@gaunt-sloth/agent 2.0.0-alpha.35 → 2.0.0-alpha.37

package/README.md

@@ -2,7 +2,7 @@
 
 The agent runtime for Gaunt Sloth: built-in tools and toolkits (filesystem, dev/shell, web
 fetch, custom), the middleware registry, MCP client + OAuth provider, A2A client and tools, the
-AG-UI server (`startAgUiServer`), the ACP server (`startAcpServer`), the interactive session
+AG-UI server (`startAgUiServer`), the interactive session
 module, and the `createResolvers` tool/middleware resolver wiring. It builds on
 [`@gaunt-sloth/core`](https://www.npmjs.com/package/@gaunt-sloth/core) (config, provider
 factory, lean agent runtime).
@@ -45,19 +45,18 @@ not expose it to public networks. Port and CORS come from `commands.api.*` in th
 
 - **`gaunt-sloth-api`** — starts the AG-UI server standalone (the code above as a command):
   `gaunt-sloth-api` (defaults to the `ag-ui` server on `commands.api.port`, 3000 by default).
-- **`gaunt-sloth-acp`** — runs the [Agent Client Protocol](https://agentclientprotocol.com/)
-  server over stdio, for ACP hosts (Zed, JetBrains). Prefer `gaunt-sloth --acp-agent` from the
-  [`gaunt-sloth`](https://www.npmjs.com/package/gaunt-sloth) app instead: the LLM providers are
-  `peerDependencies` of `@gaunt-sloth/core` that only the app declares, so a bare
-  `@gaunt-sloth/agent` install has no providers to construct a model from. See the
-  [app README → ACP server](https://github.com/pukeko-robotics/gaunt-sloth/blob/main/packages/app/README.md#acp-server-editor-integration)
-  for setup and a Zed `settings.json` example.
+- **`gaunt-sloth-acp`** — serves the [Agent Client Protocol](https://agentclientprotocol.com/) over
+  stdio, for an editor that spawns the agent as a subprocess. **ACP v2 only**; a v1-only host
+  cannot connect. Takes no arguments, and roots the session at the working directory the host
+  supplies. Gated tools are escalated to the host as `session/request_permission`. The same server
+  is reachable programmatically as `startAcpServer()`, and as `createAcpAgentApp()` when you want
+  to serve it over a transport of your own.
 
 ## Exports
 
-- `@gaunt-sloth/agent` (the root export) is the public API: the AG-UI/ACP/interactive-session
+- `@gaunt-sloth/agent` (the root export) is the public API: the AG-UI and interactive-session
   modules, A2A client and tool, MCP utilities and OAuth provider, built-in tools config, the
-  middleware registry, the deep-agent factory, and `createResolvers`.
+  middleware registry, the agent-backend seam (`resolveAgentFactory`), and `createResolvers`.
 - `@gaunt-sloth/agent/<path>.js` deep paths mirror the internal `dist/` layout 1:1 and are
   deliberately kept open for reach-in (the fat CLI imports e.g.
   `@gaunt-sloth/agent/resolvers.js`). They are supported at your own risk: internal files can

package/cli-acp.js

@@ -1,35 +1,31 @@
 #!/usr/bin/env node
 
 /**
- * ACP (Agent Client Protocol) server entry for the Gaunt Sloth deep agent.
+ * ACP (Agent Client Protocol) server entry.
  * Usage: gaunt-sloth-acp
  *
- * Speaks ACP JSON-RPC over stdio, so an ACP host (Zed, JetBrains, a future Pukeko client)
- * can spawn this binary as a coding agent subprocess.
+ * Serves ACP v2 over stdio, for an editor that spawns the agent as a subprocess (Zed, and any
+ * other v2 client). The whole startup — including redirecting ordinary console output away from
+ * stdout, which the protocol owns — lives in `startAcpServer`, shared with
+ * `gaunt-sloth --acp-agent` so the two doors cannot drift.
  *
- * stdout is the ACP protocol channel and must stay clean: any stray byte corrupts framing.
- * gsloth's console output (initConfig info, agent status) routes through console.log/info,
- * which write to stdout — so before doing anything we redirect those to stderr. The ACP SDK
- * writes the protocol via process.stdout.write directly and is unaffected; console.warn/error
- * already go to stderr.
+ * A failure before the transport is up is written to stderr, never stdout: to a host, stdout is
+ * the JSON-RPC framing channel, so prose there is a protocol error rather than a message anyone
+ * reads.
  */
 
-for (const method of ['log', 'info']) {
-  console[method] = (...args) => process.stderr.write(args.join(' ') + '\n');
-}
+import { setEntryPoint } from '@gaunt-sloth/core/utils/systemUtils.js';
+import { startAcpServer } from '#src/modules/acp/acpStdio.js';
 
-import { initConfig } from '@gaunt-sloth/core/config.js';
-import { displayError } from '@gaunt-sloth/core/utils/consoleUtils.js';
-import { startAcpServer } from '#src/modules/acpModule.js';
+// The install dir is what `getSlothVersion()` reads, and the initialize handshake reports the
+// version. Set from THIS file so it resolves the agent package's own manifest.
+setEntryPoint(import.meta.url);
 
-async function main() {
-  try {
-    const config = await initConfig({});
-    await startAcpServer(config);
-  } catch (err) {
-    displayError(`ACP server failed: ${err instanceof Error ? err.message : String(err)}`);
-    process.exit(1);
-  }
+try {
+  await startAcpServer();
+} catch (err) {
+  process.stderr.write(
+    `Gaunt Sloth ACP agent failed to start: ${err instanceof Error ? (err.stack ?? err.message) : String(err)}\n`
+  );
+  process.exit(1);
 }
-
-main();

package/dist/builtInToolsConfig.d.ts

@@ -27,8 +27,8 @@ export declare const AVAILABLE_BUILT_IN_TOOLS: {
     /**
      * Content-search (grep) tool: ripgrep-backed regex search over file CONTENTS, with an
      * in-process JS fallback when `rg` is absent. Permission-light (no shell approval) and
-     * available in every mode. Named `gth_grep` to avoid colliding with the deep backend's
-     * built-in `grep`. Enabled by default (see {@link DEFAULT_CONFIG.builtInTools}, GS2-51); disable
+     * available in every mode. Named `gth_grep` rather than `grep` so it cannot collide with a
+     * built-in a graph builder registers under that name. Enabled by default (see {@link DEFAULT_CONFIG.builtInTools}, GS2-51); disable
      * with `{ "builtInTools": { "gth_grep": { "enabled": false } } }`. Its searched corpus is
      * selectable via the `fileSet` tool-config key (`gitignore` default / `all`).
      */

package/dist/builtInToolsConfig.js

@@ -34,8 +34,8 @@ export const AVAILABLE_BUILT_IN_TOOLS = {
     /**
      * Content-search (grep) tool: ripgrep-backed regex search over file CONTENTS, with an
      * in-process JS fallback when `rg` is absent. Permission-light (no shell approval) and
-     * available in every mode. Named `gth_grep` to avoid colliding with the deep backend's
-     * built-in `grep`. Enabled by default (see {@link DEFAULT_CONFIG.builtInTools}, GS2-51); disable
+     * available in every mode. Named `gth_grep` rather than `grep` so it cannot collide with a
+     * built-in a graph builder registers under that name. Enabled by default (see {@link DEFAULT_CONFIG.builtInTools}, GS2-51); disable
      * with `{ "builtInTools": { "gth_grep": { "enabled": false } } }`. Its searched corpus is
      * selectable via the `fileSet` tool-config key (`gitignore` default / `all`).
      */

package/dist/core/debugCapture.d.ts

@@ -1,10 +1,9 @@
 /**
  * @packageDocumentation
- * The debug-capture contract now lives in `@gaunt-sloth/core` so BOTH the lean
- * ({@link import('@gaunt-sloth/core/core/GthLangChainAgent.js').GthLangChainAgent}) and deep
- * ({@link import('#src/core/GthDeepAgent.js').GthDeepAgent}) backends can install the same
- * `wrapModelCall` capture middleware. This module re-exports it so existing
- * `@gaunt-sloth/agent/core/debugCapture.js` importers (the TUI debug panel) are unaffected.
+ * The debug-capture contract lives in `@gaunt-sloth/core`, beside the agent
+ * ({@link import('@gaunt-sloth/core/core/GthLangChainAgent.js').GthLangChainAgent}) that installs
+ * the `wrapModelCall` capture middleware. This module re-exports it so
+ * `@gaunt-sloth/agent/core/debugCapture.js` importers (the TUI debug panel) resolve it here too.
  */
 export type { DebugRequestExtras, DebugToolDef, DebugCapture, LastModelRequest, } from '@gaunt-sloth/core/core/debugCapture.js';
 export { extractDebugRequestExtras } from '@gaunt-sloth/core/core/debugCapture.js';

package/dist/core/debugCapture.js.map

@@ -1 +1 @@
-{"version":3,"file":"debugCapture.js","sourceRoot":"","sources":["../../src/core/debugCapture.ts"],"names":[],"mappings":"AAcA,OAAO,EAAE,yBAAyB,EAAE,MAAM,wCAAwC,CAAC"}
+{"version":3,"file":"debugCapture.js","sourceRoot":"","sources":["../../src/core/debugCapture.ts"],"names":[],"mappings":"AAaA,OAAO,EAAE,yBAAyB,EAAE,MAAM,wCAAwC,CAAC"}

package/dist/core/resolveAgentFactory.d.ts

@@ -1,14 +1,15 @@
 import type { GthAgentFactory } from '@gaunt-sloth/core/core/types.js';
 import type { GthConfig } from '@gaunt-sloth/core/config.js';
 /**
- * Resolve the agent backend factory from config (B5). An explicit `agent.backend` wins;
- * otherwise `defaultBackend` is used — the per-command default. Every command now defaults to
- * `'lean'`; `'deep'` is the experimental, opt-in backend (selecting it emits a warning).
+ * Resolve the agent backend factory from config (B5).
  *
- * Returns {@link gthDeepAgentFactory} for `'deep'` and {@link gthLeanAgentFactory} for `'lean'`.
- * Both factories receive the SAME `createResolvers()` toolset, so lean is not capability-stripped:
- * it keeps gaunt-sloth's own filesystem + (in code mode) dev/shell tools plus the `gth_checklist`
- * planning tool; it only drops the deepagents-specific extras (subagent `task`, `write_todos`,
- * summarization, `/large_tool_results`).
+ * There is one backend — the lean {@link gthLeanAgentFactory} — so every call resolves to it, and
+ * `agent.backend` can only name it. The seam is kept rather than inlined at the ten call sites
+ * because it is the single place a backend choice is made: reinstating a choice (EXT-46's ACP
+ * rebuild, or any later runtime) is an edit here, not an edit spread across every command.
+ *
+ * The parameters are accepted and ignored for the same reason. `defaultBackend` is each caller's
+ * per-command default, and every caller passes `'lean'`; typing it as the literal keeps a caller
+ * that means something else from compiling silently.
  */
-export declare function resolveAgentFactory(config: GthConfig, defaultBackend: 'deep' | 'lean'): GthAgentFactory;
+export declare function resolveAgentFactory(_config: GthConfig, _defaultBackend?: 'lean'): GthAgentFactory;

package/dist/core/resolveAgentFactory.js

@@ -1,18 +1,17 @@
 import { gthLeanAgentFactory } from '@gaunt-sloth/core/core/gthLeanAgentFactory.js';
-import { gthDeepAgentFactory } from '#src/core/gthDeepAgentFactory.js';
 /**
- * Resolve the agent backend factory from config (B5). An explicit `agent.backend` wins;
- * otherwise `defaultBackend` is used — the per-command default. Every command now defaults to
- * `'lean'`; `'deep'` is the experimental, opt-in backend (selecting it emits a warning).
+ * Resolve the agent backend factory from config (B5).
  *
- * Returns {@link gthDeepAgentFactory} for `'deep'` and {@link gthLeanAgentFactory} for `'lean'`.
- * Both factories receive the SAME `createResolvers()` toolset, so lean is not capability-stripped:
- * it keeps gaunt-sloth's own filesystem + (in code mode) dev/shell tools plus the `gth_checklist`
- * planning tool; it only drops the deepagents-specific extras (subagent `task`, `write_todos`,
- * summarization, `/large_tool_results`).
+ * There is one backend — the lean {@link gthLeanAgentFactory} — so every call resolves to it, and
+ * `agent.backend` can only name it. The seam is kept rather than inlined at the ten call sites
+ * because it is the single place a backend choice is made: reinstating a choice (EXT-46's ACP
+ * rebuild, or any later runtime) is an edit here, not an edit spread across every command.
+ *
+ * The parameters are accepted and ignored for the same reason. `defaultBackend` is each caller's
+ * per-command default, and every caller passes `'lean'`; typing it as the literal keeps a caller
+ * that means something else from compiling silently.
  */
-export function resolveAgentFactory(config, defaultBackend) {
-    const backend = config.agent?.backend ?? defaultBackend;
-    return backend === 'deep' ? gthDeepAgentFactory : gthLeanAgentFactory;
+export function resolveAgentFactory(_config, _defaultBackend = 'lean') {
+    return gthLeanAgentFactory;
 }
 //# sourceMappingURL=resolveAgentFactory.js.map

package/dist/core/resolveAgentFactory.js.map

@@ -1 +1 @@
-{"version":3,"file":"resolveAgentFactory.js","sourceRoot":"","sources":["../../src/core/resolveAgentFactory.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,mBAAmB,EAAE,MAAM,+CAA+C,CAAC;AACpF,OAAO,EAAE,mBAAmB,EAAE,MAAM,kCAAkC,CAAC;AAEvE;;;;;;;;;;GAUG;AACH,MAAM,UAAU,mBAAmB,CACjC,MAAiB,EACjB,cAA+B;IAE/B,MAAM,OAAO,GAAG,MAAM,CAAC,KAAK,EAAE,OAAO,IAAI,cAAc,CAAC;IACxD,OAAO,OAAO,KAAK,MAAM,CAAC,CAAC,CAAC,mBAAmB,CAAC,CAAC,CAAC,mBAAmB,CAAC;AACxE,CAAC"}
+{"version":3,"file":"resolveAgentFactory.js","sourceRoot":"","sources":["../../src/core/resolveAgentFactory.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,mBAAmB,EAAE,MAAM,+CAA+C,CAAC;AAEpF;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,mBAAmB,CACjC,OAAkB,EAClB,eAAe,GAAW,MAAM;IAEhC,OAAO,mBAAmB,CAAC;AAC7B,CAAC"}

package/dist/index.d.ts

@@ -1,5 +1,4 @@
 export * from '#src/modules/apiAgUiModule.js';
-export * from '#src/modules/acpModule.js';
 export * from '#src/modules/interactiveSessionModule.js';
 export * from '#src/modules/a2a/A2AClientWrapper.js';
 export * from '#src/tools/A2AAgentTool.js';
@@ -8,7 +7,6 @@ export * from '#src/utils/mcpUtils.js';
 export { createResolvers } from '#src/resolvers.js';
 export * from '#src/builtInToolsConfig.js';
 export { resolveMiddleware } from '#src/middleware/registry.js';
-export { GthDeepAgent, type GthDeepAgentParams } from '#src/core/GthDeepAgent.js';
-export * from '#src/core/deepAgentPermissions.js';
-export { gthDeepAgentFactory } from '#src/core/gthDeepAgentFactory.js';
 export { resolveAgentFactory } from '#src/core/resolveAgentFactory.js';
+export { startAcpServer } from '#src/modules/acp/acpStdio.js';
+export { createAcpAgentApp } from '#src/modules/acp/acpAgentApp.js';

package/dist/index.js

@@ -1,5 +1,4 @@
 export * from '#src/modules/apiAgUiModule.js';
-export * from '#src/modules/acpModule.js';
 export * from '#src/modules/interactiveSessionModule.js';
 export * from '#src/modules/a2a/A2AClientWrapper.js';
 export * from '#src/tools/A2AAgentTool.js';
@@ -9,9 +8,9 @@ export { createResolvers } from '#src/resolvers.js';
 // Tools + middleware (formerly @gaunt-sloth/tools)
 export * from '#src/builtInToolsConfig.js';
 export { resolveMiddleware } from '#src/middleware/registry.js';
-// Deep agent (createDeepAgent / deepagents) + the GthConfig→permission mapping
-export { GthDeepAgent } from '#src/core/GthDeepAgent.js';
-export * from '#src/core/deepAgentPermissions.js';
-export { gthDeepAgentFactory } from '#src/core/gthDeepAgentFactory.js';
+// The agent-backend seam every command resolves its factory through.
 export { resolveAgentFactory } from '#src/core/resolveAgentFactory.js';
+// The ACP (Agent Client Protocol) v2 agent, and the stdio starter both ACP bins run.
+export { startAcpServer } from '#src/modules/acp/acpStdio.js';
+export { createAcpAgentApp } from '#src/modules/acp/acpAgentApp.js';
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,+BAA+B,CAAC;AAC9C,cAAc,2BAA2B,CAAC;AAC1C,cAAc,0CAA0C,CAAC;AACzD,cAAc,sCAAsC,CAAC;AACrD,cAAc,4BAA4B,CAAC;AAC3C,cAAc,qCAAqC,CAAC;AACpD,cAAc,wBAAwB,CAAC;AACvC,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAEpD,mDAAmD;AACnD,cAAc,4BAA4B,CAAC;AAC3C,OAAO,EAAE,iBAAiB,EAAE,MAAM,6BAA6B,CAAC;AAEhE,+EAA+E;AAC/E,OAAO,EAAE,YAAY,EAA2B,MAAM,2BAA2B,CAAC;AAClF,cAAc,mCAAmC,CAAC;AAClD,OAAO,EAAE,mBAAmB,EAAE,MAAM,kCAAkC,CAAC;AACvE,OAAO,EAAE,mBAAmB,EAAE,MAAM,kCAAkC,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,+BAA+B,CAAC;AAC9C,cAAc,0CAA0C,CAAC;AACzD,cAAc,sCAAsC,CAAC;AACrD,cAAc,4BAA4B,CAAC;AAC3C,cAAc,qCAAqC,CAAC;AACpD,cAAc,wBAAwB,CAAC;AACvC,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAEpD,mDAAmD;AACnD,cAAc,4BAA4B,CAAC;AAC3C,OAAO,EAAE,iBAAiB,EAAE,MAAM,6BAA6B,CAAC;AAEhE,qEAAqE;AACrE,OAAO,EAAE,mBAAmB,EAAE,MAAM,kCAAkC,CAAC;AAEvE,qFAAqF;AACrF,OAAO,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAC9D,OAAO,EAAE,iBAAiB,EAAE,MAAM,iCAAiC,CAAC"}

package/dist/middleware/frontendImageInjectionMiddleware.d.ts

@@ -38,8 +38,9 @@ export interface FrontendImageInjectionOptions {
  *   - **ollama** → `{ type:'image_url', image_url:'<data-URL string>' }`. ChatOllama's
  *     `convertToOllamaMessages` only handles `image_url` blocks (extractBase64FromDataUrl); the
  *     LangChain standard `source_type` block throws "Unsupported content type: image".
- *   - **OpenAI-compatible** (`openai`, `openrouter`, `deepseek`, `xai`, `groq` — all extend
- *     `ChatOpenAI` / report `_llmType()==='openai'`) → `{ type:'image_url', image_url:{ url:'<data-URL>' } }`.
+ *   - **OpenAI-compatible** (`openai`, `openrouter`, `deepseek`, `xai`, `groq` — served by an
+ *     OpenAI-compatible Chat Completions API, whichever LangChain class fronts it) →
+ *     `{ type:'image_url', image_url:{ url:'<data-URL>' } }`.
  *     This native OpenAI shape is correct on BOTH the Completions API AND the Responses API (GS2-74
  *     flips reasoning-capable openai models to Responses). A raw `source_type` standard block
  *     serialises to an *invalid* image part on the Responses path, so we emit the provider-native

package/dist/middleware/frontendImageInjectionMiddleware.js

@@ -24,8 +24,9 @@ export const DEFAULT_CAPTURE_TOOL_NAME = 'capture_image';
  *   - **ollama** → `{ type:'image_url', image_url:'<data-URL string>' }`. ChatOllama's
  *     `convertToOllamaMessages` only handles `image_url` blocks (extractBase64FromDataUrl); the
  *     LangChain standard `source_type` block throws "Unsupported content type: image".
- *   - **OpenAI-compatible** (`openai`, `openrouter`, `deepseek`, `xai`, `groq` — all extend
- *     `ChatOpenAI` / report `_llmType()==='openai'`) → `{ type:'image_url', image_url:{ url:'<data-URL>' } }`.
+ *   - **OpenAI-compatible** (`openai`, `openrouter`, `deepseek`, `xai`, `groq` — served by an
+ *     OpenAI-compatible Chat Completions API, whichever LangChain class fronts it) →
+ *     `{ type:'image_url', image_url:{ url:'<data-URL>' } }`.
  *     This native OpenAI shape is correct on BOTH the Completions API AND the Responses API (GS2-74
  *     flips reasoning-capable openai models to Responses). A raw `source_type` standard block
  *     serialises to an *invalid* image part on the Responses path, so we emit the provider-native

package/dist/middleware/frontendImageInjectionMiddleware.js.map

@@ -1 +1 @@
-{"version":3,"file":"frontendImageInjectionMiddleware.js","sourceRoot":"","sources":["../../src/middleware/frontendImageInjectionMiddleware.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,EAAE,gBAAgB,EAAwB,MAAM,WAAW,CAAC;AACnE,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAavE,6FAA6F;AAC7F,MAAM,CAAC,MAAM,yBAAyB,GAAG,eAAe,CAAC;AAkBzD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,MAAM,UAAU,aAAa,CAAC,QAAgB,EAAE,QAAgB,EAAE,IAAY;IAC5E,MAAM,OAAO,GAAG,QAAQ,QAAQ,WAAW,IAAI,EAAE,CAAC;IAClD,QAAQ,QAAQ,EAAE,CAAC;QACjB,KAAK,QAAQ;YACX,OAAO,EAAE,IAAI,EAAE,WAAoB,EAAE,SAAS,EAAE,OAAO,EAAE,CAAC;QAC5D,KAAK,QAAQ,CAAC;QACd,KAAK,YAAY,CAAC;QAClB,KAAK,UAAU,CAAC;QAChB,KAAK,KAAK,CAAC;QACX,KAAK,MAAM;YACT,OAAO,EAAE,IAAI,EAAE,WAAoB,EAAE,SAAS,EAAE,EAAE,GAAG,EAAE,OAAO,EAAE,EAAE,CAAC;QACrE,KAAK,WAAW;YACd,OAAO;gBACL,IAAI,EAAE,OAAgB;gBACtB,MAAM,EAAE,EAAE,IAAI,EAAE,QAAiB,EAAE,UAAU,EAAE,QAAQ,EAAE,IAAI,EAAE;aAChE,CAAC;QACJ,KAAK,cAAc,CAAC;QACpB,KAAK,UAAU,CAAC;QAChB;YACE,OAAO;gBACL,IAAI,EAAE,OAAgB;gBACtB,WAAW,EAAE,QAAiB;gBAC9B,SAAS,EAAE,QAAQ;gBACnB,IAAI;aACL,CAAC;IACN,CAAC;AACH,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,sCAAsC,CACpD,IAAmC;IAEnC,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,IAAI,yBAAyB,CAAC;IAE5D,6FAA6F;IAC7F,8FAA8F;IAC9F,gGAAgG;IAChG,+FAA+F;IAC/F,gGAAgG;IAChG,gGAAgG;IAChG,gGAAgG;IAChG,oEAAoE;IACpE,EAAE;IACF,iGAAiG;IACjG,+FAA+F;IAC/F,oGAAoG;IACpG,mGAAmG;IACnG,MAAM,gBAAgB,GAAG,IAAI,GAAG,EAAuB,CAAC;IAExD,OAAO,gBAAgB,CAAC;QACtB,IAAI,EAAE,0BAA0B;QAEhC,WAAW,EAAE,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE;YACpC,MAAM,QAAQ,GAAG,KAAK,CAAC,QAAQ,IAAI,EAAE,CAAC;YACtC,+FAA+F;YAC/F,6FAA6F;YAC7F,gGAAgG;YAChG,MAAM,QAAQ,GAAG,OAAO,EAAE,YAAY,EAAE,SAAS,IAAI,aAAa,CAAC;YACnE,IAAI,WAAW,GAAG,gBAAgB,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;YACjD,IAAI,CAAC,WAAW,EAAE,CAAC;gBACjB,WAAW,GAAG,IAAI,GAAG,EAAU,CAAC;gBAChC,gBAAgB,CAAC,GAAG,CAAC,QAAQ,EAAE,WAAW,CAAC,CAAC;YAC9C,CAAC;YAED,6FAA6F;YAC7F,wEAAwE;YACxE,MAAM,QAAQ,GAAiD,EAAE,CAAC;YAClE,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,QAAQ,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;gBACzC,MAAM,GAAG,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC;gBACxB;gBACE,gFAAgF;gBAChF,6FAA6F;gBAC7F,4FAA4F;gBAC5F,2FAA2F;gBAC3F,mFAAmF;gBACnF,aAAa,CAAC,GAAG,CAAC;oBAClB,OAAO,GAAG,CAAC,OAAO,KAAK,QAAQ;oBAC/B,GAAG,CAAC,IAAI,KAAK,QAAQ,EACrB,CAAC;oBACD,MAAM,EAAE,GAAG,GAAG,CAAC,YAAY,CAAC;oBAC5B,IAAI,CAAC,EAAE,IAAI,WAAW,CAAC,GAAG,CAAC,EAAE,CAAC;wBAAE,SAAS;oBACzC,IAAI,CAAC;wBACH,QAAQ,CAAC,IAAI,CAAC,EAAE,OAAO,EAAE,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,OAAO,CAAiB,EAAE,EAAE,EAAE,CAAC,CAAC;oBAC1E,CAAC;oBAAC,MAAM,CAAC;wBACP,iEAAiE;oBACnE,CAAC;gBACH,CAAC;YACH,CAAC;YAED,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC;gBAAE,OAAO,SAAS,CAAC;YAE5C,MAAM,WAAW,GAAG,CAAC,GAAG,QAAQ,CAAC,CAAC;YAClC,KAAK,MAAM,EAAE,OAAO,EAAE,EAAE,EAAE,IAAI,QAAQ,EAAE,CAAC;gBACvC,IAAI,OAAO,CAAC,KAAK,EAAE,CAAC;oBAClB,oEAAoE;oBACpE,WAAW,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;oBACpB,WAAW,CAAC,IAAI,CAAC,IAAI,YAAY,CAAC,EAAE,OAAO,EAAE,uBAAuB,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,CAAC;oBACxF,SAAS;gBACX,CAAC;gBACD,IAAI,OAAO,CAAC,QAAQ,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC;oBACrC,0FAA0F;oBAC1F,uFAAuF;oBACvF,mFAAmF;oBACnF,WAAW,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;oBACpB,MAAM,KAAK,GAAG,aAAa,CAAC,IAAI,CAAC,QAAQ,EAAE,OAAO,CAAC,QAAQ,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;oBAC3E,WAAW,CAAC,IAAI,CACd,IAAI,YAAY,CAAC;wBACf,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,wBAAwB,EAAE,EAAE,KAAK,CAAmB;qBACrF,CAAC,CACH,CAAC;gBACJ,CAAC;gBACD,yFAAyF;YAC3F,CAAC;YAED,6FAA6F;YAC7F,2FAA2F;YAC3F,OAAO,WAAW,CAAC,MAAM,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,WAAW,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC;QACtF,CAAC;KACF,CAAC,CAAC;AACL,CAAC"}
+{"version":3,"file":"frontendImageInjectionMiddleware.js","sourceRoot":"","sources":["../../src/middleware/frontendImageInjectionMiddleware.ts"],"names":[],"mappings":"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"}

package/dist/middleware/registry.js

@@ -14,9 +14,22 @@ import { createFrontendImageInjectionMiddleware } from '#src/middleware/frontend
  * Derive the provider string the vision middleware maps to a per-provider block shape. Prefers the
  * loader-stashed raw `llm.type` ({@link GthConfig.modelProviderType}) — the exact gth provider
  * namespace (`anthropic`/`openrouter`/`deepseek`/`xai`/`groq`/`ollama`/`google-genai`/`vertexai`/…)
- * — and falls back to the live model's `_llmType()` only when it is absent (module configs). The
- * OpenAI-compatible shims (openrouter/deepseek/xai/groq) all report `_llmType() === 'openai'`, which
- * maps to the same `image_url:{url}` block, so the fallback stays shape-correct.
+ * — and falls back to the live model's `_llmType()` only when it is absent (module configs).
+ * `_llmType()` is the model class's own label rather than the gth provider namespace, so the two
+ * only mostly agree. Where they do: `openrouter`/`deepseek`/`xai`/`groq`/`ollama`/`anthropic` each
+ * report their own name, which `imageBlockFor` matches directly, and both Gemini providers report
+ * `google`, which lands on the default branch — the same standard block its `google-genai`/
+ * `vertexai` cases return.
+ *
+ * Two labels do NOT agree, and this fallback is the only path either can arrive on:
+ *   - `huggingface` reports `openai`, so the fallback emits `image_url:{url}` where the configured
+ *     `type` would take the default standard block. Which of the two the HF router actually accepts
+ *     is unmeasured — see [[CFG-45]]. Do not add a branch by analogy.
+ *   - `ChatXAIResponses` reports `xai-responses`, which matches no case and so takes the default
+ *     standard block — while `imageBlockFor`'s own docstring records that a standard block
+ *     serialises to an INVALID image part on the Responses path. gth itself only ever constructs
+ *     `ChatXAI`, so this is reachable only from a module config that builds the Responses class
+ *     itself.
  */
 function resolveVisionProvider(gthConfig) {
     if (gthConfig.modelProviderType)

package/dist/middleware/registry.js.map

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

package/dist/modules/acp/acpAgentApp.d.ts

@@ -0,0 +1,93 @@
+/**
+ * @packageDocumentation
+ * Gaunt Sloth's ACP (Agent Client Protocol) **v2** agent, built on the official SDK's
+ * `experimental/v2` surface.
+ *
+ * ## v2 only, on purpose
+ *
+ * The SDK still ships v1 as its stable entry point and the migration guide advises serving both.
+ * This agent serves **v2 alone**. Zed — the editor this surface exists for — speaks v2, and the
+ * suite here drives a client we write ourselves, so nothing about proving this code works depends
+ * on a third party. A v1-only client failing to connect is a known consequence, not a defect: the
+ * cost of the compatibility layer is a second protocol to keep correct forever, and it would be
+ * carried on speculation about clients nobody here has.
+ *
+ * ## Shape
+ *
+ * v2's agent side is a fluent app builder: `acp.agent()` returns an {@link AgentApp} on which
+ * typed handlers are registered by ACP method name, and `connect()` serves a client — either over
+ * a transport stream or, for tests, directly against a `ClientApp`. Nothing about it resembles the
+ * v1 code this replaces, which subclassed a third party's server and monkey-patched an instance
+ * method before start; that is why this targets v2 directly rather than porting the old shape.
+ *
+ * ## The prompt lifecycle is the part that looks wrong until you read the spec
+ *
+ * `session/prompt` returns `{}` **as soon as the prompt is accepted** — not when the turn finishes.
+ * Progress, tool calls and the final stop reason all arrive as `session/update` notifications, and
+ * the turn is over when an idle `state_update` carrying a stop reason lands. That is what makes
+ * cancellation expressible at all: a cancelled turn reports `cancelled` on a `state_update`, while
+ * the prompt request it belongs to was answered long before. A client that waited on the prompt
+ * response for the result would hang through every tool call.
+ *
+ * ## Why a runner and not an agent
+ *
+ * Each session drives a {@link GthAgentRunner}, not a bare agent. The runner is where the
+ * tool-approval gate lives, so this is also the surface where `session/request_permission` is
+ * wired — see `acpPermissions.ts` for why that is not optional.
+ *
+ * ## One workspace per process
+ *
+ * Config discovery, the filesystem tools' allowed root, grep and the shell tool ALL resolve
+ * through `getCurrentWorkDir()`, a process-global. So the workspace is bound by the first
+ * `session/new` and a later `session/new` naming a different `cwd` is refused rather than served
+ * from the wrong root. An editor spawns one agent process per project, which is exactly the shape
+ * this serves; the alternative — letting the second session silently re-root the first session's
+ * tools — is the kind of quiet wrongness that is worse than an error a host can report.
+ */
+import * as acp from '@agentclientprotocol/sdk/experimental/v2';
+import type { GthConfig } from '@gaunt-sloth/core/config.js';
+import type { AgentResolvers } from '@gaunt-sloth/core/core/types.js';
+import type { GthAgentFactory } from '@gaunt-sloth/core/core/types.js';
+/** How this agent identifies itself in the `initialize` response. */
+export declare const ACP_AGENT_NAME = "gaunt-sloth";
+/** Human-facing name for the same, used where a client shows a title rather than an id. */
+export declare const ACP_AGENT_TITLE = "Gaunt Sloth";
+/**
+ * Whether two already-resolved absolute paths name the same workspace.
+ *
+ * **Case-insensitive on win32 and nowhere else**, because that is where the answer differs: NTFS is
+ * case-insensitive and case-preserving, so `C:\Foo` and `c:\foo` are one directory and an exact
+ * string compare calls them two — a client that re-sends its own `cwd` with different casing would
+ * be told to start a second agent process for the project it is already in. On POSIX the two really
+ * are different directories and must keep comparing unequal, so the platform is the whole
+ * distinction rather than a workaround for one.
+ *
+ * `platform` is a parameter with the live value as its default so both arms are testable on any
+ * host. Every other bug of this shape in this repo (OPS-27, EXT-38, GS2-42, EXT-16) was a POSIX-only
+ * assertion that passed everywhere except the Windows cell, and a test that can only run on win32
+ * would have the same blind spot pointed the other way.
+ */
+export declare function isSameWorkspace(a: string, b: string, platform?: NodeJS.Platform): boolean;
+/** Seams the tests replace; production leaves every one of them at its default. */
+export interface AcpAgentAppOptions {
+    /**
+     * Loads the effective gth config for a session rooted at `cwd`. Defaults to pointing config
+     * discovery at the session workspace and running the normal loader.
+     */
+    loadConfig?: (cwd: string) => Promise<GthConfig>;
+    /**
+     * The agent backend for a session. Defaults to {@link resolveAgentFactory}, i.e. the lean agent
+     * — the same backend every other command resolves, reached through the same seam rather than
+     * named here, so a future backend choice stays a single edit.
+     */
+    agentFactory?: (config: GthConfig) => GthAgentFactory;
+    /** Tool/content resolvers handed to the runner. Defaults to {@link createResolvers}. */
+    resolvers?: AgentResolvers;
+}
+/**
+ * Builds the ACP v2 agent app. Register-and-return only: nothing is connected and no config is
+ * read until a client connects and creates a session.
+ */
+export declare function createAcpAgentApp(options?: AcpAgentAppOptions): acp.AgentApp;
+/** Kept for the entry points, which announce themselves on stderr before serving. */
+export declare function announceAcpStart(): void;