agentfootprint 13.0.0 → 14.0.0

package/dist/esm/core/agent/stages/toolCalls/execution/initialInvocation.js

@@ -0,0 +1,341 @@
+import { unknownToolResult } from '../helpers/dispatchRefusals.js';
+import { CODE_RUN_SLOT } from '../../../../codeRunnerTool.js';
+import { reportingCredentials } from '../decorators/reportingCredentials.js';
+import { requestEvidenceFor } from '../../../../../tools/requestEvidence.js';
+import { mcpClientUseFor } from '../../../../../tools/mcpClientUse.js';
+import { startNegativeCall, captureNegativeResult, keepNegativeResultOut, pauseNegativeCall, } from '../../../negativeClaims/capture.js';
+import { readToolResultEnvelope, explainStatusOnlyNearMiss, } from '../../../../../semantics/toolEffects.js';
+import { isPauseRequest } from '../../../../pause.js';
+import { validateInputDeclaration, stampInputRequest, repeatOf, } from '../../../../../tools/inputRequest.js';
+/** Existing initialInvocation body; original guard and native pause return stay with the handler. */
+export async function invokeInitialTool(scope, deps, frame) {
+    try {
+        // The two refusals share one door: a name nothing holds, and a
+        // name whose offered party cannot answer (9.92.0). Both land as
+        // an errored tool result the model reads, on the same path.
+        if (!frame.tool) {
+            throw new Error(frame.resolved.refusal ?? unknownToolResult(frame.tc.name, frame.dispatchRoster(scope)));
+        }
+        frame.noteOffWire(scope, frame.resolved, {
+            toolName: frame.tc.name,
+            toolCallId: frame.tc.id,
+            iteration: frame.iteration,
+        });
+        // The time layer's dispatch moment — just before the tool runs.
+        // A look-back the clock drifted past is redrawn here (§ 7.4) — `callArgs`
+        // carries what the tool ran with, so the note and the results layer read it.
+        const dispatched = deps.time !== undefined
+            ? (await import('../../timeLayer.js')).timeAtDispatch(scope, { toolCallId: frame.tc.id, toolName: frame.tc.name }, frame.iteration, frame.tool, frame.callArguments.callArgs, deps.time.appZone)
+            : undefined;
+        const callTime = dispatched?.context;
+        if (dispatched !== undefined)
+            frame.callArguments.callArgs = dispatched.args;
+        // Set BEFORE the await: a tool that throws has still run, and a
+        // tool that does not exist has not. This flag is the entire
+        // precondition of the after-tool moment below.
+        // This dispatch's own slot for the runner's facts — see the
+        // resume path's twin in `resolveCredentialAndExecute`.
+        const codeRunSlot = {};
+        const executionContext = {
+            [CODE_RUN_SLOT]: codeRunSlot,
+            toolCallId: frame.tc.id,
+            iteration: frame.iteration,
+            ...(callTime !== undefined && { time: callTime }),
+            ...(frame.env.signal && { signal: frame.env.signal }),
+            credentials: reportingCredentials(frame.credentialsIn(scope, frame.tool.needs?.credential), frame.emitSecurity, frame.tc.name),
+            hasCredentials: frame.hasCredentials,
+            ...(frame.authorization.resolvedCredential && {
+                credential: frame.authorization.resolvedCredential,
+            }),
+            ...frame.toolArtifacts(scope, frame.tc.name, frame.tc.id),
+            ...(frame.wanted.wantedMeta !== undefined && { wanted: frame.wanted.wantedMeta }),
+            ...frame.toolProgress(scope, {
+                toolName: frame.tc.name,
+                toolCallId: frame.tc.id,
+                iteration: frame.iteration,
+            }),
+            ...requestEvidenceFor(scope, {
+                toolName: frame.tc.name,
+                toolCallId: frame.tc.id,
+                iteration: frame.iteration,
+            }),
+            ...mcpClientUseFor(scope, { toolCallId: frame.tc.id }),
+            ...frame.sessionContext(scope, frame.tc.name, frame.tc.id),
+            ...frame.toolDispatchCtx(scope, { toolName: frame.tc.name, toolCallId: frame.tc.id, iteration: frame.iteration }, frame.env.signal),
+        };
+        // `Tool.search`: the result identity is reserved and the dispatch
+        // instant taken just BEFORE the call runs (the row's address,
+        // never the provider's call id; a relative window's clock).
+        const searchDispatch = frame.searchFunnel.dispatch(scope, frame.tool, callTime);
+        frame.execution.negativeDispatch =
+            deps.negativeClaimsArmed === true
+                ? startNegativeCall(scope, {
+                    tool: frame.tool,
+                    party: frame.resolved.party,
+                    args: frame.callArguments.callArgs,
+                    toolCallId: frame.tc.id,
+                    iteration: frame.iteration,
+                    runId: frame.runFactsOf(scope)?.runId,
+                    dispatch: searchDispatch,
+                    context: executionContext,
+                })
+                : undefined;
+        frame.execution.executed = true;
+        frame.execution.submittedProgram = frame.programOfCall(frame.tool, frame.callArguments.callArgs);
+        frame.outcome.result = await frame.tool.execute(frame.callArguments.callArgs, executionContext);
+        if (frame.execution.negativeDispatch !== undefined)
+            frame.outcome.result = captureNegativeResult(scope, frame.execution.negativeDispatch, frame.outcome.result, frame.tool);
+        // A code-runner tool leaves the SHAPE of what it just ran, keyed by
+        // this call. Taken and deleted here so the map cannot grow across
+        // a long run, and emitted from the dispatch loop rather than from
+        // the tool because this is the layer that holds `typedEmit`.
+        //
+        // The code itself is never on this channel — the same rule the
+        // session events follow with `keyHash`, never the key. Generated
+        // code quotes the data it was handed, so the program is the one
+        // part of a code run that must not reach an exporter.
+        frame.execution.ranCode = frame.takeCodeRun(scope, frame.tool, codeRunSlot, {
+            toolName: frame.tc.name,
+            toolCallId: frame.tc.id,
+            takeListed: true,
+        });
+        // The typed effects channel (9.19.0): a recognized envelope is
+        // unwrapped HERE, at the one boundary the raw return crosses —
+        // everything downstream (governance rules, the cap, history,
+        // `tool_end`) sees the CONTENT, exactly what a bare return
+        // would have shown. The effects are judged below, after the
+        // gates, in call order.
+        const envelope = readToolResultEnvelope(frame.outcome.result);
+        if (envelope !== undefined) {
+            frame.outcome.toolEnvelope = envelope;
+            frame.outcome.result = envelope.content;
+            frame.outcome.toolStatus = envelope.status;
+        }
+        else {
+            // A status-only shape missing its `effects: []` marker is
+            // DATA (bytes unchanged) — but never silently: name the
+            // dropped marker in dev mode.
+            const nearMiss = explainStatusOnlyNearMiss(frame.outcome.result);
+            if (nearMiss !== undefined)
+                frame.warnEffect(frame.tc.name, nearMiss);
+        }
+        // Coverage (this release), on the UNWRAPPED content and before
+        // the ceiling — the boundary a tool declared is not the channel
+        // that can overflow. A tool that spelled its own status keeps
+        // it; otherwise an absence names the delivered outcome, so an
+        // `onToolStatus` edge can route "we looked and there was
+        // nothing" somewhere other than "the call broke".
+        // `Tool.search` — the coverage composed from the declaration and
+        // the arguments the call ran with, BEFORE everything that reads
+        // the value: the composed absence is what the model is served.
+        const searched = frame.searchFunnel.compose(scope, {
+            call: { toolName: frame.tc.name, toolCallId: frame.tc.id, iteration: frame.iteration },
+            tool: frame.tool,
+            ...(frame.resolved.party !== undefined && { party: frame.resolved.party }),
+            args: frame.execution.negativeDispatch?.args ??
+                frame.callArguments.callArgs,
+            ...(searchDispatch !== undefined && { dispatch: searchDispatch }),
+            ...(frame.outcome.toolStatus !== undefined && { status: frame.outcome.toolStatus }),
+        }, frame.outcome.result);
+        if (searched !== undefined)
+            frame.outcome.result = searched.value;
+        const coverageStatus = frame.declareCoverage(scope, { toolName: frame.tc.name, toolCallId: frame.tc.id, iteration: frame.iteration }, frame.outcome.result, searched?.reading);
+        if (frame.outcome.toolStatus === undefined)
+            frame.outcome.toolStatus = coverageStatus;
+        // The semantic envelope (9.53.0), on the unwrapped content and
+        // AFTER coverage (whose funnel absorbs the envelope's own
+        // `coverage` field), BEFORE the ceiling (which must measure
+        // what the model will actually read, and must not silently
+        // delete grain/provenance — they are already on the record by
+        // the time it fires). Everything downstream — governance, the
+        // cap, history, `tool_end` — sees the compact projection; the
+        // full envelope rides `tools.semantics_declared`.
+        const semanticView = frame.declareSemantics(scope, { toolName: frame.tc.name, toolCallId: frame.tc.id, iteration: frame.iteration }, frame.outcome.result);
+        if (semanticView !== undefined)
+            frame.outcome.result = semanticView;
+        // The tool's own refusing ceiling (9.20.0) — at the execute
+        // boundary, BEFORE the gates and the after-tool chain, so
+        // governance and the agent-level cap compose over what the
+        // model will actually read (the read_skill-gate precedent).
+        // A recognized envelope's DECLARED effects (`toolEnvelope`)
+        // are still judged below — the effects channel is not the
+        // channel that overflowed; the delivered status becomes
+        // 'invalid' so `onToolStatus` edges can route the overflow
+        // (the declared one rides the `result_refused` event).
+        const overflowRefusal = frame.refuseOverCeiling(scope, { toolName: frame.tc.name, toolCallId: frame.tc.id, iteration: frame.iteration }, frame.tool, frame.outcome.result, frame.outcome.toolStatus);
+        if (overflowRefusal !== undefined) {
+            if (frame.execution.negativeDispatch !== undefined)
+                keepNegativeResultOut(scope, frame.execution.negativeDispatch.resultId);
+            frame.execution.ceilingRefused = true;
+            frame.execution.withheldOverCeiling = true;
+            frame.outcome.result = overflowRefusal;
+            frame.outcome.toolStatus = 'invalid';
+        }
+        else {
+            // The column-type contract (9.78.0) — the main batch-loop
+            // door, one step after the ceiling. Only when the payload
+            // survived it: rows nobody will read have no columns worth
+            // arguing about.
+            const columnRefusal = frame.judgeColumns(scope, { toolName: frame.tc.name, toolCallId: frame.tc.id, iteration: frame.iteration }, frame.outcome.result);
+            if (columnRefusal !== undefined) {
+                if (frame.execution.negativeDispatch !== undefined)
+                    keepNegativeResultOut(scope, frame.execution.negativeDispatch.resultId);
+                frame.execution.ceilingRefused = true;
+                frame.outcome.result = columnRefusal;
+                frame.outcome.toolStatus = 'invalid';
+            }
+        }
+        await frame.endCall(scope);
+    }
+    catch (err) {
+        // Set when a raise declared a miss the door could not file:
+        // the call then errors with this text and does not pause.
+        let raisedMissError;
+        // In a batch whose one human question was the inputs layer's ask
+        // (`oneQuestionAsked`), the tool's own pause cannot be given: the
+        // call settles as an error below, with the refusal sentence.
+        if (isPauseRequest(err) && !frame.oneQuestionAsked) {
+            // The typed half of the question (9.24.0): a tool that raised
+            // `askHuman({ question, component })` nominated a screen
+            // component, and the nomination is judged HERE — the raise
+            // site — before the pause is allowed to happen. The tool
+            // usually minted `propsRef` via ctx.artifacts moments ago;
+            // this validates the ref it chose to carry still resolves in
+            // this run's scope, so the throw (which fails the run loudly,
+            // naming the fix) lands in the author's lap and never in the
+            // answering person's. Pauses without a component skip this
+            // entirely — byte-identical.
+            if (typeof err.data === 'object' && err.data !== null) {
+                const rawComponent = err.data.component;
+                if (rawComponent !== undefined) {
+                    await frame.assertComponentDeliverable(scope, frame.tc.name, rawComponent, `askHuman in tool '${frame.tc.name}'`);
+                }
+            }
+            const declaration = typeof err.data === 'object' && err.data !== null
+                ? err.data.inputRequest
+                : undefined;
+            // A lookup that pauses still declares what it looked at
+            // (9.114.0): the miss it is asking about is filed HERE, the
+            // raise site, FIRST — the one moment the declaration's
+            // `absence` is read. So a declaration that CARRIES one is
+            // judged before anything is written for the pause, and a miss
+            // the door cannot file errors the call below, as the same value
+            // returned would, with nothing written for a pause. A MALFORMED
+            // declaration still leaves the committed record it always left,
+            // whether or not it carried `absence`: its error leaves the
+            // stage only after the pause writes are made, so a hand-raised
+            // request (a `pauseHere`/`askHuman` that never went through
+            // `requestInput`) fails with the in-flight batch on the record.
+            // `null` is the field omitted (`inputRequest.ts` ·
+            // `validateInputDeclaration`).
+            //
+            // The pause writes: partial state, so resume() can find the
+            // history intact.
+            const writePause = () => {
+                if (frame.execution.negativeDispatch !== undefined)
+                    pauseNegativeCall(scope, frame.execution.negativeDispatch.resultId);
+                scope.history = frame.newHistory;
+                scope.pausedToolCallId = frame.tc.id;
+                scope.pausedToolName = frame.tc.name;
+                scope.pausedToolStartMs = frame.startMs;
+                // The args the tool WAS RUNNING WITH (post-transform), for
+                // the after-tool moment on the far side of the pause
+                // (8.13.0) — the same reason the three sibling pauses carry
+                // theirs.
+                scope.pausedToolArgs = frame.callArguments.callArgs;
+            };
+            const carriesAbsence = typeof declaration === 'object' &&
+                declaration !== null &&
+                declaration.absence != null;
+            let declared;
+            if (carriesAbsence) {
+                try {
+                    declared = validateInputDeclaration(declaration);
+                }
+                catch (invalid) {
+                    writePause();
+                    throw invalid;
+                }
+            }
+            raisedMissError =
+                declared?.absence === undefined
+                    ? undefined
+                    : frame.declareRaisedAbsence(scope, { toolName: frame.tc.name, toolCallId: frame.tc.id, iteration: frame.iteration }, frame.callArguments.callArgs, declared.absence, frame.newHistory);
+            if (raisedMissError === undefined) {
+                // A pause has NOT settled this call — it is waiting for a
+                // person, and the resources it opened are what the resume
+                // needs. No `'call'` teardown here, deliberately.
+                writePause();
+                // The tool asked from INSIDE `execute`: its program is the
+                // value read before it ran, never the arguments as it left them.
+                const pausedDispatch = frame.fileScript(scope, {
+                    tool: frame.tool,
+                    toolName: frame.tc.name,
+                    toolCallId: frame.tc.id,
+                    iteration: frame.iteration,
+                    proposed: frame.proposedProgram,
+                    submitted: frame.execution.submittedProgram,
+                    settlement: 'not-entered',
+                    paused: true,
+                });
+                // The resume settles this call without running it again, so
+                // the values read before it ran ride the checkpoint.
+                if (pausedDispatch !== undefined) {
+                    scope.pausedScriptPrograms = {
+                        ...(typeof frame.proposedProgram === 'string' && { proposed: frame.proposedProgram }),
+                        ...(typeof frame.execution.submittedProgram === 'string' && {
+                            submitted: frame.execution.submittedProgram,
+                        }),
+                    };
+                }
+                const stamped = declaration === undefined ? undefined : declared ?? validateInputDeclaration(declaration);
+                const awaitingInput = stamped === undefined
+                    ? undefined
+                    : stampInputRequest(stamped, `${frame.runFactsOf(scope)?.runId ?? scope.turnStartMs}:${frame.tc.id}`, {
+                        originalRequest: scope.userMessage,
+                        toolCallId: frame.tc.id,
+                        ...(scope.currentSkillId !== undefined && {
+                            skillId: scope.currentSkillId,
+                        }),
+                        ...(scope.turnRoute?.offered !== undefined && {
+                            offeredSkillIds: [...scope.turnRoute.offered],
+                        }),
+                    }, 
+                    // A re-ask of the ask this run's resume answered is
+                    // never silent: the count, and the previous
+                    // answer as the record holds it — facts, no reason.
+                    repeatOf(stamped, deps.answeredAsk?.(), frame.newHistory));
+                // Returning a defined value triggers footprintjs pause —
+                // the returned object becomes the checkpoint's pauseData.
+                return {
+                    toolCallId: frame.tc.id,
+                    toolName: frame.tc.name,
+                    ...(awaitingInput !== undefined
+                        ? { question: awaitingInput.question, awaitingInput }
+                        : typeof err.data === 'object' && err.data !== null
+                            ? err.data
+                            : { data: err.data }),
+                };
+            }
+        }
+        // A tool that threw still RAN, and may have opened the thing it
+        // was about to close. A raise whose miss could not be filed is
+        // settled here too — the returned path's error, not a pause.
+        await frame.endCall(scope);
+        frame.outcome.error = true;
+        frame.execution.executeThrew = frame.execution.executed;
+        frame.outcome.result =
+            raisedMissError ??
+                (frame.askedLayer !== undefined && isPauseRequest(err)
+                    ? // Reached only in the batch that asked (a pause anywhere
+                        // else returned above, or set `raisedMissError`): the
+                        // answers the call carried are kept for its next proposal.
+                        frame.askedLayer.secondPauseRefusal(frame.tc.name, 'tool-pause') +
+                            frame.askedLayer.keptNote(scope, frame.tc.name, frame.resolution, frame.tool, frame.callArguments.callArgs)
+                    : err instanceof Error
+                        ? err.message
+                        : String(err));
+    }
+    return undefined;
+}
+//# sourceMappingURL=initialInvocation.js.map

package/dist/esm/core/agent/stages/toolCalls/execution/initialInvocation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"initialInvocation.js","sourceRoot":"","sources":["../../../../../../../src/core/agent/stages/toolCalls/execution/initialInvocation.ts"],"names":[],"mappings":"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"}

package/dist/esm/core/agent/stages/toolCalls/execution/resourcesOperations.d.ts

@@ -0,0 +1,9 @@
+import type { TeardownScope } from '../../../../../tools/toolSessions.js';
+import type { ToolCallsHandlerDeps } from '../contracts/handlerDeps.js';
+import type { ToolResourcesOperations } from '../contracts/operations/resources.js';
+interface ToolResourcesOperationsLinks {
+    readonly AGENT_TEARDOWN_SCOPES: readonly TeardownScope[];
+}
+/** Compose the existing resources callbacks once for this handler. */
+export declare function buildToolResourcesOperations(deps: Pick<ToolCallsHandlerDeps, 'isOwnRun' | 'currentRun' | 'resources'>, links: ToolResourcesOperationsLinks): ToolResourcesOperations;
+export {};

package/dist/esm/core/agent/stages/toolCalls/execution/resourcesOperations.js

@@ -0,0 +1,86 @@
+import { runOfLink } from '../../../../memberRun.js';
+import { captureLateEmitter, policyInForce } from '../../../../../redaction/runRedaction.js';
+import { typedEmit } from '../../../../../recorders/core/typedEmit.js';
+/** Compose the existing resources callbacks once for this handler. */
+export function buildToolResourcesOperations(deps, links) {
+    const runFactsOf = (scope) => {
+        const actual = deps.currentRun?.();
+        if (deps.isOwnRun?.(scope) !== false || actual === undefined)
+            return actual;
+        const memberRun = scope.memberRun;
+        const member = memberRun?.link === '' ? memberRun : runOfLink(memberRun?.link);
+        return { ...actual, ...(member?.identity !== undefined && { identity: member.identity }) };
+    };
+    const resourceFactsOf = (scope) => {
+        const facts = runFactsOf(scope);
+        if (facts === undefined || facts.runContext === undefined || facts.runId === '')
+            throw new TypeError('Tool resource admission requires actual native run facts');
+        return { ...facts, runContext: facts.runContext };
+    };
+    const sessionContext = (scope, toolName, toolCallId) => {
+        const facts = runFactsOf(scope);
+        const resource = deps.resources?.context(scope, resourceFactsOf(scope));
+        const redact = policyInForce(scope);
+        return {
+            ...(resource !== undefined && { resourceOwner: resource.owner }),
+            ...(facts?.runId !== undefined && { runId: facts.runId }),
+            ...(facts?.sessionId !== undefined && { sessionId: facts.sessionId }),
+            ...(facts?.identity !== undefined && { identity: facts.identity }),
+            ...(redact !== undefined && { redact }),
+            teardownScopes: links.AGENT_TEARDOWN_SCOPES,
+            onTeardown: (cleanup, options) => {
+                const scopeAsked = options?.scope ?? 'run';
+                if (!links.AGENT_TEARDOWN_SCOPES.includes(scopeAsked)) {
+                    // Named, not swallowed: an accepted registration that can never fire
+                    // is a leaked resource wearing the shape of a tidy one.
+                    throw new Error(`tool '${toolName}': onTeardown scope '${scopeAsked}' is not honoured here. ` +
+                        `This door supports: ${links.AGENT_TEARDOWN_SCOPES.join(', ')}. ` +
+                        'Read `ctx.teardownScopes` and pick one of those.');
+                }
+                const tier = resource?.view;
+                if (!tier || !resource)
+                    return;
+                const filed = tier.register(resource.owner, {
+                    tool: toolName,
+                    toolCallId,
+                    emit: captureLateEmitter(scope, 'tool-teardown#0'),
+                    ...(facts?.runContext !== undefined && { runContext: facts.runContext }),
+                    ...(facts?.runId !== undefined && { runId: facts.runId }),
+                    ...(facts?.sessionId !== undefined && { sessionId: facts.sessionId }),
+                }, cleanup, options);
+                // Emitted HERE, not from the tier, because here there is still a stage
+                // to be stamped with: a start and a reuse happen inside `tool.execute`,
+                // so they ride the ordinary scope channel and carry the real
+                // `runtimeStageId`. Only the CLOSE fires after the last stage
+                // committed, and only that one wears the `tool-teardown#0` pseudo-stage.
+                //
+                // `keyHash`, never the key: the key composes tenant, principal and the
+                // hosting sessionId, and publishing it would put a user identifier into
+                // every exporter's payload.
+                typedEmit(scope, filed.outcome === 'started'
+                    ? 'agentfootprint.tools.session_started'
+                    : 'agentfootprint.tools.session_reused', {
+                    tool: toolName,
+                    scope: scopeAsked,
+                    keyHash: filed.keyHash,
+                    ...(options?.runnerId !== undefined && { runnerId: options.runnerId }),
+                    ...(options?.label !== undefined && { label: options.label }),
+                    ...(filed.outcome === 'reused' && { calls: filed.calls }),
+                });
+            },
+        };
+    };
+    /**
+     * Fire the `'call'`-scoped cleanups this tool call registered.
+     *
+     * Runs when `execute` SETTLES — resolve or throw — because a tool that threw
+     * halfway may well have opened the thing it was about to close. Deliberately
+     * NOT on the pause path: a paused call has not settled, it is waiting for a
+     * person, and its resources are exactly what the resume needs.
+     */
+    const endCall = async (scope) => {
+        await deps.resources?.endCall(scope);
+    };
+    return { runFactsOf, resourceFactsOf, sessionContext, endCall };
+}
+//# sourceMappingURL=resourcesOperations.js.map

package/dist/esm/core/agent/stages/toolCalls/execution/resourcesOperations.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resourcesOperations.js","sourceRoot":"","sources":["../../../../../../../src/core/agent/stages/toolCalls/execution/resourcesOperations.ts"],"names":[],"mappings":"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"}

package/dist/esm/core/agent/stages/toolCalls/execution/resumedInvocation.d.ts

@@ -0,0 +1,42 @@
+import { buildArgumentRefusal } from '../access/argumentValidation.js';
+import { buildSearchCoverage } from '../../searchCoverage.js';
+import type { ToolCallsHandlerDeps } from '../contracts/handlerDeps.js';
+import type { ToolCatalogOperations } from '../contracts/operations/catalog.js';
+import type { ToolArtifactsOperations } from '../contracts/operations/artifacts.js';
+import type { ToolCredentialsOperations } from '../contracts/operations/credentials.js';
+import type { ToolContextOperations } from '../contracts/operations/context.js';
+import type { ToolProgressOperations } from '../contracts/operations/progress.js';
+import type { ToolResourcesOperations } from '../contracts/operations/resources.js';
+import type { ToolScriptsOperations } from '../contracts/operations/scripts.js';
+import type { ToolCoverageOperations } from '../contracts/operations/coverage.js';
+import type { ToolSemanticsOperations } from '../contracts/operations/semantics.js';
+import type { ToolLimitsOperations } from '../contracts/operations/limits.js';
+import type { ToolIntegrityOperations } from '../contracts/operations/integrity.js';
+import type { ToolEffectsOperations } from '../contracts/operations/effects.js';
+import type { ResumedInvocation } from '../contracts/operations/resumedInvocation.js';
+interface ResumedInvocationLinks {
+    readonly dispatchRoster: ToolCatalogOperations['dispatchRoster'];
+    readonly argumentRefusal: ReturnType<typeof buildArgumentRefusal>;
+    readonly noteOffWire: ToolCatalogOperations['noteOffWire'];
+    readonly resolveWantsAtDispatch: ToolArtifactsOperations['resolveWantsAtDispatch'];
+    readonly credentialsIn: ToolCredentialsOperations['credentialsIn'];
+    readonly hasCredentials: boolean;
+    readonly toolArtifacts: ToolContextOperations['toolArtifacts'];
+    readonly toolProgress: ToolProgressOperations['toolProgress'];
+    readonly sessionContext: ToolResourcesOperations['sessionContext'];
+    readonly toolDispatchCtx: ToolContextOperations['toolDispatchCtx'];
+    readonly endCall: ToolResourcesOperations['endCall'];
+    readonly searchFunnel: ReturnType<typeof buildSearchCoverage>;
+    readonly runFactsOf: ToolResourcesOperations['runFactsOf'];
+    readonly programOfCall: ToolScriptsOperations['programOfCall'];
+    readonly proposedArgsOf: ToolScriptsOperations['proposedArgsOf'];
+    readonly takeCodeRun: ToolScriptsOperations['takeCodeRun'];
+    readonly declareCoverage: ToolCoverageOperations['declareCoverage'];
+    readonly declareSemantics: ToolSemanticsOperations['declareSemantics'];
+    readonly refuseOverCeiling: ToolLimitsOperations['refuseOverCeiling'];
+    readonly judgeColumns: ToolIntegrityOperations['judgeColumns'];
+    readonly warnEffect: ToolEffectsOperations['warnEffect'];
+}
+/** Compose the existing resumed invocation without changing its catch/cleanup boundary. */
+export declare function buildResumedInvocation(deps: Pick<ToolCallsHandlerDeps, 'clearConsentOutstanding' | 'reportConsentOutstanding' | 'time' | 'negativeClaimsArmed'>, links: ResumedInvocationLinks): ResumedInvocation;
+export {};