@shepai/cli 1.55.3 → 1.56.0

package/dist/packages/core/src/infrastructure/services/tool-installer/tools/windsurf.json

@@ -3,6 +3,7 @@
   "summary": "AI-powered code editor by Codeium",
   "description": "Windsurf is an AI-powered code editor by Codeium that provides intelligent code assistance and automation features for modern development.",
   "tags": ["ide"],
+  "iconUrl": "https://cdn.simpleicons.org/windsurf",
   "binary": "windsurf",
   "packageManager": "apt",
   "commands": {

package/dist/packages/core/src/infrastructure/services/tool-installer/tools/zed.json

@@ -3,6 +3,7 @@
   "summary": "High-performance code editor written in Rust",
   "description": "Zed is a high-performance code editor written in Rust, designed for speed and collaboration with modern developer workflows.",
   "tags": ["ide"],
+  "iconUrl": "https://cdn.simpleicons.org/zedindustries",
   "binary": "zed",
   "packageManager": "curl",
   "commands": {

package/dist/src/presentation/cli/commands/install.command.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"install.command.d.ts","sourceRoot":"","sources":["../../../../../src/presentation/cli/commands/install.command.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AA6BpC,wBAAgB,oBAAoB,IAAI,OAAO,CAuE9C"}
+{"version":3,"file":"install.command.d.ts","sourceRoot":"","sources":["../../../../../src/presentation/cli/commands/install.command.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAuBpC,wBAAgB,oBAAoB,IAAI,OAAO,CAoE9C"}

package/dist/src/presentation/cli/commands/install.command.js

@@ -16,24 +16,17 @@ import { InstallToolUseCase } from '../../../../packages/core/src/application/us
 import { TOOL_METADATA } from '../../../../packages/core/src/infrastructure/services/tool-installer/tool-metadata.js';
 import { messages, fmt, colors } from '../ui/index.js';
 function printToolsList() {
-    const tools = Object.entries(TOOL_METADATA);
-    const ides = tools.filter(([, meta]) => meta.tags.includes('ide'));
-    const cliAgents = tools.filter(([, meta]) => meta.tags.includes('cli-agent'));
-    console.log(fmt.heading('IDEs:'));
-    for (const [key, meta] of ides) {
-        console.log(`  ${colors.accent(key.padEnd(16))}${meta.name} - ${colors.muted(meta.summary)}`);
-    }
-    console.log();
-    console.log(fmt.heading('CLI Agents:'));
-    for (const [key, meta] of cliAgents) {
-        console.log(`  ${colors.accent(key.padEnd(16))}${meta.name} - ${colors.muted(meta.summary)}`);
+    const tools = Object.entries(TOOL_METADATA).sort(([a], [b]) => a.localeCompare(b));
+    for (const [key, meta] of tools) {
+        const tags = meta.tags.map((t) => t).join(', ');
+        console.log(`  ${colors.accent(key.padEnd(16))}${meta.name} - ${colors.muted(meta.summary)}  ${colors.muted(`[${tags}]`)}`);
     }
     console.log();
 }
 export function createInstallCommand() {
     return new Command('install')
-        .description('Install a development tool (IDE or CLI agent)')
-        .argument('[tool]', 'Tool to install (vscode, cursor, windsurf, zed, antigravity, cursor-cli, claude-code)')
+        .description('Install a development tool')
+        .argument('[tool]', `Tool to install (${Object.keys(TOOL_METADATA).sort().join(', ')})`)
         .option('--how', 'Show installation instructions without executing')
         .action(async (tool, options) => {
         try {

package/dist/src/presentation/cli/commands/tools.command.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Tools Command Group
+ *
+ * Provides subcommands for listing and managing development tools.
+ *
+ * Usage:
+ *   shep tools list   # List all tools with their installed status
+ */
+import { Command } from 'commander';
+/**
+ * Create the tools command group
+ */
+export declare function createToolsCommand(): Command;
+//# sourceMappingURL=tools.command.d.ts.map

package/dist/src/presentation/cli/commands/tools.command.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools.command.d.ts","sourceRoot":"","sources":["../../../../../src/presentation/cli/commands/tools.command.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAIpC;;GAEG;AACH,wBAAgB,kBAAkB,IAAI,OAAO,CAuB5C"}

package/dist/src/presentation/cli/commands/tools.command.js

@@ -0,0 +1,36 @@
+/**
+ * Tools Command Group
+ *
+ * Provides subcommands for listing and managing development tools.
+ *
+ * Usage:
+ *   shep tools list   # List all tools with their installed status
+ */
+import { Command } from 'commander';
+import { container } from '../../../../packages/core/src/infrastructure/di/container.js';
+import { ListToolsUseCase } from '../../../../packages/core/src/application/use-cases/tools/list-tools.use-case.js';
+/**
+ * Create the tools command group
+ */
+export function createToolsCommand() {
+    const tools = new Command('tools').description('Manage development tools');
+    tools
+        .command('list')
+        .description('List all available tools with their installed status')
+        .action(async () => {
+        try {
+            const listToolsUseCase = container.resolve(ListToolsUseCase);
+            const result = await listToolsUseCase.execute();
+            for (const tool of result) {
+                const statusLabel = tool.status.status === 'available' ? 'installed' : 'missing';
+                console.log(`[${statusLabel}]  ${tool.id}  ${tool.name}`);
+            }
+        }
+        catch (error) {
+            const err = error instanceof Error ? error : new Error(String(error));
+            console.error(`Error listing tools: ${err.message}`);
+            process.exitCode = 1;
+        }
+    });
+    return tools;
+}

package/dist/src/presentation/cli/index.js

@@ -40,6 +40,7 @@ import { createSessionCommand } from './commands/session/index.js';
 import { createIdeOpenCommand } from './commands/ide-open.command.js';
 import { createInstallCommand } from './commands/install.command.js';
 import { createUpgradeCommand } from './commands/upgrade.command.js';
+import { createToolsCommand } from './commands/tools.command.js';
 import { messages } from './ui/index.js';
 // Daemon lifecycle commands
 import { createStartCommand } from './commands/start.command.js';
@@ -116,6 +117,7 @@ async function bootstrap() {
         program.addCommand(createSessionCommand());
         program.addCommand(createIdeOpenCommand());
         program.addCommand(createInstallCommand());
+        program.addCommand(createToolsCommand());
         program.addCommand(createUpgradeCommand());
         // Daemon lifecycle commands (task-9)
         program.addCommand(createStartCommand());

package/dist/src/presentation/web/app/api/tools/[id]/install/route.d.ts

@@ -0,0 +1,7 @@
+import { NextResponse } from 'next/server';
+export declare function POST(_request: Request, { params }: {
+    params: Promise<{
+        id: string;
+    }>;
+}): Promise<NextResponse>;
+//# sourceMappingURL=route.d.ts.map

package/dist/src/presentation/web/app/api/tools/[id]/install/route.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"route.d.ts","sourceRoot":"","sources":["../../../../../../../../../src/presentation/web/app/api/tools/[id]/install/route.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAK3C,wBAAsB,IAAI,CACxB,QAAQ,EAAE,OAAO,EACjB,EAAE,MAAM,EAAE,EAAE;IAAE,MAAM,EAAE,OAAO,CAAC;QAAE,EAAE,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;CAAE,GAC9C,OAAO,CAAC,YAAY,CAAC,CAevB"}

package/dist/src/presentation/web/app/api/tools/[id]/install/route.js

@@ -0,0 +1,18 @@
+import { NextResponse } from 'next/server';
+import { resolve } from '../../../../../lib/server-container.js';
+import { TOOL_METADATA } from '../../../../../../../../packages/core/src/infrastructure/services/tool-installer/tool-metadata.js';
+export async function POST(_request, { params }) {
+    const { id } = await params;
+    if (!TOOL_METADATA[id]) {
+        return NextResponse.json({ error: 'Tool not found' }, { status: 404 });
+    }
+    try {
+        const useCase = resolve('InstallToolUseCase');
+        const status = await useCase.execute(id);
+        return NextResponse.json({ status });
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : 'Failed to install tool';
+        return NextResponse.json({ error: message }, { status: 500 });
+    }
+}

package/dist/src/presentation/web/app/api/tools/[id]/launch/route.d.ts

@@ -0,0 +1,7 @@
+import { NextResponse } from 'next/server';
+export declare function POST(_request: Request, { params }: {
+    params: Promise<{
+        id: string;
+    }>;
+}): Promise<NextResponse>;
+//# sourceMappingURL=route.d.ts.map

package/dist/src/presentation/web/app/api/tools/[id]/launch/route.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"route.d.ts","sourceRoot":"","sources":["../../../../../../../../../src/presentation/web/app/api/tools/[id]/launch/route.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAO3C,wBAAsB,IAAI,CACxB,QAAQ,EAAE,OAAO,EACjB,EAAE,MAAM,EAAE,EAAE;IAAE,MAAM,EAAE,OAAO,CAAC;QAAE,EAAE,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;CAAE,GAC9C,OAAO,CAAC,YAAY,CAAC,CA2BvB"}

package/dist/src/presentation/web/app/api/tools/[id]/launch/route.js

@@ -0,0 +1,28 @@
+import { NextResponse } from 'next/server';
+import { resolve } from '../../../../../lib/server-container.js';
+export async function POST(_request, { params }) {
+    const { id } = await params;
+    try {
+        const useCase = resolve('LaunchToolUseCase');
+        const result = await useCase.execute({
+            toolId: id,
+            directoryPath: process.cwd(),
+            headless: true,
+        });
+        if (result.ok) {
+            return NextResponse.json({ editorName: result.editorName, path: result.path });
+        }
+        switch (result.code) {
+            case 'tool_not_found':
+                return NextResponse.json({ error: 'Tool not found' }, { status: 404 });
+            case 'not_launchable':
+                return NextResponse.json({ error: 'Tool has no openDirectory command' }, { status: 422 });
+            case 'launch_failed':
+                return NextResponse.json({ error: result.message }, { status: 500 });
+        }
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : 'Failed to launch tool';
+        return NextResponse.json({ error: message }, { status: 500 });
+    }
+}

package/dist/src/presentation/web/app/api/tools/route.d.ts

@@ -0,0 +1,3 @@
+import { NextResponse } from 'next/server';
+export declare function GET(): Promise<NextResponse>;
+//# sourceMappingURL=route.d.ts.map

package/dist/src/presentation/web/app/api/tools/route.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"route.d.ts","sourceRoot":"","sources":["../../../../../../../src/presentation/web/app/api/tools/route.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAI3C,wBAAsB,GAAG,IAAI,OAAO,CAAC,YAAY,CAAC,CASjD"}

package/dist/src/presentation/web/app/api/tools/route.js

@@ -0,0 +1,13 @@
+import { NextResponse } from 'next/server';
+import { resolve } from '../../../lib/server-container.js';
+export async function GET() {
+    try {
+        const useCase = resolve('ListToolsUseCase');
+        const tools = await useCase.execute();
+        return NextResponse.json(tools);
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : 'Failed to list tools';
+        return NextResponse.json({ error: message }, { status: 500 });
+    }
+}

package/dist/src/presentation/web/app/tools/page.d.ts

@@ -0,0 +1,4 @@
+/** Skip static pre-rendering since we need runtime DI container and server context. */
+export declare const dynamic = "force-dynamic";
+export default function ToolsPage(): Promise<import("react/jsx-runtime").JSX.Element>;
+//# sourceMappingURL=page.d.ts.map

package/dist/src/presentation/web/app/tools/page.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"page.d.ts","sourceRoot":"","sources":["../../../../../../src/presentation/web/app/tools/page.tsx"],"names":[],"mappings":"AAIA,uFAAuF;AACvF,eAAO,MAAM,OAAO,kBAAkB,CAAC;AAEvC,wBAA8B,SAAS,qDAStC"}

package/dist/src/presentation/web/app/tools/page.js

@@ -0,0 +1,10 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { resolve } from '../../lib/server-container.js';
+import { ToolsPageClient } from '../../components/features/tools/tools-page-client.js';
+/** Skip static pre-rendering since we need runtime DI container and server context. */
+export const dynamic = 'force-dynamic';
+export default async function ToolsPage() {
+    const useCase = resolve('ListToolsUseCase');
+    const tools = await useCase.execute();
+    return (_jsx("div", { className: "flex h-full flex-col p-6", children: _jsx(ToolsPageClient, { tools: tools }) }));
+}

package/dist/src/presentation/web/components/features/index.d.ts

@@ -1,2 +1,5 @@
 export { FeaturesCanvas, type FeaturesCanvasProps } from './features-canvas/index.js';
+export { ToolsPageClient, type ToolsPageClientProps } from './tools/index.js';
+export { ToolCard, type ToolCardProps } from './tools/index.js';
+export { InstallInstructions, type InstallInstructionsProps } from './tools/index.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/src/presentation/web/components/features/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../src/presentation/web/components/features/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,KAAK,mBAAmB,EAAE,MAAM,mBAAmB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../src/presentation/web/components/features/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,KAAK,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AAC7E,OAAO,EAAE,eAAe,EAAE,KAAK,oBAAoB,EAAE,MAAM,SAAS,CAAC;AACrE,OAAO,EAAE,QAAQ,EAAE,KAAK,aAAa,EAAE,MAAM,SAAS,CAAC;AACvD,OAAO,EAAE,mBAAmB,EAAE,KAAK,wBAAwB,EAAE,MAAM,SAAS,CAAC"}

package/dist/src/presentation/web/components/features/index.js

@@ -1 +1,4 @@
 export { FeaturesCanvas } from './features-canvas/index.js';
+export { ToolsPageClient } from './tools/index.js';
+export { ToolCard } from './tools/index.js';
+export { InstallInstructions } from './tools/index.js';

package/dist/src/presentation/web/components/features/tools/index.d.ts

@@ -0,0 +1,4 @@
+export { ToolsPageClient, type ToolsPageClientProps } from './tools-page-client.js';
+export { ToolCard, type ToolCardProps } from './tool-card.js';
+export { InstallInstructions, type InstallInstructionsProps } from './install-instructions.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/src/presentation/web/components/features/tools/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../../src/presentation/web/components/features/tools/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,KAAK,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AACjF,OAAO,EAAE,QAAQ,EAAE,KAAK,aAAa,EAAE,MAAM,aAAa,CAAC;AAC3D,OAAO,EAAE,mBAAmB,EAAE,KAAK,wBAAwB,EAAE,MAAM,wBAAwB,CAAC"}

package/dist/src/presentation/web/components/features/tools/index.js

@@ -0,0 +1,3 @@
+export { ToolsPageClient } from './tools-page-client.js';
+export { ToolCard } from './tool-card.js';
+export { InstallInstructions } from './install-instructions.js';

package/dist/src/presentation/web/components/features/tools/install-instructions.d.ts

@@ -0,0 +1,9 @@
+import type { ToolItem } from '../../../../../../packages/core/src/application/use-cases/tools/list-tools.use-case.js';
+export interface InstallInstructionsProps {
+    tool: ToolItem;
+    open: boolean;
+    onOpenChange: (open: boolean) => void;
+    className?: string;
+}
+export declare function InstallInstructions({ tool, open, onOpenChange, className, }: InstallInstructionsProps): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=install-instructions.d.ts.map

package/dist/src/presentation/web/components/features/tools/install-instructions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"install-instructions.d.ts","sourceRoot":"","sources":["../../../../../../../src/presentation/web/components/features/tools/install-instructions.tsx"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,8DAA8D,CAAC;AAE7F,MAAM,WAAW,wBAAwB;IACvC,IAAI,EAAE,QAAQ,CAAC;IACf,IAAI,EAAE,OAAO,CAAC;IACd,YAAY,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,IAAI,CAAC;IACtC,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,wBAAgB,mBAAmB,CAAC,EAClC,IAAI,EACJ,IAAI,EACJ,YAAY,EACZ,SAAS,GACV,EAAE,wBAAwB,2CAiF1B"}

package/dist/src/presentation/web/components/features/tools/install-instructions.js

@@ -0,0 +1,19 @@
+'use client';
+import { jsxs as _jsxs, jsx as _jsx } from "react/jsx-runtime";
+import { useState } from 'react';
+import { Copy, Check, ExternalLink } from 'lucide-react';
+import { Button } from '../../ui/button.js';
+import { Dialog, DialogContent, DialogHeader, DialogTitle, DialogDescription, } from '../../ui/dialog.js';
+import { cn } from '../../../lib/utils.js';
+export function InstallInstructions({ tool, open, onOpenChange, className, }) {
+    const [copied, setCopied] = useState(false);
+    function handleCopy() {
+        if (!tool.installCommand)
+            return;
+        void navigator.clipboard.writeText(tool.installCommand).then(() => {
+            setCopied(true);
+            setTimeout(() => setCopied(false), 2000);
+        });
+    }
+    return (_jsx(Dialog, { open: open, onOpenChange: onOpenChange, children: _jsxs(DialogContent, { "data-testid": "install-instructions", className: cn('sm:max-w-2xl', className), children: [_jsxs(DialogHeader, { children: [_jsxs(DialogTitle, { "data-testid": "install-instructions-title", children: ["Install ", tool.name] }), _jsx(DialogDescription, { "data-testid": "install-instructions-description", children: tool.summary })] }), _jsxs("div", { className: "flex flex-col gap-4", children: [tool.installCommand && tool.autoInstall ? (_jsxs("div", { className: "flex flex-col gap-1.5", children: [_jsx("span", { className: "text-muted-foreground text-xs font-medium", children: "Installation command" }), _jsxs("div", { className: "bg-muted relative rounded-md", children: [_jsx("pre", { "data-testid": "install-instructions-command", className: "overflow-x-auto px-3 py-2.5 pr-20 font-mono text-xs leading-relaxed break-all whitespace-pre-wrap", children: _jsx("code", { children: tool.installCommand }) }), _jsxs(Button, { variant: "ghost", size: "sm", className: "absolute top-1.5 right-1.5 h-7 cursor-pointer px-2", onClick: handleCopy, "aria-label": copied ? 'Copied!' : 'Copy install command', "data-testid": "install-instructions-copy-button", children: [copied ? (_jsx(Check, { className: "h-3.5 w-3.5 text-emerald-500" })) : (_jsx(Copy, { className: "h-3.5 w-3.5" })), _jsx("span", { className: "ml-1 text-[10px]", children: copied ? 'Copied!' : 'Copy' })] })] })] })) : tool.installCommand ? (_jsx("p", { "data-testid": "install-instructions-command", className: "text-muted-foreground text-sm", children: tool.installCommand })) : (_jsx("p", { "data-testid": "install-instructions-no-command", className: "text-muted-foreground text-sm", children: "Please refer to the documentation for installation instructions." })), tool.documentationUrl ? (_jsx(Button, { variant: "outline", size: "sm", className: "w-fit cursor-pointer", asChild: true, children: _jsxs("a", { "data-testid": "install-instructions-doc-link", href: tool.documentationUrl, target: "_blank", rel: "noopener noreferrer", children: ["View documentation", _jsx(ExternalLink, { className: "ml-1.5 h-3.5 w-3.5" })] }) })) : null] })] }) }));
+}

package/dist/src/presentation/web/components/features/tools/install-instructions.stories.d.ts

@@ -0,0 +1,12 @@
+import type { Meta, StoryObj } from '@storybook/react';
+import { InstallInstructions } from './install-instructions.js';
+declare const meta: Meta<typeof InstallInstructions>;
+export default meta;
+type Story = StoryObj<typeof meta>;
+export declare const Default: Story;
+export declare const WithInstallCommand: Story;
+export declare const WithoutInstallCommand: Story;
+export declare const WithDocumentationUrl: Story;
+export declare const WithoutDocumentationUrl: Story;
+export declare const Closed: Story;
+//# sourceMappingURL=install-instructions.stories.d.ts.map

package/dist/src/presentation/web/components/features/tools/install-instructions.stories.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"install-instructions.stories.d.ts","sourceRoot":"","sources":["../../../../../../../src/presentation/web/components/features/tools/install-instructions.stories.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AACvD,OAAO,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AAkB7D,QAAA,MAAM,IAAI,EAAE,IAAI,CAAC,OAAO,mBAAmB,CAY1C,CAAC;AAEF,eAAe,IAAI,CAAC;AACpB,KAAK,KAAK,GAAG,QAAQ,CAAC,OAAO,IAAI,CAAC,CAAC;AAEnC,eAAO,MAAM,OAAO,EAAE,KAKrB,CAAC;AAEF,eAAO,MAAM,kBAAkB,EAAE,KAQhC,CAAC;AAEF,eAAO,MAAM,qBAAqB,EAAE,KAQnC,CAAC;AAEF,eAAO,MAAM,oBAAoB,EAAE,KAQlC,CAAC;AAEF,eAAO,MAAM,uBAAuB,EAAE,KAQrC,CAAC;AAEF,eAAO,MAAM,MAAM,EAAE,KAKpB,CAAC"}

package/dist/src/presentation/web/components/features/tools/install-instructions.stories.js

@@ -0,0 +1,77 @@
+import { InstallInstructions } from './install-instructions.js';
+const baseTool = {
+    id: 'cursor',
+    name: 'Cursor',
+    summary: 'AI-powered code editor',
+    description: 'Cursor is an AI-first code editor built on VS Code.',
+    tags: ['ide'],
+    iconUrl: 'https://cdn.simpleicons.org/cursor',
+    autoInstall: false,
+    required: false,
+    openDirectory: '/usr/bin/cursor',
+    documentationUrl: 'https://cursor.sh',
+    installCommand: 'brew install --cask cursor',
+    status: { status: 'missing', toolName: 'cursor' },
+};
+const meta = {
+    title: 'Features/InstallInstructions',
+    component: InstallInstructions,
+    parameters: {
+        layout: 'centered',
+    },
+    tags: ['autodocs'],
+    args: {
+        tool: baseTool,
+        open: true,
+        onOpenChange: () => undefined,
+    },
+};
+export default meta;
+export const Default = {
+    args: {
+        tool: baseTool,
+        open: true,
+    },
+};
+export const WithInstallCommand = {
+    args: {
+        tool: {
+            ...baseTool,
+            installCommand: 'brew install --cask cursor',
+        },
+        open: true,
+    },
+};
+export const WithoutInstallCommand = {
+    args: {
+        tool: {
+            ...baseTool,
+            installCommand: undefined,
+        },
+        open: true,
+    },
+};
+export const WithDocumentationUrl = {
+    args: {
+        tool: {
+            ...baseTool,
+            documentationUrl: 'https://cursor.sh/docs',
+        },
+        open: true,
+    },
+};
+export const WithoutDocumentationUrl = {
+    args: {
+        tool: {
+            ...baseTool,
+            documentationUrl: '',
+        },
+        open: true,
+    },
+};
+export const Closed = {
+    args: {
+        tool: baseTool,
+        open: false,
+    },
+};

package/dist/src/presentation/web/components/features/tools/tool-card.d.ts

@@ -0,0 +1,8 @@
+import type { ToolItem } from '../../../../../../packages/core/src/application/use-cases/tools/list-tools.use-case.js';
+export interface ToolCardProps {
+    tool: ToolItem;
+    onRefresh?: () => Promise<void>;
+    className?: string;
+}
+export declare function ToolCard({ tool, onRefresh, className }: ToolCardProps): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=tool-card.d.ts.map

package/dist/src/presentation/web/components/features/tools/tool-card.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-card.d.ts","sourceRoot":"","sources":["../../../../../../../src/presentation/web/components/features/tools/tool-card.tsx"],"names":[],"mappings":"AAkBA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,8DAA8D,CAAC;AAE7F,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,QAAQ,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAChC,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAQD,wBAAgB,QAAQ,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,SAAS,EAAE,EAAE,aAAa,2CA2JrE"}

package/dist/src/presentation/web/components/features/tools/tool-card.js

@@ -0,0 +1,39 @@
+'use client';
+import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
+import { useState, useTransition } from 'react';
+import { ExternalLink, Loader2, Rocket, Download, Monitor, Terminal, GitBranch, CircleX, Check, Package, } from 'lucide-react';
+import { Button } from '../../ui/button.js';
+import { cn } from '../../../lib/utils.js';
+import { InstallInstructions } from './install-instructions.js';
+const TAG_CONFIG = {
+    ide: { label: 'IDE', icon: Monitor },
+    'cli-agent': { label: 'CLI Agent', icon: Terminal },
+    vcs: { label: 'VCS', icon: GitBranch },
+};
+export function ToolCard({ tool, onRefresh, className }) {
+    const [installDrawerOpen, setInstallDrawerOpen] = useState(false);
+    const [isPending, startTransition] = useTransition();
+    const isInstalled = tool.status.status === 'available';
+    const isError = tool.status.status === 'error';
+    const canLaunch = isInstalled && Boolean(tool.openDirectory);
+    function handleLaunch() {
+        startTransition(async () => {
+            await fetch(`/api/tools/${tool.id}/launch`, { method: 'POST' });
+        });
+    }
+    function handleAutoInstall() {
+        startTransition(async () => {
+            const res = await fetch(`/api/tools/${tool.id}/install`, { method: 'POST' });
+            if (res.ok && onRefresh) {
+                await onRefresh();
+            }
+        });
+    }
+    return (_jsxs(_Fragment, { children: [_jsxs("div", { "data-testid": "tool-card", className: cn('bg-card group flex h-30 w-full flex-col rounded-lg border p-3 shadow-sm transition-shadow hover:shadow-md', className), children: [_jsxs("div", { className: "mb-2 flex items-start justify-between gap-2", children: [_jsxs("div", { className: "flex min-w-0 items-center gap-2", children: [tool.iconUrl ? (
+                                    /* eslint-disable-next-line @next/next/no-img-element */
+                                    _jsx("img", { src: tool.iconUrl, alt: "", width: 20, height: 20, className: "shrink-0 dark:invert" })) : (_jsx(Package, { className: "text-muted-foreground h-5 w-5 shrink-0" })), _jsx("h3", { "data-testid": "tool-card-name", className: "truncate text-sm font-bold", children: tool.name })] }), _jsx("div", { "data-testid": "tool-card-tags", className: "flex shrink-0 items-center gap-1", children: tool.tags.map((tag) => {
+                                    const config = TAG_CONFIG[tag] ?? { label: tag, icon: Monitor };
+                                    const TagIcon = config.icon;
+                                    return (_jsxs("span", { className: "bg-muted text-muted-foreground inline-flex items-center gap-0.5 rounded px-1.5 py-0.5 text-[10px] font-medium", children: [_jsx(TagIcon, { className: "h-2.5 w-2.5" }), config.label] }, tag));
+                                }) })] }), _jsx("p", { "data-testid": "tool-card-summary", className: "text-muted-foreground mt-1 truncate text-xs", children: tool.summary }), _jsxs("div", { className: "mt-auto flex items-center justify-between pt-3", children: [_jsxs("div", { className: "flex items-center gap-2", children: [isError && tool.status.status === 'error' ? (_jsxs("span", { className: "flex items-center gap-1 truncate text-[10px] text-red-600 dark:text-red-400", title: tool.status.errorMessage, children: [_jsx(CircleX, { className: "h-3 w-3 shrink-0" }), tool.status.errorMessage ?? 'Error'] })) : isInstalled ? (_jsxs("span", { className: "flex items-center gap-1 text-[11px] text-emerald-600 dark:text-emerald-400", children: [_jsx(Check, { className: "h-3 w-3" }), "Installed"] })) : (_jsx("span", { className: "text-muted-foreground text-[10px]", children: "Not installed" })), tool.required ? (_jsx("span", { className: "text-muted-foreground text-[10px] italic", children: "Required" })) : null] }), isInstalled && canLaunch ? (_jsxs(Button, { size: "sm", variant: "ghost", onClick: handleLaunch, disabled: isPending, "aria-label": `Launch ${tool.name}`, "data-testid": "tool-card-launch-button", className: "hover:bg-primary hover:text-primary-foreground h-7 cursor-pointer rounded-md px-3 text-xs", children: [isPending ? (_jsx(Loader2, { className: "mr-1 h-3 w-3 animate-spin" })) : (_jsx(Rocket, { className: "mr-1 h-3 w-3" })), "Launch"] })) : !isInstalled && !isError && tool.autoInstall ? (_jsxs(Button, { size: "sm", onClick: handleAutoInstall, disabled: isPending, "aria-label": `Install ${tool.name}`, "data-testid": "tool-card-install-button", className: "h-7 cursor-pointer rounded-md px-3 text-xs", children: [isPending ? (_jsx(Loader2, { className: "mr-1 h-3 w-3 animate-spin" })) : (_jsx(Download, { className: "mr-1 h-3 w-3" })), isPending ? 'Installing…' : 'Install'] })) : !isInstalled && !isError ? (_jsxs(Button, { size: "sm", variant: "outline", onClick: () => setInstallDrawerOpen(true), "aria-label": `View install instructions for ${tool.name}`, "data-testid": "tool-card-manual-install-button", className: "h-7 cursor-pointer rounded-md px-3 text-xs", children: [_jsx(ExternalLink, { className: "mr-1 h-3 w-3" }), "Install"] })) : null] })] }), _jsx(InstallInstructions, { tool: tool, open: installDrawerOpen, onOpenChange: setInstallDrawerOpen })] }));
+}

package/dist/src/presentation/web/components/features/tools/tool-card.stories.d.ts

@@ -0,0 +1,15 @@
+import type { Meta, StoryObj } from '@storybook/react';
+import { ToolCard } from './tool-card.js';
+declare const meta: Meta<typeof ToolCard>;
+export default meta;
+type Story = StoryObj<typeof meta>;
+export declare const Default: Story;
+export declare const InstalledWithLaunch: Story;
+export declare const InstalledNoLaunch: Story;
+export declare const MissingAutoInstall: Story;
+export declare const MissingManualInstall: Story;
+export declare const ErrorStatus: Story;
+export declare const CliAgent: Story;
+export declare const VcsTool: Story;
+export declare const AllStates: Story;
+//# sourceMappingURL=tool-card.stories.d.ts.map

package/dist/src/presentation/web/components/features/tools/tool-card.stories.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-card.stories.d.ts","sourceRoot":"","sources":["../../../../../../../src/presentation/web/components/features/tools/tool-card.stories.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AACvD,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAmGvC,QAAA,MAAM,IAAI,EAAE,IAAI,CAAC,OAAO,QAAQ,CAc/B,CAAC;AAEF,eAAe,IAAI,CAAC;AACpB,KAAK,KAAK,GAAG,QAAQ,CAAC,OAAO,IAAI,CAAC,CAAC;AAEnC,eAAO,MAAM,OAAO,EAAE,KAErB,CAAC;AAEF,eAAO,MAAM,mBAAmB,EAAE,KAEjC,CAAC;AAEF,eAAO,MAAM,iBAAiB,EAAE,KAE/B,CAAC;AAEF,eAAO,MAAM,kBAAkB,EAAE,KAEhC,CAAC;AAEF,eAAO,MAAM,oBAAoB,EAAE,KAElC,CAAC;AAEF,eAAO,MAAM,WAAW,EAAE,KAOzB,CAAC;AAEF,eAAO,MAAM,QAAQ,EAAE,KAEtB,CAAC;AAEF,eAAO,MAAM,OAAO,EAAE,KAErB,CAAC;AAEF,eAAO,MAAM,SAAS,EAAE,KAwBvB,CAAC"}