@tangle-network/agent-runtime 0.69.0 → 0.70.0

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

@@ -1,70 +0,0 @@
-/**
- * @experimental
- *
- * 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.
- */
-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;
-}
-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>;
-}
-declare function defineRuntimeHooks(hooks: RuntimeHooks): RuntimeHooks;
-declare function composeRuntimeHooks(...entries: Array<RuntimeHooks | undefined | null | false>): RuntimeHooks;
-declare function notifyRuntimeHookEvent(hooks: RuntimeHooks | undefined, event: RuntimeHookEvent, context?: RuntimeHookContext): void;
-declare function notifyRuntimeDecisionPoint(hooks: RuntimeHooks | undefined, point: RuntimeDecisionPoint, context?: RuntimeHookContext): void;
-
-export { type RuntimeHooks as R, type RuntimeHookEvent as a, type RuntimeDecisionEvidenceRef as b, type RuntimeDecisionKind as c, type RuntimeDecisionPoint as d, type RuntimeHookContext as e, type RuntimeHookErrorContext as f, type RuntimeHookPhase as g, type RuntimeHookTarget as h, composeRuntimeHooks as i, defineRuntimeHooks as j, notifyRuntimeHookEvent as k, notifyRuntimeDecisionPoint as n };