eve 0.83.2 → 0.84.0

package/dist/src/context/dynamic-connection-lifecycle.js

@@ -1 +0,0 @@
-import{createLogger}from"#internal/logging.js";import{getAdapterKind}from"#channel/adapter.js";import{AuthKey,InitiatorAuthKey,SessionIdKey}from"#context/keys.js";import{toErrorMessage}from"#shared/errors.js";import{assertNotConnectionOwned}from"#connections/ownership.js";import{eveNamespaceReservation}from"#protocol/runtime-tools.js";import{readStampedConnectionProtocol}from"#public/definitions/connections/protocol.js";import{ALLOWED_DYNAMIC_CONNECTION_EVENTS}from"#dynamic/definition.js";import{dynamicToolNames}from"#context/build-dynamic-tools.js";import{ConnectionRegistryKey}from"#context/providers/connection-key.js";import{CONNECTION_SLUG_PATTERN}from"#discover/grammar.js";import{ConnectionRegistryImpl}from"#runtime/connections/registry.js";import{BundleKey,ChannelKey}from"#runtime/sessions/runtime-context-keys.js";import{resolveDynamicConnectionValue}from"#runtime/resolve-connection.js";const log=createLogger(`dynamic-connections`),DYNAMIC_CONNECTION_RESOLUTION_ERROR_CODE=`EVE_DYNAMIC_CONNECTION_RESOLUTION_FAILED`;var DynamicConnectionResolutionError=class extends Error{code=DYNAMIC_CONNECTION_RESOLUTION_ERROR_CODE;name=`DynamicConnectionResolutionError`;constructor(e){super(toErrorMessage(e),{cause:e})}};function isDynamicConnectionResolutionError(e){return e instanceof DynamicConnectionResolutionError||typeof e==`object`&&!!e&&e.code===DYNAMIC_CONNECTION_RESOLUTION_ERROR_CODE}function qualifyConnectionNames(e,t){if(readStampedConnectionProtocol(t)!==void 0)return[{name:e.slug,value:t}];if(typeof t!=`object`||!t||Array.isArray(t))throw Error(`Dynamic connection resolver "${e.logicalPath}" must return a connection definition, a map of connection definitions, or null.`);let n=e.extensionNamespace===void 0?``:`${e.extensionNamespace}__`;return Object.entries(t).map(([t,r])=>{if(!CONNECTION_SLUG_PATTERN.test(t))throw Error(`Dynamic connection resolver "${e.logicalPath}" returned illegal connection name "${t}". Expected lowercase ASCII letters, digits, and dashes only, starting with a letter, up to 64 characters.`);if(readStampedConnectionProtocol(r)===void 0)throw Error(`Dynamic connection resolver "${e.logicalPath}" returned "${t}" without defineMcpClientConnection() or defineOpenAPIConnection().`);return{name:`${n}${t}`,value:r}})}async function resolveConnections(e){let t=e.resolver.events[e.event.type];if(t===void 0)return[];let n=await t(e.event,buildConnectionResolveContext(e.ctx));return n==null?[]:qualifyConnectionNames(e.resolver,n).map(({name:t,value:n})=>resolveDynamicConnectionValue(n,{connectionName:t,exportName:e.resolver.exportName,logicalPath:e.resolver.logicalPath,sourceId:e.resolver.sourceId,sourceKind:`module`}))}async function dispatchDynamicConnectionEvent(e){if(!ALLOWED_DYNAMIC_CONNECTION_EVENTS.has(e.event.type))return;let t=e.resolvers.filter(t=>t.eventNames.includes(e.event.type));if(t.length===0)return;let n=e.ctx.get(ConnectionRegistryKey);if(!(n instanceof ConnectionRegistryImpl))throw Error(`Dynamic connection resolution requires the framework connection registry.`);let r=await Promise.allSettled(t.map(async t=>({connections:await resolveConnections({...e,resolver:t}),resolver:t}))),i=new Map,a=agentEntryNames(e.ctx),o,s;for(let n=0;n<r.length;n+=1){let c=r[n],l=t[n];if(c.status===`rejected`){log.error(`Dynamic connection resolver (${e.event.type}) failed.`,{error:toErrorMessage(c.reason),logicalPath:l.logicalPath}),o===void 0&&(o=l,s=c.reason);continue}assertNoReservedNames(c.value.connections,l),assertOwnsNoEntries(c.value.connections,l,a),i.set(c.value.resolver.slug,c.value.connections)}if(o!==void 0)throw new DynamicConnectionResolutionError(Error(`Dynamic connection resolver "${o.logicalPath}" failed during "${e.event.type}".`,{cause:s}));await n.replaceDynamicConnections(e.event.type===`session.started`?`session`:`turn`,i)}function agentEntryNames(e){let t=e.get(BundleKey);return[...t?.toolRegistry.toolsByName.keys()??[],...t?.subagentRegistry.subagentsByName.keys()??[],...t?.subagentRegistry.dynamicResolvers.map(e=>e.name)??[],...dynamicToolNames(e)]}function assertNoReservedNames(e,t){for(let{connectionName:n}of e){let e=eveNamespaceReservation(n);if(e!==void 0)throw Error(`Dynamic connection resolver "${t.logicalPath}" returned the reserved connection name "${n}". ${e}; rename the connection.`)}}function assertOwnsNoEntries(e,t,n){let r=e.map(e=>e.connectionName);for(let e of n)assertNotConnectionOwned({connectionNames:r,name:e,remedy:`Rename it, or the dynamic connection that "${t.logicalPath}" returned.`,subject:`Tool or subagent`})}function buildConnectionResolveContext(e){let t=e.get(ChannelKey);return{session:{id:e.get(SessionIdKey)??``,auth:{current:e.get(AuthKey)??null,initiator:e.get(InitiatorAuthKey)??null}},channel:{kind:t===void 0?void 0:getAdapterKind(t)}}}export{DynamicConnectionResolutionError,dispatchDynamicConnectionEvent,isDynamicConnectionResolutionError};

package/dist/src/context/dynamic-instruction-lifecycle.d.ts

@@ -1,31 +0,0 @@
-import type { ModelMessage, SystemModelMessage } from "ai";
-import type { UnstampedMessageStreamEvent } from "#protocol/message.js";
-import type { ResolvedDynamicInstructionsResolver } from "#runtime/types.js";
-import type { AlsContext, ContextContainer } from "#context/container.js";
-import type { ContextKey } from "#context/key.js";
-import { type UserModelMessage } from "#harness/messages.js";
-/**
- * Builds the flattened system messages from session + turn durable keys.
- * Session-scoped entries appear first.
- */
-export declare function buildDynamicInstructionMessages(ctx: {
-    get<T>(key: ContextKey<T>): T | undefined;
-}): SystemModelMessage[];
-/** Starts the instructions-only virtual context for one lifecycle preamble. */
-export declare function prepareDynamicInstructionPreamble(ctx: AlsContext, messages: readonly ModelMessage[]): void;
-/** Drains user-role results and clears the instructions-only virtual context. */
-export declare function drainDynamicInstructionUserMessages(ctx: AlsContext): UserModelMessage[];
-/**
- * Dispatches a stream event to dynamic instruction resolvers.
- *
- * Each resolver's output replaces its own slot (keyed by slug) in the
- * scope-appropriate durable key (session or turn). The tool-loop calls
- * {@link buildDynamicInstructionMessages} to assemble the flattened
- * result for the model call.
- */
-export declare function dispatchDynamicInstructionEvent(input: {
-    readonly ctx: ContextContainer;
-    readonly resolvers: readonly ResolvedDynamicInstructionsResolver[];
-    readonly event: UnstampedMessageStreamEvent;
-    readonly messages: readonly ModelMessage[];
-}): Promise<void>;

package/dist/src/context/dynamic-instruction-lifecycle.js

@@ -1 +0,0 @@
-import{createLogger}from"#internal/logging.js";import{DynamicInstructionResolveMessagesKey,PendingDynamicInstructionUserMessagesKey,SessionDynamicInstructionsKey,TurnDynamicInstructionsKey}from"#context/keys.js";import{toErrorMessage}from"#shared/errors.js";import{normalizeInstructionsDefinition}from"#internal/authored-definition/core.js";import{ALLOWED_DYNAMIC_INSTRUCTION_EVENTS}from"#dynamic/definition.js";import{isBrandedInstructionsEntry}from"#shared/instructions-definition.js";import{buildResolveContext}from"#context/dynamic-resolve-context.js";import{createFrameworkUserMessage}from"#harness/messages.js";const log=createLogger(`dynamic-instructions`);function lowerInstruction(e){let t=normalizeInstructionsDefinition(e,`Expected dynamic instructions to match the public eve shape.`),n=t.content.trim();if(n.length!==0)return t.role===`system`?{role:`system`,message:{role:`system`,content:n}}:{role:`user`,message:createFrameworkUserMessage(`context.instruction`,n)}}function durableKeyForEvent(e){switch(e){case`session.started`:return SessionDynamicInstructionsKey;case`turn.started`:return TurnDynamicInstructionsKey;default:return}}function buildDynamicInstructionMessages(e){let t=e.get(SessionDynamicInstructionsKey)??{},n=e.get(TurnDynamicInstructionsKey)??{};return[...Object.values(t).flat(),...Object.values(n).flat()]}function prepareDynamicInstructionPreamble(e,t){e.setVirtualContext(DynamicInstructionResolveMessagesKey,[...t]),e.setVirtualContext(PendingDynamicInstructionUserMessagesKey,[])}function drainDynamicInstructionUserMessages(e){let t=[...e.get(PendingDynamicInstructionUserMessagesKey)??[]];return e.delete(DynamicInstructionResolveMessagesKey),e.delete(PendingDynamicInstructionUserMessagesKey),t}async function dispatchDynamicInstructionEvent(e){let{ctx:t,resolvers:n,event:r,messages:i}=e;if(!ALLOWED_DYNAMIC_INSTRUCTION_EVENTS.has(r.type))return;r.type===`turn.started`&&t.set(TurnDynamicInstructionsKey,{});let a=n.filter(e=>e.eventNames.includes(r.type));if(a.length===0)return;let o=durableKeyForEvent(r.type);if(o===void 0)return;let s=t.get(DynamicInstructionResolveMessagesKey)??i,c=t.get(PendingDynamicInstructionUserMessagesKey)??[],l=buildResolveContext(t,[...s,...c]),u=await Promise.allSettled(a.map(async e=>{let t=e.events[r.type];if(t===void 0)return null;let n=await t(r,l);if(n==null)return{resolver:e,instruction:void 0};if(!isBrandedInstructionsEntry(n))return log.error(`Dynamic instructions resolver "${e.slug}" returned an unbranded value — wrap with defineInstructions().`),null;try{return{resolver:e,instruction:lowerInstruction(n)}}catch(t){return log.error(`Dynamic instructions resolver "${e.slug}" returned an invalid value.`,{error:toErrorMessage(t)}),null}})),d={...t.get(o)};for(let e of u){if(e.status===`rejected`){log.error(`Dynamic instructions resolver (${r.type}) threw — skipping.`,{error:toErrorMessage(e.reason)});continue}if(e.value===null)continue;let{resolver:n,instruction:i}=e.value;delete d[n.slug],i?.role===`system`?d[n.slug]=[i.message]:i?.role===`user`&&t.setVirtualContext(PendingDynamicInstructionUserMessagesKey,[...t.get(PendingDynamicInstructionUserMessagesKey)??[],i.message])}t.set(o,d)}export{buildDynamicInstructionMessages,dispatchDynamicInstructionEvent,drainDynamicInstructionUserMessages,prepareDynamicInstructionPreamble};

package/dist/src/context/dynamic-model-lifecycle.d.ts

@@ -1,19 +0,0 @@
-import type { ModelMessage } from "ai";
-import type { AlsContext } from "#context/container.js";
-import type { UnstampedMessageStreamEvent } from "#protocol/message.js";
-import type { RuntimeDynamicModelReference } from "#runtime/agent/bootstrap.js";
-import { type RuntimeModelResolutionScope } from "#runtime/agent/resolve-model.js";
-export declare class DynamicModelSelectionError extends Error {
-    readonly code = "EVE_DYNAMIC_MODEL_SELECTION_FAILED";
-    readonly name = "DynamicModelSelectionError";
-    constructor(error: unknown);
-}
-export declare function isDynamicModelSelectionError(error: unknown): error is DynamicModelSelectionError;
-export declare function dispatchDynamicModelEvent(input: {
-    readonly abortSignal?: AbortSignal;
-    readonly ctx: AlsContext;
-    readonly dynamicModel: RuntimeDynamicModelReference | undefined;
-    readonly event: UnstampedMessageStreamEvent;
-    readonly messages: readonly ModelMessage[];
-    readonly scope: RuntimeModelResolutionScope;
-}): Promise<void>;

package/dist/src/context/dynamic-model-lifecycle.js

@@ -1 +0,0 @@
-import{LiveStepDynamicModelSelectionKey,SessionDynamicModelReferenceKey,TurnDynamicModelReferenceKey}from"#context/keys.js";import{toErrorMessage}from"#shared/errors.js";import{isMockModel}from"#internal/mock-model-identity.js";import{buildResolveContext}from"#context/dynamic-resolve-context.js";import{loadDynamicRuntimeModelDefinition,resolveRuntimeModelSelection,shouldMockAuthoredRuntimeModels}from"#runtime/agent/resolve-model.js";const ALLOWED_DYNAMIC_MODEL_EVENTS=new Set([`session.started`,`turn.started`,`step.started`]),DYNAMIC_MODEL_SELECTION_ERROR_CODE=`EVE_DYNAMIC_MODEL_SELECTION_FAILED`;var DynamicModelSelectionError=class extends Error{code=DYNAMIC_MODEL_SELECTION_ERROR_CODE;name=`DynamicModelSelectionError`;constructor(e){super(toErrorMessage(e),{cause:e})}};function isDynamicModelSelectionError(e){return e instanceof DynamicModelSelectionError||typeof e==`object`&&!!e&&e.code===DYNAMIC_MODEL_SELECTION_ERROR_CODE}function isDynamicModelEventName(e){return ALLOWED_DYNAMIC_MODEL_EVENTS.has(e)}function durableKeyForEvent(e){switch(e){case`session.started`:return SessionDynamicModelReferenceKey;case`turn.started`:return TurnDynamicModelReferenceKey;case`step.started`:return}}async function dispatchDynamicModelEvent(e){if(e.dynamicModel!==void 0&&isDynamicModelEventName(e.event.type)&&e.dynamicModel.eventNames.includes(e.event.type)){setSelectionForEvent(e.ctx,e.event.type,null);try{let t=(await loadDynamicRuntimeModelDefinition({dynamicModel:e.dynamicModel,scope:e.scope})).events[e.event.type];if(t===void 0)throw Error(`Dynamic model resolver is missing its compiled "${e.event.type}" handler.`);e.abortSignal?.throwIfAborted();let n=await t(e.event,{...buildResolveContext(e.ctx,e.messages),abortSignal:e.abortSignal});e.abortSignal?.throwIfAborted();let r=await resolveRuntimeModelSelection({durability:e.event.type===`step.started`?`live`:`durable`,selection:n,state:e.ctx});setSelectionForEvent(e.ctx,e.event.type,r)}catch(e){throw isDynamicModelSelectionError(e)?e:new DynamicModelSelectionError(e)}}}function setSelectionForEvent(e,t,n){if(t===`step.started`){let t=n!==null&&n.model!==void 0&&!isMockModel(n.model)&&shouldMockAuthoredRuntimeModels()?{reference:n.reference}:n;e.setVirtualContext(LiveStepDynamicModelSelectionKey,t);return}let r=durableKeyForEvent(t);r!==void 0&&e.set(r,n?.reference??null)}export{DynamicModelSelectionError,dispatchDynamicModelEvent,isDynamicModelSelectionError};

package/dist/src/context/dynamic-resolve-context.d.ts

@@ -1,12 +0,0 @@
-import type { ModelMessage } from "ai";
-import type { DynamicResolveContext } from "#dynamic/definition.js";
-import type { AlsContext } from "#context/container.js";
-type ReadableContext = Pick<AlsContext, "get">;
-/**
- * Builds the {@link DynamicResolveContext} from the active ALS context.
- *
- * Shared by all three dynamic lifecycle dispatchers (tools, skills,
- * instructions) so resolver handlers receive a consistent context shape.
- */
-export declare function buildResolveContext(ctx: ReadableContext, messages: readonly ModelMessage[]): DynamicResolveContext;
-export {};

package/dist/src/context/dynamic-resolve-context.js

@@ -1 +0,0 @@
-import{ConversationContextKey}from"#shared/conversation-context.js";import{getAdapterKind}from"#channel/adapter.js";import{AuthKey,ChannelInstrumentationKey,ContinuationTokenKey,InitiatorAuthKey,SessionIdKey,SessionPredecessorKey}from"#context/keys.js";import{readSessionSchedule}from"#context/session-schedule.js";import{ChannelKey}from"#runtime/sessions/runtime-context-keys.js";import{getEffectiveModelSelection}from"#context/effective-model.js";function buildResolveContext(e,t){let n=e.get(SessionIdKey)??``,r=e.get(AuthKey)??null,i=e.get(InitiatorAuthKey)??null,a=e.get(ChannelKey),o=e.get(ContinuationTokenKey),s=e.get(ChannelInstrumentationKey),c=getEffectiveModelSelection(e);return{model:c===null?null:{id:c.reference.id},session:{id:n,schedule:readSessionSchedule(e),auth:{current:r,initiator:i},predecessor:e.get(SessionPredecessorKey)},channel:{kind:a===void 0?void 0:getAdapterKind(a),continuationToken:o,metadata:s?.metadata},...e.get(ConversationContextKey)===void 0?void 0:{conversation:e.get(ConversationContextKey)},messages:t}}export{buildResolveContext};

package/dist/src/context/dynamic-skill-lifecycle.d.ts

@@ -1,15 +0,0 @@
-import type { ModelMessage } from "ai";
-import type { UnstampedMessageStreamEvent } from "#protocol/message.js";
-import type { ResolvedDynamicSkillResolver } from "#runtime/types.js";
-import type { ContextContainer } from "#context/container.js";
-/**
- * Dispatches a stream event to dynamic skill resolvers. On a matching
- * event: runs handlers, stores instructions in durable context, and queues
- * changed supporting files for the sandbox without waiting for them.
- */
-export declare function dispatchDynamicSkillEvent(input: {
-    readonly ctx: ContextContainer;
-    readonly resolvers: readonly ResolvedDynamicSkillResolver[];
-    readonly event: UnstampedMessageStreamEvent;
-    readonly messages: readonly ModelMessage[];
-}): Promise<void>;

package/dist/src/context/dynamic-skill-lifecycle.js

@@ -1 +0,0 @@
-import{createLogger}from"#internal/logging.js";import{DynamicSkillManifestKey,DynamicSkillSandboxKey,SandboxKey}from"#context/keys.js";import{toErrorMessage}from"#shared/errors.js";import{eveNamespaceReservation}from"#protocol/runtime-tools.js";import{ALLOWED_DYNAMIC_SKILL_EVENTS}from"#dynamic/definition.js";import{normalizeSkillPackage,removeSkillPackageFromSandbox,skillPackageRevision,writeSkillPackageToSandbox}from"#shared/skill-package.js";import{SKILL_NAME_PATTERN,SKILL_NAME_RULE}from"#discover/grammar.js";import{buildResolveContext}from"#context/dynamic-resolve-context.js";import{isBrandedSkillEntry}from"#shared/skill-definition.js";const log=createLogger(`dynamic-skills`);function qualifyDynamicSkillNames(e,t,n){let r=e.extensionNamespace===void 0?``:`${e.extensionNamespace}__`,i=Object.entries(n).map(([n,i])=>({entry:i,name:t?e.slug:`${r}${n}`}));for(let{name:t}of i){let n=eveNamespaceReservation(t);if(n!==void 0)throw Error(`Dynamic skill resolver "${e.logicalPath}" returned the reserved skill name "${t}". ${n}; rename the skill.`);if(!SKILL_NAME_PATTERN.test(t))throw Error(`Dynamic skill resolver "${e.logicalPath}" returned illegal skill name "${t}". ${SKILL_NAME_RULE}`)}return i}function toDurableSkill(e){return{deferred:e.deferred===!0||void 0,description:e.description,markdown:e.markdown,name:e.name,...e.files.length>1?{revision:skillPackageRevision(e)}:{}}}function sandboxIdentity(e){return e.session===null?null:JSON.stringify(e.session)}function syncDynamicSkillFiles(e){let{ctx:t,kept:n,previous:r,next:i}=e,a=t.get(DynamicSkillSandboxKey)??{},o=[...i.values()].filter(({revision:e,skill:t})=>r.get(t.name)!==e&&t.name in a);if(o.length>0){let e={...a};for(let{skill:t}of o)delete e[t.name];t.set(DynamicSkillSandboxKey,e)}let s=i.size===0?t.get(SandboxKey):t.require(SandboxKey);s!==void 0&&s.prepare(async e=>{let a=t.get(DynamicSkillSandboxKey)??{},o=Object.keys(a).filter(e=>!n.has(e)),c=sandboxIdentity(await s.captureState()),isWritten=e=>c!==null&&a[e]===c,l=o.filter(isWritten),u=[...i.values()].filter(({revision:e,skill:t})=>r.get(t.name)!==e||!isWritten(t.name));if(l.length===0&&u.length===0)return;let d=await e(),f={...a};for(let e of o)delete f[e];for(let{skill:e}of u)delete f[e.name];t.set(DynamicSkillSandboxKey,{...f});for(let e of l)await removeSkillPackageFromSandbox({name:e,sandbox:d});let p=sandboxIdentity(await s.captureState());for(let{skill:e}of u)await removeSkillPackageFromSandbox({name:e.name,sandbox:d}),await writeSkillPackageToSandbox({sandbox:d,skill:e}),p!==null&&(f[e.name]=p);t.set(DynamicSkillSandboxKey,f)})}async function dispatchDynamicSkillEvent(e){let{ctx:t,resolvers:n,event:r,messages:i}=e;if(!ALLOWED_DYNAMIC_SKILL_EVENTS.has(r.type))return;let a=n.filter(e=>e.eventNames.includes(r.type));if(a.length===0)return;let o=buildResolveContext(t,i),s=t.get(DynamicSkillManifestKey)??{},c=[],l=await Promise.allSettled(a.map(async e=>{let t=e.events[r.type];if(t===void 0)return null;let n=await t(r,o);if(n==null)return{resolver:e,named:[]};let i,a;return isBrandedSkillEntry(n)?(i={_single:n},a=!0):(i=n,a=!1),{resolver:e,named:qualifyDynamicSkillNames(e,a,i)}}));for(let e of l){if(e.status===`rejected`){log.error(`Dynamic skill resolver (${r.type}) threw — skipping.`,{error:toErrorMessage(e.reason)});continue}e.value!==null&&c.push({resolver:e.value.resolver,skills:e.value.named.map(({name:e,entry:t})=>normalizeSkillPackage({...t,name:e}))})}if(c.length===0)return;let u={...s},d=new Map,f=new Map;for(let{resolver:e,skills:t}of c){for(let{name:t,revision:n}of s[e.slug]??[])n!==void 0&&d.set(t,n);if(t.length===0){delete u[e.slug];continue}u[e.slug]=t.map(e=>{let t=toDurableSkill(e);return t.revision!==void 0&&f.set(e.name,{revision:t.revision,skill:e}),t})}let p=new Map;for(let[e,t]of Object.entries(u))for(let{name:n}of t){let t=p.get(n);if(t!==void 0)throw Error(`Dynamic skill "${n}" from resolver "${e}" collides with dynamic resolver "${t}". Namespace the map key manually, e.g. "${e}__${n}".`);p.set(n,e)}syncDynamicSkillFiles({ctx:t,kept:new Set(p.keys()),next:f,previous:d}),t.set(DynamicSkillManifestKey,u)}export{dispatchDynamicSkillEvent};

package/dist/src/context/dynamic-subagent-lifecycle.d.ts

@@ -1,27 +0,0 @@
-import type { ModelMessage } from "ai";
-import type { ContextContainer } from "#context/container.js";
-import type { ContextReader } from "#context/key.js";
-import { type DurableDynamicSubagentSelection } from "#context/keys.js";
-import type { HarnessToolDefinition } from "#harness/execute-tool.js";
-import type { SessionStartedStreamEvent, UnstampedMessageStreamEvent } from "#protocol/message.js";
-import type { ResolvedDynamicSubagentResolver } from "#runtime/subagents/registry.js";
-export declare function dispatchDynamicSubagentEvent(input: {
-    readonly ctx: ContextContainer;
-    readonly event: UnstampedMessageStreamEvent;
-    readonly messages: readonly ModelMessage[];
-    readonly resolvers: readonly ResolvedDynamicSubagentResolver[];
-}): Promise<void>;
-export declare function refreshDynamicSessionSubagentsForRuntimeRevision(input: {
-    readonly ctx: ContextContainer;
-    readonly event: SessionStartedStreamEvent;
-    readonly messages: readonly ModelMessage[];
-    readonly resolvers: readonly ResolvedDynamicSubagentResolver[];
-    readonly runtimeRevision: string;
-}): Promise<void>;
-export declare function buildDynamicSubagentTools(input: ContextReader): readonly HarnessToolDefinition[];
-export declare function getDynamicSubagentSelection(input: ContextReader, nodeId: string): Exclude<DurableDynamicSubagentSelection, null> | undefined;
-/**
- * The dynamic subagents selected for the current turn, by node id. A turn
- * selection overrides the session's, and `null` withdraws one.
- */
-export declare function readDynamicSubagentSelections(input: ContextReader): Readonly<Record<string, DurableDynamicSubagentSelection>>;

package/dist/src/context/dynamic-subagent-lifecycle.js

@@ -1 +0,0 @@
-import{createLogger}from"#internal/logging.js";import{SessionDynamicSubagentRuntimeRevisionKey,SessionDynamicSubagentSelectionsKey,TurnDynamicSubagentSelectionsKey}from"#context/keys.js";import{toErrorMessage}from"#shared/errors.js";import{assertNotConnectionOwned}from"#connections/ownership.js";import{eveNamespaceReservation}from"#protocol/runtime-tools.js";import{ConnectionRegistryKey}from"#context/providers/connection-key.js";import{BundleKey}from"#runtime/sessions/runtime-context-keys.js";import{buildResolveContext}from"#context/dynamic-resolve-context.js";import{createPreparedWorkflowToolHarnessDefinition}from"#execution/tools/workflow/harness-definition.js";import{createPreparedRuntimeSubagentTool}from"#runtime/subagents/registry.js";import{normalizeDynamicSubagentAgentConfig}from"#runtime/subagents/dynamic-agent-config.js";import{normalizeDynamicRemoteAgentConfig}from"#runtime/subagents/dynamic-remote-agent-config.js";const log=createLogger(`dynamic-subagents`),ALLOWED_DYNAMIC_SUBAGENT_EVENTS=new Set([`session.started`,`turn.started`]);async function resolveSelections(e){let t=await Promise.allSettled(e.resolvers.map(async t=>{let n=t.events[e.event.type];if(n===void 0)return[t.nodeId,null];let r=await n(e.event,buildResolveContext(e.ctx,e.messages));if(r==null)return[t.nodeId,null];if(assertNotConnectionOwned({connectionNames:e.ctx.get(ConnectionRegistryKey)?.getConnectionNames()??[],name:t.name,remedy:`Rename the subagent directory.`,subject:`Dynamic subagent`}),isRemoteAgentDefinition(r)){let n=await normalizeDynamicRemoteAgentConfig({name:t.name,value:r}),i=t.tool===!1?{...n,tool:!1}:n;assertToolNameAvailable(e.ctx,t,i.tool);let a=createPreparedRuntimeSubagentTool({description:i.description,kind:`remote`,logicalPath:t.logicalPath,name:t.name,nodeId:t.nodeId,path:i.path,sourceId:t.sourceId,sourceKind:t.sourceKind,tool:i.tool,url:i.url});return[t.nodeId,{kind:`remote`,prepared:a,remoteAgent:i}]}let i=await normalizeDynamicSubagentAgentConfig({name:t.name,state:e.ctx,value:r}),a=t.tool===!1?{...i,tool:!1}:i;assertToolNameAvailable(e.ctx,t,a.tool);let o=createPreparedRuntimeSubagentTool({description:a.description,kind:`subagent`,logicalPath:t.logicalPath,name:t.name,nodeId:t.nodeId,sourceId:t.sourceId,sourceKind:t.sourceKind,tool:a.tool});return[t.nodeId,{agentConfig:a,kind:`subagent`,prepared:o}]})),n={};for(let r=0;r<t.length;r+=1){let i=t[r],a=e.resolvers[r];if(i.status===`rejected`){log.error(`Dynamic subagent resolver (${e.event.type}) threw — omitting subagent.`,{error:toErrorMessage(i.reason),subagentName:a.name}),n[a.nodeId]=null;continue}n[i.value[0]]=i.value[1]}return n}function assertToolNameAvailable(e,t,n){let r=eveNamespaceReservation(t.name);if(r!==void 0)throw Error(`Dynamic subagent "${t.name}" from "${t.logicalPath}" uses the reserved name "${t.name}". ${r}; rename the subagent.`);if(n!==!1&&(e.get(BundleKey)?.toolRegistry.toolsByName)?.has(t.name)===!0)throw Error(`Dynamic subagent "${t.name}" from "${t.logicalPath}" collides with the tool "${t.name}". Set the subagent's tool to false when that tool wraps it.`)}function isRemoteAgentDefinition(e){return typeof e==`object`&&!!e&&e.kind===`remote`}async function dispatchDynamicSubagentEvent(e){if(!ALLOWED_DYNAMIC_SUBAGENT_EVENTS.has(e.event.type))return;let t=e.resolvers.filter(t=>t.eventNames.includes(e.event.type)),n=await resolveSelections({...e,resolvers:t});e.event.type===`session.started`?e.ctx.set(SessionDynamicSubagentSelectionsKey,n):e.ctx.set(TurnDynamicSubagentSelectionsKey,n)}async function refreshDynamicSessionSubagentsForRuntimeRevision(e){if(e.ctx.get(SessionDynamicSubagentRuntimeRevisionKey)===e.runtimeRevision)return;let t=e.resolvers.filter(e=>e.eventNames.includes(`session.started`)),n=await resolveSelections({...e,resolvers:t});e.ctx.set(SessionDynamicSubagentSelectionsKey,n),e.ctx.set(SessionDynamicSubagentRuntimeRevisionKey,e.runtimeRevision)}function buildDynamicSubagentTools(e){let t=e.get(SessionDynamicSubagentSelectionsKey)??{},n=e.get(TurnDynamicSubagentSelectionsKey)??{},r={...t,...n},i=[];for(let e of Object.values(r))e!==null&&(e.kind===`subagent`?e.agentConfig.tool!==!1:e.remoteAgent.tool!==!1)&&i.push(createPreparedWorkflowToolHarnessDefinition(e.prepared));return i}function getDynamicSubagentSelection(e,t){return readDynamicSubagentSelections(e)[t]??void 0}function readDynamicSubagentSelections(e){return{...e.get(SessionDynamicSubagentSelectionsKey),...e.get(TurnDynamicSubagentSelectionsKey)}}export{buildDynamicSubagentTools,dispatchDynamicSubagentEvent,getDynamicSubagentSelection,readDynamicSubagentSelections,refreshDynamicSessionSubagentsForRuntimeRevision};

package/dist/src/context/dynamic-tool-lifecycle.d.ts

@@ -1,46 +0,0 @@
-import type { ModelMessage } from "ai";
-import { type AlsContext } from "#context/container.js";
-import type { SessionStartedStreamEvent, StepStartedStreamEvent, UnstampedMessageStreamEvent } from "#protocol/message.js";
-import { type DynamicToolEntry } from "#tools/dynamic.js";
-import { type DynamicToolCallbackOwner, type DurableDynamicToolCallbacks } from "#tools/durable-callbacks.js";
-import type { ResolvedDynamicToolResolver } from "#runtime/types.js";
-export declare function validateDurableDynamicToolCallbacks(name: string, entry: DynamicToolEntry, owner: DynamicToolCallbackOwner): DurableDynamicToolCallbacks;
-/** Resolves step-scoped tools once for one internal policy/model pass. */
-export declare function resolveStepDynamicTools(input: {
-    readonly ctx: AlsContext;
-    readonly resolvers: readonly ResolvedDynamicToolResolver[];
-    readonly event: StepStartedStreamEvent;
-    readonly messages: readonly ModelMessage[];
-}): Promise<void>;
-/** Converts persisted step metadata before any approval replay can read it. */
-export declare function preparePersistedStepDynamicToolMetadata(input: {
-    readonly ctx: AlsContext;
-    readonly resolvers: readonly ResolvedDynamicToolResolver[];
-    readonly event: StepStartedStreamEvent;
-    readonly messages: readonly ModelMessage[];
-}): Promise<void>;
-export declare function dispatchDynamicToolEvent(input: {
-    readonly ctx: AlsContext;
-    readonly resolvers: readonly ResolvedDynamicToolResolver[];
-    readonly event: UnstampedMessageStreamEvent;
-    readonly messages: readonly ModelMessage[];
-}): Promise<void>;
-/**
- * Refreshes session-scoped definitions when the deployed code revision changes
- * or when persisted callbacks have no registered binding (fresh process after
- * a crash, or a redeploy), so replay always resolves against current code.
- */
-export declare function refreshDynamicSessionToolsForRuntimeRevision(input: {
-    readonly ctx: AlsContext;
-    readonly resolvers: readonly ResolvedDynamicToolResolver[];
-    readonly event: SessionStartedStreamEvent;
-    readonly messages: readonly ModelMessage[];
-    readonly runtimeRevision: string;
-}): Promise<void>;
-/** Re-registers missing callbacks while preserving the active turn's persisted tool set. */
-export declare function rebindMissingCompiledDynamicToolCallbacks(input: {
-    readonly ctx: AlsContext;
-    readonly event: UnstampedMessageStreamEvent;
-    readonly messages: readonly ModelMessage[];
-    readonly resolvers: readonly ResolvedDynamicToolResolver[];
-}): Promise<void>;

package/dist/src/context/dynamic-tool-lifecycle.js

@@ -1 +0,0 @@
-import{createLogger}from"#internal/logging.js";import{contextStorage}from"#context/container.js";import{SessionDynamicToolMetadataKey,SessionDynamicToolRuntimeRevisionKey,SessionIdKey,StepDynamicToolMetadataKey,TurnDynamicToolMetadataKey}from"#context/keys.js";import{toErrorMessage}from"#shared/errors.js";import{serializeInputSchema,serializeOutputSchema}from"#tools/schema.js";import{parseJsonObject}from"#shared/json.js";import{assertNotConnectionOwned}from"#connections/ownership.js";import{eveNamespaceReservation}from"#protocol/runtime-tools.js";import{ALLOWED_DYNAMIC_TOOL_EVENTS}from"#dynamic/definition.js";import{isCurrentDynamicToolMetadata,toCurrentDynamicToolMetadataList}from"#context/dynamic-tool-metadata.js";import{clearDurableDynamicCallbacks,hasUnregisteredDurableDynamicCallbacks,readDurableDynamicToolCallbacks,registerDurableDynamicCallback}from"#tools/durable-callbacks.js";import{hasSchemaValidator}from"#tools/durable-schema.js";import{ConnectionRegistryKey}from"#context/providers/connection-key.js";import{TOOL_SLUG_PATTERN,TOOL_SLUG_RULE}from"#discover/grammar.js";import{BundleKey}from"#runtime/sessions/runtime-context-keys.js";import{buildResolveContext}from"#context/dynamic-resolve-context.js";import{isFrameworkTool}from"#tools/provided/framework-tool.js";import{isWorkflowToolDefinition}from"#tools/workflow-definition.js";import{isBrandedToolEntry}from"#tools/dynamic.js";import{workflowIdForHandling}from"#runtime/subagents/workflow-reference.js";const log=createLogger(`dynamic-tools`);function qualifyDynamicToolNames(e,t,n){let r=Object.keys(n);if(r.length===0)return[];if(t){let t=r[0];return[{name:e.slug,entryKey:t,entry:n[t]}]}let i=e.extensionNamespace===void 0?``:`${e.extensionNamespace}__`;return r.map(t=>{let r=`${i}${t}`;if(!TOOL_SLUG_PATTERN.test(r))throw Error(`Dynamic tool resolver "${e.logicalPath}" returned illegal tool name "${r}". ${TOOL_SLUG_RULE}`);let a=eveNamespaceReservation(r);if(a!==void 0)throw Error(`Dynamic tool resolver "${e.logicalPath}" returned the reserved tool name "${r}". ${a}; rename the map key.`);return{entry:n[t],entryKey:t,name:r}})}function durableKeyForEvent(e){switch(e){case`session.started`:return SessionDynamicToolMetadataKey;case`turn.started`:return TurnDynamicToolMetadataKey;case`step.started`:return StepDynamicToolMetadataKey;default:return}}function readDynamicToolResult(e,t){let assertOrdinaryTool=t=>{if(isWorkflowToolDefinition(t))throw Error(`Dynamic tool resolver "${e.logicalPath}" cannot return defineWorkflowTool(). Workflow tools must be static tools; use defineTool() for dynamic entries.`)};if(assertOrdinaryTool(t),isBrandedToolEntry(t))return{entries:{_single:t},isSingle:!0};if(typeof t!=`object`||!t||Array.isArray(t))throw Error(`Dynamic tool resolver "${e.logicalPath}" must return defineTool(), a map of defineTool() values, or null.`);let n={};for(let[r,i]of Object.entries(t)){if(assertOrdinaryTool(i),!isBrandedToolEntry(i))throw Error(`Dynamic tool resolver "${e.logicalPath}" returned "${r}" without defineTool(). Wrap every dynamic tool entry in defineTool().`);n[r]=i}return{entries:n,isSingle:!1}}function validateReference(e){let t=e.phase===`inputSchema`||e.phase===`outputSchema`,n=t?`Write the schema expression inline in defineTool() or use defineDurableSchema() for a provider package.`:`Author the callback inline in transformed source or use an eve durable callback helper.`;if(e.stamped===void 0){if(e.required)throw Error(`Dynamic tool "${e.name}" callback "${e.phase}" does not have a durable descriptor. `+n);return}let r=Object.keys(e.stamped).filter(e=>e!==`closure`&&e!==`callback`);if(r.includes(`stepId`))throw Error(`Dynamic tool "${e.name}" callback "${e.phase}" was persisted by a pre-release eve version that identified callbacks by build offset. Start a new session to re-resolve it.`);if(r.length>0)throw Error(`Dynamic tool "${e.name}" has invalid ${e.phase} callback metadata: unknown key(s) ${r.join(`, `)}.`);if(typeof e.stamped.callback!=`function`)throw Error(`Dynamic tool "${e.name}" callback "${e.phase}" does not have a durable descriptor. `+n);let i;try{i=parseJsonObject(e.stamped.closure)}catch(n){throw Error(`Dynamic tool "${e.name}" callback "${e.phase}" has a non-serializable capture. ${toErrorMessage(n)}`+(t?` Inline the schema construction or reference a stable module-level schema; put only JSON data in its closure.`:``))}return registerDurableDynamicCallback({callback:e.stamped.callback,phase:e.phase,owner:e.owner}),{closure:i}}function validateDurableDynamicToolCallbacks(e,t,n){let r=readDurableDynamicToolCallbacks(t)??{},i=Object.keys(r).filter(e=>e!==`endsTurn`&&e!==`execute`&&e!==`inputSchema`&&e!==`outputSchema`&&e!==`label`&&e!==`approvalKey`&&e!==`approvalPrompt`&&e!==`approvalRequest`&&e!==`approvalResponse`&&e!==`toModelOutput`);if(i.length>0)throw Error(`Dynamic tool "${e}" has unknown durable callback phase(s): ${i.join(`, `)}.`);let a=t.approval!==void 0,o=t.approval!==void 0&&typeof t.approval!=`function`?t.approval:void 0,s=o?.prompt!==void 0,c=o?.response!==void 0,l=validateReference({name:e,owner:n,phase:`execute`,stamped:r.execute,required:!0}),u=validateReference({name:e,owner:n,phase:`labelComplete`,stamped:r.label?.complete,required:!1}),d=validateReference({name:e,owner:n,phase:`labelDelta`,stamped:r.label?.delta,required:!1}),f=validateReference({name:e,owner:n,phase:`labelStart`,stamped:r.label?.start,required:!1}),p=validateReference({name:e,owner:n,phase:`approvalKey`,stamped:r.approvalKey,required:t.approvalKey!==void 0}),m=validateReference({name:e,owner:n,phase:`approvalPrompt`,stamped:r.approvalPrompt,required:s}),h=validateReference({name:e,owner:n,phase:`approvalRequest`,stamped:r.approvalRequest,required:a}),g=validateReference({name:e,owner:n,phase:`approvalResponse`,stamped:r.approvalResponse,required:c}),_=validateReference({name:e,owner:n,phase:`toModelOutput`,stamped:r.toModelOutput,required:t.toModelOutput!==void 0}),v=validateReference({name:e,owner:n,phase:`endsTurn`,stamped:r.endsTurn,required:typeof t.endsTurn==`function`}),y=validateReference({name:e,owner:n,phase:`inputSchema`,stamped:r.inputSchema,required:hasSchemaValidator(t.inputSchema)}),b=validateReference({name:e,owner:n,phase:`outputSchema`,stamped:r.outputSchema,required:hasSchemaValidator(t.outputSchema)}),x={execute:l};return y!==void 0&&(x.inputSchema=y),b!==void 0&&(x.outputSchema=b),(u!==void 0||d!==void 0||f!==void 0)&&(x.label={complete:u,delta:d,start:f}),p!==void 0&&(x.approvalKey=p),m!==void 0&&(x.approvalPrompt=m),h!==void 0&&(x.approvalRequest=h),g!==void 0&&(x.approvalResponse=g),_!==void 0&&(x.toModelOutput=_),v!==void 0&&(x.endsTurn=v),x}function createMetadata(e){return{availableInSubagents:e.entry.availableInSubagents,deferred:e.entry.deferred,callbacks:validateDurableDynamicToolCallbacks(e.name,e.entry,{sessionId:e.sessionId,scope:e.scope,resolverSlug:e.resolver.slug,entryKey:e.entryKey,name:e.name}),description:e.entry.description,frameworkTool:isFrameworkTool(e.entry)||void 0,endsTurn:e.entry.endsTurn===!0||void 0,entryKey:e.entryKey,inputSchema:serializeInputSchema(e.entry.inputSchema),name:e.name,outputSchema:serializeOutputSchema(e.entry.outputSchema),resolverSlug:e.resolver.slug}}function workflowToolNames(e){let t=e.get(BundleKey);if(t===void 0)return new Set;let{subagentRegistry:n,toolRegistry:r}=t;return new Set([...[...r.toolsByName.values()].filter(({prepared:e})=>workflowIdForHandling(e.behavior?.handling)!==void 0).map(({prepared:e})=>e.name),...n.preparedTools.map(e=>e.name),...n.dynamicResolvers.map(e=>e.name)])}async function resolveToolsFromEvent(e,t,n,r){let i=e.require(SessionIdKey),a=n.type.split(`.`)[0],o=await Promise.allSettled(t.map(async t=>{let o=t.events[n.type];if(o===void 0)return null;clearDurableDynamicCallbacks(i,{scope:a,resolverSlug:t.slug});try{let s=await o(n,buildResolveContext(e,r));if(s==null)return null;let{entries:c,isSingle:l}=readDynamicToolResult(t,s),u=qualifyDynamicToolNames(t,l,c),d=e.get(ConnectionRegistryKey)?.getConnectionNames()??[],f=workflowToolNames(e);for(let{name:e}of u)if(assertNotConnectionOwned({connectionNames:d,name:e,remedy:`Rename the map key.`,subject:`Dynamic tool`}),f.has(e))throw Error(`Dynamic tool "${e}" from resolver "${t.logicalPath}" collides with the workflow tool or agent "${e}". Rename the map key.`);return{metadata:u.map(({name:e,entryKey:n,entry:r})=>createMetadata({entry:r,entryKey:n,name:e,resolver:t,sessionId:i,scope:a})),resolver:t}}catch(e){throw clearDurableDynamicCallbacks(i,{scope:a,resolverSlug:t.slug}),e}})),s=[],c=new Map;for(let e of o){if(e.status===`rejected`){log.error(`Dynamic tool resolver (${n.type}) failed — skipping its complete result.`,{error:toErrorMessage(e.reason)});continue}if(e.value!==null){for(let t of e.value.metadata){let n=c.get(t.name);if(n!==void 0&&n!==e.value.resolver.slug)throw Error(`Dynamic tool "${t.name}" from resolver "${e.value.resolver.slug}" collides with dynamic resolver "${n}". Namespace the map key manually.`);c.set(t.name,e.value.resolver.slug)}s.push(...e.value.metadata)}}return{metadata:s}}const resolvedStepTools=new WeakMap;function stepCoordinate(e){return`${e.data.turnId}:${String(e.data.stepIndex)}`}function storeResolvedStepTools(e){e.ctx.set(StepDynamicToolMetadataKey,e.metadata);let t=stepCoordinate(e.event);resolvedStepTools.set(e.ctx,{coordinate:t,metadata:e.metadata})}async function resolveStepDynamicTools(e){let t=stepCoordinate(e.event),n=resolvedStepTools.get(e.ctx);if(n?.coordinate===t){e.ctx.set(StepDynamicToolMetadataKey,n.metadata);return}let r=e.resolvers.filter(e=>e.eventNames.includes(`step.started`)),{metadata:i}=r.length===0?{metadata:[]}:await resolveToolsFromEvent(e.ctx,r,e.event,e.messages);storeResolvedStepTools({ctx:e.ctx,event:e.event,metadata:i})}async function preparePersistedStepDynamicToolMetadata(e){let t=e.ctx.get(StepDynamicToolMetadataKey)??[],n=t.filter(isCurrentDynamicToolMetadata);if(n.length===t.length&&!hasUnregisteredDurableDynamicCallbacks(n,{sessionId:e.ctx.require(SessionIdKey),scope:`step`})){n.length>0&&storeResolvedStepTools({ctx:e.ctx,event:e.event,metadata:n});return}await resolveStepDynamicTools(e);let r=e.ctx.get(StepDynamicToolMetadataKey)??[];storeResolvedStepTools({ctx:e.ctx,event:e.event,metadata:toCurrentDynamicToolMetadataList(t,r.filter(isCurrentDynamicToolMetadata))})}async function dispatchDynamicToolEvent(e){if(e.event.type===`session.completed`){let t=e.ctx.get(SessionIdKey);t!==void 0&&clearDurableDynamicCallbacks(t);return}if(!ALLOWED_DYNAMIC_TOOL_EVENTS.has(e.event.type))return;if(e.event.type===`step.started`){await resolveStepDynamicTools({...e,event:e.event});return}e.event.type===`turn.started`&&e.ctx.set(StepDynamicToolMetadataKey,[]);let t=e.resolvers.filter(t=>t.eventNames.includes(e.event.type)),{metadata:n}=t.length===0?{metadata:[]}:await resolveToolsFromEvent(e.ctx,t,e.event,e.messages),r=durableKeyForEvent(e.event.type);if(r===void 0)return;if(e.event.type===`session.started`){e.ctx.set(SessionDynamicToolMetadataKey,n);return}let i=new Set(t.map(e=>e.slug)),a=(e.ctx.get(r)??[]).filter(e=>!i.has(e.resolverSlug));e.ctx.set(r,[...a,...n])}async function refreshDynamicSessionToolsForRuntimeRevision(e){let t=e.ctx.get(SessionDynamicToolMetadataKey)??[],n=t.filter(isCurrentDynamicToolMetadata),r=n.length!==t.length,i=e.ctx.get(SessionDynamicToolRuntimeRevisionKey)!==e.runtimeRevision;if(!i&&!r&&!hasUnregisteredDurableDynamicCallbacks(n,{sessionId:e.ctx.require(SessionIdKey),scope:`session`}))return;let a=e.resolvers.filter(e=>e.eventNames.includes(`session.started`)),{metadata:o}=a.length===0?{metadata:[]}:await resolveToolsFromEvent(e.ctx,a,e.event,e.messages);e.ctx.set(SessionDynamicToolMetadataKey,i?o:toCurrentDynamicToolMetadataList(t,o)),e.ctx.set(SessionDynamicToolRuntimeRevisionKey,e.runtimeRevision)}async function rebindMissingCompiledDynamicToolCallbacks(e){let t=e.ctx.get(TurnDynamicToolMetadataKey)??[],n=t.filter(t=>!isCurrentDynamicToolMetadata(t)||hasUnregisteredDurableDynamicCallbacks([t],{sessionId:e.ctx.require(SessionIdKey),scope:`turn`}));if(n.length===0)return;let r=new Set(n.map(e=>e.resolverSlug)),i=e.resolvers.filter(e=>r.has(e.slug)),a=new Set(i.filter(e=>e.rebindMissingCallbacks===!0).map(e=>e.slug)),o=new Set(t.filter(e=>!isCurrentDynamicToolMetadata(e)).map(e=>e.resolverSlug));if(i.length===0){e.ctx.set(TurnDynamicToolMetadataKey,toCurrentDynamicToolMetadataList(t));return}let s=await contextStorage.run(e.ctx,async()=>await resolveToolsFromEvent(e.ctx,i,e.event,e.messages)),c=toCurrentDynamicToolMetadataList(t,s.metadata);e.ctx.set(TurnDynamicToolMetadataKey,c);let l=c.filter(t=>(a.has(t.resolverSlug)||o.has(t.resolverSlug))&&n.some(e=>e.resolverSlug===t.resolverSlug&&e.name===t.name)&&hasUnregisteredDurableDynamicCallbacks([t],{sessionId:e.ctx.require(SessionIdKey),scope:`turn`}));if(l.length>0)throw Error(`Dynamic tool callback rebind did not restore: ${l.map(e=>e.name).join(`, `)}. The tool may have been renamed or removed.`)}export{dispatchDynamicToolEvent,preparePersistedStepDynamicToolMetadata,rebindMissingCompiledDynamicToolCallbacks,refreshDynamicSessionToolsForRuntimeRevision,resolveStepDynamicTools,validateDurableDynamicToolCallbacks};

package/dist/src/context/dynamic-tool-metadata.d.ts

@@ -1,47 +0,0 @@
-import type { JsonObject } from "#shared/json.js";
-import type { DurableDynamicToolCallbacks } from "#tools/durable-callbacks.js";
-interface DynamicToolMetadataBase {
-    readonly frameworkTool?: boolean;
-    readonly availableInSubagents?: boolean;
-    readonly deferred?: boolean;
-    readonly name: string;
-    readonly description: string;
-    readonly endsTurn?: boolean;
-    readonly inputSchema: JsonObject;
-    readonly outputSchema?: JsonObject;
-    readonly resolverSlug: string;
-    readonly entryKey: string;
-}
-/** Callback identity is supplied by the surrounding session, scope, and resolver metadata. */
-export interface CurrentDynamicToolMetadata extends DynamicToolMetadataBase {
-    readonly callbacks: DurableDynamicToolCallbacks;
-}
-/** Old schema written before callback descriptors existed. */
-export interface OldStepFunctionDynamicToolMetadata extends DynamicToolMetadataBase {
-    readonly callbacks?: never;
-    readonly executeStepFnName?: string;
-    readonly approvalStepFnName?: string;
-    readonly approvalResponseStepFnName?: string;
-    readonly closureVars?: Record<string, unknown>;
-}
-interface OldSourceOffsetDynamicCallbackReference {
-    readonly closure: JsonObject;
-    readonly stepId: string;
-}
-/** Old schema whose callback identity was a generated source offset. */
-export interface OldSourceOffsetDynamicToolMetadata extends DynamicToolMetadataBase {
-    readonly callbacks: {
-        readonly execute: OldSourceOffsetDynamicCallbackReference;
-        readonly approvalRequest?: OldSourceOffsetDynamicCallbackReference;
-        readonly approvalResponse?: OldSourceOffsetDynamicCallbackReference;
-        readonly toModelOutput?: OldSourceOffsetDynamicCallbackReference;
-    };
-}
-export type OldDynamicToolMetadata = OldStepFunctionDynamicToolMetadata | OldSourceOffsetDynamicToolMetadata;
-export type PersistedDynamicToolMetadata = CurrentDynamicToolMetadata | OldDynamicToolMetadata;
-export declare function isOldSourceOffsetDynamicToolMetadata(metadata: PersistedDynamicToolMetadata): metadata is OldSourceOffsetDynamicToolMetadata;
-export declare function isCurrentDynamicToolMetadata(metadata: PersistedDynamicToolMetadata): metadata is CurrentDynamicToolMetadata;
-/** Converts persisted metadata without changing already-persisted callback closures. */
-export declare function toCurrentDynamicToolMetadata(persisted: PersistedDynamicToolMetadata, resolved?: CurrentDynamicToolMetadata): CurrentDynamicToolMetadata;
-export declare function toCurrentDynamicToolMetadataList(persisted: readonly PersistedDynamicToolMetadata[], resolved?: readonly CurrentDynamicToolMetadata[]): readonly CurrentDynamicToolMetadata[];
-export {};

package/dist/src/context/dynamic-tool-metadata.js

@@ -1 +0,0 @@
-function isOldSourceOffsetDynamicToolMetadata(e){return e.callbacks!==void 0&&`stepId`in e.callbacks.execute}function isCurrentDynamicToolMetadata(e){return e.callbacks!==void 0&&!isOldSourceOffsetDynamicToolMetadata(e)}function isOldStepFunctionDynamicToolMetadata(e){return e.callbacks===void 0}function withoutSourceOffset(e){return{closure:e.closure}}function convertSourceOffsetMetadata(e){let t={execute:withoutSourceOffset(e.callbacks.execute),...e.callbacks.approvalRequest===void 0?{}:{approvalRequest:withoutSourceOffset(e.callbacks.approvalRequest)},...e.callbacks.approvalResponse===void 0?{}:{approvalResponse:withoutSourceOffset(e.callbacks.approvalResponse)},...e.callbacks.toModelOutput===void 0?{}:{toModelOutput:withoutSourceOffset(e.callbacks.toModelOutput)}};return{...e,callbacks:t}}function toCurrentDynamicToolMetadata(e,t){if(isCurrentDynamicToolMetadata(e))return e;if(t===void 0)throw Error(`Dynamic tool "${e.name}" uses old persisted metadata, but its resolver did not return a current replacement.`);if(t.resolverSlug!==e.resolverSlug||t.name!==e.name)throw Error(`Dynamic tool "${e.name}" received current metadata from a different resolver or tool.`);if(!isOldStepFunctionDynamicToolMetadata(e)){for(let n of Object.keys(e.callbacks))if(t.callbacks[n]===void 0)throw Error(`Dynamic tool "${e.name}" lost its ${n} callback while converting old persisted metadata.`);return convertSourceOffsetMetadata(e)}if(e.approvalResponseStepFnName!==void 0&&e.approvalStepFnName===void 0)throw Error(`Dynamic tool "${e.name}" has an old approval-response callback without an approval-request callback.`);if(e.approvalStepFnName!==void 0&&t.callbacks.approvalRequest===void 0)throw Error(`Dynamic tool "${e.name}" lost its approval-request callback while converting old persisted metadata.`);if(e.approvalResponseStepFnName!==void 0&&t.callbacks.approvalResponse===void 0)throw Error(`Dynamic tool "${e.name}" lost its approval-response callback while converting old persisted metadata.`);return t}function toCurrentDynamicToolMetadataList(e,t=[]){return e.map(e=>toCurrentDynamicToolMetadata(e,t.find(t=>t.resolverSlug===e.resolverSlug&&t.name===e.name)))}export{isCurrentDynamicToolMetadata,isOldSourceOffsetDynamicToolMetadata,toCurrentDynamicToolMetadata,toCurrentDynamicToolMetadataList};

package/dist/src/context/effective-model.d.ts

@@ -1,5 +0,0 @@
-import type { ContextKey } from "#context/key.js";
-import { type LiveDynamicModelSelection } from "#context/keys.js";
-export declare function getEffectiveModelSelection(ctx: {
-    get<T>(key: ContextKey<T>): T | undefined;
-}): LiveDynamicModelSelection | null;

package/dist/src/context/effective-model.js

@@ -1 +0,0 @@
-import{LiveStepDynamicModelSelectionKey,SessionDynamicModelReferenceKey,StaticModelReferenceKey,TurnDynamicModelReferenceKey}from"#context/keys.js";function getEffectiveModelSelection(e){let t=e.get(LiveStepDynamicModelSelectionKey);if(t!=null)return t;let n=e.get(TurnDynamicModelReferenceKey);if(n!=null)return{reference:n};let r=e.get(SessionDynamicModelReferenceKey);if(r!=null)return{reference:r};let i=e.get(StaticModelReferenceKey);if(i===void 0)throw Error(`Effective model resolution requires initialized static model state.`);return i===null?null:{reference:i}}export{getEffectiveModelSelection};

package/dist/src/context/hook-lifecycle.d.ts

@@ -1,15 +0,0 @@
-import type { MessageStreamEvent } from "#protocol/message.js";
-import type { RuntimeHookRegistry } from "#runtime/hooks/registry.js";
-import type { ContextContainer } from "./container.js";
-/**
- * Fans one runtime stream event out to every matching subscriber.
- * Authored handler failures are logged independently. Caller must hold an
- * active ALS scope so hooks see the same context as the rest of the step.
- */
-export declare function dispatchStreamEventHooks(input: {
-    readonly ctx: ContextContainer;
-    readonly registry: RuntimeHookRegistry;
-    readonly event: MessageStreamEvent;
-    /** Stops the running turn for `ctx.cancel()`; `undefined` when this event cannot stop one. */
-    readonly cancelTurn: (() => void) | undefined;
-}): Promise<void>;

package/dist/src/context/hook-lifecycle.js

@@ -1 +0,0 @@
-import{ContinuationTokenKey}from"./keys.js";import{createLogger,logError}from"#internal/logging.js";import{getAdapterKind}from"#channel/adapter.js";import{buildCallbackContext}from"#context/build-callback-context.js";import{BundleKey,ChannelKey}from"#runtime/sessions/runtime-context-keys.js";const log=createLogger(`hooks`);async function dispatchStreamEventHooks(e){let t=e.registry.streamEventsByType.get(e.event.type)??[],n=e.registry.streamEventsWildcard;if(t.length===0&&n.length===0)return;let r=buildHookContext(e.ctx),i=!0;for(let a of[...t,...n]){let t={...r,cancel:()=>{if(i&&e.cancelTurn!==void 0){e.cancelTurn();return}log.warn(i?`ctx.cancel() ignored: the event is not part of a running turn`:`ctx.cancel() ignored: the event's hooks already returned`,{hook:a.slug,eventId:e.event.meta.id,eventType:e.event.type,sessionId:r.session.id})}};try{await a.handler(e.event,t)}catch(t){logError(log,`stream event hook failed`,t,{hook:a.slug,subscription:a.eventType,eventId:e.event.meta.id,eventType:e.event.type,sessionId:r.session.id})}}i=!1}function buildHookContext(e){let t=e.require(BundleKey),n=e.get(ChannelKey),r=e.get(ContinuationTokenKey),i=n===void 0?void 0:getAdapterKind(n);return{...buildCallbackContext(),agent:{name:t.turnAgent.id,nodeId:t.nodeId},channel:{kind:i,continuationToken:r}}}export{dispatchStreamEventHooks};

package/dist/src/context/memory-event-lifecycle.d.ts

@@ -1,15 +0,0 @@
-import type { ModelMessage } from "ai";
-import type { AlsContext } from "#context/container.js";
-import type { UnstampedMessageStreamEvent } from "#protocol/message.js";
-import type { ResolvedMemoryDefinition } from "#runtime/types.js";
-import type { MemoryInstrumentation } from "#instrumentation/memory.js";
-export declare function dispatchMemoryLifecycleEvent(input: {
-    readonly abortSignal?: AbortSignal;
-    readonly appRoot: string;
-    readonly ctx: AlsContext;
-    readonly event: UnstampedMessageStreamEvent;
-    readonly memories: readonly ResolvedMemoryDefinition[];
-    readonly messages?: readonly ModelMessage[];
-    readonly nodeId: string;
-    readonly instrumentation?: MemoryInstrumentation;
-}): Promise<readonly ModelMessage[]>;

package/dist/src/context/memory-event-lifecycle.js

@@ -1 +0,0 @@
-import{createLogger}from"#internal/logging.js";import{dispatchMemoryCompactionCompleted,dispatchMemoryCompactionRequested,dispatchMemoryTurnCompleted,dispatchMemoryTurnStarted}from"#context/memory-lifecycle.js";const log=createLogger(`memory`);async function dispatchMemoryLifecycleEvent(e){let t=e.messages??[];if(e.memories.length===0)return t;if(e.event.type===`turn.started`)return await dispatchMemoryTurnStarted({abortSignal:e.abortSignal,appRoot:e.appRoot,ctx:e.ctx,event:e.event,instrumentation:e.instrumentation,memories:e.memories,nodeId:e.nodeId});if(e.event.type===`compaction.requested`)await dispatchMemoryCompactionRequested({abortSignal:e.abortSignal,appRoot:e.appRoot,ctx:e.ctx,event:e.event,instrumentation:e.instrumentation,memories:e.memories,messages:t,nodeId:e.nodeId});else if(e.event.type===`compaction.completed`)t=await dispatchMemoryCompactionCompleted({abortSignal:e.abortSignal,ctx:e.ctx,event:e.event,instrumentation:e.instrumentation,memories:e.memories,messages:t});else if(e.event.type===`turn.completed`&&e.messages!==void 0)try{await dispatchMemoryTurnCompleted({abortSignal:e.abortSignal,ctx:e.ctx,event:e.event,instrumentation:e.instrumentation,memories:e.memories,messages:t})}catch(e){log.error(`Completed-turn memory capture failed.`,{error:e})}return t}export{dispatchMemoryLifecycleEvent};

package/dist/src/context/memory-lifecycle.d.ts

@@ -1,47 +0,0 @@
-import type { ModelMessage } from "ai";
-import type { AlsContext } from "#context/container.js";
-import { type PreparedMemoryPreamble } from "#context/keys.js";
-import type { CompactionCompletedStreamEvent, CompactionRequestedStreamEvent, TurnCompletedStreamEvent, TurnStartedStreamEvent } from "#protocol/message.js";
-import { type MemoryInstrumentation } from "#instrumentation/memory.js";
-import type { ResolvedMemoryDefinition } from "#runtime/types.js";
-export declare function prepareMemoryPreamble(ctx: AlsContext, input: PreparedMemoryPreamble): void;
-export declare function dispatchMemoryTurnStarted(input: {
-    readonly abortSignal?: AbortSignal;
-    readonly appRoot: string;
-    readonly ctx: AlsContext;
-    readonly event: TurnStartedStreamEvent;
-    readonly memories: readonly ResolvedMemoryDefinition[];
-    readonly nodeId: string;
-    readonly instrumentation?: MemoryInstrumentation;
-}): Promise<readonly ModelMessage[]>;
-export declare function drainMemoryCommit(ctx: AlsContext): import("#context/keys.js").PendingMemoryCommit | undefined;
-export declare function prepareMemoryCompaction(ctx: AlsContext, input: {
-    readonly history: readonly ModelMessage[];
-    readonly state?: Readonly<Record<string, unknown>>;
-}): void;
-export declare function dispatchMemoryCompactionRequested(input: {
-    readonly abortSignal?: AbortSignal;
-    readonly appRoot: string;
-    readonly ctx: AlsContext;
-    readonly event: CompactionRequestedStreamEvent;
-    readonly memories: readonly ResolvedMemoryDefinition[];
-    readonly messages: readonly ModelMessage[];
-    readonly nodeId: string;
-    readonly instrumentation?: MemoryInstrumentation;
-}): Promise<void>;
-export declare function dispatchMemoryCompactionCompleted(input: {
-    readonly abortSignal?: AbortSignal;
-    readonly ctx: AlsContext;
-    readonly event: CompactionCompletedStreamEvent;
-    readonly memories: readonly ResolvedMemoryDefinition[];
-    readonly messages: readonly ModelMessage[];
-    readonly instrumentation?: MemoryInstrumentation;
-}): Promise<readonly ModelMessage[]>;
-export declare function dispatchMemoryTurnCompleted(input: {
-    readonly abortSignal?: AbortSignal;
-    readonly ctx: AlsContext;
-    readonly event: TurnCompletedStreamEvent;
-    readonly memories: readonly ResolvedMemoryDefinition[];
-    readonly messages: readonly ModelMessage[];
-    readonly instrumentation?: MemoryInstrumentation;
-}): Promise<void>;

package/dist/src/context/memory-lifecycle.js

@@ -1 +0,0 @@
-import{createLogger}from"#internal/logging.js";import{PendingMemoryCommitKey,PreparedMemoryCompactionKey,PreparedMemoryPreambleKey,TurnMemoryLocksKey}from"#context/keys.js";import{buildCallbackContext}from"#context/build-callback-context.js";import{buildResolveContext}from"#context/dynamic-resolve-context.js";import{isEveDevEnvironment}from"#internal/application/dev-environment.js";import{defaultNamespace}from"#public/memory/index.js";import{instrumentMemoryOperation}from"#instrumentation/memory.js";import{applyMemoryRecallBatches,createMemoryLock,projectMemoryHistory,validateMemoryRecallResult}from"#shared/memory-state.js";const fallbackAbortSignal=new AbortController().signal,log=createLogger(`memory`);function prepareMemoryPreamble(e,t){e.setVirtualContext(PreparedMemoryPreambleKey,t)}async function dispatchMemoryTurnStarted(e){let t=e.ctx.get(PreparedMemoryPreambleKey);if(t===void 0)return[];let n=Object.freeze({id:e.event.data.turnId,input:Object.freeze([...t.input]),sequence:e.event.data.sequence}),r=Object.fromEntries((await Promise.all([...e.memories].sort((e,t)=>e.logicalPath.localeCompare(t.logicalPath)).map(async t=>{let r=await resolveMemoryLock({abortSignal:e.abortSignal??fallbackAbortSignal,appRoot:e.appRoot,ctx:e.ctx,memory:t,nodeId:e.nodeId,turn:n});return r===null?null:[t.slot,r]}))).filter(e=>e!==null));e.ctx.set(TurnMemoryLocksKey,r);let i=projectMemoryHistory({locks:r,messages:t.history}),a=buildCallbackContext(),o=(await settleMemoryOperations([...e.memories].sort((e,t)=>e.logicalPath.localeCompare(t.logicalPath)).map(async t=>{let o=r[t.slot];if(o===void 0)return null;let s=memoryOperationId({phase:`turn.started`,sequence:e.event.data.sequence,sessionId:a.session.id,slot:t.slot,turnId:n.id});return{lock:o,messages:await instrumentMemoryOperation(e.instrumentation,memoryInstrumentationOperation({operationId:s,operationName:`search_memory`,phase:`turn.started`,slot:t.slot,storeId:o.scope.key,turnId:n.id}),async()=>{let r=await t.provider.recall[`turn.started`]({...a,abortSignal:e.abortSignal??fallbackAbortSignal,memory:{scope:o.scope,slot:t.slot},messages:i,operationId:s,turn:n}),c=validateMemoryRecallResult(r,t.slot);return{outputRecords:memoryRecords(r),recordCount:c.length,value:c}}),operationId:s}}))).filter(e=>e!==null),s=applyMemoryRecallBatches({batches:o,history:t.history,state:t.state}),c=[...projectMemoryHistory({locks:r,messages:s.history}),...t.input],l=t.projector?.({messages:c,state:s.state})??c;return e.ctx.setVirtualContext(PendingMemoryCommitKey,{recalledMessages:s.recalledMessages,state:s.state}),l}function drainMemoryCommit(e){let t=e.get(PendingMemoryCommitKey);return e.delete(PendingMemoryCommitKey),e.delete(PreparedMemoryPreambleKey),t}function prepareMemoryCompaction(e,t){e.setVirtualContext(PreparedMemoryCompactionKey,t)}async function dispatchMemoryCompactionRequested(e){let t=buildCallbackContext(),n=await resolveCompactionLocks(e);e.ctx.set(TurnMemoryLocksKey,n);let r=e.event.data.turnId.length===0?null:firstLockedTurn(n);await settleMemoryOperations([...e.memories].sort((e,t)=>e.logicalPath.localeCompare(t.logicalPath)).map(async i=>{let a=n[i.slot],o=i.provider.capture?.[`compaction.requested`];if(a===void 0||o===void 0)return;let s=memoryOperationId({phase:`compaction.requested`,sequence:e.event.data.sequence,sessionId:t.session.id,slot:i.slot,stepIndex:e.event.data.stepIndex,turnId:r?.id??null});await instrumentMemoryOperation(e.instrumentation,memoryInstrumentationOperation({operationId:s,operationName:`upsert_memory`,phase:`compaction.requested`,slot:i.slot,storeId:a.scope.key,turnId:r?.id}),async()=>(await o({...t,abortSignal:e.abortSignal??fallbackAbortSignal,compaction:{modelId:e.event.data.modelId,usageInputTokens:e.event.data.usageInputTokens},memory:{scope:a.scope,slot:i.slot},messages:e.messages,operationId:s,turn:r}),{value:void 0}))}))}async function dispatchMemoryCompactionCompleted(e){let t=e.ctx.get(PreparedMemoryCompactionKey),n=t?.history??e.messages,r=e.ctx.get(TurnMemoryLocksKey)??{},i=projectMemoryHistory({locks:r,messages:n}),a=buildCallbackContext(),o=e.event.data.turnId.length===0?null:firstLockedTurn(r),s=(await settleMemoryOperations([...e.memories].sort((e,t)=>e.logicalPath.localeCompare(t.logicalPath)).map(async t=>{let n=r[t.slot],s=t.provider.recall[`compaction.completed`];if(n===void 0||s===void 0)return null;let c=memoryOperationId({phase:`compaction.completed`,sequence:e.event.data.sequence,sessionId:a.session.id,slot:t.slot,stepIndex:e.event.data.stepIndex,turnId:o?.id??null});return{lock:n,messages:await instrumentMemoryOperation(e.instrumentation,memoryInstrumentationOperation({operationId:c,operationName:`search_memory`,phase:`compaction.completed`,slot:t.slot,storeId:n.scope.key,turnId:o?.id}),async()=>{let r=await s({...a,abortSignal:e.abortSignal??fallbackAbortSignal,compaction:{modelId:e.event.data.modelId},memory:{scope:n.scope,slot:t.slot},messages:i,operationId:c,turn:o}),l=validateMemoryRecallResult(r,t.slot);return{outputRecords:memoryRecords(r),recordCount:l.length,value:l}}),operationId:c}}))).filter(e=>e!==null),c=applyMemoryRecallBatches({batches:s,history:n,state:t?.state}),l=projectMemoryHistory({locks:r,messages:c.history});return e.ctx.setVirtualContext(PendingMemoryCommitKey,{recalledMessages:c.recalledMessages,state:c.state}),e.ctx.delete(PreparedMemoryCompactionKey),l}async function dispatchMemoryTurnCompleted(e){let t=e.ctx.get(TurnMemoryLocksKey)??{},n=buildCallbackContext(),r=projectMemoryHistory({locks:t,messages:e.messages});await settleMemoryOperations([...e.memories].sort((e,t)=>e.logicalPath.localeCompare(t.logicalPath)).map(async i=>{let a=t[i.slot],o=i.provider.capture?.[`turn.completed`];if(a===void 0||o===void 0)return;let s=memoryOperationId({phase:`turn.completed`,sequence:e.event.data.sequence,sessionId:n.session.id,slot:i.slot,turnId:e.event.data.turnId});await instrumentMemoryOperation(e.instrumentation,memoryInstrumentationOperation({operationId:s,operationName:`upsert_memory`,phase:`turn.completed`,slot:i.slot,storeId:a.scope.key,turnId:a.turn.id}),async()=>(await o({...n,abortSignal:e.abortSignal??fallbackAbortSignal,memory:{scope:a.scope,slot:i.slot},messages:r,operationId:s,turn:a.turn}),{value:void 0}))}))}async function resolveCompactionLocks(e){let t=e.ctx.get(TurnMemoryLocksKey);if(e.event.data.turnId.length>0&&t!==void 0)return t;let n=Object.freeze({id:``,input:[],sequence:e.event.data.sequence});return Object.fromEntries((await Promise.all(e.memories.map(async t=>{let r=await resolveMemoryLock({abortSignal:e.abortSignal??fallbackAbortSignal,appRoot:e.appRoot,ctx:e.ctx,memory:t,nodeId:e.nodeId,turn:n});return r===null?null:[t.slot,r]}))).filter(e=>e!==null))}function firstLockedTurn(e){return Object.values(e)[0]?.turn??null}async function resolveMemoryLock(e){let t=buildResolveContext(e.ctx,[]),n={abortSignal:e.abortSignal,channel:t.channel,session:t.session},r=typeof e.memory.scope==`function`?await e.memory.scope(n):e.memory.scope;if(r===null)return reportDisabledMemorySlot(e.memory.slot,`scope`),null;let i={appRoot:e.appRoot,node:e.nodeId,slot:e.memory.slot},a=e.memory.namespace===void 0?defaultNamespace(i):typeof e.memory.namespace==`function`?await e.memory.namespace(i):e.memory.namespace;return a===null?(reportDisabledMemorySlot(e.memory.slot,`namespace`),null):createMemoryLock({namespace:a,scope:r,slot:e.memory.slot,turn:e.turn,visibility:e.memory.visibility})}function reportDisabledMemorySlot(e,t){isEveDevEnvironment()&&log.info(`Memory slot is disabled for this operation`,{resolver:t,slot:e})}async function settleMemoryOperations(e){let t=await Promise.allSettled(e),n=[],r;for(let e of t)e.status===`rejected`?r??=e:n.push(e.value);if(r!==void 0)throw r.reason;return n}function memoryOperationId(e){return[`eve-memory-operation-v1`,e.sessionId,String(e.sequence),e.turnId??`standalone`,...e.stepIndex===void 0?[]:[String(e.stepIndex)],e.phase,e.slot].join(`:`)}function memoryInstrumentationOperation(e){return{idempotencyKey:e.operationId,operationName:e.operationName,phase:e.phase,slot:e.slot,storeId:e.storeId,turnId:e.turnId}}function memoryRecords(e){return e==null?[]:e.messages.map(e=>e.id===void 0?{content:e.content}:{content:e.content,id:e.id})}export{dispatchMemoryCompactionCompleted,dispatchMemoryCompactionRequested,dispatchMemoryTurnCompleted,dispatchMemoryTurnStarted,drainMemoryCommit,prepareMemoryCompaction,prepareMemoryPreamble};

package/dist/src/context/serialized-dynamic-model-selection.d.ts

@@ -1,2 +0,0 @@
-/** Keeps a completed session-scoped model selection when its turn is cancelled. */
-export declare function preserveSerializedSessionDynamicModelSelection(original: Record<string, unknown>, interrupted: Record<string, unknown>): Record<string, unknown>;

package/dist/src/context/serialized-dynamic-model-selection.js

@@ -1 +0,0 @@
-import{SessionDynamicModelReferenceKey}from"#context/keys.js";function preserveSerializedSessionDynamicModelSelection(e,t){let n=t[SessionDynamicModelReferenceKey.name];return n===void 0?e:{...e,[SessionDynamicModelReferenceKey.name]:n}}export{preserveSerializedSessionDynamicModelSelection};

package/dist/src/execution/cancel-descendant-turns-step.d.ts

@@ -1,6 +0,0 @@
-import { type DurableSessionState } from "#execution/durable-session-store.js";
-/** Cancels every workflow tool run the turn is waiting on. */
-export declare function cancelDescendantTurnsStep(input: {
-    readonly serializedContext: Record<string, unknown>;
-    readonly sessionState: DurableSessionState;
-}): Promise<void>;

package/dist/src/execution/cancel-descendant-turns-step.js

@@ -1 +0,0 @@
-import{createLogger,logError}from"#internal/logging.js";import{runtimeWait,storedProjection,turnPosition}from"#harness/session-machine/view.js";import{readDurableSession}from"#execution/durable-session-store.js";import{cancelWorkflowToolRun}from"#execution/tools/workflow/cancel.js";import{getBlockingWorkflowToolRuns}from"#harness/workflow-tool-runs.js";const log=createLogger(`execution.cancel-descendant-turns`);async function cancelDescendantTurnsStep(e){"use step";let t;try{let n=readDurableSession(e.sessionState);t=getBlockingWorkflowToolRuns(n.state,runtimeWait(n.state)?.event.turnId??turnPosition(storedProjection(n.state)).turnId)}catch(t){logError(log,`failed to read pending descendants during cancellation`,t,{sessionId:e.sessionState.sessionId});return}await Promise.all(t.map(e=>cancelWorkflowToolRun(e.address,{kind:`cancel`,reason:`The turn that called the tool was cancelled.`})))}export{cancelDescendantTurnsStep};

package/dist/src/execution/dynamic-connection-recovery.d.ts

@@ -1,14 +0,0 @@
-import type { HandleEventFn, HarnessSession, StepResult } from "#harness/types.js";
-import type { SessionProjection } from "#protocol/session-projection.js";
-/**
- * Parks the session with `step.failed` → `turn.failed` → `session.waiting`
- * when a dynamic connection resolver throws during rehydration, so the next
- * message can retry once the dependency recovers. Returns `undefined` for any
- * other error so the caller rethrows it.
- */
-export declare function recoverDynamicConnectionRehydration(input: {
-    readonly error: unknown;
-    readonly emit: HandleEventFn;
-    readonly projection: SessionProjection;
-    readonly session: HarnessSession;
-}): Promise<StepResult | undefined>;

package/dist/src/execution/dynamic-connection-recovery.js

@@ -1 +0,0 @@
-import{createErrorId,createLogger}from"#internal/logging.js";import{toErrorMessage}from"#shared/errors.js";import{activeTurnId,turnPosition}from"#harness/session-machine/view.js";import{fail}from"#harness/session-machine/transitions.js";import{isDynamicConnectionResolutionError}from"#context/dynamic-connection-lifecycle.js";import{applyTransition,sessionView}from"#harness/session-machine/commit.js";const log=createLogger(`turn-step`);async function recoverDynamicConnectionRehydration(e){if(!isDynamicConnectionResolutionError(e.error))return;let t=createErrorId(),n=toErrorMessage(e.error);return log.error(`dynamic connection rehydration failed — parking session`,{error:e.error,errorId:t,sessionId:e.session.sessionId,turnId:activeTurnId(turnPosition(e.projection))}),{next:null,session:{...await applyTransition(e.session,fail(sessionView(e.projection,e.session.state),{code:`EVENT_HANDLER_FAILED`,details:{errorId:t},message:n}),e.emit),outputSchema:void 0},settledTurn:{isError:!0,output:n}}}export{recoverDynamicConnectionRehydration};

package/dist/src/execution/dynamic-connections.d.ts

@@ -1,12 +0,0 @@
-import type { ContextContainer } from "#context/container.js";
-import type { TurnPosition } from "#harness/session-machine/view.js";
-import type { RuntimeIdentity, UnstampedMessageStreamEvent } from "#protocol/message.js";
-import type { ResolvedAgent } from "#runtime/types.js";
-/** Binds dynamic connection lifecycle dispatch to one execution context. */
-export declare function bindDynamicConnections(ctx: ContextContainer, agent: Pick<ResolvedAgent, "dynamicConnectionResolvers">): {
-    dispatch: (event: UnstampedMessageStreamEvent) => Promise<void>;
-    rehydrate(state: TurnPosition, runtime: RuntimeIdentity, turn?: {
-        readonly sequence: number;
-        readonly turnId: string;
-    }): Promise<void>;
-};

package/dist/src/execution/dynamic-connections.js

@@ -1 +0,0 @@
-import{dispatchDynamicConnectionEvent}from"#context/dynamic-connection-lifecycle.js";import{sessionStartedForResolvers,turnStartedForResolvers}from"#harness/session-machine/resolver-events.js";function bindDynamicConnections(e,t){let n=t.dynamicConnectionResolvers??[],dispatch=async t=>{await dispatchDynamicConnectionEvent({ctx:e,event:t,resolvers:n})};return{dispatch,async rehydrate(e,t,n){e.sessionStarted&&(await dispatch(sessionStartedForResolvers(t)),n!==void 0&&await dispatch(turnStartedForResolvers(n)))}}}export{bindDynamicConnections};

package/dist/src/execution/history-view.d.ts

@@ -1,10 +0,0 @@
-import type { HarnessSession } from "#harness/types.js";
-import { type HistoryViewProjector, type PreparedHistoryView } from "#shared/history-view.js";
-interface ExecutionHistoryView {
-    readonly initial: PreparedHistoryView;
-    readonly messages: (session: HarnessSession) => PreparedHistoryView["messages"];
-    readonly prepare: (session: HarnessSession) => PreparedHistoryView;
-    readonly projector: HistoryViewProjector;
-}
-export declare function createExecutionHistoryView(session: HarnessSession): ExecutionHistoryView;
-export {};

package/dist/src/execution/history-view.js

@@ -1 +0,0 @@
-import{projectMemoryHistoryFromSessionState}from"#shared/memory-state.js";import{createHistoryViewPreparer}from"#shared/history-view.js";function createExecutionHistoryView(e){let t=projectMemoryHistoryFromSessionState,n=createHistoryViewPreparer({projector:t}),prepare=e=>n(e.history,e.state);return{initial:prepare(e),messages:e=>prepare(e).messages,prepare,projector:t}}export{createExecutionHistoryView};

package/dist/src/execution/legacy-remote-agent/protocol.d.ts

@@ -1,49 +0,0 @@
-import type { ContextContainer } from "#context/container.js";
-import type { UnstampedMessageStreamEvent } from "#protocol/message.js";
-import type { RouteContext } from "#public/definitions/channel.js";
-export declare const LEGACY_REMOTE_AGENT_PROTOCOL_VERSION = 1;
-/** A session created by a protocol-1 caller. */
-export interface LegacyRemoteAgentCaller {
-    /**
-     * The caller's background task; its questions and sign-ins are forwarded
-     * only with one. Captured at create: a 0.66–0.68 caller's model-called
-     * agents start in a task, and those callers never check it against later turns.
-     */
-    readonly taskId?: string;
-}
-/**
- * Removes the `callback.taskId` a protocol-1 caller adds when it delegates
- * from a background task. Current callers don't send it. The task id is
- * returned so the session can name it back to the caller. The caller's
- * `activityObserver` needs no removal: eve ignores that field from any caller.
- */
-export declare function splitLegacyTaskFields(input: Record<string, unknown>): {
-    readonly payload: Record<string, unknown>;
-    readonly taskId?: string;
-};
-/**
- * Sends a question, approval, or sign-in to a protocol-1 caller in the
- * `task.*` callback it expects. Returns whether the event was forwarded and
- * must stay off this session's own channel.
- */
-export declare function forwardLegacySessionInput(ctx: ContextContainer, caller: LegacyRemoteAgentCaller, event: UnstampedMessageStreamEvent): Promise<boolean>;
-/**
- * Renames a `task.*` callback that a remote agent sends a protocol-1 caller to
- * the payload kind the caller's session reads. The callback URL resolves to the
- * caller's newest deployment, while the session waiting on it may still run on
- * an eve 0.66–0.68 build; both read the renamed kinds. The caller still
- * validates the result.
- */
-export declare function renameLegacyTaskCallback(body: unknown): unknown;
-/** Route a protocol-1 caller posts its answers to a remote agent's question or approval. */
-export declare const legacyTaskInputRoute: {
-    readonly handler: typeof handleLegacyTaskInputRequest;
-    readonly path: "/eve/v1/task-input/:token";
-};
-/**
- * Delivers a protocol-1 caller's answers. The token is the capability the
- * caller derived from this session's create-once continuation token, so it
- * authorizes the request on its own, as it did in protocol 1.
- */
-declare function handleLegacyTaskInputRequest(request: Request, ctx: RouteContext): Promise<Response>;
-export {};

package/dist/src/execution/legacy-remote-agent/protocol.js

@@ -1 +0,0 @@
-import{createLogger,logError}from"#internal/logging.js";import{isObject}from"#shared/guards.js";import{isInputResponse}from"#shared/input.js";import{ContinuationTokenKey,SessionCallbackKey,SessionIdKey}from"#context/keys.js";import{EVE_ROUTE_PREFIX}from"#protocol/routes.js";import{resumeSessionInbox}from"#execution/session-inbox/resume.js";import{postSessionCallbackRequest}from"#execution/session-callback-request.js";import{HookNotFoundError}from"#compiled/@workflow/errors/index.js";const log=createLogger(`execution.legacy-remote-agent`),LEGACY_REMOTE_AGENT_PROTOCOL_VERSION=1,TASK_INPUT_TOKEN_RE=/^eve:task-input:([a-f0-9]{32})$/;function splitLegacyTaskFields(e){let{callback:t}=e;if(!isObject(t)||!(`taskId`in t))return{payload:e};let{taskId:n,...r}=t,i={...e,callback:r};return typeof n==`string`&&n.length>0?{payload:i,taskId:n}:{payload:i}}async function forwardLegacySessionInput(e,t,n){let r=e.get(SessionCallbackKey),i=e.get(ContinuationTokenKey);if(t.taskId===void 0||r===void 0||!i)return!1;let a;if(n.type===`input.requested`)a={event:n.data,kind:`task.input-requested`};else if(n.type===`authorization.required`||n.type===`authorization.completed`)a={event:n,kind:`task.authorization`};else return!1;let o=await postSessionCallbackRequest({body:{callId:r.callId,childContinuationToken:i,childSessionId:e.require(SessionIdKey),event:a.event,kind:a.kind,subagentName:r.subagentName,taskId:t.taskId},url:r.url});if(!o.ok)throw Error(`Remote task event callback failed with HTTP ${o.status}.`);return!0}function renameLegacyTaskCallback(e){if(!isObject(e))return e;let{taskId:t,...n}=e;return e.kind===`task.input-requested`?{...n,kind:`subagent-input-request`}:e.kind===`task.authorization`?{...n,kind:`subagent-authorization-event`}:e}const legacyTaskInputRoute={handler:handleLegacyTaskInputRequest,path:`${EVE_ROUTE_PREFIX}/task-input/:token`};async function handleLegacyTaskInputRequest(e,t){let n=TASK_INPUT_TOKEN_RE.exec(t.params.token??``)?.[1];if(n===void 0)return Response.json({error:`Invalid task input token.`,ok:!1},{status:403});let r;try{r=await e.json()}catch{return Response.json({error:`Invalid JSON body.`,ok:!1},{status:400})}let i=isObject(r)?r.inputResponses:void 0;if(!Array.isArray(i)||i.length===0||!i.every(isInputResponse))return Response.json({error:`Expected a non-empty inputResponses array.`,ok:!1},{status:400});try{await resumeSessionInbox(`eve:eve:op:${n}`,{kind:`send`,payload:{inputResponses:i}})}catch(e){if(HookNotFoundError.is(e))return Response.json({error:`Task input target is not pending.`,ok:!1},{status:404});let t=logError(log,`legacy task input delivery failed`,e);return Response.json({error:`Failed to deliver the task input.`,errorId:t,ok:!1},{status:500})}return Response.json({ok:!0},{status:202})}export{LEGACY_REMOTE_AGENT_PROTOCOL_VERSION,forwardLegacySessionInput,legacyTaskInputRoute,renameLegacyTaskCallback,splitLegacyTaskFields};

package/dist/src/execution/runtime-errors.d.ts

@@ -1,13 +0,0 @@
-/**
- * Thrown by a {@link Runtime}'s `deliver` when no in-flight session
- * matches the continuation token. Callers using the resume-or-start
- * pattern (e.g. a channel address send) treat this as the signal to start
- * a fresh session.
- */
-export declare class RuntimeNoActiveSessionError extends Error {
-    readonly code: "NO_ACTIVE_SESSION";
-    readonly continuationToken: string;
-    constructor(continuationToken: string);
-}
-/** Type guard for {@link RuntimeNoActiveSessionError}. */
-export declare function isRuntimeNoActiveSessionError(error: unknown): error is RuntimeNoActiveSessionError;

package/dist/src/execution/runtime-errors.js

@@ -1 +0,0 @@
-var RuntimeNoActiveSessionError=class extends Error{code=`NO_ACTIVE_SESSION`;continuationToken;constructor(e){super(`No active session for continuationToken "${e}".`),this.name=`RuntimeNoActiveSessionError`,this.continuationToken=e}};function isRuntimeNoActiveSessionError(e){return e instanceof RuntimeNoActiveSessionError}export{RuntimeNoActiveSessionError,isRuntimeNoActiveSessionError};