eve 0.83.2 → 0.84.0

package/dist/src/execution/session-event-stream.js

@@ -1 +1 @@
-import{normalizePersistedMessageStreamEvent}from"#protocol/message-version.js";import{getRun,getWorld}from"#internal/workflow/runtime.js";import{RunExpiredError}from"#compiled/@workflow/errors/index.js";import{parseNdjsonStream}from"#execution/ndjson-stream.js";function readSessionEventStream(e,t){return parseNdjsonStream(()=>getRun(e).getReadable({startIndex:t}),normalizePersistedEvent)}function readSessionEventHistory(e,t){let n=streamSessionEvents(e,{follow:!1,startIndex:t});return new ReadableStream({async pull(e){let t=await n.next();t.done?e.close():e.enqueue(t.value)},async cancel(){await n.return(void 0)}})}async function readSessionStreamTailIndex(e){let t=getRun(e).getReadable();try{let[,n]=await Promise.all([assertSessionHistoryReadable(e),t.getTailIndex()]);return n}finally{await t.cancel().catch(()=>{})}}async function assertSessionHistoryReadable(e){let t=await(await getWorld()).runs.get(e,{resolveData:`none`});if(t.expiredAt!==void 0&&t.expiredAt.getTime()<=Date.now())throw new RunExpiredError(`Session history is no longer available.`,e,t.status,t.expiredAt)}async function*streamSessionEvents(e,t={}){let{follow:n=!0,signal:r}=t,i=t.startIndex??0;if(r?.aborted)return;let a,o=i;if((!n||i<0)&&(a=await readSessionStreamTailIndex(e),i<0&&(o=Math.max(0,a+1+i))),!n&&a!==void 0&&o>a)return;let s=readSessionEventStream(e,o).getReader(),cancel=()=>void s.cancel(r?.reason).catch(()=>{});r?.addEventListener(`abort`,cancel,{once:!0});try{let e=o;for(;!r?.aborted;){let{done:t,value:r}=await s.read();if(t||(yield r,!n&&a!==void 0&&e>=a))return;e+=1}}finally{r?.removeEventListener(`abort`,cancel),await s.cancel().catch(()=>{}),s.releaseLock()}}function normalizePersistedEvent(e){return normalizePersistedMessageStreamEvent(e)}export{assertSessionHistoryReadable,readSessionEventHistory,readSessionEventStream,readSessionStreamTailIndex,streamSessionEvents};
+import{isStoredLine}from"#protocol/session-events/envelope.js";import{createEventReader}from"#protocol/session-lines.js";import{isV26Line}from"#protocol/v26-lines.js";import{getRun,getWorld}from"#internal/workflow/runtime.js";import{createV26HistoryReader}from"#execution/v26-history.js";import{RunExpiredError}from"#compiled/@workflow/errors/index.js";import{parseNdjsonStream}from"#execution/ndjson-stream.js";function readSessionRecords(e,t){return parseNdjsonStream(()=>getRun(e).getReadable({startIndex:t}))}function readSessionEventStream(e,t,n){let r=new AbortController,i=streamSessionLines(e,{startIndex:t,signal:n===void 0?r.signal:AbortSignal.any([n,r.signal])}),a=createEventReader();return new ReadableStream({async pull(e){for(;;){let t=await i.next();if(t.done===!0){e.close();return}let{line:n,position:r}=t.value;if(n===void 0)continue;let o=a.read(n,r);if(o.length!==0){for(let t of o)e.enqueue(t);return}}},async cancel(){r.abort(),await i.return(void 0)}})}function readSessionEventHistory(e,t,n){let r=streamSessionEvents(e,{follow:!1,startIndex:t,signal:n});return new ReadableStream({async pull(e){let t=await r.next();t.done?e.close():e.enqueue(t.value)},async cancel(){await r.return(void 0)}})}function readSessionRecordHistory(e,t){let n,r=0,i=-1;return new ReadableStream({async start(){i=await readSessionStreamTailIndex(e);let a=t??0;r=a<0?Math.max(0,i+1+a):a,r<=i&&(n=readSessionRecords(e,r).getReader())},async pull(e){if(n===void 0||r>i){e.close(),await n?.cancel().catch(()=>{});return}let{done:t,value:a}=await n.read();if(t){e.close();return}e.enqueue(a),r+=1},async cancel(){await n?.cancel().catch(()=>{})}})}async function readSessionStreamTailIndex(e){let t=getRun(e).getReadable();try{let[,n]=await Promise.all([assertSessionHistoryReadable(e),t.getTailIndex()]);return n}finally{await t.cancel().catch(()=>{})}}async function assertSessionHistoryReadable(e){let t=await(await getWorld()).runs.get(e,{resolveData:`none`});if(t.expiredAt!==void 0&&t.expiredAt.getTime()<=Date.now())throw new RunExpiredError(`Session history is no longer available.`,e,t.status,t.expiredAt)}async function*streamSessionLines(e,t={}){let{follow:n=!0,signal:r}=t,i=t.startIndex??0;if(r?.aborted)return;let a,o=i;if((!n||i<0)&&(a=await readSessionStreamTailIndex(e),i<0&&(o=Math.max(0,a+1+i))),!n&&a!==void 0&&o>a)return;let s=readSessionRecords(e,o).getReader(),cancel=()=>void s.cancel(r?.reason).catch(()=>{});r?.addEventListener(`abort`,cancel,{once:!0});try{let e=o;for(;!r?.aborted;){let{done:t,value:r}=await s.read();if(t||(yield{line:isStoredLine(r)?r:void 0,position:e,record:r},!n&&a!==void 0&&e>=a))return;e+=1}}finally{r?.removeEventListener(`abort`,cancel),await s.cancel().catch(()=>{}),s.releaseLock()}}async function*streamSessionEvents(e,t={}){let n=createEventReader(),r;for await(let{line:i,position:a,record:o}of streamSessionLines(e,t)){r===void 0&&isV26Line(o)&&(r=createV26HistoryReader(),a>0&&await readV26Prefix(r,e,a,t.signal));let s=r===void 0?i:r.read(o,a);s!==void 0&&(yield*n.read(s,a))}}async function readV26Prefix(e,t,n,r){for await(let{position:i,record:a}of streamSessionLines(t,{follow:!1,signal:r,startIndex:0})){if(i>=n)return;e.read(a,i)}}export{assertSessionHistoryReadable,readSessionEventHistory,readSessionEventStream,readSessionRecordHistory,readSessionRecords,readSessionStreamTailIndex,streamSessionEvents,streamSessionLines};

package/dist/src/execution/session-inbox/end-stranded-session.d.ts

@@ -1,7 +1,13 @@
+import type { SessionControlIdentity } from "#channel/types.js";
 import { type SessionInboxAddress } from "#execution/session-inbox/address.js";
 import { type StrandedSessionOwnerError } from "#execution/session-inbox/owner.js";
 /** What made eve end a stranded session; recorded for operators. */
 export type StrandedSessionEndTrigger = "message" | "reset" | "timeout";
+/**
+ * The `session.ended` cause naming what ended a stranded session without a control delivery:
+ * `stranded-message` or `stranded-timeout`. A reset's cause names its control delivery instead.
+ */
+export declare function strandedEndPolicy(trigger: StrandedSessionEndTrigger): string;
 /**
  * Ends a stranded session without running any of its code, so none of its
  * terminal hooks fire: cancels its owner run and the original run that
@@ -19,4 +25,4 @@ export type StrandedSessionEndTrigger = "message" | "reset" | "timeout";
  */
 export declare function endStrandedSession(stranded: StrandedSessionOwnerError, 
 /** The address the caller used; a session address names the session outright. */
-address: string | SessionInboxAddress, trigger: StrandedSessionEndTrigger): Promise<string>;
+address: string | SessionInboxAddress, trigger: StrandedSessionEndTrigger, control?: SessionControlIdentity): Promise<string>;

package/dist/src/execution/session-inbox/end-stranded-session.js

@@ -1 +1 @@
-import{createLogger}from"#internal/logging.js";import{logicalSessionInboxToken,sessionCommandHookToken,sessionInboxHookToken}from"#execution/session-inbox/address.js";import{resolveInstalledPackageInfo}from"#internal/application/package.js";import{encodeMessageStreamEvent,stampMessageStreamEvent}from"#protocol/message.js";import{cancelRun,getRun,getWorld}from"#internal/workflow/runtime.js";import{isInactiveWorkflowRunError}from"#internal/workflow/is-inactive-workflow-run-error.js";import{logicalSessionToken,requireSessionId}from"#execution/session-inbox/resume.js";import{sessionFailed}from"#harness/session-machine/transitions.js";import{findSessionHookHolder}from"#execution/session-inbox/owner.js";import{EVE_SESSION_ATTRIBUTE,EVE_TYPE_ATTRIBUTE}from"#execution/eve-workflow-attributes.js";import{waitForSessionHooksRelease}from"#execution/session-inbox/hook-release.js";const log=createLogger(`execution.session-inbox`);async function endStrandedSession(e,t,n){let r=typeof t==`string`?await resolveStrandedSessionId(e):t.sessionId,{ownerRunId:i}=e,a=await getWorld();await assertStillServesSession(r,i);let o=await listOwnedSessionTokens(a,i);return await publishTerminalEvent(r,n),await cancelRuns(a,[i,r],`Session ended: its deployment was retired`),await waitForSessionHooksRelease([sessionCommandHookToken(r),logicalSessionToken(t),...o],{ownerRunId:i,sessionId:r}),log.warn(`Reset stranded session`,{currentEveVersion:resolveInstalledPackageInfo().version,previousEveVersion:e.eveVersion??`unknown`,previousSessionId:r,trigger:n}),r}async function assertStillServesSession(e,t){let n=await findSessionHookHolder(sessionInboxHookToken(sessionCommandHookToken(e)));if(n!==void 0&&n.runId!==t)throw Error(`Session "${e}" changed owners while it was being reset. Nothing was ended; retry the request.`)}async function publishTerminalEvent(e,t){let n=getRun(e).getWritable().getWriter(),r=(async()=>(await n.write(encodeMessageStreamEvent(stampMessageStreamEvent(sessionFailed({code:`session_stranded`,details:{trigger:t},message:`This session is no longer available.`,sessionId:e,usage:void 0})))),await n.close(),!0))();r.catch(()=>{});let i,a=new Promise(e=>{i=setTimeout(()=>e(!1),5e3)});try{await Promise.race([r,a])||log.warn(`Timed out finishing the stranded session stream`,{sessionId:e})}catch{log.warn(`Could not finish the stranded session stream`,{sessionId:e})}finally{clearTimeout(i),n.releaseLock()}}async function cancelRuns(e,t,n){for(let r of new Set(t))try{await cancelRun(e,r,{cancelReason:n})}catch(e){if(!isInactiveWorkflowRunError(e))throw e}}async function resolveStrandedSessionId(e){let{attributes:t,runId:n}=e.ownerRun,r=t[EVE_SESSION_ATTRIBUTE];if(r!==void 0)return r;if(e.hook!==void 0)try{return requireSessionId(await e.hook.metadata)}catch{}if(t[EVE_TYPE_ATTRIBUTE]!==void 0)return n;throw Error(`Cannot reset stranded session owner run "${n}": it does not record which session it serves. Cancel the run directly.`)}async function listOwnedSessionTokens(e,t){let n=[],r;for(let i=0;i<10;i++){let i=await e.hooks.list({pagination:{cursor:r,limit:100},resolveData:`none`,runId:t});for(let e of i.data){let t=logicalSessionInboxToken(e.token);t!==void 0&&n.push(t)}if(!i.hasMore||i.cursor===null)break;r=i.cursor}return n}export{endStrandedSession};
+import{emptySessionView,foldReceivedEvent}from"#protocol/session-projection/fold.js";import{createLogger}from"#internal/logging.js";import{logicalSessionInboxToken,sessionCommandHookToken,sessionInboxHookToken}from"#execution/session-inbox/address.js";import{resolveInstalledPackageInfo}from"#internal/application/package.js";import{encodeLine}from"#protocol/session-events/envelope.js";import{isInactiveWorkflowRunError}from"#internal/workflow/is-inactive-workflow-run-error.js";import{cancelRun,getRun,getWorld}from"#internal/workflow/runtime.js";import{streamSessionEvents}from"#execution/session-event-stream.js";import{logicalSessionToken,requireSessionId}from"#execution/session-inbox/resume.js";import{findSessionHookHolder}from"#execution/session-inbox/owner.js";import{principalOf}from"#execution/session/delivery-facts.js";import{cascade}from"#harness/session-machine/cascade.js";import{EVE_SESSION_ATTRIBUTE,EVE_TYPE_ATTRIBUTE}from"#execution/eve-workflow-attributes.js";import{waitForSessionHooksRelease}from"#execution/session-inbox/hook-release.js";const log=createLogger(`execution.session-inbox`);function strandedEndPolicy(e){return`stranded-${e}`}async function endStrandedSession(e,t,n,r){if(n===`reset`&&r===void 0)throw Error(`A stranded reset requires its control delivery identity.`);let i=typeof t==`string`?await resolveStrandedSessionId(e):t.sessionId,{ownerRunId:a}=e,o=await getWorld();await assertStillServesSession(i,a);let s=await listOwnedSessionTokens(o,a);return await publishTerminalEvent(i,n,r),await cancelRuns(o,[a,i],`Session ended: its deployment was retired`),await waitForSessionHooksRelease([sessionCommandHookToken(i),logicalSessionToken(t),...s],{ownerRunId:a,sessionId:i}),log.warn(`Reset stranded session`,{currentEveVersion:resolveInstalledPackageInfo().version,previousEveVersion:e.eveVersion??`unknown`,previousSessionId:i,trigger:n}),i}async function assertStillServesSession(e,t){let n=await findSessionHookHolder(sessionInboxHookToken(sessionCommandHookToken(e)));if(n!==void 0&&n.runId!==t)throw Error(`Session "${e}" changed owners while it was being reset. Nothing was ended; retry the request.`)}async function publishTerminalEvent(e,t,n){let r=await readRecordedView(e);if(r===void 0)return;let i=getRun(e).getWritable().getWriter(),a=(async()=>{let e={data:{cause:n===void 0?{policy:strandedEndPolicy(t)}:{deliveryId:n.deliveryId},error:{code:`session_stranded`,message:`This session is no longer available.`},outcome:`failed`},type:`session.ended`},a=[];if(n!==void 0){let e=principalOf(n.auth);a.push({type:`delivery.admitted`,data:{deliveryId:n.deliveryId,source:{control:`reset`},...e!==void 0&&{principal:e}}},{type:`delivery.settled`,data:{deliveryId:n.deliveryId,outcome:`applied`}})}return a.push(e),await i.write(new TextEncoder().encode(encodeLine({at:new Date().toISOString(),facts:cascade(r,a)}))),await i.close(),!0})();a.catch(()=>{});let o,s=new Promise(e=>{o=setTimeout(()=>e(!1),5e3)});try{await Promise.race([a,s])||log.warn(`Timed out finishing the stranded session stream`,{sessionId:e})}catch{log.warn(`Could not finish the stranded session stream`,{sessionId:e})}finally{clearTimeout(o),i.releaseLock()}}async function readRecordedView(e){let t=emptySessionView(),n=new AbortController,r=(async()=>{for await(let r of streamSessionEvents(e,{follow:!1,signal:n.signal}))foldReceivedEvent(t,r)})();r.catch(()=>{});let i,a=new Promise(e=>{i=setTimeout(()=>e(!1),3e4)}),o;try{o=!await Promise.race([r.then(()=>!0),a])}catch(t){log.warn(`Could not read the stranded session history`,{error:t,sessionId:e});return}finally{clearTimeout(i)}if(o)throw n.abort(),Error(`Timed out reading the history of stranded session "${e}". Nothing was ended; retry the request.`);return t}async function cancelRuns(e,t,n){for(let r of new Set(t))try{await cancelRun(e,r,{cancelReason:n})}catch(e){if(!isInactiveWorkflowRunError(e))throw e}}async function resolveStrandedSessionId(e){let{attributes:t,runId:n}=e.ownerRun,r=t[EVE_SESSION_ATTRIBUTE];if(r!==void 0)return r;if(e.hook!==void 0)try{return requireSessionId(await e.hook.metadata)}catch{}if(t[EVE_TYPE_ATTRIBUTE]!==void 0)return n;throw Error(`Cannot reset stranded session owner run "${n}": it does not record which session it serves. Cancel the run directly.`)}async function listOwnedSessionTokens(e,t){let n=[],r;for(let i=0;i<10;i++){let i=await e.hooks.list({pagination:{cursor:r,limit:100},resolveData:`none`,runId:t});for(let e of i.data){let t=logicalSessionInboxToken(e.token);t!==void 0&&n.push(t)}if(!i.hasMore||i.cursor===null)break;r=i.cursor}return n}export{endStrandedSession,strandedEndPolicy};

package/dist/src/execution/session-inbox/inbox.js

@@ -1 +1 @@
-import{sessionInboxHookToken}from"#execution/session-inbox/address.js";import{createHook,getWorkflowMetadata}from"#compiled/@workflow/core/index.js";import{claimHookOwnership,disposeHook,isHookForceClaimedError}from"#execution/hook-ownership.js";import{releaseSessionHooksStep}from"#execution/session-inbox/release-step.js";function isInterrupt(e){return e.kind===`cancel`||e.kind===`reset`||e.kind===`session-timeout`||e.kind===`session-failure`}function isDelivery(e){return e.kind===`send`||e.kind===`deliver`}function createSessionInbox(e){let t=[],n=[],r=new Set,i=new Set,a=new Set,o,s,c,l=new Set,u=new Set,d=!1,f=!1,notify=()=>{for(let e of r)e();r.clear()},wait=()=>new Promise(e=>r.add(e)),closed=()=>t.every(e=>e.closed||e.stopping),gated=()=>s!==void 0&&t.length>0,hasReadable=()=>!gated()&&n.length>0,throwIfFailed=()=>{if(o!==void 0)throw o.error},observe=(e,t,n)=>{for(let r of t)if(n(r))for(let t of e)t(r)},openHandover=()=>{s=void 0,observe(a,n,isDelivery),notify()},blockedOnHandover=()=>{if(gated()){for(let e of l)e();l.clear()}},acceptHandover=e=>{let t=s;if(t===void 0||e.attemptKey!==t.attemptKey||e.index<t.nextPart||t.parts.has(e.index))return;t.parts.set(e.index,e);let r=[];for(;;){let e=t.parts.get(t.nextPart);if(e===void 0)break;if(e.final===!0){c={attemptKey:t.attemptKey,payloadCount:t.nextPart,appliedAtMs:Date.now()},observe(i,r,isInterrupt),openHandover();return}t.parts.delete(t.nextPart),t.nextPart+=1,n.splice(t.index,0,...e.payloads),t.index+=e.payloads.length,r.push(...e.payloads)}observe(i,r,isInterrupt),notify()},pump=async e=>{let r=e.hook[Symbol.asyncIterator]();try{for(;!e.stopping;){let e=await r.next();if(e.done)break;let t=e.value;for(let e of u)e();if(u.clear(),t.kind===`workflow-batch`){n.push(...t.messages),notify();continue}if(t.kind===`handover`){acceptHandover(t);continue}n.push(t),gated()||observe(a,[t],isDelivery),observe(i,[t],isInterrupt),notify()}}catch(n){if(e.stopping||e.replaced)return;isHookForceClaimedError(n)?(t.splice(t.indexOf(e),1),d=!0):o={error:n}}finally{e.closed=!0,notify()}},stop=async()=>{let e=t.splice(0);s=void 0,d=!1,f=!0;for(let t of e)t.stopping=!0;notify(),await Promise.all(e.map(({hook:e})=>disposeHook(e)));let r=n.splice(0);return notify(),r},claimSessionHook=async(n,r={})=>{if(!n)throw Error(`A session alias requires a nonempty continuation token.`);let i=r.force===!0,a=t.find(e=>e.token===n);if(a!==void 0&&!i)return await a.registered;if(a===void 0&&t.length>=256)throw Error(`A session may claim at most 256 addresses.`);let o={token:n,hook:createHook({token:sessionInboxHookToken(n),metadata:{sessionId:e},...i&&{experimental_force:!0}}),stopping:!1,closed:!1,replaced:!1};a===void 0?t.push(o):(a.replaced=!0,t.splice(t.indexOf(a),1,o)),f=!1;try{let confirm=()=>claimHookOwnership(o.hook);o.registered=r.confirmAfter?.then(confirm,confirm)??confirm(),await o.registered,d=!1,pump(o)}catch(e){throw a===void 0||a.closed?t.splice(t.indexOf(o),1):(a.replaced=!1,t.splice(t.indexOf(o),1,a)),e}};return{get handoverObservation(){return c},get claimedTokens(){return t.map(({token:e})=>e)},get awaitingHandover(){return s!==void 0},async whenHandoverSettled(){for(;s!==void 0;)await wait()},abandonHandover(e){s?.attemptKey===e&&openHandover()},whenBlockedOnHandover(){return new Promise(e=>l.add(e))},whenArrival(){return new Promise(e=>u.add(e))},get takenOver(){return d&&t.length===0},claimSessionHook,async claimSessionHooks(e,t={}){t.handover!==void 0&&(s={attemptKey:t.handover,index:n.length,nextPart:0,parts:new Map});let r=await Promise.allSettled([...new Set(e)].map(e=>claimSessionHook(e,t)));for(let e of r)if(e.status===`rejected`)throw e.reason},async whenTakenOver(e){for(e?.addEventListener(`abort`,notify,{once:!0});t.length>0||!d;){if(throwIfFailed(),f)throw Error(`The session inbox was released before a takeover.`);if(e?.aborted===!0)throw e.reason;await wait()}},async next(){for(;;){if(throwIfFailed(),hasReadable())return n.shift();if(closed())return;blockedOnHandover(),await wait()}},drain(){return throwIfFailed(),gated()?[]:n.splice(0)},takeLeading(e){throwIfFailed();let t=[];if(gated())return t;for(let r=n[0];r!==void 0&&e(r);r=n[0])t.push(r),n.shift();return t},hasPending(){return throwIfFailed(),hasReadable()},async whenPending(){for(;o===void 0&&!hasReadable()&&!closed();)blockedOnHandover(),await wait()},onInterrupt(e){return i.add(e),()=>i.delete(e)},onDelivery(e){if(a.add(e),!gated())for(let t of n)isDelivery(t)&&e(t);return()=>a.delete(e)},restore(e){if(t.length===0)throw Error(`Cannot restore session commands before reclaiming the session hooks.`);n.unshift(...e),s!==void 0&&(s.index+=e.length),notify()},async dispose(){await stop()},async release(){return t.length>0&&await releaseSessionHooksStep({ownerRunId:getWorkflowMetadata().workflowRunId,tokens:t.map(({hook:e})=>e.token)}),await stop()}}}function isWorkflowMessage(e){return e.kind===`agent-started`||e.kind===`started`||e.kind===`report`||e.kind===`reply`||e.kind===`request`||e.kind===`withdraw`||e.kind===`usage`||e.kind===`outcome`}export{createSessionInbox,isInterrupt,isWorkflowMessage};
+import{SESSION_INBOX_SESSION_ID_METADATA_KEY,sessionInboxHookToken}from"#execution/session-inbox/address.js";import{createHook,getWorkflowMetadata}from"#compiled/@workflow/core/index.js";import{claimHookOwnership,disposeHook,isHookForceClaimedError}from"#execution/hook-ownership.js";import{releaseSessionHooksStep}from"#execution/session-inbox/release-step.js";function isInterrupt(e){return e.kind===`cancel`||e.kind===`reset`||e.kind===`session-timeout`||e.kind===`session-failure`}function isDelivery(e){return e.kind===`send`||e.kind===`deliver`}function createSessionInbox(e){let t=[],n=[],r=new Set,i=new Set,a=new Set,o,s,c,l=new Set,u=new Set,d=!1,f=!1,notify=()=>{for(let e of r)e();r.clear()},wait=()=>new Promise(e=>r.add(e)),closed=()=>t.every(e=>e.closed||e.stopping),gated=()=>s!==void 0&&t.length>0,hasReadable=()=>!gated()&&n.length>0,throwIfFailed=()=>{if(o!==void 0)throw o.error},observe=(e,t,n)=>{for(let r of t)if(n(r))for(let t of e)t(r)},openHandover=()=>{s=void 0,observe(a,n,isDelivery),notify()},blockedOnHandover=()=>{if(gated()){for(let e of l)e();l.clear()}},acceptHandover=e=>{let t=s;if(t===void 0||e.attemptKey!==t.attemptKey||e.index<t.nextPart||t.parts.has(e.index))return;t.parts.set(e.index,e);let r=[];for(;;){let e=t.parts.get(t.nextPart);if(e===void 0)break;if(e.final===!0){c={attemptKey:t.attemptKey,payloadCount:t.nextPart,appliedAtMs:Date.now()},observe(i,r,isInterrupt),openHandover();return}t.parts.delete(t.nextPart),t.nextPart+=1,n.splice(t.index,0,...e.payloads),t.index+=e.payloads.length,r.push(...e.payloads)}observe(i,r,isInterrupt),notify()},pump=async e=>{let r=e.hook[Symbol.asyncIterator]();try{for(;!e.stopping;){let e=await r.next();if(e.done)break;let t=e.value;for(let e of u)e();if(u.clear(),t.kind===`workflow-batch`){n.push(...t.messages),notify();continue}if(t.kind===`handover`){acceptHandover(t);continue}n.push(t),gated()||observe(a,[t],isDelivery),observe(i,[t],isInterrupt),notify()}}catch(n){if(e.stopping||e.replaced)return;isHookForceClaimedError(n)?(t.splice(t.indexOf(e),1),d=!0):o={error:n}}finally{e.closed=!0,notify()}},stop=async()=>{let e=t.splice(0);s=void 0,d=!1,f=!0;for(let t of e)t.stopping=!0;notify(),await Promise.all(e.map(({hook:e})=>disposeHook(e)));let r=n.splice(0);return notify(),r},claimSessionHook=async(n,r={})=>{if(!n)throw Error(`A session alias requires a nonempty continuation token.`);let i=r.force===!0,a=t.find(e=>e.token===n);if(a!==void 0&&!i)return await a.registered;if(a===void 0&&t.length>=256)throw Error(`A session may claim at most 256 addresses.`);let o={token:n,hook:createHook({token:sessionInboxHookToken(n),metadata:{[SESSION_INBOX_SESSION_ID_METADATA_KEY]:e},...i&&{experimental_force:!0}}),stopping:!1,closed:!1,replaced:!1};a===void 0?t.push(o):(a.replaced=!0,t.splice(t.indexOf(a),1,o)),f=!1;try{let confirm=()=>claimHookOwnership(o.hook);o.registered=r.confirmAfter?.then(confirm,confirm)??confirm(),await o.registered,d=!1,pump(o)}catch(e){throw a===void 0||a.closed?t.splice(t.indexOf(o),1):(a.replaced=!1,t.splice(t.indexOf(o),1,a)),e}};return{get handoverObservation(){return c},get claimedTokens(){return t.map(({token:e})=>e)},get awaitingHandover(){return s!==void 0},async whenHandoverSettled(){for(;s!==void 0;)await wait()},abandonHandover(e){s?.attemptKey===e&&openHandover()},whenBlockedOnHandover(){return new Promise(e=>l.add(e))},whenArrival(){return new Promise(e=>u.add(e))},get takenOver(){return d&&t.length===0},claimSessionHook,async claimSessionHooks(e,t={}){t.handover!==void 0&&(s={attemptKey:t.handover,index:n.length,nextPart:0,parts:new Map});let r=await Promise.allSettled([...new Set(e)].map(e=>claimSessionHook(e,t)));for(let e of r)if(e.status===`rejected`)throw e.reason},async whenTakenOver(e){for(e?.addEventListener(`abort`,notify,{once:!0});t.length>0||!d;){if(throwIfFailed(),f)throw Error(`The session inbox was released before a takeover.`);if(e?.aborted===!0)throw e.reason;await wait()}},async next(){for(;;){if(throwIfFailed(),hasReadable())return n.shift();if(closed())return;blockedOnHandover(),await wait()}},drain(){return throwIfFailed(),gated()?[]:n.splice(0)},takeLeading(e){throwIfFailed();let t=[];if(gated())return t;for(let r=n[0];r!==void 0&&e(r);r=n[0])t.push(r),n.shift();return t},hasPending(){return throwIfFailed(),hasReadable()},async whenPending(){for(;o===void 0&&!hasReadable()&&!closed();)blockedOnHandover(),await wait()},onInterrupt(e){return i.add(e),()=>i.delete(e)},onDelivery(e){if(a.add(e),!gated())for(let t of n)isDelivery(t)&&e(t);return()=>a.delete(e)},restore(e){if(t.length===0)throw Error(`Cannot restore session commands before reclaiming the session hooks.`);n.unshift(...e),s!==void 0&&(s.index+=e.length),notify()},async dispose(){await stop()},async release(){return t.length>0&&await releaseSessionHooksStep({ownerRunId:getWorkflowMetadata().workflowRunId,tokens:t.map(({hook:e})=>e.token)}),await stop()}}}function isWorkflowMessage(e){return e.kind===`agent-started`||e.kind===`agent-sent`||e.kind===`started`||e.kind===`report`||e.kind===`reply`||e.kind===`request`||e.kind===`withdraw`||e.kind===`usage`||e.kind===`outcome`}export{createSessionInbox,isInterrupt,isWorkflowMessage};

package/dist/src/execution/session-inbox/owner.d.ts

@@ -28,8 +28,11 @@ export declare function resumeRunnableHook(token: string, payload: unknown): Pro
  * deployment, every owner can execute, so nothing is looked up.
  */
 export declare function assertRunnableSessionInbox(token: string): Promise<void>;
-/** {@link assertRunnableSessionInbox} for a hook the caller already looked up. */
-export declare function assertRunnableSessionOwner(hook: Hook): Promise<void>;
+/** {@link assertRunnableSessionInbox} for a holder the caller already looked up. */
+export declare function assertRunnableSessionOwner(holder: {
+    readonly runId: string;
+    readonly hook?: Hook;
+}): Promise<void>;
 /**
  * The run holding a session hook token, or `undefined` when none does. The
  * `eve dev` World refuses to expose the hooks of a run it will not execute

package/dist/src/execution/session-inbox/owner.js

@@ -1 +1 @@
-import{isSessionInboxHookToken}from"#execution/session-inbox/address.js";import{getHookByToken,getWorld,resumeHook}from"#internal/workflow/runtime.js";import{HookNotFoundError}from"#compiled/@workflow/errors/index.js";import{EVE_VERSION_ATTRIBUTE}from"#execution/eve-workflow-attributes.js";import{findRetiredOwnerRun,routesToOwnerDeployment}from"#execution/session-inbox/runnable-owner.js";import{DevelopmentRunUnavailableError}from"#internal/workflow/development-run-unavailable-error.js";var StrandedSessionOwnerError=class extends Error{hook;ownerRun;constructor(e,t){super(`Session owner run "${e.runId}" is stranded.`),this.name=`StrandedSessionOwnerError`,this.hook=t,this.ownerRun=e}get ownerRunId(){return this.ownerRun.runId}get eveVersion(){return this.ownerRun.attributes[EVE_VERSION_ATTRIBUTE]}};async function resumeRunnableHook(e,t){return isSessionInboxHookToken(e)&&await assertRunnableSessionInbox(e),await resumeHook(e,t)}async function assertRunnableSessionInbox(e){let t=await getWorld();if(routesToOwnerDeployment(t))return;let n=await findSessionHookHolder(e);n!==void 0&&await assertRunnableOwner(t,n.runId,n.hook)}async function assertRunnableSessionOwner(e){let t=await getWorld();routesToOwnerDeployment(t)||await assertRunnableOwner(t,e.runId,e)}async function findSessionHookHolder(e){try{let t=await getHookByToken(e);return{hook:t,runId:t.runId}}catch(e){if(HookNotFoundError.is(e))return;if(DevelopmentRunUnavailableError.is(e))return{runId:e.runId};throw e}}async function lookupSessionOwnerHook(e){try{return await getHookByToken(e)}catch(e){throw DevelopmentRunUnavailableError.is(e)&&await assertRunnableOwner(await getWorld(),e.runId),e}}async function assertRunnableOwner(e,t,n){let r=await findRetiredOwnerRun(e,t);if(r!==void 0)throw new StrandedSessionOwnerError(r,n)}export{StrandedSessionOwnerError,assertRunnableSessionInbox,assertRunnableSessionOwner,findSessionHookHolder,lookupSessionOwnerHook,resumeRunnableHook};
+import{isSessionInboxHookToken}from"#execution/session-inbox/address.js";import{getHookByToken,getWorld,resumeHook}from"#internal/workflow/runtime.js";import{HookNotFoundError}from"#compiled/@workflow/errors/index.js";import{EVE_VERSION_ATTRIBUTE}from"#execution/eve-workflow-attributes.js";import{findRetiredOwnerRun,routesToOwnerDeployment}from"#execution/session-inbox/runnable-owner.js";import{DevelopmentRunUnavailableError}from"#internal/workflow/development-run-unavailable-error.js";var StrandedSessionOwnerError=class extends Error{hook;ownerRun;constructor(e,t){super(`Session owner run "${e.runId}" is stranded.`),this.name=`StrandedSessionOwnerError`,this.hook=t,this.ownerRun=e}get ownerRunId(){return this.ownerRun.runId}get eveVersion(){return this.ownerRun.attributes[EVE_VERSION_ATTRIBUTE]}};async function resumeRunnableHook(e,t){return isSessionInboxHookToken(e)&&await assertRunnableSessionInbox(e),await resumeHook(e,t)}async function assertRunnableSessionInbox(e){let t=await getWorld();if(routesToOwnerDeployment(t))return;let n=await findSessionHookHolder(e);n!==void 0&&await assertRunnableOwner(t,n.runId,n.hook)}async function assertRunnableSessionOwner(e){let t=await getWorld();routesToOwnerDeployment(t)||await assertRunnableOwner(t,e.runId,e.hook)}async function findSessionHookHolder(e){try{let t=await getHookByToken(e);return{hook:t,runId:t.runId}}catch(e){if(HookNotFoundError.is(e))return;if(DevelopmentRunUnavailableError.is(e))return{runId:e.runId};throw e}}async function lookupSessionOwnerHook(e){try{return await getHookByToken(e)}catch(e){throw DevelopmentRunUnavailableError.is(e)&&await assertRunnableOwner(await getWorld(),e.runId),e}}async function assertRunnableOwner(e,t,n){let r=await findRetiredOwnerRun(e,t);if(r!==void 0)throw new StrandedSessionOwnerError(r,n)}export{StrandedSessionOwnerError,assertRunnableSessionInbox,assertRunnableSessionOwner,findSessionHookHolder,lookupSessionOwnerHook,resumeRunnableHook};

package/dist/src/execution/session-inbox/pre-v27.d.ts

@@ -0,0 +1,5 @@
+import type { DeliverPayload } from "#channel/types.js";
+/** The command with each payload's answers also under the name a pre-v27 owner reads. */
+export declare function withPreV27Answers<T>(command: T): T;
+/** The payload without the pre-v27 alias, which v27 code never reads. */
+export declare function withoutPreV27Answers(payload: DeliverPayload): DeliverPayload;

package/dist/src/execution/session-inbox/pre-v27.js

@@ -0,0 +1 @@
+const PRE_V27_ANSWERS_KEY=`inputResponses`;function withPreV27Answers(e){let t=e;return t.kind===`send`&&isPayload(t.payload)?{...e,payload:withAnswersAlias(t.payload)}:t.kind===`deliver`&&Array.isArray(t.payloads)?{...e,payloads:t.payloads.map(withAnswersAlias)}:e}function withoutPreV27Answers(e){if(!(PRE_V27_ANSWERS_KEY in e))return e;let{[PRE_V27_ANSWERS_KEY]:t,...n}=e;return n}function withAnswersAlias(e){return e.answers===void 0||e.answers.length===0?e:{...e,[PRE_V27_ANSWERS_KEY]:e.answers.map(e=>{let t={requestId:e.interactionId};return e.optionId!==void 0&&(t.optionId=e.optionId),e.text!==void 0&&(t.text=e.text),t})}}function isPayload(e){return typeof e==`object`&&!!e}export{withPreV27Answers,withoutPreV27Answers};

package/dist/src/execution/session-inbox/protocol.js

@@ -1 +1 @@
-import{validateDeliveryIdempotencyKey}from"#channel/delivery-idempotency.js";var SessionInboxPayloadError=class extends Error{constructor(e){super(e),this.name=`SessionInboxPayloadError`}};function decodeSessionInboxPayload(e){if(typeof e!=`object`||!e||!(`kind`in e))throw new SessionInboxPayloadError(`Session inbox payload must be an object with a kind.`);let t=e;if(t.kind===`send`||t.kind===`deliver`)try{validateDeliveryIdempotencyKey(t.idempotencyKey)}catch(e){throw new SessionInboxPayloadError(e.message)}switch(t.kind){case`send`:{if(t.payload===null||typeof t.payload!=`object`)throw new SessionInboxPayloadError(`Session send payload must be an object.`);let n=e;return{idempotencyKey:n.idempotencyKey,auth:n.auth,schedule:n.schedule,title:n.title,caller:n.caller,deliveryMetadata:n.delivery===void 0?void 0:[{...n.delivery,payloadIndex:0}],kind:`deliver`,payloads:[n.payload],requestId:n.requestId,turnPolicy:n.turnPolicy}}case`deliver`:if(!Array.isArray(t.payloads))throw new SessionInboxPayloadError(`Session delivery payloads must be an array.`);return e;case`session-prewarm`:if(typeof t.expectedOwnerRunId!=`string`||typeof t.targetDeploymentId!=`string`||t.targetDeploymentId.length===0||t.targetDeploymentId===`latest`)throw new SessionInboxPayloadError(`Invalid session prewarm hint.`);return e;case`cancel`:case`clear`:case`compact`:case`reset`:case`session-timeout`:return e;default:throw new SessionInboxPayloadError(`Unsupported session inbox payload kind ${JSON.stringify(t.kind)}.`)}}export{SessionInboxPayloadError,decodeSessionInboxPayload};
+import{validateDeliveryIdempotencyKey}from"#channel/delivery-idempotency.js";import{withoutPreV27Answers}from"#execution/session-inbox/pre-v27.js";var SessionInboxPayloadError=class extends Error{constructor(e){super(e),this.name=`SessionInboxPayloadError`}};function decodeSessionInboxPayload(e){if(typeof e!=`object`||!e||!(`kind`in e))throw new SessionInboxPayloadError(`Session inbox payload must be an object with a kind.`);let t=e;if(t.kind===`send`||t.kind===`deliver`)try{validateDeliveryIdempotencyKey(t.idempotencyKey)}catch(e){throw new SessionInboxPayloadError(e.message)}switch(t.kind){case`send`:{if(t.payload===null||typeof t.payload!=`object`)throw new SessionInboxPayloadError(`Session send payload must be an object.`);let n=e;return{idempotencyKey:n.idempotencyKey,auth:n.auth,schedule:n.schedule,title:n.title,caller:n.caller,deliveryMetadata:n.delivery===void 0?void 0:[{...n.delivery,payloadIndex:0}],kind:`deliver`,payloads:[withoutPreV27Answers(n.payload)],requestId:n.requestId,turnPolicy:n.turnPolicy}}case`deliver`:{if(!Array.isArray(t.payloads))throw new SessionInboxPayloadError(`Session delivery payloads must be an array.`);let n=e;return{...n,payloads:n.payloads.map(withoutPreV27Answers)}}case`session-prewarm`:if(typeof t.expectedOwnerRunId!=`string`||typeof t.targetDeploymentId!=`string`||t.targetDeploymentId.length===0||t.targetDeploymentId===`latest`)throw new SessionInboxPayloadError(`Invalid session prewarm hint.`);return e;case`cancel`:case`clear`:case`compact`:case`reset`:if(typeof t.deliveryId!=`string`||t.deliveryId.length===0)throw new SessionInboxPayloadError(`Session controls require a nonempty deliveryId.`);return e;case`session-timeout`:return e;default:throw new SessionInboxPayloadError(`Unsupported session inbox payload kind ${JSON.stringify(t.kind)}.`)}}export{SessionInboxPayloadError,decodeSessionInboxPayload};

package/dist/src/execution/session-inbox/resume.js

@@ -1 +1 @@
-import{isObject}from"#shared/guards.js";import{SESSION_INBOX_SESSION_ID_METADATA_KEY,isSessionInboxAddress,sessionCommandHookToken,sessionHandoffMarkerToken,sessionInboxHookToken}from"#execution/session-inbox/address.js";import{getHookByToken}from"#internal/workflow/runtime.js";import{HookNotFoundError}from"#compiled/@workflow/errors/index.js";import{assertRunnableSessionOwner,lookupSessionOwnerHook,resumeRunnableHook}from"#execution/session-inbox/owner.js";import{UnsupportedLegacySessionError,resolveLegacyInbox,resumeLegacyInbox}from"#execution/legacy-session/inbox.js";async function resumeSessionInbox(e,t){let n=logicalSessionToken(e),r=typeof e==`string`?void 0:e.sessionId,i=Date.now()+5e3;for(;;){let e;try{e=await resumeRunnableHook(sessionInboxHookToken(n),t)}catch(e){if(!HookNotFoundError.is(e))throw e;if(await waitWhileHandoffInProgress(n,i))continue;if(t.kind===`session-failure`||t.kind===`session-prewarm`)throw e;return await resumeLegacyInbox(n,t).catch(rethrowUnsupportedAsNotFound)}let a;return{ownerRunId:e.runId,get sessionId(){return a??=(async()=>{try{return r??requireSessionId(await e.metadata)}catch(e){throw new AcceptedSessionIdentityError(e)}})()}}}}var SessionHandoffPendingError=class extends Error{constructor(e){super(`Session address "${e}" is still changing owners. Nothing was delivered; retry the request.`),this.name=`SessionHandoffPendingError`}},AcceptedSessionIdentityError=class extends Error{constructor(e){super(`Session command accepted, but its session identity could not be resolved.`,{cause:e}),this.name=`AcceptedSessionIdentityError`}};function requireSessionId(e){let t=isObject(e)?e[SESSION_INBOX_SESSION_ID_METADATA_KEY]:void 0;if(typeof t!=`string`||t.length===0)throw Error(`Session hook metadata is missing its session ID.`);return t}async function resolveSessionInbox(e){try{return{sessionId:requireSessionId(await(await getHookByToken(sessionInboxHookToken(e))).metadata)}}catch(t){if(!HookNotFoundError.is(t))throw t;return{sessionId:(await resolveLegacyInbox(e)).sessionId}}}function rethrowUnsupportedAsNotFound(e){throw e instanceof UnsupportedLegacySessionError?new HookNotFoundError(e.message):e}function logicalSessionToken(e){if(typeof e==`string`)return e;if(!isSessionInboxAddress(e))throw Error(`Session inbox target has an invalid address.`);return sessionCommandHookToken(e.sessionId)}async function waitWhileHandoffInProgress(e,t){let n;try{n=await lookupSessionOwnerHook(sessionHandoffMarkerToken(e))}catch(e){if(HookNotFoundError.is(e))return!1;throw e}if(Date.now()>=t)throw await assertRunnableSessionOwner(n),new SessionHandoffPendingError(e);return await new Promise(e=>setTimeout(e,20)),!0}export{AcceptedSessionIdentityError,SessionHandoffPendingError,logicalSessionToken,requireSessionId,resolveSessionInbox,resumeSessionInbox};
+import{isObject}from"#shared/guards.js";import{SESSION_INBOX_SESSION_ID_METADATA_KEY,isSessionInboxAddress,sessionCommandHookToken,sessionHandoffMarkerToken,sessionInboxHookToken}from"#execution/session-inbox/address.js";import{getHookByToken}from"#internal/workflow/runtime.js";import{HookNotFoundError}from"#compiled/@workflow/errors/index.js";import{assertRunnableSessionOwner,lookupSessionOwnerHook,resumeRunnableHook}from"#execution/session-inbox/owner.js";import{withPreV27Answers}from"#execution/session-inbox/pre-v27.js";import{UnsupportedLegacySessionError,resolveLegacyInbox,resumeLegacyInbox}from"#execution/legacy-session/inbox.js";async function resumeSessionInbox(e,t){t=withPreV27Answers(t);let n=logicalSessionToken(e),r=typeof e==`string`?void 0:e.sessionId,i=Date.now()+5e3;for(;;){let e;try{e=await resumeRunnableHook(sessionInboxHookToken(n),t)}catch(e){if(!HookNotFoundError.is(e))throw e;if(await waitWhileHandoffInProgress(n,i))continue;if(t.kind===`session-failure`||t.kind===`session-prewarm`)throw e;return await resumeLegacyInbox(n,t).catch(rethrowUnsupportedAsNotFound)}let a;return{ownerRunId:e.runId,get sessionId(){return a??=(async()=>{try{return r??requireSessionId(await e.metadata)}catch(e){throw new AcceptedSessionIdentityError(e)}})()}}}}var SessionHandoffPendingError=class extends Error{constructor(e){super(`Session address "${e}" is still changing owners. Nothing was delivered; retry the request.`),this.name=`SessionHandoffPendingError`}},AcceptedSessionIdentityError=class extends Error{constructor(e){super(`Session command accepted, but its session identity could not be resolved.`,{cause:e}),this.name=`AcceptedSessionIdentityError`}};function requireSessionId(e){let t=isObject(e)?e[SESSION_INBOX_SESSION_ID_METADATA_KEY]:void 0;if(typeof t!=`string`||t.length===0)throw Error(`Session hook metadata is missing its session ID.`);return t}async function resolveSessionInbox(e){try{return{sessionId:requireSessionId(await(await getHookByToken(sessionInboxHookToken(e))).metadata)}}catch(t){if(!HookNotFoundError.is(t))throw t;return{sessionId:(await resolveLegacyInbox(e)).sessionId}}}function rethrowUnsupportedAsNotFound(e){throw e instanceof UnsupportedLegacySessionError?new HookNotFoundError(e.message):e}function logicalSessionToken(e){if(typeof e==`string`)return e;if(!isSessionInboxAddress(e))throw Error(`Session inbox target has an invalid address.`);return sessionCommandHookToken(e.sessionId)}async function waitWhileHandoffInProgress(e,t){let n;try{n=await lookupSessionOwnerHook(sessionHandoffMarkerToken(e))}catch(e){if(HookNotFoundError.is(e))return!1;throw e}if(Date.now()>=t)throw await assertRunnableSessionOwner({hook:n,runId:n.runId}),new SessionHandoffPendingError(e);return await new Promise(e=>setTimeout(e,20)),!0}export{AcceptedSessionIdentityError,SessionHandoffPendingError,logicalSessionToken,requireSessionId,resolveSessionInbox,resumeSessionInbox};

package/dist/src/execution/session-inbox/stranded-replay-guard.js

@@ -1 +1 @@
-import{createLogger}from"#internal/logging.js";import{resolveInstalledPackageInfo}from"#internal/application/package.js";import{cancelRun}from"#internal/workflow/runtime.js";import{isInactiveWorkflowRunError,isMissingWorkflowRunError}from"#internal/workflow/is-inactive-workflow-run-error.js";import{EVE_TYPE_ATTRIBUTE,EVE_VERSION_ATTRIBUTE}from"#execution/eve-workflow-attributes.js";import{findRetiredOwnerRun,routesToOwnerDeployment}from"#execution/session-inbox/runnable-owner.js";import{WORKFLOW_ENTRY_NAME,WORKFLOW_TOOL_RUN_WORKFLOW_NAME}from"#execution/stable-workflow-names.js";const log=createLogger(`execution.session-inbox.stranded-replay-guard`);function guardStrandedSessionReplay(e){if(routesToOwnerDeployment(e))return e;let{name:t}=resolveInstalledPackageInfo(),n=new Map([[`workflow//${t}//${WORKFLOW_ENTRY_NAME}`,`session`],[`workflow//${t}//${WORKFLOW_TOOL_RUN_WORKFLOW_NAME}`,`tool`]]),r=e.createQueueHandler.bind(e);return e.createQueueHandler=(t,i)=>r(t,async(r,a)=>{let o=n.get(a.queueName.slice(t.length)),s=readRunId(r);if(!(o!==void 0&&s!==void 0&&await skipRetiredRun(e,s,o)))return await i(r,a)}),e}async function skipRetiredRun(e,t,n){let r=await readRetiredRun(e,t);if(r===void 0)return!1;switch(strandedReplayAction(r,n)){case`replay`:return!1;case`retire`:return await retireRun(e,r),!0;case`park`:return logParkedSession(r),!0}}function strandedReplayAction(e,t){return e.status!==`pending`&&e.status!==`running`?`replay`:t===`tool`||e.attributes[EVE_TYPE_ATTRIBUTE]===`subagent`?`retire`:`park`}async function readRetiredRun(e,t){try{return await findRetiredOwnerRun(e,t)}catch(e){if(isMissingWorkflowRunError(e))return;throw e}}async function retireRun(e,t){try{await cancelRun(e,t.runId,{cancelReason:`Run retired: its eve deployment is no longer available`})}catch(e){if(!isInactiveWorkflowRunError(e))throw e}log.warn(`Retired stranded descendant run`,{runId:t.runId,previousEveVersion:t.attributes[EVE_VERSION_ATTRIBUTE]??`unknown`,currentEveVersion:resolveInstalledPackageInfo().version})}function logParkedSession(e){log.warn(`Skipping replay of stranded session run "${e.runId}" (owner eve ${e.attributes[EVE_VERSION_ATTRIBUTE]??`unknown`}, current ${resolveInstalledPackageInfo().version}). It remains active until an ordinary channel message, an explicit reset, or its session timeout ends it.`)}function readRunId(e){if(typeof e!=`object`||!e||`__healthCheck`in e)return;let t=e.runId;return typeof t==`string`&&t.length>0?t:void 0}export{guardStrandedSessionReplay};
+import{createLogger}from"#internal/logging.js";import{resolveInstalledPackageInfo}from"#internal/application/package.js";import{isInactiveWorkflowRunError,isMissingWorkflowRunError}from"#internal/workflow/is-inactive-workflow-run-error.js";import{cancelRun}from"#internal/workflow/runtime.js";import{EVE_TYPE_ATTRIBUTE,EVE_VERSION_ATTRIBUTE}from"#execution/eve-workflow-attributes.js";import{findRetiredOwnerRun,routesToOwnerDeployment}from"#execution/session-inbox/runnable-owner.js";import{WORKFLOW_ENTRY_NAME,WORKFLOW_TOOL_RUN_WORKFLOW_NAME}from"#execution/stable-workflow-names.js";const log=createLogger(`execution.session-inbox.stranded-replay-guard`);function guardStrandedSessionReplay(e){if(routesToOwnerDeployment(e))return e;let{name:t}=resolveInstalledPackageInfo(),n=new Map([[`workflow//${t}//${WORKFLOW_ENTRY_NAME}`,`session`],[`workflow//${t}//${WORKFLOW_TOOL_RUN_WORKFLOW_NAME}`,`tool`]]),r=e.createQueueHandler.bind(e);return e.createQueueHandler=(t,i)=>r(t,async(r,a)=>{let o=n.get(a.queueName.slice(t.length)),s=readRunId(r);if(!(o!==void 0&&s!==void 0&&await skipRetiredRun(e,s,o)))return await i(r,a)}),e}async function skipRetiredRun(e,t,n){let r=await readRetiredRun(e,t);if(r===void 0)return!1;switch(strandedReplayAction(r,n)){case`replay`:return!1;case`retire`:return await retireRun(e,r),!0;case`park`:return logParkedSession(r),!0}}function strandedReplayAction(e,t){return e.status!==`pending`&&e.status!==`running`?`replay`:t===`tool`||e.attributes[EVE_TYPE_ATTRIBUTE]===`subagent`?`retire`:`park`}async function readRetiredRun(e,t){try{return await findRetiredOwnerRun(e,t)}catch(e){if(isMissingWorkflowRunError(e))return;throw e}}async function retireRun(e,t){try{await cancelRun(e,t.runId,{cancelReason:`Run retired: its eve deployment is no longer available`})}catch(e){if(!isInactiveWorkflowRunError(e))throw e}log.warn(`Retired stranded descendant run`,{runId:t.runId,previousEveVersion:t.attributes[EVE_VERSION_ATTRIBUTE]??`unknown`,currentEveVersion:resolveInstalledPackageInfo().version})}function logParkedSession(e){log.warn(`Skipping replay of stranded session run "${e.runId}" (owner eve ${e.attributes[EVE_VERSION_ATTRIBUTE]??`unknown`}, current ${resolveInstalledPackageInfo().version}). It remains active until an ordinary channel message, an explicit reset, or its session timeout ends it.`)}function readRunId(e){if(typeof e!=`object`||!e||`__healthCheck`in e)return;let t=e.runId;return typeof t==`string`&&t.length>0?t:void 0}export{guardStrandedSessionReplay};

package/dist/src/execution/session-workflow-tool-run.js

@@ -1 +1 @@
-import{findBlockingWorkflowToolRun,isInboxToolResultFromRecordedWorkflowToolRun}from"#harness/workflow-tool-runs.js";import{isWorkflowMessage}from"#execution/session-inbox/inbox.js";import{runMessageBatchBudget}from"#execution/tools/workflow/messages.js";import{isTaskRunMessage}from"#execution/tasks/session.js";import{deliverWorkflowAuthorization}from"#execution/tools/workflow/owner.js";import{withdrawFinishedRunQuestionsStep,withdrawWorkflowToolRunQuestionStep}from"#execution/tools/workflow/withdraw-step.js";import{workflowToolRunOutcomeToToolResult,workflowToolRunRequestToInputRequestPayload}from"#execution/tools/workflow/owner-inbox.js";import{runProxySubagentEventStep}from"#subagents/event-proxy-step.js";function isAppliedRunMessage(e){return e.kind===`agent-started`||e.kind===`report`||isTaskRunMessage(e)}function takeLeadingAppliedRunMessages(e,t=runMessageBatchBudget()){return e.takeLeading(e=>isWorkflowMessage(e)&&isAppliedRunMessage(e)&&t(e))}async function handleWorkflowToolRunMessage(e){let{message:t}=e;switch(t.kind){case`started`:case`reply`:case`usage`:return;case`outcome`:return await handleWorkflowToolRunOutcome({...e,message:t});case`request`:await handleWorkflowToolRunRequest({...e,message:t});return;case`withdraw`:await handleWorkflowToolRunWithdraw({...e,message:t});return}}async function handleWorkflowToolRunOutcome(e){let{cursor:t,message:n}=e,r=t.sessionState.snapshot.session.state;if(findBlockingWorkflowToolRun(r,n.from.callId,n.from.turnId)?.address.runId!==n.from.runId)return;let i=workflowToolRunOutcomeToToolResult(n);if(isInboxToolResultFromRecordedWorkflowToolRun(r,i)){if(t.sessionState.hasProxyInputRequests){let{runId:e}=n.from;await t.advance(t=>withdrawFinishedRunQuestionsStep({...t,runId:e}))}return i}}async function handleWorkflowToolRunRequest(e){let{cursor:t,message:n}=e;if(n.request.kind===`authorization-request`){let e=n.request;await deliverWorkflowAuthorization({...n,request:e},async()=>{await t.advance(t=>runProxySubagentEventStep({hookPayload:e.event,...t}))});return}await t.advance(e=>runProxySubagentEventStep({...n.request.kind===`ask`&&{workflowAsk:createWorkflowAskRoute(n.request)},hookPayload:workflowToolRunRequestToInputRequestPayload(n),runId:n.from.runId,...e}))}async function handleWorkflowToolRunWithdraw(e){let{cursor:t,message:n}=e;await t.advance(e=>withdrawWorkflowToolRunQuestionStep({...e,control:n.control,requestId:n.replyTo,runId:n.from.runId}))}function createWorkflowAskRoute(e){return{control:e.control}}export{handleWorkflowToolRunMessage,isAppliedRunMessage,takeLeadingAppliedRunMessages};
+import{storedProjection}from"#harness/session-machine/view.js";import{isActiveTaskRun,readTaskTable}from"#execution/tasks/table.js";import{isWorkflowMessage}from"#execution/session-inbox/inbox.js";import{isAgentSessionMessage,runMessageBatchBudget}from"#execution/tools/workflow/messages.js";import{findBlockingWorkflowToolRun,isInboxToolResultFromRecordedWorkflowToolRun}from"#harness/workflow-tool-runs.js";import{isTaskRunMessage}from"#execution/tasks/session.js";import{deliverWorkflowRelay}from"#execution/tools/workflow/owner.js";import{withdrawFinishedRunQuestionsStep,withdrawWorkflowToolRunQuestionStep}from"#execution/tools/workflow/withdraw-step.js";import{workflowAskPayload,workflowToolRunOutcomeToToolResult}from"#execution/tools/workflow/owner-inbox.js";import{runProxySubagentEventStep}from"#subagents/event-proxy-step.js";function isAppliedRunMessage(e){return isAgentSessionMessage(e)||e.kind===`report`||isTaskRunMessage(e)}function takeLeadingAppliedRunMessages(e,t=runMessageBatchBudget()){return e.takeLeading(e=>isWorkflowMessage(e)&&isAppliedRunMessage(e)&&t(e))}async function handleWorkflowToolRunMessage(e){let{message:t}=e;switch(t.kind){case`started`:case`reply`:case`usage`:return;case`outcome`:return await handleWorkflowToolRunOutcome({...e,message:t});case`request`:await handleWorkflowToolRunRequest({...e,message:t});return;case`withdraw`:await handleWorkflowToolRunWithdraw({...e,message:t});return}}async function handleWorkflowToolRunOutcome(e){let{cursor:t,message:n}=e,r=t.sessionState.snapshot.session.state;if(findBlockingWorkflowToolRun(r,n.from.callId,n.from.turnId)?.address.runId!==n.from.runId)return;let i=workflowToolRunOutcomeToToolResult(n);if(isInboxToolResultFromRecordedWorkflowToolRun(r,i)){if(t.sessionState.hasProxyInputRequests){let{runId:e}=n.from;await t.advance(t=>withdrawFinishedRunQuestionsStep({...t,runId:e}))}return i}}async function handleWorkflowToolRunRequest(e){let{cursor:t,message:n}=e,{runId:r,taskId:i}=n.from,a=t.sessionState.snapshot.session.state;if(i!==void 0&&(!isActiveTaskRun(readTaskTable(a),i,r)||storedProjection(a).view?.tasks[i]?.status===`ended`))return;let{request:o}=n;if(o.kind===`relay`){await deliverWorkflowRelay({...n,request:o},async()=>{await t.advance(e=>runProxySubagentEventStep({hookPayload:o.event,runId:r,...e}))});return}await t.advance(e=>runProxySubagentEventStep({hookPayload:workflowAskPayload({...n,request:o}),runId:r,workflowAsk:createWorkflowAskRoute(o),...e}))}async function handleWorkflowToolRunWithdraw(e){let{cursor:t,message:n}=e;await t.advance(e=>withdrawWorkflowToolRunQuestionStep({...e,control:n.control,requestId:n.replyTo,runId:n.from.runId}))}function createWorkflowAskRoute(e){return{control:e.control}}export{handleWorkflowToolRunMessage,isAppliedRunMessage,takeLeadingAppliedRunMessages};

package/dist/src/execution/session.d.ts

@@ -1,25 +1,14 @@
 import type { DurableSession } from "#execution/durable-session-store.js";
-import type { HarnessSession, HarnessSessionBase } from "#harness/types.js";
+import type { CompactionConfig, CompactionState, HarnessSession, HarnessSessionBase } from "#harness/types.js";
 import type { RuntimeTurnAgent } from "#runtime/agent/bootstrap.js";
 /**
  * Creates the durable compaction configuration used by one harness session.
  */
 export declare function createCompactionConfig(input?: {
     readonly contextWindowTokens?: number;
-    readonly lastKnownInputTokens?: number;
-    readonly lastKnownPromptMessageCount?: number;
+    readonly previous?: CompactionState;
     readonly thresholdPercent?: number;
-}): {
-    recentWindowSize: number;
-    threshold: number;
-    thresholdPercent: number;
-} | {
-    recentWindowSize: number;
-    threshold: number;
-    thresholdPercent: number;
-    lastKnownInputTokens: number;
-    lastKnownPromptMessageCount: number | undefined;
-};
+}): CompactionConfig;
 interface CreateSessionInput {
     readonly continuationToken: string;
     readonly compactionOverrides?: {

package/dist/src/execution/session.js

@@ -1,3 +1,3 @@
-import{formatAvailableSkillsSection}from"#execution/skills/instructions.js";function createCompactionConfig(e={}){let t=e.thresholdPercent??.9,n={recentWindowSize:10,threshold:e.contextWindowTokens===void 0?1e5:Math.max(1,Math.floor(e.contextWindowTokens*t)),thresholdPercent:t};return e.lastKnownInputTokens===void 0?n:{...n,lastKnownInputTokens:e.lastKnownInputTokens,lastKnownPromptMessageCount:e.lastKnownPromptMessageCount}}function createSession(e){let{turnAgent:t}=e,n=createSessionToolDefinitions(t),r={agent:createSessionAgent(t,createSessionSystemPrompt(t),n),compaction:createCompactionConfig({contextWindowTokens:t.model?.contextWindowTokens,thresholdPercent:e.compactionOverrides?.thresholdPercent}),continuationToken:e.continuationToken,history:[...t.initialMessages??[]],sessionId:e.sessionId};return e.rootSessionId!==void 0&&(r.rootSessionId=e.rootSessionId),e.outputSchema!==void 0&&(r.outputSchema=e.outputSchema),r}function createSessionAgent(e,t,n){let r={compactionModelReference:e.compactionModel,reasoning:e.reasoning,system:t,tools:n};if(e.model!==void 0)return{...r,modelReference:e.model};if(e.dynamicModel!==void 0)return{...r,dynamicModel:!0};throw Error(`Cannot create a session before dynamic subagent config is selected.`)}function refreshSessionFromTurnAgent(e){return{...e.session,agent:createSessionAgent(e.turnAgent,createSessionSystemPrompt(e.turnAgent),createSessionToolDefinitions(e.turnAgent)),compaction:createCompactionConfig({contextWindowTokens:e.turnAgent.model?.contextWindowTokens,lastKnownInputTokens:e.session.compaction.lastKnownInputTokens,lastKnownPromptMessageCount:e.session.compaction.lastKnownPromptMessageCount,thresholdPercent:e.compactionOverrides?.thresholdPercent})}}function createSessionSystemPrompt(e){let t=formatAvailableSkillsSection(e.listedSkills??[]);return(t===null?e.instructions:[...e.instructions,t]).join(`
+import{formatAvailableSkillsSection}from"#execution/skills/instructions.js";function createCompactionConfig(e={}){let t=e.thresholdPercent??.9,n=e.contextWindowTokens===void 0?1e5:Math.max(1,Math.floor(e.contextWindowTokens*t));return{...e.previous,recentWindowSize:10,threshold:n,thresholdPercent:t}}function createSession(e){let{turnAgent:t}=e,n=createSessionToolDefinitions(t),r={agent:createSessionAgent(t,createSessionSystemPrompt(t),n),compaction:createCompactionConfig({contextWindowTokens:t.model?.contextWindowTokens,thresholdPercent:e.compactionOverrides?.thresholdPercent}),continuationToken:e.continuationToken,history:[...t.initialMessages??[]],sessionId:e.sessionId};return e.rootSessionId!==void 0&&(r.rootSessionId=e.rootSessionId),e.outputSchema!==void 0&&(r.outputSchema=e.outputSchema),r}function createSessionAgent(e,t,n){let r={compactionModelReference:e.compactionModel,reasoning:e.reasoning,system:t,tools:n};if(e.model!==void 0)return{...r,modelReference:e.model};if(e.dynamicModel!==void 0)return{...r,dynamicModel:!0};throw Error(`Cannot create a session before dynamic subagent config is selected.`)}function refreshSessionFromTurnAgent(e){return{...e.session,agent:createSessionAgent(e.turnAgent,createSessionSystemPrompt(e.turnAgent),createSessionToolDefinitions(e.turnAgent)),compaction:createCompactionConfig({contextWindowTokens:e.turnAgent.model?.contextWindowTokens,previous:e.session.compaction,thresholdPercent:e.compactionOverrides?.thresholdPercent})}}function createSessionSystemPrompt(e){let t=formatAvailableSkillsSection(e.listedSkills??[]);return(t===null?e.instructions:[...e.instructions,t]).join(`
 
-`)}function mintSubagentContinuationToken(e){return`subagent:${e??crypto.randomUUID()}`}function projectToDurableSession(e){let t={agent:{system:e.agent.system},continuationToken:e.continuationToken,sessionId:e.sessionId};return(e.compaction.lastKnownInputTokens!==void 0||e.compaction.lastKnownPromptMessageCount!==void 0)&&(t.compaction={lastKnownInputTokens:e.compaction.lastKnownInputTokens,lastKnownPromptMessageCount:e.compaction.lastKnownPromptMessageCount}),e.rootSessionId!==void 0&&(t.rootSessionId=e.rootSessionId),e.outputSchema!==void 0&&(t.outputSchema=e.outputSchema),e.sandboxState!==void 0&&(t.sandboxState=e.sandboxState),e.state!==void 0&&(t.state=e.state),t}function hydrateDurableSession(e){let{durable:t,turnAgent:n}=e,r=createSessionToolDefinitions(n),i={agent:createSessionAgent(n,t.agent.system,r),compaction:createCompactionConfig({contextWindowTokens:n.model?.contextWindowTokens,lastKnownInputTokens:t.compaction?.lastKnownInputTokens,lastKnownPromptMessageCount:t.compaction?.lastKnownPromptMessageCount,thresholdPercent:e.compactionOverrides?.thresholdPercent}),continuationToken:t.continuationToken,sessionId:t.sessionId};return t.rootSessionId!==void 0&&(i.rootSessionId=t.rootSessionId),t.outputSchema!==void 0&&(i.outputSchema=t.outputSchema),t.sandboxState!==void 0&&(i.sandboxState=t.sandboxState),t.state!==void 0&&(i.state=t.state),i}function createSessionToolDefinitions(e){return e.tools.map(e=>({description:e.description??``,inputSchema:e.inputSchema,name:e.name,outputSchema:e.outputSchema}))}export{createCompactionConfig,createSession,hydrateDurableSession,mintSubagentContinuationToken,projectToDurableSession,refreshSessionFromTurnAgent};
+`)}function mintSubagentContinuationToken(e){return`subagent:${e??crypto.randomUUID()}`}function projectToDurableSession(e){let{threshold:t,thresholdPercent:n,recentWindowSize:r,...i}=e.compaction;return{agent:{system:e.agent.system},continuationToken:e.continuationToken,sessionId:e.sessionId,...Object.values(i).some(e=>e!==void 0)&&{compaction:i},...e.rootSessionId!==void 0&&{rootSessionId:e.rootSessionId},...e.outputSchema!==void 0&&{outputSchema:e.outputSchema},...e.sandboxState!==void 0&&{sandboxState:e.sandboxState},...e.state!==void 0&&{state:e.state}}}function hydrateDurableSession(e){let{durable:t,turnAgent:n}=e,{agent:r,compaction:i,...a}=t;return{...a,agent:createSessionAgent(n,r.system,createSessionToolDefinitions(n)),compaction:createCompactionConfig({contextWindowTokens:n.model?.contextWindowTokens,previous:i,thresholdPercent:e.compactionOverrides?.thresholdPercent})}}function createSessionToolDefinitions(e){return e.tools.map(e=>({description:e.description??``,inputSchema:e.inputSchema,name:e.name,outputSchema:e.outputSchema}))}export{createCompactionConfig,createSession,hydrateDurableSession,mintSubagentContinuationToken,projectToDurableSession,refreshSessionFromTurnAgent};

package/dist/src/execution/settle-cancelled-turn-step.d.ts

@@ -2,6 +2,7 @@ import type { DurableSessionState } from "#execution/durable-session-store.js";
 import { type SessionHistoryStepState } from "#execution/publish-session-events.js";
 import { type WithSessionStateDelta } from "#execution/session/state-delta.js";
 import type { HarnessModelMessage } from "#harness/messages.js";
+import type { ControlDelivery } from "#harness/types.js";
 import type { TokenUsage } from "#shared/token-usage.js";
 export interface CancelledTurnSettleResult {
     readonly serializedContext: Record<string, unknown>;
@@ -17,6 +18,8 @@ interface CancelledTurnSettleInput extends SessionHistoryStepState {
      * reported; otherwise the next settled turn reports it.
      */
     readonly reportUsage: boolean;
+    /** The cancel control that stopped the turn, when it named its delivery. */
+    readonly control?: ControlDelivery;
 }
 /**
  * Settles one cancelled turn through the machine's `cancel`, and persists

package/dist/src/execution/settle-cancelled-turn-step.js

@@ -1 +1 @@
-import{currentProjection}from"#harness/session-machine/current.js";import{runtimeWait,storedProjection}from"#harness/session-machine/view.js";import{getTurnUsageState,takeSessionUsageDelta}from"#harness/turn-tag-state.js";import{removeBlockingWorkflowToolRuns}from"#harness/workflow-tool-runs.js";import{retireCancelledCandidates}from"#harness/hitl/index.js";import{publishFromSessionStep,restoreSessionStep}from"#execution/publish-session-events.js";import{withSessionStateDelta}from"#execution/session/state-delta.js";import{cancel}from"#harness/session-machine/transitions.js";import{applyTransition,sessionView}from"#harness/session-machine/commit.js";async function settleCancelledTurnStep(e){"use step";return await withSessionStateDelta(e,settleCancelledTurn)}async function settleCancelledTurn(e){let t={...await restoreSessionStep(e),history:e.history},n=t.durableSession.state,r=runtimeWait(n)?.event.turnId??storedProjection(n).activeTurnId??``,{published:i,result:a}=await publishFromSessionStep(t,{origin:`own`,publish:(e,n)=>applyTransition(n,cancel(sessionView(currentProjection(t.ctx),n.state)),e),updateSession(t,n){let i=removeBlockingWorkflowToolRuns(retireCancelledCandidates({...n,outputSchema:void 0}),r);if(!e.reportUsage||getTurnUsageState(n.state)===void 0)return{session:i};let a=takeSessionUsageDelta(i);return{result:a.delta,session:a.session}}});return a===void 0?i:{...i,usage:a}}export{settleCancelledTurn,settleCancelledTurnStep};
+import{runtimeWait,storedProjection}from"#harness/session-machine/view.js";import{publishFromSessionStep,restoreSessionStep}from"#execution/publish-session-events.js";import"#execution/session/state-delta.js";import{withSessionStateDelta}from"#execution/session/step-state-delta.js";import{applyTransition,saveTransition,sessionView}from"#harness/session-machine/commit.js";import{cancel,controlled}from"#harness/session-machine/transitions.js";import{sessionUsage,takeSessionUsageDelta}from"#harness/session-usage.js";import{activeTurnIdOf}from"#protocol/session-projection.js";import{removeBlockingWorkflowToolRuns}from"#harness/workflow-tool-runs.js";async function settleCancelledTurnStep(e){"use step";return await withSessionStateDelta(e,settleCancelledTurn)}async function settleCancelledTurn(e){let t={...await restoreSessionStep(e),history:e.history},n=t.durableSession.state,r=runtimeWait(n)?.event.turnId??activeTurnIdOf(storedProjection(n))??``,i=controlled(e.control,`cancel`,e=>cancel(sessionView(storedProjection(n),n),{cause:e})),{published:a,result:o}=await publishFromSessionStep(t,{origin:`own`,publish:(e,t)=>applyTransition(t,i,e),updateSession(t,n){let a=n??saveTransition(t,i),o=removeBlockingWorkflowToolRuns({...a,outputSchema:void 0},r),s=sessionUsage(a),c=s.inputTokens+s.outputTokens+s.cacheReadTokens+s.cacheWriteTokens===0&&s.costUsd===void 0;if(!e.reportUsage||c)return{session:o};let l=takeSessionUsageDelta(o);return{result:l.delta,session:l.session}}});return o===void 0?a:{...a,usage:o}}export{settleCancelledTurn,settleCancelledTurnStep};

package/dist/src/execution/stop-runs.d.ts

@@ -0,0 +1,35 @@
+import type { WorkflowToolRunControlMessage } from "#execution/tools/workflow/messages.js";
+import type { WorkflowToolRunAddress } from "#execution/tools/workflow/types.js";
+import type { SessionStateMap } from "#harness/types.js";
+/** How a run is told to stop: `end` also finishes a `serve` task's run, which a cancel keeps. */
+export type RunStop = Extract<WorkflowToolRunControlMessage, {
+    readonly kind: "cancel" | "end";
+}>;
+/** One run to stop. */
+export interface RunStopTarget {
+    readonly run: WorkflowToolRunAddress;
+    /**
+     * Whether the stop ends the run. A resumable task's cancel stops only its current stretch of
+     * work, and its run stays parked for later calls, so nothing waits for it to end.
+     */
+    readonly ends: boolean;
+}
+/**
+ * The workflow tool runs the session's turn waits on; each run is one call, which a cancel ends.
+ * A cancel still commits when they can't be read, so it stops none of them.
+ */
+export declare function waitedCallRuns(session: {
+    readonly sessionId: string;
+    readonly state?: SessionStateMap;
+}): RunStopTarget[];
+/**
+ * Stops runs, the same way whoever stops them: each is told to stop, and a run that couldn't be
+ * told, such as one that hasn't registered its control hook yet, is cancelled outright. By default
+ * a run the stop ends gets until the deadline to finish cleaning up, and one still running then is
+ * cancelled outright too. With `waitForEnd: false` nothing waits: a told run that never finishes
+ * is not cancelled here, and keeps running until it ends on its own or its session ends.
+ * Returns the runs cancelled outright, which never report how they ended.
+ */
+export declare function stopRuns(targets: readonly RunStopTarget[], stop: RunStop, options?: {
+    readonly waitForEnd?: boolean;
+}): Promise<readonly string[]>;

package/dist/src/execution/stop-runs.js

@@ -0,0 +1 @@
+import{createLogger,logError}from"#internal/logging.js";import{runtimeWait,storedProjection,turnPosition}from"#harness/session-machine/view.js";import{cancelRun,getRun,getWorld,resumeHook}from"#internal/workflow/runtime.js";import{getBlockingWorkflowToolRuns}from"#harness/workflow-tool-runs.js";import{WORKFLOW_CANCELLATION_SETTLE_MS}from"#execution/tools/workflow/cancellation-policy.js";import{isTaskWorkflowTargetGone}from"#execution/tasks/workflow-target.js";const log=createLogger(`execution.stop-runs`);function waitedCallRuns(e){try{let t=runtimeWait(e.state)?.event.turnId??turnPosition(storedProjection(e.state)).turnId;return getBlockingWorkflowToolRuns(e.state,t).map(e=>({ends:!0,run:e.address}))}catch(t){return logError(log,`failed to read the workflow tool calls a cancelled turn waits on`,t,{sessionId:e.sessionId}),[]}}async function stopRuns(e,t,n={}){let r=(await Promise.all(e.map(async e=>({target:e,told:await tell(e.run,t)})))).filter(({target:e})=>e.ends),i=n.waitForEnd===!1?[]:await runsStillRunning(r.filter(({told:e})=>e).map(({target:e})=>e.run.runId)),a=r.filter(({told:e})=>!e).map(({target:e})=>e.run.runId);return(await Promise.all([...a,...i].map(async e=>await cancelOutright(e,t.reason)?[e]:[]))).flat()}async function tell(e,t){try{return await resumeHook(e.hookToken,t),!0}catch(t){return isTaskWorkflowTargetGone(t)||logError(log,`failed to tell a run to stop; cancelling it outright`,t,{runId:e.runId}),!1}}async function runsStillRunning(e){let t=e,n=Date.now()+WORKFLOW_CANCELLATION_SETTLE_MS;for(;t.length>0&&Date.now()<n;)t=(await Promise.all(t.map(async e=>({runId:e,live:await isRunLive(e)})))).filter(({live:e})=>e).map(({runId:e})=>e),t.length>0&&await new Promise(e=>setTimeout(e,250));return t}async function isRunLive(e){try{let t=await getRun(e).status;return t===`pending`||t===`running`}catch(e){return!isTaskWorkflowTargetGone(e)}}async function cancelOutright(e,t){try{return await cancelRun(await getWorld(),e,{cancelReason:t}),!0}catch(t){return isTaskWorkflowTargetGone(t)||logError(log,`failed to cancel a run; it may run to completion`,t,{runId:e}),!1}}export{stopRuns,waitedCallRuns};

package/dist/src/execution/tasks/model-step.d.ts

@@ -1,4 +1,4 @@
-import type { ModelMessage, SystemModelMessage } from "ai";
+import type { SystemModelMessage } from "ai";
 import type { HarnessToolDefinition } from "#harness/execute-tool.js";
 import { type HarnessModelMessage } from "#harness/messages.js";
 import type { HarnessSession, HarnessToolMap } from "#harness/types.js";
@@ -10,13 +10,10 @@ export declare function isWorkflowTool(definition: HarnessToolDefinition | undef
 /** Adds `eve__task_wait` and `eve__task_cancel` to the tools of a session that offers tasks. */
 export declare function withTaskTools(tools: HarnessToolMap): HarnessToolMap;
 /**
- * The task block, when the session offers tasks. `finalReplyOnly` is set for a
- * child or schedule session, which hides a held turn's text, so a reply before
- * a result would reach no one.
+ * The task block, when the session offers tasks. `finalReplyOnly` is set for a child or schedule
+ * session, whose caller reads only the final reply, so a reply before a result reaches no one.
  */
-export declare function taskSystemMessages(offers: boolean, options: {
-    readonly finalReplyOnly: boolean;
-}): SystemModelMessage[];
+export declare function taskSystemMessages(offers: boolean, finalReplyOnly: boolean): SystemModelMessage[];
 /** A workflow tool call as the model made it, before the session knows what it enters. */
 export interface WorkflowCall {
     readonly callId: string;
@@ -45,11 +42,10 @@ export declare function workingTaskIds(session: HarnessSession): readonly string
  * `task.result` message with every settled result, then the
  * `[Tasks]` note when the listing changed. The results are marked delivered
  * in the same step. The message lives only in the model's history: clients
- * read outcomes from `task.settled`.
+ * read outcomes from `call.settled`.
  */
 export declare function appendTaskContext(input: {
     readonly messages: readonly HarnessModelMessage[];
-    readonly projectHistory: (messages: readonly ModelMessage[], state: HarnessSession["state"]) => readonly ModelMessage[];
     readonly session: HarnessSession;
     readonly tools: HarnessToolMap;
 }): Promise<{

package/dist/src/execution/tasks/model-step.js

@@ -1 +1 @@
-import{TASK_CANCEL_TOOL_NAME,TASK_WAIT_TOOL_NAME}from"#protocol/task-tools.js";import{createFrameworkUserMessage}from"#harness/messages.js";import{FINAL_REPLY_TASK_SYSTEM_BLOCK,TASKS_NOTE_LABEL,TASK_SYSTEM_BLOCK,renderModelOutputText,renderTaskResults,renderTasksNote}from"#execution/tasks/render.js";import{entryPointOf,isAgentTool}from"#execution/tasks/tool-entry-point.js";import{createTask,idleTasks,readTaskTable,takeTaskResults,workingTasks,writeTaskTable}from"#execution/tasks/table.js";import{observeToolOutput}from"#tool-stubs/execute.js";import{splitTaskIdInput}from"#execution/tasks/task-id-input.js";import{taskCancelTool}from"#tools/provided/task-cancel.js";import{taskWaitTool}from"#tools/provided/task-wait.js";function isTaskTool(e){return e?.frameworkAction===`task-wait`||e?.frameworkAction===`task-cancel`}function isWorkflowTool(e){return e?.workflowId!==void 0||isTaskTool(e)}function withTaskTools(e){return new Map([...e,[TASK_WAIT_TOOL_NAME,taskWaitTool],[TASK_CANCEL_TOOL_NAME,taskCancelTool]])}function taskSystemMessages(e,t){return e?[{content:t.finalReplyOnly?FINAL_REPLY_TASK_SYSTEM_BLOCK:TASK_SYSTEM_BLOCK,role:`system`}]:[]}function commitCallEntry(e,t){let n=entryPointOf(t.definition);switch(n){case`execute`:return{entry:{entryPoint:n},input:t.input,session:e};case`task`:return commitTask(e,t,n,t.input);case`serve`:{let{input:r,taskId:i}=splitTaskIdInput(t.input);return i===void 0?commitTask(e,t,n,r):{entry:{entryPoint:`receive`,taskId:i},input:r,session:e}}}}function commitTask(e,t,n,r){let i=createTask(readTaskTable(e.state),{callId:t.callId,kind:isAgentTool(t.definition)?`agent`:`tool`,name:t.toolName,resumable:n===`serve`,turnId:t.turnId});return{entry:{entryPoint:n,taskId:i.taskId},input:r,session:writeTaskTable(e,i.table)}}function workingTaskIds(e){return workingTasks(readTaskTable(e.state)).map(e=>e.id)}async function appendTaskContext(e){let t=[],n=await deliverTaskResults(e);n.message!==void 0&&t.push(createFrameworkUserMessage(`task.result`,n.message));let r=resolveTasksNote({messages:e.projectHistory([...e.messages,...t],n.session.state),session:n.session});return r!==void 0&&t.push(createFrameworkUserMessage(`context.state`,r)),{messages:t,session:n.session}}async function deliverTaskResults(e){let{table:t,taken:n}=takeTaskResults(readTaskTable(e.session.state));if(n.length===0)return{session:e.session};let r=[];for(let t of n)for(let n of t.results)r.push(await toResultBlock(t,n,e.tools.get(t.name)));return{message:renderTaskResults(r),session:writeTaskTable(e.session,t)}}async function toResultBlock(e,t,n){let r={taskId:e.id,tool:e.name};return t.status===`failed`?{...r,body:t.error,status:`failed`}:{...r,body:await projectOutput(e.name,t,n),status:`completed`}}async function projectOutput(e,t,n){return n?.toModelOutput===void 0?renderModelOutputText(t.output):await observeToolOutput(e,t.calls??[],async()=>renderModelOutputText(await n.toModelOutput(t.output)),()=>renderModelOutputText(t.output))}function resolveTasksNote(e){let t=readTaskTable(e.session.state),n=workingTasks(t).map(toListedTask),r=idleTasks(t).map(toListedTask),i=e.messages.findLast(isTasksNote);if(i===void 0&&n.length===0&&r.length===0)return;let a=renderTasksNote({idle:r,working:n});return i?.content===a?void 0:a}function toListedTask(e){return{id:e.id,tool:e.name}}function isTasksNote(e){return e.role===`user`&&typeof e.content==`string`&&e.content.startsWith(TASKS_NOTE_LABEL)}export{appendTaskContext,commitCallEntry,isTaskTool,isWorkflowTool,taskSystemMessages,withTaskTools,workingTaskIds};
+import{TASK_CANCEL_TOOL_NAME,TASK_WAIT_TOOL_NAME}from"#protocol/task-tools.js";import{FINAL_REPLY_TASK_SYSTEM_BLOCK,TASKS_NOTE_LABEL,TASK_SYSTEM_BLOCK,renderModelOutputText,renderTaskResults,renderTasksNote}from"#execution/tasks/render.js";import{createFrameworkUserMessage}from"#harness/messages.js";import{entryPointOf,isAgentTool}from"#execution/tasks/tool-entry-point.js";import{createTask,idleTasks,readTaskTable,takeTaskResults,workingTasks,writeTaskTable}from"#execution/tasks/table.js";import{observeToolOutput}from"#tool-stubs/execute.js";import{splitTaskIdInput}from"#execution/tasks/task-id-input.js";import{taskCancelTool}from"#tools/provided/task-cancel.js";import{taskWaitTool}from"#tools/provided/task-wait.js";function isTaskTool(e){return e?.frameworkAction===`task-wait`||e?.frameworkAction===`task-cancel`}function isWorkflowTool(e){return e?.workflowId!==void 0||isTaskTool(e)}function withTaskTools(e){return new Map([...e,[TASK_WAIT_TOOL_NAME,taskWaitTool],[TASK_CANCEL_TOOL_NAME,taskCancelTool]])}function taskSystemMessages(e,t){return e?[{content:t?FINAL_REPLY_TASK_SYSTEM_BLOCK:TASK_SYSTEM_BLOCK,role:`system`}]:[]}function commitCallEntry(e,t){let n=entryPointOf(t.definition);switch(n){case`execute`:return{entry:{entryPoint:n},input:t.input,session:e};case`task`:return commitTask(e,t,n,t.input);case`serve`:{let{input:r,taskId:i}=splitTaskIdInput(t.input);return i===void 0?commitTask(e,t,n,r):{entry:{entryPoint:`receive`,taskId:i},input:r,session:e}}}}function commitTask(e,t,n,r){let i=createTask(readTaskTable(e.state),{callId:t.callId,kind:isAgentTool(t.definition)?`agent`:`tool`,name:t.toolName,resumable:n===`serve`,turnId:t.turnId});return{entry:{entryPoint:n,taskId:i.taskId},input:r,session:writeTaskTable(e,i.table)}}function workingTaskIds(e){return workingTasks(readTaskTable(e.state)).map(e=>e.id)}async function appendTaskContext(e){let t=[],n=await deliverTaskResults(e);n.message!==void 0&&t.push(createFrameworkUserMessage(`task.result`,n.message));let r=resolveTasksNote({messages:[...e.messages,...t],session:n.session});return r!==void 0&&t.push(createFrameworkUserMessage(`context.state`,r)),{messages:t,session:n.session}}async function deliverTaskResults(e){let{table:t,taken:n}=takeTaskResults(readTaskTable(e.session.state));if(n.length===0)return{session:e.session};let r=[];for(let t of n)for(let n of t.results)r.push(await toResultBlock(t,n,e.tools.get(t.name)));return{message:renderTaskResults(r),session:writeTaskTable(e.session,t)}}async function toResultBlock(e,t,n){let r={taskId:e.id,tool:e.name};return t.status===`failed`?{...r,body:t.error,status:`failed`}:{...r,body:await projectOutput(e.name,t,n),status:`completed`}}async function projectOutput(e,t,n){return n?.toModelOutput===void 0?renderModelOutputText(t.output):await observeToolOutput(e,t.calls??[],async()=>renderModelOutputText(await n.toModelOutput(t.output)),()=>renderModelOutputText(t.output))}function resolveTasksNote(e){let t=readTaskTable(e.session.state),n=workingTasks(t).map(toListedTask),r=idleTasks(t).map(toListedTask),i=e.messages.findLast(isTasksNote);if(i===void 0&&n.length===0&&r.length===0)return;let a=renderTasksNote({idle:r,working:n});return i?.content===a?void 0:a}function toListedTask(e){return{id:e.id,tool:e.name}}function isTasksNote(e){return e.role===`user`&&typeof e.content==`string`&&e.content.startsWith(TASKS_NOTE_LABEL)}export{appendTaskContext,commitCallEntry,isTaskTool,isWorkflowTool,taskSystemMessages,withTaskTools,workingTaskIds};

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

@@ -1,11 +1,14 @@
 import type { TaskCancelResult, TaskWaitResult } from "#execution/tasks/calls.js";
 export declare const TASK_WAIT_DESCRIPTION = "Call eve__task_wait sparingly, only when you deliberately want to withhold a message from the user while waiting for a task result. Tasks keep running and their results reach you without calling eve__task_wait. If the user should hear from you now, reply instead. Wait silently until any of your tasks has a result, a new message arrives, or timeoutSeconds pass. It returns after the first result, which follows in a <task_result> message; wait again only if you still want to withhold a reply until another result arrives. Waiting never stops a task.";
 export declare const TASK_WAIT_TIMEOUT_DESCRIPTION = "Optional. Seconds to wait before returning without a result. Omit it to wait for a result or a new message, which is almost always right. Don't use short timeouts to check on tasks: results reach you without checking.";
-export declare const TASK_CANCEL_DESCRIPTION = "Stop a task's current work. That work never reports back; if it already had a result, that result is still delivered. An agent, or any task that accepts more input, stays available: call its tool with its taskId to give it new work.";
+export declare const TASK_CANCEL_DESCRIPTION = "Stop a task's current work. That work never reports back; if it already had a result, that result is still delivered. Cancelling an agent or one-shot task ends it; start a new task to delegate again. Other tasks that accept more input stay available: call their tool with the taskId to give them new work.";
 export declare const TASK_CANCEL_TASK_ID_DESCRIPTION = "The id of the task to stop, copied from its \"Started task\" receipt or the [Tasks] note.";
 /** The task block for a session a person reads, where a reply before a result is posted. */
 export declare const TASK_SYSTEM_BLOCK: string;
-/** The task block for a child or schedule session, whose caller reads only the final reply. */
+/**
+ * The task block for a child or schedule session, whose caller reads only the final reply: a held
+ * turn's text there is narration.
+ */
 export declare const FINAL_REPLY_TASK_SYSTEM_BLOCK: string;
 /** Appended to a `serve` tool's description. */
 export declare const SERVE_TOOL_DESCRIPTION = "To send this task more input, call this tool again with its taskId; without taskId, each call starts a new task.";

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

@@ -1,4 +1,4 @@
-import{TASK_CANCEL_TOOL_NAME,TASK_WAIT_TOOL_NAME}from"#protocol/task-tools.js";import{REPLY_TOOL_NAME}from"#protocol/reply-tool.js";import{formatDuration}from"#shared/format-duration.js";const TASK_WAIT_DESCRIPTION=`Call ${TASK_WAIT_TOOL_NAME} sparingly, only when you deliberately want to withhold a message from the user while waiting for a task result. Tasks keep running and their results reach you without calling ${TASK_WAIT_TOOL_NAME}. If the user should hear from you now, reply instead. Wait silently until any of your tasks has a result, a new message arrives, or timeoutSeconds pass. It returns after the first result, which follows in a <task_result> message; wait again only if you still want to withhold a reply until another result arrives. Waiting never stops a task.`,TASK_WAIT_TIMEOUT_DESCRIPTION=`Optional. Seconds to wait before returning without a result. Omit it to wait for a result or a new message, which is almost always right. Don't use short timeouts to check on tasks: results reach you without checking.`,TASK_CANCEL_DESCRIPTION=`Stop a task's current work. That work never reports back; if it already had a result, that result is still delivered. An agent, or any task that accepts more input, stays available: call its tool with its taskId to give it new work.`,TASK_ID_SOURCE=`copied from its "Started task" receipt or the [Tasks] note`,TASK_CANCEL_TASK_ID_DESCRIPTION=`The id of the task to stop, ${TASK_ID_SOURCE}.`,TASK_SYSTEM_BLOCK_OPENING=[`Tasks`,`- A call that returns "Started task <id>" is a task: it keeps working while you continue. Every agent call is a task.`,`- Each result arrives once, in a <task_result> message. Until then you know nothing about it, so don't guess or report its result.`,`- Ending your reply doesn't end your turn. While tasks work, eve holds your turn and calls you again with each result.`],TASK_SYSTEM_BLOCK_CLOSING=[`- Don't redo work you delegated. Never use sleep or shell commands to wait for a task.`,`- To correct or continue an agent, or any task that accepts more input, call its tool again with its taskId. A new message never stops your tasks: answer it if it asks you something, decide whether it changes the work, then keep each task, correct an agent by taskId, or stop a task with ${TASK_CANCEL_TOOL_NAME}.`],TASK_SYSTEM_BLOCK=[...TASK_SYSTEM_BLOCK_OPENING,`- If you have nothing to tell the person until a result arrives, call ${TASK_WAIT_TOOL_NAME}. Start every independent task first, then wait.`,`- If the person should hear from you now, for example to confirm work is underway when they don't need the result yet, reply. When results arrive, report them without repeating yourself.`,...TASK_SYSTEM_BLOCK_CLOSING].join(`
+import{TASK_CANCEL_TOOL_NAME,TASK_WAIT_TOOL_NAME}from"#protocol/task-tools.js";import{REPLY_TOOL_NAME}from"#protocol/reply-tool.js";import{formatDuration}from"#shared/format-duration.js";const TASK_WAIT_DESCRIPTION=`Call ${TASK_WAIT_TOOL_NAME} sparingly, only when you deliberately want to withhold a message from the user while waiting for a task result. Tasks keep running and their results reach you without calling ${TASK_WAIT_TOOL_NAME}. If the user should hear from you now, reply instead. Wait silently until any of your tasks has a result, a new message arrives, or timeoutSeconds pass. It returns after the first result, which follows in a <task_result> message; wait again only if you still want to withhold a reply until another result arrives. Waiting never stops a task.`,TASK_WAIT_TIMEOUT_DESCRIPTION=`Optional. Seconds to wait before returning without a result. Omit it to wait for a result or a new message, which is almost always right. Don't use short timeouts to check on tasks: results reach you without checking.`,TASK_CANCEL_DESCRIPTION=`Stop a task's current work. That work never reports back; if it already had a result, that result is still delivered. Cancelling an agent or one-shot task ends it; start a new task to delegate again. Other tasks that accept more input stay available: call their tool with the taskId to give them new work.`,TASK_ID_SOURCE=`copied from its "Started task" receipt or the [Tasks] note`,TASK_CANCEL_TASK_ID_DESCRIPTION=`The id of the task to stop, ${TASK_ID_SOURCE}.`,TASK_SYSTEM_BLOCK_OPENING=[`Tasks`,`- A call that returns "Started task <id>" is a task: it keeps working while you continue. Every agent call is a task.`,`- Each result arrives once, in a <task_result> message. Until then you know nothing about it, so don't guess or report its result.`,`- Ending your reply doesn't end your turn. While tasks work, eve holds your turn and calls you again with each result.`],TASK_SYSTEM_BLOCK_CLOSING=[`- Don't redo work you delegated. Never use sleep or shell commands to wait for a task.`,`- To correct or continue an agent, or any task that accepts more input, call its tool again with its taskId. A new message never stops your tasks: answer it if it asks you something, decide whether it changes the work, then keep each task, correct an agent by taskId, or stop a task with ${TASK_CANCEL_TOOL_NAME}.`],TASK_SYSTEM_BLOCK=[...TASK_SYSTEM_BLOCK_OPENING,`- If you have nothing to tell the person until a result arrives, call ${TASK_WAIT_TOOL_NAME}. Start every independent task first, then wait.`,`- If the person should hear from you now, for example to confirm work is underway when they don't need the result yet, reply. When results arrive, report them without repeating yourself.`,...TASK_SYSTEM_BLOCK_CLOSING].join(`
 `),FINAL_REPLY_TASK_SYSTEM_BLOCK=[...TASK_SYSTEM_BLOCK_OPENING,`- Only your final reply reaches your caller. While tasks work, call ${TASK_WAIT_TOOL_NAME} instead of replying. Start every independent task first, then wait.`,...TASK_SYSTEM_BLOCK_CLOSING].join(`
 `),SERVE_TOOL_DESCRIPTION=`To send this task more input, call this tool again with its taskId; without taskId, each call starts a new task.`,AGENT_SERVE_TOOL_DESCRIPTION=`It does not see this conversation, so put everything it needs in message. To correct or continue an agent task, call this tool again with its taskId; without taskId, each call starts a new agent.`,TASK_ID_INPUT_DESCRIPTION=`The id of a task this tool started, ${TASK_ID_SOURCE}, to send it this input. Omit it to start a new task.`,TASKS_NOTE_LABEL=`[Tasks]`,TASK_RESULT_TAG=`<task_result`,UNREADABLE_TASK_ERROR=`The task's state could not be read.`;function renderTaskReceipt(e){let t=`Started task ${e.id}. Its result will arrive in a <task_result> message.`;return e.resumable?`${t} To send it another message, call ${e.tool} again with taskId ${e.id}.`:t}function renderTaskSentReceipt(e){return`Sent to task ${e}. Its reply will arrive in a <task_result> message.`}function renderUnknownTaskError(e,t){return`No task "${e}" is available to ${t}: it may have ended or belong to another tool. Start a new one by calling ${t} without taskId.`}function renderUnknownCancelTaskError(e){return`No task "${e}" is in this session. Copy an id from a "Started task" receipt or the [Tasks] note.`}function renderTaskCancelResult(e,t){return t.status===`already_finished`?`${e} had no work to stop.`:t.resumable?`Stopped ${e}'s current work; it won't report back. To give it new work, call ${t.tool} again with taskId ${e}.`:`Stopped ${e}; it won't report back.`}function renderTooManyTasksError(e,t){return`${String(e)} tasks are already working (${t.join(`, `)}). Wait with ${TASK_WAIT_TOOL_NAME} or stop one with ${TASK_CANCEL_TOOL_NAME}, then try again.`}function renderFinalOutputWhileWorkingError(e){return`You can't give your final reply while tasks you started are working (${e.join(`, `)}). Wait for their results with ${TASK_WAIT_TOOL_NAME}, or stop a task with ${TASK_CANCEL_TOOL_NAME}, then call ${REPLY_TOOL_NAME}.`}function renderTaskWaitResult(e,t){switch(e.status){case`settled`:return renderSettledWait(e.settled,e.working);case`timeout`:return`Stopped waiting after ${formatDuration(t)}; ${countWorking(e.working)}. ${resultsArriveLater(e.working.length)}`;case`interrupt`:return`A new message arrived, so the wait ended after ${formatDuration(t)}; ${countWorking(e.working)}. Read the message, answer it if it asks you something, and decide whether it changes this work: ${interruptChoices(e.working.length)}`}}function renderSettledWait(e,t){if(e.length===0&&t.length===0)return`No tasks are working.`;let n=[];if(e.length>0){let t=e.map(e=>`${e.id} ${e.status}`),r=e.length===1?`its result follows`:`their results follow`;n.push(`${joinList(t)}; ${r}.`)}return t.length>0&&n.push(`${capitalize(countWorking(t))}: ${t.join(`, `)}.`),n.join(` `)}function countWorking(e){return e.length===1?`1 task is still working`:`${String(e.length)} tasks are still working`}function resultsArriveLater(e){return e===1?`Its result arrives before your turn ends; wait again only if you need it now.`:`Their results arrive before your turn ends; wait again only if you need them now.`}function interruptChoices(e){return`${e===1?`keep the task`:`keep the tasks`}, call an agent again with its taskId to correct it, or stop a task with ${TASK_CANCEL_TOOL_NAME}.`}function renderTaskResults(e){let t={bytes:51200,lines:2e3};return e.map(e=>{let n=fitToBudget(escapeTaskResultBody(e.body),t),r=`id="${escapeAttribute(e.taskId)}" tool="${escapeAttribute(e.tool)}" status="${e.status}"`;return`${TASK_RESULT_TAG} ${r}>${n}</task_result>`}).join(`
 `)}const TASK_RESULT_BLOCK=RegExp(`${TASK_RESULT_TAG} id="([^"]*)" tool="([^"]*)" status="(completed|failed)">([\\s\\S]*?)</task_result>`,`g`);function readTaskResults(e){return[...e.matchAll(TASK_RESULT_BLOCK)].map(([,e,t,n,r])=>({body:r.replaceAll(`<\\/task_result`,`</task_result`),status:n,taskId:e,tool:t}))}function fitToBudget(e,t){let n=new TextEncoder,r=e.split(`

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

@@ -3,7 +3,7 @@ import { type TaskToolCall } from "#execution/tasks/calls.js";
 import { type TaskRunMessage } from "#execution/tasks/steps.js";
 import { type TaskTable } from "#execution/tasks/table.js";
 import type { WorkflowToolRunMessage } from "#execution/tools/workflow/messages.js";
-import type { TaskCancelReason } from "#protocol/message.js";
+import type { TaskCancelReason } from "#execution/tasks/table.js";
 import { TASK_CANCEL_TOOL_NAME } from "#protocol/task-tools.js";
 import type { RuntimeActionResult } from "#shared/action-types.js";
 /** Whether a run's message changes a task record. */
@@ -12,9 +12,12 @@ export declare function isTaskRunMessage(message: WorkflowToolRunMessage): messa
 export declare function sessionTaskTable(cursor: SessionStateCursor): TaskTable;
 /**
  * Cancels every working task: `session.cancel()` stops them, and a turn that
- * ends anyway, such as by failing, cancels the tasks it held on.
+ * ends anyway, such as by failing, cancels the tasks it held on. With
+ * `turnCalls`, the workflow tool runs the turn waits on stop in the same step.
  */
-export declare function cancelWorkingTasks(cursor: SessionStateCursor, reason: Exclude<TaskCancelReason, "task_cancel">): Promise<void>;
+export declare function cancelWorkingTasks(cursor: SessionStateCursor, reason: Exclude<TaskCancelReason, "task-cancel">, options?: {
+    readonly turnCalls?: boolean;
+}): Promise<void>;
 export declare function answerTaskCancel(cursor: SessionStateCursor, call: Extract<TaskToolCall, {
     readonly kind: typeof TASK_CANCEL_TOOL_NAME;
 }>): Promise<RuntimeActionResult>;

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

@@ -1 +1 @@
-import{TASK_CANCEL_TOOL_NAME,UNKNOWN_TASK_CODE}from"#protocol/task-tools.js";import{renderTaskCancelResult,renderUnknownCancelTaskError}from"#execution/tasks/render.js";import{readTaskTable,taskCancelResult,workingTasks}from"#execution/tasks/table.js";import{taskToolResult}from"#execution/tasks/calls.js";import{cancelTasksStep}from"#execution/tasks/steps.js";function isTaskRunMessage(e){return e.from.taskId===void 0?!1:e.kind===`started`||e.kind===`reply`||e.kind===`usage`||e.kind===`outcome`}function sessionTaskTable(e){return readTaskTable(e.sessionState.snapshot.session.state)}async function cancelWorkingTasks(e,t){let n=workingTasks(sessionTaskTable(e)).map(e=>e.id);n.length!==0&&await e.advance(e=>cancelTasksStep({...e,reason:t,taskIds:n}))}async function answerTaskCancel(e,t){let n=taskCancelResult(sessionTaskTable(e),t.taskId);if(n===void 0){let e={code:UNKNOWN_TASK_CODE,message:renderUnknownCancelTaskError(t.taskId)};return{...taskToolResult(t.callId,TASK_CANCEL_TOOL_NAME,e),isError:!0}}return n.status===`cancelled`&&await e.advance(e=>cancelTasksStep({...e,reason:`task_cancel`,taskIds:[t.taskId]})),taskToolResult(t.callId,TASK_CANCEL_TOOL_NAME,renderTaskCancelResult(t.taskId,n))}export{answerTaskCancel,cancelWorkingTasks,isTaskRunMessage,sessionTaskTable};
+import{TASK_CANCEL_TOOL_NAME,UNKNOWN_TASK_CODE}from"#protocol/task-tools.js";import{renderTaskCancelResult,renderUnknownCancelTaskError}from"#execution/tasks/render.js";import{readTaskTable,taskCancelResult,workingTasks}from"#execution/tasks/table.js";import{getBlockingWorkflowToolRuns}from"#harness/workflow-tool-runs.js";import{taskToolResult}from"#execution/tasks/calls.js";import{cancelTasksStep}from"#execution/tasks/steps.js";function isTaskRunMessage(e){return e.from.taskId===void 0?!1:e.kind===`started`||e.kind===`reply`||e.kind===`usage`||e.kind===`outcome`}function sessionTaskTable(e){return readTaskTable(e.sessionState.snapshot.session.state)}async function cancelWorkingTasks(e,t,n={}){let r=workingTasks(sessionTaskTable(e)).map(e=>e.id),i=n.turnCalls===!0&&mayWaitOnWorkflowToolRuns(e);(r.length!==0||i)&&await e.advance(e=>cancelTasksStep({...e,reason:t,taskIds:r,turnCalls:i}))}function mayWaitOnWorkflowToolRuns(e){try{return getBlockingWorkflowToolRuns(e.sessionState.snapshot?.session?.state).length>0}catch{return!0}}async function answerTaskCancel(e,t){let n=taskCancelResult(sessionTaskTable(e),t.taskId);if(n===void 0){let e={code:UNKNOWN_TASK_CODE,message:renderUnknownCancelTaskError(t.taskId)};return{...taskToolResult(t.callId,TASK_CANCEL_TOOL_NAME,e),isError:!0}}return n.status===`cancelled`&&await e.advance(e=>cancelTasksStep({...e,reason:`task-cancel`,taskIds:[t.taskId]})),taskToolResult(t.callId,TASK_CANCEL_TOOL_NAME,renderTaskCancelResult(t.taskId,n))}export{answerTaskCancel,cancelWorkingTasks,isTaskRunMessage,sessionTaskTable};

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

@@ -1,7 +1,8 @@
 import { type TaskTable } from "#execution/tasks/table.js";
 import { type StartWorkflowTaskInput } from "#execution/tools/workflow/start.js";
 import type { HarnessSessionBase } from "#harness/types.js";
-import type { TaskStartedStreamEvent } from "#protocol/message.js";
+import type { TaskCallStart } from "#harness/session-machine/transitions.js";
+import type { SessionView } from "#protocol/session-projection/tables.js";
 import type { RuntimeToolResultActionResult, RuntimeWorkflowTaskRequest, WorkflowToolRunEntry } from "#shared/action-types.js";
 type TaskDispatchInput = StartWorkflowTaskInput & {
     readonly taskId: string;
@@ -10,7 +11,9 @@ type TaskDispatchInput = StartWorkflowTaskInput & {
 interface TaskDispatchResult {
     readonly result: RuntimeToolResultActionResult;
     readonly session: HarnessSessionBase;
-    readonly started?: TaskStartedStreamEvent["data"];
+    readonly started?: TaskCallStart;
+    /** A dispatch admission refused the call before any run started. Not inferred from output. */
+    readonly refusal?: "task-limit" | "task-unavailable";
 }
 /** The entry of a run that does a task's work. */
 type TaskRunEntry = Extract<WorkflowToolRunEntry, {
@@ -24,24 +27,24 @@ type TaskRunEntry = Extract<WorkflowToolRunEntry, {
  */
 export declare function startTaskRun(input: StartWorkflowTaskInput & {
     readonly entry: TaskRunEntry;
-}): Promise<TaskDispatchResult>;
+}, admissionView?: SessionView): Promise<TaskDispatchResult>;
 /**
  * Sends a call to the `serve` task it names by `taskId`. The task must be
  * available to the tool, and a call that makes an idle task work again
  * counts toward the cap. The call is recorded, reported as started, and sent
  * to the task's run, whose body receives it from `receive()`.
  */
-export declare function sendToTask(input: TaskDispatchInput): Promise<TaskDispatchResult>;
+export declare function sendToTask(input: TaskDispatchInput, admissionView?: SessionView): Promise<TaskDispatchResult>;
 /**
  * The entry of the run that dispatching `task` starts, or `undefined` when it
  * starts none: a call to a running task, or a task cancelled before the
  * session could start it. The task cap can still refuse a task's run.
  */
-export declare function runEntryToStart(table: TaskTable, task: RuntimeWorkflowTaskRequest): WorkflowToolRunEntry | undefined;
+export declare function runEntryToStart(table: TaskTable, view: SessionView, task: RuntimeWorkflowTaskRequest): WorkflowToolRunEntry | undefined;
 /**
  * Whether dispatching `tasks` in order starts every run {@link runEntryToStart}
  * names. A call to a running task can take a slot under the task cap, and
  * sending to it can fail the batch, so such a batch never qualifies.
  */
-export declare function startsEveryRun(table: TaskTable, tasks: readonly RuntimeWorkflowTaskRequest[]): boolean;
+export declare function startsEveryRun(table: TaskTable, view: SessionView, tasks: readonly RuntimeWorkflowTaskRequest[]): boolean;
 export {};

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

@@ -1 +1 @@
-import{createLogger,logError}from"#internal/logging.js";import{TOO_MANY_TASKS_CODE,UNKNOWN_TASK_CODE}from"#protocol/task-tools.js";import{renderTaskReceipt,renderTaskSentReceipt,renderTooManyTasksError,renderUnknownTaskError}from"#execution/tasks/render.js";import{startFailureResult,startWorkflowToolCallRun}from"#execution/tools/workflow/start.js";import{MAX_WORKING_TASKS,findTask,isTaskAvailable,isTaskWorking,readTaskTable,recordTaskCall,recordTaskRun,removeTask,workingTasks,writeTaskTable}from"#execution/tasks/table.js";import{sendTaskRunCommands}from"#execution/tasks/steps.js";import{createRuntimeToolResultFromValue}from"#harness/action-result-helpers.js";const log=createLogger(`execution.tasks`);async function startTaskRun(e){let{entry:t,session:n,task:r}=e,{taskId:i}=t,a={...e,taskId:i},o=startReceipt(a,t.entryPoint===`serve`),s=readTaskTable(n.state),c=startableTask(s,i);if(c===void 0)return{result:o,session:n};let l=tooManyTasks(a,s);if(l!==void 0)return{result:l,session:writeTaskTable(n,removeTask(s,i))};let u;try{u=await startWorkflowToolCallRun(e,t)}catch(e){return logError(log,`task run failed to start`,e,{taskId:i,toolName:r.toolName}),{result:startFailureResult(r,e),session:writeTaskTable(n,removeTask(s,i))}}return{result:o,session:writeTaskTable(n,recordTaskRun(s,i,u)),started:taskStartedEvent(a,c)}}async function sendToTask(e){let{session:t,task:n,taskId:r}=e,i=readTaskTable(t.state),a=findTask(i,r);if(!isTaskAvailable(a,n.toolName))return{result:unknownTaskResult(e),session:t};if(!isTaskWorking(a)){let n=tooManyTasks(e,i);if(n!==void 0)return{result:n,session:t}}let o=recordTaskCall(i,r,{agentContext:e.agentContext,auth:e.auth,callId:n.callId,executeInput:n.executeInput,input:n.input,sequence:e.batchEvent.sequence,stepIndex:e.batchEvent.stepIndex,turnId:e.batchEvent.turnId});return o.send!==void 0&&await sendTaskRunCommands(o.send),{result:toolResult(e,renderTaskSentReceipt(r)),session:writeTaskTable(t,o.table),started:taskStartedEvent(e,a)}}function runEntryToStart(e,t){let{entry:n}=t;switch(n.entryPoint){case`execute`:return{entryPoint:`execute`};case`task`:case`serve`:return startableTask(e,n.taskId)===void 0?void 0:n;case`receive`:return}}function startableTask(e,t){let n=findTask(e,t);return n!==void 0&&isTaskWorking(n)?n:void 0}function startsEveryRun(e,t){return!t.some(e=>e.entry.entryPoint===`receive`)&&hasTaskSlots(e,t.filter(t=>t.entry.entryPoint!==`execute`&&runEntryToStart(e,t)!==void 0).length)}function runningTasks(e){return workingTasks(e).filter(e=>e.run!==void 0)}function hasTaskSlots(e,t){return runningTasks(e).length+t<=MAX_WORKING_TASKS}function tooManyTasks(e,t){if(hasTaskSlots(t,1))return;let n=runningTasks(t).map(e=>e.id);return createRuntimeToolResultFromValue({callId:e.task.callId,isError:!0,output:{code:TOO_MANY_TASKS_CODE,message:renderTooManyTasksError(MAX_WORKING_TASKS,n)},toolName:e.task.toolName})}function unknownTaskResult(e){return createRuntimeToolResultFromValue({callId:e.task.callId,isError:!0,output:{code:UNKNOWN_TASK_CODE,message:renderUnknownTaskError(e.taskId,e.task.toolName)},toolName:e.task.toolName})}function taskStartedEvent(e,t){return{callId:e.task.callId,kind:t.kind,name:e.task.toolName,taskId:e.taskId,turnId:e.batchEvent.turnId}}function startReceipt(e,t){return toolResult(e,renderTaskReceipt({id:e.taskId,resumable:t,tool:e.task.toolName}))}function toolResult(e,t){return createRuntimeToolResultFromValue({callId:e.task.callId,output:t,toolName:e.task.toolName})}export{runEntryToStart,sendToTask,startTaskRun,startsEveryRun};
+import{isWorking,tasks}from"#protocol/session-projection/selectors.js";import{createLogger,logError}from"#internal/logging.js";import{TOO_MANY_TASKS_CODE,UNKNOWN_TASK_CODE}from"#protocol/task-tools.js";import{storedProjection}from"#harness/session-machine/view.js";import{renderTaskReceipt,renderTaskSentReceipt,renderTooManyTasksError,renderUnknownTaskError}from"#execution/tasks/render.js";import{startFailureResult,startWorkflowToolCallRun}from"#execution/tools/workflow/start.js";import{MAX_WORKING_TASKS,findTask,isTaskAvailable,readTaskTable,recordTaskCall,recordTaskRun,removeTask,writeTaskTable}from"#execution/tasks/table.js";import{sendTaskRunCommands}from"#execution/tasks/steps.js";import{createRuntimeToolResultFromValue}from"#harness/action-result-helpers.js";const log=createLogger(`execution.tasks`);async function startTaskRun(e,t=storedProjection(e.session.state).view){let{entry:n,session:r,task:i}=e,{taskId:a}=n,o={...e,taskId:a},s=startReceipt(o,n.entryPoint===`serve`),c=readTaskTable(r.state),l=findTask(c,a);if(t.calls[i.callId]?.status===`settled`)return{result:s,session:r};if(l===void 0)return{result:startFailureResult(i,Error(`Task dispatch record ${a} is unavailable.`)),session:r};let u=tooManyTasks(o,t);if(u!==void 0)return{result:u,refusal:`task-limit`,session:writeTaskTable(r,removeTask(c,a))};let d;try{d=await startWorkflowToolCallRun(e,n)}catch(e){return logError(log,`task run failed to start`,e,{taskId:a,toolName:i.toolName}),{result:startFailureResult(i,e),session:writeTaskTable(r,removeTask(c,a))}}return{result:s,session:writeTaskTable(r,recordTaskRun(c,a,d)),started:taskCallStart(o,l)}}async function sendToTask(e,t=storedProjection(e.session.state).view){let{session:n,task:r,taskId:i}=e,a=readTaskTable(n.state),o=findTask(a,i);if(t.tasks[i]?.status!==`running`||!isTaskAvailable(o,r.toolName))return{result:unknownTaskResult(e),refusal:`task-unavailable`,session:n};if(!isWorking(t,i)){let r=tooManyTasks(e,t);if(r!==void 0)return{result:r,refusal:`task-limit`,session:n}}let s=recordTaskCall(a,i,{agentContext:e.agentContext,auth:e.auth,callId:r.callId,executeInput:r.executeInput,input:r.input,sequence:e.batchEvent.sequence,stepIndex:e.batchEvent.stepIndex,turnId:e.batchEvent.turnId});return s.send!==void 0&&await sendTaskRunCommands(s.send),{result:toolResult(e,renderTaskSentReceipt(i)),session:writeTaskTable(n,s.table),started:taskCallStart(e,o)}}function runEntryToStart(e,t,n){let{entry:r}=n;switch(r.entryPoint){case`execute`:return{entryPoint:`execute`};case`task`:case`serve`:return findTask(e,r.taskId)===void 0||t.calls[n.callId]?.status===`settled`?void 0:r;case`receive`:return}}function startsEveryRun(e,t,n){if(n.some(e=>e.entry.entryPoint===`receive`))return!1;let r=n.filter(n=>n.entry.entryPoint!==`execute`&&runEntryToStart(e,t,n)!==void 0);return workingTasks$1(t).length+r.length<=MAX_WORKING_TASKS}function workingTasks$1(e){return tasks(e,{status:`working`})}function tooManyTasks(e,t){let n=workingTasks$1(t);if(n.length<MAX_WORKING_TASKS)return;let r=n.map(e=>e.taskId);return createRuntimeToolResultFromValue({callId:e.task.callId,isError:!0,output:{code:TOO_MANY_TASKS_CODE,message:renderTooManyTasksError(MAX_WORKING_TASKS,r)},toolName:e.task.toolName})}function unknownTaskResult(e){return createRuntimeToolResultFromValue({callId:e.task.callId,isError:!0,output:{code:UNKNOWN_TASK_CODE,message:renderUnknownTaskError(e.taskId,e.task.toolName)},toolName:e.task.toolName})}function taskCallStart(e,t){return{callId:e.task.callId,clearedBy:e.task.clearedBy,kind:t.kind,name:e.task.toolName,taskId:e.taskId,turnId:e.batchEvent.turnId}}function startReceipt(e,t){return toolResult(e,renderTaskReceipt({id:e.taskId,resumable:t,tool:e.task.toolName}))}function toolResult(e,t){return createRuntimeToolResultFromValue({callId:e.task.callId,output:t,toolName:e.task.toolName})}export{runEntryToStart,sendToTask,startTaskRun,startsEveryRun};

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

@@ -2,7 +2,7 @@ import { type TaskRunCommands } from "#execution/tasks/table.js";
 import type { PublishedSessionEvents, SessionStepState } from "#execution/publish-session-events.js";
 import { type SessionStateTransition } from "#execution/session/state-delta.js";
 import type { WorkflowToolRunMessage } from "#execution/tools/workflow/messages.js";
-import type { TaskCancelReason } from "#protocol/message.js";
+import type { TaskCancelReason } from "#execution/tasks/table.js";
 /** The messages a task's run sends that change its record. */
 export type TaskRunMessage = Extract<WorkflowToolRunMessage, {
     readonly kind: "outcome" | "reply" | "started" | "usage";
@@ -15,16 +15,21 @@ export declare function applyTaskRunMessage(input: SessionStepState & {
     readonly message: TaskRunMessage;
 }): Promise<PublishedSessionEvents>;
 /**
- * Cancels tasks: their calls settle as cancelled and their runs are told to
- * stop. A run ends itself within its cleanup deadline and reports cancelled.
- * A `task()` run's cancel settles every request it relayed, so the session
- * withdraws them in the same step and accepts no answer after it. A `serve()`
- * run withdraws its stretch's questions itself, and the session decides each one.
+ * Cancels tasks, and the calls the turn waits on when `turnCalls` is set. The tasks' calls
+ * settle as cancelled and the session publishes that first. A cancelled agent or `task()` task
+ * ends now, without waiting for its run to finish cleanup. A resumable tool's run only stops its
+ * current stretch.
+ *
+ * A `task()` run's cancel settles every request it relayed, so the session withdraws them in
+ * the same step and accepts no answer after it. A `serve()` run withdraws its stretch's
+ * questions itself, and the session decides each one.
  */
 export declare function cancelTasksStep(input: SessionStepState & TaskCancellationInput): Promise<SessionStateTransition>;
 interface TaskCancellationInput {
     readonly reason: TaskCancelReason;
     readonly taskIds: readonly string[];
+    /** Also stop the workflow tool runs the turn waits on. */
+    readonly turnCalls?: boolean;
 }
 /**
  * Sends commands to a task's run, in order. A run that already finished takes