opencode-swarm 7.188.5 → 7.188.7

package/dist/cli/{server-zb4j57w6.js → server-vrk0k61v.js}

@@ -22,34 +22,34 @@ import {
   resolveWriteTargets,
   searchKnowledge,
   symbols
-} from "./index-4m7cywkf.js";
+} from "./index-emh69vk9.js";
 import {
   checkFileAuthority,
   checkWriteTargetForSymlink
-} from "./index-w5p9crxx.js";
-import"./index-cjekszvy.js";
+} from "./index-7k9hdn0b.js";
+import"./index-g39cmzpj.js";
 import {
   _internals,
   saveEvidence
-} from "./index-1kd2cbcz.js";
+} from "./index-y8z9x87e.js";
 import {
   getProfileForFile
 } from "./index-vx8a8w3b.js";
 import {
   pLimit
-} from "./index-jc2ndtdt.js";
-import"./index-z11watrb.js";
+} from "./index-k8sarme1.js";
+import"./index-8xabhfwr.js";
 import"./index-txdagbh7.js";
 import {
   resolveCohortId
-} from "./index-f1wqew85.js";
+} from "./index-snwj9ptc.js";
 import"./index-rdec0y3z.js";
-import"./index-3jn6155r.js";
-import"./index-ar33mkxc.js";
-import"./index-4ak3ewt2.js";
-import"./index-n7vy4gb3.js";
+import"./index-pnfd3s7s.js";
+import"./index-rw0c6qtt.js";
+import"./index-c937rpbm.js";
+import"./index-xsdphmet.js";
 import"./index-kaqdzhj3.js";
-import"./index-ykaaejka.js";
+import"./index-9czp2dcg.js";
 import"./index-cjapb4hy.js";
 import"./index-f6exny9m.js";
 import {
@@ -59,11 +59,11 @@ import {
 import"./index-q7sjgr1y.js";
 import {
   createSwarmTool
-} from "./index-85npnq5t.js";
+} from "./index-a4s5yrdd.js";
 import {
   loadPlan,
   loadPlanJsonOnly
-} from "./index-03ng9y76.js";
+} from "./index-7zyktm9f.js";
 import {
   containsControlChars,
   createTargetWithinRootValidator,
@@ -73,15 +73,15 @@ import {
   validateWorkspaceRoot
 } from "./index-6b295cas.js";
 import"./index-9nyqt3kb.js";
-import"./index-vn8phy76.js";
+import"./index-2wctq2hn.js";
 import"./index-zsrtt42s.js";
-import"./index-fbwerevq.js";
-import"./index-8f0j6kf2.js";
-import"./index-1tgkj4mf.js";
+import"./index-yj1cwps4.js";
+import"./index-8sqyx5rh.js";
+import"./index-xj3k6x1h.js";
 import"./index-g4fs6z4e.js";
-import"./index-0cdkb7e8.js";
-import"./index-p746x44z.js";
-import"./index-98zfmfnn.js";
+import"./index-7eajwwfg.js";
+import"./index-kap459mr.js";
+import"./index-61kszszd.js";
 import"./index-m9zzj4ee.js";
 import"./index-7hr5m7yp.js";
 import"./index-2s7dvzff.js";
@@ -90,26 +90,26 @@ import {
   validateActionability,
   validateActionableFields,
   validateLesson
-} from "./index-bjh6cw86.js";
+} from "./index-m9g7s9ee.js";
 import {
   resolveWorktreeId
-} from "./index-hq7mfqe5.js";
+} from "./index-q9kefh33.js";
 import"./index-rtry5xyf.js";
-import"./index-br33a6v7.js";
+import"./index-5102w44y.js";
 import"./index-kbkk7vnh.js";
 import"./index-0725jpp7.js";
 import {
   normalizeScopeFiles
-} from "./index-vktygb4k.js";
-import"./index-dmnvgc03.js";
-import"./index-dmdg2zay.js";
+} from "./index-y3sk68m5.js";
+import"./index-ytms8x1h.js";
+import"./index-wrdktgpy.js";
 import"./index-x1eh2636.js";
 import"./index-ntda6tje.js";
 import"./index-9tvjwv01.js";
 import"./index-ry16d01s.js";
 import"./index-rdm3px0g.js";
 import"./index-7pmbnjvj.js";
-import"./index-j9swvmt3.js";
+import"./index-1xa8wq76.js";
 import {
   computeContentHash,
   dedupeCapped,
@@ -119,14 +119,14 @@ import {
   reinforceSwarmKnowledgeEntry,
   resolveSwarmKnowledgePath,
   transactKnowledge
-} from "./index-d95b3yce.js";
+} from "./index-c016phsk.js";
 import"./index-vzm6zre7.js";
 import"./index-ae75rja9.js";
-import"./index-wx43mc8h.js";
-import"./index-5nwfz9bn.js";
-import"./index-4zran0jk.js";
+import"./index-8q8783g0.js";
+import"./index-hh7pa3yk.js";
+import"./index-twb3f4tk.js";
 import"./index-t7hmqgjy.js";
-import"./index-h83221w1.js";
+import"./index-d3rjvm9e.js";
 import {
   canonicalRootKeyFresh,
   escapeRegex
@@ -143,7 +143,7 @@ import"./index-gx2vp8gx.js";
 import {
   loadGateOverrides,
   loadPluginConfigWithMeta
-} from "./index-9qbn3chx.js";
+} from "./index-9tes309n.js";
 import {
   init_git_executable,
   resolveGitExecutableAsync
@@ -151,11 +151,11 @@ import {
 import {
   KnowledgeConfigSchema,
   init_schema
-} from "./index-jevq7a7b.js";
+} from "./index-ghjg1rxe.js";
 import {
   TOOL_METADATA,
   init_tool_metadata
-} from "./index-bstjg81q.js";
+} from "./index-zfbxfm2m.js";
 import {
   KNOWLEDGE_SCHEMA_VERSION,
   init_knowledge_types

package/dist/cli/{skill-generator-fqh79jr7.js → skill-generator-bfcjzp20.js}

@@ -33,37 +33,37 @@ import {
   sanitizeSlug,
   selectCandidateEntries,
   writeEvalStub
-} from "./index-4ak3ewt2.js";
+} from "./index-c937rpbm.js";
 import"./index-q7sjgr1y.js";
-import"./index-p746x44z.js";
-import"./index-98zfmfnn.js";
+import"./index-kap459mr.js";
+import"./index-61kszszd.js";
 import"./index-m9zzj4ee.js";
 import"./index-7hr5m7yp.js";
 import"./index-2s7dvzff.js";
-import"./index-bjh6cw86.js";
-import"./index-hq7mfqe5.js";
+import"./index-m9g7s9ee.js";
+import"./index-q9kefh33.js";
 import"./index-rtry5xyf.js";
-import"./index-br33a6v7.js";
+import"./index-5102w44y.js";
 import"./index-kbkk7vnh.js";
 import"./index-0725jpp7.js";
-import"./index-j9swvmt3.js";
-import"./index-d95b3yce.js";
+import"./index-1xa8wq76.js";
+import"./index-c016phsk.js";
 import"./index-vzm6zre7.js";
 import"./index-ae75rja9.js";
-import"./index-wx43mc8h.js";
-import"./index-5nwfz9bn.js";
-import"./index-4zran0jk.js";
+import"./index-8q8783g0.js";
+import"./index-hh7pa3yk.js";
+import"./index-twb3f4tk.js";
 import"./index-t7hmqgjy.js";
-import"./index-h83221w1.js";
+import"./index-d3rjvm9e.js";
 import"./index-fzpt2djt.js";
 import"./index-ejhxgyvm.js";
 import"./index-7g4c7s5r.js";
 import"./index-p2tqzwh6.js";
 import"./index-gx2vp8gx.js";
-import"./index-9qbn3chx.js";
+import"./index-9tes309n.js";
 import"./index-zxdawwc7.js";
-import"./index-jevq7a7b.js";
-import"./index-bstjg81q.js";
+import"./index-ghjg1rxe.js";
+import"./index-zfbxfm2m.js";
 import"./index-bk5tah7q.js";
 import"./index-gknz3bv1.js";
 import"./index-zpsr8rpc.js";

package/dist/cli/{snapshot-coordination-init-v50k6v2v.js → snapshot-coordination-init-8ykpp5m6.js}

@@ -8,75 +8,75 @@ import {
   markSnapshotCoordinationClosing,
   retrySnapshotCoordinationInitialization,
   startSnapshotCoordinationInitialization
-} from "./index-4m7cywkf.js";
-import"./index-w5p9crxx.js";
-import"./index-cjekszvy.js";
-import"./index-1kd2cbcz.js";
+} from "./index-emh69vk9.js";
+import"./index-7k9hdn0b.js";
+import"./index-g39cmzpj.js";
+import"./index-y8z9x87e.js";
 import"./index-vx8a8w3b.js";
-import"./index-jc2ndtdt.js";
-import"./index-z11watrb.js";
+import"./index-k8sarme1.js";
+import"./index-8xabhfwr.js";
 import"./index-txdagbh7.js";
-import"./index-f1wqew85.js";
+import"./index-snwj9ptc.js";
 import"./index-rdec0y3z.js";
-import"./index-3jn6155r.js";
-import"./index-ar33mkxc.js";
-import"./index-4ak3ewt2.js";
-import"./index-n7vy4gb3.js";
+import"./index-pnfd3s7s.js";
+import"./index-rw0c6qtt.js";
+import"./index-c937rpbm.js";
+import"./index-xsdphmet.js";
 import"./index-kaqdzhj3.js";
-import"./index-ykaaejka.js";
+import"./index-9czp2dcg.js";
 import"./index-cjapb4hy.js";
 import"./index-f6exny9m.js";
 import"./index-pt7h91zc.js";
 import"./index-q7sjgr1y.js";
-import"./index-85npnq5t.js";
-import"./index-03ng9y76.js";
+import"./index-a4s5yrdd.js";
+import"./index-7zyktm9f.js";
 import"./index-6b295cas.js";
 import"./index-9nyqt3kb.js";
-import"./index-vn8phy76.js";
+import"./index-2wctq2hn.js";
 import"./index-zsrtt42s.js";
-import"./index-fbwerevq.js";
-import"./index-8f0j6kf2.js";
-import"./index-1tgkj4mf.js";
+import"./index-yj1cwps4.js";
+import"./index-8sqyx5rh.js";
+import"./index-xj3k6x1h.js";
 import"./index-g4fs6z4e.js";
-import"./index-0cdkb7e8.js";
-import"./index-p746x44z.js";
-import"./index-98zfmfnn.js";
+import"./index-7eajwwfg.js";
+import"./index-kap459mr.js";
+import"./index-61kszszd.js";
 import"./index-m9zzj4ee.js";
 import"./index-7hr5m7yp.js";
 import"./index-2s7dvzff.js";
-import"./index-bjh6cw86.js";
-import"./index-hq7mfqe5.js";
+import"./index-m9g7s9ee.js";
+import"./index-q9kefh33.js";
 import"./index-rtry5xyf.js";
-import"./index-br33a6v7.js";
+import"./index-5102w44y.js";
 import"./index-kbkk7vnh.js";
 import"./index-0725jpp7.js";
-import"./index-vktygb4k.js";
-import"./index-dmnvgc03.js";
-import"./index-dmdg2zay.js";
+import"./index-y3sk68m5.js";
+import"./index-ytms8x1h.js";
+import"./index-wrdktgpy.js";
 import"./index-x1eh2636.js";
 import"./index-ntda6tje.js";
 import"./index-9tvjwv01.js";
 import"./index-ry16d01s.js";
 import"./index-rdm3px0g.js";
 import"./index-7pmbnjvj.js";
-import"./index-j9swvmt3.js";
-import"./index-d95b3yce.js";
+import"./index-1xa8wq76.js";
+import"./index-c016phsk.js";
 import"./index-vzm6zre7.js";
 import"./index-ae75rja9.js";
-import"./index-wx43mc8h.js";
-import"./index-5nwfz9bn.js";
-import"./index-4zran0jk.js";
+import"./index-8q8783g0.js";
+import"./index-hh7pa3yk.js";
+import"./index-twb3f4tk.js";
 import"./index-t7hmqgjy.js";
-import"./index-h83221w1.js";
+import"./index-d3rjvm9e.js";
 import"./index-fzpt2djt.js";
 import"./index-ejhxgyvm.js";
 import"./index-7g4c7s5r.js";
 import"./index-p2tqzwh6.js";
 import"./index-gx2vp8gx.js";
-import"./index-9qbn3chx.js";
+import"./index-9tes309n.js";
 import"./index-zxdawwc7.js";
-import"./index-jevq7a7b.js";
-import"./index-bstjg81q.js";
+import"./index-ghjg1rxe.js";
+import"./index-zfbxfm2m.js";
 import"./index-bk5tah7q.js";
 import"./index-gknz3bv1.js";
 import"./index-zpsr8rpc.js";

package/dist/cli/{speckit-checkoff-mcxxpmy4.js → speckit-checkoff-3x52vw64.js}

@@ -7,14 +7,14 @@ import {
   parseSpeckitTasksContent,
   propagateSpeckitCheckoff,
   writeSpeckitCheckoffLedger
-} from "./index-fbwerevq.js";
+} from "./index-yj1cwps4.js";
 import"./index-ejhxgyvm.js";
 import"./index-7g4c7s5r.js";
 import"./index-p2tqzwh6.js";
-import"./index-9qbn3chx.js";
+import"./index-9tes309n.js";
 import"./index-zxdawwc7.js";
-import"./index-jevq7a7b.js";
-import"./index-bstjg81q.js";
+import"./index-ghjg1rxe.js";
+import"./index-zfbxfm2m.js";
 import"./index-bk5tah7q.js";
 import"./index-gknz3bv1.js";
 import"./index-zpsr8rpc.js";

package/dist/cli/{telemetry-eq1cwq2x.js → telemetry-kvhe94gs.js}

@@ -14,7 +14,7 @@ import {
   startHeartbeatTracking,
   stopHeartbeatTracking,
   telemetry
-} from "./index-h83221w1.js";
+} from "./index-d3rjvm9e.js";
 import"./index-fzpt2djt.js";
 import"./index-gknz3bv1.js";
 import"./index-zpsr8rpc.js";

package/dist/cli/{worktree-collision-ownership-fk6spbrf.js → worktree-collision-ownership-kjw1pqfc.js}

@@ -13,7 +13,7 @@ import {
 import {
   scanDelegationFallbacksForRecovery,
   scanDelegationsForRecovery
-} from "./index-0cdkb7e8.js";
+} from "./index-7eajwwfg.js";
 import"./index-7hr5m7yp.js";
 import"./index-2s7dvzff.js";
 import"./index-x1eh2636.js";
@@ -22,15 +22,15 @@ import"./index-9tvjwv01.js";
 import"./index-ry16d01s.js";
 import"./index-rdm3px0g.js";
 import"./index-7pmbnjvj.js";
-import"./index-j9swvmt3.js";
-import"./index-d95b3yce.js";
+import"./index-1xa8wq76.js";
+import"./index-c016phsk.js";
 import"./index-vzm6zre7.js";
 import"./index-ae75rja9.js";
-import"./index-wx43mc8h.js";
-import"./index-5nwfz9bn.js";
-import"./index-4zran0jk.js";
+import"./index-8q8783g0.js";
+import"./index-hh7pa3yk.js";
+import"./index-twb3f4tk.js";
 import"./index-t7hmqgjy.js";
-import"./index-h83221w1.js";
+import"./index-d3rjvm9e.js";
 import {
   canonicalRootKeyFresh
 } from "./index-fzpt2djt.js";

package/dist/cli/{worktree-isolation-ht89tqrc.js → worktree-isolation-xdgm4ekx.js}

@@ -21,77 +21,77 @@ import {
   sanitizeWorktreeTaskId,
   standardWorktreeByCallID,
   standardWorktreeSerializationSessions
-} from "./index-4m7cywkf.js";
-import"./index-w5p9crxx.js";
-import"./index-cjekszvy.js";
-import"./index-1kd2cbcz.js";
+} from "./index-emh69vk9.js";
+import"./index-7k9hdn0b.js";
+import"./index-g39cmzpj.js";
+import"./index-y8z9x87e.js";
 import"./index-vx8a8w3b.js";
-import"./index-jc2ndtdt.js";
-import"./index-z11watrb.js";
+import"./index-k8sarme1.js";
+import"./index-8xabhfwr.js";
 import"./index-txdagbh7.js";
-import"./index-f1wqew85.js";
+import"./index-snwj9ptc.js";
 import"./index-rdec0y3z.js";
-import"./index-3jn6155r.js";
-import"./index-ar33mkxc.js";
-import"./index-4ak3ewt2.js";
-import"./index-n7vy4gb3.js";
+import"./index-pnfd3s7s.js";
+import"./index-rw0c6qtt.js";
+import"./index-c937rpbm.js";
+import"./index-xsdphmet.js";
 import"./index-kaqdzhj3.js";
-import"./index-ykaaejka.js";
+import"./index-9czp2dcg.js";
 import"./index-cjapb4hy.js";
 import"./index-f6exny9m.js";
 import"./index-pt7h91zc.js";
 import"./index-q7sjgr1y.js";
-import"./index-85npnq5t.js";
-import"./index-03ng9y76.js";
+import"./index-a4s5yrdd.js";
+import"./index-7zyktm9f.js";
 import"./index-6b295cas.js";
 import"./index-9nyqt3kb.js";
-import"./index-vn8phy76.js";
+import"./index-2wctq2hn.js";
 import"./index-zsrtt42s.js";
-import"./index-fbwerevq.js";
-import"./index-8f0j6kf2.js";
-import"./index-1tgkj4mf.js";
+import"./index-yj1cwps4.js";
+import"./index-8sqyx5rh.js";
+import"./index-xj3k6x1h.js";
 import"./index-g4fs6z4e.js";
-import"./index-0cdkb7e8.js";
-import"./index-p746x44z.js";
-import"./index-98zfmfnn.js";
+import"./index-7eajwwfg.js";
+import"./index-kap459mr.js";
+import"./index-61kszszd.js";
 import"./index-m9zzj4ee.js";
 import"./index-7hr5m7yp.js";
 import"./index-2s7dvzff.js";
-import"./index-bjh6cw86.js";
-import"./index-hq7mfqe5.js";
+import"./index-m9g7s9ee.js";
+import"./index-q9kefh33.js";
 import"./index-rtry5xyf.js";
 import {
   resolveWorktreeIsolationConfig
-} from "./index-br33a6v7.js";
+} from "./index-5102w44y.js";
 import"./index-kbkk7vnh.js";
 import"./index-0725jpp7.js";
-import"./index-vktygb4k.js";
-import"./index-dmnvgc03.js";
-import"./index-dmdg2zay.js";
+import"./index-y3sk68m5.js";
+import"./index-ytms8x1h.js";
+import"./index-wrdktgpy.js";
 import"./index-x1eh2636.js";
 import"./index-ntda6tje.js";
 import"./index-9tvjwv01.js";
 import"./index-ry16d01s.js";
 import"./index-rdm3px0g.js";
 import"./index-7pmbnjvj.js";
-import"./index-j9swvmt3.js";
-import"./index-d95b3yce.js";
+import"./index-1xa8wq76.js";
+import"./index-c016phsk.js";
 import"./index-vzm6zre7.js";
 import"./index-ae75rja9.js";
-import"./index-wx43mc8h.js";
-import"./index-5nwfz9bn.js";
-import"./index-4zran0jk.js";
+import"./index-8q8783g0.js";
+import"./index-hh7pa3yk.js";
+import"./index-twb3f4tk.js";
 import"./index-t7hmqgjy.js";
-import"./index-h83221w1.js";
+import"./index-d3rjvm9e.js";
 import"./index-fzpt2djt.js";
 import"./index-ejhxgyvm.js";
 import"./index-7g4c7s5r.js";
 import"./index-p2tqzwh6.js";
 import"./index-gx2vp8gx.js";
-import"./index-9qbn3chx.js";
+import"./index-9tes309n.js";
 import"./index-zxdawwc7.js";
-import"./index-jevq7a7b.js";
-import"./index-bstjg81q.js";
+import"./index-ghjg1rxe.js";
+import"./index-zfbxfm2m.js";
 import"./index-bk5tah7q.js";
 import"./index-gknz3bv1.js";
 import"./index-zpsr8rpc.js";

package/dist/config/consumers.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Config-consumption declaration (issue #2904) - the single source of truth for
+ * WHICH production code consumes each top-level `PluginConfigSchema` key.
+ *
+ * Every key MUST declare either `consumers` (repo-relative `path:symbol` citations,
+ * each verified by `bun run scripts/check-config-consumption.ts`) or `inert` (a
+ * reason string; `/swarm config doctor` then warns when a user's config file
+ * sets the key).
+ * Exhaustive by construction: `Record<TopLevelConfigKey, ...>` fails `bun run typecheck`
+ * the moment a schema key is added without an entry here.
+ *
+ * Citation rules (enforced by the gate):
+ *  - citations live in non-test `src/**`; `src/config/schema.ts` is never a consumer
+ *    (schema-definition is not consumption)
+ *  - a citation into `src/services/config-doctor.ts` never satisfies the ratchet alone
+ *    (that file references every key via its validateConfigKey cases); keys genuinely
+ *    owned by the doctor are enumerated in the gate's DOCTOR_FILE_EXEMPT
+ *  - DI/test seams (`_internals`, `_test_exports`) are never consumers
+ *  - a reference means member access, bracket access, destructure shorthand, or a
+ *    quoted case label - in code, not comments or string text (matcher details in
+ *    scripts/check-config-consumption.ts)
+ */
+import type { PluginConfigSchema } from './schema.js';
+export type TopLevelConfigKey = keyof typeof PluginConfigSchema.shape;
+/** `'src/path/to/file.ts:symbol'` - the symbol is a representative exported
+ * declaration in the cited file. The gate verifies the symbol is DECLARED in the
+ * file and that the FILE references the key (file-level reference; the symbol
+ * anchors the citation for human readers, it does not scope the search). */
+export type ConsumerCitation = string;
+export type ConfigConsumerDeclaration = {
+    consumers: ConsumerCitation[];
+} | {
+    inert: string;
+};
+export declare const CONFIG_CONSUMERS: Record<TopLevelConfigKey, ConfigConsumerDeclaration>;

package/dist/host/v2/events.d.ts

@@ -12,14 +12,22 @@
  *   ------------------------+-------------------------------------------
  *   session.idle            → { type: 'session.idle', properties }
  *   session.status.updated  → { type: 'session.idle', properties } (state watch)
+ *   session.status          → { type: 'session.status', properties } (type-preserving; #3022)
  *   session.text.delta      → { type: 'message.part.updated', properties }
  *   session.text.ended      → { type: 'message.updated', properties }
  *   session.tool.called     → { type: 'message.part.updated', properties }
  *   session.tool.success    → { type: 'message.updated', properties }
  *   session.tool.failed     → { type: 'message.updated', properties }
  *   session.execution.failed → { type: 'session.error', properties }
+ *   session.error           → { type: 'session.error', properties } (SDK dialect; #3022)
  *   session.deleted / session.created → same-name v1 types
  *
+ * Payload dialect (#3022 D3 live capture): plugin-stream envelopes carry the
+ * payload under `data` (live 2.0.21 emits `session.execution.failed` with
+ * `data:{sessionID, error:{...}}`); the @opencode-ai/sdk SSE/REST dialect
+ * carries it under `properties` with the error event named `session.error`.
+ * Both names and both payload keys are accepted.
+ *
  * Unmapped event types are counted in a bounded debug log, never silently
  * assumed. This module is named deferred-/startDeferred- per the C6 await
  * convention (its awaits live in deferred-named helpers).
@@ -32,7 +40,17 @@ interface MappedEvent {
 /** Map a v2 event envelope onto the v1 handler input (or undefined). */
 export declare function mapV2EventToV1(envelope: V2EventEnvelope): MappedEvent | undefined;
 /**
- * Start the detached event pump. Returns a stop function. Named per the C6
+ * Seed v1 session identity from identity-bearing v2 envelopes (issue #3022 D1).
+ *
+ * Live capture (d3/run2.log): `session.created` and `session.agent.selected`
+ * carry `data.agent`. This runs PUMP-SIDE (not as mapper case labels — those
+ * names are in neither the SDK union nor the mapper's legacy allowlist, and
+ * Branch B of the v1 session.error arm resolves identity through
+ * `recordSessionChatAgent`'s map, the same bounded store the v1 chat boundary
+ * writes). Fail-open by construction: non-string fields are ignored.
+ */
+export declare function seedSessionIdentityFromEnvelope(envelope: V2EventEnvelope): void;
+/** Start the detached event pump. Returns a stop function. Named per the C6
  * convention (deferred).
  */
 export declare function startDeferredEventPump(ctx: V2PluginContext, hooks: V1HooksSubset): () => void;

package/dist/host/v2/model-apply.d.ts

@@ -0,0 +1,39 @@
+/**
+ * v2 runtime agent-model application (issue #3022, AC3).
+ *
+ * The v1 fallback loop closes through `output.message.model` at the
+ * chat.message boundary — a surface the v2 SessionPrompt event does not carry
+ * (docs/host/v2-hook-inventory.md row 13). The v2-native equivalent is
+ * rewriting the agent's `model` reference through the host-provided
+ * `ctx.agent.transform` entry: the AgentDraft editor is callback-scoped
+ * (src/host/v2/agents-commands.ts registers through the same primitive), so
+ * the apply re-invokes the stored transform surface at advance time.
+ *
+ * KEYING CONTRACT (plan-critic round 2): the v2 AgentEditor is keyed by the
+ * EXACT REGISTERED agent name (multi-swarm configs register `local_coder`
+ * etc.), and `editor.update(id, fn)` is create-or-update — callers MUST pass
+ * the registration key (`routeModel.exactAgentName`), never the bare
+ * prefix-stripped role, or a phantom bare-name agent would be created.
+ *
+ * Everything here is fail-open: with no registered surface (v1 hosts, or a v2
+ * host without the agent domain) the apply is a logged no-op.
+ */
+import type { V2PluginContext } from './types';
+/**
+ * Remember the v2 agent transform surface for later model rewrites. Called
+ * once from setup after agent registration; cleared on cleanup.
+ */
+export declare function registerV2AgentTransformSurface(ctx: V2PluginContext): void;
+/**
+ * Drop the registered surface and dispose every held apply registration
+ * (v2 cleanup). Best-effort: disposal failure is logged, never thrown.
+ */
+export declare function clearV2AgentTransformSurface(): void;
+/** True when a v2 apply surface is registered (test/diagnostic seam). */
+export declare function hasV2AgentTransformSurface(): boolean;
+/**
+ * Rewrite one registered agent's model to `modelString` ('provider/model').
+ * Returns true when a surface existed and the transform completed within the
+ * budget; false (logged, non-fatal) otherwise. No-op on v1 hosts.
+ */
+export declare function applyV2AgentModelOverride(agentName: string, modelString: string): Promise<boolean>;