@opengsd/gsd-pi 1.5.0 → 1.6.0

package/integrations/hermes/open_gsd_hermes/gsd_client.py

@@ -4,6 +4,7 @@ from __future__ import annotations
 
 import json
 import os
+import shutil
 import subprocess
 import threading
 import time
@@ -62,7 +63,12 @@ class GsdMcpClient:
 
     def _env(self) -> dict[str, str]:
         env = os.environ.copy()
-        env["GSD_CLI_PATH"] = self._config.cli_path
+        # Resolve cli_path to an absolute path so the MCP server's
+        # resolveCLIPath() does not resolve a bare command name (e.g. "gsd")
+        # against the project directory, producing a non-existent
+        # project-relative path that hangs gsd_execute until timeout.
+        resolved = shutil.which(self._config.cli_path) or self._config.cli_path
+        env["GSD_CLI_PATH"] = resolved
         return env
 
     def ensure_version(self) -> None:
@@ -134,9 +140,11 @@ class GsdMcpClient:
     def _send(self, payload: dict[str, Any], *, project_dir: str | None = None) -> None:
         proc = self._ensure_process(project_dir)
         assert proc.stdin is not None
-        body = json.dumps(payload).encode("utf-8")
-        header = f"Content-Length: {len(body)}\r\n\r\n".encode("ascii")
-        proc.stdin.write(header + body)
+        # gsd-mcp-server uses the @modelcontextprotocol/sdk stdio transport,
+        # which is newline-delimited JSON (NDJSON), not the Content-Length
+        # framing from the LSP-style MCP spec. Emit one JSON object per line.
+        data = json.dumps(payload, ensure_ascii=False).encode("utf-8") + b"\n"
+        proc.stdin.write(data)
         proc.stdin.flush()
 
     def _read_stdout_chunk(self, deadline: float) -> None:
@@ -179,42 +187,23 @@ class GsdMcpClient:
             f"{self._config.mcp_read_timeout_seconds:g}s"
         )
 
-    def _read_header(self, deadline: float) -> bytes:
+    def _read_line(self, deadline: float) -> bytes:
         while True:
-            crlf_idx = self._stdout_buffer.find(b"\r\n\r\n")
-            lf_idx = self._stdout_buffer.find(b"\n\n")
-            candidates = [
-                (idx, sep_len)
-                for idx, sep_len in ((crlf_idx, 4), (lf_idx, 2))
-                if idx >= 0
-            ]
-            if candidates:
-                idx, sep_len = min(candidates)
-                header = self._stdout_buffer[:idx]
-                self._stdout_buffer = self._stdout_buffer[idx + sep_len :]
-                return header
+            idx = self._stdout_buffer.find(b"\n")
+            if idx >= 0:
+                raw = self._stdout_buffer[:idx]
+                self._stdout_buffer = self._stdout_buffer[idx + 1 :]
+                return raw.rstrip(b"\r")
             self._read_stdout_chunk(deadline)
 
-    def _read_exact(self, length: int, deadline: float) -> bytes:
-        while len(self._stdout_buffer) < length:
-            self._read_stdout_chunk(deadline)
-        body = self._stdout_buffer[:length]
-        self._stdout_buffer = self._stdout_buffer[length:]
-        return body
-
     def _read_message(self) -> dict[str, Any]:
         deadline = time.monotonic() + self._config.mcp_read_timeout_seconds
-        header = self._read_header(deadline)
-        headers: dict[str, str] = {}
-        for raw_line in header.splitlines():
-            decoded = raw_line.decode("utf-8").strip()
-            if not decoded:
-                continue
-            key, _, val = decoded.partition(":")
-            headers[key.strip().lower()] = val.strip()
-        length = int(headers.get("content-length", "0"))
-        body = self._read_exact(length, deadline)
-        return json.loads(body.decode("utf-8"))
+        # gsd-mcp-server emits newline-delimited JSON (NDJSON); each line is a
+        # complete JSON-RPC message. Skip blank keep-alive lines.
+        while True:
+            line = self._read_line(deadline)
+            if line.strip():
+                return json.loads(line.decode("utf-8"))
 
     def _initialize(self) -> None:
         self._request_id += 1
@@ -226,7 +215,7 @@ class GsdMcpClient:
                 "params": {
                     "protocolVersion": "2024-11-05",
                     "capabilities": {},
-                    "clientInfo": {"name": "open-gsd-hermes", "version": "1.2.0"},
+                    "clientInfo": {"name": "open-gsd-hermes", "version": "1.6.0"},
                 },
             }
         )

package/integrations/hermes/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "open-gsd-hermes"
-version = "1.2.0"
+version = "1.6.0"
 description = "Hermes Agent plugin — GSD structured delivery engine integration"
 readme = "README.md"
 license = { text = "MIT" }

package/integrations/hermes/tests/test_gsd_client_timeout.py

@@ -31,7 +31,7 @@ def test_read_message_times_out_waiting_for_headers() -> None:
         proc.kill()
 
 
-def test_read_message_times_out_waiting_for_body() -> None:
+def test_read_message_times_out_waiting_for_newline() -> None:
     client = GsdMcpClient(GsdConfig(mcp_read_timeout_seconds=0.05))
     proc = subprocess.Popen(
         [
@@ -39,7 +39,7 @@ def test_read_message_times_out_waiting_for_body() -> None:
             "-c",
             (
                 "import sys, time; "
-                "sys.stdout.buffer.write(b'Content-Length: 2\\r\\n\\r\\n{'); "
+                "sys.stdout.buffer.write(b'{\"jsonrpc\":\"2.0\"'); "
                 "sys.stdout.flush(); "
                 "time.sleep(10)"
             ),
@@ -59,7 +59,7 @@ def test_read_message_times_out_waiting_for_body() -> None:
         proc.kill()
 
 
-def test_read_message_fails_without_respawning_when_stdout_closes_mid_body(
+def test_read_message_fails_without_respawning_when_stdout_closes_mid_line(
     tmp_path,
 ) -> None:
     client = GsdMcpClient(GsdConfig(mcp_read_timeout_seconds=1))
@@ -69,7 +69,7 @@ def test_read_message_fails_without_respawning_when_stdout_closes_mid_body(
             "-c",
             (
                 "import sys; "
-                "sys.stdout.buffer.write(b'Content-Length: 20\\r\\n\\r\\n{'); "
+                "sys.stdout.buffer.write(b'{\"jsonrpc\":\"2.0\"'); "
                 "sys.stdout.flush()"
             ),
         ],

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@opengsd/gsd-pi",
-  "version": "1.5.0",
+  "version": "1.6.0",
   "description": "GSD Pi local-first coding agent",
   "license": "MIT",
   "repository": {
@@ -210,11 +210,11 @@
   },
   "optionalDependencies": {
     "@mariozechner/clipboard": "0.3.6",
-    "@opengsd/engine-darwin-arm64": "1.5.0",
-    "@opengsd/engine-darwin-x64": "1.5.0",
-    "@opengsd/engine-linux-arm64-gnu": "1.5.0",
-    "@opengsd/engine-linux-x64-gnu": "1.5.0",
-    "@opengsd/engine-win32-x64-msvc": "1.5.0",
+    "@opengsd/engine-darwin-arm64": "1.6.0",
+    "@opengsd/engine-darwin-x64": "1.6.0",
+    "@opengsd/engine-linux-arm64-gnu": "1.6.0",
+    "@opengsd/engine-linux-x64-gnu": "1.6.0",
+    "@opengsd/engine-win32-x64-msvc": "1.6.0",
     "fsevents": "~2.3.3",
     "koffi": "^2.9.0"
   },

package/packages/cloud-mcp-gateway/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@opengsd/cloud-mcp-gateway",
-  "version": "1.5.0",
+  "version": "1.6.0",
   "description": "Cloud MCP gateway for brokering remote MCP clients to local GSD runtimes",
   "license": "MIT",
   "repository": {
@@ -29,7 +29,7 @@
   },
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.27.1",
-    "@opengsd/mcp-server": "^1.5.0",
+    "@opengsd/mcp-server": "^1.6.0",
     "ws": "^8.20.0",
     "zod": "^4.0.0"
   },

package/packages/contracts/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@opengsd/contracts",
-  "version": "1.5.0",
+  "version": "1.6.0",
   "description": "Shared public contracts for GSD workspace boundaries",
   "license": "MIT",
   "gsd": {

package/packages/daemon/dist/orchestrator-agent.d.ts

@@ -0,0 +1,21 @@
+import type Anthropic from '@anthropic-ai/sdk';
+import type { MessageParam } from '@anthropic-ai/sdk/resources/messages/messages';
+import { type OrchestratorToolContext } from './orchestrator-tools.js';
+export interface OrchestratorAgentConfig {
+    model: string;
+    max_tokens: number;
+}
+export declare class OrchestratorAgent {
+    private readonly config;
+    private readonly toolContext;
+    private client;
+    private history;
+    constructor(config: OrchestratorAgentConfig, toolContext: OrchestratorToolContext, client?: Anthropic);
+    run(content: string): Promise<string>;
+    getHistory(): MessageParam[];
+    stop(): void;
+    private getClient;
+    private runToolLoop;
+    private trimHistory;
+}
+//# sourceMappingURL=orchestrator-agent.d.ts.map

package/packages/daemon/dist/orchestrator-agent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"orchestrator-agent.d.ts","sourceRoot":"","sources":["../src/orchestrator-agent.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,SAAS,MAAM,mBAAmB,CAAC;AAC/C,OAAO,KAAK,EACV,YAAY,EAKb,MAAM,+CAA+C,CAAC;AACvD,OAAO,EAGL,KAAK,uBAAuB,EAC7B,MAAM,yBAAyB,CAAC;AAEjC,MAAM,WAAW,uBAAuB;IACtC,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;CACpB;AAqCD,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA0B;IACjD,OAAO,CAAC,QAAQ,CAAC,WAAW,CAA0B;IACtD,OAAO,CAAC,MAAM,CAAmB;IACjC,OAAO,CAAC,OAAO,CAAsB;gBAGnC,MAAM,EAAE,uBAAuB,EAC/B,WAAW,EAAE,uBAAuB,EACpC,MAAM,CAAC,EAAE,SAAS;IAOd,GAAG,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAmB3C,UAAU,IAAI,YAAY,EAAE;IAI5B,IAAI,IAAI,IAAI;YAKE,SAAS;YAQT,WAAW;IAkDzB,OAAO,CAAC,WAAW;CAKpB"}

package/packages/daemon/dist/orchestrator-agent.js

@@ -0,0 +1,113 @@
+import { ORCHESTRATOR_TOOLS, executeOrchestratorTool, } from './orchestrator-tools.js';
+const SYSTEM_PROMPT = `You are GSD Control — a concise, capable orchestrator for managing GSD (Git Ship Done) coding agent sessions via Discord.
+
+You have tools to list projects, start sessions, get status, stop sessions, and inspect session details. Use them to fulfill the user's requests.
+
+Response guidelines:
+- Be terse and direct. No filler, no performed enthusiasm.
+- When reporting status, use bullet points with project name, status, duration, and cost.
+- When starting a session, confirm with the project name and session ID.
+- When stopping a session, confirm which session was stopped.
+- If something fails, say what went wrong plainly.
+- Use Discord markdown formatting (bold, code blocks) for readability.
+- Never expose internal error stack traces to the user — summarize the issue.`;
+const MAX_HISTORY = 30;
+const MAX_TOOL_ITERATIONS = 10;
+function resolveAnthropicApiKey() {
+    const apiKey = process.env.ANTHROPIC_API_KEY;
+    if (!apiKey) {
+        throw new Error('ANTHROPIC_API_KEY is required. Set it in your environment or run `gsd config`.');
+    }
+    return apiKey;
+}
+function isAuthError(message) {
+    return (message.includes('authentication') ||
+        message.includes('apiKey') ||
+        message.includes('authToken') ||
+        message.includes('401'));
+}
+export class OrchestratorAgent {
+    config;
+    toolContext;
+    client;
+    history = [];
+    constructor(config, toolContext, client) {
+        this.config = config;
+        this.toolContext = toolContext;
+        this.client = client ?? null;
+    }
+    async run(content) {
+        this.history.push({ role: 'user', content });
+        try {
+            const responseText = await this.runToolLoop();
+            this.history.push({ role: 'assistant', content: responseText });
+            return responseText;
+        }
+        catch (err) {
+            const errorMsg = err instanceof Error ? err.message : String(err);
+            if (isAuthError(errorMsg)) {
+                this.client = null;
+            }
+            this.history.push({ role: 'assistant', content: '[error — see logs]' });
+            throw err;
+        }
+        finally {
+            this.trimHistory();
+        }
+    }
+    getHistory() {
+        return [...this.history];
+    }
+    stop() {
+        this.history = [];
+        this.client = null;
+    }
+    async getClient() {
+        if (this.client)
+            return this.client;
+        const apiKey = resolveAnthropicApiKey();
+        const { default: AnthropicSDK } = await import('@anthropic-ai/sdk');
+        this.client = new AnthropicSDK({ apiKey });
+        return this.client;
+    }
+    async runToolLoop() {
+        const client = await this.getClient();
+        const { model, max_tokens } = this.config;
+        let loopMessages = [...this.history];
+        for (let i = 0; i < MAX_TOOL_ITERATIONS; i++) {
+            const response = await client.messages.create({
+                model,
+                max_tokens,
+                system: SYSTEM_PROMPT,
+                tools: ORCHESTRATOR_TOOLS,
+                messages: loopMessages,
+            });
+            if (response.stop_reason !== 'tool_use') {
+                const textBlocks = response.content.filter((b) => b.type === 'text');
+                return textBlocks.map((b) => b.text).join('\n') || '(No response)';
+            }
+            const toolUseBlocks = response.content.filter((b) => b.type === 'tool_use');
+            const toolResults = [];
+            for (const toolUse of toolUseBlocks) {
+                const result = await executeOrchestratorTool(this.toolContext, toolUse.name, toolUse.input);
+                toolResults.push({
+                    type: 'tool_result',
+                    tool_use_id: toolUse.id,
+                    content: result,
+                });
+            }
+            loopMessages = [
+                ...loopMessages,
+                { role: 'assistant', content: response.content },
+                { role: 'user', content: toolResults },
+            ];
+        }
+        return 'I hit the maximum number of tool iterations. Please try a simpler request.';
+    }
+    trimHistory() {
+        while (this.history.length > MAX_HISTORY) {
+            this.history.splice(0, 2);
+        }
+    }
+}
+//# sourceMappingURL=orchestrator-agent.js.map

package/packages/daemon/dist/orchestrator-agent.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"orchestrator-agent.js","sourceRoot":"","sources":["../src/orchestrator-agent.ts"],"names":[],"mappings":"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","sourcesContent":["import type Anthropic from '@anthropic-ai/sdk';\nimport type {\n  MessageParam,\n  ContentBlockParam,\n  ToolResultBlockParam,\n  ToolUseBlock,\n  TextBlock,\n} from '@anthropic-ai/sdk/resources/messages/messages';\nimport {\n  ORCHESTRATOR_TOOLS,\n  executeOrchestratorTool,\n  type OrchestratorToolContext,\n} from './orchestrator-tools.js';\n\nexport interface OrchestratorAgentConfig {\n  model: string;\n  max_tokens: number;\n}\n\nconst SYSTEM_PROMPT = `You are GSD Control — a concise, capable orchestrator for managing GSD (Git Ship Done) coding agent sessions via Discord.\n\nYou have tools to list projects, start sessions, get status, stop sessions, and inspect session details. Use them to fulfill the user's requests.\n\nResponse guidelines:\n- Be terse and direct. No filler, no performed enthusiasm.\n- When reporting status, use bullet points with project name, status, duration, and cost.\n- When starting a session, confirm with the project name and session ID.\n- When stopping a session, confirm which session was stopped.\n- If something fails, say what went wrong plainly.\n- Use Discord markdown formatting (bold, code blocks) for readability.\n- Never expose internal error stack traces to the user — summarize the issue.`;\n\nconst MAX_HISTORY = 30;\nconst MAX_TOOL_ITERATIONS = 10;\n\nfunction resolveAnthropicApiKey(): string {\n  const apiKey = process.env.ANTHROPIC_API_KEY;\n  if (!apiKey) {\n    throw new Error(\n      'ANTHROPIC_API_KEY is required. Set it in your environment or run `gsd config`.',\n    );\n  }\n  return apiKey;\n}\n\nfunction isAuthError(message: string): boolean {\n  return (\n    message.includes('authentication') ||\n    message.includes('apiKey') ||\n    message.includes('authToken') ||\n    message.includes('401')\n  );\n}\n\nexport class OrchestratorAgent {\n  private readonly config: OrchestratorAgentConfig;\n  private readonly toolContext: OrchestratorToolContext;\n  private client: Anthropic | null;\n  private history: MessageParam[] = [];\n\n  constructor(\n    config: OrchestratorAgentConfig,\n    toolContext: OrchestratorToolContext,\n    client?: Anthropic,\n  ) {\n    this.config = config;\n    this.toolContext = toolContext;\n    this.client = client ?? null;\n  }\n\n  async run(content: string): Promise<string> {\n    this.history.push({ role: 'user', content });\n\n    try {\n      const responseText = await this.runToolLoop();\n      this.history.push({ role: 'assistant', content: responseText });\n      return responseText;\n    } catch (err) {\n      const errorMsg = err instanceof Error ? err.message : String(err);\n      if (isAuthError(errorMsg)) {\n        this.client = null;\n      }\n      this.history.push({ role: 'assistant', content: '[error — see logs]' });\n      throw err;\n    } finally {\n      this.trimHistory();\n    }\n  }\n\n  getHistory(): MessageParam[] {\n    return [...this.history];\n  }\n\n  stop(): void {\n    this.history = [];\n    this.client = null;\n  }\n\n  private async getClient(): Promise<Anthropic> {\n    if (this.client) return this.client;\n    const apiKey = resolveAnthropicApiKey();\n    const { default: AnthropicSDK } = await import('@anthropic-ai/sdk');\n    this.client = new AnthropicSDK({ apiKey });\n    return this.client;\n  }\n\n  private async runToolLoop(): Promise<string> {\n    const client = await this.getClient();\n    const { model, max_tokens } = this.config;\n\n    let loopMessages: MessageParam[] = [...this.history];\n\n    for (let i = 0; i < MAX_TOOL_ITERATIONS; i++) {\n      const response = await client.messages.create({\n        model,\n        max_tokens,\n        system: SYSTEM_PROMPT,\n        tools: ORCHESTRATOR_TOOLS,\n        messages: loopMessages,\n      });\n\n      if (response.stop_reason !== 'tool_use') {\n        const textBlocks = response.content.filter(\n          (b): b is TextBlock => b.type === 'text',\n        );\n        return textBlocks.map((b) => b.text).join('\\n') || '(No response)';\n      }\n\n      const toolUseBlocks = response.content.filter(\n        (b): b is ToolUseBlock => b.type === 'tool_use',\n      );\n\n      const toolResults: ToolResultBlockParam[] = [];\n      for (const toolUse of toolUseBlocks) {\n        const result = await executeOrchestratorTool(\n          this.toolContext,\n          toolUse.name,\n          toolUse.input as Record<string, unknown>,\n        );\n        toolResults.push({\n          type: 'tool_result',\n          tool_use_id: toolUse.id,\n          content: result,\n        });\n      }\n\n      loopMessages = [\n        ...loopMessages,\n        { role: 'assistant', content: response.content as ContentBlockParam[] },\n        { role: 'user', content: toolResults },\n      ];\n    }\n\n    return 'I hit the maximum number of tool iterations. Please try a simpler request.';\n  }\n\n  private trimHistory(): void {\n    while (this.history.length > MAX_HISTORY) {\n      this.history.splice(0, 2);\n    }\n  }\n}\n"]}

package/packages/daemon/dist/orchestrator-tools.d.ts

@@ -0,0 +1,12 @@
+import type { Tool } from '@anthropic-ai/sdk/resources/messages/messages';
+import type { SessionManager } from './session-manager.js';
+import type { ProjectInfo } from './types.js';
+import type { Logger } from './logger.js';
+export interface OrchestratorToolContext {
+    sessionManager: SessionManager;
+    scanProjects: () => Promise<ProjectInfo[]>;
+    logger: Logger;
+}
+export declare const ORCHESTRATOR_TOOLS: Tool[];
+export declare function executeOrchestratorTool(context: OrchestratorToolContext, name: string, input: Record<string, unknown>): Promise<string>;
+//# sourceMappingURL=orchestrator-tools.d.ts.map

package/packages/daemon/dist/orchestrator-tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"orchestrator-tools.d.ts","sourceRoot":"","sources":["../src/orchestrator-tools.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,+CAA+C,CAAC;AAC1E,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAC3D,OAAO,KAAK,EAAE,WAAW,EAAkB,MAAM,YAAY,CAAC;AAC9D,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAE1C,MAAM,WAAW,uBAAuB;IACtC,cAAc,EAAE,cAAc,CAAC;IAC/B,YAAY,EAAE,MAAM,OAAO,CAAC,WAAW,EAAE,CAAC,CAAC;IAC3C,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,eAAO,MAAM,kBAAkB,EAAE,IAAI,EAqDpC,CAAC;AAeF,wBAAsB,uBAAuB,CAC3C,OAAO,EAAE,uBAAuB,EAChC,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC7B,OAAO,CAAC,MAAM,CAAC,CAqBjB"}

package/packages/daemon/dist/orchestrator-tools.js

@@ -0,0 +1,137 @@
+import { z } from 'zod';
+export const ORCHESTRATOR_TOOLS = [
+    {
+        name: 'list_projects',
+        description: 'List all detected projects across configured scan roots. Returns project names, paths, and detected markers (git, node, gsd, etc.).',
+        input_schema: {
+            type: 'object',
+            properties: {},
+            required: [],
+        },
+    },
+    {
+        name: 'start_session',
+        description: 'Start a new GSD auto-mode session for a project. Provide the absolute project path. Optionally provide a command to run instead of the default "/gsd auto".',
+        input_schema: {
+            type: 'object',
+            properties: {
+                projectPath: { type: 'string', description: 'Absolute path to the project directory' },
+                command: { type: 'string', description: 'Optional command to send instead of "/gsd auto"' },
+            },
+            required: ['projectPath'],
+        },
+    },
+    {
+        name: 'get_status',
+        description: 'Get the current status of all active GSD sessions. Shows project name, status, duration, and cost for each.',
+        input_schema: {
+            type: 'object',
+            properties: {},
+            required: [],
+        },
+    },
+    {
+        name: 'stop_session',
+        description: 'Stop a running GSD session. Provide a session ID or project name — fuzzy matching is used to find the session.',
+        input_schema: {
+            type: 'object',
+            properties: {
+                identifier: { type: 'string', description: 'Session ID or project name to match' },
+            },
+            required: ['identifier'],
+        },
+    },
+    {
+        name: 'get_session_detail',
+        description: 'Get detailed information about a specific session including cost breakdown, recent events, pending blockers, and error state.',
+        input_schema: {
+            type: 'object',
+            properties: {
+                sessionId: { type: 'string', description: 'The session ID to inspect' },
+            },
+            required: ['sessionId'],
+        },
+    },
+];
+const StartSessionInput = z.object({
+    projectPath: z.string(),
+    command: z.string().optional(),
+});
+const StopSessionInput = z.object({
+    identifier: z.string(),
+});
+const GetSessionDetailInput = z.object({
+    sessionId: z.string(),
+});
+export async function executeOrchestratorTool(context, name, input) {
+    try {
+        switch (name) {
+            case 'list_projects':
+                return await listProjects(context);
+            case 'start_session':
+                return await startSession(context, input);
+            case 'get_status':
+                return getStatus(context);
+            case 'get_session_detail':
+                return getSessionDetail(context, input);
+            case 'stop_session':
+                return await stopSession(context, input);
+            default:
+                return `Unknown tool: ${name}`;
+        }
+    }
+    catch (err) {
+        const msg = err instanceof Error ? err.message : String(err);
+        context.logger.error('tool execution error', { tool: name, error: msg });
+        return `Error: ${msg}`;
+    }
+}
+async function listProjects(context) {
+    const projects = await context.scanProjects();
+    if (projects.length === 0)
+        return 'No projects found.';
+    return JSON.stringify(projects.map((p) => ({ name: p.name, path: p.path, markers: p.markers })), null, 2);
+}
+async function startSession(context, input) {
+    const parsed = StartSessionInput.parse(input);
+    const sessionId = await context.sessionManager.startSession({
+        projectDir: parsed.projectPath,
+        command: parsed.command,
+    });
+    return `Session started: ${sessionId} for ${parsed.projectPath}`;
+}
+function getStatus(context) {
+    const sessions = context.sessionManager.getAllSessions();
+    if (sessions.length === 0)
+        return 'No active sessions.';
+    return sessions
+        .map((s) => {
+        const durationMin = Math.floor((Date.now() - s.startTime) / 60_000);
+        const cost = s.cost.totalCost.toFixed(4);
+        return `• ${s.projectName} — ${s.status} (${durationMin}m, $${cost})`;
+    })
+        .join('\n');
+}
+async function stopSession(context, input) {
+    const parsed = StopSessionInput.parse(input);
+    const { identifier } = parsed;
+    const byId = context.sessionManager.getSession(identifier);
+    if (byId) {
+        await context.sessionManager.cancelSession(identifier);
+        return `Stopped session ${identifier} (${byId.projectName})`;
+    }
+    const normalizedIdentifier = identifier.toLowerCase();
+    const match = context.sessionManager.getAllSessions().find((s) => s.projectName.toLowerCase().includes(normalizedIdentifier) ||
+        s.projectDir.toLowerCase().includes(normalizedIdentifier));
+    if (match) {
+        await context.sessionManager.cancelSession(match.sessionId);
+        return `Stopped session ${match.sessionId} (${match.projectName})`;
+    }
+    return `No session found matching "${identifier}"`;
+}
+function getSessionDetail(context, input) {
+    const parsed = GetSessionDetailInput.parse(input);
+    const result = context.sessionManager.getResult(parsed.sessionId);
+    return JSON.stringify(result, null, 2);
+}
+//# sourceMappingURL=orchestrator-tools.js.map

package/packages/daemon/dist/orchestrator-tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"orchestrator-tools.js","sourceRoot":"","sources":["../src/orchestrator-tools.ts"],"names":[],"mappings":"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","sourcesContent":["import { z } from 'zod';\nimport type { Tool } from '@anthropic-ai/sdk/resources/messages/messages';\nimport type { SessionManager } from './session-manager.js';\nimport type { ProjectInfo, ManagedSession } from './types.js';\nimport type { Logger } from './logger.js';\n\nexport interface OrchestratorToolContext {\n  sessionManager: SessionManager;\n  scanProjects: () => Promise<ProjectInfo[]>;\n  logger: Logger;\n}\n\nexport const ORCHESTRATOR_TOOLS: Tool[] = [\n  {\n    name: 'list_projects',\n    description: 'List all detected projects across configured scan roots. Returns project names, paths, and detected markers (git, node, gsd, etc.).',\n    input_schema: {\n      type: 'object' as const,\n      properties: {},\n      required: [],\n    },\n  },\n  {\n    name: 'start_session',\n    description: 'Start a new GSD auto-mode session for a project. Provide the absolute project path. Optionally provide a command to run instead of the default \"/gsd auto\".',\n    input_schema: {\n      type: 'object' as const,\n      properties: {\n        projectPath: { type: 'string', description: 'Absolute path to the project directory' },\n        command: { type: 'string', description: 'Optional command to send instead of \"/gsd auto\"' },\n      },\n      required: ['projectPath'],\n    },\n  },\n  {\n    name: 'get_status',\n    description: 'Get the current status of all active GSD sessions. Shows project name, status, duration, and cost for each.',\n    input_schema: {\n      type: 'object' as const,\n      properties: {},\n      required: [],\n    },\n  },\n  {\n    name: 'stop_session',\n    description: 'Stop a running GSD session. Provide a session ID or project name — fuzzy matching is used to find the session.',\n    input_schema: {\n      type: 'object' as const,\n      properties: {\n        identifier: { type: 'string', description: 'Session ID or project name to match' },\n      },\n      required: ['identifier'],\n    },\n  },\n  {\n    name: 'get_session_detail',\n    description: 'Get detailed information about a specific session including cost breakdown, recent events, pending blockers, and error state.',\n    input_schema: {\n      type: 'object' as const,\n      properties: {\n        sessionId: { type: 'string', description: 'The session ID to inspect' },\n      },\n      required: ['sessionId'],\n    },\n  },\n];\n\nconst StartSessionInput = z.object({\n  projectPath: z.string(),\n  command: z.string().optional(),\n});\n\nconst StopSessionInput = z.object({\n  identifier: z.string(),\n});\n\nconst GetSessionDetailInput = z.object({\n  sessionId: z.string(),\n});\n\nexport async function executeOrchestratorTool(\n  context: OrchestratorToolContext,\n  name: string,\n  input: Record<string, unknown>,\n): Promise<string> {\n  try {\n    switch (name) {\n      case 'list_projects':\n        return await listProjects(context);\n      case 'start_session':\n        return await startSession(context, input);\n      case 'get_status':\n        return getStatus(context);\n      case 'get_session_detail':\n        return getSessionDetail(context, input);\n      case 'stop_session':\n        return await stopSession(context, input);\n      default:\n        return `Unknown tool: ${name}`;\n    }\n  } catch (err) {\n    const msg = err instanceof Error ? err.message : String(err);\n    context.logger.error('tool execution error', { tool: name, error: msg });\n    return `Error: ${msg}`;\n  }\n}\n\nasync function listProjects(context: OrchestratorToolContext): Promise<string> {\n  const projects = await context.scanProjects();\n  if (projects.length === 0) return 'No projects found.';\n  return JSON.stringify(\n    projects.map((p) => ({ name: p.name, path: p.path, markers: p.markers })),\n    null,\n    2,\n  );\n}\n\nasync function startSession(\n  context: OrchestratorToolContext,\n  input: Record<string, unknown>,\n): Promise<string> {\n  const parsed = StartSessionInput.parse(input);\n  const sessionId = await context.sessionManager.startSession({\n    projectDir: parsed.projectPath,\n    command: parsed.command,\n  });\n  return `Session started: ${sessionId} for ${parsed.projectPath}`;\n}\n\nfunction getStatus(context: OrchestratorToolContext): string {\n  const sessions = context.sessionManager.getAllSessions();\n  if (sessions.length === 0) return 'No active sessions.';\n\n  return sessions\n    .map((s: ManagedSession) => {\n      const durationMin = Math.floor((Date.now() - s.startTime) / 60_000);\n      const cost = s.cost.totalCost.toFixed(4);\n      return `• ${s.projectName} — ${s.status} (${durationMin}m, $${cost})`;\n    })\n    .join('\\n');\n}\n\nasync function stopSession(\n  context: OrchestratorToolContext,\n  input: Record<string, unknown>,\n): Promise<string> {\n  const parsed = StopSessionInput.parse(input);\n  const { identifier } = parsed;\n\n  const byId = context.sessionManager.getSession(identifier);\n  if (byId) {\n    await context.sessionManager.cancelSession(identifier);\n    return `Stopped session ${identifier} (${byId.projectName})`;\n  }\n\n  const normalizedIdentifier = identifier.toLowerCase();\n  const match = context.sessionManager.getAllSessions().find(\n    (s: ManagedSession) =>\n      s.projectName.toLowerCase().includes(normalizedIdentifier) ||\n      s.projectDir.toLowerCase().includes(normalizedIdentifier),\n  );\n  if (match) {\n    await context.sessionManager.cancelSession(match.sessionId);\n    return `Stopped session ${match.sessionId} (${match.projectName})`;\n  }\n\n  return `No session found matching \"${identifier}\"`;\n}\n\nfunction getSessionDetail(\n  context: OrchestratorToolContext,\n  input: Record<string, unknown>,\n): string {\n  const parsed = GetSessionDetailInput.parse(input);\n  const result = context.sessionManager.getResult(parsed.sessionId);\n  return JSON.stringify(result, null, 2);\n}\n"]}

package/packages/daemon/dist/orchestrator.d.ts

@@ -1,14 +1,8 @@
 /**
- * Orchestrator — LLM-powered agent for the #gsd-control Discord channel.
+ * Orchestrator — Discord-facing controller for the #gsd-control channel.
  *
- * Receives Discord messages, maintains conversation history, calls the
- * Anthropic messages API with 5 tool definitions (list_projects, start_session,
- * get_status, stop_session, get_session_detail), and sends the LLM's response
- * back to Discord.
- *
- * Uses the standard messages.create() tool-use loop (not betaZodTool helpers,
- * which don't exist in SDK v0.52). Zod schemas are used for input validation
- * at the tool execution layer.
+ * Receives Discord messages, filters them by channel/owner/bot guards, delegates
+ * valid user content to OrchestratorAgent, and sends the response back to Discord.
  */
 import type Anthropic from '@anthropic-ai/sdk';
 import type { MessageParam } from '@anthropic-ai/sdk/resources/messages/messages';
@@ -31,58 +25,12 @@ export interface OrchestratorDeps {
 }
 export declare class Orchestrator {
     private readonly deps;
-    private client;
-    private history;
-    /**
-     * @param deps - orchestrator dependencies (session manager, channel manager, etc.)
-     * @param client - optional Anthropic client for testability; if omitted, created from env
-     */
+    private readonly agent;
     constructor(deps: OrchestratorDeps, client?: Anthropic);
-    /**
-     * Lazily initialise the Anthropic client. Dynamic import handles K007 module resolution.
-     * Requires ANTHROPIC_API_KEY environment variable.
-     */
-    private getClient;
-    /**
-     * Handle an incoming Discord message. Entry point called by the bot's
-     * message handler for every message in every channel.
-     *
-     * Guards: ignores bot messages, non-owner messages, and non-control-channel messages.
-     */
     handleMessage(message: DiscordMessageLike): Promise<void>;
-    /**
-     * Run the tool-use loop: call messages.create(), execute any tool calls,
-     * feed results back, repeat until the model produces a final text response.
-     */
-    private runAgentLoop;
-    /**
-     * Execute a single tool by name. Returns a string result for the LLM.
-     * All errors are caught and returned as error strings (the LLM can reason about them).
-     */
-    private executeTool;
-    private toolListProjects;
-    private toolStartSession;
-    private toolGetStatus;
-    private toolStopSession;
-    private toolGetSessionDetail;
-    /**
-     * Trim conversation history to MAX_HISTORY entries.
-     * Removes the oldest user+assistant pair from the front to keep pairs aligned.
-     */
-    private trimHistory;
-    /**
-     * Return a copy of the conversation history (for debugging / observability).
-     */
     getHistory(): MessageParam[];
-    /**
-     * Stop the orchestrator — clears history and nulls client reference.
-     */
     stop(): void;
 }
-/**
- * Minimal Discord message interface — avoids importing discord.js directly,
- * making the orchestrator testable without full discord.js mocking.
- */
 export interface DiscordMessageLike {
     author: {
         id: string;

package/packages/daemon/dist/orchestrator.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"orchestrator.d.ts","sourceRoot":"","sources":["../src/orchestrator.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAGH,OAAO,KAAK,SAAS,MAAM,mBAAmB,CAAC;AAC/C,OAAO,KAAK,EACV,YAAY,EAMb,MAAM,+CAA+C,CAAC;AACvD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAC3D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAC3D,OAAO,KAAK,EAAE,WAAW,EAAkB,MAAM,YAAY,CAAC;AAC9D,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAqB1C,MAAM,WAAW,kBAAkB;IACjC,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;IACnB,kBAAkB,EAAE,MAAM,CAAC;CAC5B;AAED,MAAM,WAAW,gBAAgB;IAC/B,cAAc,EAAE,cAAc,CAAC;IAC/B,cAAc,EAAE,cAAc,CAAC;IAC/B,YAAY,EAAE,MAAM,OAAO,CAAC,WAAW,EAAE,CAAC,CAAC;IAC3C,MAAM,EAAE,kBAAkB,CAAC;IAC3B,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;CACjB;AAyGD,qBAAa,YAAY;IACvB,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAmB;IACxC,OAAO,CAAC,MAAM,CAAmB;IACjC,OAAO,CAAC,OAAO,CAAsB;IAErC;;;OAGG;gBACS,IAAI,EAAE,gBAAgB,EAAE,MAAM,CAAC,EAAE,SAAS;IAKtD;;;OAGG;YACW,SAAS;IAQvB;;;;;OAKG;IACG,aAAa,CAAC,OAAO,EAAE,kBAAkB,GAAG,OAAO,CAAC,IAAI,CAAC;IAoE/D;;;OAGG;YACW,YAAY;IAyD1B;;;OAGG;YACW,WAAW;YA2BX,gBAAgB;YAUhB,gBAAgB;IAS9B,OAAO,CAAC,aAAa;YAaP,eAAe;IA0B7B,OAAO,CAAC,oBAAoB;IAU5B;;;OAGG;IACH,OAAO,CAAC,WAAW;IAOnB;;OAEG;IACH,UAAU,IAAI,YAAY,EAAE;IAI5B;;OAEG;IACH,IAAI,IAAI,IAAI;CAIb;AAMD;;;GAGG;AACH,MAAM,WAAW,kBAAkB;IACjC,MAAM,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,OAAO,CAAA;KAAE,CAAC;IACrC,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE;QACP,IAAI,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;QAC5C,UAAU,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC,CAAC;KACpC,CAAC;CACH"}
+{"version":3,"file":"orchestrator.d.ts","sourceRoot":"","sources":["../src/orchestrator.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,SAAS,MAAM,mBAAmB,CAAC;AAC/C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,+CAA+C,CAAC;AAClF,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAC3D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAC3D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAC9C,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAG1C,MAAM,WAAW,kBAAkB;IACjC,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;IACnB,kBAAkB,EAAE,MAAM,CAAC;CAC5B;AAED,MAAM,WAAW,gBAAgB;IAC/B,cAAc,EAAE,cAAc,CAAC;IAC/B,cAAc,EAAE,cAAc,CAAC;IAC/B,YAAY,EAAE,MAAM,OAAO,CAAC,WAAW,EAAE,CAAC,CAAC;IAC3C,MAAM,EAAE,kBAAkB,CAAC;IAC3B,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,qBAAa,YAAY;IACvB,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAmB;IACxC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAoB;gBAE9B,IAAI,EAAE,gBAAgB,EAAE,MAAM,CAAC,EAAE,SAAS;IAahD,aAAa,CAAC,OAAO,EAAE,kBAAkB,GAAG,OAAO,CAAC,IAAI,CAAC;IA+C/D,UAAU,IAAI,YAAY,EAAE;IAI5B,IAAI,IAAI,IAAI;CAGb;AAED,MAAM,WAAW,kBAAkB;IACjC,MAAM,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,OAAO,CAAA;KAAE,CAAC;IACrC,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE;QACP,IAAI,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;QAC5C,UAAU,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC,CAAC;KACpC,CAAC;CACH"}