@tencent-ai/agent-harness 0.2.0-beta.1 → 0.2.0-beta.3

package/lib/application/services.d.ts

@@ -3,6 +3,7 @@ import { composeAgentHarnessModules } from '../module/compose.js';
 import { type AgentHarnessClientIdentity } from '../runtime/client-identity.js';
 import { CodeBuddyProcessContainment } from '../runtime/process-containment.js';
 import { type AgentHarnessProductInput } from '../runtime/product-config.js';
+import { type SandboxCenterOption } from '../runtime/sandbox-center.js';
 import type { TelemetryOptions } from '../telemetry/public.js';
 import { createTelemetry, type RuntimeLifecycleRecorder } from '../telemetry/runtime.js';
 import { AgentHarnessShutdownCoordinator } from './lifecycle.js';
@@ -14,6 +15,7 @@ export interface ApplicationServicesOptions {
     readonly packageVersion: string;
     readonly processRuntime: ApplicationProcessRuntime;
     readonly productConfig?: string | AgentHarnessProductInput;
+    readonly sandboxCenter?: SandboxCenterOption;
     readonly signal?: AbortSignal;
     readonly tools?: QueryOptions['tools'];
     readonly strictMcpConfig: boolean;
@@ -31,4 +33,4 @@ export interface ApplicationServices {
     readonly runtimeShutdown: AbortController;
     readonly recordLifecycle: RuntimeLifecycleRecorder;
 }
-export declare function createApplicationServices({ clientIdentity, clientIdentityEnv, dependencies, packageVersion, processRuntime, productConfig, tools, strictMcpConfig, mcp, shutdown, telemetryOptions, signal, }: ApplicationServicesOptions): Promise<ApplicationServices>;
+export declare function createApplicationServices({ clientIdentity, clientIdentityEnv, dependencies, packageVersion, processRuntime, productConfig, sandboxCenter, tools, strictMcpConfig, mcp, shutdown, telemetryOptions, signal, }: ApplicationServicesOptions): Promise<ApplicationServices>;

package/lib/application/services.js

@@ -1 +1 @@
-var We=Object.defineProperty;var t=(y,U)=>We(y,"name",{value:U,configurable:!0});import{homedir as Ye}from"node:os";import*as O from"node:path";import{isDeepStrictEqual as Ne}from"node:util";import{Context as p,Effect as m,Exit as g,Layer as s,Logger as c,Option as je,Scope as h}from"effect";import{createAgentProtocolModule as Ge}from"../agent/router.js";import{createAgentV2Facade as qe}from"../agent/v2.js";import{AgentDiscovery as Ke}from"../agent-registry/discovery.js";import{ManagedAuthLocal as Ve}from"../auth/local.js";import{ManagedAuth as Qe}from"../auth/managed.js";import{createAuthProtocolModule as Je}from"../auth/module.js";import{Checkpoints as ve}from"../checkpoint/service.js";import{ConfigFiles as Z}from"../config/files.js";import{createDefaultAgentMcpIntegration as Xe}from"../integration/agent-integration.js";import{PluginMcp as Se}from"../integration/plugin-mcp.js";import{UserMcp as Pe}from"../integration/user-mcp.js";import{requestWithEnvironment as Ze}from"../internal/http.js";import{createMcpServerProtocolModule as $e}from"../mcp-server/module.js";import{composeAgentHarnessModules as er}from"../module/compose.js";import{PluginComponents as $}from"../plugin/components.js";import{createProductProtocolModule as rr}from"../product/module.js";import{preflightCodeBuddyCode as tr}from"../runtime/agent-runtime.js";import{buildAgentHarnessClientIdentityEnv as or,buildAgentHarnessClientIdentityHeaders as nr}from"../runtime/client-identity.js";import{createCodeBuddyAuthRuntime as ir}from"../runtime/codebuddy-auth.js";import{createCodeBuddyProductLifecycle as ar}from"../runtime/codebuddy-product.js";import{DEFAULT_HOST_HEALTH_TIMEOUT_MS as sr,DEFAULT_READY_TIMEOUT_MS as cr}from"../runtime/codebuddy-resource-timeouts.js";import{CodeBuddyProcessContainment as dr}from"../runtime/process-containment.js";import{parseAgentHarnessProductConfig as pr,parseHarnessProductInput as ur}from"../runtime/product-config.js";import{ProductManager as mr}from"../runtime/product-manager.js";import{ProductResolver as we}from"../runtime/product-resolver.js";import{ProductResolverRequestError as lr}from"../runtime/product-resolver-error.js";import{loadProductSource as fr}from"../runtime/product-source.js";import{AgentHarnessServer as hr,DEFAULT_LIFECYCLE_HOOK_TIMEOUT_MS as gr}from"../server/index.js";import{makeServiceRpcs as yr}from"../server/rpc-services.js";import{AgentBackend as Er}from"../session/agent-backend.js";import{AgentServer as Ce}from"../session/agent-server.js";import{SessionConfigStore as vr}from"../session/config-store.js";import{SessionFiles as Sr}from"../session/files.js";import{localFs as Ae}from"../session/local-fs.js";import{localQueryOptions as Pr}from"../session/local-options.js";import{SessionReplay as ke}from"../session/replay.js";import{SessionRuntime as wr}from"../session/runtime.js";import{Sessions as be}from"../session/service.js";import{toExecutorPrivateProxyPolicy as _e}from"../settings/proxy-policy.js";import{createHarnessSettingsRuntime as Cr}from"../settings/runtime.js";import{Settings as Ar}from"../settings/service.js";import{createSubagentProtocolModule as kr}from"../subagent/module.js";import{createEffectTelemetryMetricAggregator as br}from"../telemetry/effect-metric-aggregation.js";import{createTelemetry as _r}from"../telemetry/runtime.js";import{measureStartup as ee,startupProfiler as i}from"../telemetry/startup-profile.js";import{closeInPhases as re,closeTelemetry as Mr,createCloseOnce as b,DEFAULT_TELEMETRY_CLOSE_TIMEOUT_MS as Lr}from"./lifecycle.js";export async function createApplicationServices({clientIdentity:y,clientIdentityEnv:U,dependencies:S,packageVersion:Me,processRuntime:E,productConfig:T,tools:te,strictMcpConfig:Le,mcp:Ie,shutdown:x,telemetryOptions:oe,signal:u}){u?.throwIfAborted();const P=t(e=>m.runPromise(e,{signal:u}),"runStartupEffect"),z=x,ne={name:"@genie/agent-harness",title:"Agent Harness",version:Me},ie=(S.preflightCodeBuddyCode??tr)(),_=new dr,F=new AbortController,l=_r(oe),B=b(()=>Mr(l,E,Math.max(1,Math.min(x.remainingMs(),oe.flushTimeoutMs??Lr))));x.registerTelemetryCloser(B);const ae=br(e=>l.recordEffectMetrics(e));try{E.addFinalizer(B)}catch(e){throw await B(),e}try{E.setTelemetryObserver({log:t(e=>l.recordEffectLog(e),"log"),metrics:t(e=>ae.record("harness",e),"metrics"),span:t(e=>l.recordEffectSpan(e),"span")})}catch{}const k=t(e=>l.recordLifecycle(e),"recordLifecycle");let se=!1;const W=t((e,d,D)=>{se||(se=!0,k({component:"server",error:e,phase:"runtime",process:{pid:process.pid},reason:D,state:d}))},"recordRootFailure");_.signal.addEventListener("abort",()=>{W(_.signal.reason,"containment_tripped","containment_failed")},{once:!0});const De={log(e){try{l.recordEffectLog(e)}catch{}},metrics(e){ae.record("executor",e)},span(e){try{l.recordEffectSpan(e)}catch{}}};let w,n,R,M,a,A,L,C;const I=h.makeUnsafe(),Y=b(e=>m.runPromise(h.close(I,e===void 0?g.void:g.fail(e))));E.addFinalizer(()=>Y(void 0));const N=t(()=>{R&&m.runPromise(m.forkIn(R.prepare,I,{startImmediately:!0})).catch(()=>{})},"prepareRuntime"),ce=h.makeUnsafe(),j=b(async e=>{try{await a?.close(e)}finally{await m.runPromise(h.close(ce,e===void 0?g.void:g.fail(e)))}});E.addFinalizer(()=>j(void 0));const G=h.makeUnsafe(),q=b(e=>m.runPromise(h.close(G,e===void 0?g.void:g.fail(e))));E.addFinalizer(()=>q(void 0));const de=h.makeUnsafe(),K=b(e=>m.runPromise(h.close(de,e===void 0?g.void:g.fail(e))));E.addFinalizer(()=>K(void 0));const pe=h.makeUnsafe(),V=b(async e=>{try{await n?.close(e)}finally{await m.runPromise(h.close(pe,e===void 0?g.void:g.fail(e)))}});E.addFinalizer(()=>V(void 0));try{const e={...process.env},d={...U},D=typeof T=="object"?ur(T):fr(T,{parse:pr});u?.throwIfAborted(),i()?.markStart("harness.product");const Te=await P(s.buildWithScope(we.layer({projection:D.projection,baseConfiguration:T===void 0?void 0:{},packageRoot:ie.productRoot??O.dirname(ie.packageJsonPath),clientIdentity:{ideName:y.ideName,ideType:y.ideType,ideVersion:y.ideVersion,...y.userAgent===void 0?{}:{userAgent:y.userAgent}},environment:t(()=>({...e,...d}),"environment")}),ce));a=await(S.createProductManager??((r,o)=>mr.create(r,o)))({bootstrap:D.bootstrap,projection:D.projection,resolver:p.get(Te,we)},u),i()?.markEnd("harness.product");const Fe=t(()=>{if(!a)throw new Error("Product manager is not ready");return a.getLaunchSnapshot()},"productLaunch");u?.throwIfAborted(),i()?.markStart("harness.config");const Re=await P(s.buildWithScope(Z.layer.pipe(s.provide(c.layer([c.withConsoleError(c.formatLogFmt)]))),G));i()?.markEnd("harness.config");const me=p.get(Re,Z);u?.throwIfAborted(),i()?.markStart("harness.settings"),A=await(S.createSettingsRuntime??Cr)({ambientEnvironment:e,config:me,environment:d,observe:t(r=>l.recordEffectLog({annotations:{component:"harness",operation:"refresh",reason:r.reason,resource:"policy","runtime.role":"harness",status:r.status,...r.policy===void 0?{}:{mode:r.policy.mode,noProxyCount:r.policy.noProxyCount,proxyConfigured:r.policy.proxyConfigured,proxySupport:r.policy.proxySupport,revision:r.policy.revision}},level:r.status==="failed"?"warn":"info",message:"harness.settings.proxy"}),"observe"),processRuntime:E}),i()?.markEnd("harness.settings");const le=vr.layer(O.join(e.CODEBUDDY_CONFIG_DIR?.trim()?O.resolve(e.CODEBUDDY_CONFIG_DIR.trim()):O.join(Ye(),".codebuddy"),"harness","sessions"));u?.throwIfAborted(),i()?.markStart("harness.session-runtime");const fe=await P(s.buildWithScope(S.sessionRuntimeLayer??Er({checkpoints:!0,headers:nr(y),resolveOptions:t(r=>m.map(Pr(r),o=>({...o,...te===void 0?{}:{tools:te}})),"resolveOptions")}).pipe(s.provideMerge(Ce.layer({product:{},fs:Ae,settingSources:["user","project","local"],env:{...or(y),CODEBUDDY_API_KEY_DISABLED:"1",CODEBUDDY_REMOTE_CONFIG_DISABLED:"1",CODEBUDDY_INCLUDE_TOPIC_MESSAGE:"true",CODEBUDDY_CODE_DISABLE_FILE_CHECKPOINTING:e.CODEBUDDY_CODE_DISABLE_FILE_CHECKPOINTING??"0"}})),s.provide(le),s.provide(Ke.layer.pipe(s.provide(c.layer([c.withConsoleError(c.formatLogFmt)]))))),I));i()?.markEnd("harness.session-runtime"),R=p.get(fe,wr),u?.throwIfAborted(),i()?.markStart("harness.replay");const He=p.get(await P(s.buildWithScope(ke.layer({},r=>Ae.readFileBuffer(r)).pipe(s.provide(le)),I)),ke);i()?.markEnd("harness.replay"),u?.throwIfAborted(),i()?.markStart("harness.storage");const he=await P(s.buildWithScope(s.mergeAll(be.layer,ve.layer).pipe(s.provide(Sr.layer),s.provide(c.layer([c.withConsoleError(c.formatLogFmt)]))),I));i()?.markEnd("harness.storage");const Oe=p.get(he,be),Ue=p.get(he,ve);M=(S.createMcpIntegration??(r=>Xe({containment:r.containment,recordEffectTelemetry:r.recordEffectTelemetry,recordLifecycle:r.recordLifecycle,supervisor:{environment:r.environment,toolsSyncTtlMs:Ie?.toolsSyncTtlMs,proxyPolicy:r.proxyPolicy}})))({containment:_,environment:d,proxyPolicy:_e(A.currentProxyPolicy,d),recordEffectTelemetry:De,recordLifecycle:k}),L=A.subscribe(r=>{const o=_e(r,d);M?.configureProxy?.(o).catch(()=>{l.recordEffectLog({annotations:{component:"harness",operation:"update",resource:"policy","runtime.role":"harness",status:"failed"},level:"warn",message:"harness.settings.proxy"})})});const ge=je.getOrUndefined(p.getOption(fe,Ce));u?.throwIfAborted(),i()?.markStart("harness.mcp-services");const Q=await P(s.buildWithScope(s.mergeAll(Pe.layer({environment:t(()=>({...e,...d}),"environment")}),Se.layer).pipe(s.provideMerge($.layer({environment:t(()=>({...e,...d}),"environment"),product:t(()=>a.getConfiguration(),"product"),writeContext:t(async()=>{await n?.prepareHostExecution(F.signal);const r=t(()=>({environment:{...e,...d},product:structuredClone(a.getConfiguration()),authentication:n?.currentSessionAuthentication()}),"capture");return n?n.runConsistentRead(r):r()},"writeContext"),onConfigChange:ge?async(r,o)=>{const f=o.authentication;ge.notifyConfigChange({source:r.source,filePath:r.file_path,cwd:r.cwd},{product:o.product,environment:o.environment,fetch:t((X,H)=>Ze(X,H,o.environment),"fetch"),auth:f?{accessToken:f.credential.accessToken,method:f.credential.type,refresh:t(async({signal:X})=>{if(!n||!a)throw new Error("Hook authentication is unavailable");const H=t(()=>{if(!Ne(o.product,a.getConfiguration()))throw new Error("Hook Product changed")},"checkProduct");await n.runConsistentRead(H);const Ee=await n.refreshHostAuthentication(f,X);return await n.runConsistentRead(H),{accessToken:Ee.credential.accessToken,method:Ee.credential.type}},"refresh")}:void 0,account:f?{uid:f.account.id,enterpriseId:f.account.organization?.id}:void 0}).catch(()=>m.runSync(m.logWarning("harness.config-change.failed").pipe(m.provide(c.layer([c.withConsoleError(c.formatLogFmt)])))))}:void 0,reloadUserConfig:t(r=>w?.reloadUserConfig(r)??Promise.resolve(),"reloadUserConfig")})),s.provide(c.layer([c.withConsoleError(c.formatLogFmt)]))),de));i()?.markEnd("harness.mcp-services"),u?.throwIfAborted(),i()?.markStart("harness.agent-facade"),w=await(S.createAgentFacade??qe)({userMcp:p.get(Q,Pe),pluginMcp:p.get(Q,Se),checkpoints:Ue,sessions:Oe,initialProductGeneration:Fe().productGeneration,mcpIntegration:M,strictMcpConfig:Le,onPermanentFailure:t(r=>{W(r,"fused","recovery_failed"),F.abort(r)},"onPermanentFailure"),prepareSessionRuntime:t((r,o)=>{if(!n)throw new Error("Authentication runtime is not ready");return n.prepareSessionRuntime(r,o.connectionSignal)},"prepareSessionRuntime"),prepareSessionWorkspace:t(async(r,o)=>{if(!n||!a)throw new Error("Product manager is not ready");try{return await a.prepareWorkspace(r,{signal:o})}catch(f){if(!(f instanceof lr&&f.code==="AUTH_REFRESH_REQUIRED"))throw f;return await n.refreshProductAuthentication(o),a.prepareWorkspace(r,{force:!0,signal:o})}},"prepareSessionWorkspace"),releaseSessionWorkspace:t((r,o)=>a?a.releaseWorkspace(r,o):Promise.resolve(),"releaseSessionWorkspace"),refreshAuthentication:t((r,o)=>{if(!n)throw new Error("Authentication runtime is not ready");return n.refreshAuthentication(r,{signal:o?.signal??AbortSignal.abort(new Error("Authentication refresh has no operation signal"))})},"refreshAuthentication"),serverInfo:ne,sessionRuntime:R,sessionReplay:He}),i()?.markEnd("harness.agent-facade");const ye=ar({facade:w,onExecutionProductCommitted:N,product:a});u?.throwIfAborted(),i()?.markStart("harness.auth-service");const xe=await P(s.buildWithScope(S.managedAuthLayer??Ve({...a.resolveLoginProduct?{resolveLoginProduct:t((r,o)=>a.resolveLoginProduct(r,o),"resolveLoginProduct")}:{},environment:t(()=>({...e,...d}),"environment"),product:t(()=>a.getConfiguration(),"product")}).pipe(s.provide(c.layer([c.withConsoleError(c.formatLogFmt)]))),pe));i()?.markEnd("harness.auth-service"),n=ir({consumer:w,getAuthMethods:t(()=>a.getAuthMethods(),"getAuthMethods"),managedAuth:p.get(xe,Qe),onRuntimePreparing:N,onRuntimePrepared:N,productLifecycle:ye});const v=await Je(n);n.bindProtocolBridge(v.bridge);const J=rr({selectConnectionProductProfile:t((r,o)=>n.selectConnectionProductProfile(r,o),"selectConnectionProductProfile"),provisionProduct:t((r,o)=>v.runAuthMutation(()=>n.provisionProduct(r,o)),"provisionProduct"),readProduct:t((r,o)=>n.readProduct(r,o),"readProduct"),provisionWorkspaceProduct:t((r,o)=>v.runAuthMutation(()=>n.provisionWorkspaceProduct(r,o)),"provisionWorkspaceProduct"),readWorkspaceProduct:t((r,o)=>a.readWorkspaceProduct(r,o),"readWorkspaceProduct")});a.bindPublisher({notifyProductUpdated:t(()=>J.publisher.notifyProductUpdated(ye.currentProductSnapshot()),"notifyProductUpdated"),notifyWorkspaceProductUpdated:t(r=>J.publisher.notifyWorkspaceProductUpdated(r),"notifyWorkspaceProductUpdated")});const ze=p.empty().pipe(p.add(Ar,A),p.add(Z,me),p.add($,p.get(Q,$)));u?.throwIfAborted(),i()?.markStart("harness.rpc-services");const Be=await P(m.provide(yr.pipe(h.provide(G)),ze));i()?.markEnd("harness.rpc-services"),C=er([{name:"private-runtime-lifecycle",capabilities:{},initialize:t(async(r,o)=>{await ee("harness.initialize.settings",()=>A?.initialize(o.connectionSignal))},"initialize"),close:t(async r=>{L?.(),L=void 0,await K(r),await A?.close(r),await re([[()=>Y(r),()=>M?.close(r)??Promise.resolve()],[()=>j(r)]],z,"private runtime shutdown")},"close")},Ge({v2:w}),$e({backend:w}),kr({backend:w}),J,{name:v.name,capabilities:v.capabilities,initialize:t(async(r,o)=>ee("harness.initialize.auth",()=>v.initialize(r,o)),"initialize"),initialized:v.initialized,notificationHandlers:v.notificationHandlers,requestHandlers:v.requestHandlers,close:V},{...Be,close:q}])}catch(e){throw L?.(),L=void 0,k({component:"server",error:e,phase:"startup",process:{pid:process.pid},reason:"startup_failed",state:"startup_failed"}),await re([[()=>q(e)],[()=>V(e)],[()=>w?.close(e)??Promise.resolve(),()=>Y(e)],[()=>M?.close(e)??Promise.resolve()],[()=>K(e)],[()=>A?.close(e)??Promise.resolve()],[()=>j(e)]],z,"module startup cleanup").catch(()=>{}),e}let ue;try{u?.throwIfAborted(),ue=(S.createServer??(e=>new hr(e)))({serverInfo:ne,capabilities:C.capabilities,initializeHookTimeoutMs:cr+sr+gr,initialize:t(async(e,d)=>(i()?.markEnd("harness.wait-initialize"),ee("harness.initialize",()=>C.initialize(e,d))),"initialize"),initialized:C.initialized,notificationHandlers:C.notificationHandlers,onContainmentFailure:t(e=>{W(e,"containment_tripped","containment_failed"),F.abort(e)},"onContainmentFailure"),readinessSignal:_.signal,requestHandlers:C.requestHandlers,telemetryRuntime:l})}catch(e){k({component:"server",error:e,phase:"startup",process:{pid:process.pid},reason:"startup_failed",state:"startup_failed"});try{await re([[()=>C.close(e)]],z,"server construction cleanup")}catch(d){k({component:"server",error:d,phase:"cleanup",process:{pid:process.pid},reason:"cleanup_failed",state:"shutdown_failed"})}throw e}return{server:ue,modules:C,telemetry:l,containment:_,runtimeShutdown:F,recordLifecycle:k}}t(createApplicationServices,"createApplicationServices");
+var Ve=Object.defineProperty;var t=(E,H)=>Ve(E,"name",{value:H,configurable:!0});import{homedir as we}from"node:os";import*as k from"node:path";import{isDeepStrictEqual as Xe}from"node:util";import{WORKBUDDY_ENABLE_LINUX_SANDBOX_CLI as Ae}from"@genie/product";import{Context as d,Effect as m,Exit as y,Layer as s,Logger as u,Option as Qe,Scope as h}from"effect";import{createAgentProtocolModule as Je}from"../agent/router.js";import{createAgentV2Facade as Ze}from"../agent/v2.js";import{ManagedAuthLocal as $e}from"../auth/local.js";import{ManagedAuth as er}from"../auth/managed.js";import{createAuthProtocolModule as rr}from"../auth/module.js";import{Checkpoints as _e}from"../checkpoint/service.js";import{ConfigFiles as re}from"../config/files.js";import{createDefaultAgentMcpIntegration as tr}from"../integration/agent-integration.js";import{PluginMcp as be}from"../integration/plugin-mcp.js";import{UserMcp as ke}from"../integration/user-mcp.js";import{requestWithEnvironment as or}from"../internal/http.js";import{createMcpServerProtocolModule as nr}from"../mcp-server/module.js";import{composeAgentHarnessModules as ir}from"../module/compose.js";import{PluginComponents as te}from"../plugin/components.js";import{createProductProtocolModule as ar}from"../product/module.js";import{preflightCodeBuddyCode as sr}from"../runtime/agent-runtime.js";import{buildAgentHarnessClientIdentityEnv as cr,buildAgentHarnessClientIdentityHeaders as dr}from"../runtime/client-identity.js";import{createCodeBuddyAuthRuntime as ur}from"../runtime/codebuddy-auth.js";import{createCodeBuddyProductLifecycle as pr}from"../runtime/codebuddy-product.js";import{DEFAULT_HOST_HEALTH_TIMEOUT_MS as mr,DEFAULT_READY_TIMEOUT_MS as lr}from"../runtime/codebuddy-resource-timeouts.js";import{CodeBuddyProcessContainment as fr}from"../runtime/process-containment.js";import{parseAgentHarnessProductConfig as hr,parseHarnessProductInput as gr}from"../runtime/product-config.js";import{ProductManager as yr}from"../runtime/product-manager.js";import{ProductResolver as De}from"../runtime/product-resolver.js";import{ProductResolverRequestError as Er}from"../runtime/product-resolver-error.js";import{loadProductSource as Sr}from"../runtime/product-source.js";import{HarnessSandboxCenter as vr}from"../runtime/sandbox-center.js";import{AgentHarnessServer as Cr,DEFAULT_LIFECYCLE_HOOK_TIMEOUT_MS as Pr}from"../server/index.js";import{makeServiceRpcs as wr}from"../server/rpc-services.js";import{AgentBackend as Ar,workspaceQueryOptions as _r}from"../session/agent-backend.js";import{AgentServer as Ie}from"../session/agent-server.js";import{readSessionConfigDefaults as br}from"../session/config-defaults.js";import{SessionConfigStore as kr}from"../session/config-store.js";import{SessionFiles as Dr}from"../session/files.js";import{localFs as Me}from"../session/local-fs.js";import{SessionReplay as Le}from"../session/replay.js";import{SessionRuntime as Ir}from"../session/runtime.js";import{Sessions as Te}from"../session/service.js";import{toExecutorPrivateProxyPolicy as Oe}from"../settings/proxy-policy.js";import{createHarnessSettingsRuntime as Mr}from"../settings/runtime.js";import{Settings as Lr}from"../settings/service.js";import{createSubagentProtocolModule as Tr}from"../subagent/module.js";import{createEffectTelemetryMetricAggregator as Or}from"../telemetry/effect-metric-aggregation.js";import{createTelemetry as xr}from"../telemetry/runtime.js";import{measureStartup as oe,startupProfiler as i}from"../telemetry/startup-profile.js";import{closeInPhases as ne,closeTelemetry as Rr,createCloseOnce as _,DEFAULT_TELEMETRY_CLOSE_TIMEOUT_MS as Fr}from"./lifecycle.js";export async function createApplicationServices({clientIdentity:E,clientIdentityEnv:H,dependencies:v,packageVersion:xe,processRuntime:g,productConfig:O,sandboxCenter:Re,tools:ie,strictMcpConfig:Fe,mcp:Ue,shutdown:B,telemetryOptions:ae,signal:p}){p?.throwIfAborted();const C=t(r=>m.runPromise(r,{signal:p}),"runStartupEffect"),z=B,se={name:"@genie/agent-harness",title:"Agent Harness",version:xe},ce=(v.preflightCodeBuddyCode??sr)(),D=new fr,x=new AbortController,l=xr(ae),W=_(()=>Rr(l,g,Math.max(1,Math.min(B.remainingMs(),ae.flushTimeoutMs??Fr))));B.registerTelemetryCloser(W);const de=Or(r=>l.recordEffectMetrics(r));try{g.addFinalizer(W)}catch(r){throw await W(),r}try{g.setTelemetryObserver({log:t(r=>l.recordEffectLog(r),"log"),metrics:t(r=>de.record("harness",r),"metrics"),span:t(r=>l.recordEffectSpan(r),"span")})}catch{}const b=t(r=>l.recordLifecycle(r),"recordLifecycle"),R=new vr(process.env.CODEBUDDY_CONFIG_DIR?.trim()?k.resolve(process.env.CODEBUDDY_CONFIG_DIR.trim()):k.join(we(),".codebuddy"),Re,process.env.SANDBOX_CENTER_IPC_ADDRESS?.trim()),N=_(()=>R.close());g.addFinalizer(N);let ue=!1;const Y=t((r,c,T)=>{ue||(ue=!0,b({component:"server",error:r,phase:"runtime",process:{pid:process.pid},reason:T,state:c}))},"recordRootFailure");D.signal.addEventListener("abort",()=>{Y(D.signal.reason,"containment_tripped","containment_failed")},{once:!0});const He={log(r){try{l.recordEffectLog(r)}catch{}},metrics(r){de.record("executor",r)},span(r){try{l.recordEffectSpan(r)}catch{}}};let P,n,F,I,a,A,M,w;const L=h.makeUnsafe(),G=_(r=>m.runPromise(h.close(L,r===void 0?y.void:y.fail(r))));g.addFinalizer(()=>G(void 0));const j=t(()=>{F&&m.runPromise(m.forkIn(F.prepare,L,{startImmediately:!0})).catch(()=>{})},"prepareRuntime"),pe=h.makeUnsafe(),q=_(async r=>{try{await a?.close(r)}finally{await m.runPromise(h.close(pe,r===void 0?y.void:y.fail(r)))}});g.addFinalizer(()=>q(void 0));const K=h.makeUnsafe(),V=_(r=>m.runPromise(h.close(K,r===void 0?y.void:y.fail(r))));g.addFinalizer(()=>V(void 0));const me=h.makeUnsafe(),X=_(r=>m.runPromise(h.close(me,r===void 0?y.void:y.fail(r))));g.addFinalizer(()=>X(void 0));const le=h.makeUnsafe(),Q=_(async r=>{try{await n?.close(r)}finally{await m.runPromise(h.close(le,r===void 0?y.void:y.fail(r)))}});g.addFinalizer(()=>Q(void 0));try{const r={...process.env},c={...H,...R.environment},T=typeof O=="object"?gr(O):Sr(O,{parse:hr});p?.throwIfAborted(),i()?.markStart("harness.product");const Be=await C(s.buildWithScope(De.layer({projection:T.projection,baseConfiguration:O===void 0?void 0:{},packageRoot:ce.productRoot??k.dirname(ce.packageJsonPath),clientIdentity:{ideName:E.ideName,ideType:E.ideType,ideVersion:E.ideVersion,...E.userAgent===void 0?{}:{userAgent:E.userAgent}},environment:t(()=>({...r,...c}),"environment")}),pe));a=await(v.createProductManager??((e,o)=>yr.create(e,o)))({bootstrap:T.bootstrap,projection:T.projection,resolver:d.get(Be,De)},p),i()?.markEnd("harness.product");const ze=t(()=>{if(!a)throw new Error("Product manager is not ready");return a.getLaunchSnapshot()},"productLaunch");p?.throwIfAborted(),i()?.markStart("harness.config");const We=await C(s.buildWithScope(re.layer.pipe(s.provide(u.layer([u.withConsoleError(u.formatLogFmt)]))),K));i()?.markEnd("harness.config");const J=d.get(We,re),he=t((e,o)=>br(J,e,o),"sessionConfigDefaults");p?.throwIfAborted(),i()?.markStart("harness.settings"),A=await(v.createSettingsRuntime??Mr)({ambientEnvironment:r,config:J,environment:c,observe:t(e=>l.recordEffectLog({annotations:{component:"harness",operation:"refresh",reason:e.reason,resource:"policy","runtime.role":"harness",status:e.status,...e.policy===void 0?{}:{mode:e.policy.mode,noProxyCount:e.policy.noProxyCount,proxyConfigured:e.policy.proxyConfigured,proxySupport:e.policy.proxySupport,revision:e.policy.revision}},level:e.status==="failed"?"warn":"info",message:"harness.settings.proxy"}),"observe"),processRuntime:g}),i()?.markEnd("harness.settings");const ge=kr.layer(k.join(r.CODEBUDDY_CONFIG_DIR?.trim()?k.resolve(r.CODEBUDDY_CONFIG_DIR.trim()):k.join(we(),".codebuddy"),"harness","sessions"));p?.throwIfAborted(),i()?.markStart("harness.session-runtime");const ye=process.platform==="linux"?r[Ae]??((await import("#agent-harness-components/session-config")).isLinuxSandboxCLIInstalled()?"1":"0"):void 0,Ee=await C(s.buildWithScope(v.sessionRuntimeLayer??Ar({checkpoints:!0,headers:dr(E),prepareSandboxCenter:t((e,o)=>R.prepare(e.account?.uid,o),"prepareSandboxCenter"),resolveOptions:t(e=>m.map(_r(e),o=>({...o,...ie===void 0?{}:{tools:ie}})),"resolveOptions"),resolveConfigDefaults:t(e=>m.tryPromise({try:t(()=>he(e.workspace?.canonicalCwd??e.cwd??process.cwd(),e.signal),"try"),catch:t(o=>o,"catch")}),"resolveConfigDefaults")}).pipe(s.provideMerge(Ie.layer({product:{},fs:Me,settingSources:["user","project","local"],env:{...cr(E),CODEBUDDY_API_KEY_DISABLED:"1",CODEBUDDY_REMOTE_CONFIG_DISABLED:"1",CODEBUDDY_INCLUDE_TOPIC_MESSAGE:"true",...ye===void 0?{}:{[Ae]:ye},...R.environment,CODEBUDDY_CODE_DISABLE_FILE_CHECKPOINTING:r.CODEBUDDY_CODE_DISABLE_FILE_CHECKPOINTING??"0"}})),s.provide(ge)),L));i()?.markEnd("harness.session-runtime"),F=d.get(Ee,Ir),p?.throwIfAborted(),i()?.markStart("harness.replay");const Ne=d.get(await C(s.buildWithScope(Le.layer({},e=>Me.readFileBuffer(e),he).pipe(s.provide(ge)),L)),Le);i()?.markEnd("harness.replay"),p?.throwIfAborted(),i()?.markStart("harness.storage");const Se=await C(s.buildWithScope(s.mergeAll(Te.layer,_e.layer).pipe(s.provide(Dr.layer),s.provide(u.layer([u.withConsoleError(u.formatLogFmt)]))),L));i()?.markEnd("harness.storage");const Ye=d.get(Se,Te),Ge=d.get(Se,_e);I=(v.createMcpIntegration??(e=>tr({containment:e.containment,recordEffectTelemetry:e.recordEffectTelemetry,recordLifecycle:e.recordLifecycle,supervisor:{environment:e.environment,toolsSyncTtlMs:Ue?.toolsSyncTtlMs,proxyPolicy:e.proxyPolicy}})))({containment:D,environment:c,proxyPolicy:Oe(A.currentProxyPolicy,c),recordEffectTelemetry:He,recordLifecycle:b}),M=A.subscribe(e=>{const o=Oe(e,c);I?.configureProxy?.(o).catch(()=>{l.recordEffectLog({annotations:{component:"harness",operation:"update",resource:"policy","runtime.role":"harness",status:"failed"},level:"warn",message:"harness.settings.proxy"})})});const ve=Qe.getOrUndefined(d.getOption(Ee,Ie));p?.throwIfAborted(),i()?.markStart("harness.mcp-services");const Z=await C(s.buildWithScope(s.mergeAll(ke.layer({environment:t(()=>({...r,...c}),"environment")}),be.layer).pipe(s.provideMerge(te.layer({environment:t(()=>({...r,...c}),"environment"),product:t(()=>a.getConfiguration(),"product"),writeContext:t(async()=>{await n?.prepareHostExecution(x.signal);const e=t(()=>({environment:{...r,...c},product:structuredClone(a.getConfiguration()),authentication:n?.currentSessionAuthentication()}),"capture");return n?n.runConsistentRead(e):e()},"writeContext"),onConfigChange:ve?async(e,o)=>{const f=o.authentication;ve.notifyConfigChange({source:e.source,filePath:e.file_path,cwd:e.cwd},{product:o.product,environment:o.environment,fetch:t((ee,U)=>or(ee,U,o.environment),"fetch"),auth:f?{accessToken:f.credential.accessToken,method:f.credential.type,refresh:t(async({signal:ee})=>{if(!n||!a)throw new Error("Hook authentication is unavailable");const U=t(()=>{if(!Xe(o.product,a.getConfiguration()))throw new Error("Hook Product changed")},"checkProduct");await n.runConsistentRead(U);const Pe=await n.refreshHostAuthentication(f,ee);return await n.runConsistentRead(U),{accessToken:Pe.credential.accessToken,method:Pe.credential.type}},"refresh")}:void 0,account:f?{uid:f.account.id,enterpriseId:f.account.organization?.id}:void 0}).catch(()=>m.runSync(m.logWarning("harness.config-change.failed").pipe(m.provide(u.layer([u.withConsoleError(u.formatLogFmt)])))))}:void 0,reloadUserConfig:t(e=>P?.reloadUserConfig(e)??Promise.resolve(),"reloadUserConfig")})),s.provide(u.layer([u.withConsoleError(u.formatLogFmt)]))),me));i()?.markEnd("harness.mcp-services"),p?.throwIfAborted(),i()?.markStart("harness.agent-facade"),P=await(v.createAgentFacade??Ze)({userMcp:d.get(Z,ke),pluginMcp:d.get(Z,be),checkpoints:Ge,sessions:Ye,initialProductGeneration:ze().productGeneration,mcpIntegration:I,strictMcpConfig:Fe,onPermanentFailure:t(e=>{Y(e,"fused","recovery_failed"),x.abort(e)},"onPermanentFailure"),prepareSessionRuntime:t((e,o)=>{if(!n)throw new Error("Authentication runtime is not ready");return n.prepareSessionRuntime(e,o.connectionSignal)},"prepareSessionRuntime"),prepareSessionWorkspace:t(async(e,o)=>{if(!n||!a)throw new Error("Product manager is not ready");try{return await a.prepareWorkspace(e,{signal:o})}catch(f){if(!(f instanceof Er&&f.code==="AUTH_REFRESH_REQUIRED"))throw f;return await n.refreshProductAuthentication(o),a.prepareWorkspace(e,{force:!0,signal:o})}},"prepareSessionWorkspace"),releaseSessionWorkspace:t((e,o)=>a?a.releaseWorkspace(e,o):Promise.resolve(),"releaseSessionWorkspace"),refreshAuthentication:t((e,o)=>{if(!n)throw new Error("Authentication runtime is not ready");return n.refreshAuthentication(e,{signal:o?.signal??AbortSignal.abort(new Error("Authentication refresh has no operation signal"))})},"refreshAuthentication"),serverInfo:se,sessionRuntime:F,sessionReplay:Ne}),i()?.markEnd("harness.agent-facade");const Ce=pr({facade:P,onExecutionProductCommitted:j,product:a});p?.throwIfAborted(),i()?.markStart("harness.auth-service");const je=await C(s.buildWithScope(v.managedAuthLayer??$e({...a.resolveLoginProduct?{resolveLoginProduct:t((e,o)=>a.resolveLoginProduct(e,o),"resolveLoginProduct")}:{},environment:t(()=>({...r,...c}),"environment"),product:t(()=>a.getConfiguration(),"product")}).pipe(s.provide(u.layer([u.withConsoleError(u.formatLogFmt)]))),le));i()?.markEnd("harness.auth-service"),n=ur({consumer:P,getAuthMethods:t(()=>a.getAuthMethods(),"getAuthMethods"),managedAuth:d.get(je,er),onRuntimePreparing:j,onRuntimePrepared:j,productLifecycle:Ce});const S=await rr(n);n.bindProtocolBridge(S.bridge);const $=ar({selectConnectionProductProfile:t((e,o)=>n.selectConnectionProductProfile(e,o),"selectConnectionProductProfile"),provisionProduct:t((e,o)=>S.runAuthMutation(()=>n.provisionProduct(e,o)),"provisionProduct"),readProduct:t((e,o)=>n.readProduct(e,o),"readProduct"),provisionWorkspaceProduct:t((e,o)=>S.runAuthMutation(()=>n.provisionWorkspaceProduct(e,o)),"provisionWorkspaceProduct"),readWorkspaceProduct:t((e,o)=>a.readWorkspaceProduct(e,o),"readWorkspaceProduct")});a.bindPublisher({notifyProductUpdated:t(()=>$.publisher.notifyProductUpdated(Ce.currentProductSnapshot()),"notifyProductUpdated"),notifyWorkspaceProductUpdated:t(e=>$.publisher.notifyWorkspaceProductUpdated(e),"notifyWorkspaceProductUpdated")});const qe=d.empty().pipe(d.add(Lr,A),d.add(re,J),d.add(te,d.get(Z,te)));p?.throwIfAborted(),i()?.markStart("harness.rpc-services");const Ke=await C(m.provide(wr.pipe(h.provide(K)),qe));i()?.markEnd("harness.rpc-services"),w=ir([{name:"private-runtime-lifecycle",capabilities:{},initialize:t(async(e,o)=>{await oe("harness.initialize.settings",()=>A?.initialize(o.connectionSignal))},"initialize"),close:t(async e=>{M?.(),M=void 0,await X(e),await A?.close(e),await ne([[()=>G(e),()=>I?.close(e)??Promise.resolve()],[()=>N()],[()=>q(e)]],z,"private runtime shutdown")},"close")},Je({v2:P}),nr({backend:P}),Tr({backend:P}),$,{name:S.name,capabilities:S.capabilities,initialize:t(async(e,o)=>oe("harness.initialize.auth",()=>S.initialize(e,o)),"initialize"),initialized:S.initialized,notificationHandlers:S.notificationHandlers,requestHandlers:S.requestHandlers,close:Q},{...Ke,close:V}])}catch(r){throw M?.(),M=void 0,b({component:"server",error:r,phase:"startup",process:{pid:process.pid},reason:"startup_failed",state:"startup_failed"}),await ne([[()=>V(r)],[()=>Q(r)],[()=>P?.close(r)??Promise.resolve(),()=>G(r)],[()=>I?.close(r)??Promise.resolve()],[()=>X(r)],[()=>A?.close(r)??Promise.resolve()],[()=>N()],[()=>q(r)]],z,"module startup cleanup").catch(()=>{}),r}let fe;try{p?.throwIfAborted(),fe=(v.createServer??(r=>new Cr(r)))({serverInfo:se,capabilities:w.capabilities,initializeHookTimeoutMs:lr+mr+Pr,initialize:t(async(r,c)=>(i()?.markEnd("harness.wait-initialize"),oe("harness.initialize",()=>w.initialize(r,c))),"initialize"),initialized:w.initialized,notificationHandlers:w.notificationHandlers,onContainmentFailure:t(r=>{Y(r,"containment_tripped","containment_failed"),x.abort(r)},"onContainmentFailure"),readinessSignal:D.signal,requestHandlers:w.requestHandlers,telemetryRuntime:l})}catch(r){b({component:"server",error:r,phase:"startup",process:{pid:process.pid},reason:"startup_failed",state:"startup_failed"});try{await ne([[()=>w.close(r)]],z,"server construction cleanup")}catch(c){b({component:"server",error:c,phase:"cleanup",process:{pid:process.pid},reason:"cleanup_failed",state:"shutdown_failed"})}throw r}return{server:fe,modules:w,telemetry:l,containment:D,runtimeShutdown:x,recordLifecycle:b}}t(createApplicationServices,"createApplicationServices");

package/lib/client/client.js

@@ -1 +1 @@
-var q=Object.defineProperty;var h=(f,e)=>q(f,"name",{value:e,configurable:!0});import{client as C,methods as c,PROTOCOL_VERSION as g,RequestError as E}from"@agentclientprotocol/sdk/experimental/v2";import{Effect as b,Stream as M}from"effect";import{isRecord as p}from"../internal/guards.js";import{toAcpStream as v}from"../transport/effect.js";import{CLIENT_MCP_METHODS as P,ClientMcp as S,isSessionMcpMethod as A}from"./mcp.js";import{clientMethods as I,notificationDecoders as j,notificationMethods as z,peerRequestDecoders as O,requestDecoders as T,requestMethods as R,reverseMethods as N,sendNotificationMethods as _}from"./rpc.js";import{isInMemoryEndpoint as D,openTransport as L}from"./transport.js";class V{static{h(this,"ClientLifecycle")}constructor(e){this.options=e,this.state="disconnected",this.cleanup=Promise.resolve(),this.handlers=new Map,this.listeners=new Map,this.mcp=new S({request:h((i,o)=>this.requireConnected().request(c.agent.mcp.message,i,{cancellationSignal:o?.signal}),"request"),notify:h(i=>this.requireConnected().notify(c.agent.mcp.message,i),"notify")})}on(e,i){if(this.assertOpen(),P.has(e))throw new TypeError("Client owns MCP handlers; configure mcpServers on the session instead");if(typeof i!="function")throw new TypeError("Client.on requires a function");if(N.has(e))return this.register(e,i);if(z.has(e))return this.subscribe(e,i);throw new TypeError(`${e} is not an incoming Client method`)}register(e,i){if(this.handlers.has(e))throw new Error(`${e} already has a request handler`);return this.handlers.set(e,i),()=>{this.handlers.get(e)===i&&this.handlers.delete(e)}}subscribe(e,i){let o=this.listeners.get(e);return o||this.listeners.set(e,o=new Set),o.add(i),()=>{o.delete(i)}}assertOpen(){if(this.state==="closed"||this.state==="closing")throw new Error("Client is closed")}async publish(e,i){const t=(await Promise.allSettled([...this.listeners.get(e)??[]].map(async n=>{await n(i)}))).filter(n=>n.status==="rejected").map(n=>n.reason);if(t.length>0)throw new AggregateError(t,`Notification listener failed for ${e}`)}handle(e,i,o){const t=this.handlers.get(e);if(t)return t(i,o);if(e===c.client.session.requestPermission)return{outcome:{outcome:"cancelled"}};throw E.methodNotFound(e)}async request(e,i={},o){const t=this.requireConnected(),n=T[e],l=A(e)?this.mcp.prepare(i):void 0;try{const r=l?.params??i,a=await t.request(e,n?n.params(r):r,o),d=n?n.result(a):a;return l?.commit(d),e===c.agent.session.close&&p(i)&&typeof i.sessionId=="string"&&await this.mcp.closeSession(i.sessionId),d}catch(r){throw await l?.rollback(),r}}async notify(e,i){await this.requireConnected().notify(e,i)}requireConnected(){if(this.state!=="connected"||!this.agent)throw new Error("Await client.connect() before making requests");return this.agent}connect(e,i){if(this.state!=="disconnected")return Promise.reject(new Error(`Client is ${this.state}`));if(!p(e))return Promise.reject(new TypeError("connect requires a Server or connection options"));const o=D(e);if(i!==void 0&&!o)return Promise.reject(new TypeError("Separate connection settings require a Server"));const t=o?i??{}:e,n=this.options.capabilities?.elicitation;return(n?.form||n?.url)&&!this.handlers.has(c.client.elicitation.create)?Promise.reject(new Error("Register client.on('elicitation/create', handler) before advertising elicitation capabilities")):t.timeoutMs!==void 0&&(!Number.isFinite(t.timeoutMs)||t.timeoutMs<=0)?Promise.reject(new TypeError("timeoutMs must be positive")):(this.state="connecting",this.initialization=void 0,this.connectAbort=new AbortController,this.connecting=this.open(e,t,this.connectAbort),this.connecting)}async open(e,i,o){const t=setTimeout(()=>o.abort(new Error("Client connect timed out")),i.timeoutMs??3e4),n=i.signal?AbortSignal.any([i.signal,o.signal]):o.signal;let l;try{n.throwIfAborted(),await this.cleanup;const r=await L(e);this.stream=r,n.throwIfAborted();const a=C();a.onConnect(({agent:s})=>{this.agent=s}),a.onRequest(c.client.session.requestPermission,async s=>await this.handle(c.client.session.requestPermission,s.params,s)),a.onRequest(c.client.elicitation.create,async s=>await this.handle(c.client.elicitation.create,s.params,s)),a.onNotification(c.client.session.update,({params:s})=>this.publish(c.client.session.update,s)),a.onNotification(c.client.elicitation.complete,({params:s})=>this.publish(c.client.elicitation.complete,s));for(const[s,u]of Object.entries(O))a.onRequest(s,u.params,async m=>u.result(await this.handle(s,m.params,m)));for(const[s,u]of Object.entries(j))a.onNotification(s,u,({params:m})=>this.publish(s,m));a.onRequest(c.client.mcp.connect,s=>this.mcp.connect(s.params,s.signal)),a.onRequest(c.client.mcp.disconnect,s=>this.mcp.disconnect(s.params)),a.onRequest(c.client.mcp.message,s=>this.mcp.message(s.params,s.signal)),a.onNotification(c.client.mcp.message,s=>this.mcp.notify(s.params));const d=a.connect(v(this.adaptInitialize(r)));this.connection=d,this.cleanup=d.closed.then(async()=>{this.connection===d&&(this.connection=void 0,this.agent=void 0,this.state==="connected"&&(this.state="disconnected")),await this.mcp.close(),await b.runPromise(r.close())}),this.cleanup.catch(()=>{});const w=this.agent;if(!w)throw new Error("ACP SDK did not create its client context");const y=w.request(c.agent.initialize,{protocolVersion:g,info:this.options.clientInfo??{name:"agent-harness-client",version:"0.1.0"},capabilities:this.options.capabilities??{}});if(await Promise.race([y,new Promise((s,u)=>{l=h(()=>{d.close(n.reason),u(n.reason)},"onAbort"),n.addEventListener("abort",l,{once:!0}),n.aborted&&l()})]),await w.notify("initialized",{}),n.throwIfAborted(),d.signal.aborted)throw d.signal.reason;this.state="connected"}catch(r){throw this.connection?.close(r),await this.releaseStream(r),this.agent=void 0,this.connection=void 0,this.initialization=void 0,this.state==="connecting"&&(this.state="disconnected"),r}finally{clearTimeout(t),l&&n.removeEventListener("abort",l)}}adaptInitialize(e){let i;const o=h(t=>{if("id"in t&&t.id===i&&"result"in t){const n=t.result;if(!p(n)||n.protocolVersion!==1||!p(n.serverInfo)||!p(n.capabilities))throw new TypeError("Invalid Harness initialize response");return this.initialization=n,{...t,result:{protocolVersion:g,info:n.serverInfo,capabilities:n.capabilities.agent??{},...n.authMethods===void 0?{}:{authMethods:n.authMethods},...n._meta===void 0?{}:{_meta:n._meta}}}}return t},"project");return{...e,incoming:M.map(e.incoming,t=>Array.isArray(t)?t.map(o):o(t)),send:h(t=>!Array.isArray(t)&&"method"in t&&"id"in t&&t.method===c.agent.initialize?(i=t.id,e.send({...t,params:{protocolVersion:1,clientInfo:this.options.clientInfo??{name:"agent-harness-client",version:"0.1.0"},capabilities:{agent:this.options.capabilities??{},...this.options.account===void 0?{}:{account:this.options.account},...this.options.product===void 0?{}:{product:this.options.product}}}})):e.send(t),"send")}}async releaseStream(e){this.stream&&await b.runPromise(this.stream.close(e)).catch(()=>{}),await this.cleanup.catch(()=>{}),this.stream=void 0}close(){return this.closing??=(async()=>{this.state="closing",this.connectAbort?.abort(new Error("Client closed")),this.connection?.close(),await this.connecting?.catch(()=>{}),await this.releaseStream(),await this.mcp.close(),this.handlers.clear(),this.listeners.clear(),this.state="closed"})()}}export function createClient(f={}){const e=new V(structuredClone(f));function i(o){const t={};for(const[n,l]of Object.entries(o))if(typeof l!="string"){const r=i(l);Object.keys(r).length>0&&(t[n]=r)}else _.has(l)?t[n]=r=>e.notify(l,r):R.has(l)&&(t[n]=(r,a)=>e.request(l,r,a));return Object.freeze(t)}return h(i,"project"),Object.freeze(Object.defineProperties({...i(I)},{state:{get:h(()=>e.state,"get")},initialization:{get:h(()=>e.initialization,"get")},on:{value:h((o,t)=>e.on(o,t),"value")},connect:{value:h((o,t)=>e.connect(o,t),"value")},close:{value:h(()=>e.close(),"value")}}))}h(createClient,"createClient");
+var q=Object.defineProperty;var h=(f,e)=>q(f,"name",{value:e,configurable:!0});import{client as C,methods as c,PROTOCOL_VERSION as g,RequestError as E}from"@agentclientprotocol/sdk/experimental/v2";import{Effect as b,Stream as M}from"effect";import{isRecord as p}from"../internal/guards.js";import{toAcpStream as v}from"../transport/effect.js";import{CLIENT_MCP_METHODS as P,ClientMcp as S,isSessionMcpMethod as A}from"./mcp.js";import{clientMethods as I,notificationDecoders as j,notificationMethods as z,peerRequestDecoders as O,requestDecoders as T,requestMethods as R,reverseMethods as N,sendNotificationMethods as _}from"./rpc.js";import{isInMemoryEndpoint as D,openTransport as L}from"./transport.js";class V{static{h(this,"ClientLifecycle")}constructor(e){this.options=e,this.state="disconnected",this.cleanup=Promise.resolve(),this.handlers=new Map,this.listeners=new Map,this.mcp=new S({request:h((i,o)=>this.requireConnected().request(c.agent.mcp.message,i,{cancellationSignal:o?.signal}),"request"),notify:h(i=>this.requireConnected().notify(c.agent.mcp.message,i),"notify")})}on(e,i){if(this.assertOpen(),P.has(e))throw new TypeError("Client owns MCP handlers; configure mcpServers on the session instead");if(typeof i!="function")throw new TypeError("Client.on requires a function");if(N.has(e))return this.register(e,i);if(z.has(e))return this.subscribe(e,i);throw new TypeError(`${e} is not an incoming Client method`)}register(e,i){if(this.handlers.has(e))throw new Error(`${e} already has a request handler`);return this.handlers.set(e,i),()=>{this.handlers.get(e)===i&&this.handlers.delete(e)}}subscribe(e,i){let o=this.listeners.get(e);return o||this.listeners.set(e,o=new Set),o.add(i),()=>{o.delete(i)}}assertOpen(){if(this.state==="closed"||this.state==="closing")throw new Error("Client is closed")}async publish(e,i){const t=(await Promise.allSettled([...this.listeners.get(e)??[]].map(async n=>{await n(i)}))).filter(n=>n.status==="rejected").map(n=>n.reason);if(t.length>0)throw new AggregateError(t,`Notification listener failed for ${e}`)}handle(e,i,o){const t=this.handlers.get(e);if(t)return t(i,o);if(e===c.client.session.requestPermission)return{outcome:{outcome:"cancelled"}};throw E.methodNotFound(e)}async request(e,i={},o){const t=this.requireConnected(),n=T[e],l=A(e)?this.mcp.prepare(i):void 0;let a;try{const r=l?.params??i,d=await t.request(e,n?n.params(r):r,o);a=n?n.result(d):d}catch(r){throw await l?.rollback(),r}return await l?.commit(a),e===c.agent.session.close&&p(i)&&typeof i.sessionId=="string"&&await this.mcp.closeSession(i.sessionId),a}async notify(e,i){await this.requireConnected().notify(e,i)}requireConnected(){if(this.state!=="connected"||!this.agent)throw new Error("Await client.connect() before making requests");return this.agent}connect(e,i){if(this.state!=="disconnected")return Promise.reject(new Error(`Client is ${this.state}`));if(!p(e))return Promise.reject(new TypeError("connect requires a Server or connection options"));const o=D(e);if(i!==void 0&&!o)return Promise.reject(new TypeError("Separate connection settings require a Server"));const t=o?i??{}:e,n=this.options.capabilities?.elicitation;return(n?.form||n?.url)&&!this.handlers.has(c.client.elicitation.create)?Promise.reject(new Error("Register client.on('elicitation/create', handler) before advertising elicitation capabilities")):t.timeoutMs!==void 0&&(!Number.isFinite(t.timeoutMs)||t.timeoutMs<=0)?Promise.reject(new TypeError("timeoutMs must be positive")):(this.state="connecting",this.initialization=void 0,this.connectAbort=new AbortController,this.connecting=this.open(e,t,this.connectAbort),this.connecting)}async open(e,i,o){const t=setTimeout(()=>o.abort(new Error("Client connect timed out")),i.timeoutMs??3e4),n=i.signal?AbortSignal.any([i.signal,o.signal]):o.signal;let l;try{n.throwIfAborted(),await this.cleanup;const a=await L(e);this.stream=a,n.throwIfAborted();const r=C();r.onConnect(({agent:s})=>{this.agent=s}),r.onRequest(c.client.session.requestPermission,async s=>await this.handle(c.client.session.requestPermission,s.params,s)),r.onRequest(c.client.elicitation.create,async s=>await this.handle(c.client.elicitation.create,s.params,s)),r.onNotification(c.client.session.update,({params:s})=>this.publish(c.client.session.update,s)),r.onNotification(c.client.elicitation.complete,({params:s})=>this.publish(c.client.elicitation.complete,s));for(const[s,u]of Object.entries(O))r.onRequest(s,u.params,async m=>u.result(await this.handle(s,m.params,m)));for(const[s,u]of Object.entries(j))r.onNotification(s,u,({params:m})=>this.publish(s,m));r.onRequest(c.client.mcp.connect,s=>this.mcp.connect(s.params,s.signal)),r.onRequest(c.client.mcp.disconnect,s=>this.mcp.disconnect(s.params)),r.onRequest(c.client.mcp.message,s=>this.mcp.message(s.params,s.signal)),r.onNotification(c.client.mcp.message,s=>this.mcp.notify(s.params));const d=r.connect(v(this.adaptInitialize(a)));this.connection=d,this.cleanup=d.closed.then(async()=>{this.connection===d&&(this.connection=void 0,this.agent=void 0,this.state==="connected"&&(this.state="disconnected")),await this.mcp.close(),await b.runPromise(a.close())}),this.cleanup.catch(()=>{});const w=this.agent;if(!w)throw new Error("ACP SDK did not create its client context");const y=w.request(c.agent.initialize,{protocolVersion:g,info:this.options.clientInfo??{name:"agent-harness-client",version:"0.1.0"},capabilities:this.options.capabilities??{}});if(await Promise.race([y,new Promise((s,u)=>{l=h(()=>{d.close(n.reason),u(n.reason)},"onAbort"),n.addEventListener("abort",l,{once:!0}),n.aborted&&l()})]),await w.notify("initialized",{}),n.throwIfAborted(),d.signal.aborted)throw d.signal.reason;this.state="connected"}catch(a){throw this.connection?.close(a),await this.releaseStream(a),this.agent=void 0,this.connection=void 0,this.initialization=void 0,this.state==="connecting"&&(this.state="disconnected"),a}finally{clearTimeout(t),l&&n.removeEventListener("abort",l)}}adaptInitialize(e){let i;const o=h(t=>{if("id"in t&&t.id===i&&"result"in t){const n=t.result;if(!p(n)||n.protocolVersion!==1||!p(n.serverInfo)||!p(n.capabilities))throw new TypeError("Invalid Harness initialize response");return this.initialization=n,{...t,result:{protocolVersion:g,info:n.serverInfo,capabilities:n.capabilities.agent??{},...n.authMethods===void 0?{}:{authMethods:n.authMethods},...n._meta===void 0?{}:{_meta:n._meta}}}}return t},"project");return{...e,incoming:M.map(e.incoming,t=>Array.isArray(t)?t.map(o):o(t)),send:h(t=>!Array.isArray(t)&&"method"in t&&"id"in t&&t.method===c.agent.initialize?(i=t.id,e.send({...t,params:{protocolVersion:1,clientInfo:this.options.clientInfo??{name:"agent-harness-client",version:"0.1.0"},capabilities:{agent:this.options.capabilities??{},...this.options.account===void 0?{}:{account:this.options.account},...this.options.product===void 0?{}:{product:this.options.product}}}})):e.send(t),"send")}}async releaseStream(e){this.stream&&await b.runPromise(this.stream.close(e)).catch(()=>{}),await this.cleanup.catch(()=>{}),this.stream=void 0}close(){return this.closing??=(async()=>{this.state="closing",this.connectAbort?.abort(new Error("Client closed")),this.connection?.close(),await this.connecting?.catch(()=>{}),await this.releaseStream(),await this.mcp.close(),this.handlers.clear(),this.listeners.clear(),this.state="closed"})()}}export function createClient(f={}){const e=new V(structuredClone(f));function i(o){const t={};for(const[n,l]of Object.entries(o))if(typeof l!="string"){const a=i(l);Object.keys(a).length>0&&(t[n]=a)}else _.has(l)?t[n]=a=>e.notify(l,a):R.has(l)&&(t[n]=(a,r)=>e.request(l,a,r));return Object.freeze(t)}return h(i,"project"),Object.freeze(Object.defineProperties({...i(I)},{state:{get:h(()=>e.state,"get")},initialization:{get:h(()=>e.initialization,"get")},on:{value:h((o,t)=>e.on(o,t),"value")},connect:{value:h((o,t)=>e.connect(o,t),"value")},close:{value:h(()=>e.close(),"value")}}))}h(createClient,"createClient");

package/lib/client/mcp.d.ts

@@ -19,7 +19,7 @@ export declare class ClientMcp {
     constructor(peer: AgentMcpPeer);
     prepare(params: unknown): {
         params: unknown;
-        commit(result: unknown): void;
+        commit(result: unknown): Promise<void>;
         rollback(): Promise<void>;
     };
     connect(params: ConnectMcpRequest, signal: AbortSignal): Promise<{

package/lib/client/mcp.js

@@ -1 +1 @@
-var I=Object.defineProperty;var c=(a,e)=>I(a,"name",{value:e,configurable:!0});import{randomUUID as u}from"node:crypto";import{methods as f,RequestError as y}from"@agentclientprotocol/sdk/experimental/v2";import{McpPeerTransport as v}from"../integration/mcp-peer-transport.js";import{isRecord as p}from"../internal/guards.js";const g=new WeakSet,P=128,C=128;export class ClientMcp{static{c(this,"ClientMcp")}constructor(e){this.peer=e,this.providers=new Map,this.connections=new Map,this.sessions=new Map,this.generation=0,this.opening=0}prepare(e){const n=[];let s=e;try{p(e)&&Array.isArray(e.mcpServers)&&(s={...e,mcpServers:e.mcpServers.map(t=>{if(!p(t)||!("transport"in t))return t;if(typeof t.name!="string"||!t.name.trim()||"type"in t||"serverId"in t)throw new TypeError("Local MCP requires { name, transport }");const o=t.transport;if(typeof o!="function"&&!M(o))throw new TypeError("MCP transport must implement the MCP SDK Transport interface");if(this.providers.size>=P)throw new RangeError("Too many local MCP providers");const r=u();return this.providers.set(r,{source:o,connections:new Set}),n.push(r),{type:"acp",name:t.name,serverId:r,...t._meta===void 0?{}:{_meta:t._meta}}})})}catch(t){for(const o of n)this.providers.delete(o);throw t}return{params:s,commit:c(t=>{if(!n.length)return;const o=p(t)&&typeof t.sessionId=="string"?t.sessionId:p(e)&&typeof e.sessionId=="string"?e.sessionId:void 0;if(!o)throw new Error("Session setup returned no sessionId for its MCP providers");const r=this.sessions.get(o)??new Set;for(const i of n)r.add(i);this.sessions.set(o,r)},"commit"),rollback:c(()=>this.release(n),"rollback")}}async connect(e,n){const s=this.providers.get(e.serverId);if(!s)throw y.invalidParams("Unknown MCP serverId");if(this.connections.size+this.opening>=C)throw new Error("Too many local MCP connections");this.opening++;try{const t=this.generation;n.throwIfAborted();const o=typeof s.source=="function"?await s.source():s.source;if(!M(o))throw new TypeError("MCP transport factory did not return a Transport");if(g.has(o)||o.onmessage||o.onclose||o.onerror)throw new Error("MCP Transport is already owned; return a fresh transport from a factory for each connection");if(g.add(o),n.aborted||t!==this.generation||this.providers.get(e.serverId)!==s)throw await o.close(),n.reason??new Error("MCP provider closed during connection");const r=u(),i=new v(r,this.peer);let l;const w=c(()=>l??=Promise.resolve().then(async()=>{this.connections.delete(r),s.connections.delete(r),i.closeFromScope(new Error("MCP connection closed")),await o.close()}),"close"),d=c(()=>{w().catch(()=>{})},"fail");i.onmessage=h=>{o.send(h).catch(d)},o.onmessage=h=>{i.send(h).catch(d)},i.onclose=o.onclose=d,i.onerror=o.onerror=d,this.connections.set(r,{provider:s,bridge:i,transport:o,close:w}),s.connections.add(r);const m=c(()=>{d()},"abort");n.addEventListener("abort",m,{once:!0});try{if(await i.start(),await o.start(),n.throwIfAborted(),l)throw new Error("MCP Transport closed during startup");return{connectionId:r}}catch(h){throw await w(),h}finally{n.removeEventListener("abort",m)}}finally{this.opening--}}message(e,n){return this.require(e.connectionId).bridge.receiveRequest(e.method,e.params,n)}notify(e){this.require(e.connectionId).bridge.receiveNotification(e.method,e.params)}async disconnect(e){return await this.connections.get(e.connectionId)?.close(),{}}async closeSession(e){const n=this.sessions.get(e)??[];this.sessions.delete(e),await this.release(n)}async close(){this.generation++,this.sessions.clear(),await this.release([...this.providers.keys()])}async release(e){const n=[];for(const s of e){const t=this.providers.get(s);this.providers.delete(s);for(const o of t?.connections??[]){const r=this.connections.get(o);r&&n.push(r)}}await Promise.all(n.map(s=>s.close()))}require(e){const n=this.connections.get(e);if(!n)throw y.invalidParams("Unknown MCP connectionId");return n}}function M(a){return p(a)&&["start","send","close"].every(e=>typeof a[e]=="function")}c(M,"isTransport");export const CLIENT_MCP_METHODS=new Set(Object.values(f.client.mcp)),sessionMcpMethods=[f.agent.session.new,f.agent.session.resume,f.agent.session.fork];export function isSessionMcpMethod(a){return sessionMcpMethods.some(e=>e===a)}c(isSessionMcpMethod,"isSessionMcpMethod");
+var M=Object.defineProperty;var a=(d,e)=>M(d,"name",{value:e,configurable:!0});import{randomUUID as u}from"node:crypto";import{methods as w,RequestError as y}from"@agentclientprotocol/sdk/experimental/v2";import{McpPeerTransport as I}from"../integration/mcp-peer-transport.js";import{isRecord as h}from"../internal/guards.js";const g=new WeakSet,P=128,C=128;export class ClientMcp{static{a(this,"ClientMcp")}constructor(e){this.peer=e,this.providers=new Map,this.connections=new Map,this.sessions=new Map,this.generation=0,this.opening=0}prepare(e){const n=[];let r=e;try{h(e)&&Array.isArray(e.mcpServers)&&(r={...e,mcpServers:e.mcpServers.map(t=>{if(!h(t)||!("transport"in t))return t;if(typeof t.name!="string"||!t.name.trim()||"type"in t||"serverId"in t)throw new TypeError("Local MCP requires { name, transport }");const o=t.transport;if(typeof o!="function"&&!v(o))throw new TypeError("MCP transport must implement the MCP SDK Transport interface");if(this.providers.size>=P)throw new RangeError("Too many local MCP providers");const s=u();return this.providers.set(s,{source:o,connections:new Set}),n.push(s),{type:"acp",name:t.name,serverId:s,...t._meta===void 0?{}:{_meta:t._meta}}})})}catch(t){for(const o of n)this.providers.delete(o);throw t}return{params:r,commit:a(async t=>{const o=h(t)&&typeof t.sessionId=="string"?t.sessionId:h(e)&&typeof e.sessionId=="string"?e.sessionId:void 0;if(!o){if(n.length)throw new Error("Session setup returned no sessionId for its MCP providers");return}const s=this.sessions.get(o)??new Set,i=new Set(n);if(h(r)&&Array.isArray(r.mcpServers))for(const c of r.mcpServers)h(c)&&typeof c.serverId=="string"&&this.providers.has(c.serverId)&&i.add(c.serverId);this.sessions.set(o,i),await this.release([...s].filter(c=>!i.has(c)))},"commit"),rollback:a(()=>this.release(n),"rollback")}}async connect(e,n){const r=this.providers.get(e.serverId);if(!r)throw y.invalidParams("Unknown MCP serverId");if(this.connections.size+this.opening>=C)throw new Error("Too many local MCP connections");this.opening++;try{const t=this.generation;n.throwIfAborted();const o=typeof r.source=="function"?await r.source():r.source;if(!v(o))throw new TypeError("MCP transport factory did not return a Transport");if(g.has(o)||o.onmessage||o.onclose||o.onerror)throw new Error("MCP Transport is already owned; return a fresh transport from a factory for each connection");if(g.add(o),n.aborted||t!==this.generation||this.providers.get(e.serverId)!==r)throw await o.close(),n.reason??new Error("MCP provider closed during connection");const s=u(),i=new I(s,this.peer);let c;const l=a(()=>c??=Promise.resolve().then(async()=>{this.connections.delete(s),r.connections.delete(s),i.closeFromScope(new Error("MCP connection closed")),await o.close()}),"close"),p=a(()=>{l().catch(()=>{})},"fail");i.onmessage=f=>{o.send(f).catch(p)},o.onmessage=f=>{i.send(f).catch(p)},i.onclose=o.onclose=p,i.onerror=o.onerror=p,this.connections.set(s,{provider:r,bridge:i,transport:o,close:l}),r.connections.add(s);const m=a(()=>{p()},"abort");n.addEventListener("abort",m,{once:!0});try{if(await i.start(),await o.start(),n.throwIfAborted(),c)throw new Error("MCP Transport closed during startup");return{connectionId:s}}catch(f){throw await l(),f}finally{n.removeEventListener("abort",m)}}finally{this.opening--}}message(e,n){return this.require(e.connectionId).bridge.receiveRequest(e.method,e.params,n)}notify(e){this.require(e.connectionId).bridge.receiveNotification(e.method,e.params)}async disconnect(e){return await this.connections.get(e.connectionId)?.close(),{}}async closeSession(e){const n=this.sessions.get(e)??[];this.sessions.delete(e),await this.release(n)}async close(){this.generation++,this.sessions.clear(),await this.release([...this.providers.keys()])}async release(e){const n=[];for(const r of e){const t=this.providers.get(r);this.providers.delete(r);for(const o of t?.connections??[]){const s=this.connections.get(o);s&&n.push(s)}}await Promise.all(n.map(r=>r.close()))}require(e){const n=this.connections.get(e);if(!n)throw y.invalidParams("Unknown MCP connectionId");return n}}function v(d){return h(d)&&["start","send","close"].every(e=>typeof d[e]=="function")}a(v,"isTransport");export const CLIENT_MCP_METHODS=new Set(Object.values(w.client.mcp)),sessionMcpMethods=[w.agent.session.new,w.agent.session.resume,w.agent.session.fork];export function isSessionMcpMethod(d){return sessionMcpMethods.some(e=>e===d)}a(isSessionMcpMethod,"isSessionMcpMethod");

package/lib/components/acp-mcp-transport.d.mts

@@ -1 +1,84 @@
-export * from './acp/acp-mcp-transport.js';
+import { type AgentContext, type JsonRpcId as AcpJsonRpcId, type MessageMcpNotification, type MessageMcpRequest } from '@agentclientprotocol/sdk/experimental/v2';
+import type { Transport, TransportSendOptions } from '@modelcontextprotocol/sdk/shared/transport.js';
+import { type JSONRPCMessage, type RequestId } from '@modelcontextprotocol/sdk/types.js';
+type McpClientContext = Pick<AgentContext, 'request' | 'notify'>;
+type AcpMcpParams = Record<string, unknown> | null | undefined;
+export interface AcpMcpPeerRegistration {
+    readonly peer: AcpMcpPeer;
+    dispose(reason?: unknown): Promise<void>;
+}
+export interface AcpMcpTransportOptions {
+    readonly routeId: string;
+    readonly serverId: string;
+    /** Cancels acquisition without transferring ownership of an established connection. */
+    readonly signal?: AbortSignal;
+}
+/**
+ * Registers the client side of one live ACP v2 connection.
+ *
+ * Session MCP configuration crosses the Agent CLI's internal HTTP boundary, so
+ * it carries only the opaque route id and resolves the live `AgentContext`
+ * here. A route is exact and cannot be replaced while it is active.
+ */
+export declare function registerAcpMcpPeer(routeId: string, client: McpClientContext, signal: AbortSignal): AcpMcpPeerRegistration;
+export declare function requireAcpMcpPeer(routeId: string): AcpMcpPeer;
+/**
+ * Connection-scoped MCP-over-ACP dispatcher. One peer may own many physical
+ * MCP connections, each selected by the provider-generated `connectionId`.
+ */
+export declare class AcpMcpPeer {
+    private readonly client;
+    private readonly rootSignal;
+    private readonly transports;
+    private isClosed;
+    constructor(client: McpClientContext, rootSignal: AbortSignal);
+    get closed(): boolean;
+    connect(serverId: string, signal: AbortSignal): Promise<string>;
+    attach(connectionId: string, transport: AcpMcpTransport): void;
+    request(transport: AcpMcpTransport, connectionId: string, method: string, params: AcpMcpParams, signal: AbortSignal): Promise<unknown>;
+    notify(transport: AcpMcpTransport, connectionId: string, method: string, params: AcpMcpParams): Promise<void>;
+    disconnect(transport: AcpMcpTransport, connectionId: string): Promise<void>;
+    disconnectUnattached(connectionId: string): Promise<void>;
+    receiveRequest(params: MessageMcpRequest, requestId: AcpJsonRpcId, signal: AbortSignal): Promise<unknown>;
+    receiveNotification(params: MessageMcpNotification): void;
+    closeFromRoot(reason?: unknown): Promise<void>;
+    private requireTransport;
+    private assertAttached;
+    private assertOpen;
+}
+/**
+ * MCP SDK transport backed by the standard ACP v2 MCP methods.
+ *
+ * ACP intentionally omits the inner JSON-RPC envelope. The outer request id is
+ * the id observed by the MCP provider, while this transport restores the local
+ * MCP SDK's id when it delivers the response back to the SDK.
+ */
+export declare class AcpMcpTransport implements Transport {
+    private readonly options;
+    private state;
+    private peer?;
+    private connectionIdValue?;
+    private startController?;
+    private closePromise?;
+    private closeNotified;
+    private readonly outbound;
+    private readonly inbound;
+    onclose?: () => void;
+    onerror?: (error: Error) => void;
+    onmessage?: <T extends JSONRPCMessage>(message: T) => void;
+    constructor(options: AcpMcpTransportOptions);
+    get sessionId(): string | undefined;
+    start(): Promise<void>;
+    send(message: JSONRPCMessage, _options?: TransportSendOptions): Promise<void>;
+    close(): Promise<void>;
+    closeFromPeer(reason?: unknown): Promise<void>;
+    receiveRequest(requestId: RequestId, method: string, params: AcpMcpParams, signal: AbortSignal): Promise<unknown>;
+    receiveNotification(method: string, params: AcpMcpParams): void;
+    private sendRequest;
+    private sendNotification;
+    private settleInbound;
+    private finishClose;
+    private deliver;
+    private notifyClose;
+}
+export {};

package/lib/components/question-elicitation.d.mts

@@ -1 +1,20 @@
-export * from './acp/acp-question-elicitation.js';
+import type { CreateElicitationRequest, ElicitationSchema } from '@agentclientprotocol/sdk';
+export interface AskUserQuestionInput {
+    questions: Array<{
+        question: string;
+        header: string;
+        options: Array<{
+            label: string;
+            description: string;
+        }>;
+        multiSelect?: boolean;
+    }>;
+    metadata?: {
+        source?: string;
+    };
+}
+export declare function createAskUserQuestionElicitation(input: AskUserQuestionInput, sessionId: string, toolCallId: string, meta?: Record<string, unknown>): CreateElicitationRequest & {
+    mode: 'form';
+    requestedSchema: ElicitationSchema;
+};
+export declare function normalizeAskUserQuestionElicitationAnswers(input: AskUserQuestionInput, content: unknown): Record<string, string>;

package/lib/components/sandbox-center.d.mts

@@ -0,0 +1,2 @@
+export { buildEpochCenterAddress, createSandboxCenterClient, SANDBOX_CENTER_IPC_ADDRESS_ENV, SANDBOX_CENTER_LIFECYCLE_COMMANDS, SANDBOX_CENTER_START_MODE_ENV, SANDBOX_RULES_COMMANDS, spawnSandboxCenter, } from '../../cli/dist-server/types/workspace/sandbox-cli/lib/node/sandbox-center-client.js';
+export { getSandboxCenterPath } from '../../cli/dist-server/types/workspace/sandbox-cli/lib/node/resolver.js';

package/lib/components/sandbox-center.mjs

@@ -0,0 +1 @@
+import e from"#agent-harness-runtime";const n=e["component-sandbox-center"]();export const{buildEpochCenterAddress,createSandboxCenterClient,SANDBOX_CENTER_IPC_ADDRESS_ENV,SANDBOX_CENTER_LIFECYCLE_COMMANDS,SANDBOX_CENTER_START_MODE_ENV,SANDBOX_RULES_COMMANDS,spawnSandboxCenter,getSandboxCenterPath}=n;

package/lib/components/{acp/acp-prompt-input.d.ts → session/prompt-input.d.ts}

@@ -1,6 +1,6 @@
 import type { PromptRequest as V2PromptRequest } from '@agentclientprotocol/sdk/experimental/v2';
+import type { PromptRequest } from '../../../cli/dist-server/types/node/server/formats/acp/acp-protocol.js';
 import type { AgentInputItem } from '../../../cli/dist-server/types/vendor/cbc-shared/node/index.js';
-import type { PromptRequest } from './acp-protocol.js';
 /** Persist SDK content once. Resource bytes are projected for the model only at its boundary. */
 export declare function acpPromptInput(input: PromptRequest | V2PromptRequest): AgentInputItem[];
 export { projectPromptFilesForModel } from '../../../cli/dist-server/types/node/utils/embedded-resource.js';

package/lib/components/session-config.d.mts

@@ -1,6 +1,8 @@
 import type { QueryOptions } from '#agent-harness-codebuddy/server';
 import type { AcpV2ClientCapabilities } from '../protocol/acp-v2.js';
 import type { SessionConfigProjector } from '../session/server-config.js';
+/** Harness opts in to the native Linux sandbox only when its executable is present. */
+export declare function isLinuxSandboxCLIInstalled(): boolean;
 /** Both backends use the CLI's option vocabulary and ACP v2 projection. */
 export declare const projectSessionConfig: SessionConfigProjector;
 export declare function projectSessionContextSize(options: QueryOptions, modelId?: string): number | undefined;

package/lib/components/session-config.mjs

@@ -1 +1 @@
-import o from"#agent-harness-runtime";const e=o["component-session-config"]();export const{projectSessionContextSize,createSessionConfigProjector,projectSessionConfig}=e;
+import o from"#agent-harness-runtime";const e=o["component-session-config"]();export const{isLinuxSandboxCLIInstalled,projectSessionContextSize,createSessionConfigProjector,projectSessionConfig}=e;

package/lib/components/session-replay.d.mts

@@ -1,8 +1,9 @@
+import { codeBuddyErrorFromRequestError } from '../../cli/dist-server/types/node/server/formats/acp/acp-error-model.js';
 import type { AgentInputItem } from '../../cli/dist-server/types/vendor/cbc-shared/node/index.js';
-import type { AgentEventProjector, AgentItemProjector, SessionReplayProjector, SessionUsage, SessionUsageHistory } from '../session/replay.js';
+import type { SessionReplayProjector, SessionUsage, SessionUsageHistory } from '../session/replay.js';
 import type { AgentHarnessRewindSessionRequest } from '../session/turn.js';
-import { codeBuddyErrorFromRequestError } from './acp/acp-error-model.js';
-export { acpPromptInput } from './acp/acp-prompt-input.js';
+export { AcpSessionFormatter } from '../../cli/dist-server/types/node/server/formats/acp/index.js';
+export { acpPromptInput } from './session/prompt-input.js';
 /** Interpret ACP turn cursors outside the Agent's native storage API. */
 export declare function selectRewindMessage(snapshot: Parameters<SessionReplayProjector>[0], boundary: AgentHarnessRewindSessionRequest['_meta']): string | null;
 export declare function createToolInputParser(): (delta: string) => Record<string, unknown>;
@@ -13,12 +14,10 @@ export declare function projectAgentError(message: string, info?: {
     code?: string | number;
     details?: string;
 } | null): ReturnType<typeof codeBuddyErrorFromRequestError>;
+export declare function projectAgentFailure(error: unknown): ReturnType<typeof projectAgentError>;
 /** The durable assistant error carries its original HTTP/category fields. */
 export declare function projectAgentItemError(item: AgentInputItem): ReturnType<typeof projectAgentError> | undefined;
-/** Live complete items and replay share content, tool and identity projection. */
-export declare const projectAgentItem: AgentItemProjector;
-/** Reuse the CLI's ACP extension vocabulary; the Agent only exports kernel facts. */
-export declare const projectAgentEvent: AgentEventProjector;
+export { projectAgentItem, projectAgentEvent } from '../../cli/dist-server/types/node/server/formats/acp/projection.js';
 /** Storage-only ACP projection: no Cell container or execution services. */
 export declare const projectSessionReplay: SessionReplayProjector;
 /** Per-transcript billing stages and context; tree edges come from live lifecycle or SessionStore. */

package/lib/components/session-replay.mjs

@@ -1 +1 @@
-import e from"#agent-harness-runtime";const t=e["component-session-replay"]();export const{selectRewindMessage,createToolInputParser,projectAgentError,projectAgentItemError,createSessionUsage,acpPromptInput,projectAgentItem,projectAgentEvent,projectSessionReplay}=t;
+import e from"#agent-harness-runtime";const t=e["component-session-replay"]();export const{selectRewindMessage,createToolInputParser,projectAgentError,projectAgentFailure,projectAgentItemError,createSessionUsage,AcpSessionFormatter,acpPromptInput,projectAgentItem,projectAgentEvent,projectSessionReplay}=t;

package/lib/effect-runtime/mcp-lifecycle.mjs

@@ -1 +1 @@
-var N=Object.defineProperty;var r=(e,t)=>N(e,"name",{value:t,configurable:!0});import{Effect as c,Exit as b,MutableList as C,PubSub as w,Queue as S,Scope as y,Semaphore as R,SubscriptionRef as B,SynchronizedRef as E}from"effect";class U extends Error{static{r(this,"McpPromiseError")}constructor(t,s){super(`MCP Promise rejected during ${t}`),this.operation=t,this.cause=s,this._tag="McpPromiseError",this.name=this._tag}}function x(e,t){return c.tryPromise({catch:r(s=>new U(e,s),"catch"),try:t})}r(x,"tryMcpPromise");function k(e){return e.catch(t=>{throw t instanceof U?t.cause:t})}r(k,"preserveMcpPromiseError");function $(e){return e}r($,"runtimeOf");function q(e){return e.forkScopeUnsafe()}r(q,"forkProcessScope");export async function createMcpSubscriptionState(e,t){const s=e,i=await s.runEffect(B.make(t));return{close:r(()=>s.runEffect(w.shutdown(i.pubsub)),"close"),get:r(()=>s.runEffect(B.get(i)),"get"),getUnsafe:r(()=>B.getUnsafe(i),"getUnsafe"),modify:r(f=>s.runEffect(B.modify(i,f)),"modify")}}r(createMcpSubscriptionState,"createMcpSubscriptionState");export function createMcpKeyedSerialExecutor(e){const t=e,s=E.makeUnsafe(new Map),i=r(n=>t.runEffect(E.modify(s,a=>{const o=a.get(n);if(o){const p={...o,users:o.users+1};return[p,new Map(a).set(n,p)]}const u={semaphore:R.makeUnsafe(1),users:1};return[u,new Map(a).set(n,u)]})),"gateFor"),f=r((n,a)=>t.runEffect(E.update(s,o=>{const u=o.get(n);if(u?.semaphore!==a.semaphore)return o;const p=new Map(o);return u.users<=1?p.delete(n):p.set(n,{...u,users:u.users-1}),p})),"releaseGate"),l=r(n=>t.runEffect(n.semaphore.withPermit(c.void)),"waitForGate");return{get activeKeyCount(){return E.getUnsafe(s).size},run:r(async(n,a,o)=>{const u=await i(n);try{return await k(t.runEffect(G(u.semaphore.withPermit(x("registry.reconcile",o)),a)))}finally{await f(n,u)}},"run"),waitForIdle:r(async()=>{const n=await t.runEffect(E.get(s));await Promise.all([...n.values()].map(l))},"waitForIdle"),waitForKey:r(async n=>{const a=(await t.runEffect(E.get(s))).get(n);a&&await l(a)},"waitForKey")}}r(createMcpKeyedSerialExecutor,"createMcpKeyedSerialExecutor");export async function openMcpEffectScope(e,t={}){const s=e,i=q(e),f=new Map;let l=!1,n;return{acquire:r(async o=>{if(l)throw new Error("MCP Effect scope is closed");const u=Symbol("mcp-scope-acquire"),p=new AbortController,g=(async()=>{const m=await s.runEffect(y.fork(i,"sequential"),{signal:p.signal}),d=o.acquire(p.signal),v=t.interruptPendingAcquires===!1?d:F(d,p.signal,o.release);let z;try{z=await k(s.runEffect(y.provide(c.acquireRelease(x("attachment.acquire",()=>v),h=>x("attachment.release",()=>o.release(h)).pipe(c.catch(()=>c.void))),m),{signal:p.signal}))}catch(h){throw await s.runEffect(y.close(m,b.fail(h))).catch(()=>{}),h}let P;const M=r(()=>(P??=s.runEffect(y.close(m,b.void)),P),"release");if(l)throw await M(),new Error("MCP Effect scope is closed");return{release:M,value:z}})();f.set(u,{controller:p,promise:g});try{return await g}finally{f.delete(u)}},"acquire"),close:r(()=>{if(n)return n;l=!0;const o=new Error("MCP Effect scope is closed");if(t.interruptPendingAcquires!==!1)for(const u of f.values())u.controller.abort(o);return n=(async()=>{await Promise.allSettled([...f.values()].map(u=>u.promise)),await s.runEffect(y.close(i,b.void))})(),n},"close")}}r(openMcpEffectScope,"openMcpEffectScope");function F(e,t,s){return new Promise((i,f)=>{let l=!1;const n=r(()=>{l||(l=!0,f(t.reason??new Error("MCP scoped acquisition aborted")))},"abort");t.aborted?n():t.addEventListener("abort",n,{once:!0}),e.then(a=>{if(t.removeEventListener("abort",n),l){s(a).catch(()=>{});return}l=!0,i(a)},a=>{t.removeEventListener("abort",n),!l&&(l=!0,f(a))})})}r(F,"interruptibleAcquisition");function G(e,t){const s="harness.executor.runtime",i={component:"executor",operation:t,resource:"registration"};return e.pipe(c.tap(()=>c.logInfo(s).pipe(c.annotateLogs({...i,outcome:"success"}))),c.tapError(()=>c.logWarning(s).pipe(c.annotateLogs({...i,outcome:"error"}))),c.withSpan(s,{attributes:i}))}r(G,"observeExecutorRegistrationEffect");export async function openMcpLivePubSub(e){if(!Number.isSafeInteger(e.capacity)||e.capacity<=0)throw new RangeError("MCP live PubSub capacity must be a positive safe integer");I(e.maxBufferedBytes,"MCP live PubSub");const t=e.processRuntime,s=q(e.processRuntime),i=await t.runEffect(w.sliding({capacity:e.capacity,replay:0})),f=R.makeUnsafe(1),l=[];let n=0,a=!1,o;const u=r(()=>{i.pubsub.slide();const m=l.shift();n-=m?.size??0},"removeOldest"),p=r(()=>{const m=w.sizeUnsafe(i);for(;l.length>m;){const d=l.shift();n-=d?.size??0}n<0&&(n=0)},"reconcile"),g=r(()=>{l.length=0,n=0},"clearBudget");return{capacity:e.capacity,buffered:r(()=>w.sizeUnsafe(i),"buffered"),bufferedBytes:r(()=>(p(),n),"bufferedBytes"),close:r(()=>o||(a=!0,o=t.runEffect(w.shutdown(i).pipe(c.andThen(y.close(s,b.void)),c.ensuring(c.sync(g)))),o),"close"),publish:r(m=>{if(a)return Promise.resolve(!1);const d={message:m,size:L(e.sizeOf,m,"MCP live PubSub")};return d.size>e.maxBufferedBytes?Promise.resolve(!1):t.runEffect(f.withPermit(c.gen(function*(){if(a)return!1;for(p();l.length>=e.capacity||n+d.size>e.maxBufferedBytes;)u();l.push(d),n+=d.size;const v=yield*w.publish(i,d);return p(),v})))},"publish"),subscribe:r(async m=>{if(a)throw new Error("MCP live PubSub is closed");const d=await t.runEffect(y.fork(s,"sequential")),v=await t.runEffect(y.provide(w.subscribe(i),d)),z=c.gen(function*(){for(;;){const h=yield*w.take(v);yield*c.sync(p),yield*x("registry.consume",A=>m(h.message,A)).pipe(c.catchCause(()=>c.void))}});await t.runEffect(c.forkIn(z,d));let P;const M=r(()=>(P??=t.runEffect(y.close(d,b.void).pipe(c.ensuring(c.sync(p)))),P),"release");if(a)throw await M(),new Error("MCP live PubSub is closed");return{release:M}},"subscribe")}}r(openMcpLivePubSub,"openMcpLivePubSub");export async function openMcpLiveQueue(e){if(!Number.isSafeInteger(e.capacity)||e.capacity<=0)throw new RangeError("MCP live queue capacity must be a positive safe integer");I(e.maxBufferedBytes,"MCP live queue");const t=e.processRuntime,s=q(e.processRuntime),i=await t.runEffect(S.sliding(e.capacity));let f=0;const l=c.gen(function*(){for(;;){const o=yield*S.take(i);yield*c.sync(()=>{f=Math.max(0,f-o.size)}),yield*x("queue.consume",u=>e.consume(o.message,u)).pipe(c.catchCause(()=>c.void))}});await t.runEffect(c.forkIn(l,s));let n=!1,a;return{capacity:e.capacity,buffered:r(()=>S.sizeUnsafe(i),"buffered"),bufferedBytes:r(()=>f,"bufferedBytes"),close:r(()=>a||(n=!0,a=t.runEffect(S.shutdown(i).pipe(c.andThen(y.close(s,b.void)),c.ensuring(c.sync(()=>{f=0})))),a),"close"),offer:r(o=>{if(n)return!1;const u={message:o,size:L(e.sizeOf,o,"MCP live queue")};if(u.size>e.maxBufferedBytes)return!1;for(;i.messages.length>=e.capacity||f+u.size>e.maxBufferedBytes;){const g=C.take(i.messages);if(g===C.Empty)break;f=Math.max(0,f-g.size)}const p=S.offerUnsafe(i,u);return p&&(f+=u.size),p},"offer")}}r(openMcpLiveQueue,"openMcpLiveQueue");function I(e,t){if(!Number.isSafeInteger(e)||e<=0)throw new RangeError(`${t} maxBufferedBytes must be a positive safe integer`)}r(I,"assertByteBudget");function L(e,t,s){const i=e(t);if(!Number.isSafeInteger(i)||i<0)throw new RangeError(`${s} message size must be a non-negative safe integer`);return i}r(L,"sizeMessage");
+var N=Object.defineProperty;var r=(e,t)=>N(e,"name",{value:t,configurable:!0});import{Effect as c,Exit as b,MutableList as R,PubSub as w,Queue as S,Scope as y,Semaphore as U,SubscriptionRef as B,SynchronizedRef as E}from"effect";class k extends Error{static{r(this,"McpPromiseError")}constructor(t,s){super(`MCP Promise rejected during ${t}`),this.operation=t,this.cause=s,this._tag="McpPromiseError",this.name=this._tag}}function x(e,t){return c.tryPromise({catch:r(s=>new k(e,s),"catch"),try:t})}r(x,"tryMcpPromise");function q(e){return e.catch(t=>{throw t instanceof k?t.cause:t})}r(q,"preserveMcpPromiseError");function $(e){return e}r($,"runtimeOf");function C(e){return e.forkScopeUnsafe()}r(C,"forkProcessScope");export async function createMcpSubscriptionState(e,t){const s=e,i=await s.runEffect(B.make(t));return{close:r(()=>s.runEffect(w.shutdown(i.pubsub)),"close"),get:r(()=>s.runEffect(B.get(i)),"get"),getUnsafe:r(()=>B.getUnsafe(i),"getUnsafe"),modify:r(f=>s.runEffect(B.modify(i,f)),"modify")}}r(createMcpSubscriptionState,"createMcpSubscriptionState");export function createMcpKeyedSerialExecutor(e){const t=e,s=E.makeUnsafe(new Map),i=r(n=>t.runEffect(E.modify(s,a=>{const o=a.get(n);if(o){const p={...o,users:o.users+1};return[p,new Map(a).set(n,p)]}const u={semaphore:U.makeUnsafe(1),users:1};return[u,new Map(a).set(n,u)]})),"gateFor"),f=r((n,a)=>t.runEffect(E.update(s,o=>{const u=o.get(n);if(u?.semaphore!==a.semaphore)return o;const p=new Map(o);return u.users<=1?p.delete(n):p.set(n,{...u,users:u.users-1}),p})),"releaseGate"),l=r(n=>t.runEffect(n.semaphore.withPermit(c.void)),"waitForGate");return{get activeKeyCount(){return E.getUnsafe(s).size},run:r(async(n,a,o)=>{const u=await i(n);try{return await q(t.runEffect(G(u.semaphore.withPermit(x("registry.reconcile",o)),a)))}finally{await f(n,u)}},"run"),waitForIdle:r(async()=>{const n=await t.runEffect(E.get(s));await Promise.all([...n.values()].map(l))},"waitForIdle"),waitForKey:r(async n=>{const a=(await t.runEffect(E.get(s))).get(n);a&&await l(a)},"waitForKey")}}r(createMcpKeyedSerialExecutor,"createMcpKeyedSerialExecutor");export async function openMcpEffectScope(e,t={}){const s=e,i=C(e),f=new Map;let l=!1,n;return{acquire:r(async o=>{if(l)throw new Error("MCP Effect scope is closed");const u=Symbol("mcp-scope-acquire"),p=new AbortController,g=(async()=>{const m=await s.runEffect(y.fork(i,"sequential"),{signal:p.signal}),d=o.acquire(p.signal),v=t.interruptPendingAcquires===!1?d:F(d,p.signal,o.release);let z;try{z=await q(s.runEffect(y.provide(c.acquireRelease(x("attachment.acquire",()=>v),h=>x("attachment.release",()=>o.release(h)).pipe(c.orDie)),m),{signal:p.signal}))}catch(h){throw await s.runEffect(y.close(m,b.fail(h))).catch(()=>{}),h}let P;const M=r(()=>(P??=q(s.runEffect(y.close(m,b.void))),P),"release");if(l)throw await M(),new Error("MCP Effect scope is closed");return{release:M,value:z}})();f.set(u,{controller:p,promise:g});try{return await g}finally{f.delete(u)}},"acquire"),close:r(()=>{if(n)return n;l=!0;const o=new Error("MCP Effect scope is closed");if(t.interruptPendingAcquires!==!1)for(const u of f.values())u.controller.abort(o);return n=(async()=>{await Promise.allSettled([...f.values()].map(u=>u.promise)),await q(s.runEffect(y.close(i,b.void)))})(),n},"close")}}r(openMcpEffectScope,"openMcpEffectScope");function F(e,t,s){return new Promise((i,f)=>{let l=!1;const n=r(()=>{l||(l=!0,f(t.reason??new Error("MCP scoped acquisition aborted")))},"abort");t.aborted?n():t.addEventListener("abort",n,{once:!0}),e.then(a=>{if(t.removeEventListener("abort",n),l){s(a).catch(()=>{});return}l=!0,i(a)},a=>{t.removeEventListener("abort",n),!l&&(l=!0,f(a))})})}r(F,"interruptibleAcquisition");function G(e,t){const s="harness.executor.runtime",i={component:"executor",operation:t,resource:"registration"};return e.pipe(c.tap(()=>c.logInfo(s).pipe(c.annotateLogs({...i,outcome:"success"}))),c.tapError(()=>c.logWarning(s).pipe(c.annotateLogs({...i,outcome:"error"}))),c.withSpan(s,{attributes:i}))}r(G,"observeExecutorRegistrationEffect");export async function openMcpLivePubSub(e){if(!Number.isSafeInteger(e.capacity)||e.capacity<=0)throw new RangeError("MCP live PubSub capacity must be a positive safe integer");I(e.maxBufferedBytes,"MCP live PubSub");const t=e.processRuntime,s=C(e.processRuntime),i=await t.runEffect(w.sliding({capacity:e.capacity,replay:0})),f=U.makeUnsafe(1),l=[];let n=0,a=!1,o;const u=r(()=>{i.pubsub.slide();const m=l.shift();n-=m?.size??0},"removeOldest"),p=r(()=>{const m=w.sizeUnsafe(i);for(;l.length>m;){const d=l.shift();n-=d?.size??0}n<0&&(n=0)},"reconcile"),g=r(()=>{l.length=0,n=0},"clearBudget");return{capacity:e.capacity,buffered:r(()=>w.sizeUnsafe(i),"buffered"),bufferedBytes:r(()=>(p(),n),"bufferedBytes"),close:r(()=>o||(a=!0,o=t.runEffect(w.shutdown(i).pipe(c.andThen(y.close(s,b.void)),c.ensuring(c.sync(g)))),o),"close"),publish:r(m=>{if(a)return Promise.resolve(!1);const d={message:m,size:L(e.sizeOf,m,"MCP live PubSub")};return d.size>e.maxBufferedBytes?Promise.resolve(!1):t.runEffect(f.withPermit(c.gen(function*(){if(a)return!1;for(p();l.length>=e.capacity||n+d.size>e.maxBufferedBytes;)u();l.push(d),n+=d.size;const v=yield*w.publish(i,d);return p(),v})))},"publish"),subscribe:r(async m=>{if(a)throw new Error("MCP live PubSub is closed");const d=await t.runEffect(y.fork(s,"sequential")),v=await t.runEffect(y.provide(w.subscribe(i),d)),z=c.gen(function*(){for(;;){const h=yield*w.take(v);yield*c.sync(p),yield*x("registry.consume",A=>m(h.message,A)).pipe(c.catchCause(()=>c.void))}});await t.runEffect(c.forkIn(z,d));let P;const M=r(()=>(P??=t.runEffect(y.close(d,b.void).pipe(c.ensuring(c.sync(p)))),P),"release");if(a)throw await M(),new Error("MCP live PubSub is closed");return{release:M}},"subscribe")}}r(openMcpLivePubSub,"openMcpLivePubSub");export async function openMcpLiveQueue(e){if(!Number.isSafeInteger(e.capacity)||e.capacity<=0)throw new RangeError("MCP live queue capacity must be a positive safe integer");I(e.maxBufferedBytes,"MCP live queue");const t=e.processRuntime,s=C(e.processRuntime),i=await t.runEffect(S.sliding(e.capacity));let f=0;const l=c.gen(function*(){for(;;){const o=yield*S.take(i);yield*c.sync(()=>{f=Math.max(0,f-o.size)}),yield*x("queue.consume",u=>e.consume(o.message,u)).pipe(c.catchCause(()=>c.void))}});await t.runEffect(c.forkIn(l,s));let n=!1,a;return{capacity:e.capacity,buffered:r(()=>S.sizeUnsafe(i),"buffered"),bufferedBytes:r(()=>f,"bufferedBytes"),close:r(()=>a||(n=!0,a=t.runEffect(S.shutdown(i).pipe(c.andThen(y.close(s,b.void)),c.ensuring(c.sync(()=>{f=0})))),a),"close"),offer:r(o=>{if(n)return!1;const u={message:o,size:L(e.sizeOf,o,"MCP live queue")};if(u.size>e.maxBufferedBytes)return!1;for(;i.messages.length>=e.capacity||f+u.size>e.maxBufferedBytes;){const g=R.take(i.messages);if(g===R.Empty)break;f=Math.max(0,f-g.size)}const p=S.offerUnsafe(i,u);return p&&(f+=u.size),p},"offer")}}r(openMcpLiveQueue,"openMcpLiveQueue");function I(e,t){if(!Number.isSafeInteger(e)||e<=0)throw new RangeError(`${t} maxBufferedBytes must be a positive safe integer`)}r(I,"assertByteBudget");function L(e,t,s){const i=e(t);if(!Number.isSafeInteger(i)||i<0)throw new RangeError(`${s} message size must be a non-negative safe integer`);return i}r(L,"sizeMessage");

package/lib/harness/create-harness.js

@@ -1 +1 @@
-var a=Object.defineProperty;var t=(e,r)=>a(e,"name",{value:r,configurable:!0});import{isAbsolute as f}from"node:path";const n=Symbol.for("codebuddy.ai/agent-harness/application-owner");export async function createHarness(e={}){if(e.signal?.throwIfAborted(),e.configDir!==void 0&&!f(e.configDir))throw new TypeError("Harness configDir must be an absolute path");const r=globalThis;if(r[n]!==void 0)throw new Error("This process already owns a Harness. Reuse it for additional Clients and Sessions; the Agent runtime cannot be restarted after close.");const i={};r[n]=i;const o=process.env.CODEBUDDY_CONFIG_DIR;e.configDir!==void 0&&(process.env.CODEBUDDY_CONFIG_DIR=e.configDir);try{const s={...e,host:e.host===void 0?void 0:{...e.host},productConfig:typeof e.productConfig=="object"?structuredClone(e.productConfig):e.productConfig},{startHarness:c}=await import("./runtime.js");return await c(s)}catch(s){throw r[n]===i&&delete r[n],e.configDir!==void 0&&process.env.CODEBUDDY_CONFIG_DIR===e.configDir&&(o===void 0?delete process.env.CODEBUDDY_CONFIG_DIR:process.env.CODEBUDDY_CONFIG_DIR=o),s}}t(createHarness,"createHarness");
+var l=Object.defineProperty;var r=(e,n)=>l(e,"name",{value:n,configurable:!0});import{isAbsolute as b}from"node:path";const o=Symbol.for("codebuddy.ai/agent-harness/application-owner");export async function createHarness(e={}){if(e.signal?.throwIfAborted(),e.configDir!==void 0&&!b(e.configDir))throw new TypeError("Harness configDir must be an absolute path");if(typeof e.sandboxCenter=="object"&&!e.sandboxCenter.address?.trim())throw new TypeError("sandboxCenter.address must be a non-empty IPC address");const n=globalThis;if(n[o]!==void 0)throw new Error("This process already owns a Harness. Reuse it for additional Clients and Sessions, or await its close() before creating another.");const d={};n[o]=d;const i=process.env.CODEBUDDY_CONFIG_DIR;e.configDir!==void 0&&(process.env.CODEBUDDY_CONFIG_DIR=e.configDir);const f=r(()=>{n[o]===d&&(delete n[o],e.configDir!==void 0&&process.env.CODEBUDDY_CONFIG_DIR===e.configDir&&(i===void 0?delete process.env.CODEBUDDY_CONFIG_DIR:process.env.CODEBUDDY_CONFIG_DIR=i))},"release");try{const t={...e,host:e.host===void 0?void 0:{...e.host},productConfig:typeof e.productConfig=="object"?structuredClone(e.productConfig):e.productConfig,sandboxCenter:typeof e.sandboxCenter=="object"?{...e.sandboxCenter}:e.sandboxCenter},{startHarness:u}=await import("./runtime.js"),s=await u(t),c=s.closed.then(f);c.catch(()=>{});const D=r(()=>(s.close().catch(()=>{}),c),"close");return{get ready(){return s.ready},connect:r((a,C)=>s.connect(a,C),"connect"),connectInMemory:r(a=>s.connectInMemory(a),"connectInMemory"),closed:c,close:D,[Symbol.asyncDispose]:D}}catch(t){throw f(),t}}r(createHarness,"createHarness");

package/lib/harness/runtime.js

@@ -1 +1 @@
-var S=Object.defineProperty;var i=(e,s)=>S(e,"name",{value:s,configurable:!0});import{readFileSync as C}from"node:fs";import{closeHarnessProcessRuntime as P,closeInPhases as v,closeWithLifecycleTelemetry as M,resolveShutdownCoordinator as R,runUntilClosed as L}from"../application/lifecycle.js";import{createApplicationServices as k}from"../application/services.js";import{createHarnessProcessRuntime as T}from"../effect-runtime/process-runtime.mjs";import{buildAgentHarnessClientIdentityEnv as x,resolveAgentHarnessClientIdentity as N}from"../runtime/client-identity.js";import{startupProfiler as O}from"../telemetry/startup-profile.js";export async function startHarness(e,s={}){e.signal?.throwIfAborted();const l=e.mcp?.toolsSyncTtlMs;if(l!=null&&(!Number.isSafeInteger(l)||l<=0))throw new RangeError("mcp.toolsSyncTtlMs must be a positive integer or null");const g=s.packageVersion??JSON.parse(C(new URL("../../package.json",import.meta.url),"utf8")).version,p=N(e.host??{},g),a=R(s),m=await(s.createProcessRuntime??T)(),w=Promise.withResolvers(),n=new AbortController,d=new Error("Agent Harness is shutting down"),u=i(()=>n.abort(e.signal?.reason??d),"cancel");e.signal?.addEventListener("abort",u,{once:!0}),e.signal?.aborted&&u();const I=Promise.resolve().then(()=>m.run(async t=>{n.signal.throwIfAborted();const{server:r,modules:o,telemetry:E,containment:A,runtimeShutdown:H,recordLifecycle:h}=await k({signal:AbortSignal.any([n.signal,t]),clientIdentity:p,clientIdentityEnv:x(p),dependencies:s,packageVersion:g,processRuntime:m,productConfig:e.productConfig,tools:e.tools,strictMcpConfig:e.strictMcpConfig??!1,mcp:e.mcp,shutdown:a,telemetryOptions:e.telemetry??{}});if(!("connectInMemory"in r)||typeof r.connectInMemory!="function")throw await v([[()=>r.close(),()=>o.close()]],a),new TypeError("Application Server does not implement the in-memory endpoint");O()?.markEvent("harness-services-ready"),h({component:"server",phase:"startup",process:{pid:process.pid},reason:"startup_completed",state:"started"}),w.resolve(r),await L(new Promise(()=>{}),b=>M(E,()=>v([[()=>r.close(b),()=>o.close(b)]],a,"in-memory shutdown")),void 0,n.signal,[A.signal,H.signal,t],{timeouts:a}),h({component:"server",phase:"shutdown",process:{pid:process.pid},reason:"shutdown_completed",state:"stopped"})})),c=(async()=>{let t,r=!1;try{await I}catch(o){t=o,r=!0}n.abort(d),a.start();try{await P(m,a)}catch(o){throw r?new AggregateError([t,o],"Harness execution and cleanup failed"):o}finally{e.signal?.removeEventListener("abort",u)}if(r)throw t})();c.catch(()=>{});const f=await Promise.race([w.promise,c.then(()=>{throw new Error("Harness closed before startup completed")})]);e.signal?.aborted&&(await c,e.signal.throwIfAborted());const y=i(()=>(n.abort(d),c),"close");return{get ready(){return!n.signal.aborted&&f.ready},closed:c,connect:i((t,r)=>{if(n.signal.aborted)throw new Error("Harness is closing");return f.connect(t,r)},"connect"),connectInMemory:i(t=>{if(n.signal.aborted)throw new Error("Harness is closing");return f.connectInMemory(t)},"connectInMemory"),close:y,[Symbol.asyncDispose]:y}}i(startHarness,"startHarness");
+var H=Object.defineProperty;var i=(e,s)=>H(e,"name",{value:s,configurable:!0});import{readFileSync as S}from"node:fs";import{closeHarnessProcessRuntime as P,closeInPhases as v,closeWithLifecycleTelemetry as M,resolveShutdownCoordinator as R,runUntilClosed as L}from"../application/lifecycle.js";import{createApplicationServices as k}from"../application/services.js";import{createHarnessProcessRuntime as x}from"../effect-runtime/process-runtime.mjs";import{buildAgentHarnessClientIdentityEnv as T,resolveAgentHarnessClientIdentity as N}from"../runtime/client-identity.js";import{startupProfiler as O}from"../telemetry/startup-profile.js";export async function startHarness(e,s={}){e.signal?.throwIfAborted();const l=e.mcp?.toolsSyncTtlMs;if(l!=null&&(!Number.isSafeInteger(l)||l<=0))throw new RangeError("mcp.toolsSyncTtlMs must be a positive integer or null");const g=s.packageVersion??JSON.parse(S(new URL("../../package.json",import.meta.url),"utf8")).version,p=N(e.host??{},g),a=R(s),m=await(s.createProcessRuntime??x)(),w=Promise.withResolvers(),n=new AbortController,d=new Error("Agent Harness is shutting down"),u=i(()=>n.abort(e.signal?.reason??d),"cancel");e.signal?.addEventListener("abort",u,{once:!0}),e.signal?.aborted&&u();const I=Promise.resolve().then(()=>m.run(async t=>{n.signal.throwIfAborted();const{server:r,modules:o,telemetry:E,containment:A,runtimeShutdown:C,recordLifecycle:h}=await k({signal:AbortSignal.any([n.signal,t]),clientIdentity:p,clientIdentityEnv:T(p),dependencies:s,packageVersion:g,processRuntime:m,productConfig:e.productConfig,sandboxCenter:e.sandboxCenter,tools:e.tools,strictMcpConfig:e.strictMcpConfig??!1,mcp:e.mcp,shutdown:a,telemetryOptions:e.telemetry??{}});if(!("connectInMemory"in r)||typeof r.connectInMemory!="function")throw await v([[()=>r.close(),()=>o.close()]],a),new TypeError("Application Server does not implement the in-memory endpoint");O()?.markEvent("harness-services-ready"),h({component:"server",phase:"startup",process:{pid:process.pid},reason:"startup_completed",state:"started"}),w.resolve(r),await L(new Promise(()=>{}),b=>M(E,()=>v([[()=>r.close(b),()=>o.close(b)]],a,"in-memory shutdown")),void 0,n.signal,[A.signal,C.signal,t],{timeouts:a}),h({component:"server",phase:"shutdown",process:{pid:process.pid},reason:"shutdown_completed",state:"stopped"})})),c=(async()=>{let t,r=!1;try{await I}catch(o){t=o,r=!0}n.abort(d),a.start();try{await P(m,a)}catch(o){throw r?new AggregateError([t,o],"Harness execution and cleanup failed"):o}finally{e.signal?.removeEventListener("abort",u)}if(r)throw t})();c.catch(()=>{});const f=await Promise.race([w.promise,c.then(()=>{throw new Error("Harness closed before startup completed")})]);e.signal?.aborted&&(await c,e.signal.throwIfAborted());const y=i(()=>(n.abort(d),c),"close");return{get ready(){return!n.signal.aborted&&f.ready},closed:c,connect:i((t,r)=>{if(n.signal.aborted)throw new Error("Harness is closing");return f.connect(t,r)},"connect"),connectInMemory:i(t=>{if(n.signal.aborted)throw new Error("Harness is closing");return f.connectInMemory(t)},"connectInMemory"),close:y,[Symbol.asyncDispose]:y}}i(startHarness,"startHarness");

package/lib/harness/types.d.ts

@@ -1,6 +1,7 @@
 import type { QueryOptions, SdkMcpToolDefinition } from '#agent-harness-codebuddy/server';
 import type { AgentHarnessClientIdentity } from '../runtime/client-identity.js';
 import type { AgentHarnessProductInput } from '../runtime/product-config.js';
+import type { SandboxCenterOption } from '../runtime/sandbox-center.js';
 import type { TelemetryOptions } from '../telemetry/public.js';
 import type { InMemoryEndpoint } from '../transport/effect.js';
 import type { AgentHarnessConnectionAcceptor } from '../transport/types.js';
@@ -14,6 +15,8 @@ export interface HarnessOptions {
     readonly productConfig?: ProductConfig | string;
     /** Application-wide directory; defaults to CODEBUDDY_CONFIG_DIR or ~/.codebuddy. */
     readonly configDir?: string;
+    /** Managed by Harness by default; pass an IPC address to borrow a Host-owned center. */
+    readonly sandboxCenter?: SandboxCenterOption;
     readonly tools?: HarnessTools;
     readonly strictMcpConfig?: boolean;
     readonly mcp?: {

package/lib/integration/agent-integration.d.ts

@@ -49,6 +49,11 @@ export interface AgentMcpAttachment {
     message(params: AcpV2MessageMcpRequest, options: AgentMcpMessageOptions): Promise<unknown>;
     notify(params: AcpV2MessageMcpNotification, options: AgentMcpNotificationOptions): void;
     callTool(logicalName: string, toolName: string, args: unknown, signal?: AbortSignal): Promise<ExecutorMcpCallResult>;
+    /**
+     * Irreversibly disable this attachment's access, then release resources.
+     * A cleanup rejection must not restore access. This releases session
+     * capabilities; it does not revoke the user's upstream OAuth/API token.
+     */
     revoke(): Promise<void>;
     subscribeServerStatus(listener: (status: SessionMcpServerStatus) => void): () => void;
 }