@tangle-network/agent-runtime 0.108.1 → 0.109.1

package/dist/runtime-hooks-C7iJOWm3.js

@@ -0,0 +1,99 @@
+//#region src/runtime-hooks.ts
+/** Identity helper that types a {@link RuntimeHooks} literal so the fields are inferred. */
+function defineRuntimeHooks(hooks) {
+	return hooks;
+}
+/**
+* Merge several {@link RuntimeHooks} into one. Falsy entries are dropped (so you can
+* pass `flag && hooks`), and every observer's `onEvent`/`onDecisionPoint` fires for each
+* event. Use this to attach N observers to a loop instead of a second event bus.
+*/
+function composeRuntimeHooks(...entries) {
+	const hooks = entries.filter((entry) => !!entry);
+	return {
+		onEvent: hooks.some((hook) => hook.onEvent) ? (event, context) => {
+			const pending = [];
+			for (const hook of hooks) {
+				const result = hook.onEvent?.(event, context);
+				if (isThenable(result)) pending.push(Promise.resolve(result));
+			}
+			if (pending.length > 0) return Promise.all(pending).then(() => void 0);
+		} : void 0,
+		onDecisionPoint: hooks.some((hook) => hook.onDecisionPoint) ? (point, context) => {
+			const pending = [];
+			for (const hook of hooks) {
+				const result = hook.onDecisionPoint?.(point, context);
+				if (isThenable(result)) pending.push(Promise.resolve(result));
+			}
+			if (pending.length > 0) return Promise.all(pending).then(() => void 0);
+		} : void 0,
+		onHookError: hooks.some((hook) => hook.onHookError) ? (error, context) => {
+			const pending = [];
+			for (const hook of hooks) {
+				const result = hook.onHookError?.(error, context);
+				if (isThenable(result)) pending.push(Promise.resolve(result));
+			}
+			if (pending.length > 0) return Promise.all(pending).then(() => void 0);
+		} : void 0
+	};
+}
+/** Fire `hooks.onEvent`, swallowing sync throws and surfacing async failures to `onError`. */
+function notifyRuntimeHookEvent(hooks, event, context = {}) {
+	const onEvent = hooks?.onEvent;
+	if (!onEvent) return;
+	try {
+		const result = onEvent(event, context);
+		if (isThenable(result)) result.catch((error) => {
+			notifyRuntimeHookError(hooks, toError(error), {
+				hook: "onEvent",
+				eventId: event.id,
+				target: event.target,
+				phase: event.phase
+			});
+		});
+	} catch (error) {
+		notifyRuntimeHookError(hooks, toError(error), {
+			hook: "onEvent",
+			eventId: event.id,
+			target: event.target,
+			phase: event.phase
+		});
+	}
+}
+/** Fire `hooks.onDecisionPoint`, swallowing sync throws and surfacing async failures to `onError`. */
+function notifyRuntimeDecisionPoint(hooks, point, context = {}) {
+	const onDecisionPoint = hooks?.onDecisionPoint;
+	if (!onDecisionPoint) return;
+	try {
+		const result = onDecisionPoint(point, context);
+		if (isThenable(result)) result.catch((error) => {
+			notifyRuntimeHookError(hooks, toError(error), {
+				hook: "onDecisionPoint",
+				decisionId: point.id,
+				decisionKind: point.kind
+			});
+		});
+	} catch (error) {
+		notifyRuntimeHookError(hooks, toError(error), {
+			hook: "onDecisionPoint",
+			decisionId: point.id,
+			decisionKind: point.kind
+		});
+	}
+}
+function notifyRuntimeHookError(hooks, error, context) {
+	try {
+		const result = hooks?.onHookError?.(error, context);
+		if (isThenable(result)) result.catch(() => void 0);
+	} catch {}
+}
+function isThenable(value) {
+	return typeof value === "object" && value !== null && "then" in value && typeof value.then === "function";
+}
+function toError(error) {
+	return error instanceof Error ? error : new Error(String(error));
+}
+//#endregion
+export { notifyRuntimeHookEvent as i, defineRuntimeHooks as n, notifyRuntimeDecisionPoint as r, composeRuntimeHooks as t };
+
+//# sourceMappingURL=runtime-hooks-C7iJOWm3.js.map

package/dist/runtime-hooks-C7iJOWm3.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-hooks-C7iJOWm3.js","names":[],"sources":["../src/runtime-hooks.ts"],"sourcesContent":["/**\n *\n * Runtime hook contracts. Hooks are execution-scoped observers, not part of an\n * `AgentProfile`: profiles stay portable agent recipes; hooks attach to the\n * loop or product harness that is running the profile.\n *\n * @experimental\n */\n\nexport type RuntimeHookPhase = 'before' | 'after' | 'error' | 'event'\n\nexport type RuntimeHookTarget =\n  | 'agent.run'\n  | 'agent.turn'\n  | 'agent.tool_call'\n  | 'agent.spawn'\n  | 'agent.child'\n  | 'agent.plan'\n  | 'agent.decision'\n  | (string & {})\n\nexport type RuntimeDecisionKind =\n  | 'continue'\n  | 'verify'\n  | 'ask'\n  | 'retry'\n  | 'stop'\n  | 'memory-write'\n  | 'memory-read'\n  | 'tool-select'\n  | 'skill-select'\n  | 'workflow-select'\n  | 'surface-promote'\n  | (string & {})\n\nexport interface RuntimeHookEvent<Payload = unknown> {\n  id: string\n  runId: string\n  scenarioId?: string\n  target: RuntimeHookTarget\n  phase: RuntimeHookPhase\n  timestamp: number\n  stepIndex?: number\n  parentId?: string\n  payload?: Payload\n  metadata?: Record<string, unknown>\n}\n\nexport interface RuntimeHookContext {\n  signal?: AbortSignal\n}\n\nexport interface RuntimeDecisionEvidenceRef {\n  source: string\n  id: string\n  detail?: string\n  metadata?: Record<string, unknown>\n}\n\nexport interface RuntimeDecisionPoint {\n  id: string\n  runId: string\n  scenarioId?: string\n  stepIndex: number\n  kind: RuntimeDecisionKind\n  candidateActions: string[]\n  context?: string\n  evidence: RuntimeDecisionEvidenceRef[]\n  metadata?: Record<string, unknown>\n}\n\nexport interface RuntimeHookErrorContext {\n  hook: 'onEvent' | 'onDecisionPoint'\n  eventId?: string\n  target?: RuntimeHookTarget\n  phase?: RuntimeHookPhase\n  decisionId?: string\n  decisionKind?: RuntimeDecisionKind\n}\n\n/**\n * The observation seam attached to a running loop (never to the portable genome).\n * Implement the optional hooks to receive lifecycle events, semantic decision points,\n * and hook errors. Author with {@link defineRuntimeHooks} for inference, and attach N\n * observers at once with {@link composeRuntimeHooks} — there is ONE event stream, not a\n * callback-prop zoo.\n */\nexport interface RuntimeHooks {\n  /**\n   * General before/after/event hook. Use this for telemetry, memory capture,\n   * policy wrapping, child lifecycle observers, or product-specific extension\n   * points.\n   */\n  onEvent?: (event: RuntimeHookEvent, context: RuntimeHookContext) => void | Promise<void>\n  /**\n   * Semantic decision hook. Belief-state evaluation consumes this, but runtime\n   * code should keep emitting ordinary lifecycle events as the base layer.\n   */\n  onDecisionPoint?: (\n    point: RuntimeDecisionPoint,\n    context: RuntimeHookContext,\n  ) => void | Promise<void>\n  onHookError?: (error: Error, context: RuntimeHookErrorContext) => void | Promise<void>\n}\n\n/** Identity helper that types a {@link RuntimeHooks} literal so the fields are inferred. */\nexport function defineRuntimeHooks(hooks: RuntimeHooks): RuntimeHooks {\n  return hooks\n}\n\n/**\n * Merge several {@link RuntimeHooks} into one. Falsy entries are dropped (so you can\n * pass `flag && hooks`), and every observer's `onEvent`/`onDecisionPoint` fires for each\n * event. Use this to attach N observers to a loop instead of a second event bus.\n */\nexport function composeRuntimeHooks(\n  ...entries: Array<RuntimeHooks | undefined | null | false>\n): RuntimeHooks {\n  const hooks = entries.filter((entry): entry is RuntimeHooks => !!entry)\n  return {\n    onEvent: hooks.some((hook) => hook.onEvent)\n      ? (event, context) => {\n          const pending: Promise<unknown>[] = []\n          for (const hook of hooks) {\n            const result = hook.onEvent?.(event, context)\n            if (isThenable(result)) pending.push(Promise.resolve(result))\n          }\n          if (pending.length > 0) return Promise.all(pending).then(() => undefined)\n          return undefined\n        }\n      : undefined,\n    onDecisionPoint: hooks.some((hook) => hook.onDecisionPoint)\n      ? (point, context) => {\n          const pending: Promise<unknown>[] = []\n          for (const hook of hooks) {\n            const result = hook.onDecisionPoint?.(point, context)\n            if (isThenable(result)) pending.push(Promise.resolve(result))\n          }\n          if (pending.length > 0) return Promise.all(pending).then(() => undefined)\n          return undefined\n        }\n      : undefined,\n    onHookError: hooks.some((hook) => hook.onHookError)\n      ? (error, context) => {\n          const pending: Promise<unknown>[] = []\n          for (const hook of hooks) {\n            const result = hook.onHookError?.(error, context)\n            if (isThenable(result)) pending.push(Promise.resolve(result))\n          }\n          if (pending.length > 0) return Promise.all(pending).then(() => undefined)\n          return undefined\n        }\n      : undefined,\n  }\n}\n\n/** Fire `hooks.onEvent`, swallowing sync throws and surfacing async failures to `onError`. */\nexport function notifyRuntimeHookEvent(\n  hooks: RuntimeHooks | undefined,\n  event: RuntimeHookEvent,\n  context: RuntimeHookContext = {},\n): void {\n  const onEvent = hooks?.onEvent\n  if (!onEvent) return\n\n  try {\n    const result = onEvent(event, context)\n    if (isThenable(result)) {\n      void result.catch((error) => {\n        notifyRuntimeHookError(hooks, toError(error), {\n          hook: 'onEvent',\n          eventId: event.id,\n          target: event.target,\n          phase: event.phase,\n        })\n      })\n    }\n  } catch (error) {\n    notifyRuntimeHookError(hooks, toError(error), {\n      hook: 'onEvent',\n      eventId: event.id,\n      target: event.target,\n      phase: event.phase,\n    })\n  }\n}\n\n/** Fire `hooks.onDecisionPoint`, swallowing sync throws and surfacing async failures to `onError`. */\nexport function notifyRuntimeDecisionPoint(\n  hooks: RuntimeHooks | undefined,\n  point: RuntimeDecisionPoint,\n  context: RuntimeHookContext = {},\n): void {\n  const onDecisionPoint = hooks?.onDecisionPoint\n  if (!onDecisionPoint) return\n\n  try {\n    const result = onDecisionPoint(point, context)\n    if (isThenable(result)) {\n      void result.catch((error) => {\n        notifyRuntimeHookError(hooks, toError(error), {\n          hook: 'onDecisionPoint',\n          decisionId: point.id,\n          decisionKind: point.kind,\n        })\n      })\n    }\n  } catch (error) {\n    notifyRuntimeHookError(hooks, toError(error), {\n      hook: 'onDecisionPoint',\n      decisionId: point.id,\n      decisionKind: point.kind,\n    })\n  }\n}\n\nfunction notifyRuntimeHookError(\n  hooks: RuntimeHooks | undefined,\n  error: Error,\n  context: RuntimeHookErrorContext,\n): void {\n  try {\n    const result = hooks?.onHookError?.(error, context)\n    if (isThenable(result)) void result.catch(() => undefined)\n  } catch {\n    // Hook errors must never become agent-loop errors.\n  }\n}\n\nfunction isThenable(value: unknown): value is PromiseLike<unknown> {\n  return (\n    typeof value === 'object' &&\n    value !== null &&\n    'then' in value &&\n    typeof (value as { then?: unknown }).then === 'function'\n  )\n}\n\nfunction toError(error: unknown): Error {\n  return error instanceof Error ? error : new Error(String(error))\n}\n"],"mappings":"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"}

package/dist/runtime-hooks-sbRpjStq.d.ts

@@ -0,0 +1,88 @@
+//#region src/runtime-hooks.d.ts
+/**
+ *
+ * Runtime hook contracts. Hooks are execution-scoped observers, not part of an
+ * `AgentProfile`: profiles stay portable agent recipes; hooks attach to the
+ * loop or product harness that is running the profile.
+ *
+ * @experimental
+ */
+type RuntimeHookPhase = 'before' | 'after' | 'error' | 'event';
+type RuntimeHookTarget = 'agent.run' | 'agent.turn' | 'agent.tool_call' | 'agent.spawn' | 'agent.child' | 'agent.plan' | 'agent.decision' | (string & {});
+type RuntimeDecisionKind = 'continue' | 'verify' | 'ask' | 'retry' | 'stop' | 'memory-write' | 'memory-read' | 'tool-select' | 'skill-select' | 'workflow-select' | 'surface-promote' | (string & {});
+interface RuntimeHookEvent<Payload = unknown> {
+  id: string;
+  runId: string;
+  scenarioId?: string;
+  target: RuntimeHookTarget;
+  phase: RuntimeHookPhase;
+  timestamp: number;
+  stepIndex?: number;
+  parentId?: string;
+  payload?: Payload;
+  metadata?: Record<string, unknown>;
+}
+interface RuntimeHookContext {
+  signal?: AbortSignal;
+}
+interface RuntimeDecisionEvidenceRef {
+  source: string;
+  id: string;
+  detail?: string;
+  metadata?: Record<string, unknown>;
+}
+interface RuntimeDecisionPoint {
+  id: string;
+  runId: string;
+  scenarioId?: string;
+  stepIndex: number;
+  kind: RuntimeDecisionKind;
+  candidateActions: string[];
+  context?: string;
+  evidence: RuntimeDecisionEvidenceRef[];
+  metadata?: Record<string, unknown>;
+}
+interface RuntimeHookErrorContext {
+  hook: 'onEvent' | 'onDecisionPoint';
+  eventId?: string;
+  target?: RuntimeHookTarget;
+  phase?: RuntimeHookPhase;
+  decisionId?: string;
+  decisionKind?: RuntimeDecisionKind;
+}
+/**
+ * The observation seam attached to a running loop (never to the portable genome).
+ * Implement the optional hooks to receive lifecycle events, semantic decision points,
+ * and hook errors. Author with {@link defineRuntimeHooks} for inference, and attach N
+ * observers at once with {@link composeRuntimeHooks} — there is ONE event stream, not a
+ * callback-prop zoo.
+ */
+interface RuntimeHooks {
+  /**
+   * General before/after/event hook. Use this for telemetry, memory capture,
+   * policy wrapping, child lifecycle observers, or product-specific extension
+   * points.
+   */
+  onEvent?: (event: RuntimeHookEvent, context: RuntimeHookContext) => void | Promise<void>;
+  /**
+   * Semantic decision hook. Belief-state evaluation consumes this, but runtime
+   * code should keep emitting ordinary lifecycle events as the base layer.
+   */
+  onDecisionPoint?: (point: RuntimeDecisionPoint, context: RuntimeHookContext) => void | Promise<void>;
+  onHookError?: (error: Error, context: RuntimeHookErrorContext) => void | Promise<void>;
+}
+/** Identity helper that types a {@link RuntimeHooks} literal so the fields are inferred. */
+declare function defineRuntimeHooks(hooks: RuntimeHooks): RuntimeHooks;
+/**
+ * Merge several {@link RuntimeHooks} into one. Falsy entries are dropped (so you can
+ * pass `flag && hooks`), and every observer's `onEvent`/`onDecisionPoint` fires for each
+ * event. Use this to attach N observers to a loop instead of a second event bus.
+ */
+declare function composeRuntimeHooks(...entries: Array<RuntimeHooks | undefined | null | false>): RuntimeHooks;
+/** Fire `hooks.onEvent`, swallowing sync throws and surfacing async failures to `onError`. */
+declare function notifyRuntimeHookEvent(hooks: RuntimeHooks | undefined, event: RuntimeHookEvent, context?: RuntimeHookContext): void;
+/** Fire `hooks.onDecisionPoint`, swallowing sync throws and surfacing async failures to `onError`. */
+declare function notifyRuntimeDecisionPoint(hooks: RuntimeHooks | undefined, point: RuntimeDecisionPoint, context?: RuntimeHookContext): void;
+//#endregion
+export { RuntimeHookErrorContext as a, RuntimeHookTarget as c, defineRuntimeHooks as d, notifyRuntimeDecisionPoint as f, RuntimeHookContext as i, RuntimeHooks as l, RuntimeDecisionKind as n, RuntimeHookEvent as o, notifyRuntimeHookEvent as p, RuntimeDecisionPoint as r, RuntimeHookPhase as s, RuntimeDecisionEvidenceRef as t, composeRuntimeHooks as u };
+//# sourceMappingURL=runtime-hooks-sbRpjStq.d.ts.map

package/dist/{structural-rollout-BC81Otmc.js → structural-rollout-ASQLr4-v.js}

@@ -1,5 +1,5 @@
 import { i as InMemorySpawnJournal, r as InMemoryResultBlobStore } from "./spawn-journal-CwPvKUTa.js";
-import { O as routerToolLoop, l as withDriverExecutor, t as createSupervisor } from "./supervisor-B2LzaWRb.js";
+import { l as withDriverExecutor, t as createSupervisor, w as routerToolLoop } from "./supervisor-sTJC9psT.js";
 import { createChatClient, estimateCost, isModelPriced, makeProposalFinding } from "@tangle-network/agent-eval";
 import { randomBytes } from "node:crypto";
 import { assertProposalFindings } from "@tangle-network/agent-eval/analyst";
@@ -1443,4 +1443,4 @@ function structuralRollout(config = {}) {
 //#endregion
 export { observe as C, researchDriverNote as D, optimizerMethod as E, strategyAuthorMethod as O, defaultAnalystInstruction as S, buildDriverSystem as T, depthStrategy as _, defaultStructuralRolloutPolicy as a, sample as b, officialChecksFromMeta as c, selectBestIndex as d, structuralRollout as f, defineStrategy as g, breadthStrategy as h, defaultExtractCandidate as i, resolveEntrySymbol as l, adaptiveRefine as m, compareCheckOutcomes as n, filterAuthoredAsserts as o, visibleCheckScore as p, composeCheckSources as r, modelAuthoredChecks as s, canDisplace as t, sandboxCheckRunner as u, refine as v, renderReport as w, sampleThenRefine as x, runAgentic as y };
 
-//# sourceMappingURL=structural-rollout-BC81Otmc.js.map
+//# sourceMappingURL=structural-rollout-ASQLr4-v.js.map