@decibelsystems/tools 2.2.0-beta.0 → 3.0.0

package/CHANGELOG.md

@@ -0,0 +1,160 @@
+# Changelog
+
+## 3.0.0 — 2026-09-06
+
+Decibel Tools stopped being a daemon, an MCP server, a CLI, a store and a VS Code
+extension that happen to share a repo. It is **one runtime with several adapters**.
+An adapter translates transport and establishes project context; it does not
+instantiate its own store, caches, project registry, or write path.
+
+That is the whole of 3.0. Everything below follows from it.
+
+### Breaking
+
+- **`DECIBEL_APPS=1` is gone, and no environment variable replaces it.** The
+  apps-tier facades (`senken`, `deck`, `mother`, `terminal`) are no longer compiled
+  into the package. They load at boot as extensions, from `extensions.allow` in
+  `~/.decibel/config.yaml`, **by absolute path only** — a bare specifier would
+  resolve against `node_modules`, which would hand facade selection to whoever can
+  write a package. An extension may not shadow a registered facade name.
+
+  Config-file state the owner edits beats environment state a generator has to
+  remember: a regenerated launchd plist silently dropped those four facades once,
+  and `/health` reported `status: ok` with no indication four were missing.
+
+- **The public package no longer describes private facades.** It previously shipped
+  compiled `senken.js` and `deck.js` — a description of a live trading Postgres and
+  a wallet-spending tool it could never reach. `S7` now asserts their absence from
+  the tarball on every run.
+
+- **An unregistered facade is a hard error, not an empty success.** Fail-closed by
+  absence is only safe if absence is loud. A call to something that was never
+  registered returns `ok: false` / `TOOL_ERROR`; it does not return zero rows.
+
+- **Issue records are canonical markdown.** All 58 remaining bare-YAML records were
+  converted; the store is markdown-only. Timestamp-slug *filenames* are deliberately
+  kept (ADR-0010) — 49 provenance events and 2 ADRs reference them, and provenance
+  events are immutable audit records. Identity is the `id:` field, which is already
+  how records resolve.
+
+- **Adapters do not silently become writers.** There is no in-process fallback for
+  mutations. A thin client auto-starts the runtime, retries briefly, then fails with
+  an actionable error.
+
+### The surface
+
+| Tier | Facades | Actions | How it loads |
+|---|---|---|---|
+| core | 26 | 183 | always |
+| + pro | 31 | 224 | license-gated at runtime |
+| + apps | — | — | extensions, absolute-path allowlist, not in the package |
+
+### Store integrity
+
+- **One writer.** `sentinelIssues.createIssue` delegates to `FsIssueRepository`;
+  there is no longer a second implementation emitting a different format into the
+  same directory.
+- **Id allocation is serialized across processes.** A file lock spans allocation
+  *through successful write* — serializing only the id scan leaves the race intact,
+  since both processes still compute the same number before either file lands — and
+  the write itself is `O_EXCL` as a second, independent defence against callers that
+  never take the lock. Applies to issues **and epics**; epics were still racing
+  until the S5 sweep found it (ISS-0158).
+- **Structured fields are parsed, mutated, serialized and atomically renamed**, never
+  edited by regex. Values containing `#`, `:`, `---` or a markdown heading survive
+  read-back.
+- **Repair, once.** `degraded` went 10 → 0, duplicate ids 4 groups → 0, wrong
+  `project` values 18 → 0. All three are now invariants CI can fail on. Most of the
+  degraded records carried a completed resolution and were open only because an old
+  status write had failed — the correct repair was to close them, not reformat them.
+- **Status is no longer stored twice by hand.** Markdown records mirror status into
+  the body; 16 had drifted from frontmatter, reading `open` to a person while every
+  tool reported them correctly. `close_issue` rewrote the mirror and `updateIssue`
+  never did. No test caught it because every test asserted through frontmatter, which
+  was never wrong.
+
+### Reads state absence honestly
+
+Thirty-one store-backed reads can now tell an **empty** store apart from an
+**unreadable** one, an **unparseable** one, and a **project that does not resolve**.
+Previously `if (!parsed) continue` and `catch {}` turned every one of those into
+`[]`.
+
+Reads that skip a record now carry `store_status` and `unreadable_count`. Three
+paths fail loudly instead, because a partial answer would have been dishonest:
+context's whole-file `facts.json` and `events.json`, and `auditPolicies` — where one
+bad policy used to abort the audit and report `summary.fail: 0`.
+
+### Runtime and daemon
+
+- `ensureRuntime({projectRoot, protocolVersion})` — one lifecycle primitive shared by
+  every caller (MCP, CLI, VS Code, hooks). Arbitration is the socket bind or an
+  atomic startup lock, never a PID file.
+- Protocol negotiation refuses a version-skewed runtime at handshake rather than
+  per-call. `/health` carries runtime version, protocol version, tier,
+  `extensions.loaded` and `extensions.rejected` with per-entry reasons.
+- **Error isolation**: no facade fault escapes `dispatch()`, including throws from
+  parameter coercion and facade resolution (which the transports would otherwise turn
+  into an MCP protocol fault rather than a failed tool call), and including dispatch
+  event listeners, which run synchronously on the call path.
+- **Per-facade circuit breaker.** The signal is *unresponsiveness*, not unhappiness:
+  a throw always counts, an `isError` slower than 2s counts, a fast `isError` leaves
+  the counters untouched. Five consecutive faults open a facade for 30s, then exactly
+  one probe at a time — a recovering database gets one connection attempt, not six.
+  Facade and direct-tool calls share one circuit, so `senken.trade_summary` and
+  `senken_trade_summary` cannot each burn a budget against the same pool.
+- Daemon hardening: timing-safe auth, body limits, rate limiting, log rotation,
+  graceful drain, crash-loop protection.
+
+### New
+
+- **guardian** (core) — dependency, secret, HTTP and config scanning with A–F grading.
+- **postoffice** (EPIC-0037) — model-agnostic agent-to-agent messaging, all seven
+  verbs, two-way threaded exchange.
+- **conductor** — run/dryrun/trace/cost/egress/routing.
+- **zoom** (EPIC-0036) — meeting-summary ingestion, gated behind `DECIBEL_ZOOM=1`.
+  **Not yet run against a live Zoom account.** It ships dark: unreachable unless
+  explicitly enabled.
+
+### The release gate
+
+`@decibelsystems/tools@3.0.0` is the first release blocked on the **tool torture
+test** (`.decibel/specs/2026-09-02-tool-torture-test.md`) — eight generated sweeps
+over the whole surface across four transports, built on one observation:
+
+> Every failure this project has actually shipped returned `ok: true`.
+
+A voice inbox dead for five and a half hours read as `voice 0`. A regenerated plist
+dropped four facades while `/health` said `status: ok`. `/batch` answered
+`{ok: true}` for a facade that does not exist.
+
+| Sweep | Gate |
+|---|---|
+| S0 enumeration | no unclaimed actions, no dangling actions, no expired waivers |
+| S1 envelope | every action answers in a well-formed envelope |
+| S2 absence | every read distinguishes the four situations above |
+| S3 round-trip | hostile values survive write → read |
+| S4 transports | stdio, thin, http-call and http-batch agree, differences declared |
+| S5 concurrency | 50 concurrent creates across 10 processes; crash mid-write |
+| S6 tier/extension | the apps boundary holds, and no env var reopens it |
+| S7 artifact | the packed tarball, not the repo |
+
+The surface is **generated from the kernel's own registries**, never enumerated by
+hand: adding a tool without giving it coverage turns the build red. Every action is
+claimed by a sweep or waived in `waivers.yaml` with a reason, an owner, and an
+expiry. Waivers expire, and an expired waiver fails the build.
+
+Six of the eighteen findings in S2 were the harness lying — fixtures planted at paths
+no reader globs, so tools that handled absence correctly were reported broken. S5's
+first crash test reported four successful `SIGKILL`s while all four victims kept
+running. Every sweep now carries a calibration probe that asserts it can see a
+deliberately broken tool before it is believed about the healthy ones.
+
+881 tests.
+
+---
+
+## 2.x
+
+Not tracked in this file. See the git history and `.decibel/sentinel/` for the
+issue-level record.

package/dist/agentPresence.d.ts

@@ -7,6 +7,85 @@
  * value the presence writer stamps. Shared by the dispatcher (agentCommands.ts).
  */
 export declare function resolveHost(): string;
+declare function serviceClient(): import("@supabase/supabase-js").SupabaseClient<any, "public", "hq", any, any> | null;
+type DbClient = NonNullable<ReturnType<typeof serviceClient>>;
+/**
+ * Derive the DURABLE address for a session.
+ *
+ * Must be stable across restarts, so anything process-scoped is disqualified:
+ * not the session key, not a PID, not a TTY. The claude-peers broker id looks
+ * stable but is not — it carries a random suffix (`decibel-hq-nby9`), so a
+ * restart would silently mint a second agent and split the thread history.
+ *
+ * Repo identity + runtime is the stable pair: the same checkout on the same
+ * runtime is the same logical agent, session after session.
+ *
+ * DELIBERATELY NOT caller-supplied. `reg.agent` is an untrusted display label
+ * from a local process, and a local caller that could name its own durable
+ * address could claim an EXISTING agent's name — resolve_agent_session picks
+ * the most recently seen session, so a frequent heartbeater would capture that
+ * agent's inbound mail. That is the principal-not-label gap (EPIC-0007) which
+ * Ben accepted as risk for EPIC-0037; accepting it is not a reason to widen it.
+ * An operator can still set the name explicitly via DECIBEL_AGENT_NAME, which
+ * is daemon-scoped env (trusted) rather than per-request payload.
+ */
+export declare function deriveAgentName(input: {
+    gitRoot?: string | null;
+    cwd?: string | null;
+    runtime: string;
+    host: string;
+}): string;
+/**
+ * Resolve (or create) the durable hq.agents row for `name` and return its id.
+ *
+ * Returns null rather than throwing when the table is absent — this ships
+ * BEFORE decibel-hq applies the post-office migration, and presence writing
+ * must keep working untouched in the meantime. When the migration lands the
+ * same code starts populating agent_id with no redeploy.
+ *
+ * `runtime` is written as a self-declared LABEL only. HQ's schema comment is
+ * explicit that it is never a trust signal, so nothing here gates on it.
+ */
+export declare function resolveAgentId(client: DbClient, name: string, runtime: string): Promise<string | null>;
+/** Test seam: drop memoised ids so a test can observe a fresh resolve. */
+export declare function __resetAgentIdCache(): void;
+export interface AgentRosterEntry {
+    id: string;
+    name: string;
+    runtime: string;
+    role: string | null;
+    capabilities: string[];
+    /** Durable lifecycle from hq.agents: 'active' | 'retired'. NOT liveness. */
+    status: string;
+    /** Liveness: does a live session currently resolve for this agent? */
+    online: boolean;
+    /** The session a message would be delivered into right now, or null. */
+    session_key: string | null;
+    last_seen_at: string | null;
+}
+/**
+ * The agents.list roster: hq.agents LEFT JOIN liveness.
+ *
+ * The roster is the DURABLE agents, each annotated with whether a live session
+ * resolves. An agent that exists but is offline MUST appear, marked offline,
+ * rather than vanish — a roster built from live sessions would silently drop
+ * exactly the agent you are trying and failing to reach, which is the same
+ * failure class as addressing a dead session.
+ *
+ * Two queries and a join in memory rather than one call to
+ * hq.resolve_agent_session per agent, which would be N round trips to render
+ * one board.
+ *
+ * CLOCK CAVEAT, and it is why this is a DISPLAY path only: the cutoff below is
+ * computed from the daemon's clock, while resolve_agent_session uses the
+ * database's now(). Skew between them can disagree at the 60s boundary. The
+ * authoritative answer at DELIVERY time is HQ's function, never this. Do not
+ * route a message using this roster's `online`.
+ *
+ * Returns null (not an empty roster) when the table is absent, so a caller can
+ * distinguish "no agents" from "post office not deployed yet".
+ */
+export declare function listAgentRoster(client: DbClient): Promise<AgentRosterEntry[] | null>;
 export interface LocalAgentRegistration {
     session_key: string;
     runtime: string;
@@ -33,4 +112,5 @@ export declare function sanitizeMeta(meta: Record<string, unknown> | undefined):
 export declare function writeLocalAgentSession(reg: LocalAgentRegistration): Promise<boolean>;
 /** Start the presence writer loop. Returns a stop function. No-ops if Supabase unconfigured. */
 export declare function startPresenceWriter(): () => void;
+export {};
 //# sourceMappingURL=agentPresence.d.ts.map

package/dist/agentPresence.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"agentPresence.d.ts","sourceRoot":"","sources":["../src/agentPresence.ts"],"names":[],"mappings":"AAsBA;;;;;;;GAOG;AACH,wBAAgB,WAAW,IAAI,MAAM,CAEpC;AAwHD,MAAM,WAAW,sBAAsB;IACrC,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,GAAG,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAG/B,MAAM,CAAC,EAAE,QAAQ,GAAG,OAAO,CAAC;CAC7B;AAmBD,+EAA+E;AAC/E,wBAAgB,YAAY,CAAC,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAIxF;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAU/F;AAED;;;;GAIG;AACH,wBAAsB,sBAAsB,CAAC,GAAG,EAAE,sBAAsB,GAAG,OAAO,CAAC,OAAO,CAAC,CAuC1F;AAED,gGAAgG;AAChG,wBAAgB,mBAAmB,IAAI,MAAM,IAAI,CAchD"}
+{"version":3,"file":"agentPresence.d.ts","sourceRoot":"","sources":["../src/agentPresence.ts"],"names":[],"mappings":"AAsBA;;;;;;;GAOG;AACH,wBAAgB,WAAW,IAAI,MAAM,CAEpC;AAeD,iBAAS,aAAa,yFAQrB;AACD,KAAK,QAAQ,GAAG,WAAW,CAAC,UAAU,CAAC,OAAO,aAAa,CAAC,CAAC,CAAC;AAqD9D;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE;IACrC,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,GAAG,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;CACd,GAAG,MAAM,CAWT;AASD;;;;;;;;;;GAUG;AACH,wBAAsB,cAAc,CAClC,MAAM,EAAE,QAAQ,EAChB,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAkCxB;AAID,0EAA0E;AAC1E,wBAAgB,mBAAmB,IAAI,IAAI,CAG1C;AASD,MAAM,WAAW,gBAAgB;IAC/B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,4EAA4E;IAC5E,MAAM,EAAE,MAAM,CAAC;IACf,sEAAsE;IACtE,MAAM,EAAE,OAAO,CAAC;IAChB,wEAAwE;IACxE,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;CAC7B;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAsB,eAAe,CAAC,MAAM,EAAE,QAAQ,GAAG,OAAO,CAAC,gBAAgB,EAAE,GAAG,IAAI,CAAC,CAmD1F;AA2ED,MAAM,WAAW,sBAAsB;IACrC,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,GAAG,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAG/B,MAAM,CAAC,EAAE,QAAQ,GAAG,OAAO,CAAC;CAC7B;AAmBD,+EAA+E;AAC/E,wBAAgB,YAAY,CAAC,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAIxF;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAU/F;AAED;;;;GAIG;AACH,wBAAsB,sBAAsB,CAAC,GAAG,EAAE,sBAAsB,GAAG,OAAO,CAAC,OAAO,CAAC,CAiD1F;AAED,gGAAgG;AAChG,wBAAgB,mBAAmB,IAAI,MAAM,IAAI,CAchD"}

package/dist/agentPresence.js

@@ -78,6 +78,170 @@ async function resolveProjectId(client, cwd) {
         projectMap = await loadProjects(client); // refresh once on miss
     return projectMap.get(key) ?? null;
 }
+// ============================================================================
+// Durable agent identity — the agent_id seam (ISS-0134 / EPIC-0037)
+// ============================================================================
+// hq.agent_sessions is EPHEMERAL: session_key dies with the process. hq.agents
+// is DURABLE: "this repo's Claude Code agent", stable across restarts, and it
+// is what a post-office message is addressed to. agent_sessions.agent_id is the
+// resolution edge between them, and HQ cannot populate it — the daemon owns
+// this write path, so the column stays inert until the code below fills it.
+//
+// Without it hq.resolve_agent_session() finds nothing, every message resolves
+// to delivered_session_key = NULL, and the post office records traffic it never
+// delivers. Honest, but inert.
+//
+// CARDINALITY IS MANY SESSIONS : ONE AGENT. That is not an assumption — HQ's
+// resolve_agent_session() ends in `order by last_seen_at desc limit 1`, which
+// only makes sense if several live sessions can share one agent_id. Two Claude
+// Code windows open on the same repo are one addressable agent; delivery goes
+// to whichever is most recently active.
+/**
+ * Derive the DURABLE address for a session.
+ *
+ * Must be stable across restarts, so anything process-scoped is disqualified:
+ * not the session key, not a PID, not a TTY. The claude-peers broker id looks
+ * stable but is not — it carries a random suffix (`decibel-hq-nby9`), so a
+ * restart would silently mint a second agent and split the thread history.
+ *
+ * Repo identity + runtime is the stable pair: the same checkout on the same
+ * runtime is the same logical agent, session after session.
+ *
+ * DELIBERATELY NOT caller-supplied. `reg.agent` is an untrusted display label
+ * from a local process, and a local caller that could name its own durable
+ * address could claim an EXISTING agent's name — resolve_agent_session picks
+ * the most recently seen session, so a frequent heartbeater would capture that
+ * agent's inbound mail. That is the principal-not-label gap (EPIC-0007) which
+ * Ben accepted as risk for EPIC-0037; accepting it is not a reason to widen it.
+ * An operator can still set the name explicitly via DECIBEL_AGENT_NAME, which
+ * is daemon-scoped env (trusted) rather than per-request payload.
+ */
+export function deriveAgentName(input) {
+    const explicit = process.env.DECIBEL_AGENT_NAME;
+    if (explicit && explicit.trim())
+        return explicit.trim().slice(0, 200);
+    // basename of the git root, else of the cwd — the repo IS the identity.
+    const root = (input.gitRoot || input.cwd || '').trim();
+    const key = root ? path.basename(root) : '';
+    // No filesystem context at all (a runtime that registered without a cwd):
+    // fall back to the daemon host so the name is still stable, just coarser.
+    const scope = key || input.host;
+    return `${scope}/${input.runtime}`.slice(0, 200);
+}
+/**
+ * agent name -> hq.agents.id, memoised for the process. The presence loop runs
+ * every 30s over every peer; without this each tick would re-round-trip the
+ * same handful of names forever.
+ */
+const agentIdCache = new Map();
+/**
+ * Resolve (or create) the durable hq.agents row for `name` and return its id.
+ *
+ * Returns null rather than throwing when the table is absent — this ships
+ * BEFORE decibel-hq applies the post-office migration, and presence writing
+ * must keep working untouched in the meantime. When the migration lands the
+ * same code starts populating agent_id with no redeploy.
+ *
+ * `runtime` is written as a self-declared LABEL only. HQ's schema comment is
+ * explicit that it is never a trust signal, so nothing here gates on it.
+ */
+export async function resolveAgentId(client, name, runtime) {
+    const cached = agentIdCache.get(name);
+    if (cached)
+        return cached;
+    // Upsert on the (org_id, name) unique key, then read the id back. Doing it as
+    // an upsert rather than select-then-insert keeps two daemons racing on the
+    // same name from both inserting.
+    const { data, error } = await withRetryResult(() => client
+        .from('agents')
+        .upsert({ org_id: ORG_ID, name, runtime }, { onConflict: 'org_id,name', ignoreDuplicates: false })
+        .select('id')
+        .maybeSingle(), `presence.agent-resolve ${name}`);
+    if (error) {
+        // Table not yet created (migration unapplied) is the EXPECTED state today,
+        // so log it once per name at low volume rather than every 30s tick.
+        if (!agentResolveWarned.has(name)) {
+            agentResolveWarned.add(name);
+            log(`Presence: agent identity unavailable for "${name}" (${error.message}) — agent_id left null.`);
+        }
+        return null;
+    }
+    const id = data?.id;
+    if (!id)
+        return null;
+    agentIdCache.set(name, id);
+    return id;
+}
+const agentResolveWarned = new Set();
+/** Test seam: drop memoised ids so a test can observe a fresh resolve. */
+export function __resetAgentIdCache() {
+    agentIdCache.clear();
+    agentResolveWarned.clear();
+}
+/**
+ * Liveness window. MUST match hq.resolve_agent_session's `interval '60 seconds'`
+ * — if these drift, the roster says "online" for an agent the delivery path
+ * will refuse to deliver to, which is worse than either answer alone.
+ */
+const LIVENESS_WINDOW_MS = 60_000;
+/**
+ * The agents.list roster: hq.agents LEFT JOIN liveness.
+ *
+ * The roster is the DURABLE agents, each annotated with whether a live session
+ * resolves. An agent that exists but is offline MUST appear, marked offline,
+ * rather than vanish — a roster built from live sessions would silently drop
+ * exactly the agent you are trying and failing to reach, which is the same
+ * failure class as addressing a dead session.
+ *
+ * Two queries and a join in memory rather than one call to
+ * hq.resolve_agent_session per agent, which would be N round trips to render
+ * one board.
+ *
+ * CLOCK CAVEAT, and it is why this is a DISPLAY path only: the cutoff below is
+ * computed from the daemon's clock, while resolve_agent_session uses the
+ * database's now(). Skew between them can disagree at the 60s boundary. The
+ * authoritative answer at DELIVERY time is HQ's function, never this. Do not
+ * route a message using this roster's `online`.
+ *
+ * Returns null (not an empty roster) when the table is absent, so a caller can
+ * distinguish "no agents" from "post office not deployed yet".
+ */
+export async function listAgentRoster(client) {
+    const { data: agents, error: agentsErr } = await withRetryResult(() => client
+        .from('agents')
+        .select('id,name,runtime,role,capabilities,status')
+        .eq('org_id', ORG_ID), 'presence.agent-roster');
+    if (agentsErr) {
+        log(`Presence: agent roster unavailable (${agentsErr.message}).`);
+        return null;
+    }
+    const cutoff = new Date(Date.now() - LIVENESS_WINDOW_MS).toISOString();
+    const { data: sessions } = await withRetryResult(() => client
+        .from('agent_sessions')
+        .select('agent_id,session_key,last_seen_at')
+        .eq('org_id', ORG_ID)
+        .eq('status', 'active')
+        .gt('last_seen_at', cutoff)
+        .order('last_seen_at', { ascending: false }), 'presence.agent-roster-liveness');
+    // Most recent wins, mirroring `order by last_seen_at desc limit 1`. The query
+    // is already sorted, so the first entry seen for an agent is the winner.
+    const live = new Map();
+    for (const s of (sessions ?? [])) {
+        if (!s.agent_id || live.has(s.agent_id))
+            continue;
+        live.set(s.agent_id, { session_key: s.session_key, last_seen_at: s.last_seen_at });
+    }
+    return (agents ?? []).map((a) => {
+        const hit = live.get(a.id);
+        return {
+            ...a,
+            capabilities: a.capabilities ?? [],
+            online: Boolean(hit),
+            session_key: hit?.session_key ?? null,
+            last_seen_at: hit?.last_seen_at ?? null,
+        };
+    });
+}
 async function tick(client) {
     const host = resolveHost();
     const nowMs = Date.now();
@@ -87,6 +251,9 @@ async function tick(client) {
         if (!p.id)
             continue;
         const project_id = await resolveProjectId(client, p.cwd);
+        // Durable identity for this session. git_root is preferred over cwd: a peer
+        // sitting in a subdirectory of the repo is the same agent as one at the top.
+        const agent_id = await resolveAgentId(client, deriveAgentName({ gitRoot: p.git_root, cwd: p.cwd, runtime: 'claude-code', host }), 'claude-code');
         const row = {
             org_id: ORG_ID,
             host,
@@ -95,6 +262,10 @@ async function tick(client) {
             // These are Claude Code sessions read from the claude-peers broker; tag the
             // runtime so HQ's /agents board renders the runtime badge + filter (P1/P5).
             runtime: 'claude-code',
+            // Only sent once resolvable. Before the post-office migration lands the
+            // column does not exist and PostgREST rejects the ENTIRE row on an
+            // unknown key — which would take down presence writing that works today.
+            ...(agent_id ? { agent_id } : {}),
             summary: p.summary || null,
             cwd: p.cwd || null,
             project_id,
@@ -179,11 +350,17 @@ export async function writeLocalAgentSession(reg) {
     const nowIso = new Date().toISOString();
     const project_id = await resolveProjectId(client, reg.cwd || '');
     const ended = reg.status === 'ended';
+    // Durable identity. The SDK gives us no git_root, so the cwd basename is the
+    // repo key. Note the address is derived from WHERE the runtime is, never from
+    // reg.agent — see deriveAgentName on why a caller must not name itself.
+    const agent_id = await resolveAgentId(client, deriveAgentName({ cwd: reg.cwd, runtime: reg.runtime, host }), reg.runtime);
     const row = {
         org_id: ORG_ID,
         host,
         session_key: reg.session_key,
         runtime: reg.runtime,
+        // See the claude-peers path: omitted, not nulled, until the column exists.
+        ...(agent_id ? { agent_id } : {}),
         // Non-encoding belt on caller-supplied display fields (store-raw / escape-at-
         // render is HQ's job; we only cap length + strip control chars/null bytes).
         agent: sanitizeText(reg.agent, FIELD_CAPS.agent),

package/dist/agentPresence.js.map

@@ -1 +1 @@
-{"version":3,"file":"agentPresence.js","sourceRoot":"","sources":["../src/agentPresence.ts"],"names":[],"mappings":"AAAA,+EAA+E;AAC/E,0EAA0E;AAC1E,+EAA+E;AAC/E,8EAA8E;AAC9E,WAAW;AACX,yEAAyE;AACzE,+EAA+E;AAC/E,mFAAmF;AACnF,yFAAyF;AACzF,kFAAkF;AAClF,uFAAuF;AACvF,+EAA+E;AAE/E,OAAO,EAAE,MAAM,IAAI,CAAC;AACpB,OAAO,IAAI,MAAM,MAAM,CAAC;AACxB,OAAO,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AACrD,OAAO,EAAE,GAAG,EAAE,MAAM,aAAa,CAAC;AAClC,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAErD,MAAM,UAAU,GAAG,oBAAoB,OAAO,CAAC,GAAG,CAAC,iBAAiB,IAAI,MAAM,EAAE,CAAC;AACjF,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,cAAc,IAAI,sCAAsC,CAAC;AAEpF;;;;;;;GAOG;AACH,MAAM,UAAU,WAAW;IACzB,OAAO,OAAO,CAAC,GAAG,CAAC,qBAAqB,IAAI,EAAE,CAAC,QAAQ,EAAE,CAAC;AAC5D,CAAC;AACD,MAAM,YAAY,GAAG,MAAM,CAAC;AAC5B,MAAM,aAAa,GAAG,MAAM,CAAC;AAC7B,MAAM,cAAc,GAAG,CAAC,GAAG,MAAM,CAAC;AAYlC,SAAS,aAAa;IACpB,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,YAAY,CAAC;IACrC,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,oBAAoB,CAAC;IAC7C,IAAI,CAAC,GAAG,IAAI,CAAC,GAAG;QAAE,OAAO,IAAI,CAAC;IAC9B,OAAO,YAAY,CAAC,GAAG,EAAE,GAAG,EAAE;QAC5B,IAAI,EAAE,EAAE,cAAc,EAAE,KAAK,EAAE,gBAAgB,EAAE,KAAK,EAAE;QACxD,EAAE,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE;KACrB,CAAC,CAAC;AACL,CAAC;AAGD,KAAK,UAAU,UAAU;IACvB,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,GAAG,UAAU,aAAa,EAAE;YAClD,MAAM,EAAE,MAAM;YACd,OAAO,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE;YAC/C,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,YAAY,EAAE,kBAAkB,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC;YAC5E,MAAM,EAAE,WAAW,CAAC,OAAO,CAAC,IAAI,CAAC;SAClC,CAAC,CAAC;QACH,IAAI,CAAC,GAAG,CAAC,EAAE;YAAE,OAAO,EAAE,CAAC;QACvB,OAAO,CAAC,MAAM,GAAG,CAAC,IAAI,EAAE,CAAiB,CAAC;IAC5C,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAC;IACZ,CAAC;AACH,CAAC;AAED,6EAA6E;AAC7E,2DAA2D;AAC3D,IAAI,UAAU,GAA+B,IAAI,CAAC;AAClD,KAAK,UAAU,YAAY,CAAC,MAAgB;IAC1C,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,MAAM,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;IAC5F,MAAM,CAAC,GAAG,IAAI,GAAG,EAAkB,CAAC;IACpC,IAAI,CAAC,KAAK,IAAI,IAAI;QAAE,KAAK,MAAM,CAAC,IAAI,IAA0C;YAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC;IACnG,OAAO,CAAC,CAAC;AACX,CAAC;AACD,KAAK,UAAU,gBAAgB,CAAC,MAAgB,EAAE,GAAW;IAC3D,MAAM,GAAG,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,IAAI,EAAE,CAAC,CAAC;IACrC,IAAI,CAAC,GAAG;QAAE,OAAO,IAAI,CAAC;IACtB,IAAI,CAAC,UAAU;QAAE,UAAU,GAAG,MAAM,YAAY,CAAC,MAAM,CAAC,CAAC;IACzD,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,GAAG,CAAC;QAAE,UAAU,GAAG,MAAM,YAAY,CAAC,MAAM,CAAC,CAAC,CAAC,uBAAuB;IAC1F,OAAO,UAAU,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,IAAI,CAAC;AACrC,CAAC;AAED,KAAK,UAAU,IAAI,CAAC,MAAgB;IAClC,MAAM,IAAI,GAAG,WAAW,EAAE,CAAC;IAC3B,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IACzB,MAAM,MAAM,GAAG,IAAI,IAAI,CAAC,KAAK,CAAC,CAAC,WAAW,EAAE,CAAC;IAE7C,MAAM,KAAK,GAAG,MAAM,UAAU,EAAE,CAAC;IACjC,KAAK,MAAM,CAAC,IAAI,KAAK,EAAE,CAAC;QACtB,IAAI,CAAC,CAAC,CAAC,EAAE;YAAE,SAAS;QACpB,MAAM,UAAU,GAAG,MAAM,gBAAgB,CAAC,MAAM,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC;QACzD,MAAM,GAAG,GAAG;YACV,MAAM,EAAE,MAAM;YACd,IAAI;YACJ,WAAW,EAAE,CAAC,CAAC,EAAE;YACjB,KAAK,EAAE,IAAqB;YAC5B,4EAA4E;YAC5E,4EAA4E;YAC5E,OAAO,EAAE,aAAa;YACtB,OAAO,EAAE,CAAC,CAAC,OAAO,IAAI,IAAI;YAC1B,GAAG,EAAE,CAAC,CAAC,GAAG,IAAI,IAAI;YAClB,UAAU;YACV,MAAM,EAAE,QAAQ;YAChB,UAAU,EAAE,CAAC,CAAC,aAAa,IAAI,MAAM;YACrC,YAAY,EAAE,MAAM;YACpB,QAAQ,EAAE,IAAqB;YAC/B,+EAA+E;YAC/E,8EAA8E;YAC9E,mEAAmE;YACnE,IAAI,EAAE,EAAE,cAAc,EAAE,CAAC,CAAC,SAAS,IAAI,MAAM,EAAE;SAChD,CAAC;QACF,MAAM,EAAE,KAAK,EAAE,GAAG,MAAM,eAAe,CACrC,GAAG,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC,MAAM,CAAC,GAAG,EAAE,EAAE,UAAU,EAAE,yBAAyB,EAAE,CAAC,EAC1F,mBAAmB,CAAC,CAAC,EAAE,EAAE,CAC1B,CAAC;QACF,IAAI,KAAK;YAAE,GAAG,CAAC,oBAAoB,CAAC,CAAC,EAAE,YAAY,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;IACtE,CAAC;IAED,kFAAkF;IAClF,+EAA+E;IAC/E,6CAA6C;IAC7C,MAAM,OAAO,GAAG,IAAI,IAAI,CAAC,KAAK,GAAG,aAAa,CAAC,CAAC,WAAW,EAAE,CAAC;IAC9D,MAAM,QAAQ,GAAG,IAAI,IAAI,CAAC,KAAK,GAAG,cAAc,CAAC,CAAC,WAAW,EAAE,CAAC;IAChE,MAAM,MAAM,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC;SAC3D,EAAE,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC,EAAE,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC,EAAE,CAAC,cAAc,EAAE,OAAO,CAAC,CAAC;IAC3E,MAAM,MAAM,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,CAAC;SAC9E,EAAE,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC,GAAG,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC,EAAE,CAAC,cAAc,EAAE,QAAQ,CAAC,CAAC;AAC9E,CAAC;AA6BD,8EAA8E;AAC9E,+EAA+E;AAC/E,8EAA8E;AAC9E,gFAAgF;AAChF,iFAAiF;AACjF,+EAA+E;AAC/E,kFAAkF;AAClF,iFAAiF;AACjF,yEAAyE;AAEzE,MAAM,UAAU,GAAG,EAAE,KAAK,EAAE,GAAG,EAAE,OAAO,EAAE,GAAG,EAAE,GAAG,EAAE,IAAI,EAAW,CAAC;AACpE,MAAM,cAAc,GAAG,IAAI,CAAC;AAC5B,MAAM,cAAc,GAAG,IAAI,CAAC;AAC5B,mFAAmF;AACnF,4CAA4C;AAC5C,MAAM,aAAa,GAAG,iDAAiD,CAAC;AAExE,+EAA+E;AAC/E,MAAM,UAAU,YAAY,CAAC,CAA4B,EAAE,MAAc;IACvE,IAAI,CAAC,IAAI,IAAI;QAAE,OAAO,IAAI,CAAC;IAC3B,MAAM,OAAO,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,aAAa,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC;IACtE,OAAO,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC;AACzC,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,YAAY,CAAC,IAAyC;IACpE,IAAI,CAAC,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ;QAAE,OAAO,EAAE,CAAC;IACjD,MAAM,GAAG,GAA4B,EAAE,CAAC;IACxC,KAAK,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;QAC1C,IAAI,OAAO,CAAC,KAAK,QAAQ;YAAE,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC,aAAa,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,cAAc,CAAC,CAAC;aACrF,IAAI,OAAO,CAAC,KAAK,QAAQ,IAAI,OAAO,CAAC,KAAK,SAAS,IAAI,CAAC,KAAK,IAAI;YAAE,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;QACnF,8CAA8C;IAChD,CAAC;IACD,IAAI,MAAM,CAAC,UAAU,CAAC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,GAAG,cAAc;QAAE,OAAO,EAAE,CAAC;IACvE,OAAO,GAAG,CAAC;AACb,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAAC,GAA2B;IACtE,MAAM,MAAM,GAAG,aAAa,EAAE,CAAC;IAC/B,IAAI,CAAC,MAAM;QAAE,OAAO,KAAK,CAAC;IAC1B,IAAI,CAAC,GAAG,CAAC,WAAW,IAAI,CAAC,GAAG,CAAC,OAAO;QAAE,OAAO,KAAK,CAAC;IAEnD,MAAM,IAAI,GAAG,WAAW,EAAE,CAAC;IAC3B,MAAM,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IACxC,MAAM,UAAU,GAAG,MAAM,gBAAgB,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,IAAI,EAAE,CAAC,CAAC;IACjE,MAAM,KAAK,GAAG,GAAG,CAAC,MAAM,KAAK,OAAO,CAAC;IACrC,MAAM,GAAG,GAAG;QACV,MAAM,EAAE,MAAM;QACd,IAAI;QACJ,WAAW,EAAE,GAAG,CAAC,WAAW;QAC5B,OAAO,EAAE,GAAG,CAAC,OAAO;QACpB,8EAA8E;QAC9E,4EAA4E;QAC5E,KAAK,EAAE,YAAY,CAAC,GAAG,CAAC,KAAK,EAAE,UAAU,CAAC,KAAK,CAAC;QAChD,OAAO,EAAE,YAAY,CAAC,GAAG,CAAC,OAAO,EAAE,UAAU,CAAC,OAAO,CAAC;QACtD,GAAG,EAAE,YAAY,CAAC,GAAG,CAAC,GAAG,EAAE,UAAU,CAAC,GAAG,CAAC;QAC1C,UAAU;QACV,MAAM,EAAE,KAAK,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,QAAQ;QAClC,UAAU,EAAE,MAAM;QAClB,YAAY,EAAE,MAAM;QACpB,QAAQ,EAAE,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI;QAC/B,+EAA+E;QAC/E,4EAA4E;QAC5E,IAAI,EAAE,EAAE,cAAc,EAAE,MAAM,EAAE,GAAG,YAAY,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE;KAC5D,CAAC;IACF,kFAAkF;IAClF,uFAAuF;IACvF,MAAM,EAAE,KAAK,EAAE,GAAG,MAAM,eAAe,CACrC,GAAG,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC,MAAM,CAAC,GAAG,EAAE,EAAE,UAAU,EAAE,yBAAyB,EAAE,CAAC,EAC1F,2BAA2B,GAAG,CAAC,WAAW,EAAE,CAC7C,CAAC;IACF,IAAI,KAAK,EAAE,CAAC;QACV,GAAG,CAAC,4BAA4B,GAAG,CAAC,WAAW,KAAK,GAAG,CAAC,OAAO,aAAa,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;QAC7F,OAAO,KAAK,CAAC;IACf,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,gGAAgG;AAChG,MAAM,UAAU,mBAAmB;IACjC,MAAM,MAAM,GAAG,aAAa,EAAE,CAAC;IAC/B,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,GAAG,CAAC,8EAA8E,CAAC,CAAC;QACpF,OAAO,GAAG,EAAE,GAAE,CAAC,CAAC;IAClB,CAAC;IACD,GAAG,CAAC,oEAAoE,MAAM,IAAI,CAAC,CAAC;IACpF,MAAM,GAAG,GAAG,GAAG,EAAE;QACf,IAAI,CAAC,MAAM,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,yBAAyB,CAAC,YAAY,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IACxG,CAAC,CAAC;IACF,GAAG,EAAE,CAAC;IACN,MAAM,EAAE,GAAG,WAAW,CAAC,GAAG,EAAE,YAAY,CAAC,CAAC;IAC1C,IAAI,OAAQ,EAA6B,CAAC,KAAK,KAAK,UAAU;QAAG,EAA4B,CAAC,KAAK,EAAE,CAAC;IACtG,OAAO,GAAG,EAAE,CAAC,aAAa,CAAC,EAAE,CAAC,CAAC;AACjC,CAAC"}
+{"version":3,"file":"agentPresence.js","sourceRoot":"","sources":["../src/agentPresence.ts"],"names":[],"mappings":"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"}

package/dist/agentic/index.d.ts

@@ -1,14 +1,24 @@
 /**
- * Agentic Pack Engine - MCP Tool Registration
+ * Agentic Pack Engine — module surface.
  *
- * Exposes the 4 core agentic tools via MCP:
- * 1. agentic.compile_pack - Compile configuration into versioned pack
- * 2. agentic.render - Transform payload to text
- * 3. agentic.lint - Validate output against constraints
- * 4. agentic.golden_eval - Run regression tests
+ * The engine itself lives in sibling modules: compiler (config → versioned,
+ * hashed pack), renderer (payload → text via pack templates), linter (output vs
+ * pack constraints), golden (regression harness). This file only re-exports
+ * them, and is imported by src/tools/agentic/index.ts, which is what actually
+ * exposes the tools.
+ *
+ * It used to also carry registerAgenticTools(server: McpServer) and the zod
+ * schemas that function validated its inputs with. That registration path died
+ * when server.ts was split into modules (ISS-0029): nothing called it, so its
+ * validation validated nothing — while still typechecking and importing
+ * cleanly, which is why it went unnoticed for 7.7 months and ~98k dispatch
+ * events. The schemas moved to types.ts, beside the interfaces they mirror,
+ * and are wired into the live handlers.
+ *
+ * The file is load-bearing even though the function was not: the live tools
+ * import compilePack/renderPayload/lintOutput/runGolden and their input types
+ * through the re-exports below. Deleting it breaks them at import time.
  */
-import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
-export declare function registerAgenticTools(server: McpServer): void;
 export * from './types.js';
 export { compilePack, loadCompiledPack, getOrCompilePack } from './compiler.js';
 export { render, renderPayload } from './renderer.js';

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/agentic/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AA0EpE,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CA8G5D;AAGD,cAAc,YAAY,CAAC;AAC3B,OAAO,EAAE,WAAW,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAChF,OAAO,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AACtD,OAAO,EAAE,IAAI,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAC7D,OAAO,EAAE,aAAa,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/agentic/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,cAAc,YAAY,CAAC;AAC3B,OAAO,EAAE,WAAW,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAChF,OAAO,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AACtD,OAAO,EAAE,IAAI,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAC7D,OAAO,EAAE,aAAa,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC"}