@shepai/cli 1.8.1 → 1.9.0

package/dist/src/infrastructure/services/agents/streaming/streaming-executor-proxy.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Streaming Executor Proxy
+ *
+ * Wraps an IAgentExecutor, transparently intercepting execute() calls
+ * and routing them through executeStream(). Stream events are forwarded
+ * to a shared EventChannel while the accumulated result is returned
+ * to the caller (the graph node) as if execute() had been called normally.
+ *
+ * This allows graph nodes to remain unaware of streaming — they call
+ * execute() and get an AgentExecutionResult back, while consumers of
+ * the EventChannel receive real-time events.
+ */
+import type { AgentType, AgentFeature } from '../../../../domain/generated/output.js';
+import type { IAgentExecutor, AgentExecutionOptions, AgentExecutionResult, AgentExecutionStreamEvent } from '../../../../application/ports/output/agent-executor.interface.js';
+import type { EventChannel } from './event-channel.js';
+export declare class StreamingExecutorProxy implements IAgentExecutor {
+    private readonly inner;
+    private readonly channel;
+    get agentType(): AgentType;
+    constructor(inner: IAgentExecutor, channel: EventChannel<AgentExecutionStreamEvent>);
+    execute(prompt: string, options?: AgentExecutionOptions): Promise<AgentExecutionResult>;
+    executeStream(prompt: string, options?: AgentExecutionOptions): AsyncIterable<AgentExecutionStreamEvent>;
+    supportsFeature(feature: AgentFeature): boolean;
+}
+//# sourceMappingURL=streaming-executor-proxy.d.ts.map

package/dist/src/infrastructure/services/agents/streaming/streaming-executor-proxy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"streaming-executor-proxy.d.ts","sourceRoot":"","sources":["../../../../../../src/infrastructure/services/agents/streaming/streaming-executor-proxy.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAC;AAC5E,OAAO,KAAK,EACV,cAAc,EACd,qBAAqB,EACrB,oBAAoB,EACpB,yBAAyB,EAC1B,MAAM,wDAAwD,CAAC;AAChE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAEvD,qBAAa,sBAAuB,YAAW,cAAc;IAMzD,OAAO,CAAC,QAAQ,CAAC,KAAK;IACtB,OAAO,CAAC,QAAQ,CAAC,OAAO;IAN1B,IAAI,SAAS,IAAI,SAAS,CAEzB;gBAGkB,KAAK,EAAE,cAAc,EACrB,OAAO,EAAE,YAAY,CAAC,yBAAyB,CAAC;IAG7D,OAAO,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,qBAAqB,GAAG,OAAO,CAAC,oBAAoB,CAAC;IAyBtF,aAAa,CAClB,MAAM,EAAE,MAAM,EACd,OAAO,CAAC,EAAE,qBAAqB,GAC9B,aAAa,CAAC,yBAAyB,CAAC;IAI3C,eAAe,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO;CAGhD"}

package/dist/src/infrastructure/services/agents/streaming/streaming-executor-proxy.js

@@ -0,0 +1,51 @@
+/**
+ * Streaming Executor Proxy
+ *
+ * Wraps an IAgentExecutor, transparently intercepting execute() calls
+ * and routing them through executeStream(). Stream events are forwarded
+ * to a shared EventChannel while the accumulated result is returned
+ * to the caller (the graph node) as if execute() had been called normally.
+ *
+ * This allows graph nodes to remain unaware of streaming — they call
+ * execute() and get an AgentExecutionResult back, while consumers of
+ * the EventChannel receive real-time events.
+ */
+export class StreamingExecutorProxy {
+    inner;
+    channel;
+    get agentType() {
+        return this.inner.agentType;
+    }
+    constructor(inner, channel) {
+        this.inner = inner;
+        this.channel = channel;
+    }
+    async execute(prompt, options) {
+        let result = '';
+        try {
+            for await (const event of this.inner.executeStream(prompt, options)) {
+                this.channel.push(event);
+                if (event.type === 'result') {
+                    result = event.content;
+                }
+            }
+        }
+        catch (error) {
+            this.channel.push({
+                type: 'error',
+                content: error instanceof Error ? error.message : String(error),
+                timestamp: new Date(),
+            });
+            this.channel.close();
+            throw error;
+        }
+        this.channel.close();
+        return { result };
+    }
+    async *executeStream(prompt, options) {
+        yield* this.inner.executeStream(prompt, options);
+    }
+    supportsFeature(feature) {
+        return this.inner.supportsFeature(feature);
+    }
+}

package/dist/src/infrastructure/services/web-server.service.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"web-server.service.d.ts","sourceRoot":"","sources":["../../../../src/infrastructure/services/web-server.service.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAGH,OAAO,IAAI,MAAM,MAAM,CAAC;AACxB,OAAO,IAAI,MAAM,WAAW,CAAC;AAG7B,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,gEAAgE,CAAC;AAIxG,MAAM,WAAW,aAAa;IAC5B,aAAa,EAAE,OAAO,IAAI,CAAC;IAC3B,gBAAgB,EAAE,OAAO,IAAI,CAAC,YAAY,CAAC;CAC5C;AAOD;;;;;;;;;GASG;AACH,wBAAgB,aAAa,IAAI;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,OAAO,CAAA;CAAE,CAwB7D;AAED,qBACa,gBAAiB,YAAW,iBAAiB;IACxD,OAAO,CAAC,GAAG,CAAwB;IACnC,OAAO,CAAC,MAAM,CAA4B;IAC1C,OAAO,CAAC,cAAc,CAAS;IAC/B,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAgB;gBAEzB,IAAI,GAAE,OAAO,CAAC,aAAa,CAAM;IAI7C;;;;;OAKG;IACG,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,UAAO,GAAG,OAAO,CAAC,IAAI,CAAC;IA2BjE;;OAEG;IACG,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;CAoB5B"}
+{"version":3,"file":"web-server.service.d.ts","sourceRoot":"","sources":["../../../../src/infrastructure/services/web-server.service.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAGH,OAAO,IAAI,MAAM,MAAM,CAAC;AACxB,OAAO,IAAI,MAAM,WAAW,CAAC;AAG7B,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,gEAAgE,CAAC;AAIxG,MAAM,WAAW,aAAa;IAC5B,aAAa,EAAE,OAAO,IAAI,CAAC;IAC3B,gBAAgB,EAAE,OAAO,IAAI,CAAC,YAAY,CAAC;CAC5C;AAOD;;;;;;;;;GASG;AACH,wBAAgB,aAAa,IAAI;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,OAAO,CAAA;CAAE,CAqB7D;AAED,qBACa,gBAAiB,YAAW,iBAAiB;IACxD,OAAO,CAAC,GAAG,CAAwB;IACnC,OAAO,CAAC,MAAM,CAA4B;IAC1C,OAAO,CAAC,cAAc,CAAS;IAC/B,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAgB;gBAEzB,IAAI,GAAE,OAAO,CAAC,aAAa,CAAM;IAI7C;;;;;OAKG;IACG,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,UAAO,GAAG,OAAO,CAAC,IAAI,CAAC;IA2BjE;;OAEG;IACG,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;CAoB5B"}

package/dist/src/infrastructure/services/web-server.service.js

@@ -45,14 +45,13 @@ export function resolveWebDir() {
     // Production: web UI is shipped alongside dist/ in the package
     // From dist/src/infrastructure/services/ we need 4 levels up to reach the package root
     const prodDir = path.resolve(import.meta.dirname, '../../../../web');
-    if (fs.existsSync(path.join(prodDir, 'next.config.ts')) ||
-        fs.existsSync(path.join(prodDir, '.next'))) {
+    if (fs.existsSync(path.join(prodDir, '.next'))) {
         return { dir: prodDir, dev: false };
     }
     throw new Error(`Web UI directory not found. Ensure the web UI is built (pnpm build:web).\n` +
         `  Searched:\n` +
         `    dev:  ${devDir} (next.config.ts: ${fs.existsSync(path.join(devDir, 'next.config.ts'))})\n` +
-        `    prod: ${prodDir} (.next: ${fs.existsSync(path.join(prodDir, '.next'))}, next.config.ts: ${fs.existsSync(path.join(prodDir, 'next.config.ts'))})\n` +
+        `    prod: ${prodDir} (.next: ${fs.existsSync(path.join(prodDir, '.next'))})\n` +
         `  import.meta.dirname: ${import.meta.dirname}`);
 }
 let WebServerService = class WebServerService {

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

@@ -0,0 +1,19 @@
+/**
+ * Run Command
+ *
+ * Runs an AI agent workflow against a repository.
+ *
+ * Usage: shep run <agent-name> [options]
+ *
+ * @example
+ * $ shep run analyze-repository
+ * $ shep run analyze-repository --prompt "Focus on security"
+ * $ shep run analyze-repository --repo /path/to/repo
+ * $ shep run analyze-repository --stream
+ */
+import { Command } from 'commander';
+/**
+ * Create the run command
+ */
+export declare function createRunCommand(): Command;
+//# sourceMappingURL=run.command.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"run.command.d.ts","sourceRoot":"","sources":["../../../../../src/presentation/cli/commands/run.command.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAmCpC;;GAEG;AACH,wBAAgB,gBAAgB,IAAI,OAAO,CA+B1C"}

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

@@ -0,0 +1,130 @@
+/**
+ * Run Command
+ *
+ * Runs an AI agent workflow against a repository.
+ *
+ * Usage: shep run <agent-name> [options]
+ *
+ * @example
+ * $ shep run analyze-repository
+ * $ shep run analyze-repository --prompt "Focus on security"
+ * $ shep run analyze-repository --repo /path/to/repo
+ * $ shep run analyze-repository --stream
+ */
+import { Command } from 'commander';
+import { container } from '../../../infrastructure/di/container.js';
+import { RunAgentUseCase } from '../../../application/use-cases/agents/run-agent.use-case.js';
+import { colors, symbols, fmt, messages } from '../ui/index.js';
+/**
+ * Creates a terminal spinner that shows progress while awaiting an async operation.
+ * Returns start/stop controls. The spinner writes to stderr to avoid polluting stdout.
+ */
+function createSpinner(text) {
+    const frames = symbols.spinner;
+    let frameIndex = 0;
+    let intervalId;
+    return {
+        start() {
+            process.stderr.write(`${colors.info(frames[0])} ${text}`);
+            intervalId = setInterval(() => {
+                frameIndex = (frameIndex + 1) % frames.length;
+                process.stderr.write(`\r${colors.info(frames[frameIndex])} ${text}`);
+            }, 80);
+        },
+        stop() {
+            if (intervalId)
+                clearInterval(intervalId);
+            process.stderr.write(`\r${' '.repeat(text.length + 4)}\r`);
+        },
+    };
+}
+/**
+ * Create the run command
+ */
+export function createRunCommand() {
+    return new Command('run')
+        .description('Run an AI agent workflow')
+        .argument('<agent-name>', 'Name of the agent to run (e.g., analyze-repository)')
+        .option('-p, --prompt <prompt>', 'Prompt to send to the agent', 'Analyze this repository')
+        .option('-r, --repo <path>', 'Repository path (defaults to current directory)')
+        .option('-s, --stream', 'Stream output in real-time')
+        .action(async (agentName, options) => {
+        try {
+            const useCase = container.resolve(RunAgentUseCase);
+            const repoPath = options.repo ?? process.cwd();
+            messages.newline();
+            console.log(`${fmt.heading('Running agent:')} ${colors.accent(agentName)}`);
+            console.log(colors.muted(`  Repository: ${repoPath}`));
+            console.log(colors.muted(`  Prompt: ${options.prompt}`));
+            messages.newline();
+            if (options.stream) {
+                await runStreaming(useCase, agentName, options.prompt, repoPath);
+            }
+            else {
+                await runBlocking(useCase, agentName, options.prompt, repoPath);
+            }
+            messages.newline();
+        }
+        catch (error) {
+            const err = error instanceof Error ? error : new Error(String(error));
+            messages.error('Failed to run agent', err);
+            process.exitCode = 1;
+        }
+    });
+}
+/** Stream agent events to stdout in real-time. */
+async function runStreaming(useCase, agentName, prompt, repoPath) {
+    let hasResult = false;
+    for await (const event of useCase.executeStream({
+        agentName,
+        prompt,
+        options: { repositoryPath: repoPath },
+    })) {
+        if (event.type === 'progress') {
+            process.stdout.write(event.content);
+        }
+        else if (event.type === 'result') {
+            hasResult = true;
+            messages.newline();
+            messages.success(`Agent ${agentName} completed`);
+            messages.newline();
+            console.log(fmt.heading('Result:'));
+            messages.newline();
+            console.log(event.content);
+        }
+        else if (event.type === 'error') {
+            messages.error(event.content);
+            process.exitCode = 1;
+        }
+    }
+    if (!hasResult) {
+        messages.success(`Agent ${agentName} completed`);
+    }
+}
+/** Run agent with spinner (blocking mode). */
+async function runBlocking(useCase, agentName, prompt, repoPath) {
+    const spinner = createSpinner(`Agent ${agentName} is working...`);
+    spinner.start();
+    let run;
+    try {
+        run = await useCase.execute({
+            agentName,
+            prompt,
+            options: { repositoryPath: repoPath },
+        });
+    }
+    finally {
+        spinner.stop();
+    }
+    if (run.status === 'completed') {
+        messages.success(`Agent ${agentName} completed`);
+        messages.newline();
+        console.log(fmt.heading('Result:'));
+        messages.newline();
+        console.log(run.result ?? 'No output');
+    }
+    else if (run.status === 'failed') {
+        messages.error('Agent execution failed', new Error(run.error ?? 'Unknown error'));
+        process.exitCode = 1;
+    }
+}

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

@@ -23,6 +23,7 @@ import { Command } from 'commander';
 import { createVersionCommand } from './commands/version.command.js';
 import { createSettingsCommand } from './commands/settings/index.js';
 import { createUiCommand } from './commands/ui.command.js';
+import { createRunCommand } from './commands/run.command.js';
 import { messages } from './ui/index.js';
 // DI container and settings
 import { initializeContainer, container } from '../../infrastructure/di/container.js';
@@ -68,6 +69,7 @@ async function bootstrap() {
         program.addCommand(createVersionCommand());
         program.addCommand(createSettingsCommand());
         program.addCommand(createUiCommand());
+        program.addCommand(createRunCommand());
         // Parse arguments (parseAsync needed for async command actions like init)
         await program.parseAsync();
     }

package/dist/src/presentation/cli/ui/messages.d.ts

@@ -21,7 +21,7 @@ export declare const messages: {
     /**
      * Print error message
      * @param text - Error message
-     * @param error - Optional error object (shown in debug mode)
+     * @param error - Optional error object with details
      * @example messages.error('Connection failed')
      * // Output: ✗ Connection failed
      */

package/dist/src/presentation/cli/ui/messages.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"messages.d.ts","sourceRoot":"","sources":["../../../../../src/presentation/cli/ui/messages.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAKH;;GAEG;AACH,eAAO,MAAM,QAAQ;IACnB;;;;OAIG;6BACa,MAAM,KAAG,IAAI;IAI7B;;;;;;OAMG;2BACW,MAAM,UAAU,KAAK,KAAG,IAAI;IAO1C;;;;OAIG;6BACa,MAAM,KAAG,IAAI;IAI7B;;;;OAIG;0BACU,MAAM,KAAG,IAAI;IAI1B;;;;OAIG;2BACW,MAAM,KAAG,IAAI;IAM3B;;OAEG;4BACU,IAAI;IAIjB;;OAEG;yBACS,MAAM,KAAG,IAAI;CAGjB,CAAC;AAEX,MAAM,MAAM,QAAQ,GAAG,OAAO,QAAQ,CAAC"}
+{"version":3,"file":"messages.d.ts","sourceRoot":"","sources":["../../../../../src/presentation/cli/ui/messages.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAKH;;GAEG;AACH,eAAO,MAAM,QAAQ;IACnB;;;;OAIG;6BACa,MAAM,KAAG,IAAI;IAI7B;;;;;;OAMG;2BACW,MAAM,UAAU,KAAK,KAAG,IAAI;IAY1C;;;;OAIG;6BACa,MAAM,KAAG,IAAI;IAI7B;;;;OAIG;0BACU,MAAM,KAAG,IAAI;IAI1B;;;;OAIG;2BACW,MAAM,KAAG,IAAI;IAM3B;;OAEG;4BACU,IAAI;IAIjB;;OAEG;yBACS,MAAM,KAAG,IAAI;CAGjB,CAAC;AAEX,MAAM,MAAM,QAAQ,GAAG,OAAO,QAAQ,CAAC"}

package/dist/src/presentation/cli/ui/messages.js

@@ -25,14 +25,20 @@ export const messages = {
     /**
      * Print error message
      * @param text - Error message
-     * @param error - Optional error object (shown in debug mode)
+     * @param error - Optional error object with details
      * @example messages.error('Connection failed')
      * // Output: ✗ Connection failed
      */
     error: (text, error) => {
         console.error(colors.error(`${symbols.error} ${text}`));
-        if (error && process.env.DEBUG) {
-            console.error(colors.muted(error.stack ?? error.message));
+        if (error) {
+            // Show full stack in debug mode, otherwise just the message
+            if (process.env.DEBUG) {
+                console.error(colors.muted(error.stack ?? error.message));
+            }
+            else {
+                console.error(colors.muted(error.message));
+            }
         }
     },
     /**

package/dist/src/presentation/cli/ui/symbols.d.ts

@@ -23,7 +23,7 @@ export declare const symbols: {
     /** Arrow/pointer */
     readonly arrow: "→" | "->";
     /** Bullet point */
-    readonly bullet: "•" | "*";
+    readonly bullet: "*" | "•";
     /** Pointer right */
     readonly pointer: "❯" | ">";
     /** Ellipsis for loading/truncation */