opencode-swarm 7.188.2 → 7.188.4

package/dist/cli/{skill-generator-ak2vxhqe.js → skill-generator-f2j1jnqf.js}

@@ -33,36 +33,36 @@ import {
   sanitizeSlug,
   selectCandidateEntries,
   writeEvalStub
-} from "./index-b02cdy5w.js";
+} from "./index-fm0yan3t.js";
 import"./index-q7sjgr1y.js";
-import"./index-yay1xxzk.js";
-import"./index-ea10gcja.js";
+import"./index-rqheyf9e.js";
+import"./index-wftdsx38.js";
 import"./index-m9zzj4ee.js";
-import"./index-bejxkee0.js";
+import"./index-4czf0es9.js";
 import"./index-2s7dvzff.js";
-import"./index-dwm3czmf.js";
-import"./index-rwabrcsg.js";
+import"./index-3034m1wv.js";
+import"./index-2ajapc0r.js";
 import"./index-rtry5xyf.js";
-import"./index-wxf5feq2.js";
+import"./index-j7pqzxyq.js";
 import"./index-kbkk7vnh.js";
 import"./index-0725jpp7.js";
-import"./index-mb1reyw3.js";
-import"./index-9b86vn97.js";
+import"./index-8tf5tewn.js";
+import"./index-bqqyxmpk.js";
 import"./index-vzm6zre7.js";
 import"./index-ae75rja9.js";
-import"./index-zwgh0gty.js";
-import"./index-7sbyvk99.js";
-import"./index-0v2svrev.js";
+import"./index-jkz10gm7.js";
+import"./index-gyhj562n.js";
+import"./index-4zran0jk.js";
 import"./index-t7hmqgjy.js";
-import"./index-4htcpbs4.js";
+import"./index-h83221w1.js";
 import"./index-fzpt2djt.js";
 import"./index-ejhxgyvm.js";
 import"./index-7g4c7s5r.js";
-import"./index-r6e8syr3.js";
+import"./index-1d51nz8d.js";
 import"./index-gx2vp8gx.js";
-import"./index-1466xg5c.js";
+import"./index-6kf62j82.js";
 import"./index-zxdawwc7.js";
-import"./index-9hsnarbv.js";
+import"./index-gmmz119k.js";
 import"./index-bstjg81q.js";
 import"./index-bk5tah7q.js";
 import"./index-gknz3bv1.js";

package/dist/cli/{snapshot-coordination-init-nwh6z0a6.js → snapshot-coordination-init-9gvgq52n.js}

@@ -8,74 +8,74 @@ import {
   markSnapshotCoordinationClosing,
   retrySnapshotCoordinationInitialization,
   startSnapshotCoordinationInitialization
-} from "./index-51dww7y9.js";
-import"./index-zyc869ys.js";
-import"./index-kxj8bqtj.js";
-import"./index-tr901ma3.js";
+} from "./index-94b58ssa.js";
+import"./index-yacpp9jq.js";
+import"./index-ntyc39rv.js";
+import"./index-tr6kaa6q.js";
 import"./index-vx8a8w3b.js";
-import"./index-x73e0zkb.js";
-import"./index-jd3hvnqn.js";
+import"./index-vx59q2ex.js";
+import"./index-75bm071p.js";
 import"./index-txdagbh7.js";
-import"./index-wb01w8ex.js";
+import"./index-4vgvybav.js";
 import"./index-rdec0y3z.js";
-import"./index-1hqybe51.js";
-import"./index-pz26qx3x.js";
-import"./index-b02cdy5w.js";
-import"./index-rn5hh7pp.js";
-import"./index-mf19yqss.js";
-import"./index-41v699sv.js";
+import"./index-6qtgyzw2.js";
+import"./index-sh7se0x5.js";
+import"./index-fm0yan3t.js";
+import"./index-8zs4v02d.js";
+import"./index-qwrx78m5.js";
+import"./index-d74wbpqc.js";
 import"./index-cjapb4hy.js";
-import"./index-a8gvszr2.js";
+import"./index-jc0jxg7y.js";
 import"./index-pt7h91zc.js";
 import"./index-q7sjgr1y.js";
-import"./index-x2p51ka9.js";
-import"./index-fq78x7th.js";
+import"./index-d3p96wkj.js";
+import"./index-p8kv9hh6.js";
 import"./index-6b295cas.js";
 import"./index-9nyqt3kb.js";
-import"./index-9wfjc4cn.js";
+import"./index-195msz9x.js";
 import"./index-zsrtt42s.js";
-import"./index-bf1meb32.js";
-import"./index-edf2eztc.js";
-import"./index-4e3qcwfb.js";
+import"./index-0yqa3awy.js";
+import"./index-1e4s8cyt.js";
+import"./index-6kckcdd7.js";
 import"./index-g4fs6z4e.js";
-import"./index-gd41qkx3.js";
-import"./index-yay1xxzk.js";
-import"./index-ea10gcja.js";
+import"./index-dka1ra21.js";
+import"./index-rqheyf9e.js";
+import"./index-wftdsx38.js";
 import"./index-m9zzj4ee.js";
-import"./index-bejxkee0.js";
+import"./index-4czf0es9.js";
 import"./index-2s7dvzff.js";
-import"./index-dwm3czmf.js";
-import"./index-rwabrcsg.js";
+import"./index-3034m1wv.js";
+import"./index-2ajapc0r.js";
 import"./index-rtry5xyf.js";
-import"./index-wxf5feq2.js";
+import"./index-j7pqzxyq.js";
 import"./index-kbkk7vnh.js";
 import"./index-0725jpp7.js";
-import"./index-0rzc71q8.js";
-import"./index-3dvzvhrp.js";
-import"./index-b9pz70d0.js";
-import"./index-m1qy7f1e.js";
-import"./index-cc1vzq4m.js";
-import"./index-9hag235h.js";
+import"./index-53me7h10.js";
+import"./index-yctaaj1k.js";
+import"./index-ge4hk20b.js";
+import"./index-103gsfn1.js";
+import"./index-v09x4k5h.js";
+import"./index-ww91zjzk.js";
 import"./index-ry16d01s.js";
 import"./index-rdm3px0g.js";
 import"./index-7pmbnjvj.js";
-import"./index-mb1reyw3.js";
-import"./index-9b86vn97.js";
+import"./index-8tf5tewn.js";
+import"./index-bqqyxmpk.js";
 import"./index-vzm6zre7.js";
 import"./index-ae75rja9.js";
-import"./index-zwgh0gty.js";
-import"./index-7sbyvk99.js";
-import"./index-0v2svrev.js";
+import"./index-jkz10gm7.js";
+import"./index-gyhj562n.js";
+import"./index-4zran0jk.js";
 import"./index-t7hmqgjy.js";
-import"./index-4htcpbs4.js";
+import"./index-h83221w1.js";
 import"./index-fzpt2djt.js";
 import"./index-ejhxgyvm.js";
 import"./index-7g4c7s5r.js";
-import"./index-r6e8syr3.js";
+import"./index-1d51nz8d.js";
 import"./index-gx2vp8gx.js";
-import"./index-1466xg5c.js";
+import"./index-6kf62j82.js";
 import"./index-zxdawwc7.js";
-import"./index-9hsnarbv.js";
+import"./index-gmmz119k.js";
 import"./index-bstjg81q.js";
 import"./index-bk5tah7q.js";
 import"./index-gknz3bv1.js";

package/dist/cli/{speckit-checkoff-wydtzjmn.js → speckit-checkoff-zw0w6ekx.js}

@@ -7,13 +7,13 @@ import {
   parseSpeckitTasksContent,
   propagateSpeckitCheckoff,
   writeSpeckitCheckoffLedger
-} from "./index-bf1meb32.js";
+} from "./index-0yqa3awy.js";
 import"./index-ejhxgyvm.js";
 import"./index-7g4c7s5r.js";
-import"./index-r6e8syr3.js";
-import"./index-1466xg5c.js";
+import"./index-1d51nz8d.js";
+import"./index-6kf62j82.js";
 import"./index-zxdawwc7.js";
-import"./index-9hsnarbv.js";
+import"./index-gmmz119k.js";
 import"./index-bstjg81q.js";
 import"./index-bk5tah7q.js";
 import"./index-gknz3bv1.js";

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

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

package/dist/cli/{workspace-snapshot-y60ay5eq.js → workspace-snapshot-w60bykdz.js}

@@ -46,11 +46,11 @@ import {
   shouldSkipSnapshot,
   switchPrFeedbackTrackingCandidateAsync,
   workspaceSnapshotMatches
-} from "./index-mf19yqss.js";
-import"./index-bejxkee0.js";
+} from "./index-qwrx78m5.js";
+import"./index-4czf0es9.js";
 import"./index-2s7dvzff.js";
 import"./index-fzpt2djt.js";
-import"./index-r6e8syr3.js";
+import"./index-1d51nz8d.js";
 import"./index-zxdawwc7.js";
 import"./index-zpsr8rpc.js";
 import"./index-zgwm4ryv.js";

package/dist/cli/{worktree-collision-ownership-5fbzrgnm.js → worktree-collision-ownership-0d8xf1d8.js}

@@ -6,37 +6,37 @@ import {
   WORKTREE_PROVISIONING_OWNER_LEASE_MS,
   removeWorktreeProvisioningOwner,
   scanWorktreeProvisioningOwnersForRecovery
-} from "./index-a8gvszr2.js";
+} from "./index-jc0jxg7y.js";
 import {
   scanWorktreeMergeFailuresForRecovery
 } from "./index-zsrtt42s.js";
 import {
   scanDelegationFallbacksForRecovery,
   scanDelegationsForRecovery
-} from "./index-gd41qkx3.js";
-import"./index-bejxkee0.js";
+} from "./index-dka1ra21.js";
+import"./index-4czf0es9.js";
 import"./index-2s7dvzff.js";
-import"./index-m1qy7f1e.js";
-import"./index-cc1vzq4m.js";
-import"./index-9hag235h.js";
+import"./index-103gsfn1.js";
+import"./index-v09x4k5h.js";
+import"./index-ww91zjzk.js";
 import"./index-ry16d01s.js";
 import"./index-rdm3px0g.js";
 import"./index-7pmbnjvj.js";
-import"./index-mb1reyw3.js";
-import"./index-9b86vn97.js";
+import"./index-8tf5tewn.js";
+import"./index-bqqyxmpk.js";
 import"./index-vzm6zre7.js";
 import"./index-ae75rja9.js";
-import"./index-zwgh0gty.js";
-import"./index-7sbyvk99.js";
-import"./index-0v2svrev.js";
+import"./index-jkz10gm7.js";
+import"./index-gyhj562n.js";
+import"./index-4zran0jk.js";
 import"./index-t7hmqgjy.js";
-import"./index-4htcpbs4.js";
+import"./index-h83221w1.js";
 import {
   canonicalRootKeyFresh
 } from "./index-fzpt2djt.js";
 import"./index-ejhxgyvm.js";
 import"./index-7g4c7s5r.js";
-import"./index-r6e8syr3.js";
+import"./index-1d51nz8d.js";
 import"./index-zxdawwc7.js";
 import"./index-bk5tah7q.js";
 import"./index-gknz3bv1.js";

package/dist/cli/{worktree-isolation-643nwna7.js → worktree-isolation-ds8n4a16.js}

@@ -21,76 +21,76 @@ import {
   sanitizeWorktreeTaskId,
   standardWorktreeByCallID,
   standardWorktreeSerializationSessions
-} from "./index-51dww7y9.js";
-import"./index-zyc869ys.js";
-import"./index-kxj8bqtj.js";
-import"./index-tr901ma3.js";
+} from "./index-94b58ssa.js";
+import"./index-yacpp9jq.js";
+import"./index-ntyc39rv.js";
+import"./index-tr6kaa6q.js";
 import"./index-vx8a8w3b.js";
-import"./index-x73e0zkb.js";
-import"./index-jd3hvnqn.js";
+import"./index-vx59q2ex.js";
+import"./index-75bm071p.js";
 import"./index-txdagbh7.js";
-import"./index-wb01w8ex.js";
+import"./index-4vgvybav.js";
 import"./index-rdec0y3z.js";
-import"./index-1hqybe51.js";
-import"./index-pz26qx3x.js";
-import"./index-b02cdy5w.js";
-import"./index-rn5hh7pp.js";
-import"./index-mf19yqss.js";
-import"./index-41v699sv.js";
+import"./index-6qtgyzw2.js";
+import"./index-sh7se0x5.js";
+import"./index-fm0yan3t.js";
+import"./index-8zs4v02d.js";
+import"./index-qwrx78m5.js";
+import"./index-d74wbpqc.js";
 import"./index-cjapb4hy.js";
-import"./index-a8gvszr2.js";
+import"./index-jc0jxg7y.js";
 import"./index-pt7h91zc.js";
 import"./index-q7sjgr1y.js";
-import"./index-x2p51ka9.js";
-import"./index-fq78x7th.js";
+import"./index-d3p96wkj.js";
+import"./index-p8kv9hh6.js";
 import"./index-6b295cas.js";
 import"./index-9nyqt3kb.js";
-import"./index-9wfjc4cn.js";
+import"./index-195msz9x.js";
 import"./index-zsrtt42s.js";
-import"./index-bf1meb32.js";
-import"./index-edf2eztc.js";
-import"./index-4e3qcwfb.js";
+import"./index-0yqa3awy.js";
+import"./index-1e4s8cyt.js";
+import"./index-6kckcdd7.js";
 import"./index-g4fs6z4e.js";
-import"./index-gd41qkx3.js";
-import"./index-yay1xxzk.js";
-import"./index-ea10gcja.js";
+import"./index-dka1ra21.js";
+import"./index-rqheyf9e.js";
+import"./index-wftdsx38.js";
 import"./index-m9zzj4ee.js";
-import"./index-bejxkee0.js";
+import"./index-4czf0es9.js";
 import"./index-2s7dvzff.js";
-import"./index-dwm3czmf.js";
-import"./index-rwabrcsg.js";
+import"./index-3034m1wv.js";
+import"./index-2ajapc0r.js";
 import"./index-rtry5xyf.js";
 import {
   resolveWorktreeIsolationConfig
-} from "./index-wxf5feq2.js";
+} from "./index-j7pqzxyq.js";
 import"./index-kbkk7vnh.js";
 import"./index-0725jpp7.js";
-import"./index-0rzc71q8.js";
-import"./index-3dvzvhrp.js";
-import"./index-b9pz70d0.js";
-import"./index-m1qy7f1e.js";
-import"./index-cc1vzq4m.js";
-import"./index-9hag235h.js";
+import"./index-53me7h10.js";
+import"./index-yctaaj1k.js";
+import"./index-ge4hk20b.js";
+import"./index-103gsfn1.js";
+import"./index-v09x4k5h.js";
+import"./index-ww91zjzk.js";
 import"./index-ry16d01s.js";
 import"./index-rdm3px0g.js";
 import"./index-7pmbnjvj.js";
-import"./index-mb1reyw3.js";
-import"./index-9b86vn97.js";
+import"./index-8tf5tewn.js";
+import"./index-bqqyxmpk.js";
 import"./index-vzm6zre7.js";
 import"./index-ae75rja9.js";
-import"./index-zwgh0gty.js";
-import"./index-7sbyvk99.js";
-import"./index-0v2svrev.js";
+import"./index-jkz10gm7.js";
+import"./index-gyhj562n.js";
+import"./index-4zran0jk.js";
 import"./index-t7hmqgjy.js";
-import"./index-4htcpbs4.js";
+import"./index-h83221w1.js";
 import"./index-fzpt2djt.js";
 import"./index-ejhxgyvm.js";
 import"./index-7g4c7s5r.js";
-import"./index-r6e8syr3.js";
+import"./index-1d51nz8d.js";
 import"./index-gx2vp8gx.js";
-import"./index-1466xg5c.js";
+import"./index-6kf62j82.js";
 import"./index-zxdawwc7.js";
-import"./index-9hsnarbv.js";
+import"./index-gmmz119k.js";
 import"./index-bstjg81q.js";
 import"./index-bk5tah7q.js";
 import"./index-gknz3bv1.js";

package/dist/context-map/capsule-builder.d.ts

@@ -20,7 +20,7 @@
  */
 import * as fs from 'node:fs';
 import type { AgentRole, CapsuleDelegationReason, CapsuleMetadata, ContextCapsule, ReadPolicyEntry, RoleProfile } from '../types/context-capsule';
-import type { ContextMap } from '../types/context-map';
+import type { ContextMap, DecisionEntry } from '../types/context-map';
 import { extractFileSummary, isFileStale } from './file-summary';
 import { computeContentHash, createEmptyContextMap, loadContextMap } from './persistence';
 /**
@@ -108,6 +108,19 @@ export declare const DEFAULT_ROLE_PROFILES: Record<AgentRole, RoleProfile>;
  * @returns Array of read policy entries, one per file
  */
 export declare function buildReadPolicy(files: string[], map: ContextMap, directory: string, invalidateOnHashChange?: boolean, contentCache?: Map<string, string | undefined>): ReadPolicyEntry[];
+/**
+ * Maximum number of decisions a critic capsule's Decisions section carries
+ * (#3016). Task-scoped decisions are selected first; remaining slots go to
+ * the most recent other decisions.
+ */
+export declare const MAX_CAPSULE_DECISIONS = 10;
+/**
+ * Select the decisions surfaced in a critic capsule: entries recorded for
+ * this task first, then the most recent decisions from other tasks, capped
+ * at {@link MAX_CAPSULE_DECISIONS} entries total. When either group exceeds
+ * its share, the MOST RECENT entries win (the log is append-order).
+ */
+export declare function selectCapsuleDecisions(decisions: readonly DecisionEntry[], taskId: string): DecisionEntry[];
 /**
  * Build a role-specific Context Capsule for a delegated agent.
  *

package/dist/context-map/persistence.d.ts

@@ -45,6 +45,15 @@ export declare function createEmptyContextMap(): ContextMap;
  * Load the Context Map from `.swarm/context-map.json` in the given directory.
  * Returns `null` if the file doesn't exist or cannot be parsed (corrupt file).
  * Never throws.
+ *
+ * Structural validation (#3016): every field downstream code iterates or
+ * spreads must have the shape the writers produce — `decisions` an array,
+ * `files` and `task_history` non-null non-array objects. Absent keys fail
+ * closed the same way: every in-repo writer (`createEmptyContextMap`,
+ * `saveContextMap`, the append paths) always materializes all three keys, so
+ * a map missing or mis-shaping them is foreign or hand-mangled and is
+ * replaced by a fresh map rather than silently dropped mid-update or
+ * corrupted by spread semantics.
  */
 export declare function loadContextMap(directory: string): ContextMap | null;
 /**

package/dist/context-map/post-agent-update.d.ts

@@ -16,9 +16,51 @@
  * No `bun:` imports — this module is Node-ESM-loadable (Invariant 2).
  */
 import * as fs from 'node:fs';
-import type { ContextMap } from '../types/context-map';
+import type { ContextMap, DecisionEntry } from '../types/context-map';
 import { extractFileSummary } from './file-summary';
 import { appendDecision, appendTaskHistory, createEmptyContextMap, loadContextMap, saveContextMap } from './persistence';
+/**
+ * A decision extracted from `.swarm/context.md`'s `## Decisions` section,
+ * ready to be persisted as a `DecisionEntry` by `updateContextMapAfterAgent`.
+ */
+export interface PostAgentDecision {
+    /** The decision text (bullet text before the first `: ` separator) */
+    decision: string;
+    /** Rationale text (after the first `: ` separator; empty when absent) */
+    rationale: string;
+    /** Phase number when the bullet carried or inherited one, else absent */
+    phase?: number;
+}
+/**
+ * Options for {@link extractContextDecisionsFromContextMd}.
+ */
+export interface ExtractContextDecisionsOptions {
+    /**
+     * Session agent role used to gate the sync. `.swarm/context.md` is
+     * architect-maintained (subagents are forbidden from writing it), so when
+     * a role is supplied and is not an architect role — bare `'architect'`
+     * (`ORCHESTRATOR_NAME`) or a multi-swarm prefixed form ending in
+     * `'_architect'` — the sync returns no decisions without reading the file.
+     * Omit to extract regardless of role.
+     */
+    agent_role?: string;
+}
+/**
+ * Maximum number of context.md decisions one sync records. The architect
+ * appends newest decisions at the bottom of the file, so the window keeps the
+ * MOST RECENT entries; older entries beyond the window are never
+ * retroactively recorded.
+ */
+export declare const MAX_CONTEXT_MD_DECISIONS = 50;
+/**
+ * Character bound for the context.md content handed to the shared extractor
+ * (PR #3023 feedback FB-005). The shared extractor's own cap slices a PREFIX
+ * (oldest-first), which would invert the most-recent window for pathological
+ * file sizes and silently drop a `## Decisions` heading lying beyond the
+ * slice; this module slices from the TAIL instead so the most recent content
+ * is what gets scanned.
+ */
+export declare const MAX_CONTEXT_MD_CONTENT_CHARS = 1000000;
 /**
  * Parameters for updating the Context Map after an agent completes a task.
  * Captures all relevant context from the agent's work session so that
@@ -45,10 +87,57 @@ export interface PostAgentUpdateParams {
     decisions?: Array<{
         decision: string;
         rationale: string;
+        phase?: number;
     }>;
     /** Project root directory */
     directory: string;
 }
+/**
+ * Allocate the next durable decision ID for a context map.
+ *
+ * Derived from the decisions already present in the map being updated:
+ * the max numeric suffix among existing `A<n>` IDs + 1, computed with BigInt
+ * so suffixes past 2^53 stay exact. Mirrors `allocateSummaryId` in
+ * src/summaries/manager.ts (issue #2576 / #2720): after a process restart
+ * the map is reloaded from disk, so allocation continues after the persisted
+ * IDs instead of restarting at A1 and duplicating identity in
+ * `.swarm/context-map.json`.
+ *
+ * IDs that do not match `^A\d+$` (foreign prefixes, non-strings) are ignored
+ * rather than crashing allocation.
+ */
+export declare function allocateDecisionId(decisions: readonly DecisionEntry[]): string;
+/**
+ * Extract decisions from `.swarm/context.md`'s `## Decisions` section.
+ *
+ * The context file is the repo's decisions-recording convention (architect
+ * prompt `src/agents/architect.ts`; shared `## Decisions` grammar parsed by
+ * `extractContextDecisions`, the #2493 consolidation). Each bullet
+ * `- <decision>: <rationale>` becomes a {@link PostAgentDecision}: the text
+ * before the FIRST `: ` is the decision, the remainder the rationale (a
+ * rationale may itself contain colons; a bullet without a separator yields an
+ * empty rationale). Bullets whose decision text is empty after the
+ * extractor's marker stripping are dropped.
+ *
+ * Bounded: keeps the most recent {@link MAX_CONTEXT_MD_DECISIONS} entries —
+ * entries beyond that window are never retroactively recorded.
+ *
+ * When `options.agent_role` is supplied and is not an architect role, returns
+ * `[]` without touching the filesystem (the file is architect-maintained;
+ * subagent-only sessions do not adopt its decisions).
+ *
+ * Never throws — a missing or unreadable file yields `[]`.
+ */
+export declare function extractContextDecisionsFromContextMd(directory: string, options?: ExtractContextDecisionsOptions): PostAgentDecision[];
+/**
+ * Upper bound for the PERSISTED decisions log in `.swarm/context-map.json`
+ * (PR #3023 feedback FB-002). The log is append-only within this window:
+ * after each update the most recent entries are kept and older ones are
+ * trimmed at save time, so reworded decision variants cannot grow the file
+ * without bound. The capsule read surface is additionally capped by
+ * `MAX_CAPSULE_DECISIONS` in the capsule builder.
+ */
+export declare const MAX_PERSISTED_DECISIONS = 200;
 /**
  * Test-only dependency-injection seam. Production code calls through this
  * object so tests can replace the underlying implementations without

package/dist/host/v2/agents-commands.d.ts

@@ -0,0 +1,41 @@
+/**
+ * v2 agent + command registration (issue #3004 / #2910).
+ *
+ * Single-source design: the v1 `config` hook IS the shared builder. This
+ * module invokes `hooks.config` against a synthetic `opencodeConfig` object
+ * and registers the resulting `.agent` / `.command` tables onto the v2 agent
+ * and command domains — the auto-select promotions and the entire v1 command table are reused with
+ * zero extraction from src/index.ts (the v1 TUI shortcut block stays
+ * byte-pinned). DELTA: the lane-permission mutations the v1 hook writes into
+ * the config object (applyLanePermissions) have no v2 destination here and
+ * are dropped - external-directory lane scoping is a #2910 follow-up row in
+ * docs/host/v2-hook-inventory.md.
+ *
+ * Mappings (docs/host/v2-hook-inventory.md rows 4-5):
+ *   - v1 AgentConfig → v2 Agent.Info: `prompt`→`system`, `mode` preserved
+ *     (multi-swarm `*_architect` primary semantics — AGENTS.md invariant 11),
+ *     `model` string 'provider/model' → Model.Ref, `tools` allowlist →
+ *     per-tool allow permission rules (best-effort; see inventory).
+ *   - Entries the v1 hook marks `disable: true` (auto-select disabling the
+ *     `build`/`plan` built-ins) are REMOVED on the v2 agent editor.
+ *   - v1 command entries `{template, description}` → v2 CommandDefinition
+ *     whose `execute` submits the expanded template through
+ *     `ctx.session.prompt` (TUI-side $ARGUMENTS expansion is replaced by
+ *     direct substitution — inventory row).
+ */
+import type { V1HooksSubset, V2AgentInfo, V2PluginContext, V2Registration } from './types';
+interface V1AgentConfigLike {
+    mode?: unknown;
+    prompt?: unknown;
+    description?: unknown;
+    model?: unknown;
+    tools?: unknown;
+    disable?: unknown;
+}
+/** Map one v1 AgentConfig entry to a v2 Agent.Info. */
+export declare function mapV1AgentToV2(name: string, config: V1AgentConfigLike): V2AgentInfo;
+/** Expand a v1 TUI template for a v2 command execution. */
+export declare function expandV1Template(template: string, argumentsText: string): string;
+/** Register agents + commands via the synthetic config-hook run. */
+export declare function registerV2AgentsAndCommands(ctx: V2PluginContext, hooks: V1HooksSubset, directory: string, registrations: V2Registration[]): Promise<void>;
+export {};

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

@@ -0,0 +1,39 @@
+/**
+ * v2 event subscription pump (issue #3004 / #2910).
+ *
+ * Consumes the v2 host's event stream (async iterable from
+ * `ctx.event.subscribe()`) and maps host events onto the plugin's existing v1
+ * event handler. The pump runs detached; the returned stop function breaks
+ * iteration (called by the v2 cleanup).
+ *
+ * Event-name map (full table in docs/host/v2-hook-inventory.md row 14):
+ *
+ *   v2 event                → v1 handler input
+ *   ------------------------+-------------------------------------------
+ *   session.idle            → { type: 'session.idle', properties }
+ *   session.status.updated  → { type: 'session.idle', properties } (state watch)
+ *   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.deleted / session.created → same-name v1 types
+ *
+ * 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).
+ */
+import type { V1HooksSubset, V2EventEnvelope, V2PluginContext } from './types';
+interface MappedEvent {
+    type: string;
+    properties: Record<string, unknown>;
+}
+/** 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
+ * convention (deferred).
+ */
+export declare function startDeferredEventPump(ctx: V2PluginContext, hooks: V1HooksSubset): () => void;
+export {};