@shepai/cli 1.92.1 → 1.92.2-pr278.ee19983

package/dist/src/presentation/web/app/actions/check-agent-tool.d.ts

@@ -0,0 +1,9 @@
+import type { ToolItem } from '../../../../../packages/core/src/application/use-cases/tools/list-tools.use-case.js';
+export interface AgentToolStatus {
+    agentType: string;
+    toolId: string | null;
+    tool: ToolItem | null;
+    installed: boolean;
+}
+export declare function checkAgentTool(agentType: string): Promise<AgentToolStatus>;
+//# sourceMappingURL=check-agent-tool.d.ts.map

package/dist/src/presentation/web/app/actions/check-agent-tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"check-agent-tool.d.ts","sourceRoot":"","sources":["../../../../../../src/presentation/web/app/actions/check-agent-tool.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,8DAA8D,CAAC;AAY7F,MAAM,WAAW,eAAe;IAC9B,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,IAAI,EAAE,QAAQ,GAAG,IAAI,CAAC;IACtB,SAAS,EAAE,OAAO,CAAC;CACpB;AAED,wBAAsB,cAAc,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC,CAkBhF"}

package/dist/src/presentation/web/app/actions/check-agent-tool.js

@@ -0,0 +1,28 @@
+'use server';
+import { resolve } from '../../lib/server-container.js';
+/**
+ * Maps agent types to their corresponding tool IDs in the tool registry.
+ * These IDs match the JSON file names in tool-installer/tools/.
+ */
+const AGENT_TOOL_MAP = {
+    'claude-code': 'claude-code',
+    cursor: 'cursor-cli',
+    'gemini-cli': 'gemini-cli',
+};
+export async function checkAgentTool(agentType) {
+    const toolId = AGENT_TOOL_MAP[agentType] ?? null;
+    // Dev agent and unknown agents don't need a tool
+    if (!toolId) {
+        return { agentType, toolId: null, tool: null, installed: true };
+    }
+    try {
+        const useCase = resolve('ListToolsUseCase');
+        const tools = await useCase.execute();
+        const tool = tools.find((t) => t.id === toolId) ?? null;
+        const installed = tool?.status.status === 'available';
+        return { agentType, toolId, tool, installed };
+    }
+    catch {
+        return { agentType, toolId, tool: null, installed: false };
+    }
+}

package/dist/src/presentation/web/components/common/feature-list-item/feature-list-item.stories.d.ts

@@ -6,6 +6,8 @@ type Story = StoryObj<typeof meta>;
 export declare const ActionNeeded: Story;
 export declare const InProgress: Story;
 export declare const Done: Story;
+export declare const Blocked: Story;
+export declare const Error: Story;
 export declare const WithClickHandler: Story;
 export declare const WithoutAgent: Story;
 //# sourceMappingURL=feature-list-item.stories.d.ts.map

package/dist/src/presentation/web/components/common/feature-list-item/feature-list-item.stories.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"feature-list-item.stories.d.ts","sourceRoot":"","sources":["../../../../../../../src/presentation/web/components/common/feature-list-item/feature-list-item.stories.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAEvD,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAEtD,QAAA,MAAM,IAAI,EAAE,IAAI,CAAC,OAAO,eAAe,CAgBtC,CAAC;AAEF,eAAe,IAAI,CAAC;AACpB,KAAK,KAAK,GAAG,QAAQ,CAAC,OAAO,IAAI,CAAC,CAAC;AAEnC,eAAO,MAAM,YAAY,EAAE,KAO1B,CAAC;AAEF,eAAO,MAAM,UAAU,EAAE,KAQxB,CAAC;AAEF,eAAO,MAAM,IAAI,EAAE,KAQlB,CAAC;AAEF,eAAO,MAAM,gBAAgB,EAAE,KAQ9B,CAAC;AAEF,eAAO,MAAM,YAAY,EAAE,KAM1B,CAAC"}
+{"version":3,"file":"feature-list-item.stories.d.ts","sourceRoot":"","sources":["../../../../../../../src/presentation/web/components/common/feature-list-item/feature-list-item.stories.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAEvD,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAEtD,QAAA,MAAM,IAAI,EAAE,IAAI,CAAC,OAAO,eAAe,CAgBtC,CAAC;AAEF,eAAe,IAAI,CAAC;AACpB,KAAK,KAAK,GAAG,QAAQ,CAAC,OAAO,IAAI,CAAC,CAAC;AAEnC,eAAO,MAAM,YAAY,EAAE,KAO1B,CAAC;AAEF,eAAO,MAAM,UAAU,EAAE,KAQxB,CAAC;AAEF,eAAO,MAAM,IAAI,EAAE,KAQlB,CAAC;AAEF,eAAO,MAAM,OAAO,EAAE,KAOrB,CAAC;AAEF,eAAO,MAAM,KAAK,EAAE,KAOnB,CAAC;AAEF,eAAO,MAAM,gBAAgB,EAAE,KAQ9B,CAAC;AAEF,eAAO,MAAM,YAAY,EAAE,KAM1B,CAAC"}

package/dist/src/presentation/web/components/common/feature-list-item/feature-list-item.stories.js

@@ -39,6 +39,22 @@ export const Done = {
         modelId: 'gemini-2.5-pro',
     },
 };
+export const Blocked = {
+    args: {
+        name: 'Dependency Resolver',
+        status: 'blocked',
+        agentType: 'claude-code',
+        modelId: 'claude-sonnet-4-6',
+    },
+};
+export const Error = {
+    args: {
+        name: 'Broken Pipeline',
+        status: 'error',
+        agentType: 'cursor',
+        modelId: 'claude-opus-4-6',
+    },
+};
 export const WithClickHandler = {
     args: {
         name: 'API Gateway',

package/dist/src/presentation/web/components/common/feature-status-badges/feature-status-badges.stories.js

@@ -15,31 +15,31 @@ const meta = {
 export default meta;
 export const AllStatuses = {
     args: {
-        counts: { 'action-needed': 2, 'in-progress': 3, done: 5 },
+        counts: { 'action-needed': 2, 'in-progress': 3, blocked: 1, error: 1, done: 5 },
     },
 };
 export const ActionNeededOnly = {
     args: {
-        counts: { 'action-needed': 4, 'in-progress': 0, done: 0 },
+        counts: { 'action-needed': 4, 'in-progress': 0, blocked: 0, error: 0, done: 0 },
     },
 };
 export const InProgressOnly = {
     args: {
-        counts: { 'action-needed': 0, 'in-progress': 2, done: 0 },
+        counts: { 'action-needed': 0, 'in-progress': 2, blocked: 0, error: 0, done: 0 },
     },
 };
 export const DoneOnly = {
     args: {
-        counts: { 'action-needed': 0, 'in-progress': 0, done: 7 },
+        counts: { 'action-needed': 0, 'in-progress': 0, blocked: 0, error: 0, done: 7 },
     },
 };
 export const LargeCounts = {
     args: {
-        counts: { 'action-needed': 12, 'in-progress': 99, done: 150 },
+        counts: { 'action-needed': 12, 'in-progress': 99, blocked: 5, error: 3, done: 150 },
     },
 };
 export const Empty = {
     args: {
-        counts: { 'action-needed': 0, 'in-progress': 0, done: 0 },
+        counts: { 'action-needed': 0, 'in-progress': 0, blocked: 0, error: 0, done: 0 },
     },
 };

package/dist/src/presentation/web/components/common/feature-status-config.d.ts

@@ -1,5 +1,5 @@
 import type { LucideIcon } from 'lucide-react';
-export type FeatureStatus = 'action-needed' | 'in-progress' | 'done';
+export type FeatureStatus = 'action-needed' | 'in-progress' | 'blocked' | 'error' | 'done';
 export interface FeatureStatusConfig {
     icon: LucideIcon;
     iconClass: string;

package/dist/src/presentation/web/components/common/feature-status-config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"feature-status-config.d.ts","sourceRoot":"","sources":["../../../../../../src/presentation/web/components/common/feature-status-config.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAE/C,MAAM,MAAM,aAAa,GAAG,eAAe,GAAG,aAAa,GAAG,MAAM,CAAC;AAErE,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,UAAU,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;CACf;AAED,eAAO,MAAM,mBAAmB,EAAE,MAAM,CAAC,aAAa,EAAE,mBAAmB,CAmB1E,CAAC;AAEF,eAAO,MAAM,kBAAkB,EAAE,aAAa,EAA6C,CAAC"}
+{"version":3,"file":"feature-status-config.d.ts","sourceRoot":"","sources":["../../../../../../src/presentation/web/components/common/feature-status-config.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAE/C,MAAM,MAAM,aAAa,GAAG,eAAe,GAAG,aAAa,GAAG,SAAS,GAAG,OAAO,GAAG,MAAM,CAAC;AAE3F,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,UAAU,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;CACf;AAED,eAAO,MAAM,mBAAmB,EAAE,MAAM,CAAC,aAAa,EAAE,mBAAmB,CA+B1E,CAAC;AAEF,eAAO,MAAM,kBAAkB,EAAE,aAAa,EAM7C,CAAC"}

package/dist/src/presentation/web/components/common/feature-status-config.js

@@ -1,4 +1,4 @@
-import { CircleAlert, Loader2, CircleCheck } from 'lucide-react';
+import { CircleAlert, Loader2, CircleCheck, Ban, CircleX } from 'lucide-react';
 export const featureStatusConfig = {
     'action-needed': {
         icon: CircleAlert,
@@ -12,6 +12,18 @@ export const featureStatusConfig = {
         bgClass: 'bg-blue-500/10',
         label: 'In Progress',
     },
+    blocked: {
+        icon: Ban,
+        iconClass: 'text-gray-400',
+        bgClass: 'bg-gray-400/10',
+        label: 'Blocked',
+    },
+    error: {
+        icon: CircleX,
+        iconClass: 'text-red-500',
+        bgClass: 'bg-red-500/10',
+        label: 'Error',
+    },
     done: {
         icon: CircleCheck,
         iconClass: 'text-emerald-500',
@@ -19,4 +31,10 @@ export const featureStatusConfig = {
         label: 'Done',
     },
 };
-export const featureStatusOrder = ['action-needed', 'in-progress', 'done'];
+export const featureStatusOrder = [
+    'action-needed',
+    'error',
+    'blocked',
+    'in-progress',
+    'done',
+];

package/dist/src/presentation/web/components/features/control-center/control-center-empty-state.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"control-center-empty-state.d.ts","sourceRoot":"","sources":["../../../../../../../src/presentation/web/components/features/control-center/control-center-empty-state.tsx"],"names":[],"mappings":"AAOA,MAAM,WAAW,4BAA4B;IAC3C,kBAAkB,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAC5C,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAID,wBAAgB,uBAAuB,CAAC,EACtC,kBAAkB,EAClB,SAAS,GACV,EAAE,4BAA4B,2CAsG9B"}
+{"version":3,"file":"control-center-empty-state.d.ts","sourceRoot":"","sources":["../../../../../../../src/presentation/web/components/features/control-center/control-center-empty-state.tsx"],"names":[],"mappings":"AAUA,MAAM,WAAW,4BAA4B;IAC3C,kBAAkB,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAC5C,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAID,wBAAgB,uBAAuB,CAAC,EACtC,kBAAkB,EAClB,SAAS,GACV,EAAE,4BAA4B,2CA+H9B"}

package/dist/src/presentation/web/components/features/control-center/control-center-empty-state.js

@@ -1,13 +1,20 @@
 'use client';
-import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
 import { useState, useCallback } from 'react';
 import { Github, Plus, TerminalSquare, Copy, Check, Loader2 } from 'lucide-react';
 import { cn } from '../../../lib/utils.js';
 import { pickFolder } from '../../common/add-repository-button/pick-folder.js';
-const commands = ['cd ~/my-repo', 'shep feat new "create modern, sleek dashboards"'];
+import { WelcomeAgentSetup } from './welcome-agent-setup.js';
+const AGENT_CONFIGURED_KEY = 'shep:agent-configured';
+const commands = ['cd ~/my-repo', 'shep feat new "sleek dashboard"'];
 export function ControlCenterEmptyState({ onRepositorySelect, className, }) {
     const [copied, setCopied] = useState(false);
     const [loading, setLoading] = useState(false);
+    const [agentReady, setAgentReady] = useState(() => {
+        if (typeof window === 'undefined')
+            return false;
+        return localStorage.getItem(AGENT_CONFIGURED_KEY) === 'true';
+    });
     async function handlePickerClick() {
         if (loading)
             return;
@@ -27,5 +34,13 @@ export function ControlCenterEmptyState({ onRepositorySelect, className, }) {
         setCopied(true);
         setTimeout(() => setCopied(false), 2000);
     }, []);
-    return (_jsxs("div", { "data-testid": "control-center-empty-state", className: cn('relative h-full w-full', className), children: [_jsx("div", { className: "absolute inset-0 [background-image:radial-gradient(circle,_var(--color-border)_1px,_transparent_1px)] [background-size:24px_24px]" }), _jsxs("div", { className: "absolute top-8 left-8 z-10", children: [_jsx("h1", { className: "text-4xl font-bold tracking-tight", children: "Features" }), _jsx("p", { className: "text-muted-foreground text-3xl font-light", children: "Control Center" })] }), _jsx("div", { className: "relative z-10 flex h-full items-center justify-center", children: _jsxs("div", { className: "flex max-w-lg flex-col items-center gap-6", children: [_jsxs("div", { className: "text-muted-foreground flex items-center gap-2", children: [_jsx(Github, { className: "h-4 w-4" }), _jsx("span", { className: "text-xs font-semibold tracking-widest uppercase", children: "Repositories" })] }), _jsxs("button", { type: "button", "data-testid": "empty-state-add-repository", onClick: handlePickerClick, disabled: loading, className: "border-muted-foreground/30 hover:border-primary hover:text-primary flex cursor-pointer items-center gap-3 rounded-lg border-2 border-dashed px-8 py-4 transition-colors disabled:cursor-wait disabled:opacity-60", children: [loading ? _jsx(Loader2, { className: "h-5 w-5 animate-spin" }) : _jsx(Plus, { className: "h-5 w-5" }), _jsx("span", { className: "text-sm font-medium", children: loading ? 'Opening...' : 'Add Repository' })] }), _jsxs("div", { className: "text-muted-foreground flex items-center gap-3", children: [_jsx("div", { className: "bg-border h-px w-16" }), _jsxs("div", { className: "flex items-center gap-1.5", children: [_jsx(TerminalSquare, { className: "h-3.5 w-3.5" }), _jsx("span", { className: "text-xs font-semibold tracking-widest uppercase", children: "Or start from the command line" })] }), _jsx("div", { className: "bg-border h-px w-16" })] }), _jsxs("div", { "data-testid": "cli-code-block", className: "relative w-full rounded-lg bg-zinc-900 px-5 py-4 font-mono text-sm text-zinc-100", children: [_jsx("button", { type: "button", "data-testid": "cli-code-block-copy", onClick: handleCopy, className: "absolute top-3 right-3 cursor-pointer rounded p-1.5 text-zinc-400 transition-colors hover:bg-zinc-800 hover:text-zinc-200", "aria-label": "Copy commands", children: copied ? _jsx(Check, { className: "h-4 w-4" }) : _jsx(Copy, { className: "h-4 w-4" }) }), _jsx("div", { className: "space-y-1", children: commands.map((cmd) => (_jsxs("div", { children: [_jsx("span", { className: "text-zinc-500 select-none", children: "$ " }), _jsx("span", { children: cmd })] }, cmd))) })] }), _jsx("p", { className: "text-muted-foreground text-sm", children: "Feature will appear on canvas once created" })] }) })] }));
+    const handleAgentSetupComplete = useCallback(() => {
+        localStorage.setItem(AGENT_CONFIGURED_KEY, 'true');
+        setAgentReady(true);
+    }, []);
+    return (_jsxs("div", { "data-testid": "control-center-empty-state", className: cn('relative h-full w-full', className), children: [_jsx("div", { className: "absolute inset-0 [background-image:radial-gradient(circle,_var(--color-border)_1px,_transparent_1px)] [background-size:24px_24px]" }), _jsxs("div", { className: "absolute top-8 left-8 z-10", children: [_jsx("h1", { className: "text-4xl font-bold tracking-tight", children: "Features" }), _jsx("p", { className: "text-muted-foreground text-3xl font-light", children: "Control Center" })] }), _jsx("div", { className: "relative z-10 flex h-full items-center justify-center", children: _jsx("div", { className: "flex w-72 flex-col items-center gap-4", children: !agentReady ? (
+                    /* Step 1: Agent setup */
+                    _jsx(WelcomeAgentSetup, { onComplete: handleAgentSetupComplete })) : (
+                    /* Step 2: Add repository (shown after agent is configured) */
+                    _jsxs(_Fragment, { children: [_jsxs("div", { className: "text-muted-foreground flex items-center gap-2", children: [_jsx(Github, { className: "h-3.5 w-3.5" }), _jsx("span", { className: "text-[10px] font-semibold tracking-widest uppercase", children: "Repositories" })] }), _jsxs("button", { type: "button", "data-testid": "empty-state-add-repository", onClick: handlePickerClick, disabled: loading, className: "border-border hover:border-foreground/40 flex w-full cursor-pointer items-center gap-2.5 rounded-md border border-dashed px-4 py-2.5 transition-colors disabled:cursor-wait disabled:opacity-50", children: [loading ? (_jsx(Loader2, { className: "text-muted-foreground h-4 w-4 animate-spin" })) : (_jsx(Plus, { className: "text-muted-foreground h-4 w-4" })), _jsx("span", { className: "text-xs font-medium", children: loading ? 'Opening…' : 'Add Repository' })] }), _jsxs("div", { className: "text-muted-foreground flex items-center gap-2", children: [_jsx("div", { className: "bg-border h-px w-10" }), _jsxs("div", { className: "flex items-center gap-1", children: [_jsx(TerminalSquare, { className: "h-3 w-3" }), _jsx("span", { className: "text-[10px] font-semibold tracking-widest uppercase", children: "Or via CLI" })] }), _jsx("div", { className: "bg-border h-px w-10" })] }), _jsxs("div", { "data-testid": "cli-code-block", className: "relative w-full rounded-md bg-zinc-900 px-3 py-2 font-mono text-[11px] text-zinc-300", children: [_jsx("button", { type: "button", "data-testid": "cli-code-block-copy", onClick: handleCopy, className: "absolute top-2 right-2 cursor-pointer rounded p-1 text-zinc-500 transition-colors hover:bg-zinc-800 hover:text-zinc-300", "aria-label": "Copy commands", children: copied ? _jsx(Check, { className: "h-3 w-3" }) : _jsx(Copy, { className: "h-3 w-3" }) }), _jsx("div", { className: "space-y-0.5", children: commands.map((cmd) => (_jsxs("div", { className: "whitespace-nowrap", children: [_jsx("span", { className: "text-zinc-500 select-none", children: "$ " }), _jsx("span", { children: cmd })] }, cmd))) })] }), _jsx("p", { className: "text-muted-foreground text-[10px]", children: "Feature will appear on canvas once created" })] })) }) })] }));
 }

package/dist/src/presentation/web/components/features/control-center/welcome-agent-setup.d.ts

@@ -0,0 +1,6 @@
+export interface WelcomeAgentSetupProps {
+    onComplete: () => void;
+    className?: string;
+}
+export declare function WelcomeAgentSetup({ onComplete, className }: WelcomeAgentSetupProps): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=welcome-agent-setup.d.ts.map

package/dist/src/presentation/web/components/features/control-center/welcome-agent-setup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"welcome-agent-setup.d.ts","sourceRoot":"","sources":["../../../../../../../src/presentation/web/components/features/control-center/welcome-agent-setup.tsx"],"names":[],"mappings":"AAwBA,MAAM,WAAW,sBAAsB;IACrC,UAAU,EAAE,MAAM,IAAI,CAAC;IACvB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AASD,wBAAgB,iBAAiB,CAAC,EAAE,UAAU,EAAE,SAAS,EAAE,EAAE,sBAAsB,2CAqQlF"}

package/dist/src/presentation/web/components/features/control-center/welcome-agent-setup.js

@@ -0,0 +1,169 @@
+'use client';
+import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
+import { useState, useEffect, useCallback, useRef } from 'react';
+import { Check, ChevronRight, ChevronLeft, Download, Loader2, CheckCircle2, Circle, AlertCircle, Bot, } from 'lucide-react';
+import { getAllAgentModels } from '../../../app/actions/get-all-agent-models.js';
+import { checkAgentTool } from '../../../app/actions/check-agent-tool.js';
+import { updateAgentAndModel } from '../../../app/actions/update-agent-and-model.js';
+import { getAgentTypeIcon } from '../../common/feature-node/agent-type-icons.js';
+import { getModelMeta } from '../../../lib/model-metadata.js';
+import { useToolInstallStream } from '../../../hooks/use-tool-install-stream.js';
+import { cn } from '../../../lib/utils.js';
+const STEPS = ['select-agent', 'select-model', 'check-tool'];
+/** Fixed width for the wizard content area to prevent layout jumps */
+const WIZARD_WIDTH = 'w-72';
+export function WelcomeAgentSetup({ onComplete, className }) {
+    const [groups, setGroups] = useState([]);
+    const [loading, setLoading] = useState(true);
+    const [step, setStep] = useState('select-agent');
+    const [selectedAgent, setSelectedAgent] = useState(null);
+    const [selectedModel, setSelectedModel] = useState(null);
+    const [toolStatus, setToolStatus] = useState(null);
+    const [checkingTool, setCheckingTool] = useState(false);
+    const [saving, setSaving] = useState(false);
+    const [transitioning, setTransitioning] = useState(false);
+    const [visible, setVisible] = useState(true);
+    const timeoutRef = useRef(undefined);
+    useEffect(() => {
+        getAllAgentModels()
+            .then(setGroups)
+            .finally(() => setLoading(false));
+    }, []);
+    const activeGroup = selectedAgent ? groups.find((g) => g.agentType === selectedAgent) : null;
+    /** Animate step transition: fade out → change step → fade in */
+    const transitionTo = useCallback((nextStep, setup) => {
+        setTransitioning(true);
+        setVisible(false);
+        if (timeoutRef.current)
+            clearTimeout(timeoutRef.current);
+        timeoutRef.current = setTimeout(() => {
+            setup?.();
+            setStep(nextStep);
+            // Small delay to let React render the new content before fading in
+            requestAnimationFrame(() => {
+                setVisible(true);
+                setTransitioning(false);
+            });
+        }, 150);
+    }, []);
+    useEffect(() => {
+        return () => {
+            if (timeoutRef.current)
+                clearTimeout(timeoutRef.current);
+        };
+    }, []);
+    const handleAgentSelect = useCallback((agentType) => {
+        const group = groups.find((g) => g.agentType === agentType);
+        if (group && group.models.length > 0) {
+            transitionTo('select-model', () => {
+                setSelectedAgent(agentType);
+            });
+        }
+        else {
+            transitionTo('check-tool', () => {
+                setSelectedAgent(agentType);
+                setSelectedModel('');
+            });
+        }
+    }, [groups, transitionTo]);
+    const handleModelSelect = useCallback((model) => {
+        transitionTo('check-tool', () => {
+            setSelectedModel(model);
+        });
+    }, [transitionTo]);
+    const handleBack = useCallback(() => {
+        if (step === 'select-model') {
+            transitionTo('select-agent', () => {
+                setSelectedAgent(null);
+            });
+        }
+        else if (step === 'check-tool') {
+            if (activeGroup && activeGroup.models.length > 0) {
+                transitionTo('select-model', () => {
+                    setSelectedModel(null);
+                });
+            }
+            else {
+                transitionTo('select-agent', () => {
+                    setSelectedAgent(null);
+                });
+            }
+        }
+    }, [step, activeGroup, transitionTo]);
+    useEffect(() => {
+        if (step !== 'check-tool' || !selectedAgent)
+            return;
+        setCheckingTool(true);
+        checkAgentTool(selectedAgent)
+            .then(setToolStatus)
+            .finally(() => setCheckingTool(false));
+    }, [step, selectedAgent]);
+    const handleConfirm = useCallback(async () => {
+        if (!selectedAgent)
+            return;
+        setSaving(true);
+        try {
+            await updateAgentAndModel(selectedAgent, selectedModel ?? null);
+            onComplete();
+        }
+        finally {
+            setSaving(false);
+        }
+    }, [selectedAgent, selectedModel, onComplete]);
+    if (loading) {
+        return (_jsxs("div", { "data-testid": "welcome-agent-setup", className: cn('flex flex-col items-center justify-center gap-3', className), children: [_jsx(Loader2, { className: "text-muted-foreground h-4 w-4 animate-spin" }), _jsx("p", { className: "text-muted-foreground text-xs", children: "Loading agents\u2026" })] }));
+    }
+    const stepIndex = STEPS.indexOf(step);
+    return (_jsxs("div", { "data-testid": "welcome-agent-setup", className: cn('flex flex-col items-center gap-4', WIZARD_WIDTH, className), children: [_jsx("div", { className: "flex flex-col items-center gap-1", children: _jsxs("div", { className: "text-muted-foreground flex items-center gap-2", children: [step === 'select-agent' && (_jsxs(_Fragment, { children: [_jsx(Bot, { className: "h-3.5 w-3.5" }), _jsx("span", { className: "text-[10px] font-semibold tracking-widest uppercase", children: "Choose your agent" })] })), step === 'select-model' && activeGroup
+                            ? (() => {
+                                const AgentIcon = getAgentTypeIcon(activeGroup.agentType);
+                                return (_jsxs(_Fragment, { children: [_jsx(AgentIcon, { className: "h-3.5 w-3.5" }), _jsxs("span", { className: "text-[10px] font-semibold tracking-widest uppercase", children: [activeGroup.label, " \u2014 Pick a model"] })] }));
+                            })()
+                            : null, step === 'check-tool' && (_jsxs(_Fragment, { children: [_jsx(Bot, { className: "h-3.5 w-3.5" }), _jsx("span", { className: "text-[10px] font-semibold tracking-widest uppercase", children: "Verifying setup" })] }))] }) }), _jsx("div", { className: "flex w-32 items-center gap-1", children: STEPS.map((s, i) => (_jsx("div", { className: cn('h-0.5 flex-1 rounded-full transition-colors duration-300', i <= stepIndex ? 'bg-foreground/60' : 'bg-muted') }, s))) }), _jsxs("div", { className: cn('flex w-full flex-col items-center transition-opacity duration-150', visible && !transitioning ? 'opacity-100' : 'opacity-0'), children: [step === 'select-agent' && (_jsx("div", { "data-testid": "agent-list", className: "flex w-full flex-col gap-1.5", children: groups.map((group) => {
+                            const GroupIcon = getAgentTypeIcon(group.agentType);
+                            return (_jsxs("button", { type: "button", "data-testid": `agent-option-${group.agentType}`, className: "border-border hover:border-foreground/40 flex w-full cursor-pointer items-center gap-2.5 rounded-md border border-dashed px-4 py-2.5 transition-colors", onClick: () => handleAgentSelect(group.agentType), children: [_jsx(GroupIcon, { className: "text-muted-foreground h-4 w-4 shrink-0" }), _jsx("span", { className: "flex-1 text-left text-xs font-medium", children: group.label }), _jsx(ChevronRight, { className: "text-muted-foreground h-3 w-3" })] }, group.agentType));
+                        }) })), step === 'select-model' && activeGroup ? (_jsxs("div", { "data-testid": "model-list", className: "flex w-full flex-col gap-1.5", children: [_jsxs("button", { type: "button", className: "text-muted-foreground hover:text-foreground mb-0.5 flex cursor-pointer items-center gap-1 self-start text-[10px] font-medium transition-colors", onClick: handleBack, children: [_jsx(ChevronLeft, { className: "h-3 w-3" }), "Back"] }), _jsx("div", { className: "flex max-h-48 w-full flex-col gap-1.5 overflow-y-auto", children: activeGroup.models.map((m) => {
+                                    const meta = getModelMeta(m.id);
+                                    return (_jsxs("button", { type: "button", "data-testid": `model-option-${m.id}`, className: "border-border hover:border-foreground/40 flex w-full cursor-pointer items-center gap-2.5 rounded-md border border-dashed px-4 py-2.5 text-left transition-colors", onClick: () => handleModelSelect(m.id), children: [_jsxs("div", { className: "flex min-w-0 flex-1 flex-col gap-0.5", children: [_jsx("span", { className: "text-xs font-medium", children: meta.displayName || m.displayName }), _jsx("span", { className: "text-muted-foreground text-[10px] leading-tight", children: meta.description || m.description })] }), _jsx(ChevronRight, { className: "text-muted-foreground h-3 w-3 shrink-0" })] }, m.id));
+                                }) })] })) : null, step === 'check-tool' && (_jsx(ToolCheckStep, { toolStatus: toolStatus, checking: checkingTool, saving: saving, onConfirm: handleConfirm, onBack: handleBack, onToolInstalled: () => {
+                            if (selectedAgent) {
+                                setCheckingTool(true);
+                                checkAgentTool(selectedAgent)
+                                    .then(setToolStatus)
+                                    .finally(() => setCheckingTool(false));
+                            }
+                        } }))] })] }));
+}
+/** Sub-component for the tool verification step */
+function ToolCheckStep({ toolStatus, checking, saving, onConfirm, onBack, onToolInstalled, }) {
+    if (checking || !toolStatus) {
+        return (_jsxs("div", { className: "flex flex-col items-center gap-2 py-4", children: [_jsx(Loader2, { className: "text-muted-foreground h-4 w-4 animate-spin" }), _jsx("p", { className: "text-muted-foreground text-[10px]", children: "Checking tool availability\u2026" })] }));
+    }
+    // Agent doesn't require a tool (e.g., dev/demo)
+    if (!toolStatus.toolId) {
+        return (_jsxs("div", { className: "flex w-full flex-col items-center gap-3", children: [_jsxs("div", { className: "text-muted-foreground flex items-center gap-1.5", children: [_jsx(CheckCircle2, { className: "h-3.5 w-3.5" }), _jsx("span", { className: "text-xs", children: "No additional tools required" })] }), _jsx(ConfirmRow, { saving: saving, onConfirm: onConfirm, onBack: onBack })] }));
+    }
+    if (toolStatus.installed) {
+        return (_jsxs("div", { className: "flex w-full flex-col items-center gap-3", children: [_jsxs("div", { className: "text-muted-foreground flex items-center gap-1.5", children: [_jsx(CheckCircle2, { className: "h-3.5 w-3.5" }), _jsxs("span", { className: "text-xs", children: [toolStatus.tool?.name ?? toolStatus.toolId, " is installed"] })] }), _jsx(ConfirmRow, { saving: saving, onConfirm: onConfirm, onBack: onBack })] }));
+    }
+    return (_jsx(ToolInstallInline, { toolStatus: toolStatus, saving: saving, onConfirm: onConfirm, onBack: onBack, onInstalled: onToolInstalled }));
+}
+/** Shared back + continue row */
+function ConfirmRow({ saving, onConfirm, onBack, }) {
+    return (_jsxs("div", { className: "flex items-center gap-3", children: [_jsxs("button", { type: "button", className: "text-muted-foreground hover:text-foreground cursor-pointer text-[10px] transition-colors", onClick: onBack, children: [_jsx(ChevronLeft, { className: "mr-0.5 inline h-3 w-3" }), "Back"] }), _jsxs("button", { type: "button", "data-testid": "agent-setup-confirm", disabled: saving, className: "border-border hover:border-foreground/40 flex cursor-pointer items-center gap-1.5 rounded-md border border-dashed px-4 py-2 text-xs font-medium transition-colors disabled:opacity-50", onClick: onConfirm, children: [saving ? _jsx(Loader2, { className: "h-3 w-3 animate-spin" }) : _jsx(Check, { className: "h-3 w-3" }), "Continue"] })] }));
+}
+/** Inline tool installer for the welcome wizard */
+function ToolInstallInline({ toolStatus, saving, onConfirm, onBack, onInstalled, }) {
+    const toolId = toolStatus.toolId ?? '';
+    const { logs, status, startInstall } = useToolInstallStream(toolId);
+    const isInstallDone = status === 'done';
+    const isInstallError = status === 'error';
+    useEffect(() => {
+        if (isInstallDone) {
+            onInstalled();
+        }
+    }, [isInstallDone, onInstalled]);
+    return (_jsxs("div", { className: "flex w-full flex-col items-center gap-3", children: [_jsxs("div", { className: "flex items-center gap-1.5", children: [isInstallDone ? (_jsx(CheckCircle2, { className: "text-muted-foreground h-3.5 w-3.5" })) : isInstallError ? (_jsx(AlertCircle, { className: "text-destructive h-3.5 w-3.5" })) : (_jsx(Circle, { className: "text-muted-foreground h-3.5 w-3.5" })), _jsxs("span", { className: "text-xs", children: [toolStatus.tool?.name ?? toolId, ' ', isInstallDone ? 'installed' : isInstallError ? 'install failed' : 'is not installed'] })] }), toolStatus.tool?.installCommand && status === 'idle' ? (_jsxs("div", { className: "w-full rounded-md bg-zinc-900 px-3 py-2 font-mono text-[11px] text-zinc-300", children: [_jsx("span", { className: "text-zinc-500 select-none", children: "$ " }), toolStatus.tool.installCommand] })) : null, (status === 'streaming' || isInstallDone || isInstallError) && logs.length > 0 ? (_jsxs("div", { className: "max-h-28 w-full overflow-auto rounded-md bg-zinc-900 px-3 py-2 font-mono text-[10px] leading-relaxed text-zinc-400", children: [logs.map((line, idx) => (
+                    // eslint-disable-next-line react/no-array-index-key -- logs are append-only, never reorder
+                    _jsx("div", { className: "break-all whitespace-pre-wrap", children: line }, idx))), isInstallDone ? (_jsx("div", { className: "text-muted-foreground mt-1", children: "Installation complete" })) : null, isInstallError ? (_jsx("div", { className: "text-destructive mt-1", children: "Installation failed \u2014 try manually" })) : null] })) : null, _jsxs("div", { className: "flex items-center gap-3", children: [_jsxs("button", { type: "button", className: "text-muted-foreground hover:text-foreground cursor-pointer text-[10px] transition-colors", onClick: onBack, children: [_jsx(ChevronLeft, { className: "mr-0.5 inline h-3 w-3" }), "Back"] }), !isInstallDone && toolStatus.tool?.autoInstall ? (_jsxs("button", { type: "button", "data-testid": "agent-setup-install", disabled: status === 'streaming', className: "border-border hover:border-foreground/40 flex cursor-pointer items-center gap-1.5 rounded-md border border-dashed px-4 py-2 text-xs font-medium transition-colors disabled:opacity-50", onClick: startInstall, children: [status === 'streaming' ? (_jsx(Loader2, { className: "h-3 w-3 animate-spin" })) : (_jsx(Download, { className: "h-3 w-3" })), status === 'streaming' ? 'Installing…' : 'Install'] })) : null, isInstallDone ? (_jsxs("button", { type: "button", "data-testid": "agent-setup-confirm", disabled: saving, className: "border-border hover:border-foreground/40 flex cursor-pointer items-center gap-1.5 rounded-md border border-dashed px-4 py-2 text-xs font-medium transition-colors disabled:opacity-50", onClick: onConfirm, children: [saving ? _jsx(Loader2, { className: "h-3 w-3 animate-spin" }) : _jsx(Check, { className: "h-3 w-3" }), "Continue"] })) : null] })] }));
+}

package/dist/src/presentation/web/components/features/control-center/welcome-agent-setup.stories.d.ts

@@ -0,0 +1,7 @@
+import type { Meta, StoryObj } from '@storybook/react';
+import { WelcomeAgentSetup } from './welcome-agent-setup.js';
+declare const meta: Meta<typeof WelcomeAgentSetup>;
+export default meta;
+type Story = StoryObj<typeof meta>;
+export declare const Default: Story;
+//# sourceMappingURL=welcome-agent-setup.stories.d.ts.map

package/dist/src/presentation/web/components/features/control-center/welcome-agent-setup.stories.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"welcome-agent-setup.stories.d.ts","sourceRoot":"","sources":["../../../../../../../src/presentation/web/components/features/control-center/welcome-agent-setup.stories.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAEvD,OAAO,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAE1D,QAAA,MAAM,IAAI,EAAE,IAAI,CAAC,OAAO,iBAAiB,CAcxC,CAAC;AAEF,eAAe,IAAI,CAAC;AACpB,KAAK,KAAK,GAAG,QAAQ,CAAC,OAAO,IAAI,CAAC,CAAC;AAEnC,eAAO,MAAM,OAAO,EAAE,KAIrB,CAAC"}

package/dist/src/presentation/web/components/features/control-center/welcome-agent-setup.stories.js

@@ -0,0 +1,20 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { fn } from '@storybook/test';
+import { WelcomeAgentSetup } from './welcome-agent-setup.js';
+const meta = {
+    title: 'Features/WelcomeAgentSetup',
+    component: WelcomeAgentSetup,
+    tags: ['autodocs'],
+    parameters: {
+        layout: 'centered',
+    },
+    decorators: [
+        (Story) => (_jsx("div", { style: { width: 480, padding: 48, display: 'flex', justifyContent: 'center' }, children: _jsx(Story, {}) })),
+    ],
+};
+export default meta;
+export const Default = {
+    args: {
+        onComplete: fn(),
+    },
+};

package/dist/src/presentation/web/components/layouts/app-shell/app-shell.js

@@ -29,7 +29,7 @@ function AppShellInner({ children }) {
     const handleRepositorySelect = useCallback((path) => {
         window.dispatchEvent(new CustomEvent('shep:add-repository', { detail: { path } }));
     }, []);
-    return (_jsxs(SidebarProvider, { children: [_jsx(AppSidebar, { features: features, featureFlags: featureFlags, onNewFeature: handleNewFeature, onFeatureClick: handleFeatureClick }), _jsx(SidebarInset, { children: _jsxs("div", { className: "relative h-full", children: [_jsxs("div", { className: "absolute top-3 right-3 z-50 flex gap-1", children: [_jsx(AddRepositoryButton, { onSelect: handleRepositorySelect }), _jsx(SoundToggle, {}), _jsx(ThemeToggle, {})] }), _jsx("main", { className: "h-full", children: children })] }) })] }));
+    return (_jsxs(SidebarProvider, { defaultOpen: false, children: [_jsx(AppSidebar, { features: features, featureFlags: featureFlags, onNewFeature: handleNewFeature, onFeatureClick: handleFeatureClick }), _jsx(SidebarInset, { children: _jsxs("div", { className: "relative h-full", children: [_jsxs("div", { className: "absolute top-3 right-3 z-50 flex gap-1", children: [_jsx(AddRepositoryButton, { onSelect: handleRepositorySelect }), _jsx(SoundToggle, {}), _jsx(ThemeToggle, {})] }), _jsx("main", { className: "h-full", children: children })] }) })] }));
 }
 export function AppShell({ children }) {
     return (_jsx(AgentEventsProvider, { children: _jsx(DrawerCloseGuardProvider, { children: _jsx(SidebarFeaturesProvider, { children: _jsx(AppShellInner, { children: children }) }) }) }));

package/dist/src/presentation/web/hooks/sidebar-features-context.d.ts

@@ -11,7 +11,7 @@ export interface SidebarFeatureItem {
     modelId?: string;
 }
 /**
- * Maps a canvas FeatureNodeState to the sidebar's 3-state FeatureStatus.
+ * Maps a canvas FeatureNodeState to the sidebar's 5-state FeatureStatus.
  * Returns `null` for `creating` (optimistic UI) — these should be excluded from the sidebar.
  */
 export declare function mapNodeStateToSidebarStatus(state: FeatureNodeState): FeatureStatus | null;

package/dist/src/presentation/web/hooks/sidebar-features-context.js

@@ -2,18 +2,18 @@
 import { jsx as _jsx } from "react/jsx-runtime";
 import { createContext, useContext, useState, useMemo } from 'react';
 // ---------------------------------------------------------------------------
-// Pure mapping: FeatureNodeState (6-state) → FeatureStatus (3-state) | null
+// Pure mapping: FeatureNodeState (6-state) → FeatureStatus (5-state) | null
 // ---------------------------------------------------------------------------
 const stateMapping = {
     'action-required': 'action-needed',
     running: 'in-progress',
     done: 'done',
-    blocked: 'in-progress',
-    error: 'in-progress',
+    blocked: 'blocked',
+    error: 'error',
     creating: null,
 };
 /**
- * Maps a canvas FeatureNodeState to the sidebar's 3-state FeatureStatus.
+ * Maps a canvas FeatureNodeState to the sidebar's 5-state FeatureStatus.
  * Returns `null` for `creating` (optimistic UI) — these should be excluded from the sidebar.
  */
 export function mapNodeStateToSidebarStatus(state) {

package/dist/src/presentation/web/lib/layout-with-dagre.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"layout-with-dagre.d.ts","sourceRoot":"","sources":["../../../../../src/presentation/web/lib/layout-with-dagre.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,eAAe,CAAC;AAEhD,MAAM,MAAM,eAAe,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,CAAC;AAExD,MAAM,WAAW,aAAa;IAC5B,iEAAiE;IACjE,SAAS,CAAC,EAAE,eAAe,CAAC;IAC5B,0DAA0D;IAC1D,QAAQ,CAAC,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;IAC7C,qDAAqD;IACrD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,wEAAwE;IACxE,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,+DAA+D;AAC/D,eAAO,MAAM,sBAAsB,EAAE,aAIpC,CAAC;AAkCF;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,CAAC,SAAS,IAAI,EAC5C,KAAK,EAAE,CAAC,EAAE,EACV,KAAK,EAAE,IAAI,EAAE,EACb,IAAI,GAAE,aAAkB,GACvB;IAAE,KAAK,EAAE,CAAC,EAAE,CAAC;IAAC,KAAK,EAAE,IAAI,EAAE,CAAA;CAAE,CAoK/B"}
+{"version":3,"file":"layout-with-dagre.d.ts","sourceRoot":"","sources":["../../../../../src/presentation/web/lib/layout-with-dagre.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,eAAe,CAAC;AAEhD,MAAM,MAAM,eAAe,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,CAAC;AAExD,MAAM,WAAW,aAAa;IAC5B,iEAAiE;IACjE,SAAS,CAAC,EAAE,eAAe,CAAC;IAC5B,0DAA0D;IAC1D,QAAQ,CAAC,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;IAC7C,qDAAqD;IACrD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,wEAAwE;IACxE,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,+DAA+D;AAC/D,eAAO,MAAM,sBAAsB,EAAE,aAIpC,CAAC;AAkCF;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,CAAC,SAAS,IAAI,EAC5C,KAAK,EAAE,CAAC,EAAE,EACV,KAAK,EAAE,IAAI,EAAE,EACb,IAAI,GAAE,aAAkB,GACvB;IAAE,KAAK,EAAE,CAAC,EAAE,CAAC;IAAC,KAAK,EAAE,IAAI,EAAE,CAAA;CAAE,CAyL/B"}