@inharness-ai/claude4spec 1.0.4 → 1.0.6

package/dist/server/mcp/brief-tools.js

@@ -4,8 +4,8 @@
  * creation time. Mounted by `routes/chat.ts` ONLY for threads with
  * `context_type='brief'`.
  *
- * Four tools, no `create_brief`/`list_briefs`/`brief_generate` (those are
- * UI/user surface, not agent loop).
+ * Two tools (get_brief, update_brief) — no `create_brief`/`list_briefs`/
+ * `brief_generate` (UI/user surface, not agent loop).
  */
 import { createMcpServer, mcpTool } from '@inharness-ai/agent-adapters';
 import { z } from 'zod';
@@ -16,7 +16,7 @@ const AGENT_ACTIONS = z.enum(['replace', 'append', 'insert_after_section']);
 const ANCHOR_RE = new RegExp(ANCHOR_PATTERN_SOURCE);
 const HEADING_RE = /^(#{2,6})\s+(.+?)\s*$/;
 export function buildBriefToolsServer(ctx) {
-    const { briefService, pageVersions, briefPath } = ctx;
+    const { briefService, briefPath } = ctx;
     const ok = (payload) => ({
         content: [{ type: 'text', text: JSON.stringify(payload) }],
     });
@@ -88,30 +88,9 @@ export function buildBriefToolsServer(ctx) {
             return fail(err);
         }
     });
-    const listBriefVersions = mcpTool('list_brief_versions', 'List all versions of this thread\'s brief (metadata only). Use to inspect history before calling get_brief_version.', {}, async () => {
-        try {
-            return ok({ versions: pageVersions.listVersions(briefPath) });
-        }
-        catch (err) {
-            return fail(err);
-        }
-    });
-    const getBriefVersion = mcpTool('get_brief_version', 'Get a specific version snapshot of this brief (full content + metadata).', {
-        version: z.number().int().positive(),
-    }, async (args) => {
-        try {
-            const v = pageVersions.getVersion(briefPath, Number(args.version));
-            if (!v)
-                return fail(new DomainError('VERSION_NOT_FOUND', `version ${args.version} not found`));
-            return ok(v);
-        }
-        catch (err) {
-            return fail(err);
-        }
-    });
     return createMcpServer({
         name: 'brief-tools',
-        tools: [getBrief, updateBrief, listBriefVersions, getBriefVersion],
+        tools: [getBrief, updateBrief],
     });
 }
 function composeBody(prior, action, fragment, anchor, heading) {

package/dist/server/mcp/brief-tools.js.map

@@ -1 +1 @@
-{"version":3,"file":"brief-tools.js","sourceRoot":"","sources":["../../../src/server/mcp/brief-tools.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"brief-tools.js","sourceRoot":"","sources":["../../../src/server/mcp/brief-tools.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,eAAe,EAAE,OAAO,EAA0B,MAAM,8BAA8B,CAAC;AAChG,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAClD,OAAO,EAAE,qBAAqB,EAAE,MAAM,gCAAgC,CAAC;AAQvE,MAAM,aAAa,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,QAAQ,EAAE,sBAAsB,CAAC,CAAC,CAAC;AAC5E,MAAM,SAAS,GAAG,IAAI,MAAM,CAAC,qBAAqB,CAAC,CAAC;AACpD,MAAM,UAAU,GAAG,uBAAuB,CAAC;AAE3C,MAAM,UAAU,qBAAqB,CAAC,GAAsB;IAC1D,MAAM,EAAE,YAAY,EAAE,SAAS,EAAE,GAAG,GAAG,CAAC;IAExC,MAAM,EAAE,GAAG,CAAC,OAAgB,EAAE,EAAE,CAAC,CAAC;QAChC,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,EAAE,CAAC;KACpE,CAAC,CAAC;IACH,MAAM,IAAI,GAAG,CAAC,GAAY,EAAE,EAAE;QAC5B,IAAI,IAAI,GAAG,UAAU,CAAC;QACtB,IAAI,OAAO,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QAC/D,IAAI,GAAG,YAAY,WAAW;YAAE,IAAI,GAAG,GAAG,CAAC,IAAI,CAAC;aAC3C,IAAI,GAAG,YAAY,aAAa;YAAE,IAAI,GAAG,GAAG,CAAC,IAAI,CAAC;QACvD,OAAO;YACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC;YACpF,OAAO,EAAE,IAAI;SACd,CAAC;IACJ,CAAC,CAAC;IAEF,MAAM,QAAQ,GAAG,OAAO,CACtB,WAAW,EACX;QACE,mEAAmE;QACnE,4EAA4E;QAC5E,6DAA6D;QAC7D,0EAA0E;QAC1E,yEAAyE;KAC1E,CAAC,IAAI,CAAC,GAAG,CAAC,EACX,EAAE,EACF,KAAK,IAAI,EAAE;QACT,IAAI,CAAC;YACH,MAAM,KAAK,GAAG,MAAM,YAAY,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC;YACrD,OAAO,EAAE,CAAC,KAAK,CAAC,CAAC;QACnB,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC;QACnB,CAAC;IACH,CAAC,CACF,CAAC;IAEF,MAAM,WAAW,GAAG,OAAO,CACzB,cAAc,EACd;QACE,8CAA8C;QAC9C,mEAAmE;QACnE,2CAA2C;QAC3C,gFAAgF;QAChF,oFAAoF;QACpF,8EAA8E;QAC9E,kFAAkF;QAClF,uEAAuE;QACvE,iEAAiE;QACjE,kFAAkF;QAClF,4DAA4D;QAC5D,uEAAuE;KACxE,CAAC,IAAI,CAAC,GAAG,CAAC,EACX;QACE,MAAM,EAAE,aAAa;QACrB,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE;QACnB,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;QAC7B,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;QAC9B,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;QACnC,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;KACrC,EACD,KAAK,EAAE,IAAI,EAAE,EAAE;QACb,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,IAAI,CAAC,MAAuD,CAAC;YAC5E,MAAM,OAAO,GAAG,MAAM,YAAY,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC;YACvD,MAAM,OAAO,GAAG,WAAW,CACzB,OAAO,CAAC,IAAI,EACZ,MAAM,EACN,MAAM,CAAC,IAAI,CAAC,OAAO,IAAI,EAAE,CAAC,EAC1B,OAAO,IAAI,CAAC,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS,EACzD,OAAO,IAAI,CAAC,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,CAC5D,CAAC;YACF,4EAA4E;YAC5E,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,aAAa,CAAC,CAAC;YAC3C,MAAM,UAAU,GAAG,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,OAAO,EAAE,OAAO,CAAC,WAAsC,CAAC,CAAC;YACrG,MAAM,MAAM,GAAG,MAAM,YAAY,CAAC,aAAa,CAAC;gBAC9C,IAAI,EAAE,SAAS;gBACf,OAAO,EAAE,UAAU;gBACnB,YAAY,EAAE,OAAO,IAAI,CAAC,YAAY,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI;gBACtF,SAAS,EAAE,OAAO;gBAClB,aAAa,EAAE,OAAO,IAAI,CAAC,aAAa,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC,SAAS;aACvF,CAAC,CAAC;YACH,OAAO,EAAE,CAAC,EAAE,OAAO,EAAE,MAAM,CAAC,OAAO,EAAE,CAAC,CAAC;QACzC,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC;QACnB,CAAC;IACH,CAAC,CACF,CAAC;IAEF,OAAO,eAAe,CAAC;QACrB,IAAI,EAAE,aAAa;QACnB,KAAK,EAAE,CAAC,QAAQ,EAAE,WAAW,CAAC;KAC/B,CAAC,CAAC;AACL,CAAC;AAED,SAAS,WAAW,CAClB,KAAa,EACb,MAAqD,EACrD,QAAgB,EAChB,MAAe,EACf,OAAgB;IAEhB,QAAQ,MAAM,EAAE,CAAC;QACf,KAAK,SAAS;YACZ,OAAO,QAAQ,CAAC;QAClB,KAAK,QAAQ,CAAC,CAAC,CAAC;YACd,IAAI,KAAK,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC;gBAAE,OAAO,QAAQ,CAAC;YAC/C,MAAM,GAAG,GAAG,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC;YACjD,OAAO,GAAG,KAAK,GAAG,GAAG,GAAG,QAAQ,EAAE,CAAC;QACrC,CAAC;QACD,KAAK,sBAAsB;YACzB,IAAI,CAAC,MAAM,IAAI,CAAC,OAAO,EAAE,CAAC;gBACxB,MAAM,IAAI,WAAW,CAAC,gBAAgB,EAAE,iDAAiD,CAAC,CAAC;YAC7F,CAAC;YACD,OAAO,kBAAkB,CAAC,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC;IAChE,CAAC;AACH,CAAC;AAED,SAAS,kBAAkB,CAAC,KAAa,EAAE,QAAgB,EAAE,MAAe,EAAE,OAAgB;IAC5F,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAChC,IAAI,UAAU,GAAG,CAAC,CAAC,CAAC;IACpB,IAAI,WAAW,GAAG,CAAC,CAAC,CAAC;IACrB,MAAM,OAAO,GAA2C,EAAE,CAAC;IAE3D,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACtC,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,CAAE,CAAC;QACvB,MAAM,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;QACjC,IAAI,CAAC,CAAC;YAAE,SAAS;QACjB,MAAM,KAAK,GAAG,CAAC,CAAC,CAAC,CAAE,CAAC,MAAM,CAAC;QAC3B,MAAM,IAAI,GAAG,CAAC,CAAC,CAAC,CAAE,CAAC,IAAI,EAAE,CAAC;QAC1B,IAAI,MAAM,EAAE,CAAC;YACX,MAAM,IAAI,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,CAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACxC,MAAM,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;YACjC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,KAAK,MAAM,EAAE,CAAC;gBAC3B,UAAU,GAAG,CAAC,CAAC;gBACf,WAAW,GAAG,KAAK,CAAC;gBACpB,MAAM;YACR,CAAC;QACH,CAAC;aAAM,IAAI,OAAO,IAAI,IAAI,KAAK,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC;YAC9C,OAAO,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC;QACnC,CAAC;IACH,CAAC;IAED,IAAI,UAAU,KAAK,CAAC,CAAC,IAAI,OAAO,IAAI,CAAC,MAAM,EAAE,CAAC;QAC5C,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACzB,0EAA0E;YAC1E,mFAAmF;YACnF,OAAO,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,GAAG,KAAK,KAAK,QAAQ,EAAE,CAAC,CAAC,CAAC,GAAG,KAAK,OAAO,QAAQ,EAAE,CAAC;QACpF,CAAC;QACD,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACvB,MAAM,IAAI,WAAW,CAAC,mBAAmB,EAAE,YAAY,OAAO,aAAa,OAAO,CAAC,MAAM,WAAW,CAAC,CAAC;QACxG,CAAC;QACD,UAAU,GAAG,OAAO,CAAC,CAAC,CAAE,CAAC,IAAI,CAAC;QAC9B,WAAW,GAAG,OAAO,CAAC,CAAC,CAAE,CAAC,KAAK,CAAC;IAClC,CAAC;IAED,IAAI,UAAU,KAAK,CAAC,CAAC,EAAE,CAAC;QACtB,yEAAyE;QACzE,OAAO,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,GAAG,KAAK,KAAK,QAAQ,EAAE,CAAC,CAAC,CAAC,GAAG,KAAK,OAAO,QAAQ,EAAE,CAAC;IACpF,CAAC;IAED,IAAI,OAAO,GAAG,KAAK,CAAC,MAAM,CAAC;IAC3B,KAAK,IAAI,CAAC,GAAG,UAAU,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACnD,MAAM,CAAC,GAAG,KAAK,CAAC,CAAC,CAAE,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;QACtC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAE,CAAC,MAAM,IAAI,WAAW,EAAE,CAAC;YACrC,OAAO,GAAG,CAAC,CAAC;YACZ,MAAM;QACR,CAAC;IACH,CAAC;IACD,MAAM,MAAM,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAClD,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC9C,MAAM,GAAG,GAAG,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC;IACjF,MAAM,QAAQ,GAAG,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC;IAChD,OAAO,GAAG,MAAM,GAAG,GAAG,GAAG,QAAQ,GAAG,QAAQ,GAAG,KAAK,EAAE,CAAC,OAAO,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;AACpF,CAAC"}

package/dist/server/mcp/c4s-tools.d.ts

@@ -0,0 +1,15 @@
+import { type McpServerInstance } from '@inharness-ai/agent-adapters';
+/**
+ * `c4s-tools` — cross-cutting in-process MCP server expozujacy `c4s ask`
+ * jako narzedzie MCP. Jeden tool `ask`, mountowany per request (jak `plan-tools`).
+ *
+ * Motywacja: w `plan_mode=true` agent ma `disallowedTools = MUTATING_BUILTINS`
+ * (Bash zakazany), wiec nie moglby zawolac binarki `c4s ask`. MCP nie podlega
+ * temu filtrowi, wiec `mcp__c4s-tools__ask` dziala w plan_mode i poza nim,
+ * bez zdejmowania bana na Bash.
+ *
+ * Stateless — w odroznieniu od `plan-tools` (gdzie `threadId` jest ambient
+ * z closure), `c4s-tools.ask` celuje w **innego** peera, wszystkie parametry
+ * przychodza jako input. Brak `ctx` w fabryce.
+ */
+export declare function buildC4sToolsServer(): McpServerInstance;

package/dist/server/mcp/c4s-tools.js

@@ -0,0 +1,67 @@
+import { createMcpServer, mcpTool } from '@inharness-ai/agent-adapters';
+import { z } from 'zod';
+import { runAsk, AskError } from '../../core/ask/run-ask.js';
+/**
+ * `c4s-tools` — cross-cutting in-process MCP server expozujacy `c4s ask`
+ * jako narzedzie MCP. Jeden tool `ask`, mountowany per request (jak `plan-tools`).
+ *
+ * Motywacja: w `plan_mode=true` agent ma `disallowedTools = MUTATING_BUILTINS`
+ * (Bash zakazany), wiec nie moglby zawolac binarki `c4s ask`. MCP nie podlega
+ * temu filtrowi, wiec `mcp__c4s-tools__ask` dziala w plan_mode i poza nim,
+ * bez zdejmowania bana na Bash.
+ *
+ * Stateless — w odroznieniu od `plan-tools` (gdzie `threadId` jest ambient
+ * z closure), `c4s-tools.ask` celuje w **innego** peera, wszystkie parametry
+ * przychodza jako input. Brak `ctx` w fabryce.
+ */
+export function buildC4sToolsServer() {
+    const ask = mcpTool('ask', [
+        'Consult another claude4spec specification synchronously. Returns { threadId, answer }.',
+        'Use `project` (local path to peer .claude4spec/) OR `server` (URL override); if both, `server` wins.',
+        'Continue an existing peer thread by passing its `threadId` (omit `contextType` then).',
+        'Works in plan_mode — MCP is not filtered by READONLY_BUILTINS, so this works where Bash-shelled `c4s ask` does not.',
+        'Same contract as the `c4s` CLI: same discovery, same errors.',
+    ].join('\n'), {
+        message: z.string(),
+        project: z.string().optional(),
+        server: z.string().optional(),
+        contextType: z.enum(['chat', 'brief', 'patch']).optional(),
+        threadId: z.string().optional(),
+        brief: z.string().optional(),
+    }, async (input) => {
+        try {
+            const result = await runAsk({
+                message: String(input.message ?? ''),
+                project: typeof input.project === 'string' ? input.project : undefined,
+                server: typeof input.server === 'string' ? input.server : undefined,
+                contextType: typeof input.contextType === 'string'
+                    ? input.contextType
+                    : undefined,
+                threadId: typeof input.threadId === 'string' ? input.threadId : undefined,
+                briefPath: typeof input.brief === 'string' ? input.brief : undefined,
+            });
+            return {
+                content: [{ type: 'text', text: JSON.stringify(result) }],
+            };
+        }
+        catch (err) {
+            const code = err instanceof AskError ? err.code : 'AGENT_ERROR';
+            const message = err instanceof Error ? err.message : String(err);
+            const hint = err instanceof AskError ? err.hint : undefined;
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: JSON.stringify({ error: { code, message, ...(hint ? { hint } : {}) } }),
+                    },
+                ],
+                isError: true,
+            };
+        }
+    });
+    return createMcpServer({
+        name: 'c4s-tools',
+        tools: [ask],
+    });
+}
+//# sourceMappingURL=c4s-tools.js.map

package/dist/server/mcp/c4s-tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"c4s-tools.js","sourceRoot":"","sources":["../../../src/server/mcp/c4s-tools.ts"],"names":[],"mappings":"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"}

package/dist/server/routes/agent-turn.d.ts

@@ -0,0 +1,92 @@
+import { EventEmitter } from 'node:events';
+import { type RuntimeAdapter, type StreamObserver, type UserInputHandler, type UserInputResponse } from '@inharness-ai/agent-adapters';
+import type { ChatService } from '../services/chat.js';
+import type { PagesService } from '../services/pages.js';
+import type { TagsService } from '../services/tags.js';
+import type { SectionsService } from '../services/sections.js';
+import type { PlanService } from '../services/plan.js';
+import type { BriefService } from '../services/brief.js';
+import type { PatchService } from '../services/patch.js';
+import type { PageVersionService } from '../services/page-version.js';
+import type { SkillResolver, SkillRegistry } from '../services/skill-registry.js';
+import type { Annotation, ChatThread } from '../../shared/entities.js';
+import type { WsGateway } from '../ws/gateway.js';
+import type { Db } from '../db/index.js';
+/** Deps potrzebne do uruchomienia tury agenta. Wspolne dla `POST /api/chat`
+ *  (SSE) i `POST /api/threads/:id/ask` (headless). */
+export interface AgentTurnDeps {
+    chatService: ChatService;
+    pagesService: PagesService;
+    tagsService: TagsService;
+    sectionsService: SectionsService;
+    planService: PlanService;
+    briefService: BriefService;
+    patchService: PatchService;
+    pageVersions: PageVersionService;
+    skillResolver: SkillResolver;
+    skillRegistry: SkillRegistry;
+    ws: WsGateway;
+    cwd: string;
+    pagesDir: string;
+    mode: 'dev' | 'prod';
+    db: Db;
+}
+export declare const ALLOWED_MODELS: readonly ["sonnet-4.6", "opus-4.7", "haiku-4.5"];
+export type Model = (typeof ALLOWED_MODELS)[number];
+interface PendingInput {
+    resolve: (response: UserInputResponse) => void;
+    reject: (reason: unknown) => void;
+    requestIdsForRequest: string;
+}
+export interface ActiveAdapter {
+    requestId: string;
+    adapter: RuntimeAdapter;
+    emitter: EventEmitter;
+}
+export declare const activeAdapters: Map<string, ActiveAdapter>;
+export declare const pendingInputs: Map<string, PendingInput>;
+export declare function cancelPendingForRequest(requestId: string): void;
+/** Typed blad tury — pozwala konsumentom (headless `ask`) zmapowac powod
+ *  zakonczenia na status HTTP. Te same kody co SSE `event: error`. */
+export declare class AgentTurnError extends Error {
+    code: 'ABORTED' | 'TIMEOUT' | 'AGENT_UNAVAILABLE' | 'AGENT_ERROR';
+    constructor(code: 'ABORTED' | 'TIMEOUT' | 'AGENT_UNAVAILABLE' | 'AGENT_ERROR', message: string);
+}
+type TurnEvent = {
+    type: string;
+} & Record<string, unknown>;
+export interface AgentTurnInput {
+    /** Watek juz rozwiazany przez callera (+ planMode zaaplikowany). */
+    thread: ChatThread;
+    prompt: string;
+    annotations?: Annotation[];
+    model: Model;
+    currentPage?: string | null;
+    architectureConfig: Record<string, unknown>;
+    requestId: string;
+    consoleObserver: StreamObserver | null;
+    /** Transport callera — SSE forwarder dla `POST /api/chat`, no-op dla `ask`. */
+    onEvent: (event: TurnEvent) => void;
+    /** Interaktywny kanal user-input. Brak = headless (np. `ask`). */
+    onUserInput?: UserInputHandler;
+}
+export interface AgentTurnResult {
+    threadId: string;
+    answer: string;
+}
+/**
+ * Uruchamia jedna ture agenta dla istniejacego watku: wstawia wiadomosc user,
+ * buduje runtime przez rejestr `context_type`, wykonuje `adapter.execute(...)`,
+ * persystuje eventy mapperem `UnifiedEvent → chat_message`. Caller wybiera
+ * transport przez `onEvent` (SSE vs collapse). Zwraca `{ threadId, answer }`,
+ * gdzie `answer` to skolapsowany tekst assistant tej tury.
+ *
+ * Pre-flight `activeAdapters.has` (→ 409) NALEZY do callera; ta funkcja
+ * rejestruje adapter w `activeAdapters` i zwalnia go w `finally`.
+ */
+export declare function runAgentTurn(deps: AgentTurnDeps, input: AgentTurnInput): Promise<AgentTurnResult>;
+export declare function countPages(tree: Array<{
+    type: string;
+    children?: unknown[];
+}>): number;
+export {};

package/dist/server/routes/agent-turn.js

@@ -0,0 +1,386 @@
+import { EventEmitter } from 'node:events';
+import { createAdapter, observeStream, AdapterAbortError, AdapterInitError, AdapterTimeoutError, } from '@inharness-ai/agent-adapters';
+import { buildPlanToolsServer } from '../mcp/plan-tools.js';
+import { buildBriefToolsServer } from '../mcp/brief-tools.js';
+import { buildC4sToolsServer } from '../mcp/c4s-tools.js';
+import { buildSystemPrompt } from '../services/chat-context.js';
+import { readConfig } from '../config.js';
+import { pluginHost } from '../core/plugin-host/host.js';
+/** M21 m05ctxreg: tools whitelist per context_type. Brief threads get only
+ *  brief-tools (per-thread, mounted below) + release-tools (read-only).
+ *  All other plugin servers (endpoint-tools, dto-tools, ui-view-tools,
+ *  database-table-tools, plan-tools, reference-tools) are NOT mounted. */
+const BRIEF_ALLOWED_PLUGIN_MCP = new Set(['release-tools']);
+export const ALLOWED_MODELS = ['sonnet-4.6', 'opus-4.7', 'haiku-4.5'];
+// Wspoldzielone rejestry — keyed by threadId, jeden aktywny adapter per watek.
+// `POST /api/chat` i `POST /api/threads/:id/ask` importuja te same instancje:
+// drugi POST/ask na ten sam watek dostaje 409, a GET /api/chat/stream/:threadId
+// dolacza do zywego streamu niezaleznie od tego, ktory endpoint go uruchomil.
+export const activeAdapters = new Map();
+export const pendingInputs = new Map();
+export function cancelPendingForRequest(requestId) {
+    for (const [inputId, pending] of pendingInputs) {
+        if (pending.requestIdsForRequest === requestId) {
+            pending.reject(new Error('stream aborted'));
+            pendingInputs.delete(inputId);
+        }
+    }
+}
+/** Typed blad tury — pozwala konsumentom (headless `ask`) zmapowac powod
+ *  zakonczenia na status HTTP. Te same kody co SSE `event: error`. */
+export class AgentTurnError extends Error {
+    code;
+    constructor(code, message) {
+        super(message);
+        this.code = code;
+        this.name = 'AgentTurnError';
+    }
+}
+/**
+ * Uruchamia jedna ture agenta dla istniejacego watku: wstawia wiadomosc user,
+ * buduje runtime przez rejestr `context_type`, wykonuje `adapter.execute(...)`,
+ * persystuje eventy mapperem `UnifiedEvent → chat_message`. Caller wybiera
+ * transport przez `onEvent` (SSE vs collapse). Zwraca `{ threadId, answer }`,
+ * gdzie `answer` to skolapsowany tekst assistant tej tury.
+ *
+ * Pre-flight `activeAdapters.has` (→ 409) NALEZY do callera; ta funkcja
+ * rejestruje adapter w `activeAdapters` i zwalnia go w `finally`.
+ */
+export async function runAgentTurn(deps, input) {
+    const { thread, prompt, requestId } = input;
+    const annotations = input.annotations ?? [];
+    const currentPage = input.currentPage ?? null;
+    const planMode = thread.planMode;
+    const adapter = createAdapter('claude-code');
+    const emitter = new EventEmitter();
+    activeAdapters.set(thread.id, { requestId, adapter, emitter });
+    // `onEvent` to transport callera; `emitter` zasila GET /api/chat/stream/:threadId.
+    const emit = (event) => {
+        input.onEvent(event);
+        emitter.emit('event', event);
+    };
+    emit({ type: 'connected', requestId, threadId: thread.id });
+    let assistantBuf = '';
+    let thinkingBuf = '';
+    // Skolapsowana odpowiedz tury — wszystkie main-agent `text_delta` zlaczone.
+    // Nie resetowane przy flush; zwracane jako `answer` po terminalnym evencie.
+    let answerBuf = '';
+    const subagentBuffers = new Map();
+    let lastMainAssistantRowId = null;
+    let lastToolResultRowId = null;
+    let lastTurnUsage = null;
+    const getSubBuf = (taskId) => {
+        let buf = subagentBuffers.get(taskId);
+        if (!buf) {
+            buf = { text: '', thinking: '' };
+            subagentBuffers.set(taskId, buf);
+        }
+        return buf;
+    };
+    const flushSubBuf = (taskId) => {
+        const buf = subagentBuffers.get(taskId);
+        if (!buf)
+            return;
+        if (buf.text) {
+            deps.chatService.addMessage(thread.id, 'assistant', JSON.stringify({ text: buf.text }), null, null, taskId);
+            buf.text = '';
+        }
+        if (buf.thinking) {
+            deps.chatService.addMessage(thread.id, 'assistant', JSON.stringify({ text: buf.thinking, thinking: true }), null, null, taskId);
+            buf.thinking = '';
+        }
+    };
+    const flushMainBuf = () => {
+        if (assistantBuf) {
+            const row = deps.chatService.addMessage(thread.id, 'assistant', JSON.stringify({ text: assistantBuf }));
+            lastMainAssistantRowId = row.id;
+            assistantBuf = '';
+        }
+        if (thinkingBuf) {
+            deps.chatService.addMessage(thread.id, 'assistant', JSON.stringify({ text: thinkingBuf, thinking: true }));
+            thinkingBuf = '';
+        }
+    };
+    try {
+        deps.chatService.addMessage(thread.id, 'user', JSON.stringify({ text: prompt, annotations }), null, null, null, planMode);
+        if (!thread.title) {
+            const title = prompt.slice(0, 60) + (prompt.length > 60 ? '...' : '');
+            deps.chatService.updateTitle(thread.id, title || '(annotations only)');
+        }
+        const isBrief = thread.contextType === 'brief';
+        // M23: patch threads keep the FULL spec-editing toolset (isBrief stays
+        // false) — their job is to edit the spec. Only the system prompt differs.
+        const isPatch = thread.contextType === 'patch';
+        // M21: dla brief context czytamy aktualny snapshot brief'u (frontmatter+body+hash)
+        // i wkladamy do system promptu. Skip kosztownych obliczen pageCount/entityCounts.
+        let briefSnapshot = null;
+        if (isBrief && thread.briefPath) {
+            try {
+                briefSnapshot = await deps.briefService.getBrief(thread.briefPath);
+            }
+            catch (err) {
+                console.warn(`[chat] brief read failed for ${thread.briefPath}:`, err.message);
+            }
+        }
+        // M23: dla patch context czytamy snapshot patcha i wkladamy do system promptu.
+        let patchSnapshot = null;
+        if (isPatch && thread.patchPath) {
+            try {
+                patchSnapshot = await deps.patchService.getPatch(thread.patchPath);
+            }
+            catch (err) {
+                console.warn(`[chat] patch read failed for ${thread.patchPath}:`, err.message);
+            }
+        }
+        let currentPageBody = null;
+        if (!isBrief && currentPage) {
+            try {
+                const page = await deps.pagesService.read(currentPage);
+                currentPageBody = page.body;
+            }
+            catch {
+                currentPageBody = null;
+            }
+        }
+        // Stale-plan reminder MUSI byc sprawdzony PRZED markPlanSeenByThread —
+        // ten ostatni bumpuje last_seen_plan_version i zapodaje sygnal "synced".
+        const isFirstTurn = !thread.hasSystemPrompt;
+        const stalePlanReminder = isBrief ? null : deps.planService.getStalePlanReminder(thread.id);
+        const currentPlan = isBrief ? null : deps.planService.getByThread(thread.id);
+        // Skill resolution: writing-style (config.writingStyle, M15) ladowany
+        // niezaleznie od kontekstu. Dla brief context dokladamy bundled `brief-author`.
+        const writingStyleSkills = deps.skillResolver.resolve();
+        const writingStyle = writingStyleSkills[0]
+            ? {
+                slug: writingStyleSkills[0].name,
+                title: String(writingStyleSkills[0].metadata?.title ?? writingStyleSkills[0].name),
+            }
+            : null;
+        const inlineSkills = [...writingStyleSkills];
+        if (isBrief && deps.skillRegistry.has('brief-author')) {
+            const skill = deps.skillRegistry.resolve('brief-author');
+            inlineSkills.push({
+                name: skill.metadata.slug,
+                description: skill.metadata.description,
+                content: skill.content,
+                files: skill.files,
+                metadata: {
+                    version: skill.metadata.version,
+                    language: skill.metadata.language,
+                    title: skill.metadata.title,
+                },
+            });
+        }
+        const pageCount = isBrief ? 0 : countPages(await deps.pagesService.listTree());
+        const systemPrompt = buildSystemPrompt({
+            projectName: readConfig(deps.cwd).name,
+            cwd: deps.cwd,
+            pagesDir: deps.pagesDir,
+            currentPagePath: currentPage,
+            currentPageBody,
+            pageCount,
+            entityCounts: isBrief ? {} : pluginHost.computeEntityCounts(deps.db.handle),
+            tagCount: isBrief ? 0 : deps.tagsService.list().length,
+            sectionCount: isBrief ? 0 : deps.sectionsService.count(),
+            annotations,
+            planMode,
+            currentPlan,
+            planToolsAvailable: !isBrief,
+            c4sToolsAvailable: !isBrief,
+            writingStyle,
+            contextType: thread.contextType,
+            brief: briefSnapshot,
+            patch: patchSnapshot,
+        });
+        // claude-code CLI po resumeSessionId ignoruje kolejne systemPrompty —
+        // wiążący dla audytu jest tylko pierwszy. UPDATE idempotentny (no-op na 2.+ turze).
+        deps.chatService.setInitialSystemPrompt(thread.id, systemPrompt);
+        if (isFirstTurn && currentPlan) {
+            deps.planService.markPlanSeenByThread(thread.id);
+        }
+        // M21 m05ctxreg: per-thread MCP servers depend on context_type.
+        const planTools = isBrief
+            ? null
+            : buildPlanToolsServer({
+                threadId: thread.id,
+                planService: deps.planService,
+            });
+        const briefTools = isBrief && thread.briefPath
+            ? buildBriefToolsServer({
+                threadId: thread.id,
+                briefPath: thread.briefPath,
+                briefService: deps.briefService,
+            })
+            : null;
+        // M24 c4s-tools: cross-cutting MCP exposing `c4s ask` flow. Stateless,
+        // fresh factory per request. Whitelist: chat + patch contexts; brief is
+        // intentionally narrow (brief-tools + read-only release-tools only).
+        const c4sTools = isBrief ? null : buildC4sToolsServer();
+        const pluginMcpEntries = pluginHost
+            .buildMcpServers()
+            .filter(({ name }) => (isBrief ? BRIEF_ALLOWED_PLUGIN_MCP.has(name) : true))
+            .map(({ name, server }) => [name, server.config]);
+        const mcpServers = Object.fromEntries(pluginMcpEntries);
+        if (planTools)
+            mcpServers['plan-tools'] = planTools.config;
+        if (briefTools)
+            mcpServers['brief-tools'] = briefTools.config;
+        if (c4sTools)
+            mcpServers['c4s-tools'] = c4sTools.config;
+        const effectivePrompt = stalePlanReminder ? `${stalePlanReminder}\n\n${prompt}` : prompt;
+        const stream = adapter.execute({
+            prompt: effectivePrompt,
+            systemPrompt,
+            model: input.model,
+            cwd: deps.cwd,
+            mcpServers,
+            skills: inlineSkills,
+            resumeSessionId: thread.lastSessionId ?? undefined,
+            architectureConfig: input.architectureConfig,
+            planMode,
+            onUserInput: input.onUserInput,
+        });
+        const observed = input.consoleObserver
+            ? observeStream(stream, [input.consoleObserver])
+            : stream;
+        for await (const event of observed) {
+            emit(event);
+            switch (event.type) {
+                case 'text_delta':
+                    if (event.isSubagent && event.subagentTaskId) {
+                        getSubBuf(event.subagentTaskId).text += event.text;
+                    }
+                    else if (!event.isSubagent) {
+                        assistantBuf += event.text;
+                        answerBuf += event.text;
+                    }
+                    break;
+                case 'thinking':
+                    if (event.isSubagent && event.subagentTaskId) {
+                        getSubBuf(event.subagentTaskId).thinking += event.text;
+                    }
+                    else if (!event.isSubagent) {
+                        thinkingBuf += event.text;
+                    }
+                    break;
+                case 'assistant_message': {
+                    if (!event.message.subagentTaskId && event.message.usage) {
+                        lastTurnUsage = event.message.usage;
+                        deps.chatService.setLastUsage(thread.id, event.message.usage);
+                    }
+                    break;
+                }
+                case 'tool_use': {
+                    const taskId = event.subagentTaskId ?? null;
+                    if (taskId)
+                        flushSubBuf(taskId);
+                    else
+                        flushMainBuf();
+                    deps.chatService.addMessage(thread.id, 'tool_use', JSON.stringify({ input: event.input }), event.toolName, event.toolUseId, taskId, planMode, 'streaming');
+                    break;
+                }
+                case 'tool_result': {
+                    const taskId = event.subagentTaskId ?? null;
+                    deps.chatService.markToolUseComplete(thread.id, event.toolUseId);
+                    const row = deps.chatService.addMessage(thread.id, 'tool_result', JSON.stringify({ summary: event.summary, isError: event.isError }), null, event.toolUseId, taskId);
+                    if (taskId === null)
+                        lastToolResultRowId = row.id;
+                    break;
+                }
+                case 'subagent_started':
+                    flushMainBuf();
+                    deps.chatService.startSubagentTask(thread.id, event.taskId, event.description, event.toolUseId ?? null);
+                    break;
+                case 'subagent_progress':
+                    deps.chatService.updateSubagentTaskProgress(thread.id, event.taskId, event.description);
+                    break;
+                case 'subagent_completed':
+                    flushSubBuf(event.taskId);
+                    deps.chatService.completeSubagentTask(thread.id, event.taskId, event.status, event.summary ?? null);
+                    break;
+                case 'result': {
+                    flushMainBuf();
+                    for (const tid of Array.from(subagentBuffers.keys()))
+                        flushSubBuf(tid);
+                    if (event.sessionId)
+                        deps.chatService.setLastSessionId(thread.id, event.sessionId);
+                    const turnAnchor = lastMainAssistantRowId ?? lastToolResultRowId;
+                    if (lastTurnUsage) {
+                        deps.chatService.setLastUsage(thread.id, lastTurnUsage);
+                        if (turnAnchor !== null) {
+                            deps.chatService.attachTurnUsage(thread.id, turnAnchor, lastTurnUsage);
+                        }
+                    }
+                    if (typeof event.contextSize === 'number') {
+                        deps.chatService.setLastContextSize(thread.id, event.contextSize);
+                        if (turnAnchor !== null) {
+                            deps.chatService.attachTurnContextSize(thread.id, turnAnchor, event.contextSize);
+                        }
+                    }
+                    break;
+                }
+                case 'todo_list_updated':
+                    if (!event.isSubagent) {
+                        deps.chatService.updateCurrentTodoItems(thread.id, event.items);
+                    }
+                    break;
+                case 'warning':
+                    console.warn('[agent warning]', event.message);
+                    break;
+            }
+        }
+        // Terminal `done`/`error` ida tylko transportem callera (`onEvent`).
+        // Emitter dla GET /stream/:threadId dostaje `done` raz, w `finally`.
+        input.onEvent({ type: 'done' });
+    }
+    catch (err) {
+        // Mapuj na typed blad — `onEvent` dostaje `event: error` (parytet z SSE),
+        // a caller (headless `ask`) lapie `AgentTurnError` i mapuje na status HTTP.
+        let turnErr;
+        if (err instanceof AdapterAbortError) {
+            turnErr = new AgentTurnError('ABORTED', 'Aborted by user');
+        }
+        else if (err instanceof AdapterTimeoutError) {
+            turnErr = new AgentTurnError('TIMEOUT', 'Agent took too long to respond');
+        }
+        else if (err instanceof AdapterInitError) {
+            turnErr = new AgentTurnError('AGENT_UNAVAILABLE', 'Claude CLI not found or not logged in. Run `claude login` first.');
+        }
+        else {
+            turnErr = new AgentTurnError('AGENT_ERROR', err instanceof Error ? err.message : String(err));
+        }
+        input.onEvent({ type: 'error', code: turnErr.code, error: turnErr.message });
+        throw turnErr;
+    }
+    finally {
+        try {
+            flushMainBuf();
+            for (const tid of Array.from(subagentBuffers.keys()))
+                flushSubBuf(tid);
+        }
+        catch (flushErr) {
+            console.error('[chat] final flush failed', flushErr);
+        }
+        try {
+            deps.chatService.finalizeStreamingRows(thread.id);
+        }
+        catch (finalizeErr) {
+            console.error('[chat] finalizeStreamingRows failed', finalizeErr);
+        }
+        emitter.emit('event', { type: 'done' });
+        activeAdapters.delete(thread.id);
+        cancelPendingForRequest(requestId);
+    }
+    return { threadId: thread.id, answer: answerBuf.trim() };
+}
+export function countPages(tree) {
+    let n = 0;
+    for (const node of tree) {
+        if (node.type === 'file')
+            n++;
+        else if (Array.isArray(node.children))
+            n += countPages(node.children);
+    }
+    return n;
+}
+//# sourceMappingURL=agent-turn.js.map