agentspeak-cli 0.9.0 → 0.10.0

package/dist/adapters/claude.d.ts

@@ -1,4 +1,4 @@
-import type { Adapter } from './index.js';
+import type { Adapter, ProbeResult } from './index.js';
 /**
  * `--via claude` — Anthropic Claude Code CLI.
  *
@@ -10,4 +10,5 @@ import type { Adapter } from './index.js';
  * pass the pre-attach gate.
  */
 export declare const claudeAdapter: Adapter;
+export declare function claudeProbe(): Promise<ProbeResult>;
 //# sourceMappingURL=claude.d.ts.map

package/dist/adapters/claude.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"claude.d.ts","sourceRoot":"","sources":["../../src/adapters/claude.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAAiB,MAAM,YAAY,CAAC;AAGzD;;;;;;;;;GASG;AACH,eAAO,MAAM,aAAa,EAAE,OAmB3B,CAAC"}
+{"version":3,"file":"claude.d.ts","sourceRoot":"","sources":["../../src/adapters/claude.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAAiB,WAAW,EAAE,MAAM,YAAY,CAAC;AAGtE;;;;;;;;;GASG;AACH,eAAO,MAAM,aAAa,EAAE,OAmB3B,CAAC;AAEF,wBAAsB,WAAW,IAAI,OAAO,CAAC,WAAW,CAAC,CAWxD"}

package/dist/adapters/claude.js

@@ -26,6 +26,17 @@ export const claudeAdapter = async (ctx) => {
         timeoutMs: ctx.timeoutMs,
     });
 };
+export async function claudeProbe() {
+    const bin = which('claude');
+    if (!bin) {
+        return {
+            ok: false,
+            detail: 'claude binary not found on PATH. ' +
+                'Install with `npm i -g @anthropic-ai/claude-code`, or pass --via echo / --via stdin.',
+        };
+    }
+    return { ok: true, detail: `found claude at ${bin}; will use \`claude -p\` per turn.` };
+}
 function ok(body, start) {
     return { stdout: body, stderr: '', exitCode: 0, durationMs: Date.now() - start, timedOut: false };
 }

package/dist/adapters/claude.js.map

@@ -1 +1 @@
-{"version":3,"file":"claude.js","sourceRoot":"","sources":["../../src/adapters/claude.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,wBAAwB,EAAE,MAAM,YAAY,CAAC;AAEtD,OAAO,EAAE,aAAa,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAC;AAEnE;;;;;;;;;GASG;AACH,MAAM,CAAC,MAAM,aAAa,GAAY,KAAK,EAAE,GAAG,EAAE,EAAE;IAClD,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IACzB,IAAI,GAAG,CAAC,SAAS,EAAE,CAAC;QAClB,OAAO,EAAE,CAAC,YAAY,EAAE,KAAK,CAAC,CAAC;IACjC,CAAC;IACD,MAAM,GAAG,GAAG,KAAK,CAAC,QAAQ,CAAC,CAAC;IAC5B,IAAI,CAAC,GAAG,EAAE,CAAC;QACT,OAAO,aAAa,CAClB,QAAQ,EACR,GAAG,EACH,iGAAiG,CAClG,CAAC;IACJ,CAAC;IACD,OAAO,QAAQ,CAAC;QACd,GAAG;QACH,IAAI,EAAE,CAAC,IAAI,CAAC;QACZ,WAAW,EAAE,wBAAwB,CAAC,GAAG,CAAC,QAAQ,CAAC;QACnD,SAAS,EAAE,GAAG,CAAC,SAAS;KACzB,CAAC,CAAC;AACL,CAAC,CAAC;AAEF,SAAS,EAAE,CAAC,IAAY,EAAE,KAAa;IACrC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,QAAQ,EAAE,CAAC,EAAE,UAAU,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC;AACpG,CAAC"}
+{"version":3,"file":"claude.js","sourceRoot":"","sources":["../../src/adapters/claude.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,wBAAwB,EAAE,MAAM,YAAY,CAAC;AAEtD,OAAO,EAAE,aAAa,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAC;AAEnE;;;;;;;;;GASG;AACH,MAAM,CAAC,MAAM,aAAa,GAAY,KAAK,EAAE,GAAG,EAAE,EAAE;IAClD,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IACzB,IAAI,GAAG,CAAC,SAAS,EAAE,CAAC;QAClB,OAAO,EAAE,CAAC,YAAY,EAAE,KAAK,CAAC,CAAC;IACjC,CAAC;IACD,MAAM,GAAG,GAAG,KAAK,CAAC,QAAQ,CAAC,CAAC;IAC5B,IAAI,CAAC,GAAG,EAAE,CAAC;QACT,OAAO,aAAa,CAClB,QAAQ,EACR,GAAG,EACH,iGAAiG,CAClG,CAAC;IACJ,CAAC;IACD,OAAO,QAAQ,CAAC;QACd,GAAG;QACH,IAAI,EAAE,CAAC,IAAI,CAAC;QACZ,WAAW,EAAE,wBAAwB,CAAC,GAAG,CAAC,QAAQ,CAAC;QACnD,SAAS,EAAE,GAAG,CAAC,SAAS;KACzB,CAAC,CAAC;AACL,CAAC,CAAC;AAEF,MAAM,CAAC,KAAK,UAAU,WAAW;IAC/B,MAAM,GAAG,GAAG,KAAK,CAAC,QAAQ,CAAC,CAAC;IAC5B,IAAI,CAAC,GAAG,EAAE,CAAC;QACT,OAAO;YACL,EAAE,EAAE,KAAK;YACT,MAAM,EACJ,mCAAmC;gBACnC,sFAAsF;SACzF,CAAC;IACJ,CAAC;IACD,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,mBAAmB,GAAG,oCAAoC,EAAE,CAAC;AAC1F,CAAC;AAED,SAAS,EAAE,CAAC,IAAY,EAAE,KAAa;IACrC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,QAAQ,EAAE,CAAC,EAAE,UAAU,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC;AACpG,CAAC"}

package/dist/adapters/cursor-agent.d.ts

@@ -1,4 +1,4 @@
-import type { Adapter } from './index.js';
+import type { Adapter, ProbeResult } from './index.js';
 /**
  * `--via cursor-agent` — Cursor Agent CLI.
  *
@@ -7,4 +7,5 @@ import type { Adapter } from './index.js';
  * Cursor account and selected model — no API key plumbing required.
  */
 export declare const cursorAgentAdapter: Adapter;
+export declare function cursorAgentProbe(): Promise<ProbeResult>;
 //# sourceMappingURL=cursor-agent.d.ts.map

package/dist/adapters/cursor-agent.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cursor-agent.d.ts","sourceRoot":"","sources":["../../src/adapters/cursor-agent.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAAiB,MAAM,YAAY,CAAC;AAGzD;;;;;;GAMG;AACH,eAAO,MAAM,kBAAkB,EAAE,OAmBhC,CAAC"}
+{"version":3,"file":"cursor-agent.d.ts","sourceRoot":"","sources":["../../src/adapters/cursor-agent.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAAiB,WAAW,EAAE,MAAM,YAAY,CAAC;AAGtE;;;;;;GAMG;AACH,eAAO,MAAM,kBAAkB,EAAE,OAmBhC,CAAC;AAEF,wBAAsB,gBAAgB,IAAI,OAAO,CAAC,WAAW,CAAC,CAW7D"}

package/dist/adapters/cursor-agent.js

@@ -23,6 +23,17 @@ export const cursorAgentAdapter = async (ctx) => {
         timeoutMs: ctx.timeoutMs,
     });
 };
+export async function cursorAgentProbe() {
+    const bin = which('cursor-agent');
+    if (!bin) {
+        return {
+            ok: false,
+            detail: 'cursor-agent binary not found on PATH. ' +
+                'Enable it via Cursor > Settings > Agent CLI, then re-run.',
+        };
+    }
+    return { ok: true, detail: `found cursor-agent at ${bin}; will use \`cursor-agent --print\` per turn.` };
+}
 function ok(body, start) {
     return { stdout: body, stderr: '', exitCode: 0, durationMs: Date.now() - start, timedOut: false };
 }

package/dist/adapters/cursor-agent.js.map

@@ -1 +1 @@
-{"version":3,"file":"cursor-agent.js","sourceRoot":"","sources":["../../src/adapters/cursor-agent.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,wBAAwB,EAAE,MAAM,YAAY,CAAC;AAEtD,OAAO,EAAE,aAAa,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAC;AAEnE;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAY,KAAK,EAAE,GAAG,EAAE,EAAE;IACvD,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IACzB,IAAI,GAAG,CAAC,SAAS,EAAE,CAAC;QAClB,OAAO,EAAE,CAAC,YAAY,EAAE,KAAK,CAAC,CAAC;IACjC,CAAC;IACD,MAAM,GAAG,GAAG,KAAK,CAAC,cAAc,CAAC,CAAC;IAClC,IAAI,CAAC,GAAG,EAAE,CAAC;QACT,OAAO,aAAa,CAClB,cAAc,EACd,GAAG,EACH,iFAAiF,CAClF,CAAC;IACJ,CAAC;IACD,OAAO,QAAQ,CAAC;QACd,GAAG;QACH,IAAI,EAAE,CAAC,SAAS,CAAC;QACjB,WAAW,EAAE,wBAAwB,CAAC,GAAG,CAAC,QAAQ,CAAC;QACnD,SAAS,EAAE,GAAG,CAAC,SAAS;KACzB,CAAC,CAAC;AACL,CAAC,CAAC;AAEF,SAAS,EAAE,CAAC,IAAY,EAAE,KAAa;IACrC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,QAAQ,EAAE,CAAC,EAAE,UAAU,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC;AACpG,CAAC"}
+{"version":3,"file":"cursor-agent.js","sourceRoot":"","sources":["../../src/adapters/cursor-agent.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,wBAAwB,EAAE,MAAM,YAAY,CAAC;AAEtD,OAAO,EAAE,aAAa,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAC;AAEnE;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAY,KAAK,EAAE,GAAG,EAAE,EAAE;IACvD,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IACzB,IAAI,GAAG,CAAC,SAAS,EAAE,CAAC;QAClB,OAAO,EAAE,CAAC,YAAY,EAAE,KAAK,CAAC,CAAC;IACjC,CAAC;IACD,MAAM,GAAG,GAAG,KAAK,CAAC,cAAc,CAAC,CAAC;IAClC,IAAI,CAAC,GAAG,EAAE,CAAC;QACT,OAAO,aAAa,CAClB,cAAc,EACd,GAAG,EACH,iFAAiF,CAClF,CAAC;IACJ,CAAC;IACD,OAAO,QAAQ,CAAC;QACd,GAAG;QACH,IAAI,EAAE,CAAC,SAAS,CAAC;QACjB,WAAW,EAAE,wBAAwB,CAAC,GAAG,CAAC,QAAQ,CAAC;QACnD,SAAS,EAAE,GAAG,CAAC,SAAS;KACzB,CAAC,CAAC;AACL,CAAC,CAAC;AAEF,MAAM,CAAC,KAAK,UAAU,gBAAgB;IACpC,MAAM,GAAG,GAAG,KAAK,CAAC,cAAc,CAAC,CAAC;IAClC,IAAI,CAAC,GAAG,EAAE,CAAC;QACT,OAAO;YACL,EAAE,EAAE,KAAK;YACT,MAAM,EACJ,yCAAyC;gBACzC,2DAA2D;SAC9D,CAAC;IACJ,CAAC;IACD,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,yBAAyB,GAAG,+CAA+C,EAAE,CAAC;AAC3G,CAAC;AAED,SAAS,EAAE,CAAC,IAAY,EAAE,KAAa;IACrC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,QAAQ,EAAE,CAAC,EAAE,UAAU,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC;AACpG,CAAC"}

package/dist/adapters/hermes.d.ts

@@ -1,10 +1,6 @@
-import type { Adapter } from './index.js';
-/**
- * `--via hermes` — Hermes runtime CLI bridge.
- *
- * Invocation: `hermes prompt` reads the prompt on stdin and prints the
- * agent's reply. Detection prefers `which hermes` and falls back to
- * `$HERMES_HOME/bin/hermes` so a pinned-install runtime still works.
- */
+import type { Adapter, ProbeResult } from './index.js';
 export declare const hermesAdapter: Adapter;
+export declare function hermesProbe(): Promise<ProbeResult>;
+/** Test-only: clear the cached verb between unit tests. */
+export declare function __resetCachedVerb(): void;
 //# sourceMappingURL=hermes.d.ts.map

package/dist/adapters/hermes.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"hermes.d.ts","sourceRoot":"","sources":["../../src/adapters/hermes.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAAiB,MAAM,YAAY,CAAC;AAGzD;;;;;;GAMG;AACH,eAAO,MAAM,aAAa,EAAE,OAuB3B,CAAC"}
+{"version":3,"file":"hermes.d.ts","sourceRoot":"","sources":["../../src/adapters/hermes.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAAiB,WAAW,EAAE,MAAM,YAAY,CAAC;AA+BtE,eAAO,MAAM,aAAa,EAAE,OAiC3B,CAAC;AAEF,wBAAsB,WAAW,IAAI,OAAO,CAAC,WAAW,CAAC,CAqBxD;AAMD,2DAA2D;AAC3D,wBAAgB,iBAAiB,IAAI,IAAI,CAExC"}

package/dist/adapters/hermes.js

@@ -1,33 +1,85 @@
 import { renderPromptFromEnvelope } from './index.js';
-import { binaryMissing, shellOut, which } from './shell-helper.js';
+import { binaryMissing, pickSubcommand, probeHelp, shellOut, which } from './shell-helper.js';
 /**
  * `--via hermes` — Hermes runtime CLI bridge.
  *
- * Invocation: `hermes prompt` reads the prompt on stdin and prints the
- * agent's reply. Detection prefers `which hermes` and falls back to
- * `$HERMES_HOME/bin/hermes` so a pinned-install runtime still works.
+ * Hermes does NOT ship a `prompt` subcommand (the previous adapter
+ * version assumed it did, which silently passed every smoke test and
+ * exit-2'd every real turn — see meet_qgCvGEsNjmUiY0hUwR9F6w). The
+ * actual surface is `hermes chat`. We probe `--help` once on attach
+ * and pick the first matching subcommand from KNOWN_VERBS so future
+ * Hermes versions that rename the chat command keep working.
  */
+const KNOWN_VERBS = ['chat', 'prompt', 'reply', 'message'];
+let cachedVerb = null;
+function locateBinary() {
+    let bin = which('hermes');
+    if (!bin && process.env.HERMES_HOME) {
+        bin = `${process.env.HERMES_HOME.replace(/\/$/, '')}/bin/hermes`;
+    }
+    return bin;
+}
+async function detectVerb(bin) {
+    if (cachedVerb)
+        return cachedVerb;
+    const help = await probeHelp(bin);
+    cachedVerb = pickSubcommand(help, KNOWN_VERBS);
+    return cachedVerb;
+}
 export const hermesAdapter = async (ctx) => {
     const start = Date.now();
     if (ctx.smokeTest) {
         return ok('[smoke ok]', start);
     }
-    let bin = which('hermes');
-    if (!bin && process.env.HERMES_HOME) {
-        const candidate = `${process.env.HERMES_HOME.replace(/\/$/, '')}/bin/hermes`;
-        bin = candidate;
-    }
+    const bin = locateBinary();
     if (!bin) {
         return binaryMissing('hermes', ctx, 'Set HERMES_HOME or put the `hermes` binary on PATH; or pass --via stdin / --via echo.');
     }
+    const verb = await detectVerb(bin);
+    if (!verb) {
+        return {
+            stdout: '',
+            stderr: `hermes adapter: this Hermes install does not expose any subcommand AgentSpeak knows how to drive ` +
+                `(tried: ${KNOWN_VERBS.join(', ')}). Run \`hermes --help\` to see the actual subcommand list, ` +
+                `then pass --via stdin and pipe the prompt yourself, or open an issue at ` +
+                `https://github.com/PhilipAD/agentspeak/issues with your hermes --help output.`,
+            exitCode: 127,
+            durationMs: Date.now() - start,
+            timedOut: false,
+        };
+    }
     return shellOut({
         bin,
-        args: ['prompt'],
+        args: [verb],
         promptStdin: renderPromptFromEnvelope(ctx.envelope),
         timeoutMs: ctx.timeoutMs,
     });
 };
+export async function hermesProbe() {
+    const bin = locateBinary();
+    if (!bin) {
+        return {
+            ok: false,
+            detail: 'hermes binary not found on PATH and HERMES_HOME unset. ' +
+                'Install hermes-cli or pass --via stdin / --via echo.',
+        };
+    }
+    const verb = await detectVerb(bin);
+    if (!verb) {
+        return {
+            ok: false,
+            detail: `hermes is installed at ${bin} but its --help output does not advertise any of the ` +
+                `subcommands AgentSpeak knows how to drive (${KNOWN_VERBS.join(', ')}). ` +
+                `Switch to --via stdin or pipe through your own --exec shim.`,
+        };
+    }
+    return { ok: true, detail: `found hermes at ${bin}; will use \`hermes ${verb}\` per turn.` };
+}
 function ok(body, start) {
     return { stdout: body, stderr: '', exitCode: 0, durationMs: Date.now() - start, timedOut: false };
 }
+/** Test-only: clear the cached verb between unit tests. */
+export function __resetCachedVerb() {
+    cachedVerb = null;
+}
 //# sourceMappingURL=hermes.js.map

package/dist/adapters/hermes.js.map

@@ -1 +1 @@
-{"version":3,"file":"hermes.js","sourceRoot":"","sources":["../../src/adapters/hermes.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,wBAAwB,EAAE,MAAM,YAAY,CAAC;AAEtD,OAAO,EAAE,aAAa,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAC;AAEnE;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,aAAa,GAAY,KAAK,EAAE,GAAG,EAAE,EAAE;IAClD,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IACzB,IAAI,GAAG,CAAC,SAAS,EAAE,CAAC;QAClB,OAAO,EAAE,CAAC,YAAY,EAAE,KAAK,CAAC,CAAC;IACjC,CAAC;IACD,IAAI,GAAG,GAAG,KAAK,CAAC,QAAQ,CAAC,CAAC;IAC1B,IAAI,CAAC,GAAG,IAAI,OAAO,CAAC,GAAG,CAAC,WAAW,EAAE,CAAC;QACpC,MAAM,SAAS,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,WAAW,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,aAAa,CAAC;QAC7E,GAAG,GAAG,SAAS,CAAC;IAClB,CAAC;IACD,IAAI,CAAC,GAAG,EAAE,CAAC;QACT,OAAO,aAAa,CAClB,QAAQ,EACR,GAAG,EACH,uFAAuF,CACxF,CAAC;IACJ,CAAC;IACD,OAAO,QAAQ,CAAC;QACd,GAAG;QACH,IAAI,EAAE,CAAC,QAAQ,CAAC;QAChB,WAAW,EAAE,wBAAwB,CAAC,GAAG,CAAC,QAAQ,CAAC;QACnD,SAAS,EAAE,GAAG,CAAC,SAAS;KACzB,CAAC,CAAC;AACL,CAAC,CAAC;AAEF,SAAS,EAAE,CAAC,IAAY,EAAE,KAAa;IACrC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,QAAQ,EAAE,CAAC,EAAE,UAAU,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC;AACpG,CAAC"}
+{"version":3,"file":"hermes.js","sourceRoot":"","sources":["../../src/adapters/hermes.ts"],"names":[],"mappings":"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"}

package/dist/adapters/index.d.ts

@@ -44,6 +44,11 @@ export interface AdapterResult {
     timedOut: boolean;
 }
 export type Adapter = (ctx: AdapterCtx) => Promise<AdapterResult>;
+export interface ProbeResult {
+    ok: boolean;
+    /** Human-readable explanation: "found hermes at /usr/bin/hermes; will use `hermes chat`". */
+    detail: string;
+}
 export interface AdapterDescriptor {
     name: string;
     summary: string;
@@ -54,6 +59,15 @@ export interface AdapterDescriptor {
      */
     requiresBinary?: string;
     adapter: Adapter;
+    /**
+     * Optional pre-attach probe. Called by cmdRun's smoke-test gate INSTEAD
+     * of running the adapter with `smokeTest=true`. Adapters that shell out
+     * to a third-party binary (hermes/openclaw/claude/cursor-agent) MUST
+     * implement this so the pre-attach gate verifies the right subcommand
+     * actually exists — preventing the "smoke OK, every real turn fails"
+     * trap.
+     */
+    probe?: () => Promise<ProbeResult>;
 }
 export declare const ADAPTERS: Record<string, AdapterDescriptor>;
 export declare function resolveAdapter(name: string): AdapterDescriptor;

package/dist/adapters/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/adapters/index.ts"],"names":[],"mappings":"AAOA;;;;;;;;;;;;;;;;GAgBG;AAEH,MAAM,WAAW,gBAAgB;IAC/B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,aAAa,CAAC,EAAE,OAAO,EAAE,CAAC;IAC1B,UAAU,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,OAAO,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACjF,CAAC,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;CACtB;AAED,MAAM,WAAW,UAAU;IACzB,QAAQ,EAAE,gBAAgB,CAAC;IAC3B,8EAA8E;IAC9E,SAAS,EAAE,OAAO,CAAC;IACnB,yEAAyE;IACzE,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,MAAM,OAAO,GAAG,CAAC,GAAG,EAAE,UAAU,KAAK,OAAO,CAAC,aAAa,CAAC,CAAC;AAElE,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB;;;;OAIG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,OAAO,EAAE,OAAO,CAAC;CAClB;AAED,eAAO,MAAM,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,iBAAiB,CAuCtD,CAAC;AAEF,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,iBAAiB,CAQ9D;AAED,wBAAgB,gBAAgB,IAAI,MAAM,EAAE,CAE3C;AAED,wBAAgB,gBAAgB,IAAI,MAAM,CAOzC;AAED;;;;;GAKG;AACH,wBAAgB,wBAAwB,CAAC,GAAG,EAAE,gBAAgB,GAAG,MAAM,CAoCtE"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/adapters/index.ts"],"names":[],"mappings":"AAOA;;;;;;;;;;;;;;;;GAgBG;AAEH,MAAM,WAAW,gBAAgB;IAC/B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,aAAa,CAAC,EAAE,OAAO,EAAE,CAAC;IAC1B,UAAU,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,OAAO,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACjF,CAAC,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;CACtB;AAED,MAAM,WAAW,UAAU;IACzB,QAAQ,EAAE,gBAAgB,CAAC;IAC3B,8EAA8E;IAC9E,SAAS,EAAE,OAAO,CAAC;IACnB,yEAAyE;IACzE,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,MAAM,OAAO,GAAG,CAAC,GAAG,EAAE,UAAU,KAAK,OAAO,CAAC,aAAa,CAAC,CAAC;AAElE,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,OAAO,CAAC;IACZ,6FAA6F;IAC7F,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB;;;;OAIG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,OAAO,EAAE,OAAO,CAAC;IACjB;;;;;;;OAOG;IACH,KAAK,CAAC,EAAE,MAAM,OAAO,CAAC,WAAW,CAAC,CAAC;CACpC;AAED,eAAO,MAAM,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,iBAAiB,CA6CtD,CAAC;AAEF,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,iBAAiB,CAQ9D;AAED,wBAAgB,gBAAgB,IAAI,MAAM,EAAE,CAE3C;AAED,wBAAgB,gBAAgB,IAAI,MAAM,CAOzC;AAED;;;;;GAKG;AACH,wBAAgB,wBAAwB,CAAC,GAAG,EAAE,gBAAgB,GAAG,MAAM,CAoCtE"}

package/dist/adapters/index.js

@@ -1,9 +1,9 @@
 import { echoAdapter } from './echo.js';
 import { stdinAdapter } from './stdin.js';
-import { claudeAdapter } from './claude.js';
-import { cursorAgentAdapter } from './cursor-agent.js';
-import { hermesAdapter } from './hermes.js';
-import { openclawAdapter } from './openclaw.js';
+import { claudeAdapter, claudeProbe } from './claude.js';
+import { cursorAgentAdapter, cursorAgentProbe } from './cursor-agent.js';
+import { hermesAdapter, hermesProbe } from './hermes.js';
+import { openclawAdapter, openclawProbe } from './openclaw.js';
 export const ADAPTERS = {
     echo: {
         name: 'echo',
@@ -21,24 +21,30 @@ export const ADAPTERS = {
         summary: 'Exec `claude -p` (Anthropic Claude Code CLI). Requires the `claude` binary on PATH.',
         requiresBinary: 'claude',
         adapter: claudeAdapter,
+        probe: claudeProbe,
     },
     'cursor-agent': {
         name: 'cursor-agent',
         summary: 'Exec `cursor-agent --print`. Requires the `cursor-agent` binary on PATH.',
         requiresBinary: 'cursor-agent',
         adapter: cursorAgentAdapter,
+        probe: cursorAgentProbe,
     },
     hermes: {
         name: 'hermes',
-        summary: 'Exec `hermes prompt` (Hermes runtime CLI). Requires `hermes` on PATH or HERMES_HOME set.',
+        summary: 'Exec `hermes <chat|prompt|reply>` (Hermes runtime CLI; verb auto-detected from --help). ' +
+            'Requires `hermes` on PATH or HERMES_HOME set.',
         requiresBinary: 'hermes',
         adapter: hermesAdapter,
+        probe: hermesProbe,
     },
     openclaw: {
         name: 'openclaw',
-        summary: 'Exec `openclaw prompt` (OpenClaw runtime CLI). Requires `openclaw` on PATH or OPENCLAW_HOME set.',
+        summary: 'Exec `openclaw <chat|run|prompt>` (OpenClaw runtime CLI; verb auto-detected from --help). ' +
+            'Requires `openclaw` on PATH or OPENCLAW_HOME set.',
         requiresBinary: 'openclaw',
         adapter: openclawAdapter,
+        probe: openclawProbe,
     },
 };
 export function resolveAdapter(name) {

package/dist/adapters/index.js.map

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

package/dist/adapters/openclaw.d.ts

@@ -1,10 +1,6 @@
-import type { Adapter } from './index.js';
-/**
- * `--via openclaw` — OpenClaw runtime CLI bridge.
- *
- * Invocation: `openclaw prompt` reads the prompt on stdin and prints the
- * agent's reply. Falls back to `$OPENCLAW_HOME/bin/openclaw` when the
- * binary is not on PATH (mirrors the hermes adapter).
- */
+import type { Adapter, ProbeResult } from './index.js';
 export declare const openclawAdapter: Adapter;
+export declare function openclawProbe(): Promise<ProbeResult>;
+/** Test-only: clear the cached verb between unit tests. */
+export declare function __resetCachedVerb(): void;
 //# sourceMappingURL=openclaw.d.ts.map

package/dist/adapters/openclaw.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"openclaw.d.ts","sourceRoot":"","sources":["../../src/adapters/openclaw.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAAiB,MAAM,YAAY,CAAC;AAGzD;;;;;;GAMG;AACH,eAAO,MAAM,eAAe,EAAE,OAsB7B,CAAC"}
+{"version":3,"file":"openclaw.d.ts","sourceRoot":"","sources":["../../src/adapters/openclaw.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAAiB,WAAW,EAAE,MAAM,YAAY,CAAC;AA4BtE,eAAO,MAAM,eAAe,EAAE,OAgC7B,CAAC;AAEF,wBAAsB,aAAa,IAAI,OAAO,CAAC,WAAW,CAAC,CAqB1D;AAMD,2DAA2D;AAC3D,wBAAgB,iBAAiB,IAAI,IAAI,CAExC"}

package/dist/adapters/openclaw.js

@@ -1,32 +1,81 @@
 import { renderPromptFromEnvelope } from './index.js';
-import { binaryMissing, shellOut, which } from './shell-helper.js';
+import { binaryMissing, pickSubcommand, probeHelp, shellOut, which } from './shell-helper.js';
 /**
  * `--via openclaw` — OpenClaw runtime CLI bridge.
  *
- * Invocation: `openclaw prompt` reads the prompt on stdin and prints the
- * agent's reply. Falls back to `$OPENCLAW_HOME/bin/openclaw` when the
- * binary is not on PATH (mirrors the hermes adapter).
+ * Like hermes, OpenClaw's exact subcommand verb varies by version
+ * (`run`, `chat`, `prompt`, ...). Probe `--help` once on attach and pick
+ * the first match, so a future rename does not silently break.
  */
+const KNOWN_VERBS = ['chat', 'run', 'prompt', 'reply', 'message'];
+let cachedVerb = null;
+function locateBinary() {
+    let bin = which('openclaw');
+    if (!bin && process.env.OPENCLAW_HOME) {
+        bin = `${process.env.OPENCLAW_HOME.replace(/\/$/, '')}/bin/openclaw`;
+    }
+    return bin;
+}
+async function detectVerb(bin) {
+    if (cachedVerb)
+        return cachedVerb;
+    const help = await probeHelp(bin);
+    cachedVerb = pickSubcommand(help, KNOWN_VERBS);
+    return cachedVerb;
+}
 export const openclawAdapter = async (ctx) => {
     const start = Date.now();
     if (ctx.smokeTest) {
         return ok('[smoke ok]', start);
     }
-    let bin = which('openclaw');
-    if (!bin && process.env.OPENCLAW_HOME) {
-        bin = `${process.env.OPENCLAW_HOME.replace(/\/$/, '')}/bin/openclaw`;
-    }
+    const bin = locateBinary();
     if (!bin) {
         return binaryMissing('openclaw', ctx, 'Set OPENCLAW_HOME or put the `openclaw` binary on PATH; or pass --via stdin / --via echo.');
     }
+    const verb = await detectVerb(bin);
+    if (!verb) {
+        return {
+            stdout: '',
+            stderr: `openclaw adapter: this OpenClaw install does not expose any subcommand AgentSpeak knows how to drive ` +
+                `(tried: ${KNOWN_VERBS.join(', ')}). Run \`openclaw --help\` to see the actual subcommand list, ` +
+                `then pass --via stdin and pipe the prompt yourself.`,
+            exitCode: 127,
+            durationMs: Date.now() - start,
+            timedOut: false,
+        };
+    }
     return shellOut({
         bin,
-        args: ['prompt'],
+        args: [verb],
         promptStdin: renderPromptFromEnvelope(ctx.envelope),
         timeoutMs: ctx.timeoutMs,
     });
 };
+export async function openclawProbe() {
+    const bin = locateBinary();
+    if (!bin) {
+        return {
+            ok: false,
+            detail: 'openclaw binary not found on PATH and OPENCLAW_HOME unset. ' +
+                'Install openclaw-cli or pass --via stdin / --via echo.',
+        };
+    }
+    const verb = await detectVerb(bin);
+    if (!verb) {
+        return {
+            ok: false,
+            detail: `openclaw is installed at ${bin} but its --help output does not advertise any of the ` +
+                `subcommands AgentSpeak knows how to drive (${KNOWN_VERBS.join(', ')}). ` +
+                `Switch to --via stdin or pipe through your own --exec shim.`,
+        };
+    }
+    return { ok: true, detail: `found openclaw at ${bin}; will use \`openclaw ${verb}\` per turn.` };
+}
 function ok(body, start) {
     return { stdout: body, stderr: '', exitCode: 0, durationMs: Date.now() - start, timedOut: false };
 }
+/** Test-only: clear the cached verb between unit tests. */
+export function __resetCachedVerb() {
+    cachedVerb = null;
+}
 //# sourceMappingURL=openclaw.js.map

package/dist/adapters/openclaw.js.map

@@ -1 +1 @@
-{"version":3,"file":"openclaw.js","sourceRoot":"","sources":["../../src/adapters/openclaw.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,wBAAwB,EAAE,MAAM,YAAY,CAAC;AAEtD,OAAO,EAAE,aAAa,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAC;AAEnE;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,eAAe,GAAY,KAAK,EAAE,GAAG,EAAE,EAAE;IACpD,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IACzB,IAAI,GAAG,CAAC,SAAS,EAAE,CAAC;QAClB,OAAO,EAAE,CAAC,YAAY,EAAE,KAAK,CAAC,CAAC;IACjC,CAAC;IACD,IAAI,GAAG,GAAG,KAAK,CAAC,UAAU,CAAC,CAAC;IAC5B,IAAI,CAAC,GAAG,IAAI,OAAO,CAAC,GAAG,CAAC,aAAa,EAAE,CAAC;QACtC,GAAG,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,aAAa,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,eAAe,CAAC;IACvE,CAAC;IACD,IAAI,CAAC,GAAG,EAAE,CAAC;QACT,OAAO,aAAa,CAClB,UAAU,EACV,GAAG,EACH,2FAA2F,CAC5F,CAAC;IACJ,CAAC;IACD,OAAO,QAAQ,CAAC;QACd,GAAG;QACH,IAAI,EAAE,CAAC,QAAQ,CAAC;QAChB,WAAW,EAAE,wBAAwB,CAAC,GAAG,CAAC,QAAQ,CAAC;QACnD,SAAS,EAAE,GAAG,CAAC,SAAS;KACzB,CAAC,CAAC;AACL,CAAC,CAAC;AAEF,SAAS,EAAE,CAAC,IAAY,EAAE,KAAa;IACrC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,QAAQ,EAAE,CAAC,EAAE,UAAU,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC;AACpG,CAAC"}
+{"version":3,"file":"openclaw.js","sourceRoot":"","sources":["../../src/adapters/openclaw.ts"],"names":[],"mappings":"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"}

package/dist/adapters/shell-helper.d.ts

@@ -23,6 +23,22 @@ export interface ShellOutOpts {
  * error capture stay identical.
  */
 export declare function shellOut(opts: ShellOutOpts): Promise<AdapterResult>;
+/**
+ * Run a binary with `--help` and return its captured stdout+stderr.
+ * Used by built-in adapters to discover the real subcommand verb on the
+ * installed runtime instead of assuming a hard-coded one. Hermes ships
+ * `chat` (no `prompt`); OpenClaw ships `run`, etc. Probing once on
+ * attach prevents the "looks fine in smoke test, fails on every real
+ * turn" failure mode that burned Yaow's invite on inv_fIs8aYZYBw9FVMI9CRBJ1Q.
+ */
+export declare function probeHelp(bin: string, timeoutMs?: number): Promise<string>;
+/**
+ * Pick the first subcommand from `candidates` that appears in the
+ * binary's `--help` output. Returns null if none match — the caller
+ * should surface a clear "this runtime does not expose any of the
+ * subcommands AgentSpeak knows how to drive" error.
+ */
+export declare function pickSubcommand(help: string, candidates: readonly string[]): string | null;
 /**
  * Standardised "binary not found" failure surfaced by every shell-out
  * adapter so the smoke test's [SHIM-FAIL] hint can recommend the right

package/dist/adapters/shell-helper.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"shell-helper.d.ts","sourceRoot":"","sources":["../../src/adapters/shell-helper.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAE5D;;;;;GAKG;AACH,wBAAgB,KAAK,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAehD;AAED,MAAM,WAAW,YAAY;IAC3B,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,wCAAwC;IACxC,WAAW,EAAE,MAAM,CAAC;IACpB,yBAAyB;IACzB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,8CAA8C;IAC9C,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC9B;AAED;;;;;GAKG;AACH,wBAAsB,QAAQ,CAAC,IAAI,EAAE,YAAY,GAAG,OAAO,CAAC,aAAa,CAAC,CA6CzE;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,UAAU,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,aAAa,CAYzF"}
+{"version":3,"file":"shell-helper.d.ts","sourceRoot":"","sources":["../../src/adapters/shell-helper.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAE5D;;;;;GAKG;AACH,wBAAgB,KAAK,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAehD;AAED,MAAM,WAAW,YAAY;IAC3B,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,wCAAwC;IACxC,WAAW,EAAE,MAAM,CAAC;IACpB,yBAAyB;IACzB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,8CAA8C;IAC9C,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC9B;AAED;;;;;GAKG;AACH,wBAAsB,QAAQ,CAAC,IAAI,EAAE,YAAY,GAAG,OAAO,CAAC,aAAa,CAAC,CA6CzE;AAED;;;;;;;GAOG;AACH,wBAAsB,SAAS,CAAC,GAAG,EAAE,MAAM,EAAE,SAAS,SAAO,GAAG,OAAO,CAAC,MAAM,CAAC,CAwB9E;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,SAAS,MAAM,EAAE,GAAG,MAAM,GAAG,IAAI,CAMzF;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,UAAU,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,aAAa,CAYzF"}

package/dist/adapters/shell-helper.js

@@ -79,6 +79,54 @@ export async function shellOut(opts) {
         clearTimeout(timer);
     return { stdout, stderr, exitCode, durationMs: Date.now() - start, timedOut };
 }
+/**
+ * Run a binary with `--help` and return its captured stdout+stderr.
+ * Used by built-in adapters to discover the real subcommand verb on the
+ * installed runtime instead of assuming a hard-coded one. Hermes ships
+ * `chat` (no `prompt`); OpenClaw ships `run`, etc. Probing once on
+ * attach prevents the "looks fine in smoke test, fails on every real
+ * turn" failure mode that burned Yaow's invite on inv_fIs8aYZYBw9FVMI9CRBJ1Q.
+ */
+export async function probeHelp(bin, timeoutMs = 5000) {
+    const start = Date.now();
+    const proc = spawn(bin, ['--help'], { stdio: ['ignore', 'pipe', 'pipe'] });
+    let buf = '';
+    proc.stdout.on('data', (c) => {
+        buf += c.toString('utf8');
+    });
+    proc.stderr.on('data', (c) => {
+        buf += c.toString('utf8');
+    });
+    const timer = setTimeout(() => {
+        try {
+            proc.kill('SIGKILL');
+        }
+        catch {
+            // ignore
+        }
+    }, timeoutMs);
+    await new Promise((resolve) => {
+        proc.on('exit', () => resolve());
+        proc.on('error', () => resolve());
+    });
+    clearTimeout(timer);
+    void start;
+    return buf;
+}
+/**
+ * Pick the first subcommand from `candidates` that appears in the
+ * binary's `--help` output. Returns null if none match — the caller
+ * should surface a clear "this runtime does not expose any of the
+ * subcommands AgentSpeak knows how to drive" error.
+ */
+export function pickSubcommand(help, candidates) {
+    for (const c of candidates) {
+        const re = new RegExp(`(?:^|[\\s,'"\\(\\|\\[])${c}(?=[\\s,'"\\)\\|\\]]|$)`, 'm');
+        if (re.test(help))
+            return c;
+    }
+    return null;
+}
 /**
  * Standardised "binary not found" failure surfaced by every shell-out
  * adapter so the smoke test's [SHIM-FAIL] hint can recommend the right

package/dist/adapters/shell-helper.js.map

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

package/dist/auto-shim.d.ts

@@ -35,4 +35,23 @@ export declare function autoShimPaths(): {
 export declare function writeAutoShim(opts?: {
     force?: boolean;
 }): AutoShimResult;
+/**
+ * Hardened reply shim. Lines marked with `# EDIT ME` are the only
+ * places the operator should change to wire in their LLM client. The
+ * smoke-test short-circuit MUST stay above the EDIT ME block so the
+ * cmdRun pre-attach gate continues to pass even with a half-written
+ * customisation.
+ */
+/**
+ * After this many DEFAULT (unedited) replies, the auto-shim self-quits
+ * the meeting with `signal=done`. This is the fix for Ernesto's
+ * similarity-loop trap (meet_qgCvGEsNjmUiY0hUwR9F6w): an unedited
+ * auto-shim repeatedly emitted "[ack] turn N" content which the
+ * coordinator's similarity detector quickly flagged as a recap-worthy
+ * loop. Self-quitting on turn 3 means a user who hasn't wired in their
+ * LLM yet still leaves the meeting in a clean `completed` state with
+ * an explanatory final turn, instead of triggering a recap and
+ * stalling everyone else.
+ */
+export declare const AUTO_SHIM_SELF_QUIT_AFTER = 3;
 //# sourceMappingURL=auto-shim.d.ts.map

package/dist/auto-shim.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"auto-shim.d.ts","sourceRoot":"","sources":["../src/auto-shim.ts"],"names":[],"mappings":"AAIA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,MAAM,WAAW,cAAc;IAC7B,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,OAAO,CAAC;CACjB;AAED,wBAAgB,aAAa,IAAI;IAAE,SAAS,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAMtE;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,IAAI,GAAE;IAAE,KAAK,CAAC,EAAE,OAAO,CAAA;CAAO,GAAG,cAAc,CA4B5E"}
+{"version":3,"file":"auto-shim.d.ts","sourceRoot":"","sources":["../src/auto-shim.ts"],"names":[],"mappings":"AAIA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,MAAM,WAAW,cAAc;IAC7B,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,OAAO,CAAC;CACjB;AAED,wBAAgB,aAAa,IAAI;IAAE,SAAS,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAMtE;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,IAAI,GAAE;IAAE,KAAK,CAAC,EAAE,OAAO,CAAA;CAAO,GAAG,cAAc,CA4B5E;AAED;;;;;;GAMG;AACH;;;;;;;;;;GAUG;AACH,eAAO,MAAM,yBAAyB,IAAI,CAAC"}