stable-harness 0.0.124 → 0.0.125

package/node_modules/@stable-harness/core/dist/runtime.js

@@ -1 +1 @@
-import{randomUUID as e}from"node:crypto";import{assertExecutionContract as t}from"./execution-contract.js";import{buildExecutionContractRecoveryRequest as r}from"./recovery/execution-contract.js";import{buildAdapterErrorRecoveryPrompt as a,isRecoverableAdapterError as o}from"./recovery/tool-call.js";import{recoverQualityReview as s,resolveQualityPolicy as n}from"./quality/index.js";import{recoverAdapterResultOutput as i}from"./runtime/recovery/adapter-result.js";import{completeRun as u,failRun as c}from"./runtime/completion.js";import{createRuntimeAdministrationMethods as p}from"./runtime/admin/administration.js";import{runDirectToolCall as d}from"./runtime/direct-tool-call.js";import{createApprovalGatedToolGateway as l}from"./runtime/governance/approval-gate.js";import{createSandboxedToolGateway as m}from"./runtime/governance/sandbox.js";import{createRuntimeInspectionMethods as w}from"./runtime/inspection/methods.js";import{createRuntimeCapabilityRegistry as g,normalizeAdapterResult as y}from"./runtime/capabilities.js";import{createMemoryRuntimeCapability as I}from"./runtime/memory.js";import{resolveToolCallRecoveryPolicy as f}from"./runtime/recovery/tool-call-policy.js";import{createRuntimeMemoryAdministration as q}from"./runtime/admin/memory.js";import{createInMemoryRuntimeStore as R}from"./runtime/persistence/stores.js";import{createProgressNarrationCapability as v}from"./runtime/progress-narration.js";import{repairRuntimeSelection as k}from"./runtime/selection-repair.js";import{createLangSmithTracingCapability as b}from"./runtime/tracing/langsmith.js";import{createToolFailureTracker as A}from"./runtime/tool-failure.js";import{runWorkflowRequest as C}from"./workflows/runtime.js";export function createStableHarnessRuntime(t){const y=new Set,x=t.store??R(),j=g([I(t),v({options:t.progressNarration,policy:t.workspace.runtime}),b({policy:t.workspace.runtime,store:x,options:t.langSmithTracing}),...t.capabilities??[]]),emitBase=t=>{const r=function enrichRuntimeEvent(t){return{...t,eventId:t.eventId??e(),emittedAt:t.emittedAt??(new Date).toISOString()}}(t);x.appendEvent(r);for(const e of y)e(r)},emit=e=>{emitBase(e),j.emitSideEffects(e,emitBase)},E=m({gateway:l({gateway:t.toolGateway,approvals:t.approvals,workspace:t.workspace,emit:emit}),workspace:t.workspace,sandbox:t.sandbox,emit:emit}),G={...t,toolGateway:E},T=A(function readToolFailurePolicy(e){if("object"!=typeof e||null===e||Array.isArray(e))return;const t=e.failurePolicy;return"object"!=typeof t||null===t||Array.isArray(t)?void 0:t}(t.workspace.runtime.toolGateway));return{request:async t=>async function runRuntimeRequest(t){const p=t.request.requestId??e(),l=t.request.sessionId??e(),m=[],{agent:w,adapter:g}=await async function resolveExecution(e,t,r){const a=t.agentId?await async function resolveRequestedAgentId(e,t,r){if(e.agents.has(t))return t;const a=await k({id:t,candidates:[...e.agents.values()].map(e=>({id:e.id,description:e.description})),trace:{...r,agentId:t,layer:"agent",owner:"stable_runtime_policy"}});return a.ok?a.id:t}(e.workspace,t.agentId,r):e.workspace.runtime.defaultAgentId,o=e.workspace.agents.get(a);if(!o)throw new Error(`Agent ${a} is not defined in the workspace`);if(t.toolCall||t.workflow)return{agent:o,adapter:void 0};const s=e.adapters.find(e=>e.canRun(o));if(!s)throw new Error(`No runtime adapter can run backend ${o.backend} for agent ${o.id}`);return{agent:o,adapter:s}}(t.input,t.request,{requestId:p,sessionId:l,emit:e=>m.push(e)});t.store.createRun(function createRunRecord(e,t,r,a){return{requestId:t,sessionId:r,agentId:a.id,input:e.input,state:"running",parentRunId:e.parentRunId,metadata:e.metadata,artifacts:[],startedAt:(new Date).toISOString(),events:[]}}(t.request,p,l,w)),m.forEach(t.emit),t.emit({type:"runtime.request.started",requestId:p,sessionId:l,agentId:w.id,input:t.request.input});try{if(t.request.workflow){const e=await C({workspace:t.input.workspace,adapters:t.input.workflowAdapters??[],toolGateway:t.input.toolGateway,request:{input:t.request.input,...t.request.workflow},requestId:p,sessionId:l,agentId:w.id,emit:t.emit});return u({store:t.store,emit:t.emit,requestId:p,sessionId:l,agent:w,result:e,artifacts:t.input.artifacts})}if(t.request.toolCall){const e=await d({gateway:t.input.toolGateway,workspace:t.input.workspace,emit:t.emit,request:t.request,requestId:p,sessionId:l,agent:w,toolFailureTracker:t.toolFailureTracker,toolGuardrails:t.input.toolGuardrails,events:t.store.getRun(p)?.events??[]});return u({store:t.store,emit:t.emit,requestId:p,sessionId:l,agent:w,result:e,artifacts:t.input.artifacts})}return await async function runAdapterRequest(e){if(!e.adapter)throw new Error(`No runtime adapter can run backend ${e.agent.backend} for agent ${e.agent.id}`);const t=e.adapter,c=await e.capabilities.beforeAdapterRun(createCapabilityContext(e)),p=c.memory,d=c.pluginMemories??[],l=f({workspace:e.input.workspace,agent:e.agent}),m=n(e.input.workspace.runtime,e.agent),w=new Map;let g;try{g=await runAdapterOnce(e,t,e.request,p,d,w,l)}catch(r){if(!o(r,l))throw r;e.emit(repairStarted(e,"adapter_error",1,errorMessage(r))),g=await runAdapterOnce(e,t,a(e.request,r,l),p,d,w,l),e.emit(repairCompleted(e,"adapter_error","retried",1,errorMessage(r)))}g=await i({...e,request:e.request,result:g,recoveryPolicy:l,workspace:e.input.workspace,toolGateway:e.input.toolGateway,runAdapter:r=>runAdapterOnce(e,t,r,p,d,w,l),runRecoveredToolCall:(t,r)=>runRecoveredToolCall(e,t,r)}),g=await s(createQualityRuntimeInput(e,p,d,w,l),e.request,g,m),await e.capabilities.beforeAdapterResultContract({...createCapabilityContext(e),result:g});try{assertRequestExecutionContract(e,g)}catch(a){const o=r({request:e.request,events:e.store.getRun(e.requestId)?.events??[],policy:l});if(!o)throw a;e.emit(repairStarted(e,"execution_contract",1,errorMessage(a))),g=await runAdapterOnce(e,t,o,p,d,w,l),g=await i({...e,request:o,result:g,recoveryPolicy:l,workspace:e.input.workspace,toolGateway:e.input.toolGateway,runAdapter:r=>runAdapterOnce(e,t,r,p,d,w,l),runRecoveredToolCall:(t,r)=>runRecoveredToolCall(e,t,r)}),g=await s(createQualityRuntimeInput(e,p,d,w,l),o,g,m),assertRequestExecutionContract(e,g),e.emit(repairCompleted(e,"execution_contract","retried",1,errorMessage(a)))}const y=u({store:e.store,emit:e.emit,requestId:e.requestId,sessionId:e.sessionId,agent:e.agent,result:g,artifacts:e.input.artifacts});return await e.capabilities.afterAdapterResponse({...createCapabilityContext(e),result:g,response:y}),y}({...t,adapter:g,requestId:p,sessionId:l,agent:w})}catch(e){return c({store:t.store,emit:t.emit,requestId:p,sessionId:l,agent:w,error:e})}}({input:G,capabilities:j,store:x,emit:emit,request:t,toolFailureTracker:T}),subscribe:e=>(y.add(e),()=>y.delete(e)),...w({workspace:t.workspace,store:x,artifacts:t.artifacts,approvals:t.approvals,emit:emit}),...p({store:x,emit:emit}),...q({memory:t.memory}),cancel(e,t){const r=x.getRun(e);r&&"running"===r.state&&(x.updateRun(e,{state:"cancelled",completedAt:(new Date).toISOString()}),emit({type:"runtime.request.cancelled",requestId:e,sessionId:r.sessionId,agentId:r.agentId,reason:t}))},async stop(){await j.stop(),y.clear()}}}function runRecoveredToolCall(e,t,r){return d({gateway:e.input.toolGateway,workspace:e.input.workspace,emit:e.emit,request:{...e.request,toolCall:{toolId:t,args:r}},requestId:e.requestId,sessionId:e.sessionId,agent:e.agent,toolFailureTracker:e.input.toolFailureTracker,toolGuardrails:e.input.toolGuardrails,events:e.store.getRun(e.requestId)?.events??[]})}function createCapabilityContext(e){return{workspace:e.input.workspace,store:e.store,emit:e.emit,request:e.request,requestId:e.requestId,sessionId:e.sessionId,agent:e.agent}}function createQualityRuntimeInput(e,t,r,a,o){return{workspace:e.input.workspace,agent:e.agent,request:e.request,requestId:e.requestId,sessionId:e.sessionId,events:e.store.getRun(e.requestId)?.events??[],emit:e.emit,getEvents:()=>e.store.getRun(e.requestId)?.events??[],runAdapter:s=>runAdapterOnce(e,e.adapter,s,t,r,a,o),reviewModel:e.input.qualityReviewModel,executionEvaluatorRules:e.input.executionEvaluatorRules,memory:t,pluginMemories:r}}function assertRequestExecutionContract(e,r){t({store:e.store,emit:e.emit,requestId:e.requestId,sessionId:e.sessionId,agent:e.agent,output:r.text,metadata:e.request.metadata})}async function runAdapterOnce(e,t,r,a,o,s,n){return y(await t.run({workspace:{...e.input.workspace,runtime:n},agent:e.agent,request:r,requestId:e.requestId,sessionId:e.sessionId,memory:a,pluginMemories:o,toolGateway:e.input.toolGateway,toolFailureTracker:e.input.toolFailureTracker,toolGuardrails:e.input.toolGuardrails,executionEvaluatorRules:e.input.executionEvaluatorRules,requestState:s,getEvents:()=>e.store.getRun(e.requestId)?.events??[],emit:e.emit}))}function repairStarted(e,t,r,a){return{type:"runtime.repair.started",requestId:e.requestId,sessionId:e.sessionId,agentId:e.agent.id,layer:t,attempt:r,reason:a}}function repairCompleted(e,t,r,a,o){return{type:"runtime.repair.completed",requestId:e.requestId,sessionId:e.sessionId,agentId:e.agent.id,layer:t,outcome:r,attempt:a,reason:o}}function errorMessage(e){return e instanceof Error?e.message:String(e)}
+import{randomUUID as e}from"node:crypto";import{assertExecutionContract as t}from"./execution-contract.js";import{buildExecutionContractRecoveryRequest as r}from"./recovery/execution-contract.js";import{buildAdapterErrorRecoveryPrompt as a,isRecoverableAdapterError as o}from"./recovery/tool-call.js";import{recoverQualityReview as s,resolveQualityPolicy as n}from"./quality/index.js";import{recoverAdapterResultOutput as i}from"./runtime/recovery/adapter-result.js";import{completeRun as u,failRun as c}from"./runtime/completion.js";import{createRuntimeAdministrationMethods as p}from"./runtime/admin/administration.js";import{runDirectToolCall as m}from"./runtime/direct-tool-call.js";import{createApprovalGatedToolGateway as d}from"./runtime/governance/approval-gate.js";import{createSandboxedToolGateway as l}from"./runtime/governance/sandbox.js";import{createRuntimeImprovementAdministration as w}from"./runtime/improvement/admin.js";import{createRuntimeEvidenceAdministration as y}from"./runtime/improvement/evidence-admin.js";import{createInMemoryRuntimeImprovementStore as g}from"./runtime/improvement/store.js";import{createRuntimeInspectionMethods as I}from"./runtime/inspection/methods.js";import{createRuntimeCapabilityRegistry as f,normalizeAdapterResult as q}from"./runtime/capabilities.js";import{createMemoryRuntimeCapability as v}from"./runtime/memory.js";import{resolveToolCallRecoveryPolicy as R}from"./runtime/recovery/tool-call-policy.js";import{createRuntimeMemoryAdministration as k}from"./runtime/admin/memory.js";import{createInMemoryRuntimeStore as A}from"./runtime/persistence/stores.js";import{createProgressNarrationCapability as b}from"./runtime/progress-narration.js";import{repairRuntimeSelection as C}from"./runtime/selection-repair.js";import{createLangSmithTracingCapability as j}from"./runtime/tracing/langsmith.js";import{createToolFailureTracker as x}from"./runtime/tool-failure.js";import{runWorkflowRequest as E}from"./workflows/runtime.js";export function createStableHarnessRuntime(t){const q=new Set,G=t.store??A(),S=t.improvements??g(),T=f([v(t),b({options:t.progressNarration,policy:t.workspace.runtime}),j({policy:t.workspace.runtime,store:G,options:t.langSmithTracing}),...t.capabilities??[]]),emitBase=t=>{const r=function enrichRuntimeEvent(t){return{...t,eventId:t.eventId??e(),emittedAt:t.emittedAt??(new Date).toISOString()}}(t);G.appendEvent(r);for(const e of q)e(r)},emit=e=>{emitBase(e),T.emitSideEffects(e,emitBase)},h=l({gateway:d({gateway:t.toolGateway,approvals:t.approvals,workspace:t.workspace,emit:emit}),workspace:t.workspace,sandbox:t.sandbox,emit:emit}),M={...t,toolGateway:h},O=x(function readToolFailurePolicy(e){if("object"!=typeof e||null===e||Array.isArray(e))return;const t=e.failurePolicy;return"object"!=typeof t||null===t||Array.isArray(t)?void 0:t}(t.workspace.runtime.toolGateway));return{request:async t=>async function runRuntimeRequest(t){const p=t.request.requestId??e(),d=t.request.sessionId??e(),l=[],{agent:w,adapter:y}=await async function resolveExecution(e,t,r){const a=t.agentId?await async function resolveRequestedAgentId(e,t,r){if(e.agents.has(t))return t;const a=await C({id:t,candidates:[...e.agents.values()].map(e=>({id:e.id,description:e.description})),trace:{...r,agentId:t,layer:"agent",owner:"stable_runtime_policy"}});return a.ok?a.id:t}(e.workspace,t.agentId,r):e.workspace.runtime.defaultAgentId,o=e.workspace.agents.get(a);if(!o)throw new Error(`Agent ${a} is not defined in the workspace`);if(t.toolCall||t.workflow)return{agent:o,adapter:void 0};const s=e.adapters.find(e=>e.canRun(o));if(!s)throw new Error(`No runtime adapter can run backend ${o.backend} for agent ${o.id}`);return{agent:o,adapter:s}}(t.input,t.request,{requestId:p,sessionId:d,emit:e=>l.push(e)});t.store.createRun(function createRunRecord(e,t,r,a){return{requestId:t,sessionId:r,agentId:a.id,input:e.input,state:"running",parentRunId:e.parentRunId,metadata:e.metadata,artifacts:[],startedAt:(new Date).toISOString(),events:[]}}(t.request,p,d,w)),l.forEach(t.emit),t.emit({type:"runtime.request.started",requestId:p,sessionId:d,agentId:w.id,input:t.request.input});try{if(t.request.workflow){const e=await E({workspace:t.input.workspace,adapters:t.input.workflowAdapters??[],toolGateway:t.input.toolGateway,request:{input:t.request.input,...t.request.workflow},requestId:p,sessionId:d,agentId:w.id,emit:t.emit});return u({store:t.store,emit:t.emit,requestId:p,sessionId:d,agent:w,result:e,artifacts:t.input.artifacts})}if(t.request.toolCall){const e=await m({gateway:t.input.toolGateway,workspace:t.input.workspace,emit:t.emit,request:t.request,requestId:p,sessionId:d,agent:w,toolFailureTracker:t.toolFailureTracker,toolGuardrails:t.input.toolGuardrails,events:t.store.getRun(p)?.events??[]});return u({store:t.store,emit:t.emit,requestId:p,sessionId:d,agent:w,result:e,artifacts:t.input.artifacts})}return await async function runAdapterRequest(e){if(!e.adapter)throw new Error(`No runtime adapter can run backend ${e.agent.backend} for agent ${e.agent.id}`);const t=e.adapter,c=await e.capabilities.beforeAdapterRun(createCapabilityContext(e)),p=c.memory,m=c.pluginMemories??[],d=R({workspace:e.input.workspace,agent:e.agent}),l=n(e.input.workspace.runtime,e.agent),w=new Map;let y;try{y=await runAdapterOnce(e,t,e.request,p,m,w,d)}catch(r){if(!o(r,d))throw r;e.emit(repairStarted(e,"adapter_error",1,errorMessage(r))),y=await runAdapterOnce(e,t,a(e.request,r,d),p,m,w,d),e.emit(repairCompleted(e,"adapter_error","retried",1,errorMessage(r)))}y=await i({...e,request:e.request,result:y,recoveryPolicy:d,workspace:e.input.workspace,toolGateway:e.input.toolGateway,runAdapter:r=>runAdapterOnce(e,t,r,p,m,w,d),runRecoveredToolCall:(t,r)=>runRecoveredToolCall(e,t,r)}),y=await s(createQualityRuntimeInput(e,p,m,w,d),e.request,y,l),await e.capabilities.beforeAdapterResultContract({...createCapabilityContext(e),result:y});try{assertRequestExecutionContract(e,y)}catch(a){const o=r({request:e.request,events:e.store.getRun(e.requestId)?.events??[],policy:d});if(!o)throw a;e.emit(repairStarted(e,"execution_contract",1,errorMessage(a))),y=await runAdapterOnce(e,t,o,p,m,w,d),y=await i({...e,request:o,result:y,recoveryPolicy:d,workspace:e.input.workspace,toolGateway:e.input.toolGateway,runAdapter:r=>runAdapterOnce(e,t,r,p,m,w,d),runRecoveredToolCall:(t,r)=>runRecoveredToolCall(e,t,r)}),y=await s(createQualityRuntimeInput(e,p,m,w,d),o,y,l),assertRequestExecutionContract(e,y),e.emit(repairCompleted(e,"execution_contract","retried",1,errorMessage(a)))}const g=u({store:e.store,emit:e.emit,requestId:e.requestId,sessionId:e.sessionId,agent:e.agent,result:y,artifacts:e.input.artifacts});return await e.capabilities.afterAdapterResponse({...createCapabilityContext(e),result:y,response:g}),g}({...t,adapter:y,requestId:p,sessionId:d,agent:w})}catch(e){return c({store:t.store,emit:t.emit,requestId:p,sessionId:d,agent:w,error:e})}}({input:M,capabilities:T,store:G,emit:emit,request:t,toolFailureTracker:O}),subscribe:e=>(q.add(e),()=>q.delete(e)),...I({workspace:t.workspace,store:G,artifacts:t.artifacts,approvals:t.approvals,emit:emit}),...p({store:G,emit:emit}),...w({runtimeStore:G,store:S,emit:emit}),...y({runtimeStore:G,emit:emit}),...k({memory:t.memory}),cancel(e,t){const r=G.getRun(e);r&&"running"===r.state&&(G.updateRun(e,{state:"cancelled",completedAt:(new Date).toISOString()}),emit({type:"runtime.request.cancelled",requestId:e,sessionId:r.sessionId,agentId:r.agentId,reason:t}))},async stop(){await T.stop(),q.clear()}}}function runRecoveredToolCall(e,t,r){return m({gateway:e.input.toolGateway,workspace:e.input.workspace,emit:e.emit,request:{...e.request,toolCall:{toolId:t,args:r}},requestId:e.requestId,sessionId:e.sessionId,agent:e.agent,toolFailureTracker:e.input.toolFailureTracker,toolGuardrails:e.input.toolGuardrails,events:e.store.getRun(e.requestId)?.events??[]})}function createCapabilityContext(e){return{workspace:e.input.workspace,store:e.store,emit:e.emit,request:e.request,requestId:e.requestId,sessionId:e.sessionId,agent:e.agent}}function createQualityRuntimeInput(e,t,r,a,o){return{workspace:e.input.workspace,agent:e.agent,request:e.request,requestId:e.requestId,sessionId:e.sessionId,events:e.store.getRun(e.requestId)?.events??[],emit:e.emit,getEvents:()=>e.store.getRun(e.requestId)?.events??[],runAdapter:s=>runAdapterOnce(e,e.adapter,s,t,r,a,o),reviewModel:e.input.qualityReviewModel,executionEvaluatorRules:e.input.executionEvaluatorRules,memory:t,pluginMemories:r}}function assertRequestExecutionContract(e,r){t({store:e.store,emit:e.emit,requestId:e.requestId,sessionId:e.sessionId,agent:e.agent,output:r.text,metadata:e.request.metadata})}async function runAdapterOnce(e,t,r,a,o,s,n){return q(await t.run({workspace:{...e.input.workspace,runtime:n},agent:e.agent,request:r,requestId:e.requestId,sessionId:e.sessionId,memory:a,pluginMemories:o,toolGateway:e.input.toolGateway,toolFailureTracker:e.input.toolFailureTracker,toolGuardrails:e.input.toolGuardrails,executionEvaluatorRules:e.input.executionEvaluatorRules,requestState:s,getEvents:()=>e.store.getRun(e.requestId)?.events??[],emit:e.emit}))}function repairStarted(e,t,r,a){return{type:"runtime.repair.started",requestId:e.requestId,sessionId:e.sessionId,agentId:e.agent.id,layer:t,attempt:r,reason:a}}function repairCompleted(e,t,r,a,o){return{type:"runtime.repair.completed",requestId:e.requestId,sessionId:e.sessionId,agentId:e.agent.id,layer:t,outcome:r,attempt:a,reason:o}}function errorMessage(e){return e instanceof Error?e.message:String(e)}

package/node_modules/@stable-harness/core/dist/trace.d.ts

@@ -4,7 +4,7 @@ export type PlanTodoItem = {
     status: string;
 };
 export type RuntimeTraceEntry = {
-    type: "request" | "tool" | "workflow" | "spec" | "adapter" | "memory" | "artifact" | "progress" | "plan" | "delegation";
+    type: "request" | "tool" | "workflow" | "spec" | "adapter" | "memory" | "artifact" | "progress" | "plan" | "delegation" | "quality";
     label: string;
     agentId: string;
     requestId: string;

package/node_modules/@stable-harness/core/dist/trace.js

@@ -1 +1 @@
-export function createDelegationTraceProjection(t,e={}){return{traceType:"delegation",traceLabel:t,...e}}export function createPlanTraceProjection(t,e={}){return{traceType:"plan",traceLabel:t,...e}}export function projectRuntimeTrace(t){return t.events.map(projectEvent).filter(isTraceEntry)}export function projectRuntimeTraceSpans(t){const e=function createSpanBuilder(t){const e=`run:${t.requestId}`,r=[],o=new Map;return{ensureRoot(){if(o.has(e))return;const n={spanId:e,requestId:t.requestId,sessionId:t.sessionId,agentId:t.agentId,kind:"run",name:t.agentId,status:(a=t.state,"completed"===a?"completed":"failed"===a?"failed":"cancelled"===a?"blocked":"running"),startedAt:t.startedAt,completedAt:t.completedAt,startEventIndex:0,...t.parentRunId?{parentSpanId:`run:${t.parentRunId}`}:{},events:[]};var a;r.push(n),o.set(e,n)},markRoot(t,r,n,a){const i=o.get(e);i&&(addEvent(i,t,r),i.status=n,i.attributes=merge(i.attributes,a),"running"!==n&&close(i,t,r))},start(t,n,a,i,s,d){const p=createSpan(`${e}/${t}:${s}`,e,n,a,i,s,d);r.push(p),o.set(t,p)},complete(t,n,a,i){const s=o.get(t)??createSpan(`${e}/${t}:${a}`,e,"adapter",t,n,a);return o.has(t)||r.push(s),addEvent(s,n,a),s.attributes=merge(s.attributes,i),close(s,n,a),o.delete(t),s},fail(t,e,r,o){this.complete(t,e,r,o).status="failed"},event(t,o,n,a,i){const s=createSpan(`${e}/event:${a}`,e,t,o,n,a,i);s.status=function readBlockedStatus(t){return t.type.endsWith(".blocked")||t.type.includes(".approval.")?"blocked":void 0}(n)??"event",close(s,n,a),r.push(s)},closeRoot(){const r=o.get(e);r&&t.completedAt&&(r.completedAt=t.completedAt)},spans:()=>r}}(t);return e.ensureRoot(),t.events.forEach((t,r)=>function projectSpanEvent(t,e,r){return e.type.startsWith("runtime.request.")?function projectRequestSpanEvent(t,e,r){return"runtime.request.started"===e.type?t.markRoot(e,r,"running",{input:e.input}):"runtime.request.completed"===e.type?t.markRoot(e,r,"completed",{output:e.output}):"runtime.request.failed"===e.type?t.markRoot(e,r,"failed",{error:e.error}):"runtime.request.cancelled"===e.type?t.markRoot(e,r,"blocked",{reason:e.reason}):"runtime.execution.contract.failed"===e.type?projectSingleSpan(t,e,r,"quality",e.type,{reason:e.reason,missingEvidenceTools:e.missingEvidenceTools}):void 0}(t,e,r):"runtime.tool.direct.started"===e.type?t.start(`tool:${e.toolId}`,"tool",e.toolId,e,r,{toolId:e.toolId}):"runtime.tool.direct.completed"===e.type?t.complete(`tool:${e.toolId}`,e,r,{toolId:e.toolId,output:e.output}):"runtime.workflow.started"===e.type?t.start(`workflow:${e.workflowId}`,"workflow",e.workflowId,e,r,{workflowId:e.workflowId,adapter:e.adapter}):"runtime.workflow.completed"===e.type?t.complete(`workflow:${e.workflowId}`,e,r,{workflowId:e.workflowId,adapter:e.adapter}):e.type.startsWith("runtime.approval.")||e.type.startsWith("runtime.memory.approval.")?projectSingleSpan(t,e,r,"approval",e.type):e.type.startsWith("runtime.specDriven.phase.")?projectSingleSpan(t,e,r,"spec",function readPhaseName(t,e){return"phaseId"in t&&"string"==typeof t.phaseId?t.phaseId:e}(e,"phase")):e.type.startsWith("runtime.memory.")?projectSingleSpan(t,e,r,"memory",e.type):e.type.startsWith("runtime.quality.")?projectSingleSpan(t,e,r,"quality",e.type):e.type.startsWith("runtime.repair.")?projectSingleSpan(t,e,r,"adapter",e.type):"runtime.artifact.created"===e.type?projectSingleSpan(t,e,r,"artifact",e.artifact.id,{artifact:e.artifact}):"runtime.progress.narration"===e.type?projectSingleSpan(t,e,r,"progress",e.message,{provider:e.provider}):"runtime.adapter.event"===e.type?function projectAdapterSpanEvent(t,e,r){const o=isRecord(e.event)?e.event:void 0,n=readString(o?.phase)??"runtime.adapter.event",a=readTraceType(o?.traceType),i=readString(o?.traceLabel);return"delegation"===a&&i?.endsWith(".start")?t.start(delegationKey(o),"delegation",readString(o?.subagentType)??i,e,r,o):"delegation"===a&&i?.endsWith(".completed")?t.complete(delegationKey(o),e,r,o):"plan"===a&&i?projectSingleSpan(t,e,r,"plan",i,o):function isToolStartEvent(t){return"deepagents.tool_execution.start"===t?.eventType||"agent.tool.start"===t?.phase}(o)?t.start(`agent-tool:${readString(o?.toolId)??"unknown"}`,"tool",readString(o?.toolId)??n,e,r,o):function isToolResultEvent(t){return"deepagents.tool_execution.result"===t?.eventType||"agent.tool.result"===t?.phase}(o)?t.complete(`agent-tool:${readString(o?.toolId)??"unknown"}`,e,r,o):projectSingleSpan(t,e,r,"adapter",n,o)}(t,e,r):"runtime.inventory.repair"===e.type?projectSingleSpan(t,e,r,"adapter","runtime.inventory.repair",{status:e.status,...e.diagnostic}):"runtime.sandbox.decision"===e.type?projectSingleSpan(t,e,r,"tool",`sandbox:${e.toolId}`,{toolId:e.toolId,...e.decision}):"runtime.tool.failure"===e.type?t.fail(`tool:${e.toolId}`,e,r,{toolId:e.toolId,...e.failure}):"runtime.tool.circuit.opened"===e.type?projectSingleSpan(t,e,r,"tool",`circuit:${e.toolId}`,{toolId:e.toolId,reason:e.reason}):void 0}(e,t,r)),e.closeRoot(),e.spans()}export function projectEvent(t){return"runtime.request.started"===t.type||"runtime.request.completed"===t.type||"runtime.request.failed"===t.type?base(t,"request",t.type):"runtime.request.cancelled"===t.type?base(t,"request",t.type,{reason:t.reason}):"runtime.execution.contract.failed"===t.type?base(t,"request",t.type,{reason:t.reason,missingEvidenceTools:t.missingEvidenceTools}):"runtime.inventory.repair"===t.type?base(t,"adapter","runtime.inventory.repair",{status:t.status,...t.diagnostic}):"runtime.repair.started"===t.type||"runtime.repair.completed"===t.type?base(t,"adapter",t.type,{layer:t.layer,..."outcome"in t?{outcome:t.outcome}:{},..."attempt"in t?{attempt:t.attempt}:{},..."reason"in t?{reason:t.reason}:{},...t.diagnostics?{diagnostics:t.diagnostics}:{}}):"runtime.tool.direct.started"===t.type?base(t,"tool","runtime.tool.direct.started",{toolId:t.toolId}):"runtime.tool.direct.completed"===t.type?base(t,"tool","runtime.tool.direct.completed",{toolId:t.toolId,...outputTraceDetail(t.output)}):"runtime.sandbox.decision"===t.type?base(t,"tool","runtime.sandbox.decision",{toolId:t.toolId,...t.decision}):"runtime.tool.failure"===t.type?base(t,"tool","runtime.tool.failure",{toolId:t.toolId,...t.failure}):"runtime.tool.circuit.opened"===t.type?base(t,"tool","runtime.tool.circuit.opened",{toolId:t.toolId,reason:t.reason}):"runtime.workflow.started"===t.type||"runtime.workflow.completed"===t.type?base(t,"workflow",t.type,{workflowId:t.workflowId,adapter:t.adapter}):function isSpecDrivenPhaseEvent(t){return t.type.startsWith("runtime.specDriven.phase.")}(t)?base(t,"spec",t.type,{phaseId:t.phaseId,..."workflowId"in t&&t.workflowId?{workflowId:t.workflowId}:{},..."reason"in t?{reason:t.reason}:{},..."artifact"in t&&t.artifact?{artifact:t.artifact}:{}}):"runtime.adapter.event"===t.type?function adapterTrace(t){const e=t.event;if(isRecord(e)&&"string"==typeof e.phase){const r=function semanticAdapterTrace(t,e){if("inventory.repair"===e.phase)return base(t,"adapter","runtime.inventory.repair",{status:e.status,...isRecord(e.diagnostic)?e.diagnostic:{}});const r=readTraceType(e.traceType),o=readString(e.traceLabel);return r&&o?base(t,r,o,e):void 0}(t,e);return r||base(t,"adapter",e.phase.startsWith("agent.")?e.phase:`adapter.${e.phase}`,e)}return base(t,"adapter","runtime.adapter.event",{event:e})}(t):"runtime.artifact.created"===t.type?base(t,"artifact","runtime.artifact.created",{artifact:t.artifact}):t.type.startsWith("runtime.memory.")?base(t,"memory",t.type):"runtime.progress.narration"===t.type?base(t,"progress",t.type,{message:t.message,provider:t.provider,sourceEventTypes:t.sourceEventTypes}):void 0}export function readPlanTodos(t){const e=function readPlanRecord(t){if(isRecord(t))return t;if("string"==typeof t)try{const e=JSON.parse(t);return isRecord(e)?e:void 0}catch{return}}(t),r=function readTodosArray(t){const e=isRecord(t?.args)?t.args:void 0;return Array.isArray(t?.todos)?t.todos:Array.isArray(e?.todos)?e.todos:[]}(e);return r.map(readTodo).filter(isPlanTodoItem)}function readTodo(t){if(isRecord(t)&&"string"==typeof t.content)return{content:t.content,status:"string"==typeof t.status?t.status:"pending"}}function isPlanTodoItem(t){return void 0!==t}function base(t,e,r,o){return{type:e,label:r,agentId:t.agentId,requestId:t.requestId,detail:o}}function isTraceEntry(t){return void 0!==t}function outputTraceDetail(t){const e="string"==typeof t?t:function serializeOutput(t){try{return void 0===t?"":JSON.stringify(t)}catch{return String(t)}}(t),r=e.slice(0,1200);return{outputType:Array.isArray(t)?"array":null===t?"null":typeof t,outputLength:e.length,outputPreview:r,...e.length>r.length?{outputTail:e.slice(-1200)}:{}}}function projectSingleSpan(t,e,r,o,n,a){return t.event(o,n,e,r,a)}function delegationKey(t){return`delegation:${readString(t?.subagentType)??readString(t?.toolId)??"task"}`}function createSpan(t,e,r,o,n,a,i){const s={spanId:t,parentSpanId:e,requestId:n.requestId,sessionId:n.sessionId,agentId:n.agentId,kind:r,name:o,status:"running",startedAt:n.emittedAt,startEventIndex:a,attributes:i,events:[]};return addEvent(s,n,a),s}function addEvent(t,e,r){t.events.push({index:r,eventId:e.eventId??`${e.requestId}:${r}`,type:e.type,emittedAt:e.emittedAt})}function close(t,e,r){t.status="failed"===t.status||"blocked"===t.status?t.status:"completed",t.completedAt=e.emittedAt,t.endEventIndex=r,t.durationMs=function durationMs(t,e){if(!t||!e)return;const r=Date.parse(e)-Date.parse(t);return Number.isFinite(r)&&r>=0?r:void 0}(t.startedAt,t.completedAt)}function merge(t,e){return e?{...t,...e}:t}function isRecord(t){return"object"==typeof t&&null!==t&&!Array.isArray(t)}function readTraceType(t){const e=readString(t);return"request"===e||"tool"===e||"workflow"===e||"spec"===e||"adapter"===e||"memory"===e||"artifact"===e||"progress"===e||"plan"===e||"delegation"===e?e:void 0}function readString(t){return"string"==typeof t&&t.trim()?t:void 0}
+export function createDelegationTraceProjection(t,e={}){return{traceType:"delegation",traceLabel:t,...e}}export function createPlanTraceProjection(t,e={}){return{traceType:"plan",traceLabel:t,...e}}export function projectRuntimeTrace(t){return t.events.map(projectEvent).filter(isTraceEntry)}export function projectRuntimeTraceSpans(t){const e=function createSpanBuilder(t){const e=`run:${t.requestId}`,r=[],n=new Map;return{ensureRoot(){if(n.has(e))return;const o={spanId:e,requestId:t.requestId,sessionId:t.sessionId,agentId:t.agentId,kind:"run",name:t.agentId,status:(a=t.state,"completed"===a?"completed":"failed"===a?"failed":"cancelled"===a?"blocked":"running"),startedAt:t.startedAt,completedAt:t.completedAt,startEventIndex:0,...t.parentRunId?{parentSpanId:`run:${t.parentRunId}`}:{},events:[]};var a;r.push(o),n.set(e,o)},markRoot(t,r,o,a){const i=n.get(e);i&&(addEvent(i,t,r),i.status=o,i.attributes=merge(i.attributes,a),"running"!==o&&close(i,t,r))},start(t,o,a,i,s,p){const d=createSpan(`${e}/${t}:${s}`,e,o,a,i,s,p);r.push(d),n.set(t,d)},complete(t,o,a,i){const s=n.get(t)??createSpan(`${e}/${t}:${a}`,e,"adapter",t,o,a);return n.has(t)||r.push(s),addEvent(s,o,a),s.attributes=merge(s.attributes,i),close(s,o,a),n.delete(t),s},fail(t,e,r,n){this.complete(t,e,r,n).status="failed"},event(t,n,o,a,i){const s=createSpan(`${e}/event:${a}`,e,t,n,o,a,i);s.status=function readBlockedStatus(t){return t.type.endsWith(".blocked")||t.type.includes(".approval.")?"blocked":void 0}(o)??"event",close(s,o,a),r.push(s)},closeRoot(){const r=n.get(e);r&&t.completedAt&&(r.completedAt=t.completedAt)},spans:()=>r}}(t);return e.ensureRoot(),t.events.forEach((t,r)=>function projectSpanEvent(t,e,r){return e.type.startsWith("runtime.request.")?function projectRequestSpanEvent(t,e,r){return"runtime.request.started"===e.type?t.markRoot(e,r,"running",{input:e.input}):"runtime.request.completed"===e.type?t.markRoot(e,r,"completed",{output:e.output}):"runtime.request.failed"===e.type?t.markRoot(e,r,"failed",{error:e.error}):"runtime.request.cancelled"===e.type?t.markRoot(e,r,"blocked",{reason:e.reason}):"runtime.execution.contract.failed"===e.type?projectSingleSpan(t,e,r,"quality",e.type,{reason:e.reason,missingEvidenceTools:e.missingEvidenceTools}):void 0}(t,e,r):"runtime.tool.direct.started"===e.type?t.start(`tool:${e.toolId}`,"tool",e.toolId,e,r,{toolId:e.toolId}):"runtime.tool.direct.completed"===e.type?t.complete(`tool:${e.toolId}`,e,r,{toolId:e.toolId,output:e.output}):"runtime.workflow.started"===e.type?t.start(`workflow:${e.workflowId}`,"workflow",e.workflowId,e,r,{workflowId:e.workflowId,adapter:e.adapter}):"runtime.workflow.completed"===e.type?t.complete(`workflow:${e.workflowId}`,e,r,{workflowId:e.workflowId,adapter:e.adapter}):e.type.startsWith("runtime.approval.")||e.type.startsWith("runtime.memory.approval.")?projectSingleSpan(t,e,r,"approval",e.type):e.type.startsWith("runtime.specDriven.phase.")?projectSingleSpan(t,e,r,"spec",function readPhaseName(t,e){return"phaseId"in t&&"string"==typeof t.phaseId?t.phaseId:e}(e,"phase")):e.type.startsWith("runtime.memory.")?projectSingleSpan(t,e,r,"memory",e.type):e.type.startsWith("runtime.quality.")?projectSingleSpan(t,e,r,"quality",e.type):"runtime.failure.classified"===e.type?projectSingleSpan(t,e,r,"quality",e.type,e.classification):e.type.startsWith("runtime.improvement.")||e.type.startsWith("runtime.verification.")?projectSingleSpan(t,e,r,"quality",e.type):e.type.startsWith("runtime.context.")?projectSingleSpan(t,e,r,"artifact",e.type):e.type.startsWith("runtime.repair.")?projectSingleSpan(t,e,r,"adapter",e.type):"runtime.artifact.created"===e.type?projectSingleSpan(t,e,r,"artifact",e.artifact.id,{artifact:e.artifact}):"runtime.progress.narration"===e.type?projectSingleSpan(t,e,r,"progress",e.message,{provider:e.provider}):"runtime.adapter.event"===e.type?function projectAdapterSpanEvent(t,e,r){const n=isRecord(e.event)?e.event:void 0,o=readString(n?.phase)??"runtime.adapter.event",a=readTraceType(n?.traceType),i=readString(n?.traceLabel);return"delegation"===a&&i?.endsWith(".start")?t.start(delegationKey(n),"delegation",readString(n?.subagentType)??i,e,r,n):"delegation"===a&&i?.endsWith(".completed")?t.complete(delegationKey(n),e,r,n):"plan"===a&&i?projectSingleSpan(t,e,r,"plan",i,n):function isToolStartEvent(t){return"deepagents.tool_execution.start"===t?.eventType||"agent.tool.start"===t?.phase}(n)?t.start(`agent-tool:${readString(n?.toolId)??"unknown"}`,"tool",readString(n?.toolId)??o,e,r,n):function isToolResultEvent(t){return"deepagents.tool_execution.result"===t?.eventType||"agent.tool.result"===t?.phase}(n)?t.complete(`agent-tool:${readString(n?.toolId)??"unknown"}`,e,r,n):projectSingleSpan(t,e,r,"adapter",o,n)}(t,e,r):"runtime.inventory.repair"===e.type?projectSingleSpan(t,e,r,"adapter","runtime.inventory.repair",{status:e.status,...e.diagnostic}):"runtime.sandbox.decision"===e.type?projectSingleSpan(t,e,r,"tool",`sandbox:${e.toolId}`,{toolId:e.toolId,...e.decision}):"runtime.tool.failure"===e.type?t.fail(`tool:${e.toolId}`,e,r,{toolId:e.toolId,...e.failure}):"runtime.tool.circuit.opened"===e.type?projectSingleSpan(t,e,r,"tool",`circuit:${e.toolId}`,{toolId:e.toolId,reason:e.reason}):void 0}(e,t,r)),e.closeRoot(),e.spans()}export function projectEvent(t){return"runtime.request.started"===t.type||"runtime.request.completed"===t.type||"runtime.request.failed"===t.type?base(t,"request",t.type):"runtime.request.cancelled"===t.type?base(t,"request",t.type,{reason:t.reason}):"runtime.failure.classified"===t.type?base(t,"quality",t.type,t.classification):"runtime.execution.contract.failed"===t.type?base(t,"request",t.type,{reason:t.reason,missingEvidenceTools:t.missingEvidenceTools}):"runtime.inventory.repair"===t.type?base(t,"adapter","runtime.inventory.repair",{status:t.status,...t.diagnostic}):"runtime.repair.started"===t.type||"runtime.repair.completed"===t.type?base(t,"adapter",t.type,{layer:t.layer,..."outcome"in t?{outcome:t.outcome}:{},..."attempt"in t?{attempt:t.attempt}:{},..."reason"in t?{reason:t.reason}:{},...t.diagnostics?{diagnostics:t.diagnostics}:{}}):"runtime.tool.direct.started"===t.type?base(t,"tool","runtime.tool.direct.started",{toolId:t.toolId}):"runtime.tool.direct.completed"===t.type?base(t,"tool","runtime.tool.direct.completed",{toolId:t.toolId,...outputTraceDetail(t.output)}):"runtime.sandbox.decision"===t.type?base(t,"tool","runtime.sandbox.decision",{toolId:t.toolId,...t.decision}):"runtime.tool.failure"===t.type?base(t,"tool","runtime.tool.failure",{toolId:t.toolId,...t.failure}):"runtime.tool.circuit.opened"===t.type?base(t,"tool","runtime.tool.circuit.opened",{toolId:t.toolId,reason:t.reason}):"runtime.workflow.started"===t.type||"runtime.workflow.completed"===t.type?base(t,"workflow",t.type,{workflowId:t.workflowId,adapter:t.adapter}):function isSpecDrivenPhaseEvent(t){return t.type.startsWith("runtime.specDriven.phase.")}(t)?base(t,"spec",t.type,{phaseId:t.phaseId,..."workflowId"in t&&t.workflowId?{workflowId:t.workflowId}:{},..."reason"in t?{reason:t.reason}:{},..."artifact"in t&&t.artifact?{artifact:t.artifact}:{}}):"runtime.adapter.event"===t.type?function adapterTrace(t){const e=t.event;if(isRecord(e)&&"string"==typeof e.phase){const r=function semanticAdapterTrace(t,e){if("inventory.repair"===e.phase)return base(t,"adapter","runtime.inventory.repair",{status:e.status,...isRecord(e.diagnostic)?e.diagnostic:{}});const r=readTraceType(e.traceType),n=readString(e.traceLabel);return r&&n?base(t,r,n,e):void 0}(t,e);return r||base(t,"adapter",e.phase.startsWith("agent.")?e.phase:`adapter.${e.phase}`,e)}return base(t,"adapter","runtime.adapter.event",{event:e})}(t):"runtime.artifact.created"===t.type?base(t,"artifact","runtime.artifact.created",{artifact:t.artifact}):t.type.startsWith("runtime.memory.")?base(t,"memory",t.type):t.type.startsWith("runtime.improvement.")||t.type.startsWith("runtime.verification.")?base(t,"quality",t.type):t.type.startsWith("runtime.context.")?base(t,"artifact",t.type):"runtime.progress.narration"===t.type?base(t,"progress",t.type,{message:t.message,provider:t.provider,sourceEventTypes:t.sourceEventTypes}):void 0}export function readPlanTodos(t){const e=function readPlanRecord(t){if(isRecord(t))return t;if("string"==typeof t)try{const e=JSON.parse(t);return isRecord(e)?e:void 0}catch{return}}(t),r=function readTodosArray(t){const e=isRecord(t?.args)?t.args:void 0;return Array.isArray(t?.todos)?t.todos:Array.isArray(e?.todos)?e.todos:[]}(e);return r.map(readTodo).filter(isPlanTodoItem)}function readTodo(t){if(isRecord(t)&&"string"==typeof t.content)return{content:t.content,status:"string"==typeof t.status?t.status:"pending"}}function isPlanTodoItem(t){return void 0!==t}function base(t,e,r,n){return{type:e,label:r,agentId:t.agentId,requestId:t.requestId,detail:n}}function isTraceEntry(t){return void 0!==t}function outputTraceDetail(t){const e="string"==typeof t?t:function serializeOutput(t){try{return void 0===t?"":JSON.stringify(t)}catch{return String(t)}}(t),r=e.slice(0,1200);return{outputType:Array.isArray(t)?"array":null===t?"null":typeof t,outputLength:e.length,outputPreview:r,...e.length>r.length?{outputTail:e.slice(-1200)}:{}}}function projectSingleSpan(t,e,r,n,o,a){return t.event(n,o,e,r,a)}function delegationKey(t){return`delegation:${readString(t?.subagentType)??readString(t?.toolId)??"task"}`}function createSpan(t,e,r,n,o,a,i){const s={spanId:t,parentSpanId:e,requestId:o.requestId,sessionId:o.sessionId,agentId:o.agentId,kind:r,name:n,status:"running",startedAt:o.emittedAt,startEventIndex:a,attributes:i,events:[]};return addEvent(s,o,a),s}function addEvent(t,e,r){t.events.push({index:r,eventId:e.eventId??`${e.requestId}:${r}`,type:e.type,emittedAt:e.emittedAt})}function close(t,e,r){t.status="failed"===t.status||"blocked"===t.status?t.status:"completed",t.completedAt=e.emittedAt,t.endEventIndex=r,t.durationMs=function durationMs(t,e){if(!t||!e)return;const r=Date.parse(e)-Date.parse(t);return Number.isFinite(r)&&r>=0?r:void 0}(t.startedAt,t.completedAt)}function merge(t,e){return e?{...t,...e}:t}function isRecord(t){return"object"==typeof t&&null!==t&&!Array.isArray(t)}function readTraceType(t){const e=readString(t);return"request"===e||"tool"===e||"workflow"===e||"spec"===e||"adapter"===e||"memory"===e||"artifact"===e||"progress"===e||"plan"===e||"delegation"===e?e:void 0}function readString(t){return"string"==typeof t&&t.trim()?t:void 0}

package/node_modules/@stable-harness/core/dist/types.d.ts

@@ -6,10 +6,11 @@ import type { RuntimeEvent, RuntimeEventListener, RuntimeEmit } from "./runtime/
 import type { RuntimeToolFailureTracker } from "./runtime/tool-failure.js";
 import type { ToolGuardrail } from "./runtime/policy/tool-invocation.js";
 import type { ExecutionEvaluatorRule } from "./quality/execution-review.js";
+import type { RuntimeImprovementProposal, RuntimeImprovementProposalFilter, RuntimeImprovementProposalInput, RuntimeImprovementReviewInput, RuntimeFailureClassificationInput, RuntimeVerificationHookResultInput, RuntimeContextOffloadInput, RuntimeContextCompactionInput } from "./runtime/improvement/types.js";
 import type { RuntimeArtifact, RuntimeArtifactFilter, RuntimeArtifactImportInput, RuntimeArtifactRecord, RuntimeOutput, RuntimeRecordState, RuntimeRequest, RuntimeResponse, RuntimeReplayBundle, RuntimeDeletionResult, RuntimeRunFilter, RuntimeRunRecord } from "./runtime/types.js";
 import type { RuntimeToolGateway } from "./runtime/tool-gateway.js";
 import type { CompiledWorkspace, WorkspaceAgent, WorkspaceRuntimePolicy } from "./workspace/types.js";
-export type { RuntimeEvent, RuntimeMemoryHook, RuntimeEventListener, RuntimeEmit } from "./runtime/events.js";
+export type { RuntimeEmit, RuntimeEvent, RuntimeEventListener, RuntimeFailureCategory, RuntimeFailureClassification, RuntimeFailureEvidenceReference, RuntimeMemoryHook, } from "./runtime/events.js";
 export type { BoundaryScanFinding, BoundaryScanLayer, BoundaryScanLayerResult, BoundaryScanResource, BoundaryScanResult } from "./boundary-scan.js";
 export type { RuntimeCapabilityContext, RuntimeCapabilityModule, RuntimeCapabilityRegistry, RuntimeCapabilityState } from "./runtime/capabilities.js";
 export type { RuntimeProgressNarrationOptions, RuntimeProgressNarrationProvider } from "./runtime/progress-narration.js";
@@ -20,6 +21,7 @@ export type { WorkspaceEvaluation, WorkspaceEvaluationCase, } from "./evaluation
 export type { SpecDrivenPhaseId, SpecDrivenPhaseRecord, SpecDrivenPhaseStatus, SpecDrivenPhaseTransition, SpecDrivenWorkflowState, WorkspaceSpecDrivenPhase, WorkspaceSpecDrivenWorkflowPolicy, } from "./spec-driven/index.js";
 export type { RuntimeToolCallRequest, RuntimeToolGateway, RuntimeToolGatewayContext, RuntimeToolRepairModel, RuntimeToolGatewayTool, RuntimeSandboxDecision, RuntimeSandboxPolicy, RuntimeSandboxPolicyInput, } from "./runtime/tool-gateway.js";
 export type { RuntimeToolFailureClassification, RuntimeToolFailureKind, RuntimeToolFailurePolicy, RuntimeToolFailureReason, RuntimeToolFailureTracker, } from "./runtime/tool-failure.js";
+export type { RuntimeContextImprovement, RuntimeContextCompactionInput, RuntimeContextOffloadInput, RuntimeFailureClassificationInput, RuntimeImprovementApplication, RuntimeImprovementOwner, RuntimeImprovementProposal, RuntimeImprovementProposalFilter, RuntimeImprovementProposalInput, RuntimeImprovementReviewInput, RuntimeImprovementStatus, RuntimeImprovementStore, RuntimeImprovementTarget, RuntimeMemoryImprovement, RuntimePolicyImprovement, RuntimeVerificationImprovement, RuntimeVerificationHookResultInput, } from "./runtime/improvement/types.js";
 export type RuntimeAdapterContext = {
     workspace: CompiledWorkspace;
     agent: WorkspaceAgent;
@@ -142,6 +144,15 @@ export type RuntimeInspector = {
     listApprovals(status?: ApprovalRequestStatus): Promise<ApprovalRequest[]>;
     getApproval(id: string): Promise<ApprovalRequest | undefined>;
     resolveApproval(id: string, status: Exclude<ApprovalRequestStatus, "pending">): Promise<ApprovalRequest | undefined>;
+    classifyRunFailure(input: RuntimeFailureClassificationInput): RuntimeImprovementProposal | undefined;
+    createImprovementProposal(input: RuntimeImprovementProposalInput): RuntimeImprovementProposal;
+    listImprovementProposals(filter?: RuntimeImprovementProposalFilter): RuntimeImprovementProposal[];
+    getImprovementProposal(id: string): RuntimeImprovementProposal | undefined;
+    reviewImprovementProposal(input: RuntimeImprovementReviewInput): RuntimeImprovementProposal | undefined;
+    applyImprovementProposal(id: string): RuntimeImprovementProposal | undefined;
+    recordVerificationHookResult(input: RuntimeVerificationHookResultInput): boolean;
+    recordContextOffload(input: RuntimeContextOffloadInput): boolean;
+    recordContextCompaction(input: RuntimeContextCompactionInput): boolean;
 };
 export type RuntimeLifecycle = {
     cancel(requestId: string, reason?: string): void;

package/node_modules/@stable-harness/core/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@stable-harness/core",
-  "version": "0.0.124",
+  "version": "0.0.125",
   "license": "Apache-2.0",
   "type": "module",
   "files": [
@@ -12,7 +12,7 @@
     ".": "./dist/index.js"
   },
   "peerDependencies": {
-    "@stable-harness/governance": "0.0.124",
-    "@stable-harness/memory": "0.0.124"
+    "@stable-harness/governance": "0.0.125",
+    "@stable-harness/memory": "0.0.125"
   }
 }

package/node_modules/@stable-harness/governance/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@stable-harness/governance",
-  "version": "0.0.124",
+  "version": "0.0.125",
   "license": "Apache-2.0",
   "type": "module",
   "files": [

package/node_modules/@stable-harness/memory/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@stable-harness/memory",
-  "version": "0.0.124",
+  "version": "0.0.125",
   "license": "Apache-2.0",
   "type": "module",
   "files": [

package/node_modules/@stable-harness/protocols/dist/src/in-process-client.js

@@ -1 +1 @@
-export function createInProcessClient(e){return{request:t=>e.request(t),subscribe:t=>e.subscribe(t),inspect:()=>e.inspect(),getRuntimePolicy:()=>e.getRuntimePolicy(),getWorkflow:t=>e.getWorkflow(t),getRun:t=>e.getRun(t),listArtifacts:t=>e.listArtifacts(t),getArtifact:t=>e.getArtifact(t),readArtifact:t=>e.readArtifact(t),importArtifact:t=>e.importArtifact(t),exportReplayBundle:t=>e.exportReplayBundle(t),listRequests:t=>e.listRequests(t),listSessions:()=>e.listSessions(),inspectRequest:t=>e.inspectRequest(t),memorize:t=>e.memorize(t),recallMemories:t=>e.recallMemories(t),listMemories:t=>e.listMemories(t),updateMemory:t=>e.updateMemory(t),archiveMemory:(t,s)=>e.archiveMemory(t,s),listApprovals:t=>e.listApprovals(t),getApproval:t=>e.getApproval(t),resolveApproval:(t,s)=>e.resolveApproval(t,s),cancel:(t,s)=>e.cancel(t,s),deleteRequest:t=>e.deleteRequest(t),deleteSession:t=>e.deleteSession(t),stop:()=>e.stop()}}
+export function createInProcessClient(e){return{request:t=>e.request(t),subscribe:t=>e.subscribe(t),inspect:()=>e.inspect(),getRuntimePolicy:()=>e.getRuntimePolicy(),getWorkflow:t=>e.getWorkflow(t),getRun:t=>e.getRun(t),listArtifacts:t=>e.listArtifacts(t),getArtifact:t=>e.getArtifact(t),readArtifact:t=>e.readArtifact(t),importArtifact:t=>e.importArtifact(t),exportReplayBundle:t=>e.exportReplayBundle(t),listRequests:t=>e.listRequests(t),listSessions:()=>e.listSessions(),inspectRequest:t=>e.inspectRequest(t),memorize:t=>e.memorize(t),recallMemories:t=>e.recallMemories(t),listMemories:t=>e.listMemories(t),updateMemory:t=>e.updateMemory(t),archiveMemory:(t,r)=>e.archiveMemory(t,r),listApprovals:t=>e.listApprovals(t),getApproval:t=>e.getApproval(t),resolveApproval:(t,r)=>e.resolveApproval(t,r),...createImprovementClient(e),cancel:(t,r)=>e.cancel(t,r),deleteRequest:t=>e.deleteRequest(t),deleteSession:t=>e.deleteSession(t),stop:()=>e.stop()}}function createImprovementClient(e){return{classifyRunFailure:t=>e.classifyRunFailure(t),createImprovementProposal:t=>e.createImprovementProposal(t),listImprovementProposals:t=>e.listImprovementProposals(t),getImprovementProposal:t=>e.getImprovementProposal(t),reviewImprovementProposal:t=>e.reviewImprovementProposal(t),applyImprovementProposal:t=>e.applyImprovementProposal(t),recordVerificationHookResult:t=>e.recordVerificationHookResult(t),recordContextOffload:t=>e.recordContextOffload(t),recordContextCompaction:t=>e.recordContextCompaction(t)}}

package/node_modules/@stable-harness/protocols/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@stable-harness/protocols",
-  "version": "0.0.124",
+  "version": "0.0.125",
   "license": "Apache-2.0",
   "type": "module",
   "files": [
@@ -11,6 +11,6 @@
   "main": "dist/src/index.js",
   "types": "dist/src/index.d.ts",
   "peerDependencies": {
-    "@stable-harness/core": "0.0.124"
+    "@stable-harness/core": "0.0.125"
   }
 }

package/node_modules/@stable-harness/tool-gateway/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@stable-harness/tool-gateway",
-  "version": "0.0.124",
+  "version": "0.0.125",
   "license": "Apache-2.0",
   "type": "module",
   "files": [

package/node_modules/@stable-harness/workspace-yaml/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@stable-harness/workspace-yaml",
-  "version": "0.0.124",
+  "version": "0.0.125",
   "license": "Apache-2.0",
   "type": "module",
   "files": [
@@ -12,6 +12,6 @@
     ".": "./dist/index.js"
   },
   "peerDependencies": {
-    "@stable-harness/core": "0.0.124"
+    "@stable-harness/core": "0.0.125"
   }
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "stable-harness",
-  "version": "0.0.124",
+  "version": "0.0.125",
   "type": "module",
   "description": "Stable application runtime and operator control plane for agent workspaces.",
   "license": "Apache-2.0",
@@ -82,14 +82,14 @@
     "@langchain/node-vfs": "^0.1.4",
     "@langchain/ollama": "^1.2.7",
     "@langchain/openai": "^1.4.5",
-    "@stable-harness/adapter-deepagents": "0.0.124",
-    "@stable-harness/adapter-langgraph": "0.0.124",
-    "@stable-harness/core": "0.0.124",
-    "@stable-harness/governance": "0.0.124",
-    "@stable-harness/memory": "0.0.124",
-    "@stable-harness/protocols": "0.0.124",
-    "@stable-harness/tool-gateway": "0.0.124",
-    "@stable-harness/workspace-yaml": "0.0.124",
+    "@stable-harness/adapter-deepagents": "0.0.125",
+    "@stable-harness/adapter-langgraph": "0.0.125",
+    "@stable-harness/core": "0.0.125",
+    "@stable-harness/governance": "0.0.125",
+    "@stable-harness/memory": "0.0.125",
+    "@stable-harness/protocols": "0.0.125",
+    "@stable-harness/tool-gateway": "0.0.125",
+    "@stable-harness/workspace-yaml": "0.0.125",
     "deepagents": "^1.10.1",
     "langchain": "^1.4.0",
     "yaml": "^2.8.2",

package/packages/adapter-deepagents/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@stable-harness/adapter-deepagents",
-  "version": "0.0.124",
+  "version": "0.0.125",
   "license": "Apache-2.0",
   "type": "module",
   "files": [
@@ -16,7 +16,7 @@
     "@langchain/node-vfs": "^0.1.4",
     "@langchain/ollama": "^1.2.7",
     "@langchain/openai": "^1.4.5",
-    "@stable-harness/core": "0.0.124",
+    "@stable-harness/core": "0.0.125",
     "deepagents": "^1.10.1",
     "langchain": "^1.4.0"
   },

package/packages/adapter-langgraph/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@stable-harness/adapter-langgraph",
-  "version": "0.0.124",
+  "version": "0.0.125",
   "license": "Apache-2.0",
   "type": "module",
   "files": [
@@ -12,6 +12,6 @@
   "types": "dist/src/index.d.ts",
   "peerDependencies": {
     "@langchain/langgraph": "^1.3.0",
-    "@stable-harness/core": "0.0.124"
+    "@stable-harness/core": "0.0.125"
   }
 }

package/packages/cli/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@stable-harness/cli",
-  "version": "0.0.124",
+  "version": "0.0.125",
   "license": "Apache-2.0",
   "type": "module",
   "files": [
@@ -15,12 +15,12 @@
   "types": "dist/src/index.d.ts",
   "peerDependencies": {
     "@langchain/langgraph-api": "^1.2.1",
-    "@stable-harness/adapter-deepagents": "0.0.124",
-    "@stable-harness/adapter-langgraph": "0.0.124",
-    "@stable-harness/core": "0.0.124",
-    "@stable-harness/memory": "0.0.124",
-    "@stable-harness/protocols": "0.0.124",
-    "@stable-harness/tool-gateway": "0.0.124",
-    "@stable-harness/workspace-yaml": "0.0.124"
+    "@stable-harness/adapter-deepagents": "0.0.125",
+    "@stable-harness/adapter-langgraph": "0.0.125",
+    "@stable-harness/core": "0.0.125",
+    "@stable-harness/memory": "0.0.125",
+    "@stable-harness/protocols": "0.0.125",
+    "@stable-harness/tool-gateway": "0.0.125",
+    "@stable-harness/workspace-yaml": "0.0.125"
   }
 }

package/packages/core/dist/index.d.ts

@@ -16,6 +16,7 @@ export * from "./runtime/tool-failure.js";
 export * from "./runtime/tracing/langsmith.js";
 export * from "./runtime/policy/tool-invocation.js";
 export * from "./runtime/persistence/stores.js";
+export * from "./runtime/improvement/store.js";
 export * from "./trace.js";
 export * from "./types.js";
 export * from "./workspace/tool-quality.js";

package/packages/core/dist/index.js

@@ -1 +1 @@
-export*from"./runtime/persistence/artifacts.js";export*from"./boundary-scan.js";export*from"./execution-contract.js";export*from"./recovery/tool-call.js";export*from"./runtime/persistence/inspection.js";export*from"./runtime/metrics/prometheus.js";export{createWorkspaceSandboxPolicy}from"./runtime/governance/sandbox.js";export*from"./memory-plugins.js";export{resolveEnabledMemories}from"./memory-plugins/shared.js";export*from"./runtime/persistence/queue.js";export*from"./runtime/policy/projection.js";export*from"./runtime.js";export*from"./runtime/selection-repair.js";export*from"./runtime/tool-failure.js";export*from"./runtime/tracing/langsmith.js";export*from"./runtime/policy/tool-invocation.js";export*from"./runtime/persistence/stores.js";export*from"./trace.js";export*from"./types.js";export*from"./workspace/tool-quality.js";export*from"./evaluations/index.js";export*from"./quality/index.js";export*from"./spec-driven/index.js";export*from"./workflows/index.js";
+export*from"./runtime/persistence/artifacts.js";export*from"./boundary-scan.js";export*from"./execution-contract.js";export*from"./recovery/tool-call.js";export*from"./runtime/persistence/inspection.js";export*from"./runtime/metrics/prometheus.js";export{createWorkspaceSandboxPolicy}from"./runtime/governance/sandbox.js";export*from"./memory-plugins.js";export{resolveEnabledMemories}from"./memory-plugins/shared.js";export*from"./runtime/persistence/queue.js";export*from"./runtime/policy/projection.js";export*from"./runtime.js";export*from"./runtime/selection-repair.js";export*from"./runtime/tool-failure.js";export*from"./runtime/tracing/langsmith.js";export*from"./runtime/policy/tool-invocation.js";export*from"./runtime/persistence/stores.js";export*from"./runtime/improvement/store.js";export*from"./trace.js";export*from"./types.js";export*from"./workspace/tool-quality.js";export*from"./evaluations/index.js";export*from"./quality/index.js";export*from"./spec-driven/index.js";export*from"./workflows/index.js";

package/packages/core/dist/recovery/raw-args.d.ts

@@ -21,4 +21,13 @@ export type RawArgsToolMatch = {
     toolId: string;
     args: Record<string, unknown>;
 };
+export type RawArgsToolEvidence = {
+    match: RawArgsToolMatch;
+    toolOutput: string;
+};
+export declare function buildRawArgsToolSequenceEvidenceRecoveryRequest(input: {
+    request: RuntimeRequest;
+    evidences: RawArgsToolEvidence[];
+}): RuntimeRequest;
 export declare function matchUniqueRawArgsTool(input: Omit<RawArgsRecoveryInput, "request">): RawArgsToolMatch | undefined;
+export declare function matchRawArgsToolSequence(input: Omit<RawArgsRecoveryInput, "request">): RawArgsToolMatch[];

package/packages/core/dist/recovery/raw-args.js

@@ -1 +1 @@
-import{selectCallCandidateByArgsSchema as e}from"@easynet/better-call";export function buildRawArgsRecoveryRequest(e){if(!toolCallRecoveryEnabled(e.policy))return;const t=matchUniqueRawArgsTool(e);return t?function buildRawArgsRecoveryPrompt(e,t){return{...e,input:[e.input,"","Stable runtime recovery: your previous final answer was a JSON argument object for a declared tool, not the final answer.",`Matched configured tool: ${t.toolId}`,"Continue the same user request by calling that tool through the backend's normal structured tool-calling mechanism with the JSON arguments below.","If the tool call succeeds, synthesize the final user-facing answer from the executed evidence.","Do not print JSON argument objects, raw tool-call markup, plans, or future-intent text as the final answer.","","Previous JSON arguments:",JSON.stringify(t.args)].join("\n"),metadata:{...e.metadata,stableHarnessRecovery:"tool_call"}}}(e.request,t):void 0}export function buildRawArgsToolEvidenceRecoveryRequest(e){return{...e.request,input:[e.request.input,"","Stable runtime recovery: your previous final answer repeated a JSON argument object for a declared tool after a structured tool-call recovery request.",`Matched configured tool: ${e.match.toolId}`,"Stable runtime executed that matched declared tool through the governed tool gateway.","Continue the same user request from the executed evidence below.","If another declared tool is needed, call it through the backend's normal structured tool-calling mechanism.","Otherwise, synthesize the final user-facing answer from the executed evidence.","Do not print JSON argument objects, raw tool-call markup, plans, or future-intent text as the final answer.","","Executed JSON arguments:",JSON.stringify(e.match.args),"","Executed tool output:",e.toolOutput].join("\n"),metadata:{...e.request.metadata,stableHarnessRecovery:"tool_call"}}}export function hasUniqueRawArgsTool(e){return toolCallRecoveryEnabled(e.policy)&&Boolean(matchUniqueRawArgsTool(e))}export function matchUniqueRawArgsTool(t){const o=function parseStandaloneJsonObject(e){const t=e.trim(),o=t.match(/^```(?:json)?\s*\n([\s\S]*?)\n```$/iu)?.[1]?.trim(),r=o??t;if(r.startsWith("{")&&r.endsWith("}")&&!(r.length>6e3))try{const e=JSON.parse(r);return!isRecord(e)||function isToolCallEnvelope(e){const t=["tool","tool_name","name","type","subagent_type"].some(t=>"string"==typeof e[t]),o=["args","arguments","parameters","kwargs"].some(t=>t in e);return t&&o}(e)||function isRuntimeControlObject(e){return"string"==typeof e.status||"string"==typeof e.error||"string"==typeof e.controlStatus}(e)?void 0:e}catch{return}}(t.output);if(!o)return;const r=e({args:o,candidates:buildCallCandidates(t)});if(r.ok)return{toolId:r.candidateId,args:r.args};const n=function latestSingleToolCandidate(e,t){for(let o=(e?.length??0)-1;o>=0;o-=1){const r=e[o];if(!r||!("diagnostics"in r)||!isRecord(r.diagnostics))continue;const n=readStringArray(r.diagnostics.toolCandidateIds).filter(e=>t.has(e));if(1===n.length)return n[0];if(n.length>1)return}}(t.events,new Set(candidateToolIds(t)));return n?{toolId:n,args:o}:void 0}function buildCallCandidates(e){return candidateToolIds(e).map(t=>({id:t,schema:e.workspace.tools.get(t)?.schema??e.toolGateway?.get(t)?.schema}))}function candidateToolIds(e){const t=new Set(e.agent.tools),o=(e.candidateToolIds??[]).filter(e=>t.has(e));return o.length>0?o:e.agent.tools}function toolCallRecoveryEnabled(e){return!!(isRecord(e)&&isRecord(e.recovery)&&isRecord(e.recovery.toolCall))&&!0===e.recovery.toolCall.enabled}function readStringArray(e){return Array.isArray(e)?e.filter(e=>"string"==typeof e&&e.length>0):[]}function isRecord(e){return"object"==typeof e&&null!==e&&!Array.isArray(e)}
+import{selectCallCandidateByArgsSchema as e}from"@easynet/better-call";export function buildRawArgsRecoveryRequest(e){if(!toolCallRecoveryEnabled(e.policy))return;const t=matchUniqueRawArgsTool(e);return t?function buildRawArgsRecoveryPrompt(e,t){return{...e,input:[e.input,"","Stable runtime recovery: your previous final answer was a JSON argument object for a declared tool, not the final answer.",`Matched configured tool: ${t.toolId}`,"Continue the same user request by calling that tool through the backend's normal structured tool-calling mechanism with the JSON arguments below.","If the tool call succeeds, synthesize the final user-facing answer from the executed evidence.","Do not print JSON argument objects, raw tool-call markup, plans, or future-intent text as the final answer.","","Previous JSON arguments:",JSON.stringify(t.args)].join("\n"),metadata:{...e.metadata,stableHarnessRecovery:"tool_call"}}}(e.request,t):void 0}export function buildRawArgsToolEvidenceRecoveryRequest(e){return{...e.request,input:[e.request.input,"","Stable runtime recovery: your previous final answer repeated a JSON argument object for a declared tool after a structured tool-call recovery request.",`Matched configured tool: ${e.match.toolId}`,"Stable runtime executed that matched declared tool through the governed tool gateway.","Continue the same user request from the executed evidence below.","If another declared tool is needed, call it through the backend's normal structured tool-calling mechanism.","Otherwise, synthesize the final user-facing answer from the executed evidence.","Do not print JSON argument objects, raw tool-call markup, plans, or future-intent text as the final answer.","","Executed JSON arguments:",JSON.stringify(e.match.args),"","Executed tool output:",e.toolOutput].join("\n"),metadata:{...e.request.metadata,stableHarnessRecovery:"tool_call"}}}export function hasUniqueRawArgsTool(e){return toolCallRecoveryEnabled(e.policy)&&Boolean(matchUniqueRawArgsTool(e))}export function buildRawArgsToolSequenceEvidenceRecoveryRequest(e){return{...e.request,input:[e.request.input,"","Stable runtime recovery: your previous final answer printed multiple JSON argument objects for declared tools after a recovery request.","Stable runtime matched and executed those declared tools through the governed tool gateway.","Continue the same user request from the executed evidence below.","If another declared tool is needed, call it through the backend's normal structured tool-calling mechanism.","Otherwise, synthesize the final user-facing answer from the executed evidence.","Do not print JSON argument objects, raw tool-call markup, plans, or future-intent text as the final answer.","",...e.evidences.flatMap((e,t)=>[`Executed tool ${t+1}: ${e.match.toolId}`,"Executed JSON arguments:",JSON.stringify(e.match.args),"Executed tool output:",e.toolOutput,""])].join("\n"),metadata:{...e.request.metadata,stableHarnessRecovery:"tool_call"}}}export function matchUniqueRawArgsTool(t){const r=parseStandaloneJsonRecords(t.output,{allowArray:!1})[0];if(!r)return;const o=e({args:r,candidates:buildCallCandidates(t)});if(o.ok)return{toolId:o.candidateId,args:o.args};const a=function latestSingleToolCandidate(e,t){for(let r=(e?.length??0)-1;r>=0;r-=1){const o=e[r];if(!o||!("diagnostics"in o)||!isRecord(o.diagnostics))continue;const a=readStringArray(o.diagnostics.toolCandidateIds).filter(e=>t.has(e));if(1===a.length)return a[0];if(a.length>1)return}}(t.events,new Set(candidateToolIds(t)));return a?{toolId:a,args:r}:void 0}export function matchRawArgsToolSequence(t){if(!toolCallRecoveryEnabled(t.policy))return[];const r=parseStandaloneJsonRecords(t.output,{allowArray:!0});if(r.length<2)return[];const o=buildCallCandidates(t),a=[];for(const t of r){const r=e({args:t,candidates:o});if(!r.ok)return[];a.push({toolId:r.candidateId,args:r.args})}return a}function buildCallCandidates(e){return candidateToolIds(e).map(t=>({id:t,schema:e.workspace.tools.get(t)?.schema??e.toolGateway?.get(t)?.schema}))}function candidateToolIds(e){const t=new Set(e.agent.tools),r=(e.candidateToolIds??[]).filter(e=>t.has(e));return r.length>0?r:e.agent.tools}function parseStandaloneJsonRecords(e,t){const r=e.trim(),o=r.match(/^```(?:json)?\s*\n([\s\S]*?)\n```$/iu)?.[1]?.trim(),a=o??r;if(a.length>6e3)return[];if(!(t.allowArray||a.startsWith("{")&&a.endsWith("}")))return[];if(t.allowArray&&!(a.startsWith("{")&&a.endsWith("}")||a.startsWith("[")&&a.endsWith("]")))return[];try{const e=JSON.parse(a),r=Array.isArray(e)&&t.allowArray?e:[e];return r.some(e=>!function isRawArgsRecord(e){return isRecord(e)&&!function isToolCallEnvelope(e){const t=["tool","tool_name","name","type","subagent_type"].some(t=>"string"==typeof e[t]),r=["args","arguments","parameters","kwargs"].some(t=>t in e);return t&&r}(e)&&!function isRuntimeControlObject(e){return"string"==typeof e.status||"string"==typeof e.error||"string"==typeof e.controlStatus}(e)}(e))?[]:r}catch{return[]}}function toolCallRecoveryEnabled(e){return!!(isRecord(e)&&isRecord(e.recovery)&&isRecord(e.recovery.toolCall))&&!0===e.recovery.toolCall.enabled}function readStringArray(e){return Array.isArray(e)?e.filter(e=>"string"==typeof e&&e.length>0):[]}function isRecord(e){return"object"==typeof e&&null!==e&&!Array.isArray(e)}

package/packages/core/dist/runtime/events.d.ts

@@ -3,10 +3,25 @@ import type { ApprovalRequest } from "@stable-harness/governance";
 import type { RuntimeArtifact } from "../types.js";
 import type { RuntimeSandboxDecision } from "./tool-gateway.js";
 import type { RuntimeToolFailureClassification, RuntimeToolFailureReason } from "./tool-failure.js";
+import type { RuntimeImprovementProposal } from "./improvement/types.js";
 export type RuntimeInventoryRepairLayer = "agent" | "workflow_route" | "workflow" | "tool" | "task" | "skill";
 export type RuntimeInventoryRepairStatus = "repaired" | "blocked";
 export type RuntimeRepairLayer = "adapter_error" | "result_output" | "execution_contract" | "evidence_synthesis";
 export type RuntimeRepairOutcome = "retried" | "synthesized" | "blocked";
+export type RuntimeFailureCategory = "upstream_backend" | "workspace_config" | "runtime_policy" | "tool_gateway" | "memory_lifecycle" | "verification_gap" | "protocol_projection" | "downstream_application" | "unclassified";
+export type RuntimeFailureEvidenceReference = {
+    kind: "runtime_event" | "trace" | "tool_result" | "approval" | "sandbox_decision" | "memory_record" | "verification_result" | "adapter_state" | "protocol_response";
+    id?: string;
+    eventType?: string;
+    summary?: string;
+};
+export type RuntimeFailureClassification = {
+    category: RuntimeFailureCategory;
+    owner: "upstream_backend" | "stable_runtime" | "protocol_adapter" | "governance_policy" | "workspace_config" | "downstream_application" | "unknown";
+    confidence: number;
+    reason: string;
+    evidence: RuntimeFailureEvidenceReference[];
+};
 export type RuntimeRepairDiagnostics = {
     outputPreview?: string;
     toolCandidateIds?: string[];
@@ -43,6 +58,52 @@ export type RuntimeEvent = RuntimeEventMetadata & ({
     sessionId: string;
     agentId: string;
     error: string;
+} | {
+    type: "runtime.failure.classified";
+    requestId: string;
+    sessionId: string;
+    agentId: string;
+    classification: RuntimeFailureClassification;
+} | {
+    type: "runtime.improvement.proposed";
+    requestId: string;
+    sessionId: string;
+    agentId: string;
+    proposal: RuntimeImprovementProposal;
+} | {
+    type: "runtime.improvement.reviewed";
+    requestId: string;
+    sessionId: string;
+    agentId: string;
+    proposal: RuntimeImprovementProposal;
+} | {
+    type: "runtime.improvement.applied";
+    requestId: string;
+    sessionId: string;
+    agentId: string;
+    proposal: RuntimeImprovementProposal;
+} | {
+    type: "runtime.verification.hook.completed";
+    requestId: string;
+    sessionId: string;
+    agentId: string;
+    hookId: string;
+    status: "passed" | "failed" | "blocked";
+    evidence?: RuntimeFailureEvidenceReference[];
+} | {
+    type: "runtime.context.offloaded";
+    requestId: string;
+    sessionId: string;
+    agentId: string;
+    artifact: RuntimeArtifact;
+    retainedPreview?: string;
+} | {
+    type: "runtime.context.compacted";
+    requestId: string;
+    sessionId: string;
+    agentId: string;
+    artifact?: RuntimeArtifact;
+    summary: string;
 } | {
     type: "runtime.request.cancelled";
     requestId: string;

package/packages/core/dist/runtime/improvement/admin.d.ts

@@ -0,0 +1,15 @@
+import type { RuntimeEmit } from "../events.js";
+import type { RuntimeStore } from "../types.js";
+import type { RuntimeFailureClassificationInput, RuntimeImprovementProposalInput, RuntimeImprovementProposalFilter, RuntimeImprovementReviewInput, RuntimeImprovementStore } from "./types.js";
+export declare function createRuntimeImprovementAdministration(input: {
+    runtimeStore: RuntimeStore;
+    store: RuntimeImprovementStore;
+    emit: RuntimeEmit;
+}): {
+    classifyRunFailure(classification: RuntimeFailureClassificationInput): import("./types.js").RuntimeImprovementProposal | undefined;
+    createImprovementProposal(proposal: RuntimeImprovementProposalInput): import("./types.js").RuntimeImprovementProposal;
+    listImprovementProposals(filter?: RuntimeImprovementProposalFilter): import("./types.js").RuntimeImprovementProposal[];
+    getImprovementProposal(id: string): import("./types.js").RuntimeImprovementProposal | undefined;
+    reviewImprovementProposal(review: RuntimeImprovementReviewInput): import("./types.js").RuntimeImprovementProposal | undefined;
+    applyImprovementProposal(id: string): import("./types.js").RuntimeImprovementProposal | undefined;
+};

package/packages/core/dist/runtime/improvement/admin.js

@@ -0,0 +1 @@
+export function createRuntimeImprovementAdministration(e){const createProposal=s=>{const t=e.store.createProposal(s);return e.emit({type:"runtime.improvement.proposed",requestId:t.requestId??t.sourceRunId??"",sessionId:t.sessionId??"",agentId:t.agentId??"",proposal:t}),t};return{classifyRunFailure(s){const t=e.runtimeStore.getRun(s.requestId);if(t)return e.emit({type:"runtime.failure.classified",requestId:t.requestId,sessionId:t.sessionId,agentId:t.agentId,classification:s.classification}),s.proposal?createProposal({...s.proposal,requestId:s.proposal.requestId??t.requestId,sessionId:s.proposal.sessionId??t.sessionId,agentId:s.proposal.agentId??t.agentId,classification:s.proposal.classification??s.classification}):void 0},createImprovementProposal:e=>createProposal(e),listImprovementProposals:s=>e.store.listProposals(s),getImprovementProposal:s=>e.store.getProposal(s),reviewImprovementProposal(s){const t=e.store.updateProposal(s.id,{status:s.status,reviewedAt:(new Date).toISOString(),reviewReason:s.reason,supersededBy:s.supersededBy});return t&&e.emit({type:"runtime.improvement.reviewed",requestId:t.requestId??t.sourceRunId??"",sessionId:t.sessionId??"",agentId:t.agentId??"",proposal:t}),t},applyImprovementProposal(s){const t=e.store.getProposal(s);if(!t||"accepted"!==t.status)return;const o=e.store.updateProposal(s,{status:"applied",appliedAt:(new Date).toISOString()});return o&&e.emit({type:"runtime.improvement.applied",requestId:o.requestId??o.sourceRunId??"",sessionId:o.sessionId??"",agentId:o.agentId??"",proposal:o}),o}}}

package/packages/core/dist/runtime/improvement/evidence-admin.d.ts

@@ -0,0 +1,11 @@
+import type { RuntimeEmit } from "../events.js";
+import type { RuntimeStore } from "../types.js";
+import type { RuntimeContextCompactionInput, RuntimeContextOffloadInput, RuntimeVerificationHookResultInput } from "./types.js";
+export declare function createRuntimeEvidenceAdministration(input: {
+    runtimeStore: RuntimeStore;
+    emit: RuntimeEmit;
+}): {
+    recordVerificationHookResult(result: RuntimeVerificationHookResultInput): boolean;
+    recordContextOffload(offload: RuntimeContextOffloadInput): boolean;
+    recordContextCompaction(compaction: RuntimeContextCompactionInput): boolean;
+};

package/packages/core/dist/runtime/improvement/evidence-admin.js

@@ -0,0 +1 @@
+export function createRuntimeEvidenceAdministration(e){return{recordVerificationHookResult(t){const r=e.runtimeStore.getRun(t.requestId);return!!r&&(e.emit({type:"runtime.verification.hook.completed",requestId:r.requestId,sessionId:r.sessionId,agentId:r.agentId,hookId:t.hookId,status:t.status,evidence:t.evidence}),!0)},recordContextOffload(t){const r=e.runtimeStore.getRun(t.requestId);return!!r&&(e.emit({type:"runtime.context.offloaded",requestId:r.requestId,sessionId:r.sessionId,agentId:r.agentId,artifact:{id:t.artifactId,kind:t.kind,uri:t.uri,metadata:t.metadata},retainedPreview:t.retainedPreview}),!0)},recordContextCompaction(t){const r=e.runtimeStore.getRun(t.requestId);return!!r&&(e.emit({type:"runtime.context.compacted",requestId:r.requestId,sessionId:r.sessionId,agentId:r.agentId,summary:t.summary,artifact:t.artifactId?{id:t.artifactId,kind:t.kind??"context-compaction",uri:t.uri,metadata:t.metadata}:void 0}),!0)}}}

package/packages/core/dist/runtime/improvement/store.d.ts

@@ -0,0 +1,2 @@
+import type { RuntimeImprovementProposal, RuntimeImprovementStore } from "./types.js";
+export declare function createInMemoryRuntimeImprovementStore(initial?: RuntimeImprovementProposal[]): RuntimeImprovementStore;

package/packages/core/dist/runtime/improvement/store.js

@@ -0,0 +1 @@
+import{randomUUID as t}from"node:crypto";export function createInMemoryRuntimeImprovementStore(e=[]){const o=new Map(e.map(t=>[t.id,cloneProposal(t)]));return{createProposal(e){const r=(new Date).toISOString(),n={...e,id:e.id??t(),status:e.status??"proposed",createdAt:e.createdAt??r,updatedAt:e.updatedAt??r};return o.set(n.id,cloneProposal(n)),cloneProposal(n)},listProposals:t=>[...o.values()].filter(e=>function matchesFilter(t,e){return!e||!(e.status&&e.status!==t.status||e.target&&e.target!==t.target||e.owner&&e.owner!==t.owner||e.requestId&&e.requestId!==t.requestId||e.sessionId&&e.sessionId!==t.sessionId||e.agentId&&e.agentId!==t.agentId)}(e,t)).map(cloneProposal),getProposal(t){const e=o.get(t);return e?cloneProposal(e):void 0},updateProposal(t,e){const r=o.get(t);if(r)return Object.assign(r,function clonePatch(t){return structuredClone(t)}(e),{updatedAt:(new Date).toISOString()}),cloneProposal(r)}}}function cloneProposal(t){return structuredClone(t)}