@nac3/forge-cli 0.2.0-alpha.5 → 0.2.0-alpha.59z.119

package/dist/chat/spec_plan.js

@@ -23,49 +23,6 @@
  *
  * ASCII-only.
  */
-const SYSTEM_PROMPT = `Sos un planner de scaffolding para una app React con NAC-3. Te paso una extraccion de spec (requirements + entities + endpoints + components) y devolves un plan en JSON puro de los archivos que hay que crear.
-
-Esquema obligatorio:
-
-{
-  "overview": "string -- 1 parrafo describiendo el plan",
-  "files": [
-    {
-      "path": "src/...",
-      "kind": "component" | "api" | "model" | "test" | "doc" | "config" | "other",
-      "language": "ts" | "tsx" | "js" | "jsx" | "json" | "md" | "css" | "other",
-      "rationale": "string corto",
-      "refs": {
-        "requirements": ["REQ-1", ...],
-        "entities": ["Paciente", ...],
-        "endpoints": ["/patients", ...],
-        "components": ["PatientCard", ...]
-      }
-    }
-  ],
-  "open_questions": ["string", ...]
-}
-
-Reglas:
-- Devolves SOLO el JSON. Sin envoltorios.
-- Orden sugerido: modelos -> tipos -> api -> componentes -> tests -> docs.
-- Paths relativos al projectRoot. Usa src/ como raiz.
-- Cada entity -> src/models/<EntityName>.ts.
-- Cada endpoint -> src/api/<resource>.ts (agrupa endpoints del mismo recurso).
-- Cada component -> src/components/<ComponentName>.tsx + src/components/<ComponentName>.test.tsx.
-- README.md tope de proyecto.
-- refs: usa los ids exactos de la extraccion.
-- open_questions: lista cosas que el spec dejo abierto (por ejemplo "autenticacion no especificada", "formato del CSV de export no aclarado").`;
-function parseJsonStrict(raw) {
-    let text = raw.trim();
-    const fenceStart = text.match(/^```(?:json)?\s*\n/i);
-    if (fenceStart)
-        text = text.slice(fenceStart[0].length);
-    const fenceEnd = text.match(/\n```\s*$/);
-    if (fenceEnd)
-        text = text.slice(0, -fenceEnd[0].length);
-    return JSON.parse(text);
-}
 const VALID_KINDS = new Set([
     'component', 'api', 'model', 'test', 'doc', 'config', 'other',
 ]);
@@ -134,27 +91,25 @@ function validate(obj) {
     }
     return out;
 }
-export async function generatePlan(claude, opts) {
+/* HITO 4 -- alpha.59z.112.
+ *
+ * The bundled SYSTEM_PROMPT + legacy branch were removed in
+ * alpha.59z.112. The worker is now the ONLY path. */
+export async function generatePlan(opts) {
     if (!opts.extraction) {
         throw new Error('spec_plan: extraction is required');
     }
-    const userMessage = 'Titulo: ' + (opts.title || '(sin titulo)') + '\n'
-        + (opts.language ? 'Idioma: ' + opts.language + '\n' : '')
-        + '\nExtraccion:\n' + JSON.stringify(opts.extraction, null, 2);
-    const reply = await claude.chat({
-        messages: [{ role: 'user', content: userMessage }],
-        system: SYSTEM_PROMPT,
-        maxTokens: 4096,
+    const { callFlow } = await import('../license/hito4_client.js');
+    const r = await callFlow('spec-plan', {
+        extraction: opts.extraction,
+        title: opts.title,
+        language: opts.language,
     });
-    let parsed;
-    try {
-        parsed = parseJsonStrict(reply.text);
-    }
-    catch (err) {
-        const msg = err instanceof Error ? err.message : String(err);
-        throw new Error('spec_plan: could not parse Claude response as JSON: ' + msg
-            + '. Raw (first 500): ' + reply.text.slice(0, 500));
+    if (!r.ok) {
+        throw new Error('spec_plan via hito4 worker failed: HTTP ' + r.status
+            + ' -- ' + (typeof r.body?.error === 'string' ? r.body.error : 'no error message'));
     }
-    return validate(parsed);
+    const out = r.body.output ?? r.body;
+    return validate(out);
 }
 //# sourceMappingURL=spec_plan.js.map

package/dist/chat/spec_plan.js.map

@@ -1 +1 @@
-{"version":3,"file":"spec_plan.js","sourceRoot":"","sources":["../../src/chat/spec_plan.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"spec_plan.js","sourceRoot":"","sources":["../../src/chat/spec_plan.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AA4DH,MAAM,WAAW,GAA0B,IAAI,GAAG,CAAC;IACjD,WAAW,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,QAAQ,EAAE,OAAO;CAC9D,CAAC,CAAC;AACH,MAAM,eAAe,GAA8B,IAAI,GAAG,CAAC;IACzD,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,OAAO;CACvD,CAAC,CAAC;AAEH,SAAS,QAAQ,CAAC,GAAY;IAC5B,IAAI,CAAC,GAAG,IAAI,OAAO,GAAG,KAAK,QAAQ,EAAE,CAAC;QACpC,MAAM,IAAI,KAAK,CAAC,sCAAsC,CAAC,CAAC;IAC1D,CAAC;IACD,MAAM,CAAC,GAAG,GAA8B,CAAC;IACzC,MAAM,QAAQ,GAAG,OAAO,CAAC,CAAC,UAAU,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IACxE,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,MAAM,IAAI,KAAK,CAAC,6CAA6C,CAAC,CAAC;IACjE,CAAC;IACD,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,EAAE,CAAC;QAC/B,MAAM,IAAI,KAAK,CAAC,yCAAyC,CAAC,CAAC;IAC7D,CAAC;IACD,MAAM,KAAK,GAAmB,CAAC,CAAC,OAAO,CAAe;SACnD,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,KAAK,QAAQ,IAAI,CAAC,KAAK,IAAI,CAAC;SAClD,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE;QACX,MAAM,CAAC,GAAG,GAA8B,CAAC;QACzC,MAAM,OAAO,GAAG,OAAO,CAAC,CAAC,MAAM,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QAC/D,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,MAAM,IAAI,KAAK,CAAC,oCAAoC,CAAC,CAAC;QACxD,CAAC;QACD;;;sCAG8B;QAC9B,IAAI,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,iBAAiB,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC;YACzF,MAAM,IAAI,KAAK,CAAC,4CAA4C,GAAG,OAAO,CAAC,CAAC;QAC1E,CAAC;QACD,MAAM,OAAO,GAAG,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,OAAO,CAAC,CAAC;QAC7C,MAAM,IAAI,GAAa,WAAW,CAAC,GAAG,CAAC,OAAmB,CAAC;YACzD,CAAC,CAAE,OAAoB;YACvB,CAAC,CAAC,OAAO,CAAC;QACZ,MAAM,OAAO,GAAG,MAAM,CAAC,CAAC,CAAC,UAAU,CAAC,IAAI,OAAO,CAAC,CAAC;QACjD,MAAM,QAAQ,GAAiB,eAAe,CAAC,GAAG,CAAC,OAAuB,CAAC;YACzE,CAAC,CAAE,OAAwB;YAC3B,CAAC,CAAC,OAAO,CAAC;QACZ,MAAM,SAAS,GAAG,OAAO,CAAC,CAAC,WAAW,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QAC3E,MAAM,GAAG,GAAgB,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,SAAS,EAAE,CAAC;QACtE,IAAI,CAAC,CAAC,MAAM,CAAC,IAAI,OAAO,CAAC,CAAC,MAAM,CAAC,KAAK,QAAQ,EAAE,CAAC;YAC/C,MAAM,CAAC,GAAG,CAAC,CAAC,MAAM,CAA4B,CAAC;YAC/C,MAAM,IAAI,GAAqC,EAAE,CAAC;YAClD,IAAI,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC,EAAE,CAAC;gBACrC,IAAI,CAAC,YAAY,GAAI,CAAC,CAAC,cAAc,CAAe,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,KAAK,QAAQ,CAAa,CAAC;YACxG,CAAC;YACD,IAAI,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,EAAE,CAAC;gBACjC,IAAI,CAAC,QAAQ,GAAI,CAAC,CAAC,UAAU,CAAe,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,KAAK,QAAQ,CAAa,CAAC;YAChG,CAAC;YACD,IAAI,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,EAAE,CAAC;gBAClC,IAAI,CAAC,SAAS,GAAI,CAAC,CAAC,WAAW,CAAe,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,KAAK,QAAQ,CAAa,CAAC;YAClG,CAAC;YACD,IAAI,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,EAAE,CAAC;gBACnC,IAAI,CAAC,UAAU,GAAI,CAAC,CAAC,YAAY,CAAe,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,KAAK,QAAQ,CAAa,CAAC;YACpG,CAAC;YACD,GAAG,CAAC,IAAI,GAAG,IAAI,CAAC;QAClB,CAAC;QACD,OAAO,GAAG,CAAC;IACb,CAAC,CAAC,CAAC;IACL,MAAM,GAAG,GAAa,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC;IAC1C,IAAI,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,gBAAgB,CAAC,CAAC,EAAE,CAAC;QACvC,GAAG,CAAC,cAAc,GAAI,CAAC,CAAC,gBAAgB,CAAe,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,KAAK,QAAQ,CAAa,CAAC;IAC3G,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED;;;qDAGqD;AAErD,MAAM,CAAC,KAAK,UAAU,YAAY,CAChC,IAAyB;IAEzB,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,CAAC;QACrB,MAAM,IAAI,KAAK,CAAC,mCAAmC,CAAC,CAAC;IACvD,CAAC;IACD,MAAM,EAAE,QAAQ,EAAE,GAAG,MAAM,MAAM,CAAC,4BAA4B,CAAC,CAAC;IAChE,MAAM,CAAC,GAAG,MAAM,QAAQ,CAAC,WAAW,EAAE;QACpC,UAAU,EAAE,IAAI,CAAC,UAAU;QAC3B,KAAK,EAAO,IAAI,CAAC,KAAK;QACtB,QAAQ,EAAI,IAAI,CAAC,QAAQ;KAC1B,CAAC,CAAC;IACH,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;QACV,MAAM,IAAI,KAAK,CACb,0CAA0C,GAAG,CAAC,CAAC,MAAM;cACnD,MAAM,GAAG,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,kBAAkB,CAAC,CACnF,CAAC;IACJ,CAAC;IACD,MAAM,GAAG,GAAG,CAAC,CAAC,IAAI,CAAC,MAAM,IAAI,CAAC,CAAC,IAAI,CAAC;IACpC,OAAO,QAAQ,CAAC,GAAG,CAAC,CAAC;AACvB,CAAC"}

package/dist/chat/tools/app_backend_dispatch.d.ts

@@ -0,0 +1,39 @@
+/**
+ * NAC-3 v3.x backend tools dispatch (task #23 slice 2).
+ *
+ * When the LLM invokes nac3_invoke with verb_id="app.<tool_id>",
+ * this module resolves the tool from the adopter's
+ * yujin.forge.json nac3_backend.tools[], validates args against
+ * the declared schema, resolves the Vault auth header per
+ * auth.kind, sends the HTTP request, and writes an audit log
+ * entry with bridge-like provenance (base_url + tool_id + method
+ * + path + redacted args).
+ *
+ * R8 modal does NOT fire here in slice 2 (the modal lives at the
+ * panel layer + recognises native verb policies). app.*
+ * approval-required/destructive policies are documented in the
+ * stub for the LLM to respect; the modal-gating ships in a later
+ * slice alongside the panel UI integration.
+ *
+ * ASCII-only.
+ */
+import type { ToolResult } from '../tools.js';
+interface BaseEntry {
+    trace_id: string;
+    panel_session_id?: string;
+    forge_version: string;
+    llm_turn_id?: string;
+    user_text_hash?: string;
+    manifest_version: string;
+}
+export interface RunAppBackendToolInput {
+    toolId: string;
+    args: Record<string, unknown>;
+    baseEntry: BaseEntry;
+    startedAt: number;
+    projectRoot: string;
+}
+export declare function _resetBackendCatalogueCache(): void;
+export declare function runAppBackendTool(input: RunAppBackendToolInput): Promise<ToolResult>;
+export {};
+//# sourceMappingURL=app_backend_dispatch.d.ts.map

package/dist/chat/tools/app_backend_dispatch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"app_backend_dispatch.d.ts","sourceRoot":"","sources":["../../../src/chat/tools/app_backend_dispatch.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAW9C,UAAU,SAAS;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,aAAa,EAAE,MAAM,CAAC;IACtB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,gBAAgB,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,sBAAsB;IACrC,MAAM,EAAQ,MAAM,CAAC;IACrB,IAAI,EAAU,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACtC,SAAS,EAAK,SAAS,CAAC;IACxB,SAAS,EAAK,MAAM,CAAC;IACrB,WAAW,EAAG,MAAM,CAAC;CACtB;AAoBD,wBAAgB,2BAA2B,IAAI,IAAI,CAElD;AAgED,wBAAsB,iBAAiB,CAAC,KAAK,EAAE,sBAAsB,GAAG,OAAO,CAAC,UAAU,CAAC,CA+I1F"}

package/dist/chat/tools/app_backend_dispatch.js

@@ -0,0 +1,239 @@
+/**
+ * NAC-3 v3.x backend tools dispatch (task #23 slice 2).
+ *
+ * When the LLM invokes nac3_invoke with verb_id="app.<tool_id>",
+ * this module resolves the tool from the adopter's
+ * yujin.forge.json nac3_backend.tools[], validates args against
+ * the declared schema, resolves the Vault auth header per
+ * auth.kind, sends the HTTP request, and writes an audit log
+ * entry with bridge-like provenance (base_url + tool_id + method
+ * + path + redacted args).
+ *
+ * R8 modal does NOT fire here in slice 2 (the modal lives at the
+ * panel layer + recognises native verb policies). app.*
+ * approval-required/destructive policies are documented in the
+ * stub for the LLM to respect; the modal-gating ships in a later
+ * slice alongside the panel UI integration.
+ *
+ * ASCII-only.
+ */
+import { NAC3_INVOKE_SPEC } from './nac3_invoke.js';
+import { logDispatch, redactArgs } from '../../nac3/dispatch_log.js';
+import { loadBackendCatalogue, } from '../../nac3/backend_tools.js';
+import { validateArgs as validateNac3Args } from '../../nac3/internal_manifest.js';
+/* ====================================================================
+ * Catalogue cache -- avoid re-reading + re-parsing yujin.forge.json
+ * on every invoke. 30s TTL is generous since the file is
+ * developer-edited; live edits propagate within half a minute.
+ * ================================================================== */
+let _cache = null;
+const CACHE_TTL_MS = 30 * 1000;
+async function getCatalogue(projectRoot) {
+    if (_cache && _cache.projectRoot === projectRoot && Date.now() - _cache.at < CACHE_TTL_MS) {
+        return _cache.catalogue;
+    }
+    const parsed = await loadBackendCatalogue(projectRoot);
+    _cache = { projectRoot, catalogue: parsed.catalogue, at: Date.now() };
+    return parsed.catalogue;
+}
+export function _resetBackendCatalogueCache() {
+    _cache = null;
+}
+/* ====================================================================
+ * Args validation -- reuse the internal_manifest validator by
+ * shaping the BackendTool into a Nac3Verb-shaped object whose
+ * schema matches the v3.x params_schema.
+ * ================================================================== */
+function validateAppToolArgs(tool, args) {
+    const synth = {
+        id: 'app.' + tool.id,
+        schema: tool.params_schema,
+    };
+    return validateNac3Args(synth, args);
+}
+/* ====================================================================
+ * Auth header resolver
+ * ================================================================== */
+async function resolveAuthHeaders(auth) {
+    const headers = {};
+    if (auth.kind === 'none')
+        return { headers, authPresent: false };
+    const { getKey } = await import('../../core/provider_keys.js');
+    if (auth.kind === 'bearer' || auth.kind === 'oauth2_token') {
+        if (!auth.vault_slot)
+            return { headers, authPresent: false };
+        const tok = await getKey(auth.vault_slot);
+        if (tok) {
+            headers['authorization'] = 'Bearer ' + tok;
+            return { headers, authPresent: true };
+        }
+        return { headers, authPresent: false };
+    }
+    if (auth.kind === 'header_key') {
+        if (!auth.vault_slot || !auth.header_name)
+            return { headers, authPresent: false };
+        const tok = await getKey(auth.vault_slot);
+        if (tok) {
+            headers[auth.header_name.toLowerCase()] = tok;
+            return { headers, authPresent: true };
+        }
+        return { headers, authPresent: false };
+    }
+    if (auth.kind === 'basic') {
+        if (!auth.vault_slot_user || !auth.vault_slot_pass)
+            return { headers, authPresent: false };
+        const u = await getKey(auth.vault_slot_user);
+        const p = await getKey(auth.vault_slot_pass);
+        if (u && p) {
+            const encoded = Buffer.from(u + ':' + p, 'utf-8').toString('base64');
+            headers['authorization'] = 'Basic ' + encoded;
+            return { headers, authPresent: true };
+        }
+        return { headers, authPresent: false };
+    }
+    return { headers, authPresent: false };
+}
+/* ====================================================================
+ * Dispatcher
+ * ================================================================== */
+export async function runAppBackendTool(input) {
+    const { toolId, args, baseEntry, startedAt, projectRoot } = input;
+    const catalogue = await getCatalogue(projectRoot);
+    if (!catalogue) {
+        await logDispatch({
+            ts: new Date().toISOString(), kind: 'verb-not-found', ...baseEntry,
+            verb_id: 'app.' + toolId,
+            args_sample: redactArgs(args),
+            result_ok: false,
+            result_error: 'no nac3_backend section in yujin.forge.json',
+            duration_ms: Date.now() - startedAt,
+        });
+        return {
+            tool: NAC3_INVOKE_SPEC.name,
+            is_error: true,
+            result: {
+                error: 'No nac3_backend section in this project',
+                hint: 'The adopter app must declare nac3_backend.tools[] in yujin.forge.json for app.* verbs to be available. See docs/NAC3_SPEC_V3_BACKEND_TOOLS.md.',
+            },
+            display: 'nac3_invoke <- app.* without nac3_backend',
+        };
+    }
+    const tool = catalogue.tools.find((t) => t.id === toolId);
+    if (!tool) {
+        const available = catalogue.tools.map((t) => 'app.' + t.id);
+        await logDispatch({
+            ts: new Date().toISOString(), kind: 'verb-not-found', ...baseEntry,
+            verb_id: 'app.' + toolId,
+            args_sample: redactArgs(args),
+            result_ok: false,
+            result_error: 'app tool not found',
+            duration_ms: Date.now() - startedAt,
+        });
+        return {
+            tool: NAC3_INVOKE_SPEC.name,
+            is_error: true,
+            result: {
+                error: 'No app tool with id "' + toolId + '"',
+                available_verbs: available,
+            },
+            display: 'nac3_invoke <- unknown app tool ' + toolId,
+        };
+    }
+    const schemaErr = validateAppToolArgs(tool, args);
+    if (schemaErr) {
+        await logDispatch({
+            ts: new Date().toISOString(), kind: 'schema-fail', ...baseEntry,
+            verb_id: 'app.' + toolId,
+            args_sample: redactArgs(args),
+            result_ok: false,
+            result_error: schemaErr,
+            duration_ms: Date.now() - startedAt,
+        });
+        return {
+            tool: NAC3_INVOKE_SPEC.name,
+            is_error: true,
+            result: {
+                error: 'Args do not match the app tool schema: ' + schemaErr,
+                verb_id: 'app.' + toolId,
+                schema: tool.params_schema,
+                policy: tool.policy,
+            },
+            display: 'nac3_invoke <- app schema fail (' + toolId + ')',
+        };
+    }
+    /* Build URL + headers + body. */
+    const url = catalogue.base_url.replace(/\/$/, '') + tool.endpoint.path;
+    const { headers: authHeaders, authPresent } = await resolveAuthHeaders(catalogue.auth);
+    const headers = {
+        'content-type': 'application/json',
+        ...authHeaders,
+    };
+    let body;
+    if (tool.endpoint.method !== 'GET' && tool.endpoint.method !== 'DELETE') {
+        body = JSON.stringify(args);
+    }
+    /* GET / DELETE pass args as query string. Simple flat-only
+     * serialisation -- nested objects are JSON-encoded as value. */
+    const urlWithQuery = (tool.endpoint.method === 'GET' || tool.endpoint.method === 'DELETE') && Object.keys(args).length > 0
+        ? url + '?' + new URLSearchParams(Object.entries(args).map(([k, v]) => [
+            k,
+            typeof v === 'string' ? v : JSON.stringify(v),
+        ])).toString()
+        : url;
+    let response = null;
+    let httpStatus;
+    let invokeError;
+    try {
+        const ctrl = new AbortController();
+        const t = setTimeout(() => ctrl.abort(), 30000);
+        const r = await fetch(urlWithQuery, {
+            method: tool.endpoint.method,
+            signal: ctrl.signal,
+            headers,
+            body,
+        });
+        clearTimeout(t);
+        httpStatus = r.status;
+        try {
+            response = await r.json();
+        }
+        catch { /* response without json body is fine */ }
+        if (!r.ok) {
+            invokeError = 'HTTP ' + r.status;
+        }
+    }
+    catch (err) {
+        invokeError = err instanceof Error ? err.message : String(err);
+    }
+    await logDispatch({
+        ts: new Date().toISOString(), kind: 'invoke', ...baseEntry,
+        verb_id: 'app.' + toolId,
+        args_sample: redactArgs({
+            base_url: catalogue.base_url,
+            method: tool.endpoint.method,
+            path: tool.endpoint.path,
+            auth_present: authPresent,
+            ...args,
+        }),
+        policy: tool.policy,
+        side_effects_declared: [...tool.side_effects],
+        side_effects_actual: invokeError ? ['network'] : ['network', 'external-api'],
+        result_ok: !invokeError,
+        result_error: invokeError,
+        duration_ms: Date.now() - startedAt,
+    });
+    return {
+        tool: NAC3_INVOKE_SPEC.name,
+        is_error: false,
+        result: {
+            ok: !invokeError,
+            verb_id: 'app.' + toolId,
+            status: httpStatus,
+            ...(invokeError ? { error: 'app_invoke_failed', detail: invokeError, partial_response: response } : { response }),
+        },
+        display: invokeError
+            ? 'nac3_invoke <- app.' + toolId + ' failed (' + (httpStatus ?? 'no-status') + ')'
+            : 'nac3_invoke -> app.' + toolId + ' (' + (httpStatus ?? '?') + ')',
+    };
+}
+//# sourceMappingURL=app_backend_dispatch.js.map

package/dist/chat/tools/app_backend_dispatch.js.map

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

package/dist/chat/tools/audit_consumers.d.ts

@@ -0,0 +1,66 @@
+/**
+ * forge_audit_consumers -- internal Forge tool to prevent
+ * producer/consumer desynchronization (SQ Sec X "Producer/Consumer
+ * Symmetry").
+ *
+ * Forge calls this BEFORE committing any change that touches a
+ * shared data structure (vault slot, JSON key, env var, tool name,
+ * endpoint contract, type / interface name, file format). The tool
+ * does a deterministic grep across src/ + tests/ + docs/ and
+ * returns every location that reads or writes the concept, so
+ * Forge can verify all readers are in sync with the new writer
+ * shape (and, if not, fix them in the same commit).
+ *
+ * This tool is the operational arm of SQ Sec X. Forge is expected
+ * to use it autonomously -- the user is never prompted to interpret
+ * the output; Forge interprets it and acts.
+ *
+ * The grep is pure file-system + glob; no LLM, no external services.
+ * Runs in < 1 second on the Forge tree itself (~10k files).
+ *
+ * Background: on 2026-05-29 the BYOK keys_setup refactor (290db8a)
+ * introduced provider_keys.json as the canonical key writer, but
+ * three downstream readers (chat resolveApiKey, Google STT provider,
+ * Google TTS provider) were not updated in the same commit. Each
+ * was patched independently (alpha.6 -> alpha.7 -> alpha.8). Had
+ * Forge run forge_audit_consumers('anthropic_api_key') and
+ * ('google_stt_key' / 'google_tts_key') before alpha.4 publish,
+ * the desync would have been caught up-front.
+ *
+ * ASCII-only.
+ */
+import type { ToolContext, ToolResult, ToolSpec } from '../tools.js';
+export declare const AUDIT_CONSUMERS_SPEC: ToolSpec;
+export interface AuditHit {
+    /** Path relative to project root. */
+    file: string;
+    /** 1-indexed. */
+    line: number;
+    /** First 200 chars of the matching line. */
+    snippet: string;
+    /** Heuristic classification of the hit. */
+    kind: 'write' | 'read' | 'test' | 'doc' | 'unknown';
+}
+export interface AuditResult {
+    concept: string;
+    hits: AuditHit[];
+    /** True iff there were more hits than max_hits; Forge should
+     *  narrow the concept term to keep the audit useful. */
+    truncated: boolean;
+    /** Quick summary by kind, so Forge can decide at a glance
+     *  whether the producer/consumer set looks balanced. */
+    summary: {
+        write: number;
+        read: number;
+        test: number;
+        doc: number;
+        unknown: number;
+    };
+}
+export declare function runAuditConsumers(args: {
+    concept: string;
+    include_tests?: boolean;
+    include_docs?: boolean;
+    max_hits?: number;
+}, ctx: ToolContext): Promise<ToolResult>;
+//# sourceMappingURL=audit_consumers.d.ts.map

package/dist/chat/tools/audit_consumers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"audit_consumers.d.ts","sourceRoot":"","sources":["../../../src/chat/tools/audit_consumers.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AAIH,OAAO,KAAK,EAAE,WAAW,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAErE,eAAO,MAAM,oBAAoB,EAAE,QAwClC,CAAC;AAEF,MAAM,WAAW,QAAQ;IACvB,qCAAqC;IACrC,IAAI,EAAE,MAAM,CAAC;IACb,iBAAiB;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,4CAA4C;IAC5C,OAAO,EAAE,MAAM,CAAC;IAChB,2CAA2C;IAC3C,IAAI,EAAE,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,KAAK,GAAG,SAAS,CAAC;CACrD;AAED,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,QAAQ,EAAE,CAAC;IACjB;4DACwD;IACxD,SAAS,EAAE,OAAO,CAAC;IACnB;4DACwD;IACxD,OAAO,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;CACtF;AAyGD,wBAAsB,iBAAiB,CACrC,IAAI,EAAE;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,aAAa,CAAC,EAAE,OAAO,CAAC;IAAC,YAAY,CAAC,EAAE,OAAO,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAE,EAC7F,GAAG,EAAE,WAAW,GACf,OAAO,CAAC,UAAU,CAAC,CAqDrB"}