agentfootprint 13.0.0 → 14.0.0

package/dist/types/core/agent/stages/toolCalls/contracts/invocationInputs.d.ts

@@ -0,0 +1,12 @@
+import type { ArtifactMeta } from '../../../../../artifacts/types.js';
+import type { Credential } from '../../../../../identity/types.js';
+/** Invocation-local phase cells; never checkpoint state or a run registry. */
+export interface CallArtifactInputs {
+    wantedMeta: Readonly<Record<string, ArtifactMeta>> | undefined;
+    wantsBlocked: boolean;
+}
+export interface CallCredentialInput {
+    resolvedCredential: Credential | undefined;
+    credentialBlocked: boolean;
+}
+//# sourceMappingURL=invocationInputs.d.ts.map

package/dist/types/core/agent/stages/toolCalls/contracts/invocationInputs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"invocationInputs.d.ts","sourceRoot":"","sources":["../../../../../../../src/core/agent/stages/toolCalls/contracts/invocationInputs.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mCAAmC,CAAC;AACtE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kCAAkC,CAAC;AAEnE,8EAA8E;AAE9E,MAAM,WAAW,kBAAkB;IACjC,UAAU,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC,GAAG,SAAS,CAAC;IAC/D,YAAY,EAAE,OAAO,CAAC;CACvB;AAED,MAAM,WAAW,mBAAmB;IAClC,kBAAkB,EAAE,UAAU,GAAG,SAAS,CAAC;IAC3C,iBAAiB,EAAE,OAAO,CAAC;CAC5B"}

package/dist/types/core/agent/stages/toolCalls/contracts/observation.d.ts

@@ -0,0 +1,25 @@
+import type { AgentfootprintEventType } from '../../../../../events/registry.js';
+/** The observation dependencies of the existing tool-call stage. */
+export interface ToolObservationPort {
+    /**
+     * Keep this run's tool-call ledger (`AgentState.toolCallLedger`) for an
+     * `answerValidation` check: name, call id and outcome per `stream.tool_end`
+     * bracket, at most `maxCalls`. Threaded ONLY on an agent with
+     * `answerValidation` — absent, no bracket writes anything, and the agent
+     * commits exactly the keys it always did.
+     */
+    readonly toolCallLedger?: {
+        readonly maxCalls: number;
+    };
+    /**
+     * Put one artifact fact on the record for the run it BELONGS to — the door
+     * a `ctx.artifacts` fact takes when it lands after that run ended (a tool's
+     * floating upload finishing during a later run). The scope channel stamps
+     * whatever run is live at emit time; this stamps the run context the binding
+     * captured when it was built.
+     *
+     * @internal
+     */
+    readonly emitForRun?: (type: AgentfootprintEventType, payload: Record<string, unknown>, runContext: import('../../../../../bridge/eventMeta.js').RunContext) => void;
+}
+//# sourceMappingURL=observation.d.ts.map

package/dist/types/core/agent/stages/toolCalls/contracts/observation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"observation.d.ts","sourceRoot":"","sources":["../../../../../../../src/core/agent/stages/toolCalls/contracts/observation.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,mCAAmC,CAAC;AAEjF,oEAAoE;AACpE,MAAM,WAAW,mBAAmB;IAClC;;;;;;OAMG;IACH,QAAQ,CAAC,cAAc,CAAC,EAAE;QAAE,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC;IACxD;;;;;;;;OAQG;IACH,QAAQ,CAAC,UAAU,CAAC,EAAE,CACpB,IAAI,EAAE,uBAAuB,EAC7B,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAChC,UAAU,EAAE,OAAO,oCAAoC,EAAE,UAAU,KAChE,IAAI,CAAC;CACX"}

package/dist/types/core/agent/stages/toolCalls/contracts/operations/artifacts.d.ts

@@ -0,0 +1,38 @@
+import type { TypedScope } from 'footprintjs';
+import type { AgentState } from '../../../../types.js';
+import type { Tool } from '../../../../../../tools/tools.js';
+import type { ToolArgs } from '../../../../../../tools/runChain.js';
+import type { ArtifactMeta } from '../../../../../../artifacts/types.js';
+import type { AskComponent } from '../../../../../../tools/askComponent.js';
+/** Explicit callback contract for existing artifacts operations. */
+export interface ToolArtifactsOperations {
+    readonly resolveWantsAtDispatch: (scope: TypedScope<AgentState>, toolName: string, wants: NonNullable<Tool['wants']>, args: ToolArgs, inputSchema: Readonly<Record<string, unknown>> | undefined) => Promise<{
+        readonly ok: true;
+        readonly args: ToolArgs;
+        readonly wanted?: Readonly<Record<string, ArtifactMeta>>;
+    } | {
+        readonly ok: false;
+        readonly refusal: string;
+    }>;
+    readonly assertComponentDeliverable: (scope: TypedScope<AgentState>, toolName: string, component: unknown, door: string) => Promise<AskComponent>;
+    readonly applyPresent: (scope: TypedScope<AgentState>, call: {
+        readonly args: Readonly<Record<string, unknown>>;
+        readonly toolCallId: string;
+        readonly iteration: number;
+    }) => Promise<{
+        readonly ok: boolean;
+        readonly text: string;
+    }>;
+    readonly placeResults: (scope: TypedScope<AgentState>, call: {
+        readonly toolName: string;
+        readonly toolCallId: string;
+        readonly iteration: number;
+    }, values: {
+        readonly result: unknown;
+        readonly modelResult: unknown;
+    }, eligible: boolean) => Promise<{
+        readonly result: unknown;
+        readonly modelResult: unknown;
+    }>;
+}
+//# sourceMappingURL=artifacts.d.ts.map

package/dist/types/core/agent/stages/toolCalls/contracts/operations/artifacts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"artifacts.d.ts","sourceRoot":"","sources":["../../../../../../../../src/core/agent/stages/toolCalls/contracts/operations/artifacts.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAC9C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AACvD,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,kCAAkC,CAAC;AAC7D,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,qCAAqC,CAAC;AACpE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,sCAAsC,CAAC;AACzE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,yCAAyC,CAAC;AAE5E,oEAAoE;AACpE,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,sBAAsB,EAAE,CAC/B,KAAK,EAAE,UAAU,CAAC,UAAU,CAAC,EAC7B,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,WAAW,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,EACjC,IAAI,EAAE,QAAQ,EACd,WAAW,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GAAG,SAAS,KACvD,OAAO,CACR;QACE,QAAQ,CAAC,EAAE,EAAE,IAAI,CAAC;QAClB,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC;QACxB,QAAQ,CAAC,MAAM,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC,CAAC;KAC1D,GACD;QAAE,QAAQ,CAAC,EAAE,EAAE,KAAK,CAAC;QAAC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CACnD,CAAC;IACF,QAAQ,CAAC,0BAA0B,EAAE,CACnC,KAAK,EAAE,UAAU,CAAC,UAAU,CAAC,EAC7B,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,OAAO,EAClB,IAAI,EAAE,MAAM,KACT,OAAO,CAAC,YAAY,CAAC,CAAC;IAC3B,QAAQ,CAAC,YAAY,EAAE,CACrB,KAAK,EAAE,UAAU,CAAC,UAAU,CAAC,EAC7B,IAAI,EAAE;QACJ,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;QACjD,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;QAC5B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;KAC5B,KACE,OAAO,CAAC;QAAE,QAAQ,CAAC,EAAE,EAAE,OAAO,CAAC;QAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC9D,QAAQ,CAAC,YAAY,EAAE,CACrB,KAAK,EAAE,UAAU,CAAC,UAAU,CAAC,EAC7B,IAAI,EAAE;QAAE,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;KAAE,EAC5F,MAAM,EAAE;QAAE,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;QAAC,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAA;KAAE,EACnE,QAAQ,EAAE,OAAO,KACd,OAAO,CAAC;QAAE,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;QAAC,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAA;KAAE,CAAC,CAAC;CAC3E"}

package/dist/types/core/agent/stages/toolCalls/contracts/operations/catalog.d.ts

@@ -0,0 +1,32 @@
+import type { ToolParty } from '../../../../../slots/buildToolsSlot.js';
+import type { Tool } from '../../../../../../tools/tools.js';
+import type { TypedScope } from 'footprintjs';
+import type { AgentState } from '../../../../types.js';
+import type { TurnStamp } from '../../../../findings/ledger.js';
+import type { SplitFindings } from '../../../../findings/reserved.js';
+import type { Resolution } from '../callFacts.js';
+import type { SpokenIds } from '../../../../../../lib/spokenIds.js';
+/** Explicit callback contract for existing catalog operations. */
+export interface ToolCatalogOperations {
+    readonly lookupTool: (toolName: string, pinned?: ToolParty) => Tool | undefined;
+    readonly unmountedRules: (tool: Tool | undefined, toolName: string) => Promise<string> | undefined;
+    readonly warnUnmountedToolPeriod: (tool: Tool | undefined, toolName: string) => void;
+    readonly turnStampOf: (scope: TypedScope<AgentState>) => TurnStamp | undefined;
+    readonly peelsReserved: (tool: Tool | undefined) => boolean;
+    readonly peelCall: (tc: {
+        readonly name: string;
+        readonly args: Readonly<Record<string, unknown>>;
+    }) => SplitFindings;
+    readonly noteOptionsFor: (tool: Tool | undefined) => {
+        readonly sources: true;
+    } | undefined;
+    readonly noteOffWire: (scope: TypedScope<AgentState>, resolved: Resolution, call: {
+        readonly toolName: string;
+        readonly toolCallId: string;
+        readonly iteration: number;
+    }) => void;
+    readonly frameworkSkipStepAnswered: (name: string, answered: Tool | undefined) => boolean;
+    readonly parkedNow: (scope: TypedScope<AgentState>) => ReadonlySet<string> | undefined;
+    readonly dispatchRoster: (scope: TypedScope<AgentState>) => SpokenIds;
+}
+//# sourceMappingURL=catalog.d.ts.map

package/dist/types/core/agent/stages/toolCalls/contracts/operations/catalog.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"catalog.d.ts","sourceRoot":"","sources":["../../../../../../../../src/core/agent/stages/toolCalls/contracts/operations/catalog.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,wCAAwC,CAAC;AACxE,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,kCAAkC,CAAC;AAC7D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAC9C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AACvD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gCAAgC,CAAC;AAChE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,kCAAkC,CAAC;AACtE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAClD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,oCAAoC,CAAC;AAEpE,kEAAkE;AAClE,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,UAAU,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,SAAS,KAAK,IAAI,GAAG,SAAS,CAAC;IAChF,QAAQ,CAAC,cAAc,EAAE,CACvB,IAAI,EAAE,IAAI,GAAG,SAAS,EACtB,QAAQ,EAAE,MAAM,KACb,OAAO,CAAC,MAAM,CAAC,GAAG,SAAS,CAAC;IACjC,QAAQ,CAAC,uBAAuB,EAAE,CAAC,IAAI,EAAE,IAAI,GAAG,SAAS,EAAE,QAAQ,EAAE,MAAM,KAAK,IAAI,CAAC;IACrF,QAAQ,CAAC,WAAW,EAAE,CAAC,KAAK,EAAE,UAAU,CAAC,UAAU,CAAC,KAAK,SAAS,GAAG,SAAS,CAAC;IAC/E,QAAQ,CAAC,aAAa,EAAE,CAAC,IAAI,EAAE,IAAI,GAAG,SAAS,KAAK,OAAO,CAAC;IAC5D,QAAQ,CAAC,QAAQ,EAAE,CAAC,EAAE,EAAE;QACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;QACtB,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;KAClD,KAAK,aAAa,CAAC;IACpB,QAAQ,CAAC,cAAc,EAAE,CAAC,IAAI,EAAE,IAAI,GAAG,SAAS,KAAK;QAAE,QAAQ,CAAC,OAAO,EAAE,IAAI,CAAA;KAAE,GAAG,SAAS,CAAC;IAC5F,QAAQ,CAAC,WAAW,EAAE,CACpB,KAAK,EAAE,UAAU,CAAC,UAAU,CAAC,EAC7B,QAAQ,EAAE,UAAU,EACpB,IAAI,EAAE;QAAE,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;KAAE,KACzF,IAAI,CAAC;IACV,QAAQ,CAAC,yBAAyB,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,IAAI,GAAG,SAAS,KAAK,OAAO,CAAC;IAC1F,QAAQ,CAAC,SAAS,EAAE,CAAC,KAAK,EAAE,UAAU,CAAC,UAAU,CAAC,KAAK,WAAW,CAAC,MAAM,CAAC,GAAG,SAAS,CAAC;IACvF,QAAQ,CAAC,cAAc,EAAE,CAAC,KAAK,EAAE,UAAU,CAAC,UAAU,CAAC,KAAK,SAAS,CAAC;CACvE"}

package/dist/types/core/agent/stages/toolCalls/contracts/operations/context.d.ts

@@ -0,0 +1,15 @@
+import type { TypedScope } from 'footprintjs';
+import type { AgentState } from '../../../../types.js';
+import type { ToolExecutionContext } from '../../../../../../tools/tools.js';
+import type { ArtifactScope } from '../../../../../../artifacts/types.js';
+/** Explicit callback contract for existing context operations. */
+export interface ToolContextOperations {
+    readonly toolArtifacts: (scope: TypedScope<AgentState>, toolName: string, toolCallId: string) => Pick<ToolExecutionContext, 'artifacts' | 'hasArtifacts'>;
+    readonly toolDispatchCtx: (scope: TypedScope<AgentState>, call: {
+        readonly toolName: string;
+        readonly toolCallId: string;
+        readonly iteration: number;
+    }, signal?: AbortSignal) => Pick<ToolExecutionContext, 'tools'>;
+    readonly runScopeOf: (scope: TypedScope<AgentState>) => ArtifactScope;
+}
+//# sourceMappingURL=context.d.ts.map

package/dist/types/core/agent/stages/toolCalls/contracts/operations/context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../../../../../../../src/core/agent/stages/toolCalls/contracts/operations/context.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAC9C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AACvD,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,kCAAkC,CAAC;AAC7E,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sCAAsC,CAAC;AAE1E,kEAAkE;AAClE,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,aAAa,EAAE,CACtB,KAAK,EAAE,UAAU,CAAC,UAAU,CAAC,EAC7B,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,MAAM,KACf,IAAI,CAAC,oBAAoB,EAAE,WAAW,GAAG,cAAc,CAAC,CAAC;IAC9D,QAAQ,CAAC,eAAe,EAAE,CACxB,KAAK,EAAE,UAAU,CAAC,UAAU,CAAC,EAC7B,IAAI,EAAE;QACJ,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;QAC1B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;QAC5B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;KAC5B,EACD,MAAM,CAAC,EAAE,WAAW,KACjB,IAAI,CAAC,oBAAoB,EAAE,OAAO,CAAC,CAAC;IACzC,QAAQ,CAAC,UAAU,EAAE,CAAC,KAAK,EAAE,UAAU,CAAC,UAAU,CAAC,KAAK,aAAa,CAAC;CACvE"}

package/dist/types/core/agent/stages/toolCalls/contracts/operations/coverage.d.ts

@@ -0,0 +1,24 @@
+import type { TypedScope } from 'footprintjs';
+import type { AgentState } from '../../../../types.js';
+import type { CoverageReading, CoverageFacts, DeclaredCoverage, ToolAbsence } from '../../../../../../semantics/coverage/index.js';
+import type { ToolResultStatus } from '../../../../../../semantics/toolEffects.js';
+import type { LLMMessage } from '../../../../../../provider-contract/types.js';
+/** Explicit callback contract for existing coverage operations. */
+export interface ToolCoverageOperations {
+    readonly declareCoverage: (scope: TypedScope<AgentState>, call: {
+        readonly toolName: string;
+        readonly toolCallId: string;
+        readonly iteration: number;
+    }, value: unknown, composed?: CoverageReading) => ToolResultStatus | undefined;
+    readonly declareComposed: (scope: TypedScope<AgentState>, call: {
+        readonly toolName: string;
+        readonly toolCallId: string;
+        readonly iteration: number;
+    }, facts: CoverageFacts) => DeclaredCoverage;
+    readonly declareRaisedAbsence: (scope: TypedScope<AgentState>, call: {
+        readonly toolName: string;
+        readonly toolCallId: string;
+        readonly iteration: number;
+    }, args: Readonly<Record<string, unknown>>, absence: ToolAbsence, history: readonly LLMMessage[]) => string | undefined;
+}
+//# sourceMappingURL=coverage.d.ts.map

package/dist/types/core/agent/stages/toolCalls/contracts/operations/coverage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"coverage.d.ts","sourceRoot":"","sources":["../../../../../../../../src/core/agent/stages/toolCalls/contracts/operations/coverage.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAC9C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AACvD,OAAO,KAAK,EACV,eAAe,EACf,aAAa,EACb,gBAAgB,EAChB,WAAW,EACZ,MAAM,+CAA+C,CAAC;AACvD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,4CAA4C,CAAC;AACnF,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,8CAA8C,CAAC;AAE/E,mEAAmE;AACnE,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,eAAe,EAAE,CACxB,KAAK,EAAE,UAAU,CAAC,UAAU,CAAC,EAC7B,IAAI,EAAE;QAAE,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;KAAE,EAC5F,KAAK,EAAE,OAAO,EACd,QAAQ,CAAC,EAAE,eAAe,KACvB,gBAAgB,GAAG,SAAS,CAAC;IAClC,QAAQ,CAAC,eAAe,EAAE,CACxB,KAAK,EAAE,UAAU,CAAC,UAAU,CAAC,EAC7B,IAAI,EAAE;QAAE,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;KAAE,EAC5F,KAAK,EAAE,aAAa,KACjB,gBAAgB,CAAC;IACtB,QAAQ,CAAC,oBAAoB,EAAE,CAC7B,KAAK,EAAE,UAAU,CAAC,UAAU,CAAC,EAC7B,IAAI,EAAE;QAAE,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;KAAE,EAC5F,IAAI,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,EACvC,OAAO,EAAE,WAAW,EACpB,OAAO,EAAE,SAAS,UAAU,EAAE,KAC3B,MAAM,GAAG,SAAS,CAAC;CACzB"}

package/dist/types/core/agent/stages/toolCalls/contracts/operations/credentials.d.ts

@@ -0,0 +1,6 @@
+import type { CredentialProvider } from '../../../../../../identity/types.js';
+/** Explicit callback contract for existing credentials operations. */
+export interface ToolCredentialsOperations {
+    readonly credentialsIn: (scope: object, service: string | undefined) => CredentialProvider;
+}
+//# sourceMappingURL=credentials.d.ts.map

package/dist/types/core/agent/stages/toolCalls/contracts/operations/credentials.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"credentials.d.ts","sourceRoot":"","sources":["../../../../../../../../src/core/agent/stages/toolCalls/contracts/operations/credentials.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,qCAAqC,CAAC;AAE9E,sEAAsE;AACtE,MAAM,WAAW,yBAAyB;IACxC,QAAQ,CAAC,aAAa,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,SAAS,KAAK,kBAAkB,CAAC;CAC5F"}

package/dist/types/core/agent/stages/toolCalls/contracts/operations/effects.d.ts

@@ -0,0 +1,15 @@
+import type { TypedScope } from 'footprintjs';
+import type { AgentState } from '../../../../types.js';
+import type { ReadToolResultEnvelope } from '../../../../../../semantics/toolEffects.js';
+import type { TransitionBatchState } from '../callFacts.js';
+/** Explicit callback contract for existing effects operations. */
+export interface ToolEffectsOperations {
+    readonly warnEffect: (toolName: string, sentence: string) => void;
+    readonly applyToolEffects: (scope: TypedScope<AgentState>, call: {
+        readonly toolName: string;
+        readonly toolCallId: string;
+        readonly iteration: number;
+    }, envelope: ReadToolResultEnvelope, state: TransitionBatchState) => string;
+    readonly emitTransitionConflict: (scope: TypedScope<AgentState>, iteration: number, state: TransitionBatchState) => void;
+}
+//# sourceMappingURL=effects.d.ts.map

package/dist/types/core/agent/stages/toolCalls/contracts/operations/effects.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"effects.d.ts","sourceRoot":"","sources":["../../../../../../../../src/core/agent/stages/toolCalls/contracts/operations/effects.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAC9C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AACvD,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,4CAA4C,CAAC;AACzF,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AAE5D,kEAAkE;AAClE,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,UAAU,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,KAAK,IAAI,CAAC;IAClE,QAAQ,CAAC,gBAAgB,EAAE,CACzB,KAAK,EAAE,UAAU,CAAC,UAAU,CAAC,EAC7B,IAAI,EAAE;QAAE,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;KAAE,EAC5F,QAAQ,EAAE,sBAAsB,EAChC,KAAK,EAAE,oBAAoB,KACxB,MAAM,CAAC;IACZ,QAAQ,CAAC,sBAAsB,EAAE,CAC/B,KAAK,EAAE,UAAU,CAAC,UAAU,CAAC,EAC7B,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,oBAAoB,KACxB,IAAI,CAAC;CACX"}

package/dist/types/core/agent/stages/toolCalls/contracts/operations/integrity.d.ts

@@ -0,0 +1,17 @@
+import type { TypedScope } from 'footprintjs';
+import type { AgentState } from '../../../../types.js';
+import type { LLMMessage } from '../../../../../../provider-contract/types.js';
+/** Explicit callback contract for existing integrity operations. */
+export interface ToolIntegrityOperations {
+    readonly judgeColumns: (scope: TypedScope<AgentState>, call: {
+        readonly toolName: string;
+        readonly toolCallId: string;
+        readonly iteration: number;
+    }, value: unknown) => string | undefined;
+    readonly noticeEmptyLookup: (scope: TypedScope<AgentState>, call: {
+        readonly toolName: string;
+        readonly toolCallId: string;
+        readonly iteration: number;
+    }, args: Readonly<Record<string, unknown>>, result: unknown, history: readonly LLMMessage[], answered: boolean) => void;
+}
+//# sourceMappingURL=integrity.d.ts.map

package/dist/types/core/agent/stages/toolCalls/contracts/operations/integrity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"integrity.d.ts","sourceRoot":"","sources":["../../../../../../../../src/core/agent/stages/toolCalls/contracts/operations/integrity.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAC9C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AACvD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,8CAA8C,CAAC;AAE/E,oEAAoE;AACpE,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,YAAY,EAAE,CACrB,KAAK,EAAE,UAAU,CAAC,UAAU,CAAC,EAC7B,IAAI,EAAE;QAAE,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;KAAE,EAC5F,KAAK,EAAE,OAAO,KACX,MAAM,GAAG,SAAS,CAAC;IACxB,QAAQ,CAAC,iBAAiB,EAAE,CAC1B,KAAK,EAAE,UAAU,CAAC,UAAU,CAAC,EAC7B,IAAI,EAAE;QAAE,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;KAAE,EAC5F,IAAI,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,EACvC,MAAM,EAAE,OAAO,EACf,OAAO,EAAE,SAAS,UAAU,EAAE,EAC9B,QAAQ,EAAE,OAAO,KACd,IAAI,CAAC;CACX"}

package/dist/types/core/agent/stages/toolCalls/contracts/operations/limits.d.ts

@@ -0,0 +1,20 @@
+import type { TypedScope } from 'footprintjs';
+import type { AgentState } from '../../../../types.js';
+import type { Tool } from '../../../../../../tools/tools.js';
+import type { ToolResultStatus } from '../../../../../../semantics/toolEffects.js';
+/** Explicit callback contract for existing limits operations. */
+export interface ToolLimitsOperations {
+    readonly capResults: (toolName: string, values: {
+        readonly result: unknown;
+        readonly modelResult: unknown;
+    }) => {
+        readonly result: unknown;
+        readonly modelResult: unknown;
+    };
+    readonly refuseOverCeiling: (scope: TypedScope<AgentState>, call: {
+        readonly toolName: string;
+        readonly toolCallId: string;
+        readonly iteration: number;
+    }, tool: Tool | undefined, value: unknown, declaredStatus?: ToolResultStatus) => string | undefined;
+}
+//# sourceMappingURL=limits.d.ts.map

package/dist/types/core/agent/stages/toolCalls/contracts/operations/limits.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"limits.d.ts","sourceRoot":"","sources":["../../../../../../../../src/core/agent/stages/toolCalls/contracts/operations/limits.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAC9C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AACvD,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,kCAAkC,CAAC;AAC7D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,4CAA4C,CAAC;AAEnF,iEAAiE;AACjE,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,UAAU,EAAE,CACnB,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE;QAAE,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;QAAC,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAA;KAAE,KAChE;QAAE,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;QAAC,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAA;KAAE,CAAC;IACjE,QAAQ,CAAC,iBAAiB,EAAE,CAC1B,KAAK,EAAE,UAAU,CAAC,UAAU,CAAC,EAC7B,IAAI,EAAE;QAAE,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;KAAE,EAC5F,IAAI,EAAE,IAAI,GAAG,SAAS,EACtB,KAAK,EAAE,OAAO,EACd,cAAc,CAAC,EAAE,gBAAgB,KAC9B,MAAM,GAAG,SAAS,CAAC;CACzB"}

package/dist/types/core/agent/stages/toolCalls/contracts/operations/middleware.d.ts

@@ -0,0 +1,26 @@
+import type { TypedScope } from 'footprintjs';
+import type { AgentState } from '../../../../types.js';
+import type { Tool } from '../../../../../../tools/tools.js';
+import type { ToolArgs } from '../../../../../../tools/runChain.js';
+import type { LLMMessage } from '../../../../../../provider-contract/types.js';
+/** Explicit callback contract for existing middleware operations. */
+export interface ToolMiddlewareOperations {
+    readonly afterMoment: (scope: TypedScope<AgentState>, call: {
+        readonly tool?: Tool;
+        readonly toolName: string;
+        readonly toolCallId: string;
+        readonly iteration: number;
+        readonly args: ToolArgs;
+        readonly result: unknown;
+        readonly error?: boolean;
+        readonly negativeResultId?: string;
+        readonly history: readonly LLMMessage[];
+        readonly identity?: {
+            tenant?: string;
+            principal?: string;
+            conversationId: string;
+        };
+        readonly signal?: AbortSignal;
+    }) => Promise<unknown>;
+}
+//# sourceMappingURL=middleware.d.ts.map

package/dist/types/core/agent/stages/toolCalls/contracts/operations/middleware.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"middleware.d.ts","sourceRoot":"","sources":["../../../../../../../../src/core/agent/stages/toolCalls/contracts/operations/middleware.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAC9C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AACvD,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,kCAAkC,CAAC;AAC7D,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,qCAAqC,CAAC;AACpE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,8CAA8C,CAAC;AAE/E,qEAAqE;AACrE,MAAM,WAAW,wBAAwB;IACvC,QAAQ,CAAC,WAAW,EAAE,CACpB,KAAK,EAAE,UAAU,CAAC,UAAU,CAAC,EAC7B,IAAI,EAAE;QACJ,QAAQ,CAAC,IAAI,CAAC,EAAE,IAAI,CAAC;QACrB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;QAC1B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;QAC5B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;QAC3B,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC;QACxB,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;QACzB,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC;QACzB,QAAQ,CAAC,gBAAgB,CAAC,EAAE,MAAM,CAAC;QACnC,QAAQ,CAAC,OAAO,EAAE,SAAS,UAAU,EAAE,CAAC;QACxC,QAAQ,CAAC,QAAQ,CAAC,EAAE;YAAE,MAAM,CAAC,EAAE,MAAM,CAAC;YAAC,SAAS,CAAC,EAAE,MAAM,CAAC;YAAC,cAAc,EAAE,MAAM,CAAA;SAAE,CAAC;QACpF,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,CAAC;KAC/B,KACE,OAAO,CAAC,OAAO,CAAC,CAAC;CACvB"}

package/dist/types/core/agent/stages/toolCalls/contracts/operations/observations.d.ts

@@ -0,0 +1,9 @@
+import type { TypedScope } from 'footprintjs';
+import type { AgentState } from '../../../../types.js';
+import type { AgentfootprintEventMap } from '../../../../../../events/registry.js';
+/** Explicit callback contract for existing observations operations. */
+export interface ToolObservationsOperations {
+    readonly emitToolStart: (scope: TypedScope<AgentState>, payload: AgentfootprintEventMap['agentfootprint.stream.tool_start']['payload']) => void;
+    readonly emitToolEnd: (scope: TypedScope<AgentState>, toolName: string, payload: AgentfootprintEventMap['agentfootprint.stream.tool_end']['payload'], ran: boolean, declaredStatus?: string | undefined, negativeResultId?: string, refusalArgs?: Readonly<Record<string, unknown>>) => void;
+}
+//# sourceMappingURL=observations.d.ts.map

package/dist/types/core/agent/stages/toolCalls/contracts/operations/observations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"observations.d.ts","sourceRoot":"","sources":["../../../../../../../../src/core/agent/stages/toolCalls/contracts/operations/observations.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAC9C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AACvD,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,sCAAsC,CAAC;AAEnF,uEAAuE;AACvE,MAAM,WAAW,0BAA0B;IACzC,QAAQ,CAAC,aAAa,EAAE,CACtB,KAAK,EAAE,UAAU,CAAC,UAAU,CAAC,EAC7B,OAAO,EAAE,sBAAsB,CAAC,kCAAkC,CAAC,CAAC,SAAS,CAAC,KAC3E,IAAI,CAAC;IACV,QAAQ,CAAC,WAAW,EAAE,CACpB,KAAK,EAAE,UAAU,CAAC,UAAU,CAAC,EAC7B,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,sBAAsB,CAAC,gCAAgC,CAAC,CAAC,SAAS,CAAC,EAC5E,GAAG,EAAE,OAAO,EACZ,cAAc,CAAC,EAAE,MAAM,GAAG,SAAS,EACnC,gBAAgB,CAAC,EAAE,MAAM,EACzB,WAAW,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,KAC5C,IAAI,CAAC;CACX"}

package/dist/types/core/agent/stages/toolCalls/contracts/operations/progress.d.ts

@@ -0,0 +1,12 @@
+import type { TypedScope } from 'footprintjs';
+import type { AgentState } from '../../../../types.js';
+import type { ToolExecutionContext } from '../../../../../../tools/tools.js';
+/** Explicit callback contract for existing progress operations. */
+export interface ToolProgressOperations {
+    readonly toolProgress: (scope: TypedScope<AgentState>, call: {
+        readonly toolName: string;
+        readonly toolCallId: string;
+        readonly iteration: number;
+    }) => Pick<ToolExecutionContext, 'progress'>;
+}
+//# sourceMappingURL=progress.d.ts.map

package/dist/types/core/agent/stages/toolCalls/contracts/operations/progress.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"progress.d.ts","sourceRoot":"","sources":["../../../../../../../../src/core/agent/stages/toolCalls/contracts/operations/progress.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAC9C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AACvD,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,kCAAkC,CAAC;AAE7E,mEAAmE;AACnE,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,YAAY,EAAE,CACrB,KAAK,EAAE,UAAU,CAAC,UAAU,CAAC,EAC7B,IAAI,EAAE;QACJ,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;QAC1B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;QAC5B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;KAC5B,KACE,IAAI,CAAC,oBAAoB,EAAE,UAAU,CAAC,CAAC;CAC7C"}

package/dist/types/core/agent/stages/toolCalls/contracts/operations/resources.d.ts

@@ -0,0 +1,13 @@
+import type { ResourceFacts } from '../../../../componentResources.js';
+import type { TypedScope } from 'footprintjs';
+import type { AgentState } from '../../../../types.js';
+import type { ToolCallsHandlerDeps } from '../handlerDeps.js';
+import type { ToolExecutionContext } from '../../../../../../tools/tools.js';
+/** Explicit callback contract for existing resources operations. */
+export interface ToolResourcesOperations {
+    readonly runFactsOf: (scope: TypedScope<AgentState>) => ReturnType<NonNullable<ToolCallsHandlerDeps['currentRun']>> | undefined;
+    readonly resourceFactsOf: (scope: TypedScope<AgentState>) => ResourceFacts;
+    readonly sessionContext: (scope: TypedScope<AgentState>, toolName: string, toolCallId: string) => Pick<ToolExecutionContext, 'runId' | 'sessionId' | 'identity' | 'redact' | 'onTeardown' | 'teardownScopes' | 'resourceOwner'>;
+    readonly endCall: (scope: TypedScope<AgentState>) => Promise<void>;
+}
+//# sourceMappingURL=resources.d.ts.map

package/dist/types/core/agent/stages/toolCalls/contracts/operations/resources.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resources.d.ts","sourceRoot":"","sources":["../../../../../../../../src/core/agent/stages/toolCalls/contracts/operations/resources.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mCAAmC,CAAC;AACvE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAC9C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AACvD,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AAC9D,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,kCAAkC,CAAC;AAE7E,oEAAoE;AACpE,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,UAAU,EAAE,CACnB,KAAK,EAAE,UAAU,CAAC,UAAU,CAAC,KAC1B,UAAU,CAAC,WAAW,CAAC,oBAAoB,CAAC,YAAY,CAAC,CAAC,CAAC,GAAG,SAAS,CAAC;IAC7E,QAAQ,CAAC,eAAe,EAAE,CAAC,KAAK,EAAE,UAAU,CAAC,UAAU,CAAC,KAAK,aAAa,CAAC;IAC3E,QAAQ,CAAC,cAAc,EAAE,CACvB,KAAK,EAAE,UAAU,CAAC,UAAU,CAAC,EAC7B,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,MAAM,KACf,IAAI,CACP,oBAAoB,EAClB,OAAO,GACP,WAAW,GACX,UAAU,GACV,QAAQ,GACR,YAAY,GACZ,gBAAgB,GAChB,eAAe,CAClB,CAAC;IACF,QAAQ,CAAC,OAAO,EAAE,CAAC,KAAK,EAAE,UAAU,CAAC,UAAU,CAAC,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CACpE"}

package/dist/types/core/agent/stages/toolCalls/contracts/operations/resumedInvocation.d.ts

@@ -0,0 +1,31 @@
+import type { TypedScope } from 'footprintjs';
+import type { AgentState } from '../../../../types.js';
+import type { Resolution, ResumedCallFacts } from '../callFacts.js';
+import type { ConsentGateKind } from '../../../../../pause.js';
+import type { ReadToolResultEnvelope } from '../../../../../../semantics/toolEffects.js';
+/** The existing resumed invocation contract; no new execution path. */
+export interface ResumedInvocation {
+    readonly resolveCredentialAndExecute: (scope: TypedScope<AgentState>, resolved: Resolution, toolName: string, args: Readonly<Record<string, unknown>>, toolCallId: string, iteration: number, env: {
+        readonly signal?: AbortSignal;
+    }, heldTo?: ConsentGateKind, seen?: ResumedCallFacts) => Promise<{
+        result: unknown;
+        error?: boolean;
+        executed?: boolean;
+        negativeResultId?: string;
+        /** The recognized effects envelope, when the tool returned one (9.19.0)
+         *  — `result` above is already its unwrapped `content`. When the ceiling
+         *  fired this carries the refusal as `content` and status `'invalid'`
+         *  (synthesized empty-effects for a non-envelope result), so every resume
+         *  path routes the status without knowing about ceilings. */
+        envelope?: ReadToolResultEnvelope;
+        /** The tool's own `resultCeiling` refused the result (9.20.0): `result`
+         *  is the teaching refusal, the true size is on the record. The call ran
+         *  — but it must not complete a procedure step (the model was told to
+         *  call again). */
+        ceilingRefused?: true;
+        /** An approved call's arguments no longer matched its request at the
+         *  last moment before `execute` (`heldTo`): the call did not run. */
+        callChanged?: true;
+    }>;
+}
+//# sourceMappingURL=resumedInvocation.d.ts.map

package/dist/types/core/agent/stages/toolCalls/contracts/operations/resumedInvocation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resumedInvocation.d.ts","sourceRoot":"","sources":["../../../../../../../../src/core/agent/stages/toolCalls/contracts/operations/resumedInvocation.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAC9C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AACvD,OAAO,KAAK,EAAE,UAAU,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AACpE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAC/D,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,4CAA4C,CAAC;AAEzF,uEAAuE;AACvE,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,2BAA2B,EAAE,CACpC,KAAK,EAAE,UAAU,CAAC,UAAU,CAAC,EAC7B,QAAQ,EAAE,UAAU,EACpB,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,EACvC,UAAU,EAAE,MAAM,EAClB,SAAS,EAAE,MAAM,EACjB,GAAG,EAAE;QAAE,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,CAAA;KAAE,EACtC,MAAM,CAAC,EAAE,eAAe,EACxB,IAAI,CAAC,EAAE,gBAAgB,KACpB,OAAO,CAAC;QACX,MAAM,EAAE,OAAO,CAAC;QAChB,KAAK,CAAC,EAAE,OAAO,CAAC;QAChB,QAAQ,CAAC,EAAE,OAAO,CAAC;QACnB,gBAAgB,CAAC,EAAE,MAAM,CAAC;QAC1B;;;;qEAI6D;QAC7D,QAAQ,CAAC,EAAE,sBAAsB,CAAC;QAClC;;;2BAGmB;QACnB,cAAc,CAAC,EAAE,IAAI,CAAC;QACtB;6EACqE;QACrE,WAAW,CAAC,EAAE,IAAI,CAAC;KACpB,CAAC,CAAC;CACJ"}

package/dist/types/core/agent/stages/toolCalls/contracts/operations/scripts.d.ts

@@ -0,0 +1,41 @@
+import type { TypedScope } from 'footprintjs';
+import type { AgentState } from '../../../../types.js';
+import type { Tool } from '../../../../../../tools/tools.js';
+import type { CallSettlement } from '../../../../scripts/label.js';
+import type { CodeRunFacts, CodeRunSlot } from '../../../../../codeRunnerTool.js';
+import type { ResumedCallFacts } from '../callFacts.js';
+/** Explicit callback contract for existing scripts operations. */
+export interface ToolScriptsOperations {
+    readonly fileScript: (scope: TypedScope<AgentState>, call: {
+        readonly tool: Tool | undefined;
+        readonly toolName: string;
+        readonly toolCallId: string;
+        readonly iteration: number;
+        /** The declared argument's value as the call arrived (`programOfCall`). */
+        readonly proposed: unknown;
+        /** Its value handed to `execute` — or as it stood at a pause or a refusal. */
+        readonly submitted?: unknown;
+        readonly settlement: CallSettlement;
+        readonly facts?: CodeRunFacts;
+        readonly withheld?: boolean;
+        readonly paused?: boolean;
+        /** The dispatch a settling paused call already has (`pausedScriptDispatch`). */
+        readonly dispatch?: number;
+    }) => number | undefined;
+    readonly programOfCall: (tool: Tool | undefined, args: Readonly<Record<string, unknown>> | undefined) => unknown;
+    readonly proposedArgsOf: (scope: TypedScope<AgentState>, toolCallId: string) => Readonly<Record<string, unknown>> | undefined;
+    readonly fileResumedScript: (scope: TypedScope<AgentState>, call: {
+        readonly toolName: string;
+        readonly toolCallId: string;
+        readonly iteration: number;
+        readonly carried: Readonly<Record<string, unknown>>;
+        readonly entered: boolean;
+        readonly seen: ResumedCallFacts;
+    }) => void;
+    readonly takeCodeRun: (scope: TypedScope<AgentState>, tool: Tool, slot: CodeRunSlot, call: {
+        readonly toolName: string;
+        readonly toolCallId: string;
+        readonly takeListed: boolean;
+    }) => CodeRunFacts | undefined;
+}
+//# sourceMappingURL=scripts.d.ts.map

package/dist/types/core/agent/stages/toolCalls/contracts/operations/scripts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scripts.d.ts","sourceRoot":"","sources":["../../../../../../../../src/core/agent/stages/toolCalls/contracts/operations/scripts.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAC9C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AACvD,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,kCAAkC,CAAC;AAC7D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AACnE,OAAO,KAAK,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,kCAAkC,CAAC;AAClF,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAExD,kEAAkE;AAClE,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,UAAU,EAAE,CACnB,KAAK,EAAE,UAAU,CAAC,UAAU,CAAC,EAC7B,IAAI,EAAE;QACJ,QAAQ,CAAC,IAAI,EAAE,IAAI,GAAG,SAAS,CAAC;QAChC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;QAC1B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;QAC5B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;QAC3B,2EAA2E;QAC3E,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;QAC3B,8EAA8E;QAC9E,QAAQ,CAAC,SAAS,CAAC,EAAE,OAAO,CAAC;QAC7B,QAAQ,CAAC,UAAU,EAAE,cAAc,CAAC;QACpC,QAAQ,CAAC,KAAK,CAAC,EAAE,YAAY,CAAC;QAC9B,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAC;QAC5B,QAAQ,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC;QAC1B,gFAAgF;QAChF,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;KAC5B,KACE,MAAM,GAAG,SAAS,CAAC;IACxB,QAAQ,CAAC,aAAa,EAAE,CACtB,IAAI,EAAE,IAAI,GAAG,SAAS,EACtB,IAAI,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GAAG,SAAS,KAChD,OAAO,CAAC;IACb,QAAQ,CAAC,cAAc,EAAE,CACvB,KAAK,EAAE,UAAU,CAAC,UAAU,CAAC,EAC7B,UAAU,EAAE,MAAM,KACf,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GAAG,SAAS,CAAC;IACnD,QAAQ,CAAC,iBAAiB,EAAE,CAC1B,KAAK,EAAE,UAAU,CAAC,UAAU,CAAC,EAC7B,IAAI,EAAE;QACJ,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;QAC1B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;QAC5B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;QAC3B,QAAQ,CAAC,OAAO,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;QACpD,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;QAC1B,QAAQ,CAAC,IAAI,EAAE,gBAAgB,CAAC;KACjC,KACE,IAAI,CAAC;IACV,QAAQ,CAAC,WAAW,EAAE,CACpB,KAAK,EAAE,UAAU,CAAC,UAAU,CAAC,EAC7B,IAAI,EAAE,IAAI,EACV,IAAI,EAAE,WAAW,EACjB,IAAI,EAAE;QAAE,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAA;KAAE,KAC3F,YAAY,GAAG,SAAS,CAAC;CAC/B"}

package/dist/types/core/agent/stages/toolCalls/contracts/operations/semantics.d.ts

@@ -0,0 +1,11 @@
+import type { TypedScope } from 'footprintjs';
+import type { AgentState } from '../../../../types.js';
+/** Explicit callback contract for existing semantics operations. */
+export interface ToolSemanticsOperations {
+    readonly declareSemantics: (scope: TypedScope<AgentState>, call: {
+        readonly toolName: string;
+        readonly toolCallId: string;
+        readonly iteration: number;
+    }, value: unknown) => unknown | undefined;
+}
+//# sourceMappingURL=semantics.d.ts.map

package/dist/types/core/agent/stages/toolCalls/contracts/operations/semantics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"semantics.d.ts","sourceRoot":"","sources":["../../../../../../../../src/core/agent/stages/toolCalls/contracts/operations/semantics.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAC9C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAEvD,oEAAoE;AACpE,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,gBAAgB,EAAE,CACzB,KAAK,EAAE,UAAU,CAAC,UAAU,CAAC,EAC7B,IAAI,EAAE;QAAE,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;KAAE,EAC5F,KAAK,EAAE,OAAO,KACX,OAAO,GAAG,SAAS,CAAC;CAC1B"}

package/dist/types/core/agent/stages/toolCalls/contracts/operations/settlement.d.ts

@@ -0,0 +1,14 @@
+import type { TypedScope } from 'footprintjs';
+import type { AgentState } from '../../../../types.js';
+import type { LLMMessage } from '../../../../../../provider-contract/types.js';
+import type { BatchSettlement } from '../callFacts.js';
+/** Explicit callback contract for existing settlement operations. */
+export interface ToolSettlementOperations {
+    readonly historyForCheckIn: (scope: TypedScope<AgentState>, history: readonly LLMMessage[]) => LLMMessage[];
+    readonly settleBatch: (answered: LLMMessage[], paused: {
+        readonly toolName: string;
+        readonly toolCallId: string;
+    }) => BatchSettlement;
+    readonly bracketSettled: (scope: TypedScope<AgentState>, settlement: BatchSettlement) => void;
+}
+//# sourceMappingURL=settlement.d.ts.map

package/dist/types/core/agent/stages/toolCalls/contracts/operations/settlement.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"settlement.d.ts","sourceRoot":"","sources":["../../../../../../../../src/core/agent/stages/toolCalls/contracts/operations/settlement.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAC9C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AACvD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,8CAA8C,CAAC;AAC/E,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAEvD,qEAAqE;AACrE,MAAM,WAAW,wBAAwB;IACvC,QAAQ,CAAC,iBAAiB,EAAE,CAC1B,KAAK,EAAE,UAAU,CAAC,UAAU,CAAC,EAC7B,OAAO,EAAE,SAAS,UAAU,EAAE,KAC3B,UAAU,EAAE,CAAC;IAClB,QAAQ,CAAC,WAAW,EAAE,CACpB,QAAQ,EAAE,UAAU,EAAE,EACtB,MAAM,EAAE;QAAE,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;KAAE,KAC/D,eAAe,CAAC;IACrB,QAAQ,CAAC,cAAc,EAAE,CAAC,KAAK,EAAE,UAAU,CAAC,UAAU,CAAC,EAAE,UAAU,EAAE,eAAe,KAAK,IAAI,CAAC;CAC/F"}

package/dist/types/core/agent/stages/toolCalls/contracts/operations/steps.d.ts

@@ -0,0 +1,27 @@
+import type { TypedScope } from 'footprintjs';
+import type { AgentState } from '../../../../types.js';
+import type { StepPointer, StepPlan } from '../../../../../../injection-engine/skillSteps.js';
+/** Explicit callback contract for existing steps operations. */
+export interface ToolStepsOperations {
+    readonly stepStateOf: (scope: TypedScope<AgentState>) => {
+        ptr: StepPointer;
+        plan: StepPlan;
+        step: {
+            tool: string;
+            note: string;
+        };
+    } | undefined;
+    readonly applySkipStep: (scope: TypedScope<AgentState>, call: {
+        readonly args: Readonly<Record<string, unknown>>;
+        readonly toolCallId: string;
+        readonly iteration: number;
+    }) => string;
+    readonly applyStepReturn: (scope: TypedScope<AgentState>, call: {
+        readonly toolName: string;
+        readonly toolCallId: string;
+        readonly iteration: number;
+    }) => string;
+    readonly readSkillStepIntroFor: (pickedId: string) => string;
+    readonly noteSkillRefusal: (scope: TypedScope<AgentState>, iteration: number) => void;
+}
+//# sourceMappingURL=steps.d.ts.map

package/dist/types/core/agent/stages/toolCalls/contracts/operations/steps.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"steps.d.ts","sourceRoot":"","sources":["../../../../../../../../src/core/agent/stages/toolCalls/contracts/operations/steps.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAC9C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AACvD,OAAO,KAAK,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,kDAAkD,CAAC;AAE9F,gEAAgE;AAChE,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,WAAW,EAAE,CACpB,KAAK,EAAE,UAAU,CAAC,UAAU,CAAC,KAC1B;QAAE,GAAG,EAAE,WAAW,CAAC;QAAC,IAAI,EAAE,QAAQ,CAAC;QAAC,IAAI,EAAE;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,IAAI,EAAE,MAAM,CAAA;SAAE,CAAA;KAAE,GAAG,SAAS,CAAC;IAC5F,QAAQ,CAAC,aAAa,EAAE,CACtB,KAAK,EAAE,UAAU,CAAC,UAAU,CAAC,EAC7B,IAAI,EAAE;QACJ,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;QACjD,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;QAC5B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;KAC5B,KACE,MAAM,CAAC;IACZ,QAAQ,CAAC,eAAe,EAAE,CACxB,KAAK,EAAE,UAAU,CAAC,UAAU,CAAC,EAC7B,IAAI,EAAE;QAAE,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;KAAE,KACzF,MAAM,CAAC;IACZ,QAAQ,CAAC,qBAAqB,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,MAAM,CAAC;IAC7D,QAAQ,CAAC,gBAAgB,EAAE,CAAC,KAAK,EAAE,UAAU,CAAC,UAAU,CAAC,EAAE,SAAS,EAAE,MAAM,KAAK,IAAI,CAAC;CACvF"}

package/dist/types/core/agent/stages/toolCalls/contracts/resources.d.ts

@@ -0,0 +1,68 @@
+import type { MemoryIdentity } from '../../../../../memory/identity/types.js';
+import type { ComponentResources } from '../../../componentResources.js';
+/** The resources dependencies of the existing tool-call stage. */
+export interface ToolResourcesPort {
+    /**
+     * The durable-write barrier (`core/durabilityBarrier.ts`). Asked ONCE per
+     * iteration, before any of this iteration's tools are dispatched: if the last
+     * iteration's state is still being written to a session store, wait for it.
+     *
+     * This is what bounds side-effect replay. Without it, iteration N's tools run
+     * while iteration N-1's write is in flight, so a crash can re-issue more than
+     * one iteration's worth of tool calls on replay and "how much re-executes?"
+     * has no answer. With it the answer is exactly one: the current iteration.
+     *
+     * Returns `undefined` when nobody installed a barrier — the ordinary case —
+     * and the dispatch loop then does not await at all, so an agent without a
+     * durable session composer is byte-identical in behaviour AND in timing.
+     *
+     * NOT a general extension point: the only installer is
+     * `agentfootprint/hosting`'s session writer, through a module-private
+     * WeakMap that appears on no barrel. See `core/durabilityBarrier.ts`.
+     *
+     * @internal
+     */
+    readonly awaitDurable?: () => Promise<void> | undefined;
+    /**
+     * The identity facts THIS run carries, for `ToolExecutionContext` (9.7.0).
+     *
+     * An ACCESSOR, for the same reason `awaitDurable` is one: the chart is built
+     * ONCE at construction and these change per run, so a captured value would be
+     * run #1's forever. Read once per dispatch loop, beside `scope.runIdentity`.
+     *
+     * `identity` here is the CALLER's explicit identity (`Agent.lastRunIdentity`),
+     * NOT `scope.runIdentity` — the latter is always populated, defaulting to
+     * `{ conversationId: '<runId>' }` (or, on a session-bound run since 9.10.0,
+     * to `{ conversationId: sessionId }`), and publishing either to a tool would
+     * present a synthesized conversation as one somebody named.
+     *
+     * @internal
+     */
+    /**
+     * Is this stage running in the agent's OWN executor? Asked of the scope
+     * (`stages/seed.ts` · `isOwnRun`): a stage in another runner's executor — a
+     * composition member — retains the actual native component run facts and
+     * takes only its explicit member identity from `scope.memberRun`. The
+     * member link never substitutes a different executor's run context.
+     * Absent → the agent's own run.
+     *
+     * @internal
+     */
+    readonly isOwnRun?: (scope: object) => boolean;
+    /** Captured native leg/component liveness, never the runner selected by a later call. */
+    readonly isRunRetired: () => boolean;
+    readonly currentRun?: () => {
+        readonly runContext?: import('../../../../../bridge/eventMeta.js').RunContext;
+        readonly runId: string;
+        readonly sessionId?: string;
+        readonly identity?: MemoryIdentity;
+    };
+    /**
+     * This native component's resource adapter. It persists finite references
+     * before tool resource effects and borrows the existing shared tier before
+     * dispatch. Live views and callbacks never cross checkpoints.
+     * @internal
+     */
+    readonly resources?: ComponentResources;
+}
+//# sourceMappingURL=resources.d.ts.map

package/dist/types/core/agent/stages/toolCalls/contracts/resources.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resources.d.ts","sourceRoot":"","sources":["../../../../../../../src/core/agent/stages/toolCalls/contracts/resources.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,yCAAyC,CAAC;AAC9E,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,gCAAgC,CAAC;AAEzE,kEAAkE;AAClE,MAAM,WAAW,iBAAiB;IAChC;;;;;;;;;;;;;;;;;;;OAmBG;IACH,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,GAAG,SAAS,CAAC;IACxD;;;;;;;;;;;;;;OAcG;IACH;;;;;;;;;OASG;IACH,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC;IAC/C,yFAAyF;IACzF,QAAQ,CAAC,YAAY,EAAE,MAAM,OAAO,CAAC;IACrC,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM;QAC1B,QAAQ,CAAC,UAAU,CAAC,EAAE,OAAO,oCAAoC,EAAE,UAAU,CAAC;QAC9E,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;QACvB,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;QAC5B,QAAQ,CAAC,QAAQ,CAAC,EAAE,cAAc,CAAC;KACpC,CAAC;IACF;;;;;OAKG;IACH,QAAQ,CAAC,SAAS,CAAC,EAAE,kBAAkB,CAAC;CACzC"}