@namzu/sdk 0.4.3 → 0.4.4

package/CHANGELOG.md

@@ -1,5 +1,41 @@
 # Changelog
 
+## 0.4.4
+
+### Patch Changes
+
+- ffe516c: Probe layer (typed observation + narrow veto) over AgentBus + RunEvent stream — ses_007 phases 0–3.
+
+  Public surface additions:
+
+  - **Typed probe observation.** `probe.on(kind | kind[], handler, opts?)` registers a typed handler scoped to one or more event kinds. `probe.onAny(handler, opts?)` is the catch-all tier preserving legacy `AgentBus.on` semantics. Options: `{ where, priority, name, override }`. Events are frozen at the registry boundary; throws are isolated per probe.
+  - **Narrow veto on tool execution.** `probe.veto('tool_executing', handler, opts?)` registers a veto handler. Handler returns `'allow' | 'deny' | { action: 'deny', reason }`. `VetoableEventKind = 'tool_executing'` in v1 (additive minor adds more kinds later). First-deny wins by ascending priority; subsequent veto handlers still fire for audit. Tool executor short-circuits before `tools.execute(...)` on deny: returns a synthetic tool failure carrying `ProbeVetoError.message` so the LLM sees a normal tool-call failure with the probe name + reason.
+  - **5 new bus event variants.** `provider_call_start`, `provider_call_completed`, `provider_call_failed`, `vault_lookup`, `sandbox_decision`. Joined to the existing `AgentBusEvent` discriminated union. Snake_case real discriminants — no rename pass on existing events.
+  - **Opt-in instrumentation wrappers.** `wrapProviderWithProbes(provider, opts?)` returns an `LLMProvider` that emits `provider_call_*` around every `chat`/`chatStream` call (correlated by a `pcall_${string}` callId, with optional usage telemetry). `wrapVaultWithProbes(vault, opts?)` emits `vault_lookup` on every `retrieve()`; the secret value is never included in the event payload (covered by a "no leakage" test).
+  - **First-time public exposure of bus event types.** `AgentBusEvent`, `AgentBusEventListener`, `CircuitBreakerSnapshot`, `FileLock`, etc. were already reachable via `AgentBus.on(listener)` at runtime but couldn't be statically typed by consumers. Now in `public-types.ts`. Pre-existing duplicate `LockId` declaration in `types/bus/` was deduplicated to a re-export from `types/ids/` in passing.
+  - **Replay-aware probe context.** `ProbeContext.isReplay: boolean` flag wired through `buildProbeContext({ runId?, isReplay? })` so probes that bill or call external services can opt out on replayed runs (`ctx.isReplay === true`). Replay-execution wiring lands in a future session; the accessor is ready.
+
+  Integration:
+
+  - `AgentBus.emit` dispatches through `ProbeRegistry` first (typed-priority probes → legacy `bus.on` listeners → `onAny` catch-all). Existing `bus.on(listener)` consumers see every event in unchanged relative order.
+  - `EventTranslator.emitEvent` dispatches every `RunEvent` through the same registry before the existing pendingEvents push + persist flow.
+  - `ToolExecutor.executeSingle` calls `probes.queryVeto({type: 'tool_executing', ...})` immediately after the existing `tool_executing` emit, before `tools.execute(...)`.
+
+  Not yet wired (follow-up commits):
+
+  - Per-run probes via `createRun({ probes: [...] })` — the registry has the foundation; createRun plumbing lands in a follow-up.
+  - `wrapProviderWithProbes` / `wrapVaultWithProbes` are opt-in helpers; the SDK's own `ProviderRegistry` does not auto-wrap registered providers yet.
+  - `sandbox_decision` ships as a type only; emit site lands when a real sandbox provider exists (current `LocalSandboxProvider` is a stub).
+
+  Public surface delta: `380 → 392` runtime keys (verified against the regenerated baseline). Net new symbols added by this changeset:
+
+  - `probe`, `ProbeRegistry`, `createProbeRegistry`, `buildProbeContext`, `ProbeNameCollisionError`, `ProbeVetoError`
+  - `wrapProviderWithProbes`, `wrapVaultWithProbes`
+
+  Non-runtime (types-only) additions: `ProbeEventKind`, `ProbeEventOf<K>`, `ProbeContext`, `ProbeHandler<K>`, `ProbeOptions<K>`, `Unsubscribe`, `VetoableEventKind`, `VetoDecision`, `VetoHandler<K>`, `VetoOutcome`, `DoctorStatus`, `DoctorCategory`, `DoctorCheck`, `DoctorCheckContext`, `DoctorCheckResult`, `DoctorCheckRecord`, `DoctorReport`, `ProviderCallId`, `ProviderCallUsage`, `SandboxDecisionAction`, plus first-time exposure of all `AgentBusEvent` shape types.
+
+  Doctor types ship in this release; the runtime registry + CLI command land in a subsequent ses_007 patch.
+
 ## 0.4.3
 
 ### Patch Changes

package/dist/bridge/tools/connector/adapter.d.ts

@@ -12,13 +12,13 @@ declare const ConnectorRouterInputSchema: z.ZodObject<{
     method: z.ZodString;
     input: z.ZodRecord<z.ZodString, z.ZodUnknown>;
 }, "strip", z.ZodTypeAny, {
-    method: string;
     input: Record<string, unknown>;
+    method: string;
     connectorId: string;
     instanceId: string;
 }, {
-    method: string;
     input: Record<string, unknown>;
+    method: string;
     connectorId: string;
     instanceId: string;
 }>;

package/dist/bus/index.d.ts

@@ -1,3 +1,4 @@
+import { type ProbeRegistry } from '../probe/registry.js';
 import type { AgentBusEventListener } from '../types/bus/index.js';
 import type { RunId } from '../types/ids/index.js';
 import type { Logger } from '../utils/logger.js';
@@ -19,7 +20,8 @@ export declare class AgentBus {
     private readonly listeners;
     private readonly log;
     private readonly config;
-    constructor(log: Logger, config?: Partial<AgentBusConfig>);
+    private readonly probes;
+    constructor(log: Logger, config?: Partial<AgentBusConfig>, probeRegistry?: ProbeRegistry);
     on(listener: AgentBusEventListener): () => void;
     private emit;
     cleanupAgent(runId: RunId): void;

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/bus/index.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAiB,qBAAqB,EAAE,MAAM,uBAAuB,CAAA;AACjF,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,uBAAuB,CAAA;AAClD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAA;AAEhD,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAA;AAC7C,OAAO,EAAE,eAAe,EAAE,MAAM,WAAW,CAAA;AAC3C,OAAO,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAA;AAErD,MAAM,WAAW,cAAc;IAC9B,OAAO,EAAE,OAAO,CAAA;IAChB,aAAa,EAAE,MAAM,CAAA;IACrB,oBAAoB,EAAE,MAAM,CAAA;IAC5B,gBAAgB,EAAE,MAAM,CAAA;IACxB,uBAAuB,EAAE,MAAM,CAAA;IAC/B,qBAAqB,EAAE,MAAM,CAAA;CAC7B;AAWD,qBAAa,QAAQ;IACpB,QAAQ,CAAC,KAAK,EAAE,eAAe,CAAA;IAC/B,QAAQ,CAAC,SAAS,EAAE,oBAAoB,CAAA;IACxC,QAAQ,CAAC,OAAO,EAAE,cAAc,CAAA;IAEhC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAwC;IAClE,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAQ;IAC5B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAgB;gBAE3B,GAAG,EAAE,MAAM,EAAE,MAAM,GAAE,OAAO,CAAC,cAAc,CAAM;IAsB7D,EAAE,CAAC,QAAQ,EAAE,qBAAqB,GAAG,MAAM,IAAI;IAO/C,OAAO,CAAC,IAAI;IAaZ,YAAY,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI;IAahC,WAAW,IAAI,IAAI;CAMnB;AAED,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAA;AAC7C,OAAO,EAAE,eAAe,EAAE,MAAM,WAAW,CAAA;AAC3C,YAAY,EAAE,qBAAqB,EAAE,MAAM,WAAW,CAAA;AACtD,OAAO,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAA;AACrD,YAAY,EACX,aAAa,EACb,qBAAqB,EACrB,sBAAsB,EACtB,mBAAmB,EACnB,QAAQ,EACR,aAAa,EACb,iBAAiB,EACjB,MAAM,EACN,oBAAoB,GACpB,MAAM,uBAAuB,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/bus/index.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,KAAK,aAAa,EAAiC,MAAM,sBAAsB,CAAA;AACxF,OAAO,KAAK,EAAiB,qBAAqB,EAAE,MAAM,uBAAuB,CAAA;AACjF,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,uBAAuB,CAAA;AAClD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAA;AAEhD,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAA;AAC7C,OAAO,EAAE,eAAe,EAAE,MAAM,WAAW,CAAA;AAC3C,OAAO,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAA;AAErD,MAAM,WAAW,cAAc;IAC9B,OAAO,EAAE,OAAO,CAAA;IAChB,aAAa,EAAE,MAAM,CAAA;IACrB,oBAAoB,EAAE,MAAM,CAAA;IAC5B,gBAAgB,EAAE,MAAM,CAAA;IACxB,uBAAuB,EAAE,MAAM,CAAA;IAC/B,qBAAqB,EAAE,MAAM,CAAA;CAC7B;AAWD,qBAAa,QAAQ;IACpB,QAAQ,CAAC,KAAK,EAAE,eAAe,CAAA;IAC/B,QAAQ,CAAC,SAAS,EAAE,oBAAoB,CAAA;IACxC,QAAQ,CAAC,OAAO,EAAE,cAAc,CAAA;IAEhC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAwC;IAClE,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAQ;IAC5B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAgB;IACvC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAe;gBAGrC,GAAG,EAAE,MAAM,EACX,MAAM,GAAE,OAAO,CAAC,cAAc,CAAM,EACpC,aAAa,GAAE,aAAoC;IAyBpD,EAAE,CAAC,QAAQ,EAAE,qBAAqB,GAAG,MAAM,IAAI;IAO/C,OAAO,CAAC,IAAI;IAeZ,YAAY,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI;IAahC,WAAW,IAAI,IAAI;CAMnB;AAED,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAA;AAC7C,OAAO,EAAE,eAAe,EAAE,MAAM,WAAW,CAAA;AAC3C,YAAY,EAAE,qBAAqB,EAAE,MAAM,WAAW,CAAA;AACtD,OAAO,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAA;AACrD,YAAY,EACX,aAAa,EACb,qBAAqB,EACrB,sBAAsB,EACtB,mBAAmB,EACnB,QAAQ,EACR,aAAa,EACb,iBAAiB,EACjB,MAAM,EACN,oBAAoB,GACpB,MAAM,uBAAuB,CAAA"}

package/dist/bus/index.js

@@ -1,4 +1,6 @@
 import { DEFAULT_BREAKER_FAILURE_THRESHOLD, DEFAULT_BREAKER_RESET_TIMEOUT_MS, DEFAULT_LOCK_ACQUIRE_TIMEOUT_MS, DEFAULT_LOCK_TIMEOUT_MS, DEFAULT_MAX_LOCKS_PER_AGENT, } from '../constants/bus/index.js';
+import { buildProbeContext } from '../probe/context.js';
+import { probe as defaultProbeRegistry } from '../probe/registry.js';
 import { CircuitBreaker } from './breaker.js';
 import { FileLockManager } from './lock.js';
 import { EditOwnershipTracker } from './ownership.js';
@@ -17,9 +19,12 @@ export class AgentBus {
     listeners = new Set();
     log;
     config;
-    constructor(log, config = {}) {
+    probes;
+    constructor(log, config = {}, probeRegistry = defaultProbeRegistry) {
         this.config = { ...DEFAULT_AGENT_BUS_CONFIG, ...config };
         this.log = log.child({ component: 'AgentBus' });
+        this.probes = probeRegistry;
+        this.probes.setLogger(log);
         const emitFn = (event) => this.emit(event);
         this.locks = new FileLockManager(this.log, emitFn, {
             lockTimeoutMs: this.config.lockTimeoutMs,
@@ -36,17 +41,19 @@ export class AgentBus {
         };
     }
     emit(event) {
-        for (const listener of this.listeners) {
-            try {
-                listener(event);
+        this.probes.dispatch(event, buildProbeContext(), () => {
+            for (const listener of this.listeners) {
+                try {
+                    listener(event);
+                }
+                catch (error) {
+                    this.log.error('event listener threw', {
+                        eventType: event.type,
+                        error: error instanceof Error ? error.message : String(error),
+                    });
+                }
             }
-            catch (error) {
-                this.log.error('event listener threw', {
-                    eventType: event.type,
-                    error: error instanceof Error ? error.message : String(error),
-                });
-            }
-        }
+        });
     }
     cleanupAgent(runId) {
         this.log.info('cleaning up agent resources', { runId });

package/dist/bus/index.js.map

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

package/dist/config/runtime.d.ts

@@ -294,6 +294,20 @@ export declare const RuntimeConfigSchema: z.ZodObject<{
     tokenBudget: number;
     maxResponseTokens: number;
     maxIterations: number;
+    sandbox?: {
+        enabled: boolean;
+        provider: "local";
+        timeoutMs: number;
+        memoryLimitMb: number;
+        maxProcesses: number;
+        cleanupOnDestroy: boolean;
+    } | undefined;
+    plugins?: {
+        enabled: boolean;
+        autoDiscovery: boolean;
+        allowedScopes: ("user" | "project")[];
+        hookTimeoutMs: number;
+    } | undefined;
     taskRouter?: {
         default?: string | null | undefined;
         compaction?: string | null | undefined;
@@ -315,20 +329,6 @@ export declare const RuntimeConfigSchema: z.ZodObject<{
         enabled: boolean;
         strategy: "auto" | "disabled";
     } | undefined;
-    plugins?: {
-        enabled: boolean;
-        autoDiscovery: boolean;
-        allowedScopes: ("user" | "project")[];
-        hookTimeoutMs: number;
-    } | undefined;
-    sandbox?: {
-        enabled: boolean;
-        provider: "local";
-        timeoutMs: number;
-        memoryLimitMb: number;
-        maxProcesses: number;
-        cleanupOnDestroy: boolean;
-    } | undefined;
 }, {
     timeoutMs?: number | undefined;
     compaction?: {
@@ -351,6 +351,20 @@ export declare const RuntimeConfigSchema: z.ZodObject<{
     temperature?: number | undefined;
     tokenBudget?: number | undefined;
     maxResponseTokens?: number | undefined;
+    sandbox?: {
+        enabled?: boolean | undefined;
+        provider?: "local" | undefined;
+        timeoutMs?: number | undefined;
+        memoryLimitMb?: number | undefined;
+        maxProcesses?: number | undefined;
+        cleanupOnDestroy?: boolean | undefined;
+    } | undefined;
+    plugins?: {
+        enabled?: boolean | undefined;
+        autoDiscovery?: boolean | undefined;
+        allowedScopes?: ("user" | "project")[] | undefined;
+        hookTimeoutMs?: number | undefined;
+    } | undefined;
     maxIterations?: number | undefined;
     taskRouter?: {
         default?: string | null | undefined;
@@ -373,20 +387,6 @@ export declare const RuntimeConfigSchema: z.ZodObject<{
         enabled?: boolean | undefined;
         strategy?: "auto" | "disabled" | undefined;
     } | undefined;
-    plugins?: {
-        enabled?: boolean | undefined;
-        autoDiscovery?: boolean | undefined;
-        allowedScopes?: ("user" | "project")[] | undefined;
-        hookTimeoutMs?: number | undefined;
-    } | undefined;
-    sandbox?: {
-        enabled?: boolean | undefined;
-        provider?: "local" | undefined;
-        timeoutMs?: number | undefined;
-        memoryLimitMb?: number | undefined;
-        maxProcesses?: number | undefined;
-        cleanupOnDestroy?: boolean | undefined;
-    } | undefined;
 }>;
 export type RuntimeConfig = z.infer<typeof RuntimeConfigSchema>;
 export declare const RUNTIME_DEFAULTS: Readonly<RuntimeConfig>;

package/dist/probe/context.d.ts

@@ -0,0 +1,8 @@
+import type { RunId } from '../types/ids/index.js';
+import type { ProbeContext } from '../types/probe/index.js';
+export interface ProbeContextInput {
+    readonly runId?: RunId;
+    readonly isReplay?: boolean;
+}
+export declare function buildProbeContext(input?: ProbeContextInput): ProbeContext;
+//# sourceMappingURL=context.d.ts.map

package/dist/probe/context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../src/probe/context.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,uBAAuB,CAAA;AAClD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAA;AAE3D,MAAM,WAAW,iBAAiB;IACjC,QAAQ,CAAC,KAAK,CAAC,EAAE,KAAK,CAAA;IACtB,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAA;CAC3B;AAED,wBAAgB,iBAAiB,CAAC,KAAK,GAAE,iBAAsB,GAAG,YAAY,CAK7E"}

package/dist/probe/context.js

@@ -0,0 +1,7 @@
+export function buildProbeContext(input = {}) {
+    return Object.freeze({
+        runId: input.runId,
+        isReplay: input.isReplay ?? false,
+    });
+}
+//# sourceMappingURL=context.js.map

package/dist/probe/context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.js","sourceRoot":"","sources":["../../src/probe/context.ts"],"names":[],"mappings":"AAQA,MAAM,UAAU,iBAAiB,CAAC,QAA2B,EAAE;IAC9D,OAAO,MAAM,CAAC,MAAM,CAAC;QACpB,KAAK,EAAE,KAAK,CAAC,KAAK;QAClB,QAAQ,EAAE,KAAK,CAAC,QAAQ,IAAI,KAAK;KACjC,CAAC,CAAA;AACH,CAAC"}

package/dist/probe/errors.d.ts

@@ -0,0 +1,12 @@
+import type { VetoableEventKind } from '../types/probe/index.js';
+export declare class ProbeNameCollisionError extends Error {
+    readonly probeName: string;
+    constructor(probeName: string);
+}
+export declare class ProbeVetoError extends Error {
+    readonly probeName: string;
+    readonly reason: string;
+    readonly eventKind: VetoableEventKind;
+    constructor(probeName: string, reason: string, eventKind: VetoableEventKind);
+}
+//# sourceMappingURL=errors.d.ts.map

package/dist/probe/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/probe/errors.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAA;AAEhE,qBAAa,uBAAwB,SAAQ,KAAK;IACjD,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;gBAEd,SAAS,EAAE,MAAM;CAO7B;AAED,qBAAa,cAAe,SAAQ,KAAK;IACxC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;IAC1B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,SAAS,EAAE,iBAAiB,CAAA;gBAEzB,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,iBAAiB;CAO3E"}

package/dist/probe/errors.js

@@ -0,0 +1,21 @@
+export class ProbeNameCollisionError extends Error {
+    probeName;
+    constructor(probeName) {
+        super(`Probe name "${probeName}" is already registered. Pass { override: true } to replace, or pick a different name.`);
+        this.name = 'ProbeNameCollisionError';
+        this.probeName = probeName;
+    }
+}
+export class ProbeVetoError extends Error {
+    probeName;
+    reason;
+    eventKind;
+    constructor(probeName, reason, eventKind) {
+        super(`Operation denied by probe "${probeName}" on ${eventKind}: ${reason}`);
+        this.name = 'ProbeVetoError';
+        this.probeName = probeName;
+        this.reason = reason;
+        this.eventKind = eventKind;
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/probe/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/probe/errors.ts"],"names":[],"mappings":"AAEA,MAAM,OAAO,uBAAwB,SAAQ,KAAK;IACxC,SAAS,CAAQ;IAE1B,YAAY,SAAiB;QAC5B,KAAK,CACJ,eAAe,SAAS,wFAAwF,CAChH,CAAA;QACD,IAAI,CAAC,IAAI,GAAG,yBAAyB,CAAA;QACrC,IAAI,CAAC,SAAS,GAAG,SAAS,CAAA;IAC3B,CAAC;CACD;AAED,MAAM,OAAO,cAAe,SAAQ,KAAK;IAC/B,SAAS,CAAQ;IACjB,MAAM,CAAQ;IACd,SAAS,CAAmB;IAErC,YAAY,SAAiB,EAAE,MAAc,EAAE,SAA4B;QAC1E,KAAK,CAAC,8BAA8B,SAAS,QAAQ,SAAS,KAAK,MAAM,EAAE,CAAC,CAAA;QAC5E,IAAI,CAAC,IAAI,GAAG,gBAAgB,CAAA;QAC5B,IAAI,CAAC,SAAS,GAAG,SAAS,CAAA;QAC1B,IAAI,CAAC,MAAM,GAAG,MAAM,CAAA;QACpB,IAAI,CAAC,SAAS,GAAG,SAAS,CAAA;IAC3B,CAAC;CACD"}

package/dist/probe/index.d.ts

@@ -0,0 +1,5 @@
+export { ProbeNameCollisionError, ProbeVetoError } from './errors.js';
+export { buildProbeContext } from './context.js';
+export type { ProbeContextInput } from './context.js';
+export { ProbeRegistry, createProbeRegistry, probe } from './registry.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/probe/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,uBAAuB,EAAE,cAAc,EAAE,MAAM,aAAa,CAAA;AACrE,OAAO,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAA;AAChD,YAAY,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAA;AACrD,OAAO,EAAE,aAAa,EAAE,mBAAmB,EAAE,KAAK,EAAE,MAAM,eAAe,CAAA"}

package/dist/probe/index.js

@@ -0,0 +1,4 @@
+export { ProbeNameCollisionError, ProbeVetoError } from './errors.js';
+export { buildProbeContext } from './context.js';
+export { ProbeRegistry, createProbeRegistry, probe } from './registry.js';
+//# sourceMappingURL=index.js.map

package/dist/probe/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/probe/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,uBAAuB,EAAE,cAAc,EAAE,MAAM,aAAa,CAAA;AACrE,OAAO,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAA;AAEhD,OAAO,EAAE,aAAa,EAAE,mBAAmB,EAAE,KAAK,EAAE,MAAM,eAAe,CAAA"}

package/dist/probe/registry.d.ts

@@ -0,0 +1,24 @@
+import type { ProbeContext, ProbeEvent, ProbeEventKind, ProbeEventOf, ProbeHandler, ProbeOptions, Unsubscribe, VetoHandler, VetoOutcome, VetoableEventKind } from '../types/probe/index.js';
+import type { Logger } from '../utils/logger.js';
+export declare class ProbeRegistry {
+    private readonly typedByKind;
+    private readonly vetoByKind;
+    private readonly catchAll;
+    private readonly byName;
+    private nextId;
+    private log?;
+    setLogger(log: Logger): void;
+    on<K extends ProbeEventKind>(kind: K | readonly K[], handler: ProbeHandler<K>, opts?: ProbeOptions<K>): Unsubscribe;
+    onAny(handler: (event: ProbeEvent, ctx: ProbeContext) => void, opts?: ProbeOptions): Unsubscribe;
+    dispatch(event: ProbeEvent, ctx: ProbeContext, betweenTier?: () => void): void;
+    veto<K extends VetoableEventKind>(kind: K, handler: VetoHandler<K>, opts?: ProbeOptions<K>): Unsubscribe;
+    queryVeto<K extends VetoableEventKind>(event: ProbeEventOf<K>, ctx: ProbeContext): VetoOutcome;
+    clear(): void;
+    private runTier;
+    private makeEntry;
+    private removeAnywhere;
+    private logThrow;
+}
+export declare const probe: ProbeRegistry;
+export declare function createProbeRegistry(): ProbeRegistry;
+//# sourceMappingURL=registry.d.ts.map

package/dist/probe/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/probe/registry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACX,YAAY,EACZ,UAAU,EACV,cAAc,EACd,YAAY,EACZ,YAAY,EACZ,YAAY,EACZ,WAAW,EAEX,WAAW,EACX,WAAW,EACX,iBAAiB,EACjB,MAAM,yBAAyB,CAAA;AAChC,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAA;AAoEhD,qBAAa,aAAa;IACzB,OAAO,CAAC,QAAQ,CAAC,WAAW,CAA+C;IAC3E,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAiD;IAC5E,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAmB;IAC5C,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAiD;IACxE,OAAO,CAAC,MAAM,CAAI;IAClB,OAAO,CAAC,GAAG,CAAC,CAAQ;IAEpB,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAI5B,EAAE,CAAC,CAAC,SAAS,cAAc,EAC1B,IAAI,EAAE,CAAC,GAAG,SAAS,CAAC,EAAE,EACtB,OAAO,EAAE,YAAY,CAAC,CAAC,CAAC,EACxB,IAAI,GAAE,YAAY,CAAC,CAAC,CAAM,GACxB,WAAW;IAyBd,KAAK,CACJ,OAAO,EAAE,CAAC,KAAK,EAAE,UAAU,EAAE,GAAG,EAAE,YAAY,KAAK,IAAI,EACvD,IAAI,GAAE,YAAiB,GACrB,WAAW;IASd,QAAQ,CAAC,KAAK,EAAE,UAAU,EAAE,GAAG,EAAE,YAAY,EAAE,WAAW,CAAC,EAAE,MAAM,IAAI,GAAG,IAAI;IAa9E,IAAI,CAAC,CAAC,SAAS,iBAAiB,EAC/B,IAAI,EAAE,CAAC,EACP,OAAO,EAAE,WAAW,CAAC,CAAC,CAAC,EACvB,IAAI,GAAE,YAAY,CAAC,CAAC,CAAM,GACxB,WAAW;IAgCd,SAAS,CAAC,CAAC,SAAS,iBAAiB,EAAE,KAAK,EAAE,YAAY,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,YAAY,GAAG,WAAW;IA6B9F,KAAK,IAAI,IAAI;IAOb,OAAO,CAAC,OAAO;IAWf,OAAO,CAAC,SAAS;IAwBjB,OAAO,CAAC,cAAc;IAOtB,OAAO,CAAC,QAAQ;CAQhB;AAED,eAAO,MAAM,KAAK,EAAE,aAAmC,CAAA;AAEvD,wBAAgB,mBAAmB,IAAI,aAAa,CAEnD"}

package/dist/probe/registry.js

@@ -0,0 +1,228 @@
+import { ProbeNameCollisionError } from './errors.js';
+function compareVeto(a, b) {
+    if (a.priority !== b.priority)
+        return a.priority - b.priority;
+    return a.id - b.id;
+}
+function insertSortedVeto(list, entry) {
+    let lo = 0;
+    let hi = list.length;
+    while (lo < hi) {
+        const mid = (lo + hi) >>> 1;
+        if (compareVeto(list[mid], entry) <= 0)
+            lo = mid + 1;
+        else
+            hi = mid;
+    }
+    list.splice(lo, 0, entry);
+}
+function removeVeto(list, entry) {
+    const idx = list.indexOf(entry);
+    if (idx >= 0)
+        list.splice(idx, 1);
+}
+function normalizeDecision(decision) {
+    if (decision === 'allow')
+        return { allow: true };
+    if (decision === 'deny')
+        return { allow: false };
+    return { allow: false, reason: decision.reason };
+}
+function compareEntries(a, b) {
+    if (a.priority !== b.priority)
+        return a.priority - b.priority;
+    return a.id - b.id;
+}
+function insertSorted(list, entry) {
+    let lo = 0;
+    let hi = list.length;
+    while (lo < hi) {
+        const mid = (lo + hi) >>> 1;
+        if (compareEntries(list[mid], entry) <= 0)
+            lo = mid + 1;
+        else
+            hi = mid;
+    }
+    list.splice(lo, 0, entry);
+}
+function removeEntry(list, entry) {
+    const idx = list.indexOf(entry);
+    if (idx >= 0)
+        list.splice(idx, 1);
+}
+export class ProbeRegistry {
+    typedByKind = new Map();
+    vetoByKind = new Map();
+    catchAll = [];
+    byName = new Map();
+    nextId = 1;
+    log;
+    setLogger(log) {
+        this.log = log.child({ component: 'ProbeRegistry' });
+    }
+    on(kind, handler, opts = {}) {
+        const kinds = Array.isArray(kind) ? kind : [kind];
+        const entry = this.makeEntry(handler, opts);
+        for (const k of kinds) {
+            let bucket = this.typedByKind.get(k);
+            if (!bucket) {
+                bucket = [];
+                this.typedByKind.set(k, bucket);
+            }
+            insertSorted(bucket, entry);
+        }
+        return () => {
+            for (const k of kinds) {
+                const bucket = this.typedByKind.get(k);
+                if (bucket)
+                    removeEntry(bucket, entry);
+            }
+            if (entry.name)
+                this.byName.delete(entry.name);
+        };
+    }
+    onAny(handler, opts = {}) {
+        const entry = this.makeEntry(handler, opts);
+        insertSorted(this.catchAll, entry);
+        return () => {
+            removeEntry(this.catchAll, entry);
+            if (entry.name)
+                this.byName.delete(entry.name);
+        };
+    }
+    dispatch(event, ctx, betweenTier) {
+        const frozen = Object.isFrozen(event) ? event : Object.freeze(event);
+        this.runTier(this.typedByKind.get(frozen.type) ?? [], frozen, ctx);
+        if (betweenTier) {
+            try {
+                betweenTier();
+            }
+            catch (error) {
+                this.logThrow('between-tier', frozen.type, error);
+            }
+        }
+        this.runTier(this.catchAll, frozen, ctx);
+    }
+    veto(kind, handler, opts = {}) {
+        if (opts.name !== undefined) {
+            const existing = this.byName.get(opts.name);
+            if (existing && !opts.override) {
+                throw new ProbeNameCollisionError(opts.name);
+            }
+            if (existing && opts.override)
+                this.removeAnywhere(existing);
+        }
+        const entry = {
+            id: this.nextId++,
+            name: opts.name,
+            priority: opts.priority ?? 0,
+            handler: handler,
+            where: opts.where,
+        };
+        let bucket = this.vetoByKind.get(kind);
+        if (!bucket) {
+            bucket = [];
+            this.vetoByKind.set(kind, bucket);
+        }
+        insertSortedVeto(bucket, entry);
+        if (entry.name)
+            this.byName.set(entry.name, entry);
+        return () => {
+            const list = this.vetoByKind.get(kind);
+            if (list)
+                removeVeto(list, entry);
+            if (entry.name)
+                this.byName.delete(entry.name);
+        };
+    }
+    queryVeto(event, ctx) {
+        const wide = event;
+        const frozen = Object.isFrozen(wide) ? wide : Object.freeze(wide);
+        const bucket = this.vetoByKind.get(frozen.type);
+        if (!bucket || bucket.length === 0)
+            return { action: 'allow' };
+        let firstDeny;
+        for (const entry of bucket) {
+            if (entry.where && !entry.where(frozen))
+                continue;
+            let decision;
+            try {
+                decision = entry.handler(frozen, ctx);
+            }
+            catch (error) {
+                this.logThrow(entry.name ?? 'unnamed', frozen.type, error);
+                continue;
+            }
+            const normalized = normalizeDecision(decision);
+            if (!normalized.allow && firstDeny === undefined) {
+                firstDeny = {
+                    action: 'deny',
+                    probeName: entry.name,
+                    reason: normalized.reason,
+                };
+            }
+        }
+        return firstDeny ?? { action: 'allow' };
+    }
+    clear() {
+        this.typedByKind.clear();
+        this.vetoByKind.clear();
+        this.catchAll.length = 0;
+        this.byName.clear();
+    }
+    runTier(entries, event, ctx) {
+        for (const entry of entries) {
+            if (entry.where && !entry.where(event))
+                continue;
+            try {
+                entry.handler(event, ctx);
+            }
+            catch (error) {
+                this.logThrow(entry.name ?? 'unnamed', event.type, error);
+            }
+        }
+    }
+    makeEntry(handler, opts) {
+        if (opts.name !== undefined) {
+            const existing = this.byName.get(opts.name);
+            if (existing && !opts.override) {
+                throw new ProbeNameCollisionError(opts.name);
+            }
+            if (existing && opts.override)
+                this.removeAnywhere(existing);
+        }
+        const entry = {
+            id: this.nextId++,
+            name: opts.name,
+            priority: opts.priority ?? 0,
+            handler,
+            where: opts.where,
+        };
+        if (entry.name)
+            this.byName.set(entry.name, entry);
+        return entry;
+    }
+    removeAnywhere(entry) {
+        for (const bucket of this.typedByKind.values())
+            removeEntry(bucket, entry);
+        removeEntry(this.catchAll, entry);
+        for (const bucket of this.vetoByKind.values())
+            removeVeto(bucket, entry);
+        if (entry.name)
+            this.byName.delete(entry.name);
+    }
+    logThrow(probeName, eventType, error) {
+        if (!this.log)
+            return;
+        this.log.error('probe handler threw', {
+            probeName,
+            eventType,
+            error: error instanceof Error ? error.message : String(error),
+        });
+    }
+}
+export const probe = new ProbeRegistry();
+export function createProbeRegistry() {
+    return new ProbeRegistry();
+}
+//# sourceMappingURL=registry.js.map

package/dist/probe/registry.js.map

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

package/dist/probe/registry.test.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Ratified §9 of docs.local/sessions/ses_007-probe-and-doctor/design.md.
+ * These tests pin the contract documented there — not an internal
+ * implementation detail. If the semantics change, update §9 first.
+ */
+export {};
+//# sourceMappingURL=registry.test.d.ts.map

package/dist/probe/registry.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.test.d.ts","sourceRoot":"","sources":["../../src/probe/registry.test.ts"],"names":[],"mappings":"AAAA;;;;GAIG"}