eve 0.71.2 → 0.72.0

package/dist/src/harness/approval-candidates.js

@@ -1 +0,0 @@
-const APPROVAL_STATE_KEY=`eve.runtime.hitl.approvalState`;function createApprovalCandidate(e){let t=expireApprovalCandidates({now:e.createdAt,state:e.state}),n=readApprovalState(t);if(n.settlements[e.requestId]!==void 0)return{changed:!1,state:t};let r=e.responder;if(Object.values(n.activeCandidates).find(t=>t.requestId===e.requestId&&t.decision===e.decision&&sameResponder(t.responder,r))!==void 0)return{changed:!1,state:t};let i=n.activeCandidates[e.candidateIdPrefix]!==void 0||n.candidateHistory.some(t=>t.candidateId===e.candidateIdPrefix)?`${e.candidateIdPrefix}.${n.nextCandidateSequence.toString(36)}`:e.candidateIdPrefix;if(n.activeCandidates[i]!==void 0||n.candidateHistory.some(e=>e.candidateId===i))throw Error(`Approval candidate id collision: "${i}".`);let a={candidateId:i,createdAt:e.createdAt,decision:e.decision,expiresAt:e.expiresAt,requestId:e.requestId,responder:r,status:`pending`};return{changed:!0,state:writeApprovalState(t,{...n,activeCandidates:{...n.activeCandidates,[a.candidateId]:a},nextCandidateSequence:n.nextCandidateSequence+1})}}function markApprovalCandidatePendingEventEmitted(e){let t=readApprovalState(e.state),n=t.activeCandidates[e.candidateId];return n===void 0||n.pendingEventEmitted===!0?e.state:writeApprovalState(e.state,{...t,activeCandidates:{...t.activeCandidates,[e.candidateId]:{...n,pendingEventEmitted:!0}}})}function markApprovalCandidateHistoryEventEmitted(e){let t=readApprovalState(e.state),n=!1,r=t.candidateHistory.map(t=>t.candidateId!==e.candidateId||t.eventEmitted===!0?t:(n=!0,{...t,eventEmitted:!0}));return n?writeApprovalState(e.state,{...t,candidateHistory:r}):e.state}function markApprovalSettlementEventEmitted(e){let t=readApprovalState(e.state),n=t.settlements[e.requestId];return n===void 0||n.eventEmitted===!0?e.state:writeApprovalState(e.state,{...t,settlements:{...t.settlements,[e.requestId]:{...n,eventEmitted:!0}}})}function markApprovalCandidateAuthorizationRequired(e){let t=readApprovalState(e.state),n=t.activeCandidates[e.candidateId];if(n===void 0)return e.state;let r={...n,authorizationChallenges:e.authorizationChallenges,expiresAt:e.expiresAt??n.expiresAt,status:`authorization-required`};return writeApprovalState(e.state,{...t,activeCandidates:{...t.activeCandidates,[e.candidateId]:r}})}function finishApprovalCandidate(e){let t=readApprovalState(e.state),n=t.activeCandidates[e.candidateId];if(n===void 0)return e.state;let r={...t.activeCandidates};return delete r[e.candidateId],writeApprovalState(e.state,{...t,activeCandidates:r,candidateHistory:[...t.candidateHistory,toCandidateAuditRecord({candidate:n,completedAt:e.completedAt,reason:e.reason,status:e.status})]})}function expireApprovalCandidates(e){let t=e.state,n=Object.values(readApprovalState(t).activeCandidates);for(let r of n)r.expiresAt>e.now||(t=finishApprovalCandidate({candidateId:r.candidateId,completedAt:e.now,state:t,status:`timed-out`}));return t}function settleAllowedCandidate(e){let t=expireApprovalCandidates({now:e.settledAt,state:e.state}),n=readApprovalState(t),r=n.activeCandidates[e.candidateId];if(r===void 0){let r=n.candidateHistory.find(t=>t.candidateId===e.candidateId);if((r&&n.settlements[r.requestId])!==void 0)return{changed:!1,state:t};throw Error(`Unknown approval candidate "${e.candidateId}".`)}return settleRequest({actor:projectResponder(r.responder),candidateId:r.candidateId,outcome:r.decision===`cancel`?`cancelled`:`allowed`,requestId:r.requestId,settledAt:e.settledAt,state:t})}function settleDirectApprovalResponse(e){let t=expireApprovalCandidates({now:e.settledAt,state:e.state});return settleRequest({actor:projectResponder(e.actor),outcome:e.outcome,requestId:e.requestId,settledAt:e.settledAt,state:t})}function getActiveApprovalCandidate(e,t){return readApprovalState(e).activeCandidates[t]}function getApprovalAuditState(e){let t=readApprovalState(e);return{activeCandidates:Object.values(t.activeCandidates),candidateHistory:t.candidateHistory,settlements:Object.values(t.settlements)}}function settleRequest(e){let t=readApprovalState(e.state);if(t.settlements[e.requestId]!==void 0)return{changed:!1,state:e.state};let n={actor:e.actor,candidateId:e.candidateId,outcome:e.outcome,requestId:e.requestId,settledAt:e.settledAt},r={},i=[...t.candidateHistory];for(let n of Object.values(t.activeCandidates)){if(n.requestId!==e.requestId){r[n.candidateId]=n;continue}i.push(toCandidateAuditRecord({candidate:n,completedAt:e.settledAt,status:n.candidateId===e.candidateId?`allowed`:`stale`}))}let a={activeCandidates:r,candidateHistory:i,nextCandidateSequence:t.nextCandidateSequence,settlements:{...t.settlements,[e.requestId]:n}};return{changed:!0,state:writeApprovalState(e.state,a)}}function toCandidateAuditRecord(e){let{authorizationChallenges:t,responder:n,...r}=e.candidate;return{...r,completedAt:e.completedAt,responder:projectResponder(n),reason:e.reason,status:e.status}}function projectResponder(e){return{authenticator:e.authenticator,issuer:e.issuer,principalId:e.principalId,principalType:e.principalType}}function sameResponder(e,t){return e.authenticator===t.authenticator&&e.issuer===t.issuer&&e.principalId===t.principalId&&e.principalType===t.principalType}function readActiveCandidates(e){return Object.fromEntries(Object.entries(e).map(([e,t])=>[e,{...t,decision:t.decision===`cancel`?`cancel`:`approve`}]))}function readApprovalState(e){let t=e?.[APPROVAL_STATE_KEY];if(typeof t!=`object`||!t)return{activeCandidates:{},candidateHistory:[],nextCandidateSequence:0,settlements:{}};let n=t;return{activeCandidates:typeof n.activeCandidates==`object`&&n.activeCandidates!==null?readActiveCandidates(n.activeCandidates):{},candidateHistory:Array.isArray(n.candidateHistory)?n.candidateHistory:[],nextCandidateSequence:typeof n.nextCandidateSequence==`number`&&Number.isSafeInteger(n.nextCandidateSequence)&&n.nextCandidateSequence>=0?n.nextCandidateSequence:deriveNextCandidateSequence(n),settlements:typeof n.settlements==`object`&&n.settlements!==null?n.settlements:{}}}function deriveNextCandidateSequence(e){return Object.keys(e.activeCandidates??{}).length+(Array.isArray(e.candidateHistory)?e.candidateHistory.length:0)}function writeApprovalState(e,t){return{...e,[APPROVAL_STATE_KEY]:t}}export{createApprovalCandidate,expireApprovalCandidates,finishApprovalCandidate,getActiveApprovalCandidate,getApprovalAuditState,markApprovalCandidateAuthorizationRequired,markApprovalCandidateHistoryEventEmitted,markApprovalCandidatePendingEventEmitted,markApprovalSettlementEventEmitted,settleAllowedCandidate,settleDirectApprovalResponse};

package/dist/src/harness/approval-delivery-coordinator.js

@@ -1 +0,0 @@
-import{contextStorage}from"#context/container.js";import{AuthKey,SessionKey}from"#context/keys.js";import{buildCallbackContext}from"#context/build-callback-context.js";import{buildApprovalResponseAuth,handleApprovalResponsePolicyError}from"#execution/tool-auth.js";import{clearPendingAuthorization,getAuthorizationResult,getPendingAuthorization,isAuthorizationSignal}from"#harness/authorization.js";import{getPendingInputBatches,pendingInputRequester}from"#harness/pending-input-batches.js";import{createApprovalCandidate,expireApprovalCandidates,finishApprovalCandidate,getActiveApprovalCandidate,getApprovalAuditState,markApprovalCandidateAuthorizationRequired,settleAllowedCandidate,settleDirectApprovalResponse}from"#harness/approval-candidates.js";import{isApprovalRequest}from"#harness/input-request-class.js";async function coordinateApprovalDelivery(e){let t=e.now??Date.now(),n=getApprovalAuditState(e.session.state).activeCandidates.filter(e=>e.expiresAt<=t),r=n.flatMap(e=>e.authorizationChallenges?.map(e=>e.attemptId??e.candidateId??e.name)??[]),i=expireApprovalCandidates({now:t,state:e.session.state}),a={...e.session,state:clearPendingAuthorization(i,r)},o=getApprovalAuditState(a.state),s=getPendingInputBatches(a.state),c=new Set(s.flatMap(e=>e.requests.map(e=>e.requestId))),l=o.settlements.filter(e=>c.has(e.requestId)),u=new Set(o.settlements.map(e=>e.requestId)),d=new Set([...u].filter(e=>!c.has(e))),f=hasResponseForRequest(e.stepInput,d),p=f?removeConsumedResponses(e.stepInput,d):e.stepInput;if(f&&l.length===0&&!hasMeaningfulInput(p))return deliveryResult(a,p,`park`);if(s.length===0)return deliveryResult(a,p);let m=p,h=new Set(s.flatMap(e=>e.responseAuthRequiredRequestIds??[])),g=s.flatMap(e=>e.requests),_=new Map(g.map(e=>[e.requestId,e])),v=[],y=[],b=new Set,x=!1,S=getApprovalAuditState(a.state).activeCandidates,C=[...m?.attributedInputResponses??[],...(m?.inputResponses??[]).map(e=>({auth:void 0,response:e}))];for(let{auth:e,response:n}of C){let r=_.get(n.requestId);if(r===void 0||!isApprovalRequest(r))continue;if(!h.has(n.requestId)){let r=contextStorage.getStore(),i=e===void 0?r?.get(AuthKey)??r?.get(SessionKey)?.auth.current??null:e,o=toCandidateDecision(n.optionId);if(i!==null&&o!==void 0){let e=settleDirectApprovalResponse({actor:i,outcome:o===`approve`?`allowed`:`cancelled`,requestId:n.requestId,settledAt:t,state:a.state});a={...a,state:e.state},x||=e.changed}continue}b.add(n.requestId);let i=toCandidateDecision(n.optionId);if(i===void 0)continue;let o=e===void 0?buildCallbackContext().session.auth.current:e;if(o===null){y.push(`Authentication is required to respond to this approval.`);continue}let s=createApprovalCandidate({candidateIdPrefix:approvalCandidateIdPrefix(r.requestId,o,i),createdAt:t,decision:i,expiresAt:t+6e5,requestId:r.requestId,responder:o,state:a.state});a={...a,state:s.state},x||=s.changed}let w=removeConsumedResponses(m,b);if(b.size>0)return deliveryResult(a,w,x?`continue-coordination`:`continue`,[],y);if(x)return deliveryResult(a,w,`continue`,[],y);let T=new Set(getPendingAuthorization(a.state)?.challenges.map(e=>e.name)??[]);for(let n of S){if(n.status===`authorization-required`){let e=n.authorizationChallenges??[];if(!e.some(e=>getAuthorizationResult(e.name)!==void 0)){v.push(...e.filter(e=>!T.has(e.name)));continue}}let r=_.get(n.requestId);if(r===void 0||getActiveApprovalCandidate(a.state,n.candidateId)===void 0)continue;let i=await authorizeCandidate({candidateId:n.candidateId,decision:n.decision,now:t,request:r,responder:n.responder,session:a,tools:await e.prepareTools?.(r)??e.tools});a=i.session,x||=i.didCommit,v.push(...i.challenges);let o=getApprovalAuditState(a.state).settlements.find(e=>e.requestId===n.requestId);o!==void 0&&l.push(o)}let E=appendSettledResponses(w,l);return(x||n.length>0)&&getApprovalAuditState(a.state).activeCandidates.length===0?deliveryResult(a,E,`responses-completed`):l.length>0?deliveryResult(a,E,`continue`):x?deliveryResult(a,E,`continue-coordination`):deliveryResult(a,E,v.length>0?`authorization-required`:`continue`,v)}async function authorizeCandidate(e){let t={...e.session,state:expireApprovalCandidates({now:e.now,state:e.session.state})};if(getActiveApprovalCandidate(t.state,e.candidateId)===void 0)return{challenges:[],didCommit:!1,session:t};let n=e.tools.get(e.request.action.toolName)?.approval,r=n!==void 0&&typeof n!=`function`?n.response:void 0;if(r===void 0)return failCandidate({...e,reason:`Approval authorization is temporarily unavailable. Please try again.`,session:t});try{let n=buildCallbackContext(),i=await withAuthorizerTimeout(r({auth:buildApprovalResponseAuth({responder:e.responder,scope:e.candidateId}),request:{callId:e.request.action.callId,requestId:e.request.requestId,principal:pendingInputRequester(t.state,e.request.requestId),toolInput:e.request.action.input,toolName:e.request.action.toolName},response:{decision:e.decision,principal:e.responder},session:{id:n.session.id,initiator:n.session.auth.initiator,parent:n.session.parent,turn:n.session.turn}}));if(i.status===`rejected`)return t={...t,state:finishApprovalCandidate({candidateId:e.candidateId,completedAt:e.now,reason:i.reason,state:t.state,status:`rejected`})},{challenges:[],didCommit:!0,session:t};if(i.status!==`allowed`)return failCandidate({...e,session:t});let a=settleAllowedCandidate({candidateId:e.candidateId,settledAt:e.now,state:t.state});return{challenges:[],didCommit:a.changed,session:{...t,state:a.state}}}catch(n){let r=await handleApprovalResponsePolicyError(n).catch(()=>void 0);if(isAuthorizationSignal(r)){let n=r.challenges.map(e=>Date.parse(e.challenge.expiresAt??``)).filter(Number.isFinite).sort((e,t)=>e-t)[0];return t={...t,state:markApprovalCandidateAuthorizationRequired({authorizationChallenges:r.challenges.map(t=>({...t,candidateId:e.candidateId})),candidateId:e.candidateId,expiresAt:n,state:t.state})},{challenges:r.challenges.map(t=>({...t,candidateId:e.candidateId})),didCommit:!0,session:t}}return failCandidate({...e,session:t})}}function failCandidate(e){let t=e.reason??`We couldn’t verify your response. Please try again.`;return{challenges:[],didCommit:!0,session:{...e.session,state:finishApprovalCandidate({candidateId:e.candidateId,completedAt:e.now,reason:t,state:e.session.state,status:`failed`})}}}function hasResponseForRequest(e,t){return e?.attributedInputResponses?.some(({response:e})=>t.has(e.requestId))===!0||e?.inputResponses?.some(e=>t.has(e.requestId))===!0}function hasMeaningfulInput(e){return e?.message!==void 0||(e?.attributedInputResponses?.length??0)>0||(e?.inputResponses?.length??0)>0||(e?.runtimeActionResults?.length??0)>0}function appendSettledResponses(e,t){if(t.length===0)return e;let n=new Set([...(e?.inputResponses??[]).map(e=>e.requestId),...(e?.attributedInputResponses??[]).map(({response:e})=>e.requestId)]),r=t.filter(e=>!n.has(e.requestId));return r.length===0?e:{...e,inputResponses:[...e?.inputResponses??[],...r.map(e=>({optionId:e.outcome===`allowed`?`approve`:`cancel`,requestId:e.requestId}))]}}function removeConsumedResponses(e,t){if(e===void 0)return;let n=(e.attributedInputResponses??[]).filter(({response:e})=>!t.has(e.requestId)),r=[...(e.inputResponses??[]).filter(e=>!t.has(e.requestId)),...n.map(({response:e})=>e)];return{...e,attributedInputResponses:void 0,inputResponses:r}}function deliveryResult(e,t,n=`continue`,r=[],i=[]){return{challenges:r,feedback:i,kind:n,session:e,stepInput:t}}function toCandidateDecision(e){if(e===`approve`)return`approve`;if(e===`cancel`||e===`deny`)return`cancel`}function approvalCandidateIdPrefix(e,t,n){let r=[t.authenticator,t.issuer??``,t.principalType,t.principalId].join(`:`),i=`${encodeCandidateIdPart(e)}.${encodeCandidateIdPart(r)}`;return n===`approve`?i:`${i}.${encodeCandidateIdPart(n)}`}function encodeCandidateIdPart(e){return Array.from(e,e=>e.codePointAt(0).toString(36)).join(`-`)}async function withAuthorizerTimeout(e){let t;try{return await Promise.race([Promise.resolve(e),new Promise((e,n)=>{t=setTimeout(()=>n(Error(`Approval response authorizer timed out.`)),1e4)})])}finally{t!==void 0&&clearTimeout(t)}}export{coordinateApprovalDelivery};

package/dist/src/harness/cancelled-turn-emission.d.ts

@@ -1,12 +0,0 @@
-import type { HarnessEmitFn } from "#harness/types.js";
-import type { TokenUsage } from "#shared/token-usage.js";
-import type { HarnessEmissionState } from "#harness/emission.js";
-/**
- * Emits the cancelled-turn epilogue: `turn.cancelled` → `session.waiting`
- * (never a failure event) and returns the between-turns emission state.
- *
- * `state` is the last *persisted* emission state, which may predate the
- * cancelled turn's preamble — the turn id is reconstructed via
- * {@link activeTurnId} and `sessionStarted` is stamped `true`.
- */
-export declare function emitCancelledTurn(emitFn: HarnessEmitFn, state: HarnessEmissionState, usage: TokenUsage): Promise<HarnessEmissionState>;

package/dist/src/harness/cancelled-turn-emission.js

@@ -1 +0,0 @@
-import{createSessionWaitingEvent,createTurnCancelledEvent}from"#protocol/message.js";import{activeTurnId}from"#harness/active-turn-id.js";async function emitCancelledTurn(e,t,n){return await e(createTurnCancelledEvent({sequence:t.sequence,turnId:activeTurnId(t)})),await e(createSessionWaitingEvent(n)),{sessionStarted:!0,sequence:t.sequence+1,stepIndex:0,turnId:``}}export{emitCancelledTurn};

package/dist/src/harness/emission-state.d.ts

@@ -1,26 +0,0 @@
-import type { HarnessSession, SessionStateMap } from "#harness/types.js";
-/**
- * Tracks emission lifecycle state across harness step invocations.
- *
- * Persisted on `session.state` so the state survives when the durable
- * workflow runtime recreates the harness at each `"use step"` boundary.
- */
-export interface HarnessEmissionState {
-    readonly assistantOutputStarted?: boolean;
-    readonly sessionStarted: boolean;
-    readonly sequence: number;
-    readonly stepIndex: number;
-    readonly turnId: string;
-}
-/** Reads the emission state, returning defaults when absent. */
-export declare function getHarnessEmissionState(state: SessionStateMap | undefined): HarnessEmissionState;
-/**
- * Returns `true` when the harness is between turns — either no turn has
- * started yet or the previous turn has emitted its epilogue and reset.
- *
- * The empty `turnId` sentinel distinguishes a fresh delivery from an in-flight
- * continuation. Callers should use this predicate instead of reading it.
- */
-export declare function isHarnessBetweenTurns(session: HarnessSession): boolean;
-/** Writes the emission state onto a new copy of the session. */
-export declare function setHarnessEmissionState(session: HarnessSession, state: HarnessEmissionState): HarnessSession;

package/dist/src/harness/emission-state.js

@@ -1 +0,0 @@
-import{clearTurnClientContextState}from"#harness/turn-client-context.js";const HARNESS_EMISSION_STATE_KEY=`eve.harness.emission`,DEFAULT_EMISSION_STATE={sessionStarted:!1,sequence:0,stepIndex:0,turnId:``};function getHarnessEmissionState(e){return e?.[HARNESS_EMISSION_STATE_KEY]??DEFAULT_EMISSION_STATE}function isHarnessBetweenTurns(e){return getHarnessEmissionState(e.state).turnId===``}function setHarnessEmissionState(e,t){let n=t.turnId===``?clearTurnClientContextState(e):e;return{...n,state:{...n.state,[HARNESS_EMISSION_STATE_KEY]:t}}}export{getHarnessEmissionState,isHarnessBetweenTurns,setHarnessEmissionState};

package/dist/src/harness/held-requests.d.ts

@@ -1,18 +0,0 @@
-import { type AuthorizationChallenge } from "#harness/authorization.js";
-import type { HarnessEmissionState } from "#harness/emission-state.js";
-import { type AuthorizationCompletedStreamEvent } from "#protocol/message.js";
-/**
- * Ends the sign-ins a held turn waits on when the person moves on, by steering
- * it with a message or cancelling it: the turn's own sign-ins, and the sign-ins
- * of responders still checking one of its approvals, whose candidates end as
- * stale. The approvals themselves resolve with the steering step or the cancel.
- */
-export declare function withdrawHeldSignIns(state: Record<string, unknown> | undefined, input: {
-    readonly completedAt: number;
-    readonly reason: string;
-}): {
-    readonly state: Record<string, unknown> | undefined;
-    readonly withdrawn: readonly AuthorizationChallenge[];
-};
-/** The `authorization.completed` events reporting withdrawn sign-ins as declined. */
-export declare function declinedSignInEvents(withdrawn: readonly AuthorizationChallenge[], reason: string, emissionState: HarnessEmissionState): AuthorizationCompletedStreamEvent[];

package/dist/src/harness/held-requests.js

@@ -1 +0,0 @@
-import{createAuthorizationCompletedEvent}from"#protocol/message.js";import{clearPendingAuthorization,getPendingAuthorization}from"#harness/authorization.js";import{authorizationEventFields}from"#harness/authorization-event-fields.js";import{finishApprovalCandidate,getApprovalAuditState}from"#harness/approval-candidates.js";function withdrawHeldSignIns(e,t){let n=getPendingAuthorization(e)?.challenges??[],r=n.length===0?e:clearPendingAuthorization(e);for(let e of getApprovalAuditState(r).activeCandidates)r=finishApprovalCandidate({candidateId:e.candidateId,completedAt:t.completedAt,reason:t.reason,state:r,status:`stale`});return{state:r,withdrawn:n}}function declinedSignInEvents(e,t,n){return e.map(e=>createAuthorizationCompletedEvent({...authorizationEventFields(e),outcome:`declined`,reason:t,sequence:n.sequence,stepIndex:n.stepIndex,turnId:n.turnId}))}export{declinedSignInEvents,withdrawHeldSignIns};

package/dist/src/harness/hitl/approval-input-requests.d.ts

@@ -1,27 +0,0 @@
-import type { InputRequest, InputResponse } from "#shared/input.js";
-import type { PendingInputBatch } from "#harness/pending-input-batches.js";
-import type { InputDomainResolverInput, ResolvedInputActionBatch, ResolvePendingInputResult } from "#harness/hitl/pending-input-resolution.js";
-import type { HarnessSession } from "#harness/types.js";
-export type RejectedActionBatch = ResolvedInputActionBatch;
-export declare function findAnsweredApprovalBatches(batches: readonly PendingInputBatch[], responses: readonly InputResponse[]): PendingInputBatch[];
-export declare function resolveApprovalInputBatches(input: InputDomainResolverInput & {
-    readonly resolveApprovalKey?: (request: InputRequest) => string | undefined;
-}): ResolvePendingInputResult;
-/**
- * Resolves the first open approval batch when the person steered the held turn
- * with a message instead of finishing it. Requests they already answered, as in
- * a partial approval, keep that answer; the rest report `ignored`. Later
- * batches stay open, as with answered batches.
- */
-export declare function ignoreApprovalInputBatch(input: InputDomainResolverInput & {
-    readonly resolveApprovalKey?: (request: InputRequest) => string | undefined;
-}): ResolvePendingInputResult;
-/**
- * Withdraws every pending tool approval when its turn is cancelled. Each held
- * call goes into history with a not-run result, so no call is left without one.
- */
-export declare function cancelApprovalInputBatches(session: HarnessSession): HarnessSession;
-/** Tool approvals still waiting for an answer, which cancelling their turn withdraws. */
-export declare function getPendingApprovalRequests(state: HarnessSession["state"]): readonly InputRequest[];
-/** Returns recorded approval keys that have no matching request still pending. */
-export declare function getApprovedTools(session: HarnessSession, resolveApprovalKey?: (request: InputRequest) => string | undefined): ReadonlySet<string>;

package/dist/src/harness/hitl/approval-input-requests.js

@@ -1 +0,0 @@
-import{validateHarnessModelMessages}from"#harness/messages.js";import{getPendingInputBatches,queueDeferredStepInput,removePendingInputBatches}from"#harness/pending-input-batches.js";import{isApprovalRequest}from"#harness/input-request-class.js";import{TOOL_EXECUTION_DENIED_MESSAGE,buildResolvedInputBatch,resolveApprovalOutcome}from"#harness/input-request-resolution.js";import{appendResolvedBatchTranscript,compactStepInput,finishResolvedInput,responsesForBatches}from"#harness/hitl/pending-input-resolution.js";const APPROVED_TOOLS_KEY=`eve.runtime.hitl.approvedTools`;function findAnsweredApprovalBatches(e,t){let n=new Set(t.map(e=>e.requestId));return e.filter(e=>e.requests.every(e=>!isApprovalRequest(e)||n.has(e.requestId)))}function resolveApprovalInputBatches(e){let t=new Set(findAnsweredApprovalBatches(e.batches,e.responses)),n=e.batches.find(e=>t.has(e)),r=e.batches.filter(e=>e!==n),i=responsesForBatches(e.responses,r);if(n===void 0)return e.resolvedStepInput?.message===void 0?{outcome:`unresolved`,messages:[...e.baseHistory],session:queueDeferredStepInput(e.session,compactStepInput(e.resolvedStepInput))}:ignoreApprovalInputBatch(e);let a=resolveApprovalBatch({batch:n,messages:[...e.baseHistory],resolveApprovalKey:e.resolveApprovalKey,responses:e.responses,session:e.session}),o=buildResolvedInputBatch(n,e.responses);return finishResolvedInput({deferTurnInput:!0,leftoverResponses:i,messages:a.messages,rejectedActions:a.rejectedActions,resolvedInputs:o===void 0?[]:[o],resolvedStepInput:e.resolvedStepInput,session:removePendingInputBatches(a.session,[n])})}function ignoreApprovalInputBatch(e){let t=e.batches[0],n=responsesForBatches(e.responses,[t]),r=resolveApprovalBatch({batch:t,messages:[...e.baseHistory],resolveApprovalKey:e.resolveApprovalKey,responses:n,session:e.session}),i=buildResolvedInputBatch(t,n);return finishResolvedInput({deferTurnInput:n.some(e=>resolveApprovalOutcome(e).approved),leftoverResponses:responsesForBatches(e.responses,e.batches.slice(1)),messages:r.messages,rejectedActions:r.rejectedActions,resolvedInputs:i===void 0?[]:[i],resolvedStepInput:e.resolvedStepInput,session:removePendingInputBatches(r.session,[t])})}function cancelApprovalInputBatches(e){let t=pendingApprovalBatches(e.state);if(t.length===0)return e;let n=[...e.history];for(let e of t)appendResolvedBatchTranscript(n,e,buildApprovalBatchToolResponseParts(e,[],`Cancelled before anyone answered.`));return{...removePendingInputBatches(e,t),history:validateHarnessModelMessages(n)}}function getPendingApprovalRequests(e){return pendingApprovalBatches(e).flatMap(e=>e.requests)}function pendingApprovalBatches(e){return getPendingInputBatches(e).filter(e=>e.requests.every(isApprovalRequest))}function getApprovedTools(e,t){let n=readRecordedApprovedTools(e);for(let r of getPendingInputBatches(e.state))for(let e of r.requests)isApprovalRequest(e)&&n.delete(t?.(e)??e.action.toolName);return n}function readRecordedApprovedTools(e){let t=e.state?.[APPROVED_TOOLS_KEY];return Array.isArray(t)?new Set(t):new Set}function resolveApprovalBatch(e){let t=recordApprovedTools({pendingBatch:e.batch,resolveApprovalKey:e.resolveApprovalKey,responses:e.responses,session:e.session}),n=buildApprovalBatchToolResponseParts(e.batch,e.responses);appendResolvedBatchTranscript(e.messages,e.batch,n);let r=buildRejectedActionBatch(e.batch,e.responses);return{messages:e.messages,rejectedActions:r===void 0?void 0:[r],session:t}}function recordApprovedTools(e){let t=new Set(e.responses.filter(e=>e.optionId===`approve`).map(e=>e.requestId)),n=e.pendingBatch.requests.filter(e=>isApprovalRequest(e)&&t.has(e.requestId)).map(t=>e.resolveApprovalKey?.(t)??t.action.toolName);if(n.length===0)return e.session;let r={...e.session.state};return r[APPROVED_TOOLS_KEY]=[...new Set([...readRecordedApprovedTools(e.session),...n])],{...e.session,state:r}}function buildRejectedActionBatch(e,t){if(e.event===void 0)return;let n=new Map(t.map(e=>[e.requestId,e])),r=[];for(let t of e.requests){if(!isApprovalRequest(t))continue;let{approved:e,reason:i,status:a}=resolveApprovalOutcome(n.get(t.requestId));e||r.push({callId:t.action.callId,isError:!0,kind:`tool-result`,output:{approval:{requestId:t.requestId,status:a},code:`TOOL_EXECUTION_DENIED`,message:i??TOOL_EXECUTION_DENIED_MESSAGE,tool:{result:`not_run`}},toolName:t.action.toolName})}return r.length>0?{event:e.event,results:r}:void 0}function buildApprovalBatchToolResponseParts(e,t,n){let r=new Map(t.map(e=>[e.requestId,e])),i=[];for(let t of e.requests){let e=r.get(t.requestId);switch(t.kind){case`tool-approval`:i.push(...buildApprovalToolResponseParts(t,e,n));break;case`question`:case`session-limit`:throw TypeError(`Approval pending input batches cannot contain a "${t.kind}" request.`);default:{let e=t.kind;throw TypeError(`Unhandled pending input request kind: ${String(e)}`)}}}return i}function buildApprovalToolResponseParts(e,t,n){let r=resolveApprovalOutcome(t),i=r.approved,a=t===void 0?n??r.reason:r.reason,o=[{approvalId:e.requestId,approved:i,reason:a,type:`tool-approval-response`}];return i||o.push({output:{type:`execution-denied`,reason:a},toolCallId:e.action.callId,toolName:e.action.toolName,type:`tool-result`}),o}export{cancelApprovalInputBatches,findAnsweredApprovalBatches,getApprovedTools,getPendingApprovalRequests,ignoreApprovalInputBatch,resolveApprovalInputBatches};

package/dist/src/harness/hitl/pending-input-resolution.d.ts

@@ -1,54 +0,0 @@
-import type { ModelMessage } from "ai";
-import type { RuntimeToolResultActionResult } from "#shared/action-types.js";
-import type { InputResponse } from "#shared/input.js";
-import type { ResolvedInputBatch } from "#harness/input-request-resolution.js";
-import type { PendingInputBatch, PendingInputBatchEvent } from "#harness/pending-input-batches.js";
-import type { HarnessSession, StepInput } from "#harness/types.js";
-export type ToolResponsePart = Extract<ModelMessage, {
-    role: "tool";
-}>["content"][number];
-/** Action results from one resolved batch, attributed to their originating turn. */
-export interface ResolvedInputActionBatch {
-    readonly event: PendingInputBatchEvent;
-    readonly results: readonly RuntimeToolResultActionResult[];
-}
-export type ResolvedStepInput = StepInput & {
-    readonly messageConsumed?: boolean;
-};
-export type InputDomainResolverInput = {
-    readonly baseHistory: ModelMessage[];
-    readonly batches: readonly PendingInputBatch[];
-    readonly deferTurnInput: boolean;
-    readonly resolvedStepInput: ResolvedStepInput | undefined;
-    readonly responses: readonly InputResponse[];
-    readonly session: HarnessSession;
-};
-export type ResolvePendingInputResult = {
-    readonly consumedMessage?: boolean;
-    readonly deferredContext?: boolean;
-    readonly deferredMessage?: boolean;
-    /** Present when a session-limit continuation prompt was resolved. */
-    readonly limitContinuation?: {
-        readonly granted: boolean;
-    };
-    readonly outcome: "resolved" | "continue" | "unresolved";
-    readonly messages: ModelMessage[];
-    readonly rejectedActions?: readonly ResolvedInputActionBatch[];
-    readonly resolvedInputs?: readonly ResolvedInputBatch[];
-    readonly session: HarnessSession;
-};
-export declare function responsesForBatches(responses: readonly InputResponse[], batches: readonly PendingInputBatch[]): readonly InputResponse[];
-export declare function appendResolvedBatchTranscript(messages: ModelMessage[], batch: PendingInputBatch, toolParts: readonly ToolResponsePart[]): void;
-export declare function finishResolvedInput(input: {
-    readonly deferTurnInput: boolean;
-    readonly leftoverResponses: readonly InputResponse[];
-    readonly limitContinuation?: {
-        readonly granted: boolean;
-    };
-    readonly messages: ModelMessage[];
-    readonly rejectedActions?: readonly ResolvedInputActionBatch[];
-    readonly resolvedInputs?: readonly ResolvedInputBatch[];
-    readonly resolvedStepInput: ResolvedStepInput | undefined;
-    readonly session: HarnessSession;
-}): ResolvePendingInputResult;
-export declare function compactStepInput(input: ResolvedStepInput | undefined): ResolvedStepInput;

package/dist/src/harness/hitl/pending-input-resolution.js

@@ -1 +0,0 @@
-import{attachClientContext,readClientContext}from"#internal/client-context.js";import{queueDeferredStepInput}from"#harness/pending-input-batches.js";function responsesForBatches(e,t){return e.filter(e=>t.some(t=>t.requests.some(t=>t.requestId===e.requestId)))}function appendResolvedBatchTranscript(e,t,n){e.push(...t.responseMessages),n.length>0&&e.push({content:[...n],role:`tool`})}function finishResolvedInput(e){let t={},n;if(e.leftoverResponses.length>0&&(t.inputResponses=e.leftoverResponses),e.deferTurnInput){(e.resolvedStepInput?.context?.length??0)>0&&(t.context=e.resolvedStepInput?.context);let r=readClientContext(e.resolvedStepInput);(r?.length??0)>0&&(n=r),e.resolvedStepInput?.message!==void 0&&(t.message=e.resolvedStepInput.message)}return attachClientContext(t,n),Object.keys(t).length>0?{consumedMessage:e.resolvedStepInput?.messageConsumed,deferredContext:t.context===void 0&&readClientContext(t)===void 0?void 0:!0,deferredMessage:t.message!==void 0||void 0,limitContinuation:e.limitContinuation,outcome:`resolved`,messages:e.messages,rejectedActions:e.rejectedActions,resolvedInputs:e.resolvedInputs,session:queueDeferredStepInput(e.session,t)}:{consumedMessage:e.resolvedStepInput?.messageConsumed,limitContinuation:e.limitContinuation,outcome:`resolved`,messages:e.messages,rejectedActions:e.rejectedActions,resolvedInputs:e.resolvedInputs,session:e.session}}function compactStepInput(e){if(e===void 0)return{};let t={};return(e.context?.length??0)>0&&(t.context=e.context),(e.inputResponses?.length??0)>0&&(t.inputResponses=e.inputResponses),e.message!==void 0&&(t.message=e.message),e.messageConsumed===!0&&(t.messageConsumed=!0),e.outputSchema!==void 0&&(t.outputSchema=e.outputSchema),attachClientContext(t,readClientContext(e))}export{appendResolvedBatchTranscript,compactStepInput,finishResolvedInput,responsesForBatches};

package/dist/src/harness/hitl/session-limit-input-requests.d.ts

@@ -1,12 +0,0 @@
-import type { PendingInputBatch } from "#harness/pending-input-batches.js";
-import type { InputDomainResolverInput, ResolvePendingInputResult } from "#harness/hitl/pending-input-resolution.js";
-import type { HarnessSession } from "#harness/types.js";
-/** Returns whether this is a valid session-limit batch and rejects mixed ownership. */
-export declare function isSessionLimitInputBatch(batch: PendingInputBatch): boolean;
-export declare function resolveSessionLimitInput(input: InputDomainResolverInput & {
-    readonly pendingBatch: PendingInputBatch;
-}): ResolvePendingInputResult;
-/** A batch of only harness-authored session-limit prompts, which a cancel drops. */
-export declare function isSessionLimitPromptBatch(batch: PendingInputBatch): boolean;
-/** Drops only harness-authored session-limit prompts from a parked session. */
-export declare function clearPendingSessionLimitPrompt(session: HarnessSession): HarnessSession;

package/dist/src/harness/hitl/session-limit-input-requests.js

@@ -1 +0,0 @@
-import{getPendingInputBatches,queueDeferredStepInput,removePendingInputBatches}from"#harness/pending-input-batches.js";import{buildResolvedInputBatch}from"#harness/input-request-resolution.js";import{appendResolvedBatchTranscript,compactStepInput,finishResolvedInput,responsesForBatches}from"#harness/hitl/pending-input-resolution.js";import{isSessionLimitContinuationRequest,resolveSessionLimitContinuation}from"#harness/session-limit-continuation.js";function isSessionLimitInputBatch(e){let t=e.requests.some(e=>e.kind===`session-limit`);if(t&&e.requests.some(e=>e.kind!==`session-limit`))throw TypeError(`Session-limit pending input batches must contain only session-limit requests.`);return t}function resolveSessionLimitInput(e){let t=new Set(e.responses.map(e=>e.requestId));if(!(e.pendingBatch.requests.some(e=>t.has(e.requestId))&&e.pendingBatch.requests.every(e=>t.has(e.requestId))))return{deferredMessage:!0,outcome:`unresolved`,messages:[...e.baseHistory],session:queueDeferredStepInput(e.session,compactStepInput(e.resolvedStepInput))};let n=e.batches.filter(t=>t!==e.pendingBatch),r=responsesForBatches(e.responses,n),i=n.some(e=>e.requests.some(e=>isSessionLimitContinuationRequest(e))),a=[...e.baseHistory];appendResolvedBatchTranscript(a,e.pendingBatch,[]);let o=removePendingInputBatches(e.session,[e.pendingBatch]),s=resolveSessionLimitContinuation({requests:e.pendingBatch.requests,responses:e.responses});return finishResolvedInput({deferTurnInput:e.deferTurnInput||i,leftoverResponses:r,limitContinuation:s,messages:a,resolvedInputs:[buildResolvedInputBatch(e.pendingBatch,e.responses)].filter(e=>e!==void 0),resolvedStepInput:e.resolvedStepInput,session:o})}function isSessionLimitPromptBatch(e){return e.requests.length>0&&e.requests.every(e=>isSessionLimitContinuationRequest(e))}function clearPendingSessionLimitPrompt(e){let t=getPendingInputBatches(e.state).filter(isSessionLimitPromptBatch);return t.length===0?e:removePendingInputBatches(e,t)}export{clearPendingSessionLimitPrompt,isSessionLimitInputBatch,isSessionLimitPromptBatch,resolveSessionLimitInput};

package/dist/src/harness/input-requests.d.ts

@@ -1,31 +0,0 @@
-import type { ModelMessage } from "ai";
-import type { InputRequest } from "#shared/input.js";
-import { getApprovedTools } from "#harness/hitl/approval-input-requests.js";
-import type { RejectedActionBatch } from "#harness/hitl/approval-input-requests.js";
-import type { PendingInputBatch } from "#harness/pending-input-batches.js";
-import type { ResolvePendingInputResult } from "#harness/hitl/pending-input-resolution.js";
-import { clearPendingSessionLimitPrompt } from "#harness/hitl/session-limit-input-requests.js";
-import type { HarnessSession, StepInput } from "#harness/types.js";
-export { getApprovedTools, clearPendingSessionLimitPrompt };
-export type { RejectedActionBatch };
-export type { ResolvedInputBatch } from "#harness/input-request-resolution.js";
-export { appendPendingInputBatch, consumeDeferredStepInput, getPendingInputRequestIds, hasPendingInputBatch, } from "#harness/pending-input-batches.js";
-/** Returns true when the step input carries user-facing turn input. */
-export declare function hasStepInput(input?: StepInput): boolean;
-/** Stored partial answers are not runnable work until they can resolve a batch. */
-export declare function hasRunnableDeferredStepInput(session: HarnessSession): boolean;
-/** Selects the complete approval batch that pending-input resolution will resume. */
-export declare function selectApprovalReplayBatch(session: HarnessSession, stepInput?: StepInput): PendingInputBatch | undefined;
-/**
- * Resolves pending input at the start of a harness step.
- *
- * Ordered batches remain independently answerable. Session-limit prompts own
- * resolution while open; approval batches preserve AI SDK's tail-message
- * requirement.
- */
-export declare function resolvePendingInput(input: {
-    readonly history?: readonly ModelMessage[];
-    readonly resolveApprovalKey?: (request: InputRequest) => string | undefined;
-    readonly session: HarnessSession;
-    readonly stepInput?: StepInput;
-}): ResolvePendingInputResult;

package/dist/src/harness/input-requests.js

@@ -1 +0,0 @@
-import{readClientContext}from"#internal/client-context.js";import{readAnswerText}from"#internal/input-text.js";import{resolveTextToResponses}from"#channel/resolve-text.js";import{appendPendingInputBatch,consumeDeferredStepInput,getDeferredStepInput,getPendingInputBatches,getPendingInputRequestIds,hasPendingInputBatch,queueDeferredStepInput}from"#harness/pending-input-batches.js";import{findAnsweredApprovalBatches,getApprovedTools,resolveApprovalInputBatches}from"#harness/hitl/approval-input-requests.js";import{isApprovalRequest}from"#harness/input-request-class.js";import{compactStepInput,finishResolvedInput}from"#harness/hitl/pending-input-resolution.js";import{hasTailApprovalResponse}from"#harness/current-messages.js";import{clearPendingSessionLimitPrompt,isSessionLimitInputBatch,resolveSessionLimitInput}from"#harness/hitl/session-limit-input-requests.js";function hasStepInput(e){return e===void 0?!1:e.message!==void 0||(e.inputResponses?.length??0)>0}function hasRunnableDeferredStepInput(e){let t=getDeferredStepInput(e);if(t===void 0)return!1;if(t.message!==void 0||(t.context?.length??0)>0||readClientContext(t)!==void 0||t.outputSchema!==void 0||(t.runtimeActionResults?.length??0)>0)return!0;let n=[...t.inputResponses??[],...(t.attributedInputResponses??[]).map(({response:e})=>e)];if(n.length===0)return!1;let r=getPendingInputBatches(e.state),i=routePendingInput(r);switch(i.kind){case`session-limit`:return i.batch.requests.every(e=>n.some(t=>t.requestId===e.requestId));case`approvals`:return findAnsweredApprovalBatches(r,n).length>0}}function selectApprovalReplayBatch(e,t){let n=getPendingInputBatches(e.state);if(n.some(isSessionLimitInputBatch))return;let r=canonicalizeInputResponses((n.length===1?resolveTextMessageInput(n[0],t):t)?.inputResponses??[]),i=findAnsweredApprovalBatches(n,r)[0];return i?.requests.some(e=>isApprovalRequest(e)&&r.some(t=>t.requestId===e.requestId&&t.optionId===`approve`))?i:void 0}function resolvePendingInput(e){let t=[...e.history??e.session.history],n=getPendingInputBatches(e.session.state),r=routePendingInput(n);if(r.kind===`approvals`&&hasTailApprovalResponse(t))return finishResolvedInput({deferTurnInput:!0,leftoverResponses:e.stepInput?.inputResponses??[],messages:t,resolvedStepInput:e.stepInput,session:e.session});if(n.length===0)return{outcome:`continue`,messages:t,session:e.session};let i=hasTailApprovalResponse(t),a=r.kind===`session-limit`?r.batch:n.length===1?n[0]:void 0,o=a===void 0?e.stepInput:resolveTextMessageInput(a,e.stepInput),s=canonicalizeInputResponses(o?.inputResponses??[]);if(s.length===0&&o?.message===void 0){let n=compactStepInput(o);return{outcome:`unresolved`,messages:t,session:n.context!==void 0||readClientContext(n)!==void 0||n.outputSchema!==void 0?queueDeferredStepInput(e.session,n):e.session}}let c={baseHistory:t,batches:n,deferTurnInput:i,resolvedStepInput:o,responses:s,session:e.session};switch(r.kind){case`session-limit`:return resolveSessionLimitInput({...c,pendingBatch:r.batch});case`approvals`:return resolveApprovalInputBatches({...c,resolveApprovalKey:e.resolveApprovalKey})}}function routePendingInput(e){let t=e.find(e=>isSessionLimitInputBatch(e));if(t!==void 0)return{batch:t,kind:`session-limit`};for(let t of e)for(let e of t.requests)if(!isApprovalRequest(e))throw TypeError(`Unhandled pending input request kind: ${e.kind}`);return{kind:`approvals`}}function canonicalizeInputResponses(e){let t=new Map;for(let n of e)t.set(n.requestId,n);return[...t.values()]}function resolveTextMessageInput(e,t){let n=readAnswerText(t);if(t===void 0||n===void 0)return t;let r=new Set(e.requests.map(e=>e.requestId));if(t.inputResponses?.some(e=>r.has(e.requestId)))return t;let i=new Set(e.responseAuthRequiredRequestIds??[]),a=e.requests.filter(e=>!i.has(e.requestId)),o=resolveTextToResponses(n,a);return o.length===0?t:compactStepInput({...t,inputResponses:[...t.inputResponses??[],...o],messageConsumed:!0,message:void 0})}export{appendPendingInputBatch,clearPendingSessionLimitPrompt,consumeDeferredStepInput,getApprovedTools,getPendingInputRequestIds,hasPendingInputBatch,hasRunnableDeferredStepInput,hasStepInput,resolvePendingInput,selectApprovalReplayBatch};

package/dist/src/harness/pending-input-batches.d.ts

@@ -1,81 +0,0 @@
-import type { ModelMessage } from "ai";
-import type { SessionAuthContext } from "#channel/types.js";
-import type { InputRequest } from "#shared/input.js";
-import type { HarnessSession, SessionStateMap, StepInput } from "#harness/types.js";
-/**
- * Stream-emit coordinates carried so a parked batch's resolution can attribute
- * its events to the turn and step that requested the input.
- */
-export interface PendingInputBatchEvent {
-    readonly sequence: number;
-    readonly stepIndex: number;
-    readonly turnId: string;
-}
-/**
- * Serializable pending input batch stored on the session state: one parked
- * assistant turn's requests plus its withheld model output.
- */
-export interface PendingInputBatch {
-    readonly event?: PendingInputBatchEvent;
-    readonly requests: readonly InputRequest[];
-    /**
-     * Auth of the caller whose turn parked the batch, captured when it parked;
-     * `null` when that caller was unauthenticated.
-     */
-    readonly requester?: SessionAuthContext | null;
-    readonly responseAuthRequiredRequestIds?: readonly string[];
-    readonly responseMessages: readonly ModelMessage[];
-}
-/**
- * Returns true when the session holds at least one pending HITL batch
- * (tool approvals or a session-limit continuation prompt).
- */
-export declare function hasPendingInputBatch(state: SessionStateMap | undefined): boolean;
-/**
- * Returns the request IDs across every pending HITL batch.
- */
-export declare function getPendingInputRequestIds(state: SessionStateMap | undefined): ReadonlySet<string>;
-/**
- * Reads the ordered pending batches. Sessions parked before the collection
- * shape carry the legacy singleton key; it reads as a one-element list and
- * is rewritten to the list shape on the next batch write.
- */
-export declare function getPendingInputBatches(state: SessionStateMap | undefined): readonly PendingInputBatch[];
-/**
- * Removes the given batches (matched by identity from a prior
- * {@link getPendingInputBatches} read) and keeps every other batch open.
- *
- * Removal is the only exported way to shrink the collection: a wholesale
- * setter would reintroduce the overwrite hazard the collection exists to
- * prevent — a writer clobbering batches it never resolved.
- */
-export declare function removePendingInputBatches(session: HarnessSession, batches: readonly PendingInputBatch[]): HarnessSession;
-/**
- * Appends one pending HITL batch for a parked assistant turn. Earlier
- * batches stay open and independently answerable.
- */
-export declare function appendPendingInputBatch(input: {
-    readonly event?: PendingInputBatchEvent;
-    readonly requests: readonly InputRequest[];
-    readonly responseAuthRequiredRequestIds?: readonly string[];
-    readonly responseMessages: readonly ModelMessage[];
-    readonly session: HarnessSession;
-}): HarnessSession;
-/** The requester recorded on the pending batch that holds `requestId`. */
-export declare function pendingInputRequester(state: SessionStateMap | undefined, requestId: string): SessionAuthContext | null;
-/**
- * Merges any queued follow-up input into the current step input and clears it
- * from session state.
- *
- * Used when the harness has to process a pending tool-approval response first
- * and defer the user's new message to the next internal model step.
- */
-export declare function consumeDeferredStepInput(input: {
-    readonly input?: StepInput;
-    readonly session: HarnessSession;
-}): {
-    readonly input?: StepInput;
-    readonly session: HarnessSession;
-};
-export declare function getDeferredStepInput(session: HarnessSession): StepInput | undefined;
-export declare function queueDeferredStepInput(session: HarnessSession, input: StepInput): HarnessSession;

package/dist/src/harness/pending-input-batches.js

@@ -1 +0,0 @@
-import{contextStorage}from"#context/container.js";import{AuthKey,SessionKey}from"#context/keys.js";import{coalesceTurnInputs}from"#harness/messages.js";const PENDING_INPUT_BATCHES_KEY=`eve.runtime.pendingInputBatches`,LEGACY_PENDING_INPUT_BATCH_KEY=`eve.runtime.pendingInputBatch`,DEFERRED_STEP_INPUT_KEY=`eve.runtime.deferredStepInput`;function hasPendingInputBatch(e){return getPendingInputBatches(e).length>0}function getPendingInputRequestIds(e){return new Set(getPendingInputBatches(e).flatMap(e=>e.requests.map(e=>e.requestId)))}function coercePendingInputBatch(e){if(typeof e!=`object`||!e)return;let t=e;if(Array.isArray(t.requests)&&Array.isArray(t.responseMessages))return t}function getPendingInputBatches(e){let t=e?.[PENDING_INPUT_BATCHES_KEY];if(Array.isArray(t)){let e=t.map(e=>coercePendingInputBatch(e)).filter(e=>e!==void 0);return assertUniqueRequestIds(e),e}let n=coercePendingInputBatch(e?.[LEGACY_PENDING_INPUT_BATCH_KEY]),r=n===void 0?[]:[n];return assertUniqueRequestIds(r),r}function assertUniqueRequestIds(e){let t=new Set;for(let n of e)for(let e of n.requests){if(t.has(e.requestId))throw TypeError(`Internal pending input invariant violated: requestId must be unique across all pending batches: ${JSON.stringify(e.requestId)}.`);t.add(e.requestId)}}function removePendingInputBatches(e,t){let n=new Set(t);return setPendingInputBatches(e,getPendingInputBatches(e.state).filter(e=>!n.has(e)))}function setPendingInputBatches(e,t){assertUniqueRequestIds(t);let n={...e.state};return delete n[LEGACY_PENDING_INPUT_BATCH_KEY],t.length===0?delete n[PENDING_INPUT_BATCHES_KEY]:n[PENDING_INPUT_BATCHES_KEY]=t.map(e=>({event:e.event,requester:e.requester,responseAuthRequiredRequestIds:e.responseAuthRequiredRequestIds,requests:[...e.requests],responseMessages:[...e.responseMessages]})),{...e,state:Object.keys(n).length>0?n:void 0}}function appendPendingInputBatch(e){return setPendingInputBatches(e.session,[...getPendingInputBatches(e.session.state),{event:e.event,requester:currentRequester(),responseAuthRequiredRequestIds:e.responseAuthRequiredRequestIds,requests:e.requests,responseMessages:e.responseMessages}])}function currentRequester(){let e=contextStorage.getStore(),t=e?.get(AuthKey)??e?.get(SessionKey)?.auth.current??null;return t?.principalType===`anonymous`?null:t}function pendingInputRequester(e,t){return getPendingInputBatches(e).find(e=>e.requests.some(e=>e.requestId===t))?.requester??null}function consumeDeferredStepInput(e){let t=getDeferredStepInput(e.session);if(t===void 0)return e;let n=clearDeferredStepInput(e.session);return e.input===void 0?{input:t,session:n}:{input:coalesceTurnInputs(t,e.input),session:n}}function getDeferredStepInput(e){return e.state?.[DEFERRED_STEP_INPUT_KEY]}function queueDeferredStepInput(e,t){let n=getDeferredStepInput(e),r=n===void 0?t:coalesceTurnInputs(n,t),i={...e.state};return i[DEFERRED_STEP_INPUT_KEY]=r,{...e,state:i}}function clearDeferredStepInput(e){if(e.state?.[DEFERRED_STEP_INPUT_KEY]===void 0)return e;let t={...e.state};return delete t[DEFERRED_STEP_INPUT_KEY],{...e,state:Object.keys(t).length>0?t:void 0}}export{appendPendingInputBatch,consumeDeferredStepInput,getDeferredStepInput,getPendingInputBatches,getPendingInputRequestIds,hasPendingInputBatch,pendingInputRequester,queueDeferredStepInput,removePendingInputBatches};

package/dist/src/harness/session-limit-continuation.js

@@ -1 +0,0 @@
-const SESSION_LIMIT_CONTINUE_OPTION_ID=`continue`,SESSION_LIMIT_STOP_OPTION_ID=`stop`;function createSessionLimitContinuationRequest(e){let{sessionId:t,violation:n}=e,r=n.kind===`token-cost`?n.usedCostUsd:n.usedTokens,i=`${t}:limit:${n.kind}:${String(r)}`;return{action:{callId:i,input:n.kind===`token-cost`?{kind:n.kind,limitUsd:n.limitUsd,usedCostUsd:n.usedCostUsd}:{kind:n.kind,limit:n.limit,usedTokens:n.usedTokens},kind:`tool-call`,toolName:`session_limit_continuation`},allowFreeform:!1,display:`confirmation`,kind:`session-limit`,options:[{description:n.kind===`token-cost`?`Grant a fresh model token-cost budget`:`Grant a fresh token budget`,id:SESSION_LIMIT_CONTINUE_OPTION_ID,label:`Approve`,style:`primary`},{description:`Stop now`,id:SESSION_LIMIT_STOP_OPTION_ID,label:`Stop`,style:`danger`}],prompt:formatSessionLimitPrompt(n),requestId:i}}function formatCompactTokenCount(e){return e>=1e6?`${trimTrailingZero(e/1e6)}M`:e>=1e3?`${trimTrailingZero(e/1e3)}K`:String(e)}function trimTrailingZero(e){let t=e.toFixed(1);return t.endsWith(`.0`)?t.slice(0,-2):t}function formatSessionLimitPrompt(e){return`This session has hit the ${e.kind===`token-cost`?`${formatUsd(e.limitUsd)} model token-cost limit per session`:`${e.kind}-token limit (${formatCompactTokenCount(e.limit)}) per session`}. This is a guardrail against defective long-running sessions. If session activity looks fine, just approve to keep going.`}function formatUsd(e){return`$${(e<1e-6?String(e):e.toFixed(6)).replace(/0+$/u,``).replace(/\.$/u,``)}`}function isSessionLimitContinuationRequest(e){return e.kind===`session-limit`}function isSessionLimitContinuationRequestId(e){return/:limit:(?:input|output):\d+$/u.test(e)||/:limit:token-cost:\d+(?:\.\d+)?(?:e[+-]?\d+)?$/iu.test(e)}function resolveSessionLimitContinuation(e){let t=e.requests.find(isSessionLimitContinuationRequest);if(t===void 0)return;let n=e.responses.find(e=>e.requestId===t.requestId);if(n!==void 0){if(n.optionId===SESSION_LIMIT_CONTINUE_OPTION_ID)return{granted:!0};if(n.optionId===`stop`)return{granted:!1}}}export{SESSION_LIMIT_STOP_OPTION_ID,createSessionLimitContinuationRequest,isSessionLimitContinuationRequest,isSessionLimitContinuationRequestId,resolveSessionLimitContinuation};

package/dist/src/harness/session-limit-enforcement.d.ts

@@ -1,45 +0,0 @@
-import { type HarnessEmissionState } from "#harness/emission.js";
-import type { HarnessModelMessage } from "#harness/messages.js";
-import type { HarnessSession, StepResult, ToolLoopHarnessConfig } from "#harness/types.js";
-interface SessionLimitPolicyInput {
-    readonly config: ToolLoopHarnessConfig;
-    readonly emit?: ToolLoopHarnessConfig["handleEvent"];
-    readonly emissionState: HarnessEmissionState;
-    readonly session: HarnessSession;
-}
-/**
- * Acts on a resolved session-limit continuation answer.
- *
- * Granted: bumps the runtime token limits via
- * {@link bumpSessionRuntimeUsageLimits} and lets the step continue
- * transparently.
- * Declined: a user decision, not an error — the decline cancels the
- * in-flight turn tree through the standard cancellation path, settling as
- * `turn.cancelled` → `session.waiting` with no failure surfaced anywhere.
- * The harness only declares the intent by throwing
- * {@link SessionLimitDeclinedError}; the execution layer detects it at the
- * step boundary and cancels the root turn, whose cancelled arm cascades to
- * every descendant, so the delegating parent never receives an error result
- * it could retry against a fresh budget share.
- *
- * Returns `result: null` when the step should continue with `session`.
- */
-export declare function applySessionLimitContinuation(input: SessionLimitPolicyInput & {
-    readonly limitContinuation: {
-        readonly granted: boolean;
-    } | undefined;
-}): Promise<{
-    readonly result: StepResult | null;
-    readonly session: HarnessSession;
-}>;
-/**
- * Pre-model-call gate for the session token budget.
- *
- * Returns `null` when the session is within budget. Over budget, sessions
- * that can request input park on the deterministic continuation prompt;
- * others fail fast with `SESSION_TOKEN_LIMIT_REACHED`.
- */
-export declare function enforceSessionUsageLimit(input: SessionLimitPolicyInput & {
-    readonly messages: readonly HarnessModelMessage[];
-}): Promise<StepResult | null>;
-export {};

package/dist/src/harness/session-limit-enforcement.js

@@ -1 +0,0 @@
-import{createInputRequestedEvent}from"#protocol/message.js";import{emitFailedStep,emitTurnEpilogue,setHarnessEmissionState}from"#harness/emission.js";import{bumpSessionRuntimeUsageLimits,getSessionTokenUsage,getSessionUsage,getSessionUsageLimitViolation}from"#harness/turn-tag-state.js";import{SessionLimitDeclinedError}from"#harness/turn-cancellation.js";import{appendPendingInputBatch}from"#harness/input-requests.js";import{createSessionLimitContinuationRequest}from"#harness/session-limit-continuation.js";async function applySessionLimitContinuation(e){if(e.limitContinuation===void 0)return{result:null,session:e.session};if(e.limitContinuation.granted)return{result:null,session:bumpSessionRuntimeUsageLimits(e.session)};throw new SessionLimitDeclinedError}async function enforceSessionUsageLimit(e){let t=getSessionUsageLimitViolation(e.session);if(t===null)return null;let{emit:n}=e;return violationWindow(t)>0&&n!==void 0&&e.config.capabilities?.requestInput===!0?parkOnSessionUsageLimit({...e,emit:n,violation:t}):failSessionUsageLimit({...e,violation:t})}async function parkOnSessionUsageLimit(e){let t=createSessionLimitContinuationRequest({sessionId:e.session.sessionId,violation:e.violation}),n=e.emissionState,r=appendPendingInputBatch({event:{sequence:n.sequence,stepIndex:n.stepIndex,turnId:n.turnId},requests:[t],responseMessages:[],session:{...e.session,history:[...e.messages]}});return await e.emit(createInputRequestedEvent({requests:[t],sequence:n.sequence,stepIndex:n.stepIndex,turnId:n.turnId})),n=await emitTurnEpilogue(e.emit,n,r.history,getSessionUsage(r)),{next:null,session:setHarnessEmissionState(r,n)}}function violationWindow(e){return e.kind===`token-cost`?e.limitUsd:e.limit}function formatSessionLimitMessage(e){return e===`token-cost`?`The session reached its configured model token-cost limit.`:`The session reached its configured ${e} token limit.`}async function failSessionUsageLimit(e){let t=getSessionTokenUsage(e.session),n=formatSessionLimitMessage(e.violation.kind),r=e.violation.kind===`token-cost`?{costUsd:t.costUsd,kind:e.violation.kind,limitUsd:e.violation.limitUsd,usedCostUsd:e.violation.usedCostUsd}:{inputTokens:t.inputTokens,kind:e.violation.kind,limit:e.violation.limit,outputTokens:t.outputTokens,usedTokens:e.violation.usedTokens};return e.emit&&await emitFailedStep(e.emit,e.emissionState,{code:e.violation.kind===`token-cost`?`SESSION_TOKEN_COST_LIMIT_REACHED`:`SESSION_TOKEN_LIMIT_REACHED`,details:r,message:n,sessionId:e.session.sessionId,usage:getSessionUsage(e.session)}),{next:{done:!0,output:``},session:e.session}}export{applySessionLimitContinuation,enforceSessionUsageLimit};

package/dist/src/harness/stale-input-responses.js

@@ -1,3 +0,0 @@
-import{appendUserContent,normalizeUserContent}from"#harness/messages.js";import{extractHistoricalInputRequests}from"#harness/input-extraction.js";import{isSessionLimitContinuationRequestId}from"#harness/session-limit-continuation.js";function dropStaleSessionLimitContinuationResponses(e){if(e.stepInput===void 0)return;let t=e.stepInput.inputResponses??[],n=e.stepInput.attributedInputResponses??[],keep=t=>e.pendingRequestIds.has(t)||!isSessionLimitContinuationRequestId(t),r=t.filter(e=>keep(e.requestId)),i=n.filter(({response:e})=>keep(e.requestId));if(r.length===t.length&&i.length===n.length)return e.stepInput;let{attributedInputResponses:a,inputResponses:o,...s}=e.stepInput,c=s;return r.length>0&&(c.inputResponses=r),i.length>0&&(c.attributedInputResponses=i),c}function convertStaleResponsesToUserMessage(e){if(e.stepInput===void 0)return{kind:`unchanged`};let t=e.stepInput.inputResponses??[],n=e.stepInput.attributedInputResponses??[];if(t.length===0&&n.length===0)return{kind:`unchanged`,stepInput:e.stepInput};let r=[],i=[],a=[];for(let n of t)(e.pendingRequestIds.has(n.requestId)?r:a).push(n);for(let t of n)e.pendingRequestIds.has(t.response.requestId)?i.push(t):a.push(t.response);if(a.length===0)return{kind:`unchanged`,stepInput:e.stepInput};let o=extractHistoricalInputRequests({history:e.history,requestIds:new Set(a.map(e=>e.requestId))}),s=appendOptionalUserContent(e.stepInput.message,formatModelMessage(a,o)),c=appendOptionalUserContent(e.stepInput.message,formatDisplayMessage(a,o)),{attributedInputResponses:l,inputResponses:u,...d}=e.stepInput,f={...d,message:s};return r.length>0&&(f.inputResponses=r),i.length>0&&(f.attributedInputResponses=i),{displayMessage:c,kind:`converted`,stepInput:f}}function formatModelMessage(e,t){let n=e.map(e=>{let n=t.get(e.requestId),r=n?.options?.find(t=>t.id===e.optionId),i={};if(e.optionId!==void 0&&(i.optionId=e.optionId),r!==void 0){let e={id:r.id,label:r.label};r.description!==void 0&&(e.description=r.description),i.selectedOption=e}e.text!==void 0&&(i.text=e.text);let a={requestId:e.requestId,response:i};return n!==void 0&&(a.prompt=n.prompt,a.requestType=`approval`,a.toolName=n.action.toolName),a});return[`The user submitted the following response to an earlier interactive prompt.`,`Treat it as new input at the current point in the conversation and decide whether it is still relevant. This does not authorize an earlier action; request approval again if that action is still needed.`,JSON.stringify(n,null,2)].join(`
-`)}function formatDisplayMessage(e,t){return e.map(e=>e.text!==void 0&&e.text.length>0?e.text:t.get(e.requestId)?.options?.find(t=>t.id===e.optionId)?.label??e.optionId??`Response to an earlier interactive prompt`).join(`
-`)}function appendOptionalUserContent(e,t){let n=normalizeUserContent(e);return n===void 0?t:appendUserContent({appended:t,existing:n})}export{convertStaleResponsesToUserMessage,dropStaleSessionLimitContinuationResponses};

package/dist/src/harness/workflow-dispatch.d.ts

@@ -1,30 +0,0 @@
-import type { ModelMessage } from "ai";
-import { type CoordinationToolCall } from "#harness/coordination.js";
-import type { ResolvedInputBatch } from "#harness/input-request-resolution.js";
-import type { HarnessSession, HarnessToolMap } from "#harness/types.js";
-import type { RuntimeWorkflowTaskRequest } from "#shared/action-types.js";
-/**
- * Parks the step on the workflow tools a person just approved. The approval
- * tool message moves into the batch's response so workflow results join it:
- * AI SDK then resumes approved sibling tools without replaying the workflows.
- */
-export declare function dispatchApprovedWorkflowCalls(input: {
-    readonly messages: readonly ModelMessage[];
-    readonly resolvedInputs: readonly ResolvedInputBatch[] | undefined;
-    readonly session: HarnessSession;
-    readonly tools: HarnessToolMap;
-}): HarnessSession | undefined;
-/**
- * Turns a step's deferred calls into workflow runs, committing a task record
- * for each call that starts a task. Task tool calls stay in the response
- * alone: the session reads them from there.
- */
-export declare function collectDeferredCalls(input: {
-    readonly session: HarnessSession;
-    readonly toolCalls: readonly CoordinationToolCall[];
-    readonly tools: HarnessToolMap;
-    readonly turnId: string;
-}): {
-    readonly session: HarnessSession;
-    readonly workflowRequests: readonly RuntimeWorkflowTaskRequest[];
-};

package/dist/src/harness/workflow-dispatch.js

@@ -1 +0,0 @@
-import{validateHarnessModelMessages}from"#harness/messages.js";import{createCoordinationRequestFromToolCall,resolveToolCallInputObject,setPendingCoordinationBatch}from"#harness/coordination.js";import{hasTailApprovalResponse}from"#harness/current-messages.js";import{commitCallEntry,isTaskTool}from"#execution/tasks/model-step.js";function dispatchApprovedWorkflowCalls(e){for(let t of e.resolvedInputs??[]){let n=t.inputs.filter(({outcome:t,request:n})=>t===`approved`&&e.tools.get(n.action.toolName)?.workflowId!==void 0);if(n.length===0)continue;if(!hasTailApprovalResponse(e.messages))throw Error(`Approved workflow calls must follow their approval tool message.`);let r=collectDeferredCalls({session:e.session,toolCalls:n.map(({request:e})=>({input:e.action.input,toolCallId:e.action.callId,toolName:e.action.toolName})),tools:e.tools,turnId:t.event.turnId});return setPendingCoordinationBatch({tasks:r.workflowRequests,event:t.event,responseMessages:e.messages.slice(-1),session:{...r.session,history:validateHarnessModelMessages(e.messages.slice(0,-1))}})}}function collectDeferredCalls(e){let{session:t}=e,n=[];for(let r of e.toolCalls){let i=e.tools.get(r.toolName);if(isTaskTool(i))continue;let a=commitCallEntry(t,{callId:r.toolCallId,definition:i,input:resolveToolCallInputObject(r.input,{callId:r.toolCallId,toolName:r.toolName}),toolName:r.toolName,turnId:e.turnId});t=a.session,n.push(createCoordinationRequestFromToolCall({entry:a.entry,input:a.input,toolCall:r,tools:e.tools}))}return{session:t,workflowRequests:n}}export{collectDeferredCalls,dispatchApprovedWorkflowCalls};

package/dist/src/public/channels/linear/inbound-images.d.ts

@@ -1,19 +0,0 @@
-import type { UserContent } from "ai";
-import type { LinearFetch } from "#public/channels/linear/api.js";
-import { type LinearChannelCredentials } from "#public/channels/linear/auth.js";
-/** One trusted Linear upload referenced by markdown image syntax. */
-interface LinearUploadImageReference {
-    readonly altText: string;
-    readonly end: number;
-    readonly start: number;
-    readonly url: URL;
-}
-/** Extracts markdown image references that target Linear's exact upload origin. */
-export declare function extractLinearUploadImageReferences(markdown: string): readonly LinearUploadImageReference[];
-/** Adds authenticated Linear upload images to otherwise text-only inbound content. */
-export declare function attachLinearInboundImages(input: {
-    readonly content: UserContent;
-    readonly credentials?: LinearChannelCredentials;
-    readonly fetch?: LinearFetch;
-}): Promise<UserContent>;
-export {};

package/dist/src/public/channels/linear/inbound-images.js

@@ -1 +0,0 @@
-import{resolveLinearAccessToken}from"#public/channels/linear/auth.js";const MARKDOWN_IMAGE_PATTERN=/!\[([^\]\r\n]*)\]\(\s*(?:<([^>\r\n]+)>|([^\s)\r\n]+))(?:\s+(?:"[^"\r\n]*"|'[^'\r\n]*'|\([^)\r\n]*\)))?\s*\)/gu;function extractLinearUploadImageReferences(e){let t=[];for(let n of e.matchAll(MARKDOWN_IMAGE_PATTERN)){let e=n[2]??n[3],r=n.index;if(e===void 0||r===void 0)continue;let i=parseLinearUploadUrl(e);i!==null&&t.push({altText:n[1]??``,end:r+n[0].length,start:r,url:i})}return t}async function attachLinearInboundImages(e){if(typeof e.content!=`string`)return e.content;let t=extractLinearUploadImageReferences(e.content);if(t.length===0)return e.content;let n;try{n=await resolveLinearAccessToken(e.credentials?.accessToken)}catch{return e.content}let r=e.fetch??fetch,i=await Promise.all(t.map(e=>fetchLinearUploadImage(e.url,n,r)));return i.every(e=>e===null)?e.content:buildLinearImageContent(e.content,t,i)}function parseLinearUploadUrl(e){let t;try{t=new URL(e)}catch{return null}return t.origin!==`https://uploads.linear.app`||t.username!==``||t.password!==``?null:t}async function fetchLinearUploadImage(e,t,n){if(parseLinearUploadUrl(e.href)===null)return null;try{let r=await n(e.href,{credentials:`omit`,headers:{accept:`image/*`,authorization:`Bearer ${t}`},redirect:`manual`});if(!r.ok)return null;let i=readImageMediaType(r.headers.get(`content-type`));return i===null?null:{data:Buffer.from(await r.arrayBuffer()),mediaType:i,type:`file`}}catch{return null}}function readImageMediaType(e){let t=e?.split(`;`,1)[0]?.trim().toLowerCase();return t?.startsWith(`image/`)===!0&&t.length>6?t:null}function buildLinearImageContent(e,t,n){let r=0,i=``,a=[];for(let[o,s]of t.entries()){let t=n[o];t!=null&&(i+=e.slice(r,s.start),i+=s.altText,r=s.end,a.push(t))}return i+=e.slice(r),i.trim().length===0?a:[{text:i,type:`text`},...a]}export{attachLinearInboundImages,extractLinearUploadImageReferences};

package/dist/src/tracing/agent-action-instrumentation.d.ts

@@ -1,25 +0,0 @@
-import { type Context, type SpanContext, type Tracer } from "#compiled/@opentelemetry/api/index.js";
-import type { InstrumentationActionStartedEvent, InstrumentationAttemptScope, InstrumentationProviderDefinition } from "#instrumentation/lifecycle.js";
-import type { AgentSpanIdGenerator } from "#tracing/agent-span-id-generator.js";
-import type { AgentTraceStateStore } from "#tracing/agent-trace-state.js";
-interface AgentActionInstrumentation {
-    readonly events: Pick<NonNullable<InstrumentationProviderDefinition["events"]>, "action.completed" | "action.failed" | "action.started">;
-    deleteForSession(sessionId: string): void | PromiseLike<void>;
-    failForAttempt(scope: InstrumentationAttemptScope, error: unknown): Promise<void>;
-    contextFor(sessionId: string, turnId: string, callId: string): Promise<AgentActionContext | undefined>;
-}
-export interface AgentActionContext {
-    readonly context: Context;
-    readonly spanContext: SpanContext;
-}
-/** Builds durable `agent.action` spans around eve's runtime dispatch boundary. */
-export declare function createAgentActionInstrumentation(input: {
-    readonly frameworkVersion: string;
-    readonly idGenerator: AgentSpanIdGenerator;
-    readonly recordInputs: boolean;
-    readonly recordOutputs: boolean;
-    readonly resolveTraceContext: (event: InstrumentationActionStartedEvent) => SpanContext | undefined | PromiseLike<SpanContext | undefined>;
-    readonly stateStore: AgentTraceStateStore;
-    readonly tracer: Tracer;
-}): AgentActionInstrumentation;
-export {};

package/dist/src/tracing/agent-action-instrumentation.js

@@ -1 +0,0 @@
-import{normalizeChannelAudience}from"#shared/channel-audience.js";import{AGENT_SPAN_NAMES}from"#tracing/agent-span-contract.js";import{isSampledTrace}from"#tracing/sampled-trace.js";import{ROOT_CONTEXT,SpanKind,trace}from"#compiled/@opentelemetry/api/index.js";import{actionIdempotencyKey,attemptIdempotencyKey}from"#instrumentation/lifecycle.js";import{agentSpanNamingAttributes}from"#tracing/agent-span-naming.js";import{contentAttribute,textContentAttribute}from"#tracing/agent-otel-content.js";import{recordAgentSpanError}from"#tracing/agent-span-error.js";import{agentTraceIdentityAttributes,traceSessionIdOf}from"#tracing/agent-otel-attributes.js";import{setAgentUsage}from"#tracing/agent-otel-usage.js";import{withChannelAudience}from"#tracing/channel-audience-context.js";function createAgentActionInstrumentation(e){let t=new Map,onStarted=async n=>{let r=await e.resolveTraceContext(n);if(r===void 0||!isSampledTrace(r))return;let i=await e.stateStore.getAction(n.idempotencyKey)??{attemptIndex:n.scope.attemptIndex,callId:n.callId,channelAudience:normalizeChannelAudience(n.scope.channelAudience),inputAttribute:e.recordInputs?contentAttribute(n.input):void 0,kind:n.kind,name:n.name,parent:{spanId:e.idGenerator.deriveSpanId(attemptIdempotencyKey(n.scope)),traceFlags:r.traceFlags,traceId:r.traceId},rootSessionId:n.scope.rootSessionId??n.scope.sessionId,traceSessionId:traceSessionIdOf(n.scope),sessionId:n.scope.sessionId,spanId:e.idGenerator.deriveSpanId(`action:${n.idempotencyKey}`),startTimeMs:Date.now(),stepIndex:n.scope.stepIndex,turnId:n.scope.turnId};await e.stateStore.setAction(n.idempotencyKey,i),n.isWorkflowTool===!0&&await e.stateStore.setActionAnchor(n.idempotencyKey,i);let a=t.get(n.scope.attemptId)??new Set;a.add(n.idempotencyKey),t.set(n.scope.attemptId,a)},onTerminal=async t=>{let n=await e.stateStore.getAction(t.idempotencyKey);if(n!==void 0)try{finishActionSpan(n,t)}finally{await e.stateStore.deleteAction(t.idempotencyKey),forget(t.idempotencyKey)}},startSpan=t=>{let n=isAgentInvocation(t.kind),r=e.idGenerator.withSpanId(t.spanId,()=>e.tracer.startSpan(AGENT_SPAN_NAMES.action,{attributes:{"agent.action.call_id":t.callId,"agent.action.kind":t.kind,"agent.action.name":t.name,"agent.framework.name":`eve`,"agent.framework.version":e.frameworkVersion,"agent.step.attempt":t.attemptIndex,"agent.step.index":t.stepIndex,"agent.turn.id":t.turnId,...agentSpanNamingAttributes(AGENT_SPAN_NAMES.action),...agentTraceIdentityAttributes({rootSessionId:t.rootSessionId,traceSessionId:t.traceSessionId,sessionId:t.sessionId}),...n?{"gen_ai.agent.name":t.name,"agent.invocation.role":`caller`}:void 0},kind:t.kind===`remote-agent-call`?SpanKind.CLIENT:SpanKind.INTERNAL,startTime:t.startTimeMs},contextFromActionState(t)));return!n&&t.inputAttribute!==void 0&&r.setAttribute(`gen_ai.tool.call.arguments`,t.inputAttribute),r};return{async contextFor(t,n,r){let i=actionIdempotencyKey(t,n,r),a=await e.stateStore.getAction(i);if(a!==void 0)return actionContext(a);let o=await e.stateStore.findAction(t,r);return o===void 0?void 0:actionContext(o)},async deleteForSession(t){await e.stateStore.deleteActions(t),await e.stateStore.deleteActionAnchors(t)},async failForAttempt(n,r){let i=t.get(n.attemptId);if(i!==void 0){t.delete(n.attemptId);for(let t of i){let n=await e.stateStore.getAction(t);if(n===void 0)continue;let i=startSpan(n);recordAgentSpanError(i,r),i.end(),await e.stateStore.deleteAction(t)}}},events:{"action.completed":onTerminal,"action.failed":onTerminal,"action.started":onStarted}};function forget(e){for(let[n,r]of t)r.delete(e),r.size===0&&t.delete(n)}function finishActionSpan(t,n){let r=startSpan(t);if(r.setAttribute(`agent.action.outcome`,n.outcome),n.usage!==void 0&&setAgentUsage(r,n.usage),n.type===`action.failed`)n.errorCode!==void 0&&r.setAttribute(`agent.action.error.code`,n.errorCode),recordActionError(r,n.error,n.errorCode);else if(n.output.type===`error`)recordActionError(r,n.output.error);else if(e.recordOutputs&&!isAgentInvocation(t.kind)){let e=contentAttribute(n.output.output);e!==void 0&&r.setAttribute(`gen_ai.tool.call.result`,e)}r.end(n.acceptedAtMs)}}function actionContext(e){let t={isRemote:!1,spanId:e.spanId,traceFlags:e.parent.traceFlags,traceId:e.parent.traceId};return{context:withChannelAudience(trace.setSpan(ROOT_CONTEXT,trace.wrapSpanContext(t)),e.channelAudience),spanContext:t}}function contextFromActionState(e){return withChannelAudience(trace.setSpan(ROOT_CONTEXT,trace.wrapSpanContext({...e.parent,isRemote:!1})),e.channelAudience)}function isAgentInvocation(e){return e===`subagent-call`||e===`remote-agent-call`}function recordActionError(e,t,n){if(t instanceof Error||t===void 0){recordAgentSpanError(e,t,n);return}let r=serializedErrorDetail(t);if(r===void 0){recordAgentSpanError(e,void 0,n);return}let i=Error(r);n!==void 0&&(i.name=n),recordAgentSpanError(e,i,n)}function serializedErrorDetail(e){if(typeof e==`string`)return textContentAttribute(e);let t=contentAttribute(e);if(typeof e!=`object`||!e||Array.isArray(e))return t;let n=Reflect.get(e,`message`);return typeof n==`string`?textContentAttribute(t===void 0?n:`${n}\n${t}`):t}export{createAgentActionInstrumentation};