eve 0.68.0 → 0.70.0

package/dist/src/execution/tools/subagent/emit-event-step.js

@@ -1 +0,0 @@
-import{contextStorage}from"#context/container.js";import{BundleKey,ChannelKey}from"#runtime/sessions/runtime-context-keys.js";import{deserializeContext,serializeContext}from"#context/serialize.js";import{createDurableSessionState,readDurableSession}from"#execution/durable-session-store.js";import{resolveEffectiveAgentRuntime}from"#execution/effective-agent-config.js";import{hydrateDurableSession}from"#execution/session.js";import{withContextScope}from"#context/run-step.js";import{dispatchStreamEventHooks}from"#context/hook-lifecycle.js";import{createSessionEventSink}from"#execution/session/event-sink.js";import{reconcileSessionContinuationToken}from"#execution/reconcile-session-continuation-token.js";async function emitSubagentEventStep(e){"use step";let t=await deserializeContext(e.serializedContext),n=t.require(BundleKey),publish=async()=>{let n=createSessionEventSink({adapter:t.require(ChannelKey),ctx:t,isFirstTurn:e.sessionState.emissionState.sequence===0,sessionWritable:e.sessionWritable,sessionId:e.sessionState.sessionId});try{return await contextStorage.run(t,()=>n.emit(e.event))}finally{n.release()}},r=n.hookRegistry;if((r.streamEventsByType.get(e.event.type)?.length??0)===0&&r.streamEventsWildcard.length===0)return await publish(),{serializedContext:serializeContext(t),sessionState:e.sessionState};let i=resolveEffectiveAgentRuntime(n,t),a=hydrateDurableSession({durable:readDurableSession(e.sessionState),turnAgent:i.turnAgent,compactionOverrides:{thresholdPercent:i.thresholdPercent}}),o=await withContextScope(t,a,async e=>{let n=await publish();return n.suppressed||await dispatchStreamEventHooks({cancelTurn:void 0,ctx:t,registry:r,event:n.event}),{result:void 0,session:e}});return{serializedContext:serializeContext(t),sessionState:createDurableSessionState({session:reconcileSessionContinuationToken(t,o.session)})}}export{emitSubagentEventStep};

package/dist/src/execution/tools/subagent/invoke-agent.d.ts

@@ -1,42 +0,0 @@
-import type { RuntimeActionResultHookPayload, SubagentAuthorizationEventHookPayload, SubagentInputRequestHookPayload } from "#channel/types.js";
-import type { RuntimeSubagentChildResult } from "#shared/action-types.js";
-import type { JsonValue } from "#shared/json.js";
-import type { JsonObject } from "#shared/json.js";
-import type { AgentInput } from "#tools/workflow-definition.js";
-import type { ToolContext } from "#tools/definition.js";
-export type InternalAgentInput = {
-    readonly agentId?: string;
-    readonly message: string;
-    readonly outputSchema?: JsonObject;
-    readonly target: string;
-};
-/**
- * Asks the owning session to spawn an agent for a workflow tool run. Spawning
- * needs owner-held material (auth, capabilities, the agent handle
- * store) that a workflow tool body never has.
- */
-export interface AgentInvocationRequest {
-    readonly input: InternalAgentInput;
-    readonly invocationId: string;
-    readonly kind: "agent-invoke";
-}
-/**
- * Tells the owning session that an owner-spawned agent replied to the run, so
- * the owner can release the handle it reserved for `agent-invoke`.
- */
-export interface AgentSettlementRequest {
-    readonly kind: "agent-settled";
-    readonly result: RuntimeSubagentChildResult;
-}
-export type AgentInvocationEvent = SubagentAuthorizationEventHookPayload | SubagentInputRequestHookPayload;
-export type AgentInvocationReply = AgentInvocationEvent | RuntimeActionResultHookPayload | {
-    readonly kind: "agent-settled";
-    readonly callId: string;
-};
-/** Invokes an agent from a workflow tool. */
-export declare function agent(ctx: ToolContext, target: string, input: AgentInput): Promise<JsonValue>;
-/** Invokes an agent with a framework-selected replay-stable invocation id. */
-export declare function invokeAgent(ctx: ToolContext, input: InternalAgentInput, options?: {
-    readonly invocationId?: string;
-}): Promise<JsonValue>;
-export declare function validateAgentInput(input: InternalAgentInput): void;

package/dist/src/execution/tools/subagent/invoke-agent.js

@@ -1 +0,0 @@
-import{sessionCommandHookToken,sessionInboxHookToken}from"#execution/session-inbox/address.js";import{createHook}from"#compiled/@workflow/core/index.js";import{disposeHook}from"#execution/hook-ownership.js";import{resumeHookStep}from"#execution/tools/workflow/resume-hook-step.js";import{readWorkflowToolRunOwner,readWorkflowToolRunRef}from"#execution/tools/workflow/ask.js";async function agent(e,t,n){return readWorkflowToolRunRef(e),validateAgentInput({...n,target:t}),await invokeAgent(e,{agentId:n.agentId,message:n.message,outputSchema:n.outputSchema,target:t})}async function invokeAgent(e,t,n={}){validateAgentInput(t);let r=readWorkflowToolRunRef(e),i=readWorkflowToolRunOwner(e),a=createHook(),o=n.invocationId??`${e.callId}:${a.token}`;try{await resumeHookStep(i.inbox,{kind:`request`,from:r,replyTo:a.token,request:{input:t,invocationId:o,kind:`agent-invoke`}});let n=a[Symbol.asyncIterator]();for(;;){let s=await nextAgentReply(n,e.abortSignal);if(s.done)break;let c=s.value;if(c.kind===`runtime-action-result`){let s=c.results.find(e=>e.kind===`subagent-result`&&e.callId===o);if(s!==void 0){if(s.origin===`child`)for(await resumeHookStep(i.inbox,{kind:`request`,from:r,replyTo:a.token,request:{kind:`agent-settled`,result:s}});;){let r=await nextAgentReply(n,e.abortSignal);if(r.done)throw Error(`Agent "${t.target}" closed before settlement.`);if(r.value.kind===`agent-settled`&&r.value.callId===o)break}if(s.isError===!0)throw s.output;return s.output}continue}if(c.kind!==`agent-settled`){if(c.kind===`subagent-input-request`){await resumeHookStep(i.inbox,{kind:`request`,from:r,replyTo:c.childSessionInbox?.sessionId===c.childSessionId?sessionInboxHookToken(sessionCommandHookToken(c.childSessionInbox.sessionId)):c.childContinuationToken,request:{kind:`input-batch`,requests:c.event.requests},requestCoordinates:{sequence:c.event.sequence,stepIndex:c.event.stepIndex,turnId:c.event.turnId}});continue}await resumeHookStep(i.inbox,{kind:`request`,from:r,replyTo:a.token,request:{event:c,kind:`authorization-request`}})}}}finally{try{await disposeHook(a)}catch{}}throw Error(`Agent "${t.target}" closed without a result.`)}async function nextAgentReply(e,t){if(t===void 0)return await e.next();if(t.aborted)throw t.reason;let n,r=new Promise((e,t)=>{n=t}),abort=()=>n?.(t.reason);t.addEventListener(`abort`,abort,{once:!0});try{return await Promise.race([e.next(),r])}finally{t.removeEventListener(`abort`,abort)}}function validateAgentInput(e){if(typeof e.target!=`string`||e.target.trim()===``)throw TypeError(`agent() requires a non-empty agent name as its first argument.`);if(typeof e.message!=`string`||e.message.trim()===``)throw TypeError("agent() requires a non-empty `message`.");if(e.outputSchema!==void 0&&(typeof e.outputSchema!=`object`||e.outputSchema===null||Array.isArray(e.outputSchema)))throw TypeError("agent() `outputSchema` must be a JSON Schema object.")}export{agent,invokeAgent,validateAgentInput};

package/dist/src/execution/tools/subagent/invoke-preparation.d.ts

@@ -1,44 +0,0 @@
-import type { ContextReader } from "#context/key.js";
-import { type PreparedCoordinationDispatch } from "#execution/coordination-dispatch-shared.js";
-import { type DurableSessionState } from "#execution/durable-session-store.js";
-import type { RuntimeAgentDispatchRequest } from "#shared/action-types.js";
-import type { RuntimeSubagentDispatchFailure } from "#shared/action-types.js";
-import type { AgentInvocationRequest } from "#execution/tools/subagent/invoke-agent.js";
-import { type CompiledBundle } from "#runtime/sessions/runtime-context-keys.js";
-import type { DynamicRemoteAgentConfig } from "#runtime/subagents/dynamic-remote-agent-config.js";
-import { type RuntimeAgentHandleAction, type RuntimeSession } from "#subagents/handle-dispatch.js";
-import type { SubagentStartTarget } from "#execution/tools/subagent/start.js";
-type OwnerAgentDispatchPlanEntry = {
-    readonly kind: "resume";
-    readonly action: RuntimeAgentHandleAction;
-    readonly agentId: string;
-    readonly dynamicRemoteAgent?: DynamicRemoteAgentConfig;
-} | {
-    readonly kind: "reject";
-    readonly result: RuntimeSubagentDispatchFailure;
-} | {
-    readonly kind: "start";
-    readonly target: SubagentStartTarget;
-};
-/** Prepares one workflow-owner agent invocation from durable inputs. */
-export declare function prepareOwnerAgentInvocation(input: {
-    readonly invocation: AgentInvocationRequest["input"];
-    readonly invocationId: string;
-    readonly knownAgentIds?: readonly string[];
-    readonly serializedContext: Record<string, unknown>;
-    readonly sessionState: DurableSessionState;
-    readonly taskId?: string;
-}): Promise<Omit<PreparedCoordinationDispatch<OwnerAgentDispatchPlanEntry>, "sessionState">>;
-export declare function planAgentDispatch(input: {
-    readonly action: RuntimeAgentDispatchRequest;
-    readonly bundle: CompiledBundle;
-    readonly ctx: ContextReader;
-    readonly knownAgentIds?: readonly string[];
-    readonly session: RuntimeSession;
-}): OwnerAgentDispatchPlanEntry;
-export declare function resolveAgentInvocationAction(input: {
-    readonly ctx: ContextReader;
-    readonly input: AgentInvocationRequest["input"];
-    readonly invocationId: string;
-}): RuntimeAgentDispatchRequest;
-export {};

package/dist/src/execution/tools/subagent/invoke-preparation.js

@@ -1 +0,0 @@
-import{createLogger}from"#internal/logging.js";import{SessionDynamicSubagentSelectionsKey,TurnDynamicSubagentSelectionsKey}from"#context/keys.js";import{BundleKey}from"#runtime/sessions/runtime-context-keys.js";import{getHarnessEmissionState}from"#harness/emission.js";import{deserializeContext}from"#context/serialize.js";import{readDurableSession}from"#execution/durable-session-store.js";import{getBackgroundTasks}from"#harness/workflow-tool-runs.js";import{getAgentHandleStore}from"#subagents/handles/store.js";import{getDynamicSubagentSelection}from"#context/dynamic-subagent-lifecycle.js";import{activeTurnId}from"#harness/active-turn-id.js";import{prepareActionDispatch}from"#execution/coordination-dispatch-shared.js";import{ROOT_RUNTIME_AGENT_NODE_ID}from"#runtime/graph.js";import{AGENT_TOOL_DESCRIPTION,AGENT_TOOL_NAME}from"#tools/framework/agent-contract.js";import{isAgentHandleAction}from"#subagents/handle-dispatch.js";import{createRecursiveAgentRootOnlyResult,createUnavailableDynamicSubagentResult,getSubagentName}from"#execution/dispatch-action-failures.js";const log=createLogger(`execution.agent-invocation`);async function prepareOwnerAgentInvocation(e){let t=readDurableSession(e.sessionState),n=await deserializeContext(e.serializedContext),r=getHarnessEmissionState(t.state),i=e.taskId===void 0?void 0:getBackgroundTasks(t.state).get(e.taskId)?.run,a=resolveAgentInvocationAction({ctx:n,input:e.invocation,invocationId:e.invocationId});return await prepareActionDispatch({batch:{requests:[a],event:{...r,stepIndex:i?.origin.stepIndex??r.stepIndex,turnId:i?.origin.turnId??activeTurnId(r)}},ctx:n,durableSession:t,fanoutSize:1,plan:({bundle:t,ctx:n,session:r})=>[planAgentDispatch({action:a,bundle:t,ctx:n,knownAgentIds:e.knownAgentIds,session:r})],planReusesOwnerSandbox:({bundle:e,plan:t})=>ownerPlanReusesSandbox({bundle:e,plan:t}),serializedContext:e.serializedContext})}function planAgentDispatch(e){let t=new Set(e.knownAgentIds??(getAgentHandleStore(e.session.state)?.handles??[]).map(e=>e.identity.id)),n=e.action.input.agentId,r=typeof n==`string`&&n.trim()!==``?n:void 0;if(r!==void 0&&isAgentHandleAction(e.action)){if(t.has(r)){let t=e.bundle.subagentRegistry.dynamicNodeIds?.has(e.action.nodeId)===!0?getDynamicSubagentSelection(e.ctx,e.action.nodeId):void 0;return{action:e.action,agentId:r,dynamicRemoteAgent:e.action.kind===`remote-agent-call`&&t?.kind===`remote`?t.remoteAgent:void 0,kind:`resume`}}log.warn(`unknown agentId on subagent call; starting a new agent`,{agentId:r,callId:e.action.callId})}return classifyFreshStart(e)}function classifyFreshStart(e){let{action:t}=e,n=e.bundle.subagentRegistry.subagentsByNodeId,r=e.bundle.subagentRegistry.dynamicNodeIds?.has(t.nodeId)===!0,i=r?getDynamicSubagentSelection(e.ctx,t.nodeId):void 0;if(r&&(i===void 0||t.kind===`subagent-call`&&i.kind!==`subagent`||t.kind===`remote-agent-call`&&i.kind!==`remote`))return log.warn(`dynamic subagent call blocked after availability changed`,{callId:t.callId,nodeId:t.nodeId,subagentName:getSubagentName(t)}),{kind:`reject`,result:createUnavailableDynamicSubagentResult(t)};if(isRecursiveAgentAction(t,n)&&e.session.rootSessionId!==void 0)return log.warn(`recursive agent call blocked outside the root session`,{callId:t.callId,nodeId:t.nodeId,rootSessionId:e.session.rootSessionId,subagentName:t.subagentName}),{kind:`reject`,result:createRecursiveAgentRootOnlyResult(t)};if(t.kind===`remote-agent-call`)return{kind:`start`,target:{action:t,dynamicRemoteAgent:i?.kind===`remote`?i.remoteAgent:void 0,kind:`remote`}};let a=i?.kind===`subagent`?i.agentConfig:void 0,o=n.get(t.nodeId),s=a?.description??(o?.definition.kind===`subagent`?o.definition.description:void 0);return{kind:`start`,target:{action:t,dynamicSubagentAgentConfig:a,kind:`local`,source:s===void 0?{type:`runtime`}:{description:s,type:`local`}}}}function ownerPlanReusesSandbox(e){return e.plan.some(t=>{if(t.kind!==`start`||t.target.kind!==`local`)return!1;let n=t.target.action;return n.subagentName===`agent`&&!e.bundle.subagentRegistry.subagentsByNodeId.has(n.nodeId)||e.bundle.graph?.nodesByNodeId.get(n.nodeId)?.sandboxRegistry.sandbox.definition.kind===`parent`})}function isRecursiveAgentAction(e,t){return e.kind===`subagent-call`&&e.subagentName===`agent`&&!t.has(e.nodeId)}function resolveAgentInvocationAction(e){let t=e.ctx.require(BundleKey),n=t.subagentRegistry.subagentsByName.get(e.input.target),r=n===void 0?Object.values({...e.ctx.get(SessionDynamicSubagentSelectionsKey),...e.ctx.get(TurnDynamicSubagentSelectionsKey)}).find(t=>t!==null&&t.prepared?.name===e.input.target):void 0,i=n?.definition??r?.prepared??(e.input.target===AGENT_TOOL_NAME&&t.nodeId===void 0?{description:AGENT_TOOL_DESCRIPTION,kind:`subagent`,name:AGENT_TOOL_NAME,nodeId:ROOT_RUNTIME_AGENT_NODE_ID}:void 0);if(i===void 0)throw Error(`Agent target "${e.input.target}" is not available to this agent.`);let a={message:e.input.message};e.input.agentId!==void 0&&(a.agentId=e.input.agentId),e.input.outputSchema!==void 0&&(a.outputSchema=e.input.outputSchema);let o={callId:e.invocationId,description:i.description??``,input:a,name:i.name,nodeId:i.nodeId};return i.kind===`remote`?{...o,kind:`remote-agent-call`,remoteAgentName:i.name}:{...o,kind:`subagent-call`,subagentName:i.name}}export{planAgentDispatch,prepareOwnerAgentInvocation,resolveAgentInvocationAction};

package/dist/src/execution/tools/subagent/invoke-step.d.ts

@@ -1,64 +0,0 @@
-import type { AgentInvocationRequest } from "#execution/tools/subagent/invoke-agent.js";
-import type { RuntimeSubagentResult } from "#shared/action-types.js";
-import type { HandleEventFn } from "#harness/types.js";
-import type { ActivityWorkIdentityV1 } from "#protocol/activity.js";
-import { type SubagentCalledStreamEvent, type SubagentCompletedStreamEvent } from "#protocol/message.js";
-import { type DurableSessionState } from "#execution/durable-session-store.js";
-import type { RuntimeSubagentChildResult } from "#shared/action-types.js";
-export type AgentInvocationDispatchResult = {
-    readonly kind: "dispatched";
-    readonly agentId: string;
-    readonly event: SubagentCalledStreamEvent;
-    readonly serializedContext?: Record<string, unknown>;
-    readonly sessionState: DurableSessionState;
-} | {
-    readonly kind: "failed";
-    readonly result: RuntimeSubagentResult;
-    readonly serializedContext?: Record<string, unknown>;
-    readonly sessionState: DurableSessionState;
-};
-export type TaskAgentInvocationDispatchResult = {
-    readonly kind: "not-admitted";
-    readonly sessionState: DurableSessionState;
-} | AgentInvocationDispatchResult;
-/** Dispatches one owner-scoped local or remote agent invocation. */
-export declare function dispatchAgentInvocation(input: {
-    readonly activityWorkIdentity?: ActivityWorkIdentityV1;
-    readonly callbackBaseUrl: string;
-    readonly emit?: HandleEventFn;
-    readonly replyTo: string;
-    readonly request: AgentInvocationRequest;
-    readonly serializedContext: Record<string, unknown>;
-    readonly sessionState: DurableSessionState;
-    readonly ownerId: string;
-    /** Optional creator snapshot used only to prepare this invocation. */
-    readonly invocationContext?: Record<string, unknown>;
-    readonly taskId?: string | undefined;
-}): Promise<AgentInvocationDispatchResult>;
-/**
- * Dispatches one agent request after any task-owned invocation is admitted.
- * The callback origin is parent-owned, so it is derived from this workflow's
- * own metadata rather than accepted from the inbound request.
- */
-export declare function dispatchTaskAgentInvocationStep(input: Omit<Parameters<typeof dispatchAgentInvocation>[0], "callbackBaseUrl" | "emit">): Promise<TaskAgentInvocationDispatchResult>;
-/** Applies an owner-scoped child settlement to the parent session's canonical state. */
-export declare function settleTaskAgentInvocationStep(input: {
-    readonly ownerId: string;
-    readonly result: RuntimeSubagentChildResult;
-    readonly serializedContext: Record<string, unknown>;
-    readonly sessionState: DurableSessionState;
-    readonly taskId?: string | undefined;
-}): Promise<{
-    readonly settled: boolean;
-    readonly completion?: SubagentCompletedStreamEvent;
-    readonly serializedContext: Record<string, unknown>;
-    readonly sessionState: DurableSessionState;
-}>;
-/** Releases any child leases still owned by a completed workflow-tool run. */
-export declare function releaseAgentInvocationOwnerStep(input: {
-    readonly cancelled?: boolean;
-    readonly ownerId: string;
-    readonly sessionState: DurableSessionState;
-}): Promise<{
-    readonly sessionState: DurableSessionState;
-}>;

package/dist/src/execution/tools/subagent/invoke-step.js

@@ -1 +0,0 @@
-import{AuthKey,InitiatorAuthKey,SessionDynamicSubagentSelectionsKey,TurnDynamicSubagentSelectionsKey}from"#context/keys.js";import{createSubagentCalledEvent}from"#protocol/message.js";import{workflowEntryReference}from"#execution/workflow-runtime.js";import{getWorkflowMetadata}from"#compiled/@workflow/core/index.js";import{deriveAgentOperationId}from"#subagents/handles/operation-id.js";import{readDurableSession,replaceDurableSessionSnapshot}from"#execution/durable-session-store.js";import{getBackgroundTasks}from"#harness/workflow-tool-runs.js";import{getAgentHandleStore,writeHandles}from"#subagents/handles/store.js";import{projectToDurableSession}from"#execution/session.js";import{AGENT_BUSY,AGENT_MISMATCH,AGENT_UNREACHABLE,formatAgentBusyMessage}from"#subagents/agent-handle-errors.js";import{clearProxyInputRequestsForChild,clearProxyInputRequestsForTask}from"#harness/proxy-input-requests.js";import{accumulateSessionUsage,getTurnUsageState,setTurnUsageState}from"#harness/turn-tag-state.js";import{resolveWorkflowCallbackBaseUrl}from"#execution/workflow-callback-url.js";import{abandonAgentInvocationOwners,applyTaskAgentHandleCommand}from"#subagents/handles/transitions.js";import{createSubagentReceiptIdentity}from"#execution/tools/subagent/receipt-identity.js";import{createAgentErrorResult,dispatchToClaimedAgentAddress}from"#subagents/handle-dispatch.js";import{createAgentContinuationBundle}from"#subagents/continuation-bundle.js";import{startSubagent}from"#execution/tools/subagent/start.js";import{prepareOwnerAgentInvocation}from"#execution/tools/subagent/invoke-preparation.js";import{prepareAgentInvocationTrace}from"#tracing/agent-invocation-coordinator.js";import{flushAgentInvocationTraces,settleAgentInvocationTrace}from"#tracing/agent-invocation-terminal.js";async function dispatchAgentInvocation(e){let t=readDurableSession(e.sessionState),n=getAgentHandleStore(t.state)?.handles??[],r=await prepareOwnerAgentInvocation({invocation:e.request.input,invocationId:e.request.invocationId,knownAgentIds:n.map(e=>e.identity.id),serializedContext:e.invocationContext??e.serializedContext,sessionState:e.sessionState,taskId:e.taskId}),i=r.plan[0];if(i===void 0)throw Error(`Agent invocation produced no executable plan entry.`);if(i.kind===`reject`)return{kind:`failed`,result:i.result,serializedContext:e.serializedContext,sessionState:e.sessionState};let a=i.kind===`start`?i.target.action:i.action,o=prepareAgentInvocationTrace({conversation:r.inheritedConversation,invocation:a,ownerId:e.ownerId,serializedContext:e.serializedContext,sessionId:r.session.sessionId,sessionState:t.state,startTimeMs:Date.now(),taskId:e.taskId,turnId:r.batch.event.turnId}),s=r.activityObserver===void 0||e.activityWorkIdentity===void 0?void 0:{sink:r.activityObserver.sink,workIdentity:e.activityWorkIdentity},c=r.session,currentAgentHandles=()=>getAgentHandleStore(c.state)?.handles??[],sessionState=()=>replaceDurableSessionSnapshot({session:projectToDurableSession(c),state:e.sessionState}),failed=async e=>({kind:`failed`,result:e,serializedContext:await flushAgentInvocationTraces(o.fail(e)),sessionState:sessionState()}),applyHandleCommand=e=>{let t=applyTaskAgentHandleCommand(c,e);return c=t.session,t.result},l,u;if(i.kind===`resume`){let t=currentAgentHandles().filter(t=>t.phase===`claimed`&&t.ownerId===e.ownerId&&t.callId===i.action.callId&&t.identity.id===i.agentId);if(t.length>1)throw Error(`Invocation owner "${e.ownerId}" has multiple claims for "${i.action.callId}".`);let n=t[0];if(n===void 0){let t=deriveAgentOperationId({callId:i.action.callId,parentSessionId:r.session.sessionId,parentTurnId:r.batch.event.turnId}),a=applyHandleCommand({agentId:i.agentId,callId:i.action.callId,expectedTarget:i.action.kind===`remote-agent-call`?`remote`:`local`,invokedName:i.action.kind===`remote-agent-call`?i.action.remoteAgentName:i.action.subagentName,kind:`claim`,operationId:t,ownerId:e.ownerId});if(n=readClaimedHandle(a),n===void 0)return failed(createTaskClaimError(i.action,i.agentId,a))}let a=createAgentContinuationBundle({action:i.action,bundle:r.bundle,dynamicRemoteAgent:i.dynamicRemoteAgent});l=await dispatchToClaimedAgentAddress({activityObserver:s,action:i.action,auth:r.auth,bundle:a,currentSession:c,handle:n,reply:e.taskId===void 0?{kind:`reply`,parentToken:e.replyTo}:{kind:`reply`,parentToken:e.replyTo,taskId:e.taskId}}),l.kind===`error`&&l.deliveryPermanent===!0&&applyHandleCommand({agentId:i.agentId,kind:`remove`,ownerId:e.ownerId}),u=n.identity.id}else{let t=i.target.action,n=currentAgentHandles().filter(n=>n.phase===`reserved`&&n.ownerId===e.ownerId&&n.callId===t.callId&&n.identity.name===t.name&&n.identity.nodeId===t.nodeId),a=n.length===1?{identity:n[0].identity,operation:{id:n[0].operationId}}:createSubagentReceiptIdentity({callId:t.callId,subagentName:t.kind===`remote-agent-call`?t.remoteAgentName:t.subagentName,nodeId:t.nodeId,parentSessionId:r.session.sessionId,parentTurnId:r.batch.event.turnId});if(n.length>1)throw Error(`Invocation owner "${e.ownerId}" has multiple reservations for "${t.callId}".`);if(n.length===0&&applyHandleCommand({identity:a.identity,callId:t.callId,kind:`reserve`,operationId:a.operation.id,ownerId:e.ownerId}).kind!==`ready`)throw Error(`Agent handle store rejected start operation "${a.operation.id}".`);if(l=await startSubagent({auth:r.auth,batchEvent:r.batch.event,bundle:r.bundle,callbackBaseUrl:e.callbackBaseUrl,capabilities:r.capabilities,channelMetadata:r.channelMetadata,inheritedConversation:r.inheritedConversation,currentSession:c,fanoutSize:r.fanoutSize,initiatorAuth:r.initiatorAuth,localDevRequest:r.localDevRequest,parentContinuationToken:e.replyTo,activityObserver:r.activityObserver,taskActivityObserver:s,sandboxSessionId:r.sandboxSessionId,session:c,taskId:e.taskId,target:i.target,trace:o.dispatch}),u=a.identity.id,l.kind===`error`)applyHandleCommand({agentId:u,kind:`remove`,ownerId:e.ownerId});else if(readClaimedHandle(applyHandleCommand({address:l.address,kind:`confirm`,operationId:a.operation.id,ownerId:e.ownerId}))===void 0)throw Error(`Agent handle store could not confirm start operation "${a.operation.id}".`)}if(l.kind===`error`)return failed(l.result);let d=i.kind===`resume`?i.action:i.target.action,f=i.kind===`resume`?i.dynamicRemoteAgent:i.target.kind===`remote`?i.target.dynamicRemoteAgent:void 0,p=createSubagentCalledEvent({agentId:u,callId:l.callId,childSessionId:l.address.sessionId,name:l.name,remote:l.address.kind===`agent/remote`?{resolverId:f===void 0?d.nodeId:f.credentialsStepId,url:l.address.url}:void 0,sequence:r.batch.event.sequence,sessionId:r.session.sessionId,toolName:l.toolName,turnId:r.batch.event.turnId,workflowId:workflowEntryReference.workflowId});return e.emit!==void 0&&await e.emit(p),{kind:`dispatched`,agentId:u,event:p,serializedContext:o.serializedContext,sessionState:sessionState()}}async function dispatchTaskAgentInvocationStep(e){"use step";let t,n;if(e.taskId!==void 0){let r=readDurableSession(e.sessionState),i=getBackgroundTasks(r.state).get(e.taskId);if(i?.status!==`working`)return{kind:`not-admitted`,sessionState:e.sessionState};n=i.run.task.dispatchContext,i.metadata.kind===`subagent`&&(t=i.run.task.activityWorkIdentity)}return await dispatchAgentInvocation({...e,activityWorkIdentity:t,callbackBaseUrl:resolveWorkflowCallbackBaseUrl(getWorkflowMetadata().url),invocationContext:n===void 0?void 0:applyTaskDispatchContext(e.serializedContext,n)})}function applyTaskDispatchContext(e,t){let n={...e,[AuthKey.name]:t.auth.current,[InitiatorAuthKey.name]:t.auth.initiator};for(let[e,r]of[[SessionDynamicSubagentSelectionsKey.name,t.sessionDynamicSubagentSelections],[TurnDynamicSubagentSelectionsKey.name,t.turnDynamicSubagentSelections]])r===void 0?delete n[e]:n[e]=r;return n}async function settleTaskAgentInvocationStep(e){"use step";let t=readDurableSession(e.sessionState),n=getAgentHandleStore(t.state)?.handles??[],r=n.find(t=>t.phase===`claimed`&&t.ownerId===e.ownerId&&t.callId===e.result.callId);if(r?.phase!==`claimed`)return{settled:!1,serializedContext:e.serializedContext,sessionState:e.sessionState};let i=await flushAgentInvocationTraces(settleAgentInvocationTrace({acceptedAtMs:Date.now(),result:e.result,serializedContext:e.serializedContext,sessionId:t.sessionId})),a=e.result.outcome.kind===`terminal`?n.filter(e=>e!==r):n.map(t=>t===r?e.result.outcome.result.kind===`cancelled`?{address:r.address,identity:r.identity,lastStatus:`(cancelled)`,phase:`parked`}:{address:r.address,identity:r.identity,phase:`available`}:t),o=writeHandles(t,a);e.result.outcome.kind===`terminal`&&(o=e.taskId===void 0?`continuationToken`in r.address?clearProxyInputRequestsForChild(o,r.address.continuationToken):o:clearProxyInputRequestsForTask(o,e.taskId)),o=setTurnUsageState(o,accumulateSessionUsage({previous:getTurnUsageState(o.state),usage:e.result.outcome.usageDelta}));let s=e.taskId===void 0?void 0:getBackgroundTasks(o.state).get(e.taskId),c=s?.metadata.kind===`subagent`&&s.run.callId===e.result.callId;return{settled:!0,completion:e.result.outcome.result.kind!==`succeeded`||c?void 0:{type:`subagent.completed`,data:{callId:e.result.callId,subagentName:e.result.subagentName,output:typeof e.result.output==`string`?e.result.output:JSON.stringify(e.result.output)}},serializedContext:i,sessionState:replaceDurableSessionSnapshot({session:o,state:e.sessionState})}}async function releaseAgentInvocationOwnerStep(e){"use step";let t=readDurableSession(e.sessionState),n=e.cancelled?abandonAgentInvocationOwners(t,new Set([e.ownerId])):applyTaskAgentHandleCommand(t,{kind:`release-owner`,ownerId:e.ownerId}).session;return{sessionState:n===t?e.sessionState:replaceDurableSessionSnapshot({session:n,state:e.sessionState})}}function readClaimedHandle(e){let t=e.kind===`ready`?e.handle:void 0;return t?.phase===`claimed`?t:void 0}function createTaskClaimError(e,t,n){return n.kind===`mismatch`?createAgentErrorResult({action:e,code:AGENT_MISMATCH,message:`Agent "${t}" no longer matches this subagent definition. Start a new agent instead.`}):n.kind===`busy`?createAgentErrorResult({action:e,code:AGENT_BUSY,message:formatAgentBusyMessage({agentId:t,agentName:n.handle.identity.name,ownerId:`ownerId`in n.handle?n.handle.ownerId:void 0})}):createAgentErrorResult({action:e,code:AGENT_UNREACHABLE,message:`Agent with id "${t}" is no longer reachable.`})}export{dispatchAgentInvocation,dispatchTaskAgentInvocationStep,releaseAgentInvocationOwnerStep,settleTaskAgentInvocationStep};

package/dist/src/execution/tools/subagent/receipt-identity.d.ts

@@ -1,11 +0,0 @@
-/** Derives the one deterministic identity shared by subagent receipts and dispatch. */
-export declare function createSubagentReceiptIdentity(input: {
-    readonly callId: string;
-    readonly parentSessionId: string;
-    readonly parentTurnId: string;
-    readonly subagentName: string;
-    readonly nodeId: string;
-}): {
-    readonly identity: import("../../../subagents/handles/store.ts").AgentIdentity;
-    readonly operation: import("../../../subagents/handles/store.ts").StartOperation;
-};

package/dist/src/execution/tools/subagent/receipt-identity.js

@@ -1 +0,0 @@
-import{mintStartOperation}from"#execution/dispatch-start-operation.js";function createSubagentReceiptIdentity(e){return mintStartOperation({callId:e.callId,name:e.subagentName,nodeId:e.nodeId,parentSessionId:e.parentSessionId,parentTurnId:e.parentTurnId})}export{createSubagentReceiptIdentity};

package/dist/src/execution/tools/subagent/start.d.ts

@@ -1,51 +0,0 @@
-import type { ActivityObserverConfig } from "#channel/types.js";
-import type { LocalDevRequestProvenance } from "#context/keys.js";
-import type { ActivityWorkIdentityV1 } from "#protocol/activity.js";
-import type { DynamicSubagentAgentConfig } from "#runtime/subagents/dynamic-agent-config.js";
-import type { DynamicRemoteAgentConfig } from "#runtime/subagents/dynamic-remote-agent-config.js";
-import type { CompiledBundle } from "#runtime/sessions/runtime-context-keys.js";
-import type { RuntimeRemoteAgentDispatchRequest, RuntimeSubagentDispatchRequest } from "#shared/action-types.js";
-import type { DispatchOutcome, RuntimeSession } from "#subagents/handle-dispatch.js";
-import { buildSubagentRunInput, type SubagentInputSource } from "#subagents/tool.js";
-import type { AgentChildTraceDispatch } from "#tracing/agent-invocation-coordinator.js";
-export type SubagentStartTarget = {
-    readonly kind: "local";
-    readonly action: RuntimeSubagentDispatchRequest;
-    readonly dynamicSubagentAgentConfig?: DynamicSubagentAgentConfig;
-    readonly source: SubagentInputSource;
-} | {
-    readonly kind: "remote";
-    readonly action: RuntimeRemoteAgentDispatchRequest;
-    readonly dynamicRemoteAgent?: DynamicRemoteAgentConfig;
-};
-/** Starts one planned fresh child against its local or remote target. */
-export declare function startSubagent(input: {
-    readonly auth: Parameters<typeof buildSubagentRunInput>[0]["auth"];
-    readonly batchEvent: {
-        readonly sequence: number;
-        readonly turnId: string;
-    };
-    readonly bundle: CompiledBundle;
-    readonly callbackBaseUrl: string | undefined;
-    readonly capabilities: Parameters<typeof buildSubagentRunInput>[0]["capabilities"];
-    readonly channelMetadata: Parameters<typeof buildSubagentRunInput>[0]["channelMetadata"];
-    readonly inheritedConversation?: Parameters<typeof buildSubagentRunInput>[0]["inheritedConversation"];
-    readonly currentSession: RuntimeSession;
-    readonly fanoutSize: number;
-    readonly initiatorAuth: Parameters<typeof buildSubagentRunInput>[0]["initiatorAuth"];
-    /** Inherited originating-client metadata for the dev-TUI hint. */
-    readonly localDevRequest?: LocalDevRequestProvenance;
-    readonly parentContinuationToken: string | undefined;
-    readonly activityObserver?: ActivityObserverConfig & {
-        readonly workIdentity: ActivityWorkIdentityV1;
-    };
-    /** The backing agent reports as this task, rather than as a separate child work item. */
-    readonly taskActivityObserver?: ActivityObserverConfig & {
-        readonly workIdentity: ActivityWorkIdentityV1;
-    };
-    readonly sandboxSessionId: string;
-    readonly session: RuntimeSession;
-    readonly taskId?: string;
-    readonly target: SubagentStartTarget;
-    readonly trace: AgentChildTraceDispatch;
-}): Promise<DispatchOutcome>;

package/dist/src/execution/tools/subagent/start.js

@@ -1 +0,0 @@
-import"#subagents/tool.js";import{resolveConversationId}from"#shared/conversation-identity.js";import{startLocalSubagent}from"#subagents/start-local.js";import{startRemoteSubagent}from"#subagents/start-remote.js";async function startSubagent(e){let{trace:t}=e,n={conversationId:t.conversationId??resolveConversationId(e.session.rootSessionId??e.session.sessionId),lineage:{callId:e.target.action.callId,rootSessionId:e.session.rootSessionId??e.session.sessionId,sessionId:e.session.sessionId,turn:{id:e.batchEvent.turnId,sequence:e.batchEvent.sequence}},continuationToken:e.parentContinuationToken,traceContext:t.parentTraceContext,originAudience:t.originAudience};switch(e.target.kind){case`local`:return startLocalSubagent({action:e.target.action,auth:e.auth,bundle:e.bundle,capabilities:e.capabilities,channelMetadata:e.channelMetadata,inheritedConversation:e.inheritedConversation,currentSession:e.currentSession,dynamicSubagentAgentConfig:e.target.dynamicSubagentAgentConfig,fanoutSize:e.fanoutSize,initiatorAuth:e.initiatorAuth,localDevRequest:e.localDevRequest,parent:n,activityObserver:e.taskActivityObserver??e.activityObserver,sandboxSessionId:e.sandboxSessionId,session:e.session,source:e.target.source,taskId:e.taskId});case`remote`:return startRemoteSubagent({action:e.target.action,auth:e.auth,bundle:e.bundle,callbackBaseUrl:e.callbackBaseUrl,currentSession:e.currentSession,dynamicRemoteAgent:e.target.dynamicRemoteAgent,initiatorAuth:e.initiatorAuth,parent:n,activityObserver:e.activityObserver,taskActivityObserver:e.taskActivityObserver,session:e.session,taskId:e.taskId});default:return e.target}}export{startSubagent};

package/dist/src/execution/tools/subagent/steer.d.ts

@@ -1,13 +0,0 @@
-import type { ContextReader } from "#context/key.js";
-import type { HarnessSession } from "#harness/types.js";
-import type { JsonObject } from "#shared/json.js";
-import type { TaskOwnedAgentHandle } from "#subagents/handles/store.js";
-export declare function steerBackgroundAgent(input: {
-    readonly ctx: ContextReader;
-    readonly handle: Extract<TaskOwnedAgentHandle, {
-        phase: "claimed";
-    }>;
-    readonly callId: string;
-    readonly input: JsonObject;
-    readonly session: HarnessSession;
-}): Promise<void>;

package/dist/src/execution/tools/subagent/steer.js

@@ -1 +0,0 @@
-import{resolveAgentInvocationAction}from"./invoke-preparation.js";import{AuthKey}from"#context/keys.js";import{BundleKey}from"#runtime/sessions/runtime-context-keys.js";import{getDynamicSubagentSelection}from"#context/dynamic-subagent-lifecycle.js";import{dispatchToClaimedAgentAddress}from"#subagents/handle-dispatch.js";import{createAgentContinuationBundle}from"#subagents/continuation-bundle.js";import{normalizeRequestedOutputSchema}from"#subagents/invocation.js";async function steerBackgroundAgent(e){let t=resolveAgentInvocationAction({ctx:e.ctx,invocationId:e.callId,input:{agentId:e.handle.identity.id,message:typeof e.input.message==`string`?e.input.message:``,outputSchema:normalizeRequestedOutputSchema(e.input.outputSchema),target:e.handle.identity.name}}),n=getDynamicSubagentSelection(e.ctx,e.handle.identity.nodeId),r=await dispatchToClaimedAgentAddress({action:t,auth:e.ctx.get(AuthKey)??null,bundle:createAgentContinuationBundle({action:t,bundle:e.ctx.require(BundleKey),dynamicRemoteAgent:n?.kind===`remote`?n.remoteAgent:void 0}),currentSession:e.session,handle:e.handle,reply:{kind:`steer`}});if(r.kind===`error`)throw Error(JSON.stringify(r.result.output))}export{steerBackgroundAgent};

package/dist/src/execution/tools/subagent/task-agent-requests.d.ts

@@ -1,24 +0,0 @@
-import type { DurableSessionState } from "#execution/durable-session-store.js";
-import type { TaskAgentRequestDelivery } from "#tasks/types.js";
-interface AgentRequestDelivery {
-    readonly ownerId: string;
-    readonly replyTo: TaskAgentRequestDelivery["replyTo"];
-    readonly request: TaskAgentRequestDelivery["request"];
-    readonly taskId?: string;
-}
-interface TaskAgentRequestContext {
-    readonly sessionWritable: WritableStream<Uint8Array>;
-    readonly serializedContext: Record<string, unknown>;
-    readonly sessionState: DurableSessionState;
-}
-interface AppliedTaskAgentRequest {
-    readonly serializedContext: Record<string, unknown>;
-    readonly sessionState: DurableSessionState;
-}
-/**
- * Applies one workflow-owned agent request to the parent session: `agent-invoke`
- * spawns the child with parent-owned material and `agent-settled` releases the
- * handle. Child authorization and HITL ride their own task envelope arms.
- */
-export declare function applyTaskAgentRequest(delivery: AgentRequestDelivery, ctx: TaskAgentRequestContext): Promise<AppliedTaskAgentRequest>;
-export {};

package/dist/src/execution/tools/subagent/task-agent-requests.js

@@ -1 +0,0 @@
-import{emitSubagentEventStep}from"#execution/tools/subagent/emit-event-step.js";import{dispatchTaskAgentInvocationStep,settleTaskAgentInvocationStep}from"#execution/tools/subagent/invoke-step.js";import{resumeHookStep}from"#execution/tools/workflow/resume-hook-step.js";async function applyTaskAgentRequest(e,t){let{request:n}=e;switch(n.kind){case`agent-settled`:{let r=await settleTaskAgentInvocationStep({ownerId:e.ownerId,result:n.result,serializedContext:t.serializedContext,sessionState:t.sessionState,taskId:e.taskId}),i=r.serializedContext,a=r.sessionState;if(r.completion!==void 0){let e=await emitSubagentEventStep({event:r.completion,sessionWritable:t.sessionWritable,serializedContext:i,sessionState:r.sessionState});i=e.serializedContext,a=e.sessionState}return await resumeHookStep(e.replyTo,{kind:`agent-settled`,callId:n.result.callId},{ifPresent:!0}),{serializedContext:i,sessionState:a}}case`agent-invoke`:{let r=await dispatchTaskAgentInvocationStep({ownerId:e.ownerId,replyTo:e.replyTo,request:n,serializedContext:t.serializedContext,sessionState:t.sessionState,taskId:e.taskId});switch(r.kind){case`dispatched`:return await emitSubagentEventStep({event:r.event,sessionWritable:t.sessionWritable,serializedContext:r.serializedContext??t.serializedContext,sessionState:r.sessionState});case`failed`:return await resumeHookStep(e.replyTo,{kind:`runtime-action-result`,results:[r.result]}),{serializedContext:r.serializedContext??t.serializedContext,sessionState:r.sessionState};case`not-admitted`:return{serializedContext:t.serializedContext,sessionState:r.sessionState}}}}}export{applyTaskAgentRequest};

package/dist/src/execution/tools/subagent/task-cancel.d.ts

@@ -1,10 +0,0 @@
-import type { TaskExecutorCancel } from "#execution/tasks/parent/task-cancel.js";
-import { type DurableSessionState } from "#execution/durable-session-store.js";
-/** Cancels child turns and their nested tasks still owned by a background task. */
-export declare const cancelBackgroundAgentTask: TaskExecutorCancel;
-/** Cancels a child turn still claimed by a completed workflow-tool run. */
-export declare function cancelAgentInvocationOwnerStep(input: {
-    readonly ownerId: string;
-    readonly serializedContext: Record<string, unknown>;
-    readonly sessionState: DurableSessionState;
-}): Promise<void>;

package/dist/src/execution/tools/subagent/task-cancel.js

@@ -1 +0,0 @@
-import{createLogger,logError}from"#internal/logging.js";import{BundleKey}from"#runtime/sessions/runtime-context-keys.js";import{requestWorkflowTurnCancellation}from"#execution/workflow-runtime.js";import{deserializeContext}from"#context/serialize.js";import{readDurableSession}from"#execution/durable-session-store.js";import{cancelRemoteAgentTurn,resolveRemoteAgentForAction}from"#subagents/remote-dispatch.js";import{getAgentHandleStore}from"#subagents/handles/store.js";import{getDynamicSubagentSelection}from"#context/dynamic-subagent-lifecycle.js";const log=createLogger(`execution.agent-invocation-cancel`),cancelBackgroundAgentTask=async e=>{e.session!==void 0&&e.serializedContext!==void 0&&await cancelAgentInvocationOwner({ownerId:e.entry.task.taskId,serializedContext:e.serializedContext,session:e.session})};async function cancelAgentInvocationOwnerStep(e){"use step";try{await cancelAgentInvocationOwner({ownerId:e.ownerId,serializedContext:e.serializedContext,session:readDurableSession(e.sessionState)})}catch(t){logError(log,`failed to cancel workflow-owned agent turn`,t,{ownerId:e.ownerId})}}async function cancelAgentInvocationOwner(e){let t=(getAgentHandleStore(e.session.state)?.handles??[]).filter(t=>t.phase===`claimed`&&t.ownerId===e.ownerId);if(t.length===0)return;let n,r=(await Promise.allSettled(t.map(async t=>{if(t.address.kind!==`agent/remote`){await requestWorkflowTurnCancellation({sessionId:t.address.sessionId,tasks:!0});return}n??=deserializeContext(e.serializedContext);let r=await n,i=r.require(BundleKey),a=getDynamicSubagentSelection(r,t.identity.nodeId),o=resolveRemoteAgentForAction({dynamicRemoteAgent:a?.kind===`remote`?a.remoteAgent:void 0,nodeId:t.identity.nodeId,registry:i.subagentRegistry.subagentsByNodeId,remoteAgentName:t.identity.name});await cancelRemoteAgentTurn({remote:{...o,url:t.address.url},sessionId:t.address.sessionId,tasks:!0})}))).filter(e=>e.status===`rejected`);if(r.length>0)throw AggregateError(r.map(e=>e.reason),`Failed to cancel owned agent turns.`)}export{cancelAgentInvocationOwnerStep,cancelBackgroundAgentTask};

package/dist/src/execution/tools/tasks.d.ts

@@ -1,3 +0,0 @@
-import type { HarnessToolDefinition } from "#harness/execute-tool.js";
-/** Builds the harness definition for the compiled framework task control. */
-export declare function createTaskToolHarnessDefinitions(): readonly HarnessToolDefinition[];

package/dist/src/execution/tools/tasks.js

@@ -1 +0,0 @@
-import{TASK_CANCEL_INPUT_SCHEMA,TASK_CANCEL_TOOL_NAME,TASK_VIEWS_OUTPUT_SCHEMA}from"#tools/framework/task-contract.js";function createTaskToolHarnessDefinitions(){return[{description:`Request cooperative cancellation of one or more background tasks. Cancellation is final: a task that finishes after you cancel it stays cancelled. Cancelling an already-finished task changes nothing.`,inputSchema:TASK_CANCEL_INPUT_SCHEMA,name:TASK_CANCEL_TOOL_NAME,outputSchema:TASK_VIEWS_OUTPUT_SCHEMA,runtimeAction:{kind:`task-control`}}]}export{createTaskToolHarnessDefinitions};

package/dist/src/execution/tools/workflow/background.js

@@ -1 +0,0 @@
-import{parseJsonObject}from"#shared/json.js";import{UNSPECIFIED_INPUT_SCHEMA,toInputSchema,toOutputSchema}from"#tools/schema.js";function createWorkflowToolHarnessDefinition(e){let t=e.definition,n={executeInput:e.executeInput,nodeId:e.nodeId,workflowId:e.workflowId};return t.execution===`background`?{...t,...n,execute:createWorkflowToolBackgroundExecute({toolName:t.name,workflowId:e.workflowId})}:{...t,...n,execute:void 0}}function createPreparedWorkflowToolHarnessDefinition(e){if(e.task===void 0)throw Error(`Prepared tool "${e.name}" is not backed by a workflow task.`);return createWorkflowToolHarnessDefinition({definition:{behavior:e.behavior,description:e.description,execution:e.execution,inputSchema:toInputSchema(e.inputSchema)??UNSPECIFIED_INPUT_SCHEMA,name:e.name,outputSchema:toOutputSchema(e.outputSchema),rootOnly:e.rootOnly},nodeId:e.task.nodeId,workflowId:e.task.workflowId})}function createWorkflowToolBackgroundExecute(e){return(t,n)=>{throw Error(`Background workflow tool "${e.toolName}" must be started by the task runtime (${e.workflowId}).`)}}function parseWorkflowToolInput(e,t){try{return parseJsonObject(e)}catch(e){throw TypeError(`Tool "${t}" is a workflow, so its parsed input must be a JSON object.`,{cause:e})}}export{createPreparedWorkflowToolHarnessDefinition,createWorkflowToolHarnessDefinition,parseWorkflowToolInput};

package/dist/src/execution/tools/workflow/workflow-owner-background.d.ts

@@ -1,14 +0,0 @@
-import type { BackgroundWorkflowToolRunInput } from "#execution/tools/workflow/types.js";
-import type { WorkflowToolRunMessage } from "#execution/tools/workflow/messages.js";
-import { type ChannelReader } from "#execution/tools/workflow/owner-channels.js";
-import { type TaskRunInboundPayload } from "#tasks/types.js";
-interface BackgroundWorkflowOwner {
-    readonly kind: "session";
-    readonly commands: ChannelReader<"commands", TaskRunInboundPayload>;
-    readonly signal: AbortSignal;
-    handleCommand(payload: TaskRunInboundPayload): Promise<"start" | "stop" | undefined>;
-    handleMessage(message: WorkflowToolRunMessage): Promise<void>;
-}
-/** Routes child messages; the parent session owns persisted task state. */
-export declare function createBackgroundWorkflowOwner(input: BackgroundWorkflowToolRunInput): Promise<BackgroundWorkflowOwner | undefined>;
-export {};

package/dist/src/execution/tools/workflow/workflow-owner-background.js

@@ -1 +0,0 @@
-import{createHook}from"#compiled/@workflow/core/index.js";import{claimHookOwnership,isHookConflictError}from"#execution/hook-ownership.js";import{deliverWorkflowAuthorization}from"#execution/tools/workflow/owner.js";import{workflowToolRunInputRequests}from"#execution/tools/workflow/owner-inbox.js";import{isTerminalTaskStatus,readTaskInputRequestId}from"#tasks/types.js";import{deliverTaskInputResponsesStep,emitTaskActivityStep,notifyTaskParent}from"#execution/tasks/child/notify.js";import{createChannelReader}from"#execution/tools/workflow/owner-channels.js";import{applyTaskTransition}from"#tasks/transitions.js";async function createBackgroundWorkflowOwner(e){let t=createHook({token:e.taskInboxToken}),n=e.initialView,r=0,i=new Map,a=new AbortController;try{await claimHookOwnership(t)}catch(e){if(isHookConflictError(e))return;throw e}return await emitTaskActivityStep({activityObserver:e.activityObserver,view:n}),{kind:`session`,commands:createChannelReader(`commands`,t),signal:a.signal,handleCommand,handleMessage};async function handleCommand(t){if(t.kind===`task-command`){if(t.command.kind===`ready`)return isTerminalTaskStatus(n.status)?(await notifyTaskParent({token:e.parentContinuationToken,view:n}),`stop`):`start`;if(t.command.kind===`reject-dispatch`)return applyTransition(t.command),`stop`}await applyPayload(t)}async function handleMessage(t){if(t.kind===`report`){await handleReport(t);return}if(t.kind===`outcome`){(applyTransition(t)||n.status===`cancelled`)&&await notifyTaskParent({token:e.parentContinuationToken,view:n});return}let r=t,a=r.request.kind;if(a===`agent-invoke`||a===`agent-settled`||a===`authorization-request`){await handleOwnerRequest(r);return}r.requestCoordinates===void 0&&i.set(r.replyTo,{runId:r.from.runId}),applyTransition({kind:`require-input`,inputRequests:workflowToolRunInputRequests(r)})&&await notifyTaskParent({request:r,taskId:n.taskId,token:e.parentContinuationToken})}async function handleReport(t){let i=r++;n.metadata.kind!==`subagent`||isTerminalTaskStatus(n.status)||await notifyTaskParent({token:e.parentContinuationToken,update:{report:t,index:i},view:n})}async function applyPayload(e){let t;if(e.kind===`input-response`)t=n.status===`input_required`?await resolveAnsweredCommand(n,e,i.get(e.childContinuationToken)):void 0;else if(e.kind===`task-command`)t=e.command;else return;t!==void 0&&applyTransition(t)&&t.kind===`cancel`&&a.abort(Error(`Task ${n.taskId} was cancelled.`))}function applyTransition(e){let t=applyTaskTransition(n,e);return t.action===`accepted`&&(n=t.view,!0)}async function handleOwnerRequest(t){let{request:r}=t;if(r.kind===`authorization-request`){await deliverWorkflowAuthorization({...t,request:r},async()=>{let i=r.event.childSessionId===t.from.runId&&r.event.event.type===`authorization.completed`;(!isTerminalTaskStatus(n.status)||i)&&await notifyTaskParent({request:t,taskId:n.taskId,token:e.parentContinuationToken})});return}isTerminalTaskStatus(n.status)||await notifyTaskParent({request:t,taskId:n.taskId,token:e.parentContinuationToken})}}async function resolveAnsweredCommand(e,t,n){if(t.taskId!==e.taskId)return;let r=new Set(e.inputRequests.flatMap(e=>{let t=readTaskInputRequestId(e);return t===void 0?[]:[t]})),i=t.inputResponses.map(e=>e.requestId).filter(e=>r.has(e));if(i.length!==0)return await deliverTaskInputResponsesStep({answer:t,answerHook:n,requestIds:i})===`delivered`?{kind:`answered`,requestIds:i}:void 0}export{createBackgroundWorkflowOwner};

package/dist/src/harness/background-tools.d.ts

@@ -1,45 +0,0 @@
-import { ContextKey } from "#context/key.js";
-import type { InternalToolLabelDefinition, ToolExecuteOptions } from "#tools/definition.js";
-import type { AgentView } from "#subagents/handles/prompt.js";
-import type { JsonValue } from "#shared/json.js";
-export interface BackgroundExecutableTool {
-    readonly label?: InternalToolLabelDefinition;
-    readonly executeInput?: (input: unknown) => JsonValue;
-    readonly name: string;
-    /** Selected agent definition's runtime graph ID; absent for authored workflow tools. */
-    readonly nodeId?: string;
-    /** Registered durable workflow body run by the session-owned task. */
-    readonly workflowId: string;
-}
-export interface BackgroundToolCall {
-    readonly callId: string;
-    readonly definition: BackgroundExecutableTool;
-    readonly input: unknown;
-}
-export interface BackgroundToolCallBatch {
-    readonly calls: readonly BackgroundToolCall[];
-    register(call: {
-        readonly callId: string;
-        readonly input: unknown;
-        readonly toolName: string;
-    }): void;
-    setTool(name: string, definition?: BackgroundExecutableTool): void;
-}
-export interface BackgroundToolExecutor {
-    hasPendingTasks?(): boolean;
-    readAgentViews?(): Promise<readonly AgentView[]>;
-    execute(input: {
-        readonly batch: BackgroundToolCallBatch;
-        readonly definition: BackgroundExecutableTool;
-        readonly options: ToolExecuteOptions;
-        readonly toolInput: unknown;
-    }): Promise<unknown>;
-}
-export declare const BackgroundToolExecutorKey: ContextKey<BackgroundToolExecutor>;
-export declare function createBackgroundToolCallBatch(): BackgroundToolCallBatch;
-export declare function executeBackgroundToolCall(input: {
-    readonly batch: BackgroundToolCallBatch;
-    readonly definition: BackgroundExecutableTool;
-    readonly options: ToolExecuteOptions;
-    readonly toolInput: unknown;
-}): Promise<unknown>;

package/dist/src/harness/background-tools.js

@@ -1 +0,0 @@
-import{loadContext}from"#context/container.js";import{ContextKey}from"#context/key.js";const BackgroundToolExecutorKey=new ContextKey(`eve.internal.backgroundToolExecution`);function createBackgroundToolCallBatch(){let e=[],t=new Map,n=new Map;return{calls:e,register(r){let i=n.get(r.toolName);if(i===void 0)return;let a=t.get(r.callId);if(a?.definition===i)return;if(a!==void 0)throw Error(`Background tool call "${r.callId}" was registered more than once.`);let o={callId:r.callId,definition:i,input:r.input};t.set(r.callId,o),e.push(o)},setTool(e,t){t===void 0?n.delete(e):n.set(e,t)}}}async function executeBackgroundToolCall(e){return await loadContext().require(BackgroundToolExecutorKey).execute(e)}export{BackgroundToolExecutorKey,createBackgroundToolCallBatch,executeBackgroundToolCall};

package/dist/src/instrumentation/background-task-runtime.d.ts

@@ -1,18 +0,0 @@
-import { type ContextContainer } from "#context/container.js";
-import type { InstrumentationHooks } from "#instrumentation/lifecycle.js";
-import type { TaskView } from "#tasks/types.js";
-export interface BackgroundTaskInstrumentation {
-    readonly publishBackgroundTaskSettlements: (input: {
-        readonly acceptedAtMs?: number;
-        readonly views: readonly TaskView[];
-    }) => Promise<void>;
-    readonly rememberBackgroundTasks: (tasks: readonly {
-        readonly callId?: string;
-        readonly taskId: string;
-    }[]) => void;
-}
-export declare function createBackgroundTaskInstrumentation(input: {
-    readonly ctx: ContextContainer;
-    readonly hooks: () => InstrumentationHooks;
-    readonly sessionId: string;
-}): BackgroundTaskInstrumentation;

package/dist/src/instrumentation/background-task-runtime.js

@@ -1 +0,0 @@
-import{contextStorage}from"#context/container.js";import{rememberInstrumentationBackgroundTaskForCall}from"#instrumentation/state.js";import{publishBackgroundTaskSettlements}from"#instrumentation/native-events.js";function createBackgroundTaskInstrumentation(e){return{publishBackgroundTaskSettlements:t=>publishBackgroundTaskSettlements({...t,hooks:e.hooks()}),rememberBackgroundTasks:t=>{contextStorage.run(e.ctx,()=>{for(let n of t)n.callId!==void 0&&rememberInstrumentationBackgroundTaskForCall(e.sessionId,n.callId,n.taskId)})}}}export{createBackgroundTaskInstrumentation};