Artifact support to link to workflow step

Task

Support on certain message artifacts the ability to link out the workflow url via a new tab

• MESSAGE_LINK_TO_WORKFLOW_FEATURE_FLAG .env based artifact
• Support workflow_url on message model (same level as message, taskId)
• link out icon on message that has workflow_url
• support backend/frontend rendering of that variable ‘workflow_url’
• only show tab out, on hover of the message or artifact (e.g. longform) component in the top right?

Feature Flags

Simple .env-based feature flags with role-based access control.

Quick Setup

1. Create the utility

// src/lib/feature-flags.ts

2. Create the hook

// src/hooks/useFeatureFlag.ts

3. Add environment variables to .env

Usage

Components Example?

export function ChatFeature() {
  const canAccessChat = useFeatureFlag('CHAT');
  if (!canAccessChat) return null;
  return <ChatInterface />;
}

// Navigation
export function Nav() {
  const canAccessChat = useFeatureFlag('CHAT');
  return (
    <nav>
      <NavItem href="/dashboard">Dashboard</NavItem>
      {canAccessChat && <NavItem href="/chat">Chat</NavItem>}
    </nav>
  );
}

API Routes

// Check feature access in API routes
const userRole = workspace.members.find(m => m.userId === session?.user?.id)?.role;
if (!canAccessFeature('CHAT', userRole)) {
  return NextResponse.json({ error: 'Feature not available' }, { status: 404 });
}

Pages

export default function ChatPage() {
  const { role } = useWorkspace();

  if (!canAccessFeature('CHAT', role)) {
    return <AccessDenied message="Chat is admin-only" />;
  }

  return <ChatFeature />;
}

Adding New Features

1. Add to .env.local: FEATURE_NEW_THING=true
2. Use useFeatureFlag('NEW_THING') in components

Start with the feature-flag locations named in the issue, src/lib/feature-flags.ts and src/hooks/useFeatureFlag.ts, then trace the message model and message or longform artifact components. Confirm how workflow_url is represented and rendered across the backend and frontend. Done means the flag controls the feature, messages with workflow_url show a hover-only external-link control, and messages without it remain unchanged.