opencode-swarm 7.188.1 → 7.188.3

package/dist/cli/{snapshot-coordination-init-j226zrvz.js → snapshot-coordination-init-c82a9gd1.js}

@@ -8,74 +8,74 @@ import {
   markSnapshotCoordinationClosing,
   retrySnapshotCoordinationInitialization,
   startSnapshotCoordinationInitialization
-} from "./index-wkxhhyej.js";
-import"./index-jn08bcaa.js";
-import"./index-qgvmq92m.js";
-import"./index-xrsfbr31.js";
+} from "./index-jh7s55h1.js";
+import"./index-vzd1a06e.js";
+import"./index-pah0zema.js";
+import"./index-vz6cjc6f.js";
 import"./index-vx8a8w3b.js";
-import"./index-x73e0zkb.js";
-import"./index-jd3hvnqn.js";
+import"./index-rysj8e3x.js";
+import"./index-9dp2zhvj.js";
 import"./index-txdagbh7.js";
-import"./index-z4zznftq.js";
+import"./index-1xedjkyy.js";
 import"./index-rdec0y3z.js";
-import"./index-gy57hcy2.js";
-import"./index-ztq5ag7q.js";
-import"./index-aqe9x8ga.js";
-import"./index-zhnywrhs.js";
+import"./index-p9y1t8tk.js";
+import"./index-s51gwkgd.js";
+import"./index-63pm3wa2.js";
+import"./index-5jm1nkv7.js";
 import"./index-mf19yqss.js";
-import"./index-41v699sv.js";
+import"./index-rszpn3zf.js";
 import"./index-cjapb4hy.js";
 import"./index-a8gvszr2.js";
 import"./index-pt7h91zc.js";
 import"./index-q7sjgr1y.js";
-import"./index-zvrfvtp3.js";
-import"./index-dxhd7dsr.js";
+import"./index-82q5nv5h.js";
+import"./index-ebhxj1dk.js";
 import"./index-6b295cas.js";
 import"./index-9nyqt3kb.js";
-import"./index-swagbt0g.js";
+import"./index-crkx7tta.js";
 import"./index-zsrtt42s.js";
-import"./index-c66ywect.js";
-import"./index-9007eaeh.js";
-import"./index-edaj9qxn.js";
+import"./index-1wfychd6.js";
+import"./index-tqdjsvrm.js";
+import"./index-q2nydddh.js";
 import"./index-g4fs6z4e.js";
-import"./index-w4q0sw5g.js";
-import"./index-mdbqm6w1.js";
-import"./index-4m6k2r0v.js";
+import"./index-2y4v88xp.js";
+import"./index-91ajdtc6.js";
+import"./index-jgkcsykf.js";
 import"./index-m9zzj4ee.js";
 import"./index-bejxkee0.js";
 import"./index-2s7dvzff.js";
-import"./index-cs6g43qy.js";
-import"./index-rwabrcsg.js";
+import"./index-rw8bq18z.js";
+import"./index-ats43ttc.js";
 import"./index-rtry5xyf.js";
-import"./index-cb72p9w2.js";
+import"./index-h3sty9qx.js";
 import"./index-kbkk7vnh.js";
 import"./index-0725jpp7.js";
-import"./index-9bjf0bhd.js";
-import"./index-4rjw95qw.js";
-import"./index-b9pz70d0.js";
+import"./index-gjnt7sfc.js";
+import"./index-z7k42wpb.js";
+import"./index-yd36m8y5.js";
 import"./index-m1qy7f1e.js";
 import"./index-cc1vzq4m.js";
 import"./index-9hag235h.js";
 import"./index-ry16d01s.js";
 import"./index-rdm3px0g.js";
 import"./index-7pmbnjvj.js";
-import"./index-mb1reyw3.js";
-import"./index-fdx38afm.js";
+import"./index-9kaerjtj.js";
+import"./index-q1ymkdnc.js";
 import"./index-vzm6zre7.js";
 import"./index-ae75rja9.js";
-import"./index-zwgh0gty.js";
-import"./index-7sbyvk99.js";
-import"./index-0v2svrev.js";
+import"./index-r06m1jps.js";
+import"./index-e3ddxfh4.js";
+import"./index-bt11gbj8.js";
 import"./index-t7hmqgjy.js";
-import"./index-4htcpbs4.js";
+import"./index-qx0npayj.js";
 import"./index-fzpt2djt.js";
 import"./index-ejhxgyvm.js";
 import"./index-7g4c7s5r.js";
 import"./index-r6e8syr3.js";
 import"./index-gx2vp8gx.js";
-import"./index-936d3ny7.js";
+import"./index-322afz1z.js";
 import"./index-zxdawwc7.js";
-import"./index-5m06enb0.js";
+import"./index-0vhaejxa.js";
 import"./index-bstjg81q.js";
 import"./index-bk5tah7q.js";
 import"./index-gknz3bv1.js";

package/dist/cli/{speckit-checkoff-6xa1f1qr.js → speckit-checkoff-fr3jnnah.js}

@@ -7,13 +7,13 @@ import {
   parseSpeckitTasksContent,
   propagateSpeckitCheckoff,
   writeSpeckitCheckoffLedger
-} from "./index-c66ywect.js";
+} from "./index-1wfychd6.js";
 import"./index-ejhxgyvm.js";
 import"./index-7g4c7s5r.js";
 import"./index-r6e8syr3.js";
-import"./index-936d3ny7.js";
+import"./index-322afz1z.js";
 import"./index-zxdawwc7.js";
-import"./index-5m06enb0.js";
+import"./index-0vhaejxa.js";
 import"./index-bstjg81q.js";
 import"./index-bk5tah7q.js";
 import"./index-gknz3bv1.js";

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

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

package/dist/cli/{worktree-collision-ownership-frtjkhms.js → worktree-collision-ownership-q0kn3g0k.js}

@@ -13,7 +13,7 @@ import {
 import {
   scanDelegationFallbacksForRecovery,
   scanDelegationsForRecovery
-} from "./index-w4q0sw5g.js";
+} from "./index-2y4v88xp.js";
 import"./index-bejxkee0.js";
 import"./index-2s7dvzff.js";
 import"./index-m1qy7f1e.js";
@@ -22,15 +22,15 @@ import"./index-9hag235h.js";
 import"./index-ry16d01s.js";
 import"./index-rdm3px0g.js";
 import"./index-7pmbnjvj.js";
-import"./index-mb1reyw3.js";
-import"./index-fdx38afm.js";
+import"./index-9kaerjtj.js";
+import"./index-q1ymkdnc.js";
 import"./index-vzm6zre7.js";
 import"./index-ae75rja9.js";
-import"./index-zwgh0gty.js";
-import"./index-7sbyvk99.js";
-import"./index-0v2svrev.js";
+import"./index-r06m1jps.js";
+import"./index-e3ddxfh4.js";
+import"./index-bt11gbj8.js";
 import"./index-t7hmqgjy.js";
-import"./index-4htcpbs4.js";
+import"./index-qx0npayj.js";
 import {
   canonicalRootKeyFresh
 } from "./index-fzpt2djt.js";

package/dist/cli/{worktree-isolation-c07qk28m.js → worktree-isolation-zz26e66q.js}

@@ -21,76 +21,76 @@ import {
   sanitizeWorktreeTaskId,
   standardWorktreeByCallID,
   standardWorktreeSerializationSessions
-} from "./index-wkxhhyej.js";
-import"./index-jn08bcaa.js";
-import"./index-qgvmq92m.js";
-import"./index-xrsfbr31.js";
+} from "./index-jh7s55h1.js";
+import"./index-vzd1a06e.js";
+import"./index-pah0zema.js";
+import"./index-vz6cjc6f.js";
 import"./index-vx8a8w3b.js";
-import"./index-x73e0zkb.js";
-import"./index-jd3hvnqn.js";
+import"./index-rysj8e3x.js";
+import"./index-9dp2zhvj.js";
 import"./index-txdagbh7.js";
-import"./index-z4zznftq.js";
+import"./index-1xedjkyy.js";
 import"./index-rdec0y3z.js";
-import"./index-gy57hcy2.js";
-import"./index-ztq5ag7q.js";
-import"./index-aqe9x8ga.js";
-import"./index-zhnywrhs.js";
+import"./index-p9y1t8tk.js";
+import"./index-s51gwkgd.js";
+import"./index-63pm3wa2.js";
+import"./index-5jm1nkv7.js";
 import"./index-mf19yqss.js";
-import"./index-41v699sv.js";
+import"./index-rszpn3zf.js";
 import"./index-cjapb4hy.js";
 import"./index-a8gvszr2.js";
 import"./index-pt7h91zc.js";
 import"./index-q7sjgr1y.js";
-import"./index-zvrfvtp3.js";
-import"./index-dxhd7dsr.js";
+import"./index-82q5nv5h.js";
+import"./index-ebhxj1dk.js";
 import"./index-6b295cas.js";
 import"./index-9nyqt3kb.js";
-import"./index-swagbt0g.js";
+import"./index-crkx7tta.js";
 import"./index-zsrtt42s.js";
-import"./index-c66ywect.js";
-import"./index-9007eaeh.js";
-import"./index-edaj9qxn.js";
+import"./index-1wfychd6.js";
+import"./index-tqdjsvrm.js";
+import"./index-q2nydddh.js";
 import"./index-g4fs6z4e.js";
-import"./index-w4q0sw5g.js";
-import"./index-mdbqm6w1.js";
-import"./index-4m6k2r0v.js";
+import"./index-2y4v88xp.js";
+import"./index-91ajdtc6.js";
+import"./index-jgkcsykf.js";
 import"./index-m9zzj4ee.js";
 import"./index-bejxkee0.js";
 import"./index-2s7dvzff.js";
-import"./index-cs6g43qy.js";
-import"./index-rwabrcsg.js";
+import"./index-rw8bq18z.js";
+import"./index-ats43ttc.js";
 import"./index-rtry5xyf.js";
 import {
   resolveWorktreeIsolationConfig
-} from "./index-cb72p9w2.js";
+} from "./index-h3sty9qx.js";
 import"./index-kbkk7vnh.js";
 import"./index-0725jpp7.js";
-import"./index-9bjf0bhd.js";
-import"./index-4rjw95qw.js";
-import"./index-b9pz70d0.js";
+import"./index-gjnt7sfc.js";
+import"./index-z7k42wpb.js";
+import"./index-yd36m8y5.js";
 import"./index-m1qy7f1e.js";
 import"./index-cc1vzq4m.js";
 import"./index-9hag235h.js";
 import"./index-ry16d01s.js";
 import"./index-rdm3px0g.js";
 import"./index-7pmbnjvj.js";
-import"./index-mb1reyw3.js";
-import"./index-fdx38afm.js";
+import"./index-9kaerjtj.js";
+import"./index-q1ymkdnc.js";
 import"./index-vzm6zre7.js";
 import"./index-ae75rja9.js";
-import"./index-zwgh0gty.js";
-import"./index-7sbyvk99.js";
-import"./index-0v2svrev.js";
+import"./index-r06m1jps.js";
+import"./index-e3ddxfh4.js";
+import"./index-bt11gbj8.js";
 import"./index-t7hmqgjy.js";
-import"./index-4htcpbs4.js";
+import"./index-qx0npayj.js";
 import"./index-fzpt2djt.js";
 import"./index-ejhxgyvm.js";
 import"./index-7g4c7s5r.js";
 import"./index-r6e8syr3.js";
 import"./index-gx2vp8gx.js";
-import"./index-936d3ny7.js";
+import"./index-322afz1z.js";
 import"./index-zxdawwc7.js";
-import"./index-5m06enb0.js";
+import"./index-0vhaejxa.js";
 import"./index-bstjg81q.js";
 import"./index-bk5tah7q.js";
 import"./index-gknz3bv1.js";

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

@@ -16,7 +16,7 @@
  * 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';
 /**
@@ -49,6 +49,21 @@ export interface PostAgentUpdateParams {
     /** 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;
 /**
  * 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 {};

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

@@ -0,0 +1,30 @@
+/**
+ * v2 guidance delivery — the session `context` hook (issue #3004 / #2910, R1
+ * in ADR-0003).
+ *
+ * Transport mapping (docs/host/v2-hook-inventory.md row 6/7):
+ *
+ *   - The v1 MESSAGES transform chain runs first against a translated view of
+ *     `event.messages`. On v1 its guidance injections ride USER-role carrier
+ *     messages (`swarm-guidance:*` ids, fenced text) because the v1 host drops
+ *     role:'system' entries (#2526). The v2 host renders `event.system`
+ *     natively, so those carriers are RE-HOMED here into `event.system` as
+ *     text parts and removed from the message list — each guidance unit has
+ *     exactly one destination.
+ *   - The v1 SYSTEM transform chain then runs with a translated input and its
+ *     (unfenced) strings are appended as further `event.system` text parts —
+ *     exactly what the v1 system surface receives.
+ *
+ * `event.agent` is an Agent.Info-shaped object on v2; it is normalized to a
+ * name before any v1 agent comparison (frozen C4 header requirement).
+ *
+ * Part-kind mapping (R10): text parts map 1:1; non-text content kinds
+ * (media, tool-call, tool-result, reasoning, step-start, compaction, effort)
+ * are preserved untouched on their message — the v1 chain's steps only read
+ * and write `type === 'text'` parts.
+ */
+import type { V1HooksSubset, V2PluginContext, V2Registration, V2SessionContextEvent } from './types';
+/** The v2 context hook body. */
+export declare function onV2ContextEvent(event: V2SessionContextEvent, hooks: V1HooksSubset, directory: string): Promise<void>;
+/** Register the context hook on the v2 session domain. */
+export declare function registerV2ContextHook(ctx: V2PluginContext, hooks: V1HooksSubset, directory: string, registrations: V2Registration[]): Promise<void>;

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

@@ -0,0 +1,31 @@
+/**
+ * v2 lifecycle hook adapters — tool execute.before/after, session compaction,
+ * session prompt (issue #3004 / #2910).
+ *
+ * Each adapter wraps the SAME v1 handler functions with payload translation:
+ *
+ *   - `tool.execute.before`: v2 `{tool, sessionID, agent, messageID, id,
+ *     input}` → v1 `{tool, sessionID, callID, agent}` + mutable output
+ *     `{args}`; the v1 chain's `output.args` mutation is applied back onto
+ *     `event.input` in place.
+ *   - `tool.execute.after`: v1 `{title, output, metadata}` mutable output is
+ *     fed a best-effort translation of the v2 completed/error result.
+ *     (v2 has no title surface; the translation targets the fields the v1
+ *     toolAfter chain reads.)
+ *   - `compaction`: translated session/model identity; the v1 customizer's
+ *     directive output has no v1→v2 mapping yet — the turn-generation advance
+ *     and the customizer still run (inventory row).
+ *   - `prompt`: the v1 `chat.message` chain (model fallback preflight,
+ *     delegation ledger, cache-cohort seeding) runs against a translated
+ *     envelope. The #2989 chat-boundary model override writes
+ *     `output.message.model`, which the v2 SessionPrompt has no field for —
+ *     v1-only for now (inventory row).
+ *
+ * Denial semantics: a v1 hook throw propagates as the v2 hook error
+ * (fail-closed preserved; documented v2 delta in the inventory).
+ */
+import type { V1HooksSubset, V2PluginContext, V2Registration } from './types';
+/** Register the tool hooks (execute.before/after). */
+export declare function registerV2ToolHooks(ctx: V2PluginContext, hooks: V1HooksSubset, directory: string, registrations: V2Registration[]): Promise<void>;
+/** Register the compaction + prompt session hooks. */
+export declare function registerV2SessionHooks(ctx: V2PluginContext, hooks: V1HooksSubset, directory: string, registrations: V2Registration[]): Promise<void>;

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

@@ -0,0 +1,61 @@
+/**
+ * OpenCode 2 (v2 plugin API) setup entrypoint — issue #3004 / #2910.
+ *
+ * The v2 host validates the plugin's default export against
+ * `{ id, setup | effect }` (sst/opencode v2 line, packages/core/src/plugin/
+ * module.ts). The v1 `server()` path stays byte-stable for OpenCode 1 hosts;
+ * this module is what `setup(ctx)` runs on OpenCode 2 hosts.
+ *
+ * Architecture (ADR-0003): the adapter reuses the SAME initialization core and
+ * the SAME v1 hook set — it only TRANSLATES registration surfaces:
+ *
+ *   - tools: `hooks.tool` map → `ctx.tool.transform(editor.add)` (one source,
+ *     `buildPluginToolObject`; no parallel name list — enforced by
+ *     scripts/check-tool-registration.ts);
+ *   - agents + commands: the v1 `config` hook is invoked against a synthetic
+ *     `opencodeConfig` object, making the config hook itself the shared
+ *     builder (auto-select promotions and the command table are reused
+ *     verbatim — zero extraction from src/index.ts);
+ *   - guidance: the v1 messages/system transform chains run against a
+ *     translated session event; the #2526 USER-role guidance carriers the
+ *     messages chain materializes are re-homed into `event.system` (v2 renders
+ *     system natively — the user→system transport delta is recorded in
+ *     docs/host/v2-hook-inventory.md);
+ *   - lifecycle: tool execute.before/after, compaction, prompt hooks and the
+ *     event subscription are wired with payload translation; `setup` returns
+ *     a single Cleanup that disposes every Registration and runs the v1
+ *     dispose teardown.
+ *
+ * Init boundedness (AGENTS.md invariant 1): every `await` in src/host/** is
+ * either on the same physical line as a `withTimeout(` call or inside a
+ * function named deferred-…/cleanup-… (the frozen C6 source-scan convention).
+ * The shared initialization wrapper (`deps.runInit`) is injected by
+ * src/index.ts so no module cycle is created and the FATAL-fail surface stays
+ * with the v1 wrapper.
+ */
+import type { V1HooksSubset, V2PluginContext } from './types';
+/** Dependencies injected from src/index.ts (avoids an index↔host cycle). */
+export interface V2SetupDependencies {
+    /** The shared server-initialization wrapper (begin-interval → init core → schedule deferred → end-interval). */
+    runInit: (input: unknown) => Promise<V1HooksSubset>;
+}
+/** Normalize a v2 agent reference (Agent.Info object or bare string) to a name. */
+export declare function normalizeV2AgentRef(agent: unknown): string | undefined;
+/**
+ * Register the plugin on an OpenCode 2 host. Throws propagate to the v2 host
+ * (which skips the plugin) after a FATAL stderr line from the shared wrapper —
+ * the same posture the v1 server() path has (issue #675).
+ */
+export declare function openCodeSwarmV2Setup(ctx: V2PluginContext, deps: V2SetupDependencies): Promise<() => Promise<void>>;
+/**
+ * Seed the v1 session state a translated hook event implies. Shared by the
+ * guidance/prompt/tool-hook adapters so the v1 chain sees the same session
+ * identity the v1 host would have seeded via chat.message.
+ */
+export declare function seedV1SessionState(sessionID: string | undefined, agentRef: unknown, directory: string): string | undefined;
+/**
+ * Convert a v1 zod args shape into the JSON-schema-ish `input` value the v2
+ * tool editor accepts. Cached per tool at registration time (transforms must
+ * be synchronous and cheap).
+ */
+export declare function v2ToolInputSchema(args: unknown): unknown;

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

@@ -0,0 +1,41 @@
+/**
+ * v2 tool registration — issue #3004 / #2910.
+ *
+ * Registers every tool from the SAME map the v1 host receives
+ * (`hooks.tool`, built by `buildPluginToolObject` from `TOOL_MANIFEST` — the
+ * single source; scripts/check-tool-registration.ts enforces that no parallel
+ * name list exists here).
+ *
+ * The execute adapter synthesizes the FULL v1 `ToolContext` (AGENTS.md
+ * invariant 4: `.swarm/` must resolve against the project root captured at
+ * setup, never `process.cwd()`): `directory`/`worktree` are injected, the v2
+ * `signal` becomes the v1 `abort`, `progress` bridges v1 `metadata({title?,
+ * metadata?})`, and `ask` bridges to the v2 permission domain when available
+ * and fails closed otherwise.
+ *
+ * Result mapping: v1 `string | {title?, output, metadata?, attachments?}` →
+ * v2 `{content, metadata}` (v2 has no title/attachment surface — inventory
+ * row in docs/host/v2-hook-inventory.md).
+ */
+import type { V1HooksSubset, V2PluginContext, V2Registration, V2ToolContext } from './types';
+interface V1ToolContextShape {
+    sessionID: string;
+    messageID: string;
+    agent: string;
+    directory: string;
+    worktree: string;
+    abort: AbortSignal;
+    metadata: (input: {
+        title?: string;
+        metadata?: Record<string, unknown>;
+    }) => void;
+    ask: (input: unknown) => Promise<void>;
+}
+/** Synthesize the v1 ToolContext the plugin's tools expect (R2 in ADR-0003). */
+declare function synthesizeV1ToolContext(context: V2ToolContext, projectRoot: string, permissionBridge: ((input: unknown) => Promise<void>) | undefined): V1ToolContextShape;
+/** Register all v1 tools on the v2 tool domain. */
+export declare function registerV2Tools(ctx: V2PluginContext, hooks: V1HooksSubset, projectRoot: string, registrations: V2Registration[]): Promise<void>;
+export declare const _internals: {
+    synthesizeV1ToolContext: typeof synthesizeV1ToolContext;
+};
+export {};