@robota-sdk/agent-framework 3.0.0-beta.78 → 3.0.0-beta.81

package/dist/node/testing/index.cjs

@@ -1,2 +1,2 @@
-Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=require("../interactive-D1dVksoo.cjs");let t=require("node:path"),n=require("node:os"),r=require("node:fs"),i=require("@robota-sdk/agent-core/testing");const a=[`text_delta`,`tool_start`,`tool_end`,`thinking`,`complete`,`interrupted`,`error`,`context_update`,`goal_event`,`turn_source`,`user_message`];var o=class{cwd;session;requests;events=new Map;completions=[];sessionStore;ownsWorkspace;disposed=!1;constructor(o){if(this.ownsWorkspace=o.cwd===void 0,this.cwd=o.cwd??(0,r.mkdtempSync)((0,t.join)((0,n.tmpdir)(),`robota-fxn-`)),this.ownsWorkspace)for(let[e,n]of Object.entries(o.files??{})){let i=(0,t.join)(this.cwd,e);(0,r.mkdirSync)((0,t.dirname)(i),{recursive:!0}),(0,r.writeFileSync)(i,n,`utf8`)}if([o.turns,o.cassette,o.record].filter(e=>e!==void 0).length!==1)throw Error("scriptedSession requires exactly one of `turns`, `cassette`, or `record`.");let s;s=o.cassette?(0,i.createReplayProvider)({cassettePath:o.cassette,scrub:[this.cwd],rewriteCwd:this.cwd}):o.record?(0,i.createRecordingProvider)({provider:o.record.provider,cassettePath:o.record.toCassette,recordCwd:this.cwd}):(0,i.createScriptedProvider)(this.substituteWorkspacePath(o.turns??[])).provider,this.requests=[];let c={...s,chat:(e,t)=>(this.requests.push([...e]),s.chat(e,t))};this.sessionStore=o.persistence?e.n(this.cwd):void 0,this.session=new e.s({cwd:this.cwd,provider:c,bare:o.bare??!0,permissionMode:o.permissionMode??`bypassPermissions`,...o.allowedTools?{allowedTools:o.allowedTools}:{},...o.deniedTools?{deniedTools:o.deniedTools}:{},...this.sessionStore?{sessionStore:this.sessionStore}:{},...o.resumeSessionId?{resumeSessionId:o.resumeSessionId}:{},...o.forkSession?{forkSession:o.forkSession}:{},...o.commandModules?{commandModules:o.commandModules}:{},...o.maxTurns===void 0?{}:{maxTurns:o.maxTurns},...o.model===void 0?{}:{model:o.model},...o.terminalHandoff?{terminalHandoff:o.terminalHandoff}:{},...o.askHandler?{askHandler:o.askHandler}:{}});for(let e of a)this.session.on(e,((...t)=>{this.record(e,t),(e===`complete`||e===`interrupted`)&&this.completions.push(t[0])}))}substituteWorkspacePath(e){return e.map(e=>`toolCalls`in e?{toolCalls:e.toolCalls.map(e=>({name:e.name,args:JSON.parse(JSON.stringify(e.args).split(`{{cwd}}`).join(this.cwd))}))}:e)}record(e,t){let n=this.events.get(e)??[];n.push(t),this.events.set(e,n)}async submit(e){let t=this.nextSettledTurn();return await this.session.submit(e),t}async runGoal(e,t={}){let n=new Promise((e,t)=>{let n=t=>{t.type===`goal_stopped`&&(i(),e(t.goal))},r=e=>{i(),t(e)},i=()=>{this.session.off(`goal_event`,n),this.session.off(`error`,r)};this.session.on(`goal_event`,n),this.session.on(`error`,r)});return await this.session.setGoal(e,t.maxIterations?{maxIterations:t.maxIterations}:{}),n}command(e,t=``){return this.session.executeCommand(e,t)}async wake(e,t){return this.session.requestWakeup(e,t)?this.nextSettledTurn():null}awaitEvent(e,t){return new Promise(n=>{let r=((...i)=>{let a=i;t&&!t(...a)||(this.session.off(e,r),n(a))});this.session.on(e,r)})}nextSettledTurn(){return new Promise((e,t)=>{let n=t=>{i(),e(t)},r=e=>{i(),t(e)},i=()=>{this.session.off(`complete`,n),this.session.off(`interrupted`,n),this.session.off(`error`,r)};this.session.on(`complete`,n),this.session.on(`interrupted`,n),this.session.on(`error`,r)})}history(){return this.session.getMessages()}sessionRecord(){if(this.sessionStore)return this.sessionStore.load(this.session.getSession().getSessionId())}sessionLog(){return{id:this.session.getSession().getSessionId(),history:this.session.getFullHistory()}}logsDir(){return(0,t.join)(this.cwd,`.robota`,`logs`)}transcriptPath(){return(0,t.join)(this.logsDir(),`${this.session.getSession().getSessionId()}.jsonl`)}transcript(){let e=this.transcriptPath();return(0,r.existsSync)(e)?(0,r.readFileSync)(e,`utf8`):``}logEntries(){return this.transcript().split(`
-`).filter(e=>e.trim().length>0).map(e=>JSON.parse(e))}toolCalls(){return this.completions.flatMap(e=>e.toolSummaries)}emittedEvents(e){return this.events.get(e)??[]}readFile(e){return(0,r.readFileSync)((0,t.join)(this.cwd,e),`utf8`)}exists(e){return(0,r.existsSync)((0,t.join)(this.cwd,e))}files(){let e=[],n=i=>{for(let a of(0,r.readdirSync)(i,{withFileTypes:!0})){if(a.name===`.robota`)continue;let r=(0,t.join)(i,a.name);a.isDirectory()?n(r):e.push((0,t.relative)(this.cwd,r).split(t.sep).join(`/`))}};return n(this.cwd),e.sort()}async dispose(){this.disposed||(this.disposed=!0,await this.session.shutdown({reason:`other`,message:`functional test complete`}),this.ownsWorkspace&&(0,r.rmSync)(this.cwd,{recursive:!0,force:!0,maxRetries:5,retryDelay:20}))}};function s(e){return new o(e)}const c={usedTokens:0,maxTokens:2e5,usedPercentage:0,remainingPercentage:100},l={sessionId:`test-session-id`,updatedAt:new Date().toISOString(),entries:[]},u={id:`test-goal`,objective:`test goal`,status:`active`,iterations:0,maxIterations:25,startedAt:new Date().toISOString(),progress:[]},d={id:``,parentSessionId:`test-session-id`,waitPolicy:`wait_all`,taskIds:[],status:`completed`,createdAt:new Date().toISOString(),updatedAt:new Date().toISOString(),results:[]};function f(e){return{submit:()=>Promise.resolve(),abort:()=>{},cancelQueue:()=>{},shutdown:()=>Promise.resolve(),isExecuting:()=>!1,getPendingPrompt:()=>null,getMessages:()=>[],getContextState:()=>({...c}),getSession:()=>({getSessionId:()=>`test-session-id`}),getCwd:()=>`/workspace`,executeCommand:()=>Promise.resolve(null),listCommands:()=>[],on:()=>{},off:()=>{},listBackgroundTasks:()=>[],getBackgroundTask:()=>void 0,cancelBackgroundTask:()=>Promise.resolve(),closeBackgroundTask:()=>Promise.resolve(),sendBackgroundTask:()=>Promise.resolve(),readBackgroundTaskLog:()=>Promise.resolve({taskId:``,lines:[]}),listBackgroundJobGroups:()=>[],getBackgroundJobGroup:()=>void 0,createBackgroundJobGroup:()=>({...d}),waitBackgroundJobGroup:()=>Promise.resolve({...d}),getExecutionWorkspaceSnapshot:()=>({...l}),listAgentDefinitions:()=>[],listAgentJobs:()=>[],spawnAgentJob:()=>Promise.resolve({id:`agent_1`,type:`general-purpose`,label:`general-purpose`,parentSessionId:`test-session-id`,status:`running`,mode:`background`,depth:1,cwd:`/workspace`,promptPreview:``,updatedAt:new Date().toISOString()}),sendAgentJob:()=>Promise.resolve(),cancelAgentJob:()=>Promise.resolve(),closeAgentJob:()=>Promise.resolve(),setGoal:()=>Promise.resolve({...u}),getGoalState:()=>null,cancelGoal:()=>null,...e}}exports.ScriptedSessionHarness=o,Object.defineProperty(exports,"createScriptedProvider",{enumerable:!0,get:function(){return i.createScriptedProvider}}),exports.createTestInteractiveSession=f,exports.scriptedSession=s;
+Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=require("../interactive-BpTvVVtf.cjs");let t=require("node:path"),n=require("@robota-sdk/agent-executor"),r=require("@robota-sdk/agent-session"),i=require("node:fs"),a=require("node:os"),o=require("@robota-sdk/agent-core/testing");function s(e){return{turnSource:`peer`,driverId:`peer:${e}`}}function c(e){return(0,t.join)(e,`.robota`,`logs`)}function l(e,n){return(0,t.join)(c(e),`${n}.jsonl`)}function u(e,t){let n=l(e,t);return(0,i.existsSync)(n)?(0,i.readFileSync)(n,`utf8`):``}function d(e,t){return u(e,t).split(`
+`).filter(e=>e.trim().length>0).map(e=>JSON.parse(e))}function f(e,n){return(0,i.readFileSync)((0,t.join)(e,n),`utf8`)}function p(e,n){return(0,i.existsSync)((0,t.join)(e,n))}function m(e){let n=[],r=a=>{for(let o of(0,i.readdirSync)(a,{withFileTypes:!0})){if(o.name===`.robota`)continue;let i=(0,t.join)(a,o.name);o.isDirectory()?r(i):n.push((0,t.relative)(e,i).split(t.sep).join(`/`))}};return r(e),n.sort()}const h=[`text_delta`,`tool_start`,`tool_end`,`thinking`,`complete`,`interrupted`,`error`,`context_update`,`goal_event`,`turn_source`,`user_message`,`background_task_event`];var g=class{cwd;session;requests;events=new Map;completions=[];sessionStore;ownsWorkspace;disposed=!1;constructor(s){if(this.ownsWorkspace=s.cwd===void 0,this.cwd=s.cwd??(0,i.realpathSync)((0,i.mkdtempSync)((0,t.join)((0,a.tmpdir)(),`robota-fxn-`))),this.ownsWorkspace)for(let[e,n]of Object.entries(s.files??{})){let r=(0,t.join)(this.cwd,e);(0,i.mkdirSync)((0,t.dirname)(r),{recursive:!0}),(0,i.writeFileSync)(r,n,`utf8`)}if([s.turns,s.cassette,s.record].filter(e=>e!==void 0).length!==1)throw Error("scriptedSession requires exactly one of `turns`, `cassette`, or `record`.");let c;c=s.cassette?(0,o.createReplayProvider)({cassettePath:s.cassette,scrub:[this.cwd],rewriteCwd:this.cwd}):s.record?(0,o.createRecordingProvider)({provider:s.record.provider,cassettePath:s.record.toCassette,recordCwd:this.cwd}):(0,o.createScriptedProvider)(this.substituteWorkspacePath(s.turns??[])).provider,this.requests=[];let l={...c,chat:async(e,t)=>(this.requests.push([...e]),await s.beforeProviderCall?.(),c.chat(e,t))},u=(0,t.join)(this.cwd,`.robota`,`sessions`);this.sessionStore=s.persistence?new r.NodeSessionStore(u):void 0;let d;if(s.permissions!==void 0||s.hooks!==void 0){d=(0,t.join)(this.cwd,`.robota-test-user-settings.json`);let e={...s.permissions===void 0?{}:{permissions:s.permissions},...s.hooks===void 0?{}:{hooks:s.hooks}};(0,i.writeFileSync)(d,JSON.stringify(e),`utf8`)}this.session=new e.b({cwd:this.cwd,provider:l,...d===void 0?{}:{userSettingsSources:[e.yr(`user`,d)]},...s.projectAccess?{projectAccess:s.projectAccess}:{},...s.sandboxClient?{sandboxClient:s.sandboxClient}:{},...s.contributionSources===void 0?{}:{contributionSources:s.contributionSources},...s.skillRoots===void 0?{}:{skillRoots:s.skillRoots},...s.resolveDefaultLoopPrompt?{resolveDefaultLoopPrompt:s.resolveDefaultLoopPrompt}:{},...s.agentDefinitionRoots===void 0?{}:{agentDefinitionRoots:s.agentDefinitionRoots},bare:s.bare??!0,permissionMode:s.permissionMode??`bypassPermissions`,...s.allowedTools?{allowedTools:s.allowedTools}:{},...s.deniedTools?{deniedTools:s.deniedTools}:{},...this.sessionStore?{sessionStore:this.sessionStore}:{},sessionLogSink:new r.NodeSessionLogSink((0,t.join)(this.cwd,`.robota`,`logs`)),...s.resumeSessionId?{resumeSessionId:s.resumeSessionId}:{},...s.forkSession?{forkSession:s.forkSession}:{},...s.workspaceMovedFrom===void 0?{}:{workspaceMovedFrom:s.workspaceMovedFrom},...s.commandModules?{commandModules:s.commandModules}:{},...s.backgroundTasks?{backgroundTaskRunners:(0,n.createDefaultBackgroundTaskRunners)()}:{},...s.maxTurns===void 0?{}:{maxTurns:s.maxTurns},...s.model===void 0?{}:{model:s.model},...s.terminalHandoff?{terminalHandoff:s.terminalHandoff}:{},...s.additionalTools?{additionalTools:s.additionalTools}:{},...s.backgroundTaskRunners?{backgroundTaskRunners:s.backgroundTaskRunners}:{},...s.toolCallHandoff?{toolCallHandoff:s.toolCallHandoff}:{}});for(let e of h)this.session.on(e,((...t)=>{this.record(e,t),(e===`complete`||e===`interrupted`)&&this.completions.push(t[0])}));if(s.askHandler){let e=s.askHandler;this.session.on(`ask_request`,({id:t,request:n})=>{Promise.resolve(e(n)).then(e=>this.session.resolveAsk(t,e)).catch(()=>this.session.resolveAsk(t,{type:`cancelled`}))})}}substituteWorkspacePath(e){return e.map(e=>`toolCalls`in e?{toolCalls:e.toolCalls.map(e=>({name:e.name,args:JSON.parse(JSON.stringify(e.args).split(`{{cwd}}`).join(this.cwd))}))}:e)}record(e,t){let n=this.events.get(e)??[];n.push(t),this.events.set(e,n)}async submit(e){let t=this.nextSettledTurn();return await this.session.submit(e),t}async runGoal(e,t={}){let n=new Promise((e,t)=>{let n=t=>{t.type===`goal_stopped`&&(i(),e(t.goal))},r=e=>{i(),t(e)},i=()=>{this.session.off(`goal_event`,n),this.session.off(`error`,r)};this.session.on(`goal_event`,n),this.session.on(`error`,r)});return await this.session.setGoal(e,t.maxIterations?{maxIterations:t.maxIterations}:{}),n}command(e,t=``){return this.session.executeCommand(e,t)}async wake(e,t){return this.session.requestWakeup(e,t)?this.nextSettledTurn():null}async submitPeer(e,t){let n=this.nextSettledTurn();return await this.session.submit(e,void 0,void 0,s(t)),n}awaitEvent(e,t){return new Promise(n=>{let r=((...i)=>{let a=i;t&&!t(...a)||(this.session.off(e,r),n(a))});this.session.on(e,r)})}nextSettledTurn(){return new Promise((e,t)=>{let n=t=>{i(),e(t)},r=e=>{i(),t(e)},i=()=>{this.session.off(`complete`,n),this.session.off(`interrupted`,n),this.session.off(`error`,r)};this.session.on(`complete`,n),this.session.on(`interrupted`,n),this.session.on(`error`,r)})}history(){return this.session.getMessages()}sessionRecord(){if(!this.sessionStore)return;let e=this.sessionStore.load(this.session.getSession().getSessionId());return e.status===`valid`?e.record:void 0}sessionLog(){return{id:this.session.getSession().getSessionId(),history:this.session.getFullHistory()}}logsDir(){return c(this.cwd)}transcriptPath(){return l(this.cwd,this.session.getSession().getSessionId())}transcript(){return u(this.cwd,this.session.getSession().getSessionId())}logEntries(){return d(this.cwd,this.session.getSession().getSessionId())}toolCalls(){return this.completions.flatMap(e=>e.toolSummaries)}emittedEvents(e){return this.events.get(e)??[]}readFile(e){return f(this.cwd,e)}exists(e){return p(this.cwd,e)}files(){return m(this.cwd)}async dispose(){this.disposed||(this.disposed=!0,await this.session.shutdown({reason:`other`,message:`functional test complete`}),this.ownsWorkspace&&(0,i.rmSync)(this.cwd,{recursive:!0,force:!0,maxRetries:5,retryDelay:20}))}};function _(e){return new g(e)}const v=`1970-01-01T00:00:00.000Z`,y=`/robota-test-command-host`;function b(e,t){let n={...e};for(let[e,r]of Object.entries(t??{}))r!==void 0&&(n[e]=r);return n}const x={id:`test-agent-job`,type:`general-purpose`,label:`test`,parentSessionId:`test-command-host`,status:`running`,mode:`background`,depth:1,cwd:y,promptPreview:``,updatedAt:v},S={id:`test-group`,parentSessionId:`test-command-host`,waitPolicy:`wait_all`,taskIds:[],status:`running`,createdAt:v,updatedAt:v,results:[]},C={id:`test-background-task`,kind:`agent`,label:`test`,status:`running`,mode:`background`,parentSessionId:`test-command-host`,depth:1,cwd:y,updatedAt:v,unread:!1};function w(e){return b({listAgentDefinitions:()=>[],listAgentJobs:()=>[],spawnAgentJob:()=>Promise.resolve(x),sendAgentJob:()=>Promise.resolve(),cancelAgentJob:()=>Promise.resolve(),closeAgentJob:()=>Promise.resolve(),createBackgroundJobGroup:()=>S,waitBackgroundJobGroup:()=>Promise.resolve(S),spawnScheduledWake:()=>Promise.resolve(C),listSchedules:()=>[],pauseSchedule:()=>Promise.resolve(),resumeSchedule:()=>Promise.resolve(),editSchedule:()=>Promise.resolve(),spawnMonitorWake:()=>Promise.resolve(C),readBackgroundTaskLog:e=>Promise.resolve({taskId:e,lines:[]})},e)}const T={target:{id:`test-checkpoint`,sessionId:`test-command-host`,sequence:0,prompt:``,createdAt:v,fileCount:0},restoredCheckpointCount:0,restoredFileCount:0,removedCheckpointCount:0},E={maxTokens:0,usedTokens:0,usedPercentage:0,remainingPercentage:100},D={id:`test-goal`,objective:``,status:`stopped`,iterations:0,maxIterations:0,startedAt:v,progress:[]},O={id:`test-plan`,objective:``,steps:[],phase:`planning`,createdAt:v},k={},A={loadStartupMemory:()=>Promise.resolve({content:``,path:``,lineCount:0,truncated:!1}),list:()=>Promise.resolve({indexPath:``,topicsPath:``,topics:[]}),readTopic:()=>Promise.resolve(``),append:e=>Promise.resolve({indexPath:``,topicPath:``,topic:e.topic,deduplicated:!1}),recall:()=>Promise.resolve({content:``,references:[],truncated:!1}),getPending:()=>Promise.resolve(void 0),listPending:()=>Promise.resolve([]),markPending:(e,t,n)=>Promise.resolve({id:e,type:`project`,topic:``,text:``,sourceMessageIds:[],confidence:0,createdAt:v,reason:n,status:t,updatedAt:v}),upsertPending:()=>Promise.resolve()};let j=0;function M(e){let t=[];return b({getSessionId:()=>`test-command-host-${j}`,getHistory:()=>[],getFullHistory:()=>[],getMessageCount:()=>0,clearHistory:()=>{},compact:()=>Promise.resolve(),getContextState:()=>E,getPermissionMode:()=>`default`,setPermissionMode:()=>{},getSessionAllowedTools:()=>[],getPermissionRules:()=>({allow:[],deny:[],ask:[]}),getRecentPermissionDenials:()=>[],retryPermissionDenial:()=>void 0,applyPresetToolLists:e=>{t.push(e)},getAutoCompactThreshold:()=>!1,setAutoCompactThreshold:()=>{},getSessionTokenUsage:()=>void 0,getModelId:()=>void 0,getModelEffort:()=>`high`,getOfferedToolSchemas:()=>[],addTools:async()=>[],applyModelOptions:()=>{},applyAgentName:()=>{},getActivePresetId:()=>`default`,setActivePresetId:()=>{},setParallelSubagentsEnabled:()=>{}},e)}function N(e={}){j+=1;let t=e.cwd??`/robota-test-command-host-${j}`,n=M(e.session);return b({getSession:()=>n,validateCurrentSessionReplayLog:()=>({logFile:`${t}/session.jsonl`,entryCount:0,validation:{ok:!0,issues:[]}}),getCwd:()=>t,getCommandInvocationSource:()=>`user`,clearConversationHistory:()=>{},getSessionUsage:()=>[],forkSession:e=>Promise.resolve({sessionId:`test-command-host-${j}-fork`,name:e?.name??`test-command-host-${j} (fork)`}),getUserInteraction:()=>void 0,getActiveOutputStyleId:()=>`default`,applyPersona:()=>{},applySelfVerification:()=>{},applyResponseLanguage:()=>{},applyOutputStyle:()=>{},applyPresetSystemPrompt:()=>{},applyCommandModuleSelection:()=>[],getAutoCompactThresholdSource:()=>`session`,setAutoCompactThreshold:()=>{},listCheckpointBranches:()=>[],forkCheckpointBranch:()=>Promise.resolve(T),switchCheckpointBranch:()=>{},setGoal:()=>Promise.resolve(D),getGoalState:()=>null,cancelGoal:()=>null,setPlan:()=>Promise.resolve(O),getPlanState:()=>null,approvePlan:()=>O,revertPlan:()=>O,getMemoryStore:()=>A,runWithTerminal:e=>e(),getContextState:()=>E,getAutoCompactThreshold:()=>!1,compactContext:()=>Promise.resolve(),listCommands:()=>[],listSkills:()=>[],executeSkillCommandByName:()=>Promise.resolve(null),listContextReferences:()=>[],addContextReference:()=>Promise.resolve({evicted:[],diagnostics:[]}),removeContextReference:()=>({}),clearContextReferences:()=>({removed:[]}),listEditCheckpoints:()=>[],inspectEditCheckpoint:()=>({target:T.target,capturedFiles:[],restoreToCheckpoint:{checkpointIds:[],fileCount:0},rollbackThroughCheckpoint:{checkpointIds:[],fileCount:0}}),restoreEditCheckpoint:()=>Promise.resolve(T),rollbackEditCheckpoint:()=>Promise.resolve(T),getUsedMemoryReferences:()=>[],recordMemoryEvent:()=>{},listBackgroundTasks:()=>[],readBackgroundTaskLog:e=>Promise.resolve({taskId:e,lines:[]}),cancelBackgroundTask:()=>Promise.resolve(),closeBackgroundTask:()=>Promise.resolve(),getCommandHostAdapters:()=>k,canHandoffTerminal:()=>!1,getAgentJobCapability:()=>w()},e.overrides)}function P(t,n){return e.m(t,()=>n)}exports.ScriptedSessionHarness=g,exports.createInteractiveRuntimeForTesting=P,exports.createTestAgentJobHost=w,exports.createTestCommandHost=N,exports.createTestSessionRuntime=M,exports.scriptedSession=_;

package/dist/node/testing/index.d.cts

@@ -0,0 +1,240 @@
+import { Cn as IContributionSource, Fa as ICommandModule, Lt as IToolCallHandoffPolicy, Pc as IAgentJobHostContext, Sc as TWorkspaceProjectAccess, g as IInteractiveSession$1, gn as ISkillRootDescriptor, hl as ICommandSessionRuntime, i as IInteractiveRuntime, l as InteractiveSession, n as IInteractiveRuntimeTestOptions, qa as ICommandHostContext } from "../createInteractiveRuntime-CKt44Pva.cjs";
+import { IExecutionResult, IGoalState, IInteractiveSessionEvents, IInteractiveSessionRecord, ITerminalHandoff, IToolSummary, TInteractiveEventName } from "@robota-sdk/agent-interface-session";
+import { IAIProvider, IToolWithEventService, IUserInteraction, THooksConfig, TPermissionMode, TUniversalMessage } from "@robota-sdk/agent-core";
+import { ICommandResult } from "@robota-sdk/agent-interface-command";
+import { IBackgroundTaskRunner } from "@robota-sdk/agent-executor";
+import { ISandboxClient } from "@robota-sdk/agent-tools";
+import { TScriptedTurn } from "@robota-sdk/agent-core/testing";
+//#region src/testing/scripted-session-harness.d.ts
+/** Options for {@link scriptedSession}. Provide exactly one of `turns`, `cassette`, or `record`. */
+interface IScriptedSessionOptions {
+  /** Scripted assistant turns replayed deterministically through the real loop. */
+  turns?: readonly TScriptedTurn[];
+  /**
+   * CMD-005: answer model-issued questions (AskUserQuestion) programmatically. When set, the harness
+   * subscribes to the session's `ask_request` event and answers via `resolveAsk` (REMOTE-007). Absent ⇒
+   * nothing subscribes, so a model-issued question fails closed (each question `cancelled`) — the
+   * headless no-human path.
+   */
+  askHandler?: IUserInteraction['ask'];
+  /**
+   * Path to a recorded cassette (TEST-005). Replays a real model's captured prompts + tool-use
+   * deterministically through the real loop. The workspace path is rewritten/scrubbed automatically.
+   */
+  cassette?: string;
+  /**
+   * Record mode (TEST-005): drive the session with a REAL provider and capture every interaction to
+   * `toCassette` for later deterministic replay. Used in a one-off keyed record run, not in CI.
+   */
+  record?: {
+    provider: IAIProvider;
+    toCassette: string;
+  };
+  /** Awaited before every provider call, so a test can hold a turn open while it observes. */
+  beforeProviderCall?: () => Promise<void>;
+  /** Seed files written into the workspace before the session starts (workspace-relative paths). */
+  files?: Record<string, string>;
+  /** Persist sessions to a real store in the workspace (enables resume/record assertions). */
+  persistence?: boolean;
+  /**
+   * Reuse an existing workspace directory instead of a fresh temp one. Required for multi-session
+   * resume/fork (the resumed session must read the same store). The harness does not delete a
+   * workspace it did not create.
+   */
+  cwd?: string;
+  /** Explicit host-issued project authority for contribution-discovery fixtures. */
+  projectAccess?: TWorkspaceProjectAccess;
+  /** Explicit host contribution sources used by skill discovery fixtures. */
+  contributionSources?: readonly IContributionSource[];
+  /** Ordered host-owned skill roots used by skill discovery fixtures. */
+  skillRoots?: readonly ISkillRootDescriptor[];
+  resolveDefaultLoopPrompt?: () => string;
+  /** Ordered host-owned agent-definition roots for discovery tests. */
+  agentDefinitionRoots?: readonly string[];
+  /** Resume a persisted session by id (multi-session). Requires `persistence` + the same `cwd`. */
+  resumeSessionId?: string;
+  /** Fork the resumed session into a new id while restoring its context (multi-session). */
+  forkSession?: boolean;
+  /** Issue #3081: the session is the target of a `/cd` from this directory. */
+  workspaceMovedFrom?: string;
+  /** Command modules composed into the session (e.g. the `/goal` module). */
+  commandModules?: readonly ICommandModule[];
+  /** Enable the real background-task runners for schedule/monitor functional tests. */
+  backgroundTasks?: boolean;
+  /** Permission posture. Defaults to `bypassPermissions` so tools run unattended. */
+  permissionMode?: TPermissionMode;
+  /** Pre-approved tool names. */
+  allowedTools?: string[];
+  /** Denied tool names (deny wins over allow). */
+  deniedTools?: string[];
+  /**
+   * Permission PATTERNS (`Bash(rm *)`), as a user's settings file would carry them — read through a
+   * host settings source, the route the product uses. Tool-name lists are `allowedTools`/`deniedTools`.
+   */
+  permissions?: {
+    allow?: string[];
+    deny?: string[];
+    ask?: string[];
+  };
+  /** Hook configuration, written into the same user settings file as `permissions`. */
+  hooks?: THooksConfig;
+  /** A sandbox client, as a product that confines commands supplies one. */
+  sandboxClient?: ISandboxClient;
+  /** Skip AGENTS.md/CLAUDE.md and plugin discovery for determinism. Defaults to `true`. */
+  bare?: boolean;
+  /** Cap on agentic rounds per submit. */
+  maxTurns?: number;
+  /** Model override (e.g. when recording against a real provider whose model differs). */
+  model?: string;
+  /** TERM-001: inject a (fake) terminal-handoff capability to exercise the handoff orchestration. */
+  terminalHandoff?: ITerminalHandoff;
+  /** Additional tools registered alongside the default CLI tools (e.g. a fake slow MCP-like tool). */
+  additionalTools?: IToolWithEventService[];
+  /** Runtime-composed background task runners (e.g. the `tool-invocation` runner, MCP-004). */
+  backgroundTaskRunners?: IBackgroundTaskRunner[];
+  /** MCP-004 §S3: hand a main-turn tool call exceeding its threshold to a background task. */
+  toolCallHandoff?: IToolCallHandoffPolicy;
+}
+/**
+ * A live, scripted, isolated functional-test session. Construct via {@link scriptedSession};
+ * always `await dispose()` in a test teardown.
+ */
+declare class ScriptedSessionHarness {
+  /** Absolute path of the isolated temp workspace. */
+  readonly cwd: string;
+  /** The real session under test. */
+  readonly session: InteractiveSession;
+  /** Message arrays of every provider chat() call, in order, for request assertions. */
+  readonly requests: TUniversalMessage[][];
+  private readonly events;
+  private readonly completions;
+  private readonly sessionStore?;
+  private readonly ownsWorkspace;
+  private disposed;
+  constructor(options: IScriptedSessionOptions);
+  /**
+   * Replace the `{{cwd}}` placeholder in scripted tool-call args with the isolated workspace path,
+   * so a test can reference absolute workspace paths it cannot know until the harness is built
+   * (e.g. `{ filePath: '{{cwd}}/out.txt' }` or a Bash `workingDirectory`). Keeps the harness free of
+   * global `process.cwd()` mutation.
+   */
+  private substituteWorkspacePath;
+  private record;
+  /** Submit a user prompt and resolve with the completed turn result (rejects on `error`). */
+  submit(prompt: string): Promise<IExecutionResult>;
+  /**
+   * Assign an autonomous goal and resolve with the FINAL stopped goal state once the loop ends
+   * (satisfied or a bound). Rejects if the session emits `error` first.
+   */
+  runGoal(objective: string, options?: {
+    maxIterations?: number;
+  }): Promise<IGoalState>;
+  /** Run a slash command through the real session command pipeline. */
+  command(name: string, args?: string): Promise<ICommandResult | null>;
+  /**
+   * FLOW-002: inject a background/scheduled wake (a non-user `agent-wakeup` turn) and resolve once
+   * that turn settles. Mirrors a background task completion or a scheduled fire re-entering the
+   * agent loop. Coalesces by `sourceTaskId` exactly as the real wake path does.
+   *
+   * Returns `null` when the wake was a no-op (coalesced because `sourceTaskId` is already in flight,
+   * or the session is shutting down) — no turn runs, so callers must not await one. This prevents the
+   * driver from hanging until the test timeout when the wake is dropped.
+   */
+  wake(instruction: string, sourceTaskId: string): Promise<IExecutionResult | null>;
+  /** PEER-002 (#1809): deliver a message from ANOTHER SESSION; see `peerTurnOptions`. */
+  submitPeer(text: string, peerSessionId: string): Promise<IExecutionResult>;
+  /** Resolve with the args of the next `event` (optionally matching `predicate`). */
+  awaitEvent<E extends TInteractiveEventName>(event: E, predicate?: (...args: Parameters<IInteractiveSessionEvents[E]>) => boolean): Promise<Parameters<IInteractiveSessionEvents[E]>>;
+  private nextSettledTurn;
+  /** The current conversation messages. */
+  history(): TUniversalMessage[];
+  /** The persisted session record (requires `persistence: true`), or undefined. */
+  sessionRecord(): IInteractiveSessionRecord | undefined;
+  /**
+   * Neutral session-log accessor (INFRA-025): the id + full history in the shape analysis
+   * tooling consumes. Usage assertions compose it with `summarizeUsageBySource` from
+   * `@robota-sdk/agent-session-analytics` in the TEST — the harness itself carries no
+   * analytics dependency.
+   */
+  sessionLog(): {
+    id: string;
+    history: ReturnType<InteractiveSession['getFullHistory']>;
+  };
+  /** The real session-log directory the framework writes to (`{cwd}/.robota/logs`). */
+  logsDir(): string;
+  /** Path of the real JSONL transcript the framework writes for this session. */
+  transcriptPath(): string;
+  /** Raw contents of the real session transcript (`''` if none was written). */
+  transcript(): string;
+  /**
+   * The real session transcript parsed into structured log entries — the durable record the
+   * framework itself writes. Leverages the system's own logging as a verification surface.
+   */
+  logEntries(): Array<Record<string, unknown>>;
+  /** Every tool call the agent made across all completed turns, in order. */
+  toolCalls(): IToolSummary[];
+  /** Raw collected args of each emission of `event`. */
+  emittedEvents<E extends TInteractiveEventName>(event: E): Array<Parameters<IInteractiveSessionEvents[E]>>;
+  /** Read a workspace file (UTF-8). */
+  readFile(relPath: string): string;
+  /** Whether a workspace file exists. */
+  exists(relPath: string): boolean;
+  /** List workspace files (relative paths), excluding the `.robota` session/log dir. */
+  files(): string[];
+  /** Shut the session down and remove the temp workspace. Idempotent. */
+  dispose(): Promise<void>;
+}
+/** Build a live, isolated, scripted functional-test session (TEST-003). */
+declare function scriptedSession(options: IScriptedSessionOptions): ScriptedSessionHarness;
+//#endregion
+//#region src/testing/double-overrides.d.ts
+/**
+ * ARCH-029: the one guarantee every command-axis double makes about its overrides.
+ *
+ * It lives here rather than in either double because both make it, and review found the second copy
+ * had been re-implemented inline with a comment pointing at "the sibling double" — two copies of a
+ * guarantee drift, and this one had already been stated wrongly once.
+ */
+/**
+ * An override may replace a member, never remove one.
+ *
+ * `Partial<T>` admits `{ setPlan: undefined }`, and object spread then writes that `undefined` over
+ * the double's answer — reintroducing an ABSENT member at runtime, fully type-checked, which is the
+ * exact state ARCH-029 S4 removed.
+ *
+ * The type alone does NOT close it, and an earlier revision of this comment claimed it did.
+ * Measured: `NonNullable` strips `undefined` from the VALUE type, but the `?` modifier re-admits it
+ * unless `exactOptionalPropertyTypes` is on, and it is set nowhere in this repo — so
+ * `{ setPlan: undefined }` type-checks here with no cast. What the type DOES buy is `null`:
+ * `{ setPlan: null }` is rejected under `strictNullChecks`. The `undefined` half of the guarantee is
+ * enforced where it actually holds — {@link mergeOverrides} drops those values at merge time, which
+ * is flag-independent.
+ */
+type TOverrides<T> = { [K in keyof T]?: NonNullable<T[K]>; };
+//#endregion
+//#region src/testing/command-host-double.d.ts
+/**
+ * The session-runtime half of the double, published for the same reason the host half is: three
+ * fixtures hand-rolled this 18-member contract, and making its members required turned each of
+ * those into a compile error with nothing honest to reach for.
+ */
+declare function createTestSessionRuntime(overrides?: TOverrides<ICommandSessionRuntime>): ICommandSessionRuntime;
+interface ICreateTestCommandHostOptions {
+  /** Overrides applied last, so a test can state exactly the capability it exercises. */
+  readonly overrides?: TOverrides<ICommandHostContext>;
+  /** Convenience for the common case of shaping only the session runtime. */
+  readonly session?: TOverrides<ICommandSessionRuntime>;
+  /** The working directory every path-scoped command reads. */
+  readonly cwd?: string;
+}
+declare function createTestCommandHost(options?: ICreateTestCommandHostOptions): ICommandHostContext;
+//#endregion
+//#region src/testing/agent-job-host-double.d.ts
+declare function createTestAgentJobHost(overrides?: TOverrides<IAgentJobHostContext>): IAgentJobHostContext;
+//#endregion
+//#region src/testing/interactive-runtime.d.ts
+/** Create an interactive runtime around a test double without weakening production options. */
+declare function createInteractiveRuntimeForTesting(options: IInteractiveRuntimeTestOptions, session: IInteractiveSession$1): IInteractiveRuntime;
+//#endregion
+export { type ICreateTestCommandHostOptions, type IScriptedSessionOptions, ScriptedSessionHarness, createInteractiveRuntimeForTesting, createTestAgentJobHost, createTestCommandHost, createTestSessionRuntime, scriptedSession };
+//# sourceMappingURL=index.d.cts.map

package/dist/node/testing/index.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.cts","names":[],"sources":["../../../src/testing/scripted-session-harness.ts","../../../src/testing/double-overrides.ts","../../../src/testing/command-host-double.ts","../../../src/testing/agent-job-host-double.ts","../../../src/testing/interactive-runtime.ts"],"mappings":";;;;;;;;;UAqEiB;;EAEf,iBAAiB;;;;;;;EAOjB,aAAa;;;;;EAKb;;;;;EAKA;IAAW,UAAU;IAAa;;;EAElC,2BAA2B;;EAE3B,QAAQ;;EAER;;;;;;EAMA;;EAEA,gBAAgB;;EAEhB,+BAA+B;;EAE/B,sBAAsB;EACtB;;EAEA;;EAEA;;EAEA;;EAEA;;EAEA,0BAA0B;;EAE1B;;EAEA,iBAAiB;;EAEjB;;EAEA;;;;;EAKA;IAAgB;IAAkB;IAAiB;;;EAEnD,QAAQ;;EAER,gBAAgB;;EAEhB;;EAEA;;EAEA;;EAEA,kBAAkB;;EAElB,kBAAkB;;EAElB,wBAAwB;;EAExB,kBAAkB;;;;;;cAuBP;;WAEF;;WAEA,SAAS;;WAET,UAAU;mBAEF;mBACA;mBACA;mBACA;UACT;EAEI,YAAA,SAAS;;;;;;;UA8Hb;UAeA;;EASF,OAAO,iBAAiB,QAAQ;;;;;EAUhC,QAAQ,mBAAmB;IAAW;MAAgC,QAAQ;;EA0BpF,QAAQ,cAAc,gBAAY,QAAQ;;;;;;;;;;EAapC,KAAK,qBAAqB,uBAAuB,QAAQ;;EAOzD,WAAW,cAAc,wBAAwB,QAAQ;;EAO/D,WAAW,UAAU,uBACnB,OAAO,GACP,gBAAgB,MAAM,WAAW,0BAA0B,kBAC1D,QAAQ,WAAW,0BAA0B;UAYxC;;EAwBR,WAAW;;EAKX,iBAAiB;;;;;;;EAYjB;IAAgB;IAAY,SAAS,WAAW;;;EAQhD;;EAKA;;EAKA;;;;;EAQA,cAAc,MAAM;;EAKpB,aAAa;;EAKb,cAAc,UAAU,uBACtB,OAAO,IACN,MAAM,WAAW,0BAA0B;;EAK9C,SAAS;;EAKT,OAAO;;EAKP;;EAOM,WAAW;;;iBAcH,gBAAgB,SAAS,0BAA0B;;;;;;;;;;;;;;;;;;;;;;;;;KCzfvD,WAAW,QAAQ,WAAW,KAAK,YAAY,EAAE;;;;;;;;iBCoG7C,yBACd,YAAY,WAAW,0BACtB;UA8Cc;;WAEN,YAAY,WAAW;;WAEvB,UAAU,WAAW;;WAErB;;iBAGK,sBACd,UAAS,gCACR;;;iBC9Ga,uBACd,YAAY,WAAW,wBACtB;;;;iBCnEa,mCACd,SAAS,gCACT,SAAS,wBACR"}

package/dist/node/testing/index.d.ts

@@ -1,16 +1,20 @@
-import { Ei as ICommandModule, i as IInteractiveSession, r as InteractiveSession } from "../index-BeYNnJed.js";
-import { ICommandResult, IExecutionResult, IGoalState, IInteractiveSessionEvents, IInteractiveSessionRecord, ITerminalHandoff, IToolSummary, TInteractiveEventName } from "@robota-sdk/agent-interface-transport";
-import { IAIProvider, IUserInteraction, TPermissionMode, TUniversalMessage } from "@robota-sdk/agent-core";
-import { IScriptedProvider, TScriptedTurn, TScriptedTurn as TScriptedTurn$1, createScriptedProvider } from "@robota-sdk/agent-core/testing";
-
+import { Cn as IContributionSource, Fa as ICommandModule, Lt as IToolCallHandoffPolicy, Pc as IAgentJobHostContext, Sc as TWorkspaceProjectAccess, g as IInteractiveSession$1, gn as ISkillRootDescriptor, hl as ICommandSessionRuntime, i as IInteractiveRuntime, l as InteractiveSession, n as IInteractiveRuntimeTestOptions, qa as ICommandHostContext } from "../createInteractiveRuntime-GD7gJ7ig.js";
+import { IAIProvider, IToolWithEventService, IUserInteraction, THooksConfig, TPermissionMode, TUniversalMessage } from "@robota-sdk/agent-core";
+import { IExecutionResult, IGoalState, IInteractiveSessionEvents, IInteractiveSessionRecord, ITerminalHandoff, IToolSummary, TInteractiveEventName } from "@robota-sdk/agent-interface-session";
+import { IBackgroundTaskRunner } from "@robota-sdk/agent-executor";
+import { ISandboxClient } from "@robota-sdk/agent-tools";
+import { TScriptedTurn } from "@robota-sdk/agent-core/testing";
+import { ICommandResult } from "@robota-sdk/agent-interface-command";
 //#region src/testing/scripted-session-harness.d.ts
 /** Options for {@link scriptedSession}. Provide exactly one of `turns`, `cassette`, or `record`. */
 interface IScriptedSessionOptions {
   /** Scripted assistant turns replayed deterministically through the real loop. */
-  turns?: readonly TScriptedTurn$1[];
+  turns?: readonly TScriptedTurn[];
   /**
-   * CMD-005: answer model-issued questions (AskUserQuestion) programmatically. When set, tool
-   * executions receive it as `context.ask`; absent ⇒ the tool reports `unavailable` (headless).
+   * CMD-005: answer model-issued questions (AskUserQuestion) programmatically. When set, the harness
+   * subscribes to the session's `ask_request` event and answers via `resolveAsk` (REMOTE-007). Absent ⇒
+   * nothing subscribes, so a model-issued question fails closed (each question `cancelled`) — the
+   * headless no-human path.
    */
   askHandler?: IUserInteraction['ask'];
   /**
@@ -26,6 +30,8 @@ interface IScriptedSessionOptions {
     provider: IAIProvider;
     toCassette: string;
   };
+  /** Awaited before every provider call, so a test can hold a turn open while it observes. */
+  beforeProviderCall?: () => Promise<void>;
   /** Seed files written into the workspace before the session starts (workspace-relative paths). */
   files?: Record<string, string>;
   /** Persist sessions to a real store in the workspace (enables resume/record assertions). */
@@ -36,18 +42,44 @@ interface IScriptedSessionOptions {
    * workspace it did not create.
    */
   cwd?: string;
+  /** Explicit host-issued project authority for contribution-discovery fixtures. */
+  projectAccess?: TWorkspaceProjectAccess;
+  /** Explicit host contribution sources used by skill discovery fixtures. */
+  contributionSources?: readonly IContributionSource[];
+  /** Ordered host-owned skill roots used by skill discovery fixtures. */
+  skillRoots?: readonly ISkillRootDescriptor[];
+  resolveDefaultLoopPrompt?: () => string;
+  /** Ordered host-owned agent-definition roots for discovery tests. */
+  agentDefinitionRoots?: readonly string[];
   /** Resume a persisted session by id (multi-session). Requires `persistence` + the same `cwd`. */
   resumeSessionId?: string;
   /** Fork the resumed session into a new id while restoring its context (multi-session). */
   forkSession?: boolean;
+  /** Issue #3081: the session is the target of a `/cd` from this directory. */
+  workspaceMovedFrom?: string;
   /** Command modules composed into the session (e.g. the `/goal` module). */
   commandModules?: readonly ICommandModule[];
+  /** Enable the real background-task runners for schedule/monitor functional tests. */
+  backgroundTasks?: boolean;
   /** Permission posture. Defaults to `bypassPermissions` so tools run unattended. */
   permissionMode?: TPermissionMode;
   /** Pre-approved tool names. */
   allowedTools?: string[];
   /** Denied tool names (deny wins over allow). */
   deniedTools?: string[];
+  /**
+   * Permission PATTERNS (`Bash(rm *)`), as a user's settings file would carry them — read through a
+   * host settings source, the route the product uses. Tool-name lists are `allowedTools`/`deniedTools`.
+   */
+  permissions?: {
+    allow?: string[];
+    deny?: string[];
+    ask?: string[];
+  };
+  /** Hook configuration, written into the same user settings file as `permissions`. */
+  hooks?: THooksConfig;
+  /** A sandbox client, as a product that confines commands supplies one. */
+  sandboxClient?: ISandboxClient;
   /** Skip AGENTS.md/CLAUDE.md and plugin discovery for determinism. Defaults to `true`. */
   bare?: boolean;
   /** Cap on agentic rounds per submit. */
@@ -56,6 +88,12 @@ interface IScriptedSessionOptions {
   model?: string;
   /** TERM-001: inject a (fake) terminal-handoff capability to exercise the handoff orchestration. */
   terminalHandoff?: ITerminalHandoff;
+  /** Additional tools registered alongside the default CLI tools (e.g. a fake slow MCP-like tool). */
+  additionalTools?: IToolWithEventService[];
+  /** Runtime-composed background task runners (e.g. the `tool-invocation` runner, MCP-004). */
+  backgroundTaskRunners?: IBackgroundTaskRunner[];
+  /** MCP-004 §S3: hand a main-turn tool call exceeding its threshold to a background task. */
+  toolCallHandoff?: IToolCallHandoffPolicy;
 }
 /**
  * A live, scripted, isolated functional-test session. Construct via {@link scriptedSession};
@@ -103,6 +141,8 @@ declare class ScriptedSessionHarness {
    * driver from hanging until the test timeout when the wake is dropped.
    */
   wake(instruction: string, sourceTaskId: string): Promise<IExecutionResult | null>;
+  /** PEER-002 (#1809): deliver a message from ANOTHER SESSION; see `peerTurnOptions`. */
+  submitPeer(text: string, peerSessionId: string): Promise<IExecutionResult>;
   /** Resolve with the args of the next `event` (optionally matching `predicate`). */
   awaitEvent<E extends TInteractiveEventName>(event: E, predicate?: (...args: Parameters<IInteractiveSessionEvents[E]>) => boolean): Promise<Parameters<IInteractiveSessionEvents[E]>>;
   private nextSettledTurn;
@@ -128,8 +168,7 @@ declare class ScriptedSessionHarness {
   transcript(): string;
   /**
    * The real session transcript parsed into structured log entries — the durable record the
-   * framework itself writes (`{ timestamp, sessionId, event, ... }` per line). Leverages the
-   * system's own logging as a verification surface, not just in-memory state.
+   * framework itself writes. Leverages the system's own logging as a verification surface.
    */
   logEntries(): Array<Record<string, unknown>>;
   /** Every tool call the agent made across all completed turns, in order. */
@@ -148,10 +187,54 @@ declare class ScriptedSessionHarness {
 /** Build a live, isolated, scripted functional-test session (TEST-003). */
 declare function scriptedSession(options: IScriptedSessionOptions): ScriptedSessionHarness;
 //#endregion
-//#region src/testing/create-test-interactive-session.d.ts
-/** Creates a stub IInteractiveSession for use in tests. All methods return sensible defaults.
- *  Pass overrides to spy on or replace specific methods. */
-declare function createTestInteractiveSession(overrides?: Partial<IInteractiveSession>): IInteractiveSession;
+//#region src/testing/double-overrides.d.ts
+/**
+ * ARCH-029: the one guarantee every command-axis double makes about its overrides.
+ *
+ * It lives here rather than in either double because both make it, and review found the second copy
+ * had been re-implemented inline with a comment pointing at "the sibling double" — two copies of a
+ * guarantee drift, and this one had already been stated wrongly once.
+ */
+/**
+ * An override may replace a member, never remove one.
+ *
+ * `Partial<T>` admits `{ setPlan: undefined }`, and object spread then writes that `undefined` over
+ * the double's answer — reintroducing an ABSENT member at runtime, fully type-checked, which is the
+ * exact state ARCH-029 S4 removed.
+ *
+ * The type alone does NOT close it, and an earlier revision of this comment claimed it did.
+ * Measured: `NonNullable` strips `undefined` from the VALUE type, but the `?` modifier re-admits it
+ * unless `exactOptionalPropertyTypes` is on, and it is set nowhere in this repo — so
+ * `{ setPlan: undefined }` type-checks here with no cast. What the type DOES buy is `null`:
+ * `{ setPlan: null }` is rejected under `strictNullChecks`. The `undefined` half of the guarantee is
+ * enforced where it actually holds — {@link mergeOverrides} drops those values at merge time, which
+ * is flag-independent.
+ */
+type TOverrides<T> = { [K in keyof T]?: NonNullable<T[K]>; };
+//#endregion
+//#region src/testing/command-host-double.d.ts
+/**
+ * The session-runtime half of the double, published for the same reason the host half is: three
+ * fixtures hand-rolled this 18-member contract, and making its members required turned each of
+ * those into a compile error with nothing honest to reach for.
+ */
+declare function createTestSessionRuntime(overrides?: TOverrides<ICommandSessionRuntime>): ICommandSessionRuntime;
+interface ICreateTestCommandHostOptions {
+  /** Overrides applied last, so a test can state exactly the capability it exercises. */
+  readonly overrides?: TOverrides<ICommandHostContext>;
+  /** Convenience for the common case of shaping only the session runtime. */
+  readonly session?: TOverrides<ICommandSessionRuntime>;
+  /** The working directory every path-scoped command reads. */
+  readonly cwd?: string;
+}
+declare function createTestCommandHost(options?: ICreateTestCommandHostOptions): ICommandHostContext;
+//#endregion
+//#region src/testing/agent-job-host-double.d.ts
+declare function createTestAgentJobHost(overrides?: TOverrides<IAgentJobHostContext>): IAgentJobHostContext;
+//#endregion
+//#region src/testing/interactive-runtime.d.ts
+/** Create an interactive runtime around a test double without weakening production options. */
+declare function createInteractiveRuntimeForTesting(options: IInteractiveRuntimeTestOptions, session: IInteractiveSession$1): IInteractiveRuntime;
 //#endregion
-export { type IScriptedProvider, type IScriptedSessionOptions, ScriptedSessionHarness, type TScriptedTurn, createScriptedProvider, createTestInteractiveSession, scriptedSession };
+export { type ICreateTestCommandHostOptions, type IScriptedSessionOptions, ScriptedSessionHarness, createInteractiveRuntimeForTesting, createTestAgentJobHost, createTestCommandHost, createTestSessionRuntime, scriptedSession };
 //# sourceMappingURL=index.d.ts.map

package/dist/node/testing/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","names":[],"sources":["../../../src/testing/scripted-session-harness.ts","../../../src/testing/create-test-interactive-session.ts"],"mappings":";;;;;;;UAyDiB,uBAAA;EAOF;EALb,KAAA,YAAiB,eAAA;EAejB;;;;EAVA,UAAA,GAAa,gBAAA;EAYL;;;;EAPR,QAAA;EAqBA;;;;EAhBA,MAAA;IAAW,QAAA,EAAU,WAAA;IAAa,UAAA;EAAA;EA4BlC;EA1BA,KAAA,GAAQ,MAAA;EA4BU;EA1BlB,WAAA;EA0BkC;AAqBpC;;;;EAzCE,GAAA;EAuDqB;EArDrB,eAAA;EA2J8B;EAzJ9B,WAAA;EAmK4E;EAjK5E,cAAA,YAA0B,cAAA;EA2LQ;EAzLlC,cAAA,GAAiB,eAAA;EAsMsC;EApMvD,YAAA;EA4MS;EA1MT,WAAA;EA2M6D;EAzM7D,IAAA;EA0MsB;EAxMtB,QAAA;EAwMW;EAtMX,KAAA;EA0OW;EAxOX,eAAA,GAAkB,gBAAA;AAAA;;;;;cAqBP,sBAAA;EA6QF;EAAA,SA3QA,GAAA;EA4QqC;EAAA,SA1QrC,OAAA,EAAS,kBAAA;EA0Qf;EAAA,SAxQM,QAAA,EAAU,iBAAA;EAAA,iBAEF,MAAA;EAAA,iBACA,WAAA;EAAA,iBACA,YAAA;EAAA,iBACA,aAAA;EAAA,QACT,QAAA;cAEI,OAAA,EAAS,uBAAA;EARF;;;;;;EAAA,QAsFX,uBAAA;EAAA,QAeA,MAAA;EA7FI;EAsGN,MAAA,CAAO,MAAA,WAAiB,OAAA,CAAQ,gBAAA;EAT9B;;;;EAmBF,OAAA,CAAQ,SAAA,UAAmB,OAAA;IAAW,aAAA;EAAA,IAAgC,OAAA,CAAQ,UAAA;EAAxC;EA0B5C,OAAA,CAAQ,IAAA,UAAc,IAAA,YAAY,OAAA,CAAQ,cAAA;EA1BkC;;;;;;;;;EAuCtE,IAAA,CAAK,WAAA,UAAqB,YAAA,WAAuB,OAAA,CAAQ,gBAAA;EAAR;EAOvD,UAAA,WAAqB,qBAAA,EACnB,KAAA,EAAO,CAAA,EACP,SAAA,OAAgB,IAAA,EAAM,UAAA,CAAW,yBAAA,CAA0B,CAAA,iBAC1D,OAAA,CAAQ,UAAA,CAAW,yBAAA,CAA0B,CAAA;EAAA,QAYxC,eAAA;EAfG;EAuCX,OAAA,IAAW,iBAAA;EAtCF;EA2CT,aAAA,IAAiB,yBAAA;EA1CC;;;;;;EAqDlB,UAAA;IAAgB,EAAA;IAAY,OAAA,EAAS,UAAA,CAAW,kBAAA;EAAA;EAhBhD;EAwBA,OAAA;EAnBA;EAwBA,cAAA;EAbA;EAkBA,UAAA;EAlB4B;;;;;EA4B5B,UAAA,IAAc,KAAA,CAAM,MAAA;EAApB;EAQA,SAAA,IAAa,YAAA;EARO;EAapB,aAAA,WAAwB,qBAAA,EACtB,KAAA,EAAO,CAAA,GACN,KAAA,CAAM,UAAA,CAAW,yBAAA,CAA0B,CAAA;EAPjC;EAYb,QAAA,CAAS,OAAA;EAPK;EAYd,MAAA,CAAO,OAAA;EAXE;EAgBT,KAAA;EAfG;EAgCG,OAAA,IAAW,OAAA;AAAA;;iBAcH,eAAA,CAAgB,OAAA,EAAS,uBAAA,GAA0B,sBAAsB;;;;;iBCnZzE,4BAAA,CACd,SAAA,GAAY,OAAA,CAAQ,mBAAA,IACnB,mBAAA"}
+{"version":3,"file":"index.d.ts","names":[],"sources":["../../../src/testing/scripted-session-harness.ts","../../../src/testing/double-overrides.ts","../../../src/testing/command-host-double.ts","../../../src/testing/agent-job-host-double.ts","../../../src/testing/interactive-runtime.ts"],"mappings":";;;;;;;;;UAqEiB;;EAEf,iBAAiB;;;;;;;EAOjB,aAAa;;;;;EAKb;;;;;EAKA;IAAW,UAAU;IAAa;;;EAElC,2BAA2B;;EAE3B,QAAQ;;EAER;;;;;;EAMA;;EAEA,gBAAgB;;EAEhB,+BAA+B;;EAE/B,sBAAsB;EACtB;;EAEA;;EAEA;;EAEA;;EAEA;;EAEA,0BAA0B;;EAE1B;;EAEA,iBAAiB;;EAEjB;;EAEA;;;;;EAKA;IAAgB;IAAkB;IAAiB;;;EAEnD,QAAQ;;EAER,gBAAgB;;EAEhB;;EAEA;;EAEA;;EAEA,kBAAkB;;EAElB,kBAAkB;;EAElB,wBAAwB;;EAExB,kBAAkB;;;;;;cAuBP;;WAEF;;WAEA,SAAS;;WAET,UAAU;mBAEF;mBACA;mBACA;mBACA;UACT;EAEI,YAAA,SAAS;;;;;;;UA8Hb;UAeA;;EASF,OAAO,iBAAiB,QAAQ;;;;;EAUhC,QAAQ,mBAAmB;IAAW;MAAgC,QAAQ;;EA0BpF,QAAQ,cAAc,gBAAY,QAAQ;;;;;;;;;;EAapC,KAAK,qBAAqB,uBAAuB,QAAQ;;EAOzD,WAAW,cAAc,wBAAwB,QAAQ;;EAO/D,WAAW,UAAU,uBACnB,OAAO,GACP,gBAAgB,MAAM,WAAW,0BAA0B,kBAC1D,QAAQ,WAAW,0BAA0B;UAYxC;;EAwBR,WAAW;;EAKX,iBAAiB;;;;;;;EAYjB;IAAgB;IAAY,SAAS,WAAW;;;EAQhD;;EAKA;;EAKA;;;;;EAQA,cAAc,MAAM;;EAKpB,aAAa;;EAKb,cAAc,UAAU,uBACtB,OAAO,IACN,MAAM,WAAW,0BAA0B;;EAK9C,SAAS;;EAKT,OAAO;;EAKP;;EAOM,WAAW;;;iBAcH,gBAAgB,SAAS,0BAA0B;;;;;;;;;;;;;;;;;;;;;;;;;KCzfvD,WAAW,QAAQ,WAAW,KAAK,YAAY,EAAE;;;;;;;;iBCoG7C,yBACd,YAAY,WAAW,0BACtB;UA8Cc;;WAEN,YAAY,WAAW;;WAEvB,UAAU,WAAW;;WAErB;;iBAGK,sBACd,UAAS,gCACR;;;iBC9Ga,uBACd,YAAY,WAAW,wBACtB;;;;iBCnEa,mCACd,SAAS,gCACT,SAAS,wBACR"}

package/dist/node/testing/index.js

@@ -1,3 +1,3 @@
-import{n as e,s as t}from"../interactive-C93XBn4U.js";import{dirname as n,join as r,relative as i,sep as a}from"node:path";import{tmpdir as o}from"node:os";import{existsSync as s,mkdirSync as c,mkdtempSync as l,readFileSync as u,readdirSync as d,rmSync as f,writeFileSync as p}from"node:fs";import{createRecordingProvider as m,createReplayProvider as h,createScriptedProvider as g,createScriptedProvider as _}from"@robota-sdk/agent-core/testing";const v=[`text_delta`,`tool_start`,`tool_end`,`thinking`,`complete`,`interrupted`,`error`,`context_update`,`goal_event`,`turn_source`,`user_message`];var y=class{cwd;session;requests;events=new Map;completions=[];sessionStore;ownsWorkspace;disposed=!1;constructor(i){if(this.ownsWorkspace=i.cwd===void 0,this.cwd=i.cwd??l(r(o(),`robota-fxn-`)),this.ownsWorkspace)for(let[e,t]of Object.entries(i.files??{})){let i=r(this.cwd,e);c(n(i),{recursive:!0}),p(i,t,`utf8`)}if([i.turns,i.cassette,i.record].filter(e=>e!==void 0).length!==1)throw Error("scriptedSession requires exactly one of `turns`, `cassette`, or `record`.");let a;a=i.cassette?h({cassettePath:i.cassette,scrub:[this.cwd],rewriteCwd:this.cwd}):i.record?m({provider:i.record.provider,cassettePath:i.record.toCassette,recordCwd:this.cwd}):_(this.substituteWorkspacePath(i.turns??[])).provider,this.requests=[];let s={...a,chat:(e,t)=>(this.requests.push([...e]),a.chat(e,t))};this.sessionStore=i.persistence?e(this.cwd):void 0,this.session=new t({cwd:this.cwd,provider:s,bare:i.bare??!0,permissionMode:i.permissionMode??`bypassPermissions`,...i.allowedTools?{allowedTools:i.allowedTools}:{},...i.deniedTools?{deniedTools:i.deniedTools}:{},...this.sessionStore?{sessionStore:this.sessionStore}:{},...i.resumeSessionId?{resumeSessionId:i.resumeSessionId}:{},...i.forkSession?{forkSession:i.forkSession}:{},...i.commandModules?{commandModules:i.commandModules}:{},...i.maxTurns===void 0?{}:{maxTurns:i.maxTurns},...i.model===void 0?{}:{model:i.model},...i.terminalHandoff?{terminalHandoff:i.terminalHandoff}:{},...i.askHandler?{askHandler:i.askHandler}:{}});for(let e of v)this.session.on(e,((...t)=>{this.record(e,t),(e===`complete`||e===`interrupted`)&&this.completions.push(t[0])}))}substituteWorkspacePath(e){return e.map(e=>`toolCalls`in e?{toolCalls:e.toolCalls.map(e=>({name:e.name,args:JSON.parse(JSON.stringify(e.args).split(`{{cwd}}`).join(this.cwd))}))}:e)}record(e,t){let n=this.events.get(e)??[];n.push(t),this.events.set(e,n)}async submit(e){let t=this.nextSettledTurn();return await this.session.submit(e),t}async runGoal(e,t={}){let n=new Promise((e,t)=>{let n=t=>{t.type===`goal_stopped`&&(i(),e(t.goal))},r=e=>{i(),t(e)},i=()=>{this.session.off(`goal_event`,n),this.session.off(`error`,r)};this.session.on(`goal_event`,n),this.session.on(`error`,r)});return await this.session.setGoal(e,t.maxIterations?{maxIterations:t.maxIterations}:{}),n}command(e,t=``){return this.session.executeCommand(e,t)}async wake(e,t){return this.session.requestWakeup(e,t)?this.nextSettledTurn():null}awaitEvent(e,t){return new Promise(n=>{let r=((...i)=>{let a=i;t&&!t(...a)||(this.session.off(e,r),n(a))});this.session.on(e,r)})}nextSettledTurn(){return new Promise((e,t)=>{let n=t=>{i(),e(t)},r=e=>{i(),t(e)},i=()=>{this.session.off(`complete`,n),this.session.off(`interrupted`,n),this.session.off(`error`,r)};this.session.on(`complete`,n),this.session.on(`interrupted`,n),this.session.on(`error`,r)})}history(){return this.session.getMessages()}sessionRecord(){if(this.sessionStore)return this.sessionStore.load(this.session.getSession().getSessionId())}sessionLog(){return{id:this.session.getSession().getSessionId(),history:this.session.getFullHistory()}}logsDir(){return r(this.cwd,`.robota`,`logs`)}transcriptPath(){return r(this.logsDir(),`${this.session.getSession().getSessionId()}.jsonl`)}transcript(){let e=this.transcriptPath();return s(e)?u(e,`utf8`):``}logEntries(){return this.transcript().split(`
-`).filter(e=>e.trim().length>0).map(e=>JSON.parse(e))}toolCalls(){return this.completions.flatMap(e=>e.toolSummaries)}emittedEvents(e){return this.events.get(e)??[]}readFile(e){return u(r(this.cwd,e),`utf8`)}exists(e){return s(r(this.cwd,e))}files(){let e=[],t=n=>{for(let o of d(n,{withFileTypes:!0})){if(o.name===`.robota`)continue;let s=r(n,o.name);o.isDirectory()?t(s):e.push(i(this.cwd,s).split(a).join(`/`))}};return t(this.cwd),e.sort()}async dispose(){this.disposed||(this.disposed=!0,await this.session.shutdown({reason:`other`,message:`functional test complete`}),this.ownsWorkspace&&f(this.cwd,{recursive:!0,force:!0,maxRetries:5,retryDelay:20}))}};function b(e){return new y(e)}const x={usedTokens:0,maxTokens:2e5,usedPercentage:0,remainingPercentage:100},S={sessionId:`test-session-id`,updatedAt:new Date().toISOString(),entries:[]},C={id:`test-goal`,objective:`test goal`,status:`active`,iterations:0,maxIterations:25,startedAt:new Date().toISOString(),progress:[]},w={id:``,parentSessionId:`test-session-id`,waitPolicy:`wait_all`,taskIds:[],status:`completed`,createdAt:new Date().toISOString(),updatedAt:new Date().toISOString(),results:[]};function T(e){return{submit:()=>Promise.resolve(),abort:()=>{},cancelQueue:()=>{},shutdown:()=>Promise.resolve(),isExecuting:()=>!1,getPendingPrompt:()=>null,getMessages:()=>[],getContextState:()=>({...x}),getSession:()=>({getSessionId:()=>`test-session-id`}),getCwd:()=>`/workspace`,executeCommand:()=>Promise.resolve(null),listCommands:()=>[],on:()=>{},off:()=>{},listBackgroundTasks:()=>[],getBackgroundTask:()=>void 0,cancelBackgroundTask:()=>Promise.resolve(),closeBackgroundTask:()=>Promise.resolve(),sendBackgroundTask:()=>Promise.resolve(),readBackgroundTaskLog:()=>Promise.resolve({taskId:``,lines:[]}),listBackgroundJobGroups:()=>[],getBackgroundJobGroup:()=>void 0,createBackgroundJobGroup:()=>({...w}),waitBackgroundJobGroup:()=>Promise.resolve({...w}),getExecutionWorkspaceSnapshot:()=>({...S}),listAgentDefinitions:()=>[],listAgentJobs:()=>[],spawnAgentJob:()=>Promise.resolve({id:`agent_1`,type:`general-purpose`,label:`general-purpose`,parentSessionId:`test-session-id`,status:`running`,mode:`background`,depth:1,cwd:`/workspace`,promptPreview:``,updatedAt:new Date().toISOString()}),sendAgentJob:()=>Promise.resolve(),cancelAgentJob:()=>Promise.resolve(),closeAgentJob:()=>Promise.resolve(),setGoal:()=>Promise.resolve({...C}),getGoalState:()=>null,cancelGoal:()=>null,...e}}export{y as ScriptedSessionHarness,g as createScriptedProvider,T as createTestInteractiveSession,b as scriptedSession};
+import{b as e,m as t,yr as n}from"../interactive-Bqe03GGe.js";import{dirname as r,join as i,relative as a,sep as o}from"node:path";import{createDefaultBackgroundTaskRunners as s}from"@robota-sdk/agent-executor";import{NodeSessionLogSink as c,NodeSessionStore as l}from"@robota-sdk/agent-session";import{existsSync as u,mkdirSync as d,mkdtempSync as f,readFileSync as p,readdirSync as m,realpathSync as h,rmSync as g,writeFileSync as _}from"node:fs";import{tmpdir as v}from"node:os";import{createRecordingProvider as y,createReplayProvider as b,createScriptedProvider as x}from"@robota-sdk/agent-core/testing";function S(e){return{turnSource:`peer`,driverId:`peer:${e}`}}function C(e){return i(e,`.robota`,`logs`)}function w(e,t){return i(C(e),`${t}.jsonl`)}function T(e,t){let n=w(e,t);return u(n)?p(n,`utf8`):``}function E(e,t){return T(e,t).split(`
+`).filter(e=>e.trim().length>0).map(e=>JSON.parse(e))}function D(e,t){return p(i(e,t),`utf8`)}function O(e,t){return u(i(e,t))}function k(e){let t=[],n=r=>{for(let s of m(r,{withFileTypes:!0})){if(s.name===`.robota`)continue;let c=i(r,s.name);s.isDirectory()?n(c):t.push(a(e,c).split(o).join(`/`))}};return n(e),t.sort()}const A=[`text_delta`,`tool_start`,`tool_end`,`thinking`,`complete`,`interrupted`,`error`,`context_update`,`goal_event`,`turn_source`,`user_message`,`background_task_event`];var j=class{cwd;session;requests;events=new Map;completions=[];sessionStore;ownsWorkspace;disposed=!1;constructor(t){if(this.ownsWorkspace=t.cwd===void 0,this.cwd=t.cwd??h(f(i(v(),`robota-fxn-`))),this.ownsWorkspace)for(let[e,n]of Object.entries(t.files??{})){let t=i(this.cwd,e);d(r(t),{recursive:!0}),_(t,n,`utf8`)}if([t.turns,t.cassette,t.record].filter(e=>e!==void 0).length!==1)throw Error("scriptedSession requires exactly one of `turns`, `cassette`, or `record`.");let a;a=t.cassette?b({cassettePath:t.cassette,scrub:[this.cwd],rewriteCwd:this.cwd}):t.record?y({provider:t.record.provider,cassettePath:t.record.toCassette,recordCwd:this.cwd}):x(this.substituteWorkspacePath(t.turns??[])).provider,this.requests=[];let o={...a,chat:async(e,n)=>(this.requests.push([...e]),await t.beforeProviderCall?.(),a.chat(e,n))},u=i(this.cwd,`.robota`,`sessions`);this.sessionStore=t.persistence?new l(u):void 0;let p;if(t.permissions!==void 0||t.hooks!==void 0){p=i(this.cwd,`.robota-test-user-settings.json`);let e={...t.permissions===void 0?{}:{permissions:t.permissions},...t.hooks===void 0?{}:{hooks:t.hooks}};_(p,JSON.stringify(e),`utf8`)}this.session=new e({cwd:this.cwd,provider:o,...p===void 0?{}:{userSettingsSources:[n(`user`,p)]},...t.projectAccess?{projectAccess:t.projectAccess}:{},...t.sandboxClient?{sandboxClient:t.sandboxClient}:{},...t.contributionSources===void 0?{}:{contributionSources:t.contributionSources},...t.skillRoots===void 0?{}:{skillRoots:t.skillRoots},...t.resolveDefaultLoopPrompt?{resolveDefaultLoopPrompt:t.resolveDefaultLoopPrompt}:{},...t.agentDefinitionRoots===void 0?{}:{agentDefinitionRoots:t.agentDefinitionRoots},bare:t.bare??!0,permissionMode:t.permissionMode??`bypassPermissions`,...t.allowedTools?{allowedTools:t.allowedTools}:{},...t.deniedTools?{deniedTools:t.deniedTools}:{},...this.sessionStore?{sessionStore:this.sessionStore}:{},sessionLogSink:new c(i(this.cwd,`.robota`,`logs`)),...t.resumeSessionId?{resumeSessionId:t.resumeSessionId}:{},...t.forkSession?{forkSession:t.forkSession}:{},...t.workspaceMovedFrom===void 0?{}:{workspaceMovedFrom:t.workspaceMovedFrom},...t.commandModules?{commandModules:t.commandModules}:{},...t.backgroundTasks?{backgroundTaskRunners:s()}:{},...t.maxTurns===void 0?{}:{maxTurns:t.maxTurns},...t.model===void 0?{}:{model:t.model},...t.terminalHandoff?{terminalHandoff:t.terminalHandoff}:{},...t.additionalTools?{additionalTools:t.additionalTools}:{},...t.backgroundTaskRunners?{backgroundTaskRunners:t.backgroundTaskRunners}:{},...t.toolCallHandoff?{toolCallHandoff:t.toolCallHandoff}:{}});for(let e of A)this.session.on(e,((...t)=>{this.record(e,t),(e===`complete`||e===`interrupted`)&&this.completions.push(t[0])}));if(t.askHandler){let e=t.askHandler;this.session.on(`ask_request`,({id:t,request:n})=>{Promise.resolve(e(n)).then(e=>this.session.resolveAsk(t,e)).catch(()=>this.session.resolveAsk(t,{type:`cancelled`}))})}}substituteWorkspacePath(e){return e.map(e=>`toolCalls`in e?{toolCalls:e.toolCalls.map(e=>({name:e.name,args:JSON.parse(JSON.stringify(e.args).split(`{{cwd}}`).join(this.cwd))}))}:e)}record(e,t){let n=this.events.get(e)??[];n.push(t),this.events.set(e,n)}async submit(e){let t=this.nextSettledTurn();return await this.session.submit(e),t}async runGoal(e,t={}){let n=new Promise((e,t)=>{let n=t=>{t.type===`goal_stopped`&&(i(),e(t.goal))},r=e=>{i(),t(e)},i=()=>{this.session.off(`goal_event`,n),this.session.off(`error`,r)};this.session.on(`goal_event`,n),this.session.on(`error`,r)});return await this.session.setGoal(e,t.maxIterations?{maxIterations:t.maxIterations}:{}),n}command(e,t=``){return this.session.executeCommand(e,t)}async wake(e,t){return this.session.requestWakeup(e,t)?this.nextSettledTurn():null}async submitPeer(e,t){let n=this.nextSettledTurn();return await this.session.submit(e,void 0,void 0,S(t)),n}awaitEvent(e,t){return new Promise(n=>{let r=((...i)=>{let a=i;t&&!t(...a)||(this.session.off(e,r),n(a))});this.session.on(e,r)})}nextSettledTurn(){return new Promise((e,t)=>{let n=t=>{i(),e(t)},r=e=>{i(),t(e)},i=()=>{this.session.off(`complete`,n),this.session.off(`interrupted`,n),this.session.off(`error`,r)};this.session.on(`complete`,n),this.session.on(`interrupted`,n),this.session.on(`error`,r)})}history(){return this.session.getMessages()}sessionRecord(){if(!this.sessionStore)return;let e=this.sessionStore.load(this.session.getSession().getSessionId());return e.status===`valid`?e.record:void 0}sessionLog(){return{id:this.session.getSession().getSessionId(),history:this.session.getFullHistory()}}logsDir(){return C(this.cwd)}transcriptPath(){return w(this.cwd,this.session.getSession().getSessionId())}transcript(){return T(this.cwd,this.session.getSession().getSessionId())}logEntries(){return E(this.cwd,this.session.getSession().getSessionId())}toolCalls(){return this.completions.flatMap(e=>e.toolSummaries)}emittedEvents(e){return this.events.get(e)??[]}readFile(e){return D(this.cwd,e)}exists(e){return O(this.cwd,e)}files(){return k(this.cwd)}async dispose(){this.disposed||(this.disposed=!0,await this.session.shutdown({reason:`other`,message:`functional test complete`}),this.ownsWorkspace&&g(this.cwd,{recursive:!0,force:!0,maxRetries:5,retryDelay:20}))}};function M(e){return new j(e)}const N=`1970-01-01T00:00:00.000Z`,P=`/robota-test-command-host`;function F(e,t){let n={...e};for(let[e,r]of Object.entries(t??{}))r!==void 0&&(n[e]=r);return n}const I={id:`test-agent-job`,type:`general-purpose`,label:`test`,parentSessionId:`test-command-host`,status:`running`,mode:`background`,depth:1,cwd:P,promptPreview:``,updatedAt:N},L={id:`test-group`,parentSessionId:`test-command-host`,waitPolicy:`wait_all`,taskIds:[],status:`running`,createdAt:N,updatedAt:N,results:[]},R={id:`test-background-task`,kind:`agent`,label:`test`,status:`running`,mode:`background`,parentSessionId:`test-command-host`,depth:1,cwd:P,updatedAt:N,unread:!1};function z(e){return F({listAgentDefinitions:()=>[],listAgentJobs:()=>[],spawnAgentJob:()=>Promise.resolve(I),sendAgentJob:()=>Promise.resolve(),cancelAgentJob:()=>Promise.resolve(),closeAgentJob:()=>Promise.resolve(),createBackgroundJobGroup:()=>L,waitBackgroundJobGroup:()=>Promise.resolve(L),spawnScheduledWake:()=>Promise.resolve(R),listSchedules:()=>[],pauseSchedule:()=>Promise.resolve(),resumeSchedule:()=>Promise.resolve(),editSchedule:()=>Promise.resolve(),spawnMonitorWake:()=>Promise.resolve(R),readBackgroundTaskLog:e=>Promise.resolve({taskId:e,lines:[]})},e)}const B={target:{id:`test-checkpoint`,sessionId:`test-command-host`,sequence:0,prompt:``,createdAt:N,fileCount:0},restoredCheckpointCount:0,restoredFileCount:0,removedCheckpointCount:0},V={maxTokens:0,usedTokens:0,usedPercentage:0,remainingPercentage:100},H={id:`test-goal`,objective:``,status:`stopped`,iterations:0,maxIterations:0,startedAt:N,progress:[]},U={id:`test-plan`,objective:``,steps:[],phase:`planning`,createdAt:N},W={},G={loadStartupMemory:()=>Promise.resolve({content:``,path:``,lineCount:0,truncated:!1}),list:()=>Promise.resolve({indexPath:``,topicsPath:``,topics:[]}),readTopic:()=>Promise.resolve(``),append:e=>Promise.resolve({indexPath:``,topicPath:``,topic:e.topic,deduplicated:!1}),recall:()=>Promise.resolve({content:``,references:[],truncated:!1}),getPending:()=>Promise.resolve(void 0),listPending:()=>Promise.resolve([]),markPending:(e,t,n)=>Promise.resolve({id:e,type:`project`,topic:``,text:``,sourceMessageIds:[],confidence:0,createdAt:N,reason:n,status:t,updatedAt:N}),upsertPending:()=>Promise.resolve()};let K=0;function q(e){let t=[];return F({getSessionId:()=>`test-command-host-${K}`,getHistory:()=>[],getFullHistory:()=>[],getMessageCount:()=>0,clearHistory:()=>{},compact:()=>Promise.resolve(),getContextState:()=>V,getPermissionMode:()=>`default`,setPermissionMode:()=>{},getSessionAllowedTools:()=>[],getPermissionRules:()=>({allow:[],deny:[],ask:[]}),getRecentPermissionDenials:()=>[],retryPermissionDenial:()=>void 0,applyPresetToolLists:e=>{t.push(e)},getAutoCompactThreshold:()=>!1,setAutoCompactThreshold:()=>{},getSessionTokenUsage:()=>void 0,getModelId:()=>void 0,getModelEffort:()=>`high`,getOfferedToolSchemas:()=>[],addTools:async()=>[],applyModelOptions:()=>{},applyAgentName:()=>{},getActivePresetId:()=>`default`,setActivePresetId:()=>{},setParallelSubagentsEnabled:()=>{}},e)}function J(e={}){K+=1;let t=e.cwd??`/robota-test-command-host-${K}`,n=q(e.session);return F({getSession:()=>n,validateCurrentSessionReplayLog:()=>({logFile:`${t}/session.jsonl`,entryCount:0,validation:{ok:!0,issues:[]}}),getCwd:()=>t,getCommandInvocationSource:()=>`user`,clearConversationHistory:()=>{},getSessionUsage:()=>[],forkSession:e=>Promise.resolve({sessionId:`test-command-host-${K}-fork`,name:e?.name??`test-command-host-${K} (fork)`}),getUserInteraction:()=>void 0,getActiveOutputStyleId:()=>`default`,applyPersona:()=>{},applySelfVerification:()=>{},applyResponseLanguage:()=>{},applyOutputStyle:()=>{},applyPresetSystemPrompt:()=>{},applyCommandModuleSelection:()=>[],getAutoCompactThresholdSource:()=>`session`,setAutoCompactThreshold:()=>{},listCheckpointBranches:()=>[],forkCheckpointBranch:()=>Promise.resolve(B),switchCheckpointBranch:()=>{},setGoal:()=>Promise.resolve(H),getGoalState:()=>null,cancelGoal:()=>null,setPlan:()=>Promise.resolve(U),getPlanState:()=>null,approvePlan:()=>U,revertPlan:()=>U,getMemoryStore:()=>G,runWithTerminal:e=>e(),getContextState:()=>V,getAutoCompactThreshold:()=>!1,compactContext:()=>Promise.resolve(),listCommands:()=>[],listSkills:()=>[],executeSkillCommandByName:()=>Promise.resolve(null),listContextReferences:()=>[],addContextReference:()=>Promise.resolve({evicted:[],diagnostics:[]}),removeContextReference:()=>({}),clearContextReferences:()=>({removed:[]}),listEditCheckpoints:()=>[],inspectEditCheckpoint:()=>({target:B.target,capturedFiles:[],restoreToCheckpoint:{checkpointIds:[],fileCount:0},rollbackThroughCheckpoint:{checkpointIds:[],fileCount:0}}),restoreEditCheckpoint:()=>Promise.resolve(B),rollbackEditCheckpoint:()=>Promise.resolve(B),getUsedMemoryReferences:()=>[],recordMemoryEvent:()=>{},listBackgroundTasks:()=>[],readBackgroundTaskLog:e=>Promise.resolve({taskId:e,lines:[]}),cancelBackgroundTask:()=>Promise.resolve(),closeBackgroundTask:()=>Promise.resolve(),getCommandHostAdapters:()=>W,canHandoffTerminal:()=>!1,getAgentJobCapability:()=>z()},e.overrides)}function Y(e,n){return t(e,()=>n)}export{j as ScriptedSessionHarness,Y as createInteractiveRuntimeForTesting,z as createTestAgentJobHost,J as createTestCommandHost,q as createTestSessionRuntime,M as scriptedSession};
 //# sourceMappingURL=index.js.map