@inharness-ai/claude4spec 1.0.21 → 1.0.23

package/dist/core/agent/run-agent.js

@@ -0,0 +1,212 @@
+import path from 'node:path';
+import { createHash } from 'node:crypto';
+import { resolveWorkspaceProject, WorkspaceResolveError } from '../workspace/resolve.js';
+/** Default model resolved here so every transport shares one source of truth. */
+const DEFAULT_MODEL = 'opus-4.8';
+export class AgentError extends Error {
+    code;
+    hint;
+    constructor(code, message, hint) {
+        super(message);
+        this.code = code;
+        this.hint = hint;
+        this.name = 'AgentError';
+    }
+}
+export async function runAgent(params) {
+    const message = params.message;
+    if (!message || !message.trim()) {
+        throw new AgentError('INVALID_ARGS', 'message is required');
+    }
+    const model = params.model ?? DEFAULT_MODEL;
+    const output = params.output ?? 'final';
+    // --- discovery: adres serwera + project-id ------------------------------
+    // M31: discovery przez rejestr workspace'ow (`defaultPort`), nie przez
+    // config.json (port wyprowadzil sie z configu w v3). Kazdy URL dostaje
+    // prefiks `/api/projects/<id>` — peer servuje N projektow.
+    let baseUrl;
+    let projectId;
+    if (params.server) {
+        baseUrl = params.server.replace(/\/+$/, '');
+        // `--server` bez resolvable projektu → wymagaj `--project` (id liczy sie
+        // z absolutnej sciezki projektu, tak jak rejestruje go peer).
+        try {
+            const resolved = resolveWorkspaceProject({ project: params.project, workspace: params.workspace });
+            projectId = resolved.projectId;
+        }
+        catch (err) {
+            if (err instanceof WorkspaceResolveError && params.project) {
+                // Sciezka podana wprost, ale nieznana lokalnemu rejestrowi (zdalny
+                // peer) — id wyprowadzamy z samej sciezki.
+                projectId = projectIdForPath(params.project);
+            }
+            else if (err instanceof WorkspaceResolveError) {
+                throw new AgentError('INVALID_ARGS', '--server requires --project <path> when no local workspace owns the current directory', 'the project id in the URL prefix derives from the project path');
+            }
+            else {
+                throw err;
+            }
+        }
+    }
+    else {
+        let resolved;
+        try {
+            resolved = resolveWorkspaceProject({ project: params.project, workspace: params.workspace });
+        }
+        catch (err) {
+            if (err instanceof WorkspaceResolveError) {
+                throw new AgentError(err.code, err.message, err.hint);
+            }
+            throw err;
+        }
+        baseUrl = `http://localhost:${resolved.defaultPort}`;
+        projectId = resolved.projectId;
+    }
+    const apiBase = `${baseUrl}/api/projects/${projectId}`;
+    // --- health-check tozsamosci --------------------------------------------
+    await healthCheck(baseUrl, apiBase);
+    // --- create-thread (context-specific) — pomijany dla threadId ----------
+    let threadId;
+    if (params.threadId) {
+        threadId = params.threadId;
+    }
+    else {
+        const ct = params.contextType ?? 'chat';
+        if (ct !== 'chat' && ct !== 'brief' && ct !== 'patch' && ct !== 'ask') {
+            throw new AgentError('INVALID_ARGS', `contextType must be chat|brief|patch|ask (got '${ct}')`);
+        }
+        if (ct === 'patch') {
+            // Watki patch nie maja route create-thread — tylko kontynuacja.
+            throw new AgentError('INVALID_ARGS', 'cannot create a patch thread via agent; pass threadId to continue one');
+        }
+        if (ct === 'brief') {
+            if (!params.briefPath) {
+                throw new AgentError('INVALID_ARGS', "contextType='brief' requires briefPath");
+            }
+            const encoded = params.briefPath.split('/').map(encodeURIComponent).join('/');
+            const created = await postJson(`${apiBase}/briefs/${encoded}/threads`, {});
+            threadId = pickThreadId(created);
+        }
+        else {
+            // 'chat' + 'ask' share the generic create-thread route; the server
+            // validates `context_type` (only 'chat'/'ask' accepted on this path).
+            const created = await postJson(`${apiBase}/threads`, { context_type: ct });
+            threadId = pickThreadId(created);
+        }
+    }
+    // --- run-turn (generyczny po context_type) ------------------------------
+    const result = await postJson(`${apiBase}/threads/${encodeURIComponent(threadId)}/ask`, {
+        message,
+        model,
+    });
+    const answer = typeof result.answer === 'string' ? result.answer : '';
+    const outThreadId = typeof result.threadId === 'string' ? result.threadId : threadId;
+    const out = { threadId: outThreadId, answer };
+    if (output === 'full') {
+        out.messages = Array.isArray(result.messages) ? result.messages : [];
+    }
+    return out;
+}
+/** M31: project id = sha1(abs path).slice(0,12) — same derivation as the registry. */
+function projectIdForPath(project) {
+    // Lazy import-free copy of projectIdForCwd to keep run-agent dependency-light:
+    // resolveWorkspaceProject already covers the registry path; this branch only
+    // serves `--server` + explicit `--project` for a remote peer.
+    return createHashHex(path.resolve(process.cwd(), project)).slice(0, 12);
+}
+/**
+ * M31 health-check tozsamosci: `GET /api/projects/<id>/config` musi zwrocic
+ * ksztalt configu claude4spec v3. Piec rozlacznych wynikow:
+ *   connection refused           → SERVER_NOT_RUNNING
+ *   nie-c4s ksztalt               → SERVER_NOT_RECOGNIZED
+ *   404 z koperta c4s             → PROJECT_NOT_IN_WORKSPACE
+ *   inny nie-2xx z koperta c4s    → kod z koperty (np. PROJECT_BUILD_FAILED)
+ *   200 config                    → OK
+ */
+async function healthCheck(baseUrl, apiBase) {
+    let res;
+    try {
+        res = await fetch(`${apiBase}/config`);
+    }
+    catch {
+        throw new AgentError('SERVER_NOT_RUNNING', `no claude4spec server responding at ${baseUrl}`, 'start it with `npx @inharness-ai/claude4spec` in the project');
+    }
+    let body;
+    try {
+        body = await res.json();
+    }
+    catch {
+        throw new AgentError('SERVER_NOT_RECOGNIZED', `process at ${baseUrl} responded but not with a claude4spec config`);
+    }
+    if (res.status === 404 && isC4sErrorEnvelope(body)) {
+        const err = body.error;
+        throw new AgentError('PROJECT_NOT_IN_WORKSPACE', err.message ?? `project not registered in the workspace served at ${baseUrl}`, 'register it: POST /api/workspace/projects or run `npx @inharness-ai/claude4spec` in the project');
+    }
+    // A non-2xx carrying a c4s error envelope means the server IS claude4spec but
+    // this project failed to build (e.g. 500 PROJECT_BUILD_FAILED). Surface its own
+    // code/message instead of masking it as "not a claude4spec server" — otherwise a
+    // bad config.json (e.g. an unselectable writingStyle) looks like a missing server.
+    if (!res.ok && isC4sErrorEnvelope(body)) {
+        const err = body.error;
+        throw new AgentError(err.code ?? 'PROJECT_BUILD_FAILED', err.message ?? `project at ${baseUrl} failed to build`, err.hint);
+    }
+    if (!res.ok || !isConfigShape(body)) {
+        throw new AgentError('SERVER_NOT_RECOGNIZED', `process at ${baseUrl} is not a claude4spec server (unexpected GET ${apiBase}/config shape)`);
+    }
+}
+function isC4sErrorEnvelope(body) {
+    if (!body || typeof body !== 'object')
+        return false;
+    const e = body.error;
+    return !!e && typeof e === 'object' && typeof e.code === 'string';
+}
+/** M31 v3 shape — no port/mode anymore; entitiesDir is required. */
+function isConfigShape(body) {
+    if (!body || typeof body !== 'object')
+        return false;
+    const c = body;
+    return (typeof c.name === 'string' &&
+        typeof c.pagesDir === 'string' &&
+        typeof c.entitiesDir === 'string' &&
+        'writingStyle' in c &&
+        !!c.onboarding &&
+        typeof c.onboarding === 'object');
+}
+/** POST JSON; przy nie-2xx propaguje `{ error: { code, message } }` endpointu. */
+async function postJson(url, payload) {
+    let res;
+    try {
+        res = await fetch(url, {
+            method: 'POST',
+            headers: { 'content-type': 'application/json' },
+            body: JSON.stringify(payload),
+        });
+    }
+    catch {
+        throw new AgentError('SERVER_NOT_RUNNING', `request to ${url} failed (connection refused)`);
+    }
+    let body = {};
+    try {
+        body = (await res.json());
+    }
+    catch {
+        /* puste/nie-JSON body — obsluzone nizej przez !res.ok */
+    }
+    if (!res.ok) {
+        const err = (body.error ?? {});
+        throw new AgentError(err.code ?? 'AGENT_ERROR', err.message ?? `request to ${url} failed with HTTP ${res.status}`, err.hint);
+    }
+    return body.data ?? body;
+}
+function pickThreadId(created) {
+    // `POST /api/threads` → `{ id }`; `POST /api/briefs/.../threads` → `{ threadId }`.
+    const id = created.threadId ?? created.id;
+    if (typeof id !== 'string' || !id) {
+        throw new AgentError('AGENT_ERROR', 'create-thread response had no thread id');
+    }
+    return id;
+}
+function createHashHex(input) {
+    return createHash('sha1').update(input).digest('hex');
+}
+//# sourceMappingURL=run-agent.js.map

package/dist/core/agent/run-agent.js.map

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

package/dist/core/ask/run-ask.d.ts

@@ -30,7 +30,7 @@ export interface AskResult {
     threadId: string;
     answer: string;
 }
-export type AskErrorCode = 'PROJECT_NOT_FOUND' | 'AMBIGUOUS_WORKSPACE' | 'PROJECT_NOT_IN_WORKSPACE' | 'SERVER_NOT_RUNNING' | 'SERVER_NOT_RECOGNIZED' | 'NOT_FOUND' | 'STREAM_IN_PROGRESS' | 'AGENT_UNAVAILABLE' | 'AGENT_ERROR' | 'TIMEOUT' | 'ABORTED' | 'INVALID_ARGS';
+export type AskErrorCode = 'PROJECT_NOT_FOUND' | 'AMBIGUOUS_WORKSPACE' | 'PROJECT_NOT_IN_WORKSPACE' | 'SERVER_NOT_RUNNING' | 'SERVER_NOT_RECOGNIZED' | 'PROJECT_BUILD_FAILED' | 'NOT_FOUND' | 'STREAM_IN_PROGRESS' | 'AGENT_UNAVAILABLE' | 'AGENT_ERROR' | 'TIMEOUT' | 'ABORTED' | 'INVALID_ARGS';
 export declare class AskError extends Error {
     code: AskErrorCode;
     hint?: string | undefined;

package/dist/core/ask/run-ask.js

@@ -105,11 +105,12 @@ function projectIdForPath(project) {
 }
 /**
  * M31 health-check tozsamosci: `GET /api/projects/<id>/config` musi zwrocic
- * ksztalt configu claude4spec v3. Cztery rozlaczne wyniki:
- *   connection refused      → SERVER_NOT_RUNNING
- *   nie-c4s ksztalt          → SERVER_NOT_RECOGNIZED
- *   404 z koperta c4s        → PROJECT_NOT_IN_WORKSPACE
- *   200 config               → OK
+ * ksztalt configu claude4spec v3. Piec rozlacznych wynikow:
+ *   connection refused           → SERVER_NOT_RUNNING
+ *   nie-c4s ksztalt               → SERVER_NOT_RECOGNIZED
+ *   404 z koperta c4s             → PROJECT_NOT_IN_WORKSPACE
+ *   inny nie-2xx z koperta c4s    → kod z koperty (np. PROJECT_BUILD_FAILED)
+ *   200 config                    → OK
  */
 async function healthCheck(baseUrl, apiBase) {
     let res;
@@ -130,6 +131,14 @@ async function healthCheck(baseUrl, apiBase) {
         const err = body.error;
         throw new AskError('PROJECT_NOT_IN_WORKSPACE', err.message ?? `project not registered in the workspace served at ${baseUrl}`, 'register it: POST /api/workspace/projects or run `npx @inharness-ai/claude4spec` in the project');
     }
+    // A non-2xx carrying a c4s error envelope means the server IS claude4spec but
+    // this project failed to build (e.g. 500 PROJECT_BUILD_FAILED). Surface its own
+    // code/message instead of masking it as "not a claude4spec server" — otherwise a
+    // bad config.json (e.g. an unselectable writingStyle) looks like a missing server.
+    if (!res.ok && isC4sErrorEnvelope(body)) {
+        const err = body.error;
+        throw new AskError(err.code ?? 'PROJECT_BUILD_FAILED', err.message ?? `project at ${baseUrl} failed to build`, err.hint);
+    }
     if (!res.ok || !isConfigShape(body)) {
         throw new AskError('SERVER_NOT_RECOGNIZED', `process at ${baseUrl} is not a claude4spec server (unexpected GET ${apiBase}/config shape)`);
     }

package/dist/core/ask/run-ask.js.map

@@ -1 +1 @@
-{"version":3,"file":"run-ask.js","sourceRoot":"","sources":["../../../src/core/ask/run-ask.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"run-ask.js","sourceRoot":"","sources":["../../../src/core/ask/run-ask.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,uBAAuB,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AAqDzF,MAAM,OAAO,QAAS,SAAQ,KAAK;IACd;IAA4C;IAA/D,YAAmB,IAAkB,EAAE,OAAe,EAAS,IAAa;QAC1E,KAAK,CAAC,OAAO,CAAC,CAAC;QADE,SAAI,GAAJ,IAAI,CAAc;QAA0B,SAAI,GAAJ,IAAI,CAAS;QAE1E,IAAI,CAAC,IAAI,GAAG,UAAU,CAAC;IACzB,CAAC;CACF;AAED,MAAM,CAAC,KAAK,UAAU,MAAM,CAAC,MAAiB;IAC5C,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC;IAC/B,IAAI,CAAC,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC;QAChC,MAAM,IAAI,QAAQ,CAAC,cAAc,EAAE,qBAAqB,CAAC,CAAC;IAC5D,CAAC;IAED,2EAA2E;IAC3E,uEAAuE;IACvE,uEAAuE;IACvE,2DAA2D;IAC3D,IAAI,OAAe,CAAC;IACpB,IAAI,SAAiB,CAAC;IACtB,IAAI,MAAM,CAAC,MAAM,EAAE,CAAC;QAClB,OAAO,GAAG,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;QAC5C,yEAAyE;QACzE,8DAA8D;QAC9D,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,uBAAuB,CAAC,EAAE,OAAO,EAAE,MAAM,CAAC,OAAO,EAAE,SAAS,EAAE,MAAM,CAAC,SAAS,EAAE,CAAC,CAAC;YACnG,SAAS,GAAG,QAAQ,CAAC,SAAS,CAAC;QACjC,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,IAAI,GAAG,YAAY,qBAAqB,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;gBAC3D,mEAAmE;gBACnE,2CAA2C;gBAC3C,SAAS,GAAG,gBAAgB,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;YAC/C,CAAC;iBAAM,IAAI,GAAG,YAAY,qBAAqB,EAAE,CAAC;gBAChD,MAAM,IAAI,QAAQ,CAChB,cAAc,EACd,uFAAuF,EACvF,gEAAgE,CACjE,CAAC;YACJ,CAAC;iBAAM,CAAC;gBACN,MAAM,GAAG,CAAC;YACZ,CAAC;QACH,CAAC;IACH,CAAC;SAAM,CAAC;QACN,IAAI,QAAQ,CAAC;QACb,IAAI,CAAC;YACH,QAAQ,GAAG,uBAAuB,CAAC,EAAE,OAAO,EAAE,MAAM,CAAC,OAAO,EAAE,SAAS,EAAE,MAAM,CAAC,SAAS,EAAE,CAAC,CAAC;QAC/F,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,IAAI,GAAG,YAAY,qBAAqB,EAAE,CAAC;gBACzC,MAAM,IAAI,QAAQ,CAAC,GAAG,CAAC,IAAI,EAAE,GAAG,CAAC,OAAO,EAAE,GAAG,CAAC,IAAI,CAAC,CAAC;YACtD,CAAC;YACD,MAAM,GAAG,CAAC;QACZ,CAAC;QACD,OAAO,GAAG,oBAAoB,QAAQ,CAAC,WAAW,EAAE,CAAC;QACrD,SAAS,GAAG,QAAQ,CAAC,SAAS,CAAC;IACjC,CAAC;IACD,MAAM,OAAO,GAAG,GAAG,OAAO,iBAAiB,SAAS,EAAE,CAAC;IAEvD,2EAA2E;IAC3E,MAAM,WAAW,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;IAEpC,0EAA0E;IAC1E,IAAI,QAAgB,CAAC;IACrB,IAAI,MAAM,CAAC,QAAQ,EAAE,CAAC;QACpB,QAAQ,GAAG,MAAM,CAAC,QAAQ,CAAC;IAC7B,CAAC;SAAM,CAAC;QACN,MAAM,EAAE,GAAmB,MAAM,CAAC,WAAW,IAAI,MAAM,CAAC;QACxD,IAAI,EAAE,KAAK,MAAM,IAAI,EAAE,KAAK,OAAO,IAAI,EAAE,KAAK,OAAO,EAAE,CAAC;YACtD,MAAM,IAAI,QAAQ,CAChB,cAAc,EACd,8CAA8C,EAAE,IAAI,CACrD,CAAC;QACJ,CAAC;QACD,IAAI,EAAE,KAAK,OAAO,EAAE,CAAC;YACnB,gEAAgE;YAChE,MAAM,IAAI,QAAQ,CAChB,cAAc,EACd,qEAAqE,CACtE,CAAC;QACJ,CAAC;QACD,IAAI,EAAE,KAAK,OAAO,EAAE,CAAC;YACnB,IAAI,CAAC,MAAM,CAAC,SAAS,EAAE,CAAC;gBACtB,MAAM,IAAI,QAAQ,CAAC,cAAc,EAAE,wCAAwC,CAAC,CAAC;YAC/E,CAAC;YACD,MAAM,OAAO,GAAG,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,kBAAkB,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;YAC9E,MAAM,OAAO,GAAG,MAAM,QAAQ,CAAC,GAAG,OAAO,WAAW,OAAO,UAAU,EAAE,EAAE,CAAC,CAAC;YAC3E,QAAQ,GAAG,YAAY,CAAC,OAAO,CAAC,CAAC;QACnC,CAAC;aAAM,CAAC;YACN,MAAM,OAAO,GAAG,MAAM,QAAQ,CAAC,GAAG,OAAO,UAAU,EAAE,EAAE,CAAC,CAAC;YACzD,QAAQ,GAAG,YAAY,CAAC,OAAO,CAAC,CAAC;QACnC,CAAC;IACH,CAAC;IAED,2EAA2E;IAC3E,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAC,GAAG,OAAO,YAAY,kBAAkB,CAAC,QAAQ,CAAC,MAAM,EAAE;QACtF,OAAO;KACR,CAAC,CAAC;IACH,MAAM,MAAM,GAAG,OAAO,MAAM,CAAC,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC;IACtE,MAAM,WAAW,GAAG,OAAO,MAAM,CAAC,QAAQ,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC;IACrF,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,EAAE,CAAC;AAC3C,CAAC;AAED,sFAAsF;AACtF,SAAS,gBAAgB,CAAC,OAAe;IACvC,6EAA6E;IAC7E,6EAA6E;IAC7E,8DAA8D;IAC9D,OAAO,aAAa,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;AAC1E,CAAC;AAED;;;;;;;;GAQG;AACH,KAAK,UAAU,WAAW,CAAC,OAAe,EAAE,OAAe;IACzD,IAAI,GAAa,CAAC;IAClB,IAAI,CAAC;QACH,GAAG,GAAG,MAAM,KAAK,CAAC,GAAG,OAAO,SAAS,CAAC,CAAC;IACzC,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,IAAI,QAAQ,CAChB,oBAAoB,EACpB,uCAAuC,OAAO,EAAE,EAChD,8DAA8D,CAC/D,CAAC;IACJ,CAAC;IACD,IAAI,IAAa,CAAC;IAClB,IAAI,CAAC;QACH,IAAI,GAAG,MAAM,GAAG,CAAC,IAAI,EAAE,CAAC;IAC1B,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,IAAI,QAAQ,CAChB,uBAAuB,EACvB,cAAc,OAAO,8CAA8C,CACpE,CAAC;IACJ,CAAC;IACD,IAAI,GAAG,CAAC,MAAM,KAAK,GAAG,IAAI,kBAAkB,CAAC,IAAI,CAAC,EAAE,CAAC;QACnD,MAAM,GAAG,GAAI,IAAuD,CAAC,KAAK,CAAC;QAC3E,MAAM,IAAI,QAAQ,CAChB,0BAA0B,EAC1B,GAAG,CAAC,OAAO,IAAI,qDAAqD,OAAO,EAAE,EAC7E,iGAAiG,CAClG,CAAC;IACJ,CAAC;IACD,8EAA8E;IAC9E,gFAAgF;IAChF,iFAAiF;IACjF,mFAAmF;IACnF,IAAI,CAAC,GAAG,CAAC,EAAE,IAAI,kBAAkB,CAAC,IAAI,CAAC,EAAE,CAAC;QACxC,MAAM,GAAG,GAAI,IAAsE,CAAC,KAAK,CAAC;QAC1F,MAAM,IAAI,QAAQ,CACf,GAAG,CAAC,IAAqB,IAAI,sBAAsB,EACpD,GAAG,CAAC,OAAO,IAAI,cAAc,OAAO,kBAAkB,EACtD,GAAG,CAAC,IAAI,CACT,CAAC;IACJ,CAAC;IACD,IAAI,CAAC,GAAG,CAAC,EAAE,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,EAAE,CAAC;QACpC,MAAM,IAAI,QAAQ,CAChB,uBAAuB,EACvB,cAAc,OAAO,gDAAgD,OAAO,gBAAgB,CAC7F,CAAC;IACJ,CAAC;AACH,CAAC;AAED,SAAS,kBAAkB,CAAC,IAAa;IACvC,IAAI,CAAC,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC;IACpD,MAAM,CAAC,GAAI,IAA4B,CAAC,KAAK,CAAC;IAC9C,OAAO,CAAC,CAAC,CAAC,IAAI,OAAO,CAAC,KAAK,QAAQ,IAAI,OAAQ,CAAwB,CAAC,IAAI,KAAK,QAAQ,CAAC;AAC5F,CAAC;AAED,oEAAoE;AACpE,SAAS,aAAa,CAAC,IAAa;IAClC,IAAI,CAAC,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC;IACpD,MAAM,CAAC,GAAG,IAA+B,CAAC;IAC1C,OAAO,CACL,OAAO,CAAC,CAAC,IAAI,KAAK,QAAQ;QAC1B,OAAO,CAAC,CAAC,QAAQ,KAAK,QAAQ;QAC9B,OAAO,CAAC,CAAC,WAAW,KAAK,QAAQ;QACjC,cAAc,IAAI,CAAC;QACnB,CAAC,CAAC,CAAC,CAAC,UAAU;QACd,OAAO,CAAC,CAAC,UAAU,KAAK,QAAQ,CACjC,CAAC;AACJ,CAAC;AAED,kFAAkF;AAClF,KAAK,UAAU,QAAQ,CAAC,GAAW,EAAE,OAAgB;IACnD,IAAI,GAAa,CAAC;IAClB,IAAI,CAAC;QACH,GAAG,GAAG,MAAM,KAAK,CAAC,GAAG,EAAE;YACrB,MAAM,EAAE,MAAM;YACd,OAAO,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE;YAC/C,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC;SAC9B,CAAC,CAAC;IACL,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,IAAI,QAAQ,CAAC,oBAAoB,EAAE,cAAc,GAAG,8BAA8B,CAAC,CAAC;IAC5F,CAAC;IACD,IAAI,IAAI,GAA4B,EAAE,CAAC;IACvC,IAAI,CAAC;QACH,IAAI,GAAG,CAAC,MAAM,GAAG,CAAC,IAAI,EAAE,CAA4B,CAAC;IACvD,CAAC;IAAC,MAAM,CAAC;QACP,yDAAyD;IAC3D,CAAC;IACD,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC;QACZ,MAAM,GAAG,GAAG,CAAC,IAAI,CAAC,KAAK,IAAI,EAAE,CAAuD,CAAC;QACrF,MAAM,IAAI,QAAQ,CACf,GAAG,CAAC,IAAqB,IAAI,aAAa,EAC3C,GAAG,CAAC,OAAO,IAAI,cAAc,GAAG,qBAAqB,GAAG,CAAC,MAAM,EAAE,EACjE,GAAG,CAAC,IAAI,CACT,CAAC;IACJ,CAAC;IACD,OAAQ,IAAI,CAAC,IAAgC,IAAI,IAAI,CAAC;AACxD,CAAC;AAED,SAAS,YAAY,CAAC,OAAgC;IACpD,mFAAmF;IACnF,MAAM,EAAE,GAAG,OAAO,CAAC,QAAQ,IAAI,OAAO,CAAC,EAAE,CAAC;IAC1C,IAAI,OAAO,EAAE,KAAK,QAAQ,IAAI,CAAC,EAAE,EAAE,CAAC;QAClC,MAAM,IAAI,QAAQ,CAAC,aAAa,EAAE,yCAAyC,CAAC,CAAC;IAC/E,CAAC;IACD,OAAO,EAAE,CAAC;AACZ,CAAC;AAED,SAAS,aAAa,CAAC,KAAa;IAClC,OAAO,UAAU,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AACxD,CAAC"}

package/dist/core/workspace/resolve.d.ts

@@ -5,6 +5,8 @@ export interface ResolvedWorkspaceProject {
     projectDir: string;
     /** `~/.claude4spec/<ws>/<id>/db.sqlite` — may not exist yet (fresh slot). */
     dbPath: string;
+    /** M33: workspace plugin packages (predefined ∪ user-added) for the loader. */
+    pluginPackages: string[];
 }
 export type WorkspaceResolveErrorCode = 'PROJECT_NOT_FOUND' | 'AMBIGUOUS_WORKSPACE';
 export declare class WorkspaceResolveError extends Error {

package/dist/core/workspace/resolve.js

@@ -1,5 +1,5 @@
 import path from 'node:path';
-import { WorkspaceRegistry } from '../../server/workspace/registry.js';
+import { WorkspaceRegistry, resolvePluginPackages } from '../../server/workspace/registry.js';
 import { projectIdForCwd } from '../../server/workspace/project-id.js';
 export class WorkspaceResolveError extends Error {
     code;
@@ -75,6 +75,7 @@ export function resolveWorkspaceProject(opts = {}) {
         projectId,
         projectDir,
         dbPath: path.join(registry.slotDir(workspace, projectId), 'db.sqlite'),
+        pluginPackages: resolvePluginPackages(workspace),
     };
 }
 //# sourceMappingURL=resolve.js.map

package/dist/core/workspace/resolve.js.map

@@ -1 +1 @@
-{"version":3,"file":"resolve.js","sourceRoot":"","sources":["../../../src/core/workspace/resolve.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"resolve.js","sourceRoot":"","sources":["../../../src/core/workspace/resolve.ts"],"names":[],"mappings":"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"}

package/dist/plugin-types/ambient.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Ambient binding for the runtime value specifiers `@c4s/plugin-runtime` and
+ * `@c4s/plugin-runtime/ui` (brief 0.1.85→0.1.86, "For implementers" #2).
+ *
+ * A plugin's source imports those BARE specifiers (resolved at runtime by the
+ * M33 import-map shim). This file makes TypeScript resolve their TYPES to the
+ * host's published surface, so a plugin can drop its vendored `c4s-runtime.d.ts`
+ * and instead reference the host package once:
+ *
+ *   /// <reference types="@inharness-ai/claude4spec/plugin-runtime/ambient" />
+ *
+ * or via tsconfig `compilerOptions.types`. That single reference types BOTH the
+ * value specifier and all the type names (AC1).
+ *
+ * This is a SCRIPT file (no top-level import/export) so the `declare module`
+ * blocks are AMBIENT declarations, not augmentations. The bodies live in the
+ * tsc-emitted module surfaces — re-exported here by their official subpaths, so
+ * there is a single source and no hand-mirrored copy to drift. It is shipped
+ * verbatim (copied into `dist/plugin-types/`), never compiled by the host, so
+ * the self-package specifiers resolve on the consumer side (where the package is
+ * installed), not during the host's own build.
+ */
+
+declare module '@c4s/plugin-runtime' {
+  export * from '@inharness-ai/claude4spec/plugin-runtime';
+}
+
+declare module '@c4s/plugin-runtime/ui' {
+  export * from '@inharness-ai/claude4spec/plugin-runtime/ui';
+}

package/dist/plugin-types/plugin-runtime.d.ts

@@ -0,0 +1,172 @@
+/**
+ * `@inharness-ai/claude4spec/plugin-runtime` — the PUBLISHED Host API type
+ * surface for plugin authors (brief 0.1.85→0.1.86).
+ *
+ * This is the official, host-owned mirror of the contract a plugin's code
+ * compiles against. It replaces the per-plugin vendored `c4s-runtime.d.ts`
+ * ambient fallback: the host now ships these declarations so plugin authors
+ * reference them instead of hand-copying. The value transport is unchanged —
+ * at runtime a plugin's `import "@c4s/plugin-runtime"` still resolves to the
+ * M33 import-map shim; these types are that contract's compile-time mirror.
+ *
+ * Two channels compose:
+ *   - top-level exports here type the subpath `@inharness-ai/claude4spec/plugin-runtime`;
+ *   - the ambient `declare module '@c4s/plugin-runtime'` in `./ambient.d.ts` binds
+ *     the runtime value specifier to this same surface.
+ *
+ * SINGLE SOURCE OF TRUTH. The dep-free contract (manifest / EntityModule) is
+ * RE-EXPORTED from its canonical host modules, so it cannot drift (a change to
+ * the real interface flows through automatically; `published-surface.test.ts`
+ * additionally asserts structural parity). The server- and client-coupled slots
+ * (mount context, serializer, render props, runtime singletons) are declared
+ * here with intentionally-loose external types: their real types pull host
+ * internals (express Router, better-sqlite3 Database, the Tiptap registry) that
+ * are NOT part of the contract and must not leak into the published surface
+ * (AC2). This mirrors how the host itself types them `unknown` and narrows
+ * internally.
+ *
+ * `hostApiVersion` is NOT bumped by publishing these types — `tsc` erases types
+ * from emitted JS, so the alias-path argument that blocks publishing runtime
+ * VALUES does not apply to declarations (brief "Version semantics").
+ */
+import type { ComponentType } from 'react';
+import type { EntityModuleManifest, SystemPromptContribution } from '../shared/plugin-host/types.js';
+export { HOST_API_VERSION } from '../shared/plugin-host/manifest.js';
+export type { PluginManifest, PluginEngines, EntityContribution, WritingStyleContribution, PluginSettingField, PluginSettingsModule, PluginCommandContribution, } from '../shared/plugin-host/manifest.js';
+export type { EntityModuleManifest, SystemPromptContribution };
+export interface SqlMigration {
+    version: number;
+    name: string;
+    /** Idempotent SQL — must tolerate replay. */
+    up: string;
+}
+export interface MountContext {
+    app: any;
+    db: any;
+    host: any;
+    cwd: string;
+    ws: {
+        broadcast(msg: unknown): void;
+    };
+    tagsService: any;
+    versionService: any;
+    referencesService: any;
+    entityStore: any;
+    registerMcpServer(name: string, factory: () => unknown): void;
+    registerEntityService(type: string, service: unknown): void;
+}
+export type PluginMountFn = (ctx: MountContext) => void;
+export interface SerializeContext {
+    reader: unknown;
+    depth: number;
+    maxDepth: number;
+}
+export interface RestoreContext {
+    reader: unknown;
+    writer: unknown;
+    releaseId: number | null;
+    actor: 'user' | 'agent';
+}
+export interface RestoreResult<T = unknown> {
+    op: 'created' | 'updated' | 'deleted' | 'noop';
+    entity: T | null;
+    warnings?: string[];
+}
+export interface EntityDiff {
+    type: string;
+    slug: string;
+    op: 'created' | 'deleted' | 'modified' | 'noop';
+    changes?: Record<string, unknown>;
+}
+export type SnapshotData = unknown;
+export interface EntitySerializer<T = unknown> {
+    type: string;
+    version: string;
+    inlineMention?: (entity: T, ctx: SerializeContext) => unknown;
+    singleElement?: (entity: T, ctx: SerializeContext) => unknown;
+    elementListItem?: (entity: T, ctx: SerializeContext) => unknown;
+    taggedListItem?: (entity: T, ctx: SerializeContext) => unknown;
+    detail?: (entity: T, ctx: SerializeContext) => unknown;
+    snapshot?: (entity: T, ctx: SerializeContext) => SnapshotData;
+    restore?: (data: SnapshotData, ctx: RestoreContext) => RestoreResult;
+    diff?: (a: SnapshotData, b: SnapshotData, slug: string) => EntityDiff;
+}
+export interface EntityChipProps<T = unknown> {
+    slug: string;
+    /** The host injects the resolved entity; `null` ⇒ broken reference. */
+    entity: T | null;
+    onOpen?: () => void;
+}
+export interface EntityCardProps<T = unknown> extends EntityChipProps<T> {
+}
+export interface EntityRowProps<T = unknown> {
+    slug: string;
+    entity: T;
+    active?: boolean;
+    onOpen?: () => void;
+}
+export interface EntityDetailProps {
+    slug: string;
+    onDeleted: () => void;
+    onRenamed: (newSlug: string) => void;
+    onBack: () => void;
+}
+export interface SidebarTabSlot {
+    icon: ComponentType<{
+        className?: string;
+        size?: number | string;
+    }>;
+    label: string;
+    order: number;
+    emptyState?: ComponentType<unknown>;
+}
+export interface SlashCommand {
+    id: string;
+    label: string;
+    description: string;
+    hint: string;
+    pluginPopoverKind?: string;
+}
+export interface EditorExtensionRegistration {
+    name: string;
+    extension?: unknown;
+    priority?: number;
+    availableIn?: string[];
+    slashCommand?: SlashCommand;
+}
+export type AnyRoute = unknown;
+export type RouteTreeFragment = (ctx: {
+    rootRoute: AnyRoute;
+}) => AnyRoute[];
+export interface FrontendModule extends EntityModuleManifest {
+    renderChip: ComponentType<EntityChipProps<unknown>>;
+    renderCard: ComponentType<EntityCardProps<unknown>>;
+    renderRow: ComponentType<EntityRowProps<unknown>>;
+    detailPanel: ComponentType<EntityDetailProps>;
+    useGetBySlug: (slug: string | null) => {
+        data: unknown | null | undefined;
+        isLoading: boolean;
+    };
+    listByTags: (args: {
+        tags: string[];
+        filter: 'and' | 'or';
+    }) => Promise<Array<{
+        slug: string;
+    }>>;
+    sidebarTab?: SidebarTabSlot;
+    editorExtensions?: EditorExtensionRegistration[];
+    /** Phase 3 — page routes this module owns (factory bound to the host root). */
+    routes?: RouteTreeFragment;
+}
+export interface EditorBridge {
+    openEntity: (type: string, slug: string) => void;
+    openSection: (pagePath: string, anchor: string) => void;
+}
+export declare const clientPluginHost: {
+    registerFrontendModule(module: FrontendModule): void;
+    [key: string]: unknown;
+};
+export declare function registerFrontendModule(module: FrontendModule): void;
+export declare const queryClient: unknown;
+export declare const editorBridge: EditorBridge;
+export declare function registerExtensionReferenceType(...args: unknown[]): void;