eve 0.68.0 → 0.70.0

package/dist/src/subagents/handles/prompt.js

@@ -1,3 +0,0 @@
-const AGENTS_SNIPPET_LABEL=`[Agents]`;function projectParkedAgentHandles(e){return e.handles.filter(e=>e.phase===`available`||e.phase===`parked`)}function renderAgentsSnippet(e){let t=projectParkedAgentHandles(e).map(e=>{let t=e.phase===`parked`?e.lastStatus:`(available)`;return`<agent id="${escapeXml(e.identity.id)}" name="${escapeXml(e.identity.name)}">${escapeXml(t===``?`(no status)`:t)}</agent>`});return[AGENTS_SNIPPET_LABEL,`<agents>`,...t,`</agents>`].join(`
-`)}function renderAgentViewsSnippet(e){let t=e.map(e=>{let t=e.taskId===void 0||e.taskStatus===void 0?``:` taskId="${escapeXml(e.taskId)}" taskStatus="${e.taskStatus}"`,n=e.statusLine??(e.availability===`busy`?`(busy)`:`(available)`);return`<agent id="${escapeXml(e.id)}" name="${escapeXml(e.name)}" availability="${e.availability}"${t}>${escapeXml(n)}</agent>`});return[AGENTS_SNIPPET_LABEL,`<agents>`,...t,`</agents>`].join(`
-`)}function resolveAgentsAnnouncement(e){let t=e.messages.findLast(e=>e.role===`user`&&typeof e.content==`string`&&e.content.startsWith(`[Agents]`)),n=e.store??{handles:[]},r=e.agentViews?.length??projectParkedAgentHandles(n).length;if(t===void 0&&r===0)return;let i=e.agentViews===void 0?renderAgentsSnippet(n):renderAgentViewsSnippet(e.agentViews);return t?.content===i?void 0:i}function escapeXml(e){return e.replaceAll(`&`,`&amp;`).replaceAll(`"`,`&quot;`).replaceAll(`<`,`&lt;`).replaceAll(`>`,`&gt;`)}export{AGENTS_SNIPPET_LABEL,projectParkedAgentHandles,renderAgentViewsSnippet,renderAgentsSnippet,resolveAgentsAnnouncement};

package/dist/src/subagents/handles/query.d.ts

@@ -1,41 +0,0 @@
-import type { RuntimeActionResult, RuntimeSubagentChildResult } from "#shared/action-types.js";
-import type { TurnOwnedAgentHandle } from "#subagents/handles/store.js";
-import type { SessionStateMap } from "#harness/types.js";
-/** A handle with one outstanding operation and a confirmed child address. */
-export type RunningAgentHandle = Extract<TurnOwnedAgentHandle, {
-    phase: "running";
-}>;
-/**
- * Finds the running agent handle a child-produced result must settle: the
- * handle whose recorded operation carries the result's callId.
- *
- * Binding is by callId alone. Possession of the parent's callback token is
- * the authorization to settle; the handle's recorded address is used for
- * outbound delivery (continuation, cancellation), never as an inbound
- * identity check. Under the accepted at-least-once dispatch window a
- * replay-orphaned duplicate child holds the same token and callId and may
- * settle the call in place of the owned child — an accepted trade-off,
- * since both children computed the same input.
- */
-export declare function findRunningAgentHandle(state: SessionStateMap | undefined, input: {
-    readonly callId: string;
-}): RunningAgentHandle | undefined;
-/**
- * A subagent result may settle a call only when a running handle records
- * its callId: a late or duplicate result for an already-settled call finds
- * no running handle and is dropped.
- *
- * `dispatch`-origin failures pass unconditionally: the parent synthesizes
- * them for calls whose child never started, and they reach the harness only
- * through the trusted step-result path. Untrusted channels must use
- * {@link isInboxSubagentResultFromRunningHandle} instead.
- */
-export declare function isResultBoundToRunningHandle(state: SessionStateMap | undefined, result: RuntimeActionResult): boolean;
-/**
- * Strict variant of {@link isResultBoundToRunningHandle} for results arriving
- * over the shared turn inbox (child notifications and remote callbacks).
- * An inbox result must bind to a running handle by callId; one with no
- * matching running handle — including one for a callId whose dispatch
- * already failed — must not overwrite the dispatch-produced error result.
- */
-export declare function isInboxSubagentResultFromRunningHandle(state: SessionStateMap | undefined, result: RuntimeSubagentChildResult): boolean;

package/dist/src/subagents/handles/query.js

@@ -1 +0,0 @@
-import{AGENT_HANDLES_STATE_KEY}from"#subagents/handles/state-key.js";function readAgentHandles(e){let t=e?.[AGENT_HANDLES_STATE_KEY];if(t===void 0)return[];let n=t.handles;return Array.isArray(n)?n:[]}function findRunningAgentHandle(e,t){return readAgentHandles(e).find(e=>e.phase===`running`&&e.operation.callId===t.callId)}function isResultBoundToRunningHandle(e,t){return t.kind!==`subagent-result`||t.origin===`dispatch`||t.backgroundTask!==void 0||findRunningAgentHandle(e,{callId:t.callId})!==void 0}function isInboxSubagentResultFromRunningHandle(e,t){return findRunningAgentHandle(e,{callId:t.callId})!==void 0}export{findRunningAgentHandle,isInboxSubagentResultFromRunningHandle,isResultBoundToRunningHandle};

package/dist/src/subagents/handles/state-key.d.ts

@@ -1,8 +0,0 @@
-/**
- * Session-state key for delegated agent handles.
- *
- * Lives apart from the store so schema-free readers (the session owner's
- * handle query) can import the key without pulling the zod-backed store
- * module into their bundle.
- */
-export declare const AGENT_HANDLES_STATE_KEY = "eve.agent.handles";

package/dist/src/subagents/handles/state-key.js

@@ -1 +0,0 @@
-const AGENT_HANDLES_STATE_KEY=`eve.agent.handles`;export{AGENT_HANDLES_STATE_KEY};

package/dist/src/subagents/handles/store.d.ts

@@ -1,217 +0,0 @@
-import type { SessionStateMap } from "#harness/types.js";
-import { AGENT_HANDLES_STATE_KEY } from "./state-key.js";
-export { AGENT_HANDLES_STATE_KEY };
-/**
- * Stable identity of one delegated child, minted before its start side
- * effect runs. The model-visible `id` derives from the first start
- * operation, never from the child session id, so it exists before the
- * child does and cannot collide on externally supplied session suffixes.
- */
-export interface AgentIdentity {
-    /** Model-visible identifier: `ag_<name>:<operation-hash>`. */
-    readonly id: string;
-    /** Subagent tool name. */
-    readonly name: string;
-    /** Agent-graph node used to re-resolve delivery configuration. */
-    readonly nodeId: string;
-}
-/**
- * One dispatch the parent intends to perform or has performed. Repeating
- * the same operation is a replay; a different operation against a
- * starting/running handle is a busy conflict.
- */
-export interface StartOperation {
-    readonly kind: "start";
-    /** Derived via {@link deriveAgentOperationId}; stable across replays. */
-    readonly id: string;
-    readonly callId: string;
-    readonly parentTurnId: string;
-}
-/** A continuation delivery against a parked handle. */
-export interface ContinueOperation {
-    readonly kind: "continue";
-    /** Derived via {@link deriveAgentOperationId}; stable across replays. */
-    readonly id: string;
-    readonly callId: string;
-    readonly parentTurnId: string;
-    /**
-     * Status the handle showed before this delivery, restored when the
-     * delivery is rejected as retryable so the handle returns to `parked`
-     * without optional state.
-     */
-    readonly previousStatus: string;
-}
-/** Where a fresh child will be started. No session exists yet. */
-export type AgentStartTarget = {
-    readonly kind: "agent/local";
-    /** Deterministic child continuation token chosen at dispatch. */
-    readonly continuationToken: string;
-} | {
-    readonly kind: "agent/self";
-    readonly continuationToken: string;
-} | {
-    readonly kind: "agent/remote";
-    /** Deliver target base URL; never model-visible. */
-    readonly url: string;
-    /** Callback base URL stub captured at dispatch; never model-visible. */
-    readonly callbackBaseUrl: string;
-    /** Auth/header resolver selected when this child was created; `{}` means none. */
-    readonly credentialResolver?: {
-        readonly resolverId?: string;
-    };
-};
-/** Confirmed delivery coordinates of a started child. */
-export type AgentAddress = {
-    readonly kind: "agent/local";
-    readonly sessionId: string;
-    readonly continuationToken: string;
-} | {
-    readonly kind: "agent/self";
-    readonly sessionId: string;
-    readonly continuationToken: string;
-} | {
-    readonly kind: "agent/remote";
-    readonly sessionId: string;
-    readonly url: string;
-    readonly callbackBaseUrl: string;
-    /** Auth/header resolver selected when this child was created; `{}` means none. */
-    readonly credentialResolver?: {
-        readonly resolverId?: string;
-    };
-};
-/**
- * Parent-turn-owned lifecycle: `starting → running → parked ↔ running`.
- *
- * `starting` owns a start intent before the child has an address, `running`
- * owns one outstanding child turn, and `parked` retains an idle, resumable
- * child. A terminal child or dead dispatch leaves this union entirely.
- */
-export type TurnOwnedAgentHandle = {
-    readonly phase: "starting";
-    readonly identity: AgentIdentity;
-    readonly operation: StartOperation;
-    readonly target: AgentStartTarget;
-} | {
-    readonly phase: "running";
-    readonly identity: AgentIdentity;
-    readonly operation: StartOperation | ContinueOperation;
-    readonly address: AgentAddress;
-} | {
-    readonly phase: "parked";
-    readonly identity: AgentIdentity;
-    readonly address: AgentAddress;
-    readonly lastStatus: string;
-};
-/**
- * Workflow-owner lifecycle: `reserved → claimed → available ↔ claimed`.
- *
- * `reserved` leases a fresh identity before start, `claimed` leases an
- * addressed child turn to one task or workflow-tool run, and `available`
- * retains the idle address between invocations. A terminal child leaves this
- * union entirely.
- */
-export type TaskOwnedAgentHandle = {
-    /** Fresh identity leased to one owner before the child's address is confirmed. */
-    readonly phase: "reserved";
-    readonly identity: AgentIdentity;
-    readonly operationId: string;
-    readonly callId?: string;
-    readonly ownerId: string;
-} | {
-    /** Addressed child turn leased until its owner releases it. */
-    readonly phase: "claimed";
-    readonly identity: AgentIdentity;
-    readonly operationId: string;
-    readonly callId?: string;
-    readonly address: AgentAddress;
-    readonly ownerId: string;
-} | {
-    /** Idle addressed child with no owner lease, ready for a later invocation to claim. */
-    readonly phase: "available";
-    readonly identity: AgentIdentity;
-    readonly address: AgentAddress;
-};
-/**
- * Durable ownership record for one delegated child.
- *
- * The two execution policies share an identity namespace and serialized store,
- * but their lifecycle states and transitions are disjoint. A terminal child has
- * no handle: settlement deletes it.
- */
-export type AgentHandle = TurnOwnedAgentHandle | TaskOwnedAgentHandle;
-/** Lifecycle phase of a delegated agent handle. */
-export type AgentHandlePhase = AgentHandle["phase"];
-/** Session-state collection of delegated agent handles. */
-export interface AgentHandleStore {
-    readonly handles: readonly AgentHandle[];
-}
-export declare const EMPTY_AGENT_HANDLE_STORE: AgentHandleStore;
-/** One serialized owner-lease mutation against the shared agent handle store. */
-export type AgentHandleStoreCommand = {
-    readonly kind: "read";
-} | {
-    readonly identity: AgentIdentity;
-    readonly kind: "reserve";
-    readonly operationId: string;
-    readonly callId?: string;
-    readonly ownerId: string;
-} | {
-    readonly address: AgentAddress;
-    readonly kind: "confirm";
-    readonly operationId: string;
-    readonly ownerId: string;
-} | {
-    readonly agentId: string;
-    readonly expectedTarget: "local" | "remote";
-    readonly callId?: string;
-    readonly invokedName: string;
-    readonly kind: "claim";
-    readonly operationId: string;
-    readonly ownerId: string;
-} | {
-    readonly agentId: string;
-    readonly kind: "remove";
-    readonly ownerId: string;
-} | {
-    readonly kind: "release-owner";
-    readonly ownerId: string;
-};
-export type AgentHandleStoreCommandResult = {
-    readonly kind: "ready";
-    readonly handle?: TaskOwnedAgentHandle;
-} | {
-    readonly kind: "busy";
-    readonly handle: AgentHandle;
-} | {
-    readonly kind: "mismatch";
-    readonly handle: AgentHandle;
-} | {
-    readonly kind: "unknown";
-};
-/** Derives the model-visible agent id from the first start operation. */
-export declare function deriveAgentId(name: string, startOperationId: string): string;
-/** Collapses whitespace and truncates output into a handle status line. */
-export declare function formatAgentStatus(output: unknown): string;
-/**
- * Validates one agent handle store about to be persisted, returning the
- * parsed value. Throws instead of writing an invalid store: transitions run
- * this on every write, which is the invariant that lets the schema-free
- * owner-side reader (`query.ts`) trust stored values without revalidating.
- */
-export declare function assertPersistableAgentHandleStore(store: AgentHandleStore): AgentHandleStore;
-/** Parses one complete command before the session inbox routes it to the handle store. */
-export declare function parseAgentHandleStoreCommand(value: unknown): AgentHandleStoreCommand | undefined;
-/**
- * Reads and validates the agent handle store from session state.
- *
- * Returns `undefined` only when no store has been written. A present but
- * invalid store throws: treating corruption as absence would let the next
- * transition silently replace every delegated child's delivery coordinates.
- */
-export declare function getAgentHandleStore(state: SessionStateMap | undefined): AgentHandleStore | undefined;
-/** Writes the validated agent handle store under its single session-state key. */
-export declare function setAgentHandleStore(state: SessionStateMap | undefined, store: AgentHandleStore): SessionStateMap;
-/** Writes a validated handle list to a session-shaped value. */
-export declare function writeHandles<Session extends {
-    readonly state?: SessionStateMap;
-}>(session: Session, handles: readonly AgentHandle[]): Session;

package/dist/src/subagents/handles/store.js

@@ -1 +0,0 @@
-import{AGENT_HANDLES_STATE_KEY}from"./state-key.js";import{z}from"#compiled/zod/index.js";const EMPTY_AGENT_HANDLE_STORE={handles:[]},nonEmptyString=z.string().min(1),identitySchema=z.looseObject({id:nonEmptyString,name:nonEmptyString,nodeId:nonEmptyString}),startOperationSchema=z.looseObject({callId:nonEmptyString,id:nonEmptyString,kind:z.literal(`start`),parentTurnId:nonEmptyString}),continueOperationSchema=z.looseObject({callId:nonEmptyString,id:nonEmptyString,kind:z.literal(`continue`),parentTurnId:nonEmptyString,previousStatus:z.string().max(120)}),startTargetSchema=z.discriminatedUnion(`kind`,[z.looseObject({continuationToken:nonEmptyString,kind:z.literal(`agent/local`)}),z.looseObject({continuationToken:nonEmptyString,kind:z.literal(`agent/self`)}),z.looseObject({callbackBaseUrl:z.url(),credentialResolver:z.looseObject({resolverId:nonEmptyString.optional()}).optional(),kind:z.literal(`agent/remote`),url:z.url()})]),addressSchema=z.discriminatedUnion(`kind`,[z.looseObject({continuationToken:nonEmptyString,kind:z.literal(`agent/local`),sessionId:nonEmptyString}),z.looseObject({continuationToken:nonEmptyString,kind:z.literal(`agent/self`),sessionId:nonEmptyString}),z.looseObject({callbackBaseUrl:z.url(),credentialResolver:z.looseObject({resolverId:nonEmptyString.optional()}).optional(),kind:z.literal(`agent/remote`),sessionId:nonEmptyString,url:z.url()})]),agentHandleStoreCommandSchema=z.discriminatedUnion(`kind`,[z.strictObject({kind:z.literal(`read`)}),z.strictObject({identity:identitySchema,callId:nonEmptyString.optional(),kind:z.literal(`reserve`),operationId:nonEmptyString,ownerId:nonEmptyString}),z.strictObject({address:addressSchema,kind:z.literal(`confirm`),operationId:nonEmptyString,ownerId:nonEmptyString}),z.strictObject({agentId:nonEmptyString,callId:nonEmptyString.optional(),expectedTarget:z.enum([`local`,`remote`]),invokedName:nonEmptyString,kind:z.literal(`claim`),operationId:nonEmptyString,ownerId:nonEmptyString}),z.strictObject({agentId:nonEmptyString,kind:z.literal(`remove`),ownerId:nonEmptyString}),z.strictObject({kind:z.literal(`release-owner`),ownerId:nonEmptyString})]),turnOwnedAgentHandleSchema=z.discriminatedUnion(`phase`,[z.looseObject({identity:identitySchema,operation:startOperationSchema,phase:z.literal(`starting`),target:startTargetSchema}),z.looseObject({address:addressSchema,identity:identitySchema,operation:z.discriminatedUnion(`kind`,[startOperationSchema,continueOperationSchema]),phase:z.literal(`running`)}),z.looseObject({address:addressSchema,identity:identitySchema,lastStatus:z.string().max(120),phase:z.literal(`parked`)})]),taskOwnedAgentHandleSchema=z.discriminatedUnion(`phase`,[z.looseObject({callId:nonEmptyString.optional(),identity:identitySchema,operationId:nonEmptyString,phase:z.literal(`reserved`),ownerId:nonEmptyString}),z.looseObject({address:addressSchema,callId:nonEmptyString.optional(),identity:identitySchema,operationId:nonEmptyString,phase:z.literal(`claimed`),ownerId:nonEmptyString}),z.looseObject({address:addressSchema,identity:identitySchema,phase:z.literal(`available`)})]),agentHandleSchema=z.union([turnOwnedAgentHandleSchema,taskOwnedAgentHandleSchema]),agentHandleStoreSchema=z.looseObject({handles:z.array(agentHandleSchema)}).refine(e=>new Set(e.handles.map(e=>e.identity.id)).size===e.handles.length,{message:`Agent handle ids must be unique.`});function deriveAgentId(e,t){return`ag_${e}:${t.slice(0,12)}`}function formatAgentStatus(e){return(typeof e==`string`?e:JSON.stringify(e)??``).replaceAll(/\s+/g,` `).trim().slice(0,120)}function assertPersistableAgentHandleStore(e){let t=agentHandleStoreSchema.safeParse(e);if(!t.success)throw Error(`Refusing to persist a corrupt agent handle store: ${t.error.message}`);return t.data}function parseAgentHandleStoreCommand(e){let t=agentHandleStoreCommandSchema.safeParse(e);return t.success?t.data:void 0}function getAgentHandleStore(e){let t=e?.[AGENT_HANDLES_STATE_KEY];if(t===void 0)return;let n=agentHandleStoreSchema.safeParse(t);if(!n.success)throw Error(`Corrupt agent handle store under session state key "${AGENT_HANDLES_STATE_KEY}": ${n.error.message}`);return n.data}function setAgentHandleStore(e,t){return{...e,[AGENT_HANDLES_STATE_KEY]:assertPersistableAgentHandleStore(t)}}function writeHandles(e,t){return{...e,state:setAgentHandleStore(e.state,{handles:t})}}export{AGENT_HANDLES_STATE_KEY,EMPTY_AGENT_HANDLE_STORE,assertPersistableAgentHandleStore,deriveAgentId,formatAgentStatus,getAgentHandleStore,parseAgentHandleStoreCommand,setAgentHandleStore,writeHandles};

package/dist/src/subagents/handles/transitions.d.ts

@@ -1,103 +0,0 @@
-import { type AgentAddress, type AgentHandleStore, type AgentHandleStoreCommand, type AgentHandleStoreCommandResult, type AgentIdentity, type StartOperation, type TurnOwnedAgentHandle } from "#subagents/handles/store.js";
-import type { HarnessSession, SessionStateMap } from "#harness/types.js";
-import type { AgentTurnOutcome } from "#shared/agent-turn-outcome.js";
-/**
- * Records intent to start a fresh child. Must be applied to the step's
- * working snapshot before the start side effect runs, so the returned state
- * owns any child the step may have created.
- *
- * The guarantee is intra-step, not exactly-once: the prepared handle
- * durably commits only when the enclosing dispatch step's result commits.
- * A crash between an accepted start and that commit replays the step from
- * the pre-step snapshot and re-runs the side effect.
- *
- * Throws when the identity or operation already exists: fresh starts mint
- * a new identity, so a collision means corrupted derivation, not a replay.
- */
-export declare function prepareAgentStart(session: HarnessSession, input: {
-    readonly identity: AgentIdentity;
-    readonly operation: StartOperation;
-    readonly target: AgentStartTargetInput;
-}): HarnessSession;
-type AgentStartTargetInput = Extract<TurnOwnedAgentHandle, {
-    phase: "starting";
-}>["target"];
-/**
- * Confirms a started child: `starting` becomes `running` with the child's
- * confirmed address. Throws when no starting handle carries the operation,
- * because confirming an unprepared start means ownership was never
- * committed. Re-confirming an already-running handle with the same
- * operation and address is a replay no-op.
- */
-export declare function confirmAgentStarted(session: HarnessSession, input: {
-    readonly operationId: string;
-    readonly address: AgentAddress;
-}): HarnessSession;
-/**
- * Resolves a dispatch that definitively failed.
- *
- * - A dead start or dead continuation deletes the handle: there is no
- *   child left to own.
- * - A retryable continuation failure restores `parked` with the status the
- *   handle showed before the delivery, so the model may retry the same
- *   `agentId` later.
- *
- * Unknown operations are a no-op: the failure raced a settlement that
- * already resolved the handle.
- */
-export declare function rejectAgentEffect(session: HarnessSession, input: {
-    readonly operationId: string;
-    readonly disposition: "dead" | "retryable";
-}): HarnessSession;
-/**
- * Parks every running child when the parent abandons a cancelled turn.
- *
- * Cancellation requests each running descendant's cancellation and then
- * tears down the turn inbox — the only hook a child settlement can
- * resume — so no later settlement can move these handles. Without this
- * transition they would stay `running` forever: invisible to the model,
- * unresumable, and retried by every future cancellation.
- *
- * A cancelled child settles its own turn as a park, so `parked` with
- * `"(cancelled)"` mirrors {@link settleAgentTurn}'s cancelled outcome. If
- * the child instead died, a later continuation attempt discovers the dead
- * session and {@link rejectAgentEffect} deletes the handle.
- */
-export declare function abandonRunningAgentTurns(session: HarnessSession): HarnessSession;
-/** Result of applying a settled child turn to the store. */
-export type SettleAgentTurnResult = {
-    readonly kind: "settled";
-    readonly session: HarnessSession;
-} | {
-    readonly kind: "ignored";
-    readonly reason: "unknown-operation";
-};
-/**
- * Applies one settled child turn: `running` becomes `parked` for a parked
- * outcome or is deleted for a terminal outcome.
- *
- * The settlement must carry the operation currently recorded on the
- * running handle; anything else is ignored so a stale delivery can never
- * move a newer turn.
- */
-export declare function settleAgentTurn(session: HarnessSession, input: {
-    readonly operationId: string;
-    readonly outcome: AgentTurnOutcome;
-}): SettleAgentTurnResult;
-/** Applies one atomic owner lease command to the shared agent handle store. */
-export declare function applyAgentHandleStoreCommand(store: AgentHandleStore, command: AgentHandleStoreCommand): {
-    readonly result: AgentHandleStoreCommandResult;
-    readonly store: AgentHandleStore;
-};
-/** Parks child turns still owned by workflow runs when their parent turn is cancelled. */
-export declare function abandonAgentInvocationOwners<Session extends {
-    readonly state?: SessionStateMap;
-}>(session: Session, ownerIds: ReadonlySet<string>): Session;
-/** Applies one owner-scoped handle transition to a harness session. */
-export declare function applyTaskAgentHandleCommand<Session extends {
-    readonly state?: SessionStateMap;
-}>(session: Session, command: AgentHandleStoreCommand): {
-    readonly result: AgentHandleStoreCommandResult;
-    readonly session: Session;
-};
-export {};

package/dist/src/subagents/handles/transitions.js

@@ -1 +0,0 @@
-import{EMPTY_AGENT_HANDLE_STORE,formatAgentStatus,getAgentHandleStore,writeHandles}from"#subagents/handles/store.js";function prepareAgentStart(e,t){let n=getAgentHandleStore(e.state)?.handles??[];if(n.some(e=>e.identity.id===t.identity.id))throw Error(`Agent handle "${t.identity.id}" already exists.`);return writeHandles(e,[...n,{identity:t.identity,operation:t.operation,phase:`starting`,target:t.target}])}function findActiveHandle(e,t){return e.find(e=>(e.phase===`starting`||e.phase===`running`)&&e.operation.id===t)}function confirmAgentStarted(e,t){let n=getAgentHandleStore(e.state)?.handles??[],r=findActiveHandle(n,t.operationId);if(r===void 0)throw Error(`No prepared agent handle for operation "${t.operationId}".`);return r.phase===`running`?e:writeHandles(e,n.map(e=>e===r?{address:t.address,identity:r.identity,operation:r.operation,phase:`running`}:e))}function rejectAgentEffect(e,t){let n=getAgentHandleStore(e.state)?.handles??[],r=findActiveHandle(n,t.operationId);if(r===void 0)return e;if(t.disposition===`retryable`&&r.phase===`running`){let{operation:t}=r;if(t.kind===`continue`)return writeHandles(e,n.map(e=>e===r?{address:r.address,identity:r.identity,lastStatus:t.previousStatus,phase:`parked`}:e))}return writeHandles(e,n.filter(e=>e!==r))}function abandonRunningAgentTurns(e){let t=getAgentHandleStore(e.state)?.handles??[];return t.some(e=>e.phase===`running`)?writeHandles(e,t.map(e=>e.phase===`running`?{address:e.address,identity:e.identity,lastStatus:`(cancelled)`,phase:`parked`}:e)):e}function settleAgentTurn(e,t){let n=getAgentHandleStore(e.state)?.handles??[],r=n.find(e=>e.phase===`running`&&e.operation.id===t.operationId);if(r===void 0||r.phase!==`running`)return{kind:`ignored`,reason:`unknown-operation`};if(t.outcome.kind===`terminal`)return{kind:`settled`,session:writeHandles(e,n.filter(e=>e!==r))};let{result:i}=t.outcome,a=i.kind===`succeeded`?formatAgentStatus(i.output):i.kind===`failed`?formatAgentStatus(i.error):`(cancelled)`;return{kind:`settled`,session:writeHandles(e,n.map(e=>e===r?{address:r.address,identity:r.identity,lastStatus:a,phase:`parked`}:e))}}function applyAgentHandleStoreCommand(e,t){switch(t.kind){case`read`:return{result:{kind:`ready`},store:e};case`reserve`:{let n=e.handles.find(e=>e.identity.id===t.identity.id);if(n!==void 0)return(n.phase===`reserved`||n.phase===`claimed`)&&n.operationId===t.operationId&&n.ownerId===t.ownerId?{result:{handle:n,kind:`ready`},store:e}:{result:{handle:n,kind:`busy`},store:e};let r={callId:t.callId,identity:t.identity,operationId:t.operationId,phase:`reserved`,ownerId:t.ownerId};return{result:{handle:r,kind:`ready`},store:{handles:[...e.handles,r]}}}case`confirm`:{let n=e.handles.find(e=>(e.phase===`claimed`||e.phase===`reserved`)&&e.operationId===t.operationId&&e.ownerId===t.ownerId);return n===void 0?{result:{kind:`unknown`},store:e}:n.phase===`claimed`?{result:{handle:n,kind:`ready`},store:e}:replaceHandle(e,n,{address:t.address,callId:n.callId,identity:n.identity,operationId:n.operationId,phase:`claimed`,ownerId:n.ownerId})}case`claim`:{let n=e.handles.find(e=>e.identity.id===t.agentId);return n===void 0?{result:{kind:`unknown`},store:e}:n.phase===`starting`||n.phase===`running`||n.identity.name!==t.invokedName||n.phase!==`reserved`&&n.address.kind===`agent/remote`!=(t.expectedTarget===`remote`)?{result:{handle:n,kind:`mismatch`},store:e}:n.phase===`claimed`?n.operationId===t.operationId&&n.ownerId===t.ownerId?{result:{handle:n,kind:`ready`},store:e}:{result:{handle:n,kind:`busy`},store:e}:n.phase===`reserved`?{result:{handle:n,kind:`busy`},store:e}:replaceHandle(e,n,{address:n.address,callId:t.callId,identity:n.identity,operationId:t.operationId,phase:`claimed`,ownerId:t.ownerId})}case`remove`:{let n=e.handles.find(e=>e.identity.id===t.agentId);return n===void 0?{result:{kind:`ready`},store:e}:n.phase===`claimed`&&n.ownerId!==t.ownerId?{result:{handle:n,kind:`busy`},store:e}:{result:{kind:`ready`},store:{handles:e.handles.filter(e=>e!==n)}}}case`release-owner`:{let n=e.handles.flatMap(e=>e.phase===`reserved`&&e.ownerId===t.ownerId?[]:e.phase!==`claimed`||e.ownerId!==t.ownerId?[e]:[{address:e.address,identity:e.identity,phase:`available`}]);return{result:{kind:`ready`},store:handlesEqual(e.handles,n)?e:{handles:n}}}}}function abandonAgentInvocationOwners(e,t){let n=getAgentHandleStore(e.state)?.handles??[],r=n.flatMap(e=>e.phase===`reserved`&&t.has(e.ownerId)?[]:e.phase!==`claimed`||!t.has(e.ownerId)?[e]:[{address:e.address,identity:e.identity,lastStatus:`(cancelled)`,phase:`parked`}]);return handlesEqual(n,r)?e:writeHandles(e,r)}function applyTaskAgentHandleCommand(e,t){let n=getAgentHandleStore(e.state)??EMPTY_AGENT_HANDLE_STORE,r=applyAgentHandleStoreCommand(n,t);return{result:r.result,session:r.store===n?e:writeHandles(e,r.store.handles)}}function replaceHandle(e,t,n){return{result:{handle:n,kind:`ready`},store:{handles:e.handles.map(e=>e===t?n:e)}}}function handlesEqual(e,t){return e.length===t.length&&e.every((e,n)=>e===t[n])}export{abandonAgentInvocationOwners,abandonRunningAgentTurns,applyAgentHandleStoreCommand,applyTaskAgentHandleCommand,confirmAgentStarted,prepareAgentStart,rejectAgentEffect,settleAgentTurn};

package/dist/src/subagents/remote-dispatch.js

@@ -1 +0,0 @@
-import{z}from"#compiled/zod/index.js";import{createEveCallbackRoutePath,createEveSessionCancelRoutePath,createEveSessionResetRoutePath,createEveSessionRoutePath}from"#protocol/routes.js";import{decisionToTraceContentCeiling}from"#shared/forwarded-trace-policy.js";import{expectFunction,expectObjectRecord}from"#internal/authored-module.js";import{CancelTurnResponseSchema}from"#protocol/cancel-turn.js";import{ResetResponseSchema}from"#protocol/reset-session.js";import{formatTraceparent,writeAgentDispatchTracestate}from"#protocol/traceparent.js";import{writeForwardedAudienceBaggage,writeForwardedParentSessionBaggage}from"#protocol/baggage.js";import{writeConversationBaggage}from"#tracing/conversation-context.js";import{createWorkflowCallbackUrl}from"#execution/workflow-callback-url.js";import{formatSubagentInput,normalizeRequestedOutputSchema}from"#subagents/invocation.js";import{readTaskIdFromInboxToken}from"#tasks/task-inbox-token.js";import{AgentHandleError}from"#protocol/agent-handle-error.js";import{createRemoteAgentRouteUrl}from"#subagents/remote-route-url.js";const CreateSessionResponseSchema=z.object({ok:z.literal(!0),sessionId:z.string().min(1),status:z.literal(`accepted`)});var RemoteAgentCancelRequestError=class extends Error{retryable;constructor(e,t){super(e),this.name=`RemoteAgentCancelRequestError`,this.retryable=t.retryable}};async function startRemoteAgentSession(e){let t=e.parent?.continuationToken??e.session.continuationToken;if(!t)throw Error(`Cannot dispatch remote agent without a parent continuation token.`);if(!e.callbackBaseUrl)throw Error(`Cannot dispatch remote agent without a callback base URL.`);let n=buildForwardedPrincipalField(e),r={capabilities:{},callback:{callId:e.action.callId,subagentName:e.action.remoteAgentName,taskId:e.taskId??readTaskIdFromInboxToken(t),token:t,url:createWorkflowCallbackUrl(e.callbackBaseUrl,createEveCallbackRoutePath(t))},message:formatRemoteAgentCallInputMessage({action:e.action,remote:e.remote}),outputSchema:normalizeRequestedOutputSchema(e.action.input.outputSchema)};e.activityObserver!==void 0&&(r.activityObserver=e.activityObserver),n!==void 0&&(r.forwardedPrincipal=n),e.operationId!==void 0&&(r.operationId=e.operationId);let i=await resolveRemoteAgentRequestHeaders(e.remote),a=formatTraceparent(e.parent?.traceContext);a!==void 0&&setHeader(i,`traceparent`,a),setHeader(i,`tracestate`,writeAgentDispatchTracestate(readHeader(i,`tracestate`),e.parent?.traceContext));let o=writeForwardedAudienceBaggage(readHeader(i,`baggage`),buildForwardedTraceAssertion({forwardedPrincipal:n,originAudience:e.originAudience,parentTraceContext:e.parent?.traceContext,traceparent:a})),s=writeConversationBaggage(o,e.parent?.conversationId);setHeader(i,`baggage`,writeForwardedParentSessionBaggage(s,e.parent?.lineage));let c=await fetch(createRemoteAgentSessionUrl(e.remote),{body:JSON.stringify(r),headers:{"content-type":`application/json`,...i},method:`POST`});if(!c.ok)throw Error(`Remote agent "${e.action.remoteAgentName}" create-session request failed with HTTP ${c.status}.`);let l;try{l=await c.json()}catch{throw Error(`Remote agent "${e.action.remoteAgentName}" create-session response was not valid JSON.`)}let u=CreateSessionResponseSchema.safeParse(l);if(!u.success)throw Error(`Remote agent "${e.action.remoteAgentName}" create-session response was invalid.`);return{sessionId:u.data.sessionId}}function buildForwardedTraceAssertion(e){let t=decisionToTraceContentCeiling(e.parentTraceContext?.decision);if(e.forwardedPrincipal!==void 0&&e.parentTraceContext!==void 0&&(e.parentTraceContext.traceFlags&1)==1&&e.traceparent!==void 0&&t!==void 0)return{ceiling:t,originAudience:e.originAudience??`unknown`}}async function continueRemoteAgentSession(e){let t=buildForwardedPrincipalField(e),n={activityObserver:e.activityObserver,callback:e.callback,message:e.message,outputSchema:e.outputSchema};t!==void 0&&(n.forwardedPrincipal=t);let r=await fetch(createRemoteAgentContinueUrl(e.remote,e.sessionId),{body:JSON.stringify(n),headers:{"content-type":`application/json`,...await resolveRemoteAgentRequestHeaders(e.remote)},method:`POST`});if(!r.ok){let n=await readRemoteAgentErrorCode(r),i=r.status===404||n===AgentHandleError.SessionNotResumable.code,a=r.status===400&&t!==void 0?` The receiver may support forwarded principals only on session creation; upgrade it before retrying.`:``;throw new RemoteAgentContinueRequestError(`Remote agent "${e.remote.name}" continue-session request failed${i?` permanently`:``} with HTTP ${r.status}.${a}`,{deliveryAmbiguous:isAmbiguousRemoteContinueStatus(r.status),retryable:!i})}}var RemoteAgentContinueRequestError=class extends Error{deliveryAmbiguous;retryable;constructor(e,t){super(e),this.name=`RemoteAgentContinueRequestError`,this.deliveryAmbiguous=t.deliveryAmbiguous,this.retryable=t.retryable}};function isRetryableRemoteAgentContinueError(e){return!(e instanceof RemoteAgentContinueRequestError)||e.retryable}function isAmbiguousRemoteAgentContinueError(e){return!(e instanceof RemoteAgentContinueRequestError)||e.deliveryAmbiguous}function isAmbiguousRemoteContinueStatus(e){return e===408||e===425||e>=500}async function readRemoteAgentErrorCode(e){let t;try{t=await e.json()}catch{return}if(typeof t!=`object`||!t)return;let n=Reflect.get(t,`code`);return typeof n==`string`?n:void 0}function buildForwardedPrincipalField(e){if(e.remote.forwardPrincipal!==!0||e.auth===null||e.auth===void 0)return;let t={current:e.auth};return e.initiatorAuth!==null&&e.initiatorAuth!==void 0&&(t.initiator=e.initiatorAuth),t}async function cancelRemoteAgentTurn(e){let t=e.headers??await resolveRemoteAgentRequestHeaders(e.remote),n=await fetch(createRemoteAgentCancelTurnUrl(e.remote,e.sessionId),{body:e.turnId===void 0&&e.taskId===void 0&&e.tasks===void 0?void 0:JSON.stringify({taskId:e.taskId,tasks:e.tasks,turnId:e.turnId}),headers:t,method:`POST`});if(!n.ok)throw new RemoteAgentCancelRequestError(`Remote agent "${e.remote.name}" cancel-turn request failed with HTTP ${n.status}.`,{retryable:isRetryableRemoteCancelStatus(n.status)});let r;try{r=await n.json()}catch{throw new RemoteAgentCancelRequestError(`Remote agent "${e.remote.name}" cancel-turn response was not valid JSON.`,{retryable:!1})}let i=CancelTurnResponseSchema.safeParse(r);if(!i.success||i.data.status===`accepted`&&i.data.sessionId!==e.sessionId)throw new RemoteAgentCancelRequestError(`Remote agent "${e.remote.name}" cancel-turn response was invalid.`,{retryable:!1});return i.data.status===`accepted`?{sessionId:i.data.sessionId,status:`accepted`}:{status:`no_active_turn`}}function readHeader(e,t){let n=Object.keys(e).find(e=>e.toLowerCase()===t);return n===void 0?void 0:e[n]}function setHeader(e,t,n){for(let n of Object.keys(e))n.toLowerCase()===t&&delete e[n];n!==void 0&&(e[t]=n)}async function resetRemoteAgentSession(e){let t=e.headers??await resolveRemoteAgentRequestHeaders(e.remote),n=await fetch(createRemoteAgentRouteUrl(e.remote.url,createEveSessionResetRoutePath(e.sessionId)),{body:JSON.stringify({reason:`Parent session ended`}),headers:{"content-type":`application/json`,...t},method:`POST`});if(!n.ok)throw Error(`Remote agent "${e.remote.name}" reset-session request failed with HTTP ${n.status}.`);let r=ResetResponseSchema.safeParse(await n.json());if(!r.success||r.data.status===`reset`&&r.data.previousSessionId!==e.sessionId)throw Error(`Remote agent "${e.remote.name}" reset-session response was invalid.`);return r.data}function isRetryableRemoteAgentCancelError(e){return!(e instanceof RemoteAgentCancelRequestError)||e.retryable}function resolveRemoteAgentForAction(e){let t=e.registry.get(e.nodeId)?.definition;if(e.dynamicRemoteAgent!==void 0){if(t===void 0)throw Error(`Missing remote agent "${e.remoteAgentName}" in runtime registry.`);let n=resolveDynamicRemoteAgentCredentials(e.dynamicRemoteAgent),r=e.dynamicRemoteAgent,i={description:r.description,kind:`remote`,logicalPath:t.logicalPath,name:e.remoteAgentName,nodeId:e.nodeId,path:r.path,sourceId:t.sourceId,sourceKind:`module`,url:r.url};return r.forwardPrincipal!==void 0&&(i.forwardPrincipal=r.forwardPrincipal),n.auth!==void 0&&(i.auth=n.auth),n.headers!==void 0&&(i.headers=n.headers),i}if(t?.kind!==`remote`)throw Error(`Missing remote agent "${e.remoteAgentName}" in runtime registry.`);return t}async function resolveRemoteAgentStreamHeaders(e){if(e.resolverId===void 0)return{};let t=new Set([e.bundle.graph.root,...e.bundle.graph.nodesByNodeId.values()]);for(let n of t){let t=n.subagentRegistry.subagentsByNodeId.get(e.resolverId)?.definition;if(t!==void 0){if(t.kind!==`remote`||t.name!==e.name||t.url!==e.url)throw Error(`Remote child stream resolver does not match the authored remote agent.`);return await resolveRemoteAgentRequestHeaders(t)}}return await resolveRemoteAgentRequestHeaders(resolveDynamicRemoteAgentCredentials({credentialsStepId:e.resolverId,description:``,path:``,url:e.url}))}function resolveDynamicRemoteAgentCredentials(e){if(e.credentialsStepId===void 0)return{};let t=getStepRegistry().get(e.credentialsStepId);if(t===void 0)throw Error(`Dynamic remote subagent credentials function "${e.credentialsStepId}" is not registered.`);let n=expectObjectRecord(t(),`Dynamic remote subagent credentials are invalid.`),r={};return n.auth!==void 0&&(r.auth=expectFunction(n.auth,`Dynamic remote subagent auth is invalid.`)),n.headers!==void 0&&(r.headers=resolveDynamicRemoteAgentHeaders(n.headers)),r}function resolveDynamicRemoteAgentHeaders(e){if(typeof e==`function`)return e;let t=expectObjectRecord(e,`Dynamic remote subagent headers are invalid.`);for(let e of Object.values(t))if(typeof e!=`string`)throw Error(`Dynamic remote subagent headers are invalid.`);return t}function getStepRegistry(){let e=Symbol.for(`@workflow/core//registeredSteps`),t=globalThis,n=t[e];return n===void 0&&(n=new Map,t[e]=n),n}function createRemoteAgentSessionUrl(e){return createRemoteAgentRouteUrl(e.url,e.path)}function createRemoteAgentCancelTurnUrl(e,t){return createRemoteAgentRouteUrl(e.url,createEveSessionCancelRoutePath(t))}function createRemoteAgentContinueUrl(e,t){return createRemoteAgentRouteUrl(e.url,createEveSessionRoutePath(t))}function isRetryableRemoteCancelStatus(e){return e===408||e===425||e===429||e>=500}async function resolveRemoteAgentRequestHeaders(e){let t={};return e.headers!==void 0&&Object.assign(t,typeof e.headers==`function`?await e.headers():e.headers),e.auth!==void 0&&Object.assign(t,(await e.auth()).headers),t}function formatRemoteAgentCallInputMessage(e){let t=typeof e.action.input.message==`string`?e.action.input.message:``;return formatSubagentInput({description:e.remote.description,message:t,name:e.action.remoteAgentName,type:`remote`}).message}export{RemoteAgentContinueRequestError,cancelRemoteAgentTurn,continueRemoteAgentSession,isAmbiguousRemoteAgentContinueError,isRetryableRemoteAgentCancelError,isRetryableRemoteAgentContinueError,resetRemoteAgentSession,resolveRemoteAgentForAction,resolveRemoteAgentStreamHeaders,startRemoteAgentSession};

package/dist/src/subagents/start-local.d.ts

@@ -1,29 +0,0 @@
-import type { DispatchOutcome, RuntimeSession } from "#subagents/handle-dispatch.js";
-import type { LocalDevRequestProvenance } from "#context/keys.js";
-import { buildSubagentRunInput, type SubagentInputSource } from "#subagents/tool.js";
-import { createWorkflowRuntime } from "#execution/workflow-runtime.js";
-import type { RuntimeSubagentDispatchRequest } from "#shared/action-types.js";
-import type { CompiledBundle } from "#runtime/sessions/runtime-context-keys.js";
-import type { SubagentParentContext } from "#subagents/invocation.js";
-type DynamicSubagentAgentConfig = Parameters<typeof createWorkflowRuntime>[0]["dynamicSubagentAgentConfig"];
-/** Starts one local subagent after dispatch planning has selected its target. */
-export declare function startLocalSubagent(input: {
-    readonly action: RuntimeSubagentDispatchRequest;
-    readonly auth: Parameters<typeof buildSubagentRunInput>[0]["auth"];
-    readonly bundle: CompiledBundle;
-    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 dynamicSubagentAgentConfig?: DynamicSubagentAgentConfig;
-    readonly fanoutSize: number;
-    readonly initiatorAuth: Parameters<typeof buildSubagentRunInput>[0]["initiatorAuth"];
-    readonly localDevRequest?: LocalDevRequestProvenance;
-    readonly parent: SubagentParentContext;
-    readonly activityObserver?: Parameters<typeof buildSubagentRunInput>[0]["activityObserver"];
-    readonly sandboxSessionId: string;
-    readonly session: RuntimeSession;
-    readonly source: SubagentInputSource;
-    readonly taskId?: string;
-}): Promise<DispatchOutcome>;
-export {};

package/dist/src/subagents/start-local.js

@@ -1 +0,0 @@
-import{createLogger,logError}from"#internal/logging.js";import{sessionInboxHookToken}from"#execution/session-inbox/address.js";import{ContextContainer,contextStorage}from"#context/container.js";import{toErrorMessage}from"#shared/errors.js";import{createWorkflowRuntime,waitForCommandHookOwner}from"#execution/workflow-runtime.js";import{buildSubagentRunInput}from"#subagents/tool.js";import{SUBAGENT_START_FAILED}from"#subagents/agent-handle-errors.js";const log=createLogger(`execution.subagent-start-local`);async function startLocalSubagent(e){let{action:t,source:n}=e,r=createWorkflowRuntime({compiledArtifactsSource:e.bundle.compiledArtifactsSource,dynamicSubagentAgentConfig:e.dynamicSubagentAgentConfig,nodeId:t.nodeId}),{childContinuationToken:i,runInput:a}=buildSubagentRunInput({action:t,auth:e.auth,capabilities:e.capabilities,channelMetadata:e.channelMetadata,inheritedConversation:e.inheritedConversation,fanoutSize:e.fanoutSize,initiatorAuth:e.initiatorAuth,graph:e.bundle.graph,parent:e.parent,activityObserver:e.activityObserver,sandboxSessionId:e.sandboxSessionId,session:e.session,selfAgent:n.type===`runtime`,source:n,taskId:e.taskId}),o=n.type===`runtime`?`agent/self`:`agent/local`,s;try{await contextStorage.run(new ContextContainer({localDevRequest:e.localDevRequest}),()=>r.createSession(a)),s=(await waitForCommandHookOwner(sessionInboxHookToken(i))).runId}catch(n){return logError(log,`local subagent start failed`,n,{callId:t.callId,nodeId:t.nodeId,subagentName:t.subagentName}),{kind:`error`,result:{callId:t.callId,isError:!0,kind:`subagent-result`,origin:`dispatch`,output:{code:SUBAGENT_START_FAILED,message:toErrorMessage(n)},subagentName:t.subagentName},session:e.currentSession}}return{address:{continuationToken:i,kind:o,sessionId:s},callId:t.callId,kind:`called`,name:t.name,session:e.currentSession,toolName:t.subagentName}}export{startLocalSubagent};

package/dist/src/subagents/start-remote.d.ts

@@ -1,21 +0,0 @@
-import type { DispatchOutcome, RuntimeSession } from "#subagents/handle-dispatch.js";
-import { resolveRemoteAgentForAction, startRemoteAgentSession } from "#subagents/remote-dispatch.js";
-import type { RuntimeRemoteAgentDispatchRequest } from "#shared/action-types.js";
-import type { CompiledBundle } from "#runtime/sessions/runtime-context-keys.js";
-import type { SubagentParentContext } from "#subagents/invocation.js";
-/** Starts one remote subagent after dispatch planning has selected its target. */
-export declare function startRemoteSubagent(input: {
-    readonly action: RuntimeRemoteAgentDispatchRequest;
-    readonly auth: Parameters<typeof startRemoteAgentSession>[0]["auth"];
-    readonly bundle: CompiledBundle;
-    readonly callbackBaseUrl: string | undefined;
-    readonly currentSession: RuntimeSession;
-    readonly dynamicRemoteAgent?: NonNullable<Parameters<typeof resolveRemoteAgentForAction>[0]["dynamicRemoteAgent"]>;
-    readonly initiatorAuth: Parameters<typeof startRemoteAgentSession>[0]["initiatorAuth"];
-    readonly parent: SubagentParentContext;
-    readonly activityObserver?: Parameters<typeof startRemoteAgentSession>[0]["activityObserver"];
-    /** Already resolved task-owned work; do not derive another child identity. */
-    readonly taskActivityObserver?: Parameters<typeof startRemoteAgentSession>[0]["activityObserver"];
-    readonly session: RuntimeSession;
-    readonly taskId?: string;
-}): Promise<DispatchOutcome>;

package/dist/src/subagents/start-remote.js

@@ -1 +0,0 @@
-import{createLogger,logError}from"#internal/logging.js";import{resolveRemoteAgentForAction,startRemoteAgentSession}from"#subagents/remote-dispatch.js";import{deriveChildActivityObserverConfig}from"#execution/activity-work.js";import{createRemoteAgentStartFailureResult}from"#execution/dispatch-action-failures.js";import{mintStartOperation}from"#execution/dispatch-start-operation.js";const log=createLogger(`execution.subagent-start-remote`);async function startRemoteSubagent(e){let{action:t}=e,n=e.taskActivityObserver??deriveChildActivityObserverConfig({activityObserver:e.activityObserver,callId:t.callId,kind:`remote-agent`,name:t.remoteAgentName,parentSessionId:e.session.sessionId,parentTurnId:e.parent.lineage.turn.id}),r,i;try{if(e.callbackBaseUrl===void 0)throw Error(`Cannot dispatch remote agent without a callback base URL.`);r=e.callbackBaseUrl,i=resolveRemoteAgentForAction({dynamicRemoteAgent:e.dynamicRemoteAgent,nodeId:t.nodeId,remoteAgentName:t.remoteAgentName,registry:e.bundle.subagentRegistry.subagentsByNodeId})}catch(n){return logError(log,`remote agent start failed`,n,{remoteAgentName:t.remoteAgentName,nodeId:t.nodeId,callId:t.callId}),{kind:`error`,result:createRemoteAgentStartFailureResult({action:t,error:n}),session:e.currentSession}}let{operation:a}=mintStartOperation({callId:t.callId,name:t.remoteAgentName,nodeId:t.nodeId,parentSessionId:e.session.sessionId,parentTurnId:e.parent.lineage.turn.id}),o={resolverId:e.dynamicRemoteAgent===void 0?t.nodeId:e.dynamicRemoteAgent.credentialsStepId};try{let s=await startRemoteAgentSession({action:t,auth:e.auth,callbackBaseUrl:r,originAudience:e.parent.originAudience,initiatorAuth:e.initiatorAuth,operationId:a.id,parent:e.parent,activityObserver:n,remote:i,session:e.session,taskId:e.taskId});return{address:{callbackBaseUrl:r,credentialResolver:o,kind:`agent/remote`,sessionId:s.sessionId,url:i.url},callId:t.callId,kind:`called`,name:t.name,session:e.currentSession,toolName:t.remoteAgentName}}catch(n){return logError(log,`remote agent start failed`,n,{remoteAgentName:t.remoteAgentName,nodeId:t.nodeId,callId:t.callId}),{kind:`error`,result:createRemoteAgentStartFailureResult({action:t,error:n}),session:e.currentSession}}}export{startRemoteSubagent};

package/dist/src/tasks/delivery-context.d.ts

@@ -1,32 +0,0 @@
-import type { TaskDeliveryPolicy, DeliverHookPayload } from "#channel/types.js";
-import type { SessionStateMap, StepInput } from "#harness/types.js";
-export declare const TASK_DELIVERY_CONTEXT_LABEL = "[Task state]";
-export declare const TASK_DELIVERY_INITIATING_INSTRUCTION = "Background task reporting: launch acknowledgement\nThe latest [Task state] message is runtime-authored and lists background tasks accepted so far from the current turn. They continue independently after this turn.\n\nContinue carrying out the user's request, including starting any remaining background work. When no further tool calls are needed in this turn, send one brief user-facing acknowledgement that the background work has started. Do not wait for results or report results that are not available yet. End the turn after the acknowledgement.";
-export declare const TASK_DELIVERY_SETTLED_INSTRUCTION = "Background task reporting\nFor this background-task update, the accompanying [Task state] message is runtime-authored and lists the settled tasks in this cohort and their available terminal outputs. Report their useful results together in one user-facing response without repeating results already reported. Do not reply with <eve-empty-delivery/>.";
-export declare const TASK_DELIVERY_AUTO_INSTRUCTION = "Background task reporting\nFor this background-task update, the accompanying [Task state] message is runtime-authored and lists the whole cohort, including pending tasks and every available terminal output. A received result has not necessarily been reported to the user. Report new results only when they are useful independently of unfinished work. When that work settles, combine its results with any previously withheld results. If there is nothing new and useful to report, reply with exactly <eve-empty-delivery/>. Do not repeat results already reported or send an acknowledgement just to say you are waiting.";
-type BackgroundTaskDelivery = DeliverHookPayload & {
-    readonly taskDeliveryId: string;
-};
-/** Returns task delivery provenance when a child task wakes its parent. */
-export declare function getBackgroundTaskDelivery(input: unknown): BackgroundTaskDelivery | undefined;
-/** Marks a task-produced user message before the harness coalesces delivery results. */
-export declare function markBackgroundTaskStepInput(input: StepInput): StepInput;
-/** Projects the report group without changing the delivered task's activity root. */
-export declare function resolveTaskDeliveryContext(input: {
-    readonly state: SessionStateMap | undefined;
-    readonly taskDeliveryIds: readonly string[];
-    readonly taskDeliveryPolicy: TaskDeliveryPolicy;
-}): {
-    readonly context: string;
-    readonly phase: "pending" | "settled";
-    readonly rootTurnId: string;
-} | undefined;
-/** Returns model context for durable tasks launched by the active parent turn. */
-export declare function resolveInitiatingTaskContext(input: {
-    readonly state: SessionStateMap | undefined;
-    readonly turnId: string;
-}): {
-    readonly context: string;
-    readonly phase: "initiating";
-} | undefined;
-export {};

package/dist/src/tasks/delivery-context.js

@@ -1,4 +0,0 @@
-import{markFrameworkStepInput}from"#harness/messages.js";import{getBackgroundTasks}from"#harness/workflow-tool-runs.js";import{taskIdOfDelivery}from"#tasks/notification.js";import{EMPTY_DELIVERY_SENTINEL}from"#shared/empty-delivery.js";const TASK_DELIVERY_CONTEXT_LABEL=`[Task state]`,TASK_DELIVERY_INITIATING_INSTRUCTION=`Background task reporting: launch acknowledgement
-The latest ${TASK_DELIVERY_CONTEXT_LABEL} message is runtime-authored and lists background tasks accepted so far from the current turn. They continue independently after this turn.
-
-Continue carrying out the user's request, including starting any remaining background work. When no further tool calls are needed in this turn, send one brief user-facing acknowledgement that the background work has started. Do not wait for results or report results that are not available yet. End the turn after the acknowledgement.`,TASK_DELIVERY_SETTLED_INSTRUCTION=`Background task reporting\nFor this background-task update, the accompanying ${TASK_DELIVERY_CONTEXT_LABEL} message is runtime-authored and lists the settled tasks in this cohort and their available terminal outputs. Report their useful results together in one user-facing response without repeating results already reported. Do not reply with ${EMPTY_DELIVERY_SENTINEL}.`,TASK_DELIVERY_AUTO_INSTRUCTION=`Background task reporting\nFor this background-task update, the accompanying ${TASK_DELIVERY_CONTEXT_LABEL} message is runtime-authored and lists the whole cohort, including pending tasks and every available terminal output. A received result has not necessarily been reported to the user. Report new results only when they are useful independently of unfinished work. When that work settles, combine its results with any previously withheld results. If there is nothing new and useful to report, reply with exactly ${EMPTY_DELIVERY_SENTINEL}. Do not repeat results already reported or send an acknowledgement just to say you are waiting.`;function getBackgroundTaskDelivery(e){if(typeof e!=`object`||!e)return;let t=e;return t.kind===`deliver`&&typeof t.taskDeliveryId==`string`?e:void 0}function markBackgroundTaskStepInput(e){return e.message===void 0?e:markFrameworkStepInput(e,`execution.background_task`)}function resolveTaskDeliveryContext(e){let t=e.taskDeliveryIds[0];if(t===void 0)return;let n=getBackgroundTasks(e.state),r=n.get(taskIdOfDelivery(t));if(r!==void 0)return{...projectTaskCohort(n.query({cohortId:r.cohortId}),e.taskDeliveryPolicy===`auto`),rootTurnId:r.turnId}}function resolveInitiatingTaskContext(e){let t=getBackgroundTasks(e.state);if(t.query({state:`working`,turnId:e.turnId}).length!==0)return{...projectTaskCohort(t.query({turnId:e.turnId}),!1),phase:`initiating`}}function projectTaskCohort(e,t){let n=e.every(e=>e.status!==`working`),r=e.map(e=>({name:e.metadata.name,output:n||t?e.lastOutput:void 0,status:e.status===`working`?`pending`:e.status,taskId:e.taskId}));return{context:`${TASK_DELIVERY_CONTEXT_LABEL}\n${JSON.stringify({tasks:r})}`,phase:n?`settled`:`pending`}}export{TASK_DELIVERY_AUTO_INSTRUCTION,TASK_DELIVERY_CONTEXT_LABEL,TASK_DELIVERY_INITIATING_INSTRUCTION,TASK_DELIVERY_SETTLED_INSTRUCTION,getBackgroundTaskDelivery,markBackgroundTaskStepInput,resolveInitiatingTaskContext,resolveTaskDeliveryContext};

package/dist/src/tasks/delivery-policy.d.ts

@@ -1,14 +0,0 @@
-import type { TaskDeliveryPolicy } from "#channel/types.js";
-export interface DeliveryPolicy {
-    readonly allowsEmptyDelivery: boolean;
-    readonly instruction?: string;
-}
-/** Resolves one policy for both model prompting and empty-response recovery. */
-export declare function resolveDeliveryPolicy(input: {
-    readonly hasOutputSchema: boolean;
-    readonly isChild: boolean;
-    readonly isFirstTurn: boolean;
-    readonly hasScheduleProvenance: boolean;
-    readonly taskDeliveryPolicy: TaskDeliveryPolicy | undefined;
-    readonly taskDeliveryPhase: "none" | "initiating" | "pending" | "settled" | undefined;
-}): DeliveryPolicy;

package/dist/src/tasks/delivery-policy.js

@@ -1 +0,0 @@
-import{TASK_DELIVERY_AUTO_INSTRUCTION,TASK_DELIVERY_INITIATING_INSTRUCTION,TASK_DELIVERY_SETTLED_INSTRUCTION}from"#tasks/delivery-context.js";import{CONDITIONAL_DELIVERY_INSTRUCTION}from"#shared/empty-delivery.js";const POLICIES={auto:{allowsEmptyDelivery:!0,instruction:TASK_DELIVERY_AUTO_INSTRUCTION},conditional:{allowsEmptyDelivery:!0,instruction:CONDITIONAL_DELIVERY_INSTRUCTION},initiating:{allowsEmptyDelivery:!1,instruction:TASK_DELIVERY_INITIATING_INSTRUCTION},normal:{allowsEmptyDelivery:!1},pending:{allowsEmptyDelivery:!0},settled:{allowsEmptyDelivery:!1,instruction:TASK_DELIVERY_SETTLED_INSTRUCTION}};function resolveDeliveryPolicy(e){return e.hasOutputSchema||e.isChild?POLICIES.normal:e.taskDeliveryPolicy===`auto`&&(e.taskDeliveryPhase===`pending`||e.taskDeliveryPhase===`settled`)?POLICIES.auto:e.taskDeliveryPhase===`pending`?POLICIES.pending:e.taskDeliveryPhase===`settled`?POLICIES.settled:e.isFirstTurn&&e.hasScheduleProvenance?POLICIES.conditional:e.taskDeliveryPhase===`initiating`?POLICIES.initiating:POLICIES.normal}export{resolveDeliveryPolicy};