stable-harness 0.0.3 → 0.0.5

package/packages/core/dist/runtime.js

@@ -1 +1 @@
-import{randomUUID as e}from"node:crypto";import{assertExecutionContract as t}from"./execution-contract.js";import{projectRequestInspection as s,projectRequestSummary as r,projectSessionSummaries as o}from"./runtime/persistence/inspection.js";import{recallMemoryPlugins as a,runMemoryPlugins as n}from"./memory-plugins.js";import{assertNoRawToolCallOutput as i,buildAdapterErrorRecoveryPrompt as u,buildResultRecoveryRequest as d,containsRawToolCallOutput as l,isRecoverableAdapterError as c,rawToolCallFailureMessage as p,toolCallRecoveryEnabled as m}from"./recovery/tool-call.js";import{completeRun as w,failRun as I}from"./runtime/completion.js";import{runDirectToolCall as g}from"./runtime/direct-tool-call.js";import{emitMemoryLifecycle as q,runMemoryRecall as f,submitMemoryCandidates as k}from"./runtime/memory.js";import{createInMemoryRuntimeStore as y}from"./runtime/persistence/stores.js";import{runWorkflowRequest as R}from"./workflows/runtime.js";export function createStableHarnessRuntime(b){const C=new Set,j=b.store??y(),S=e=>{j.appendEvent(e);for(const t of C)t(e)};return{request:async s=>async function(s){const{agent:r,adapter:o}=function(e,t){const s=t.agentId??e.workspace.runtime.defaultAgentId,r=e.workspace.agents.get(s);if(!r)throw new Error(`Agent ${s} is not defined in the workspace`);if(t.toolCall||t.workflow)return{agent:r,adapter:void 0};const o=e.adapters.find(e=>e.canRun(r));if(!o)throw new Error(`No runtime adapter can run backend ${r.backend} for agent ${r.id}`);return{agent:r,adapter:o}}(s.input,s.request),y=s.request.requestId??e(),b=s.request.sessionId??e();s.store.createRun(function(e,t,s,r){return{requestId:t,sessionId:s,agentId:r.id,input:e.input,state:"running",parentRunId:e.parentRunId,metadata:e.metadata,artifacts:[],startedAt:(new Date).toISOString(),events:[]}}(s.request,y,b,r)),s.emit({type:"request.started",requestId:y,sessionId:b,agentId:r.id});try{if(s.request.workflow){const e=await R({workspace:s.input.workspace,adapters:s.input.workflowAdapters??[],toolGateway:s.input.toolGateway,request:{input:s.request.input,...s.request.workflow},requestId:y,sessionId:b,agentId:r.id,emit:s.emit});return w({store:s.store,emit:s.emit,requestId:y,sessionId:b,agent:r,result:e})}if(s.request.toolCall){const e=await g({gateway:s.input.toolGateway,workspace:s.input.workspace,emit:s.emit,request:s.request,requestId:y,sessionId:b,agent:r});return w({store:s.store,emit:s.emit,requestId:y,sessionId:b,agent:r,result:e})}return await async function(e){if(!e.adapter)throw new Error(`No runtime adapter can run backend ${e.agent.backend} for agent ${e.agent.id}`);const s=e.adapter,r=await f({memory:e.input.memory,emit:e.emit,request:e.request,requestId:e.requestId,sessionId:e.sessionId,agent:e.agent,workspace:e.input.workspace}),o=await a({providers:e.input.memoryProviders,request:e.request,agent:e.agent,workspace:e.input.workspace}),I=e.input.workspace.runtime;let g;try{g=await v(e,s,e.request,r,o)}catch(t){if(!c(t,I))throw t;g=await v(e,s,u(e.request,t,I),r,o)}const y=d({request:e.request,output:g.text,events:e.store.getRun(e.requestId)?.events??[],policy:I});if(y){g=await v(e,s,y,r,o);const t=d({request:y,output:g.text,events:[],policy:I});t&&(g=await v(e,s,t,r,o))}var R;m(I)&&(l(g.text,I)&&(R=e.request.metadata,"message"===("object"!=typeof R?.toolCallRecovery||null===R.toolCallRecovery||Array.isArray(R.toolCallRecovery)?{}:R.toolCallRecovery).onFailure)&&(g={...g,text:p(),metadata:{...g.metadata,toolCallRecovery:{failed:!0,reason:"raw_tool_call_output"}}}),i(g.text,I)),q(e.input.memory,e.emit,e.requestId,e.sessionId,e.agent.id,"read-before-finalize"),await k({memory:e.input.memory,approvals:e.input.approvals,emit:e.emit,request:e.request,requestId:e.requestId,sessionId:e.sessionId,agent:e.agent,workspace:e.input.workspace}),t({store:e.store,emit:e.emit,requestId:e.requestId,sessionId:e.sessionId,agent:e.agent,metadata:e.request.metadata});const b=w({store:e.store,emit:e.emit,requestId:e.requestId,sessionId:e.sessionId,agent:e.agent,result:g});return await n({providers:e.input.memoryProviders,emit:e.emit,request:e.request,requestId:e.requestId,sessionId:e.sessionId,agent:e.agent,workspace:e.input.workspace,result:g}),b}({...s,adapter:o,requestId:y,sessionId:b,agent:r})}catch(e){return I({store:s.store,emit:s.emit,requestId:y,sessionId:b,agent:r,error:e})}}({input:b,store:j,emit:S,request:s}),subscribe:e=>(C.add(e),()=>C.delete(e)),inspect:()=>({workspaceRoot:b.workspace.root,agents:[...b.workspace.agents.keys()].sort(),workflows:[...b.workspace.workflows.keys()].sort(),...b.workspace.runtime.workflowRouting?.defaultWorkflowId?{defaultWorkflowId:b.workspace.runtime.workflowRouting.defaultWorkflowId}:{},workflowRoutes:(b.workspace.runtime.workflowRouting?.routes??[]).map(e=>e.id).sort(),models:[...b.workspace.models.keys()].sort(),tools:[...b.workspace.tools.keys()].sort(),runs:j.listRuns()}),getRuntimePolicy:()=>b.workspace.runtime,getWorkflow:e=>b.workspace.workflows.get(e),getRun:e=>j.getRun(e),listRequests:e=>j.listRuns(e).map(r),listSessions:()=>o(j.listRuns()),inspectRequest(e){const t=j.getRun(e);return t?s(b.workspace,t):void 0},cancel(e,t){const s=j.getRun(e);s&&"running"===s.state&&(j.updateRun(e,{state:"cancelled",completedAt:(new Date).toISOString()}),S({type:"request.cancelled",requestId:e,sessionId:s.sessionId,agentId:s.agentId,reason:t}))},async stop(){C.clear()}}}async function v(e,t,s,r,o){return"string"==typeof(a=await t.run({workspace:e.input.workspace,agent:e.agent,request:s,requestId:e.requestId,sessionId:e.sessionId,memory:r,pluginMemories:o,toolGateway:e.input.toolGateway,emit:e.emit}))?{text:a}:a;var a}
+import{randomUUID as e}from"node:crypto";import{assertExecutionContract as t}from"./execution-contract.js";import{projectRequestInspection as r,projectRequestSummary as s,projectSessionSummaries as o}from"./runtime/persistence/inspection.js";import{recallMemoryPlugins as a,runMemoryPlugins as n}from"./memory-plugins.js";import{assertNoRawToolCallOutput as i,assertNoToolExecutionErrorOutput as u,buildAdapterErrorRecoveryPrompt as c,buildEvidenceSynthesisOutput as l,buildExecutionContractRecoveryRequest as p,buildResultRecoveryRequest as d,containsRawToolCallOutput as m,isRecoverableAdapterError as w,rawToolCallFailureMessage as f,toolCallRecoveryEnabled as y}from"./recovery/tool-call.js";import{completeRun as g,failRun as q}from"./runtime/completion.js";import{runDirectToolCall as I}from"./runtime/direct-tool-call.js";import{emitMemoryLifecycle as k,runMemoryRecall as R,submitMemoryCandidates as v}from"./runtime/memory.js";import{createInMemoryRuntimeStore as A}from"./runtime/persistence/stores.js";import{createProgressNarrationEvent as b,resolveProgressNarrator as C}from"./runtime/progress-narration.js";import{runWorkflowRequest as h}from"./workflows/runtime.js";export function createStableHarnessRuntime(t){const i=new Set,u=t.store??A(),l=C({options:t.progressNarration,policy:t.workspace.runtime}),emit=e=>{u.appendEvent(e);for(const t of i)t(e);!function tryEmitProgressNarration(e){try{const t=b({source:e.event,narrator:e.narrator,options:e.options,policy:e.policy});!function isPromiseLike(e){return"object"==typeof e&&null!==e&&"then"in e&&"function"==typeof e.then}(t)?t&&e.emitNarration(t):t.then(t=>{t&&e.emitNarration(t)}).catch(()=>{})}catch{return}}({event:e,narrator:l,options:t.progressNarration,policy:t.workspace.runtime,emitNarration:e=>{u.appendEvent(e);for(const t of i)t(e)}})};return{request:async r=>async function runRuntimeRequest(t){const{agent:r,adapter:s}=function resolveExecution(e,t){const r=t.agentId??e.workspace.runtime.defaultAgentId,s=e.workspace.agents.get(r);if(!s)throw new Error(`Agent ${r} is not defined in the workspace`);if(t.toolCall||t.workflow)return{agent:s,adapter:void 0};const o=e.adapters.find(e=>e.canRun(s));if(!o)throw new Error(`No runtime adapter can run backend ${s.backend} for agent ${s.id}`);return{agent:s,adapter:o}}(t.input,t.request),o=t.request.requestId??e(),i=t.request.sessionId??e();t.store.createRun(function createRunRecord(e,t,r,s){return{requestId:t,sessionId:r,agentId:s.id,input:e.input,state:"running",parentRunId:e.parentRunId,metadata:e.metadata,artifacts:[],startedAt:(new Date).toISOString(),events:[]}}(t.request,o,i,r)),t.emit({type:"runtime.request.started",requestId:o,sessionId:i,agentId:r.id,input:t.request.input});try{if(t.request.workflow){const e=await h({workspace:t.input.workspace,adapters:t.input.workflowAdapters??[],toolGateway:t.input.toolGateway,request:{input:t.request.input,...t.request.workflow},requestId:o,sessionId:i,agentId:r.id,emit:t.emit});return g({store:t.store,emit:t.emit,requestId:o,sessionId:i,agent:r,result:e})}if(t.request.toolCall){const e=await I({gateway:t.input.toolGateway,workspace:t.input.workspace,emit:t.emit,request:t.request,requestId:o,sessionId:i,agent:r});return g({store:t.store,emit:t.emit,requestId:o,sessionId:i,agent:r,result:e})}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,r=await R({memory:e.input.memory,emit:e.emit,request:e.request,requestId:e.requestId,sessionId:e.sessionId,agent:e.agent,workspace:e.input.workspace}),s=await a({providers:e.input.memoryProviders,request:e.request,agent:e.agent,workspace:e.input.workspace}),o=e.input.workspace.runtime,i=new Map;let u;try{u=await runAdapterOnce(e,t,e.request,r,s,i)}catch(a){if(!w(a,o))throw a;u=await runAdapterOnce(e,t,c(e.request,a,o),r,s,i)}u=await recoverAdapterResultOutput(e,t,e.request,u,r,s,o,i),k(e.input.memory,e.emit,e.requestId,e.sessionId,e.agent.id,"read-before-finalize"),await v({memory:e.input.memory,approvals:e.input.approvals,emit:e.emit,request:e.request,requestId:e.requestId,sessionId:e.sessionId,agent:e.agent,workspace:e.input.workspace});try{assertRequestExecutionContract(e)}catch(a){const n=p({request:e.request,events:e.store.getRun(e.requestId)?.events??[],policy:o});if(!n)throw a;u=await runAdapterOnce(e,t,n,r,s,i),u=await recoverAdapterResultOutput(e,t,n,u,r,s,o,i),assertRequestExecutionContract(e)}const l=g({store:e.store,emit:e.emit,requestId:e.requestId,sessionId:e.sessionId,agent:e.agent,result:u});return await n({providers:e.input.memoryProviders,emit:e.emit,request:e.request,requestId:e.requestId,sessionId:e.sessionId,agent:e.agent,workspace:e.input.workspace,result:u}),l}({...t,adapter:s,requestId:o,sessionId:i,agent:r})}catch(e){return q({store:t.store,emit:t.emit,requestId:o,sessionId:i,agent:r,error:e})}}({input:t,store:u,emit:emit,request:r}),subscribe:e=>(i.add(e),()=>i.delete(e)),inspect(){return{workspaceRoot:t.workspace.root,agents:[...t.workspace.agents.keys()].sort(),workflows:[...t.workspace.workflows.keys()].sort(),...t.workspace.runtime.specDrivenWorkflow?{specDrivenWorkflow:(e=t.workspace.runtime.specDrivenWorkflow,{enabled:e.enabled,artifactsDir:e.artifactsDir,...e.constitution?{constitution:e.constitution}:{},phases:e.phases.map(e=>e.id)})}:{},evaluations:[...t.workspace.evaluations?.keys()??[]].sort(),...t.workspace.runtime.workflowRouting?.defaultWorkflowId?{defaultWorkflowId:t.workspace.runtime.workflowRouting.defaultWorkflowId}:{},workflowRoutes:(t.workspace.runtime.workflowRouting?.routes??[]).map(e=>e.id).sort(),models:[...t.workspace.models.keys()].sort(),tools:[...t.workspace.tools.keys()].sort(),runs:u.listRuns()};var e},getRuntimePolicy:()=>t.workspace.runtime,getWorkflow:e=>t.workspace.workflows.get(e),getRun:e=>u.getRun(e),listRequests:e=>u.listRuns(e).map(s),listSessions:()=>o(u.listRuns()),inspectRequest(e){const s=u.getRun(e);return s?r(t.workspace,s):void 0},cancel(e,t){const r=u.getRun(e);r&&"running"===r.state&&(u.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(){i.clear()}}}async function recoverAdapterResultOutput(e,t,r,s,o,a,n,c){let p=r;const w=function resultRecoveryAttempts(e){const t="object"!=typeof e||null===e||Array.isArray(e)?void 0:e.recovery,r="object"!=typeof t||null===t||Array.isArray(t)?void 0:t.toolCall,s="object"!=typeof r||null===r||Array.isArray(r)?void 0:r.maxResultRecoveryAttempts;return"number"==typeof s&&Number.isInteger(s)&&s>0?s:3}(n);let g=0;for(let r=0;r<w;r+=1){const r=e.store.getRun(e.requestId)?.events??[],i=d({request:p,output:s.text,events:r.slice(g),availableToolIds:e.agent.tools,policy:n});if(!i)break;p=i,g=e.store.getRun(e.requestId)?.events.length??0,s=await runAdapterOnce(e,t,i,o,a,c)}if(y(n)){let t=!1;m(s.text,n)&&function rawToolCallFailureReturnsMessage(e){return"message"===("object"!=typeof e?.toolCallRecovery||null===e.toolCallRecovery||Array.isArray(e.toolCallRecovery)?{}:e.toolCallRecovery).onFailure}(r.metadata)&&(s={...s,text:f(),metadata:{...s.metadata,toolCallRecovery:{failed:!0,reason:"raw_tool_call_output"}}});const o=l({request:r,output:s.text,events:e.store.getRun(e.requestId)?.events??[],policy:n});o&&(t=!0,s={...s,text:o,metadata:{...s.metadata,toolCallRecovery:{synthesized:!0,reason:"raw_tool_call_output_with_evidence"}}}),t||(i(s.text,n),u(s.text,n))}return s}function assertRequestExecutionContract(e){t({store:e.store,emit:e.emit,requestId:e.requestId,sessionId:e.sessionId,agent:e.agent,metadata:e.request.metadata})}async function runAdapterOnce(e,t,r,s,o,a){return function normalizeAdapterResult(e){return"string"==typeof e?{text:e}:e}(await t.run({workspace:e.input.workspace,agent:e.agent,request:r,requestId:e.requestId,sessionId:e.sessionId,memory:s,pluginMemories:o,toolGateway:e.input.toolGateway,requestState:a,emit:e.emit}))}

package/packages/core/dist/spec-driven/config.d.ts

@@ -0,0 +1,4 @@
+import type { WorkspaceSpecDrivenPhase, WorkspaceSpecDrivenWorkflowPolicy } from "./types.js";
+export declare const DEFAULT_SPEC_DRIVEN_PHASES: WorkspaceSpecDrivenPhase[];
+export declare function createSpecDrivenWorkflowPolicy(input?: Partial<WorkspaceSpecDrivenWorkflowPolicy>): WorkspaceSpecDrivenWorkflowPolicy;
+export declare function assertSpecDrivenWorkflowPolicy(policy: WorkspaceSpecDrivenWorkflowPolicy): void;

package/packages/core/dist/spec-driven/config.js

@@ -0,0 +1 @@
+export const DEFAULT_SPEC_DRIVEN_PHASES=[{id:"constitution",artifactKind:"constitution",required:!0},{id:"specify",artifactKind:"spec",required:!0},{id:"plan",artifactKind:"plan",required:!0},{id:"contracts",artifactKind:"contract"},{id:"research",artifactKind:"research"},{id:"tasks",artifactKind:"tasks",required:!0},{id:"implement",artifactKind:"execution"},{id:"verify",artifactKind:"evidence",required:!0}];export function createSpecDrivenWorkflowPolicy(i){return{enabled:i?.enabled??!1,...i?.constitution?{constitution:i.constitution}:{},artifactsDir:i?.artifactsDir??"specs",phases:(t=i?.phases,(t&&t.length>0?t:DEFAULT_SPEC_DRIVEN_PHASES).map(i=>({id:i.id,...i.artifactKind?{artifactKind:i.artifactKind}:{},...void 0!==i.required?{required:i.required}:{},...i.gate?{gate:i.gate}:{},...i.config?{config:i.config}:{}}))),...i?.gates?{gates:i.gates}:{},...i?.config?{config:i.config}:{}};var t}export function assertSpecDrivenWorkflowPolicy(i){const t=new Set;for(const e of i.phases){if(!e.id.trim())throw new Error("specDrivenWorkflow phases require non-empty id");if(t.has(e.id))throw new Error(`specDrivenWorkflow phase is duplicated: ${e.id}`);t.add(e.id)}}

package/packages/core/dist/spec-driven/events.d.ts

@@ -0,0 +1,11 @@
+import type { RuntimeEvent } from "../runtime/events.js";
+import type { RuntimeArtifact } from "../runtime/types.js";
+import type { SpecDrivenPhaseTransition } from "./types.js";
+export type SpecDrivenEventContext = {
+    requestId: string;
+    sessionId: string;
+    agentId: string;
+    workflowId?: string;
+};
+export declare function createSpecDrivenPhaseEvent(context: SpecDrivenEventContext, transition: SpecDrivenPhaseTransition): RuntimeEvent;
+export declare function createSpecDrivenArtifactEvent(context: SpecDrivenEventContext, phaseId: string, artifact: RuntimeArtifact): RuntimeEvent;

package/packages/core/dist/spec-driven/events.js

@@ -0,0 +1 @@
+export function createSpecDrivenPhaseEvent(e,t){const r={requestId:e.requestId,sessionId:e.sessionId,agentId:e.agentId,phaseId:t.phaseId,...e.workflowId?{workflowId:e.workflowId}:{}};return"started"===t.status?{type:"runtime.specDriven.phase.started",...r}:"completed"===t.status?{type:"runtime.specDriven.phase.completed",...r,artifact:t.artifact}:"verified"===t.status?{type:"runtime.specDriven.phase.verified",...r,artifact:t.artifact}:{type:"runtime.specDriven.phase.blocked",...r,reason:t.reason??"unspecified"}}export function createSpecDrivenArtifactEvent(e,t,r){return{type:"runtime.artifact.created",requestId:e.requestId,sessionId:e.sessionId,agentId:e.agentId,artifact:{...r,metadata:{...r.metadata,phaseId:t,workflowKind:"spec-driven"}}}}

package/packages/core/dist/spec-driven/index.d.ts

@@ -0,0 +1,4 @@
+export * from "./config.js";
+export * from "./events.js";
+export * from "./lifecycle.js";
+export * from "./types.js";

package/packages/core/dist/spec-driven/index.js

@@ -0,0 +1 @@
+export*from"./config.js";export*from"./events.js";export*from"./lifecycle.js";export*from"./types.js";

package/packages/core/dist/spec-driven/lifecycle.d.ts

@@ -0,0 +1,11 @@
+import type { RuntimeArtifact } from "../runtime/types.js";
+import type { SpecDrivenPhaseTransition, SpecDrivenWorkflowState, WorkspaceSpecDrivenWorkflowPolicy } from "./types.js";
+export declare function createSpecDrivenWorkflowState(policy: WorkspaceSpecDrivenWorkflowPolicy): SpecDrivenWorkflowState;
+export declare function applySpecDrivenPhaseTransition(state: SpecDrivenWorkflowState, transition: SpecDrivenPhaseTransition): SpecDrivenWorkflowState;
+export declare function createSpecDrivenArtifact(input: {
+    id: string;
+    phaseId: string;
+    artifactKind: string;
+    uri?: string;
+    metadata?: Record<string, unknown>;
+}): RuntimeArtifact;

package/packages/core/dist/spec-driven/lifecycle.js

@@ -0,0 +1 @@
+export function createSpecDrivenWorkflowState(t){return{enabled:t.enabled,artifactsDir:t.artifactsDir,...t.constitution?{constitution:t.constitution}:{},phases:t.phases.map(t=>({id:t.id,status:"pending",updatedAt:new Date(0).toISOString()}))}}export function applySpecDrivenPhaseTransition(t,a){if(!new Set(t.phases.map(t=>t.id)).has(a.phaseId))throw new Error(`Spec-driven workflow phase is not configured: ${a.phaseId}`);return{...t,phases:t.phases.map(t=>function updatePhase(t,a){return t.id!==a.phaseId?t:{id:t.id,status:a.status,...a.artifact?{artifact:a.artifact}:t.artifact?{artifact:t.artifact}:{},...a.reason?{reason:a.reason}:{},updatedAt:a.timestamp??(new Date).toISOString()}}(t,a))}}export function createSpecDrivenArtifact(t){return{id:t.id,kind:`spec-driven.${t.artifactKind}`,...t.uri?{uri:t.uri}:{},metadata:{phaseId:t.phaseId,...t.metadata}}}

package/packages/core/dist/spec-driven/types.d.ts

@@ -0,0 +1,38 @@
+import type { RuntimeArtifact } from "../runtime/types.js";
+export type SpecDrivenPhaseId = string;
+export type SpecDrivenPhaseStatus = "pending" | "started" | "blocked" | "completed" | "verified";
+export type WorkspaceSpecDrivenPhase = {
+    id: string;
+    artifactKind?: string;
+    required?: boolean;
+    gate?: string;
+    config?: Record<string, unknown>;
+};
+export type WorkspaceSpecDrivenWorkflowPolicy = {
+    enabled: boolean;
+    constitution?: string;
+    artifactsDir: string;
+    phases: WorkspaceSpecDrivenPhase[];
+    gates?: Record<string, unknown>;
+    config?: Record<string, unknown>;
+};
+export type SpecDrivenPhaseRecord = {
+    id: string;
+    status: SpecDrivenPhaseStatus;
+    artifact?: RuntimeArtifact;
+    reason?: string;
+    updatedAt: string;
+};
+export type SpecDrivenWorkflowState = {
+    enabled: boolean;
+    artifactsDir: string;
+    constitution?: string;
+    phases: SpecDrivenPhaseRecord[];
+};
+export type SpecDrivenPhaseTransition = {
+    phaseId: string;
+    status: Exclude<SpecDrivenPhaseStatus, "pending">;
+    artifact?: RuntimeArtifact;
+    reason?: string;
+    timestamp?: string;
+};

package/packages/core/dist/spec-driven/types.js

@@ -0,0 +1 @@
+export{};

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

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

package/packages/core/dist/trace.js

@@ -1 +1 @@
-export function projectRuntimeTrace(t){return t.events.map(projectEvent).filter(o)}export function projectEvent(t){return"request.started"===t.type||"request.completed"===t.type||"request.failed"===t.type?r(t,"request",t.type):"request.cancelled"===t.type?r(t,"request",t.type,{reason:t.reason}):"execution.contract.failed"===t.type?r(t,"request",t.type,{reason:t.reason,missingEvidenceTools:t.missingEvidenceTools}):"tool.started"===t.type?r(t,"tool","tool.started",{toolId:t.toolId}):"tool.completed"===t.type?r(t,"tool","tool.completed",{toolId:t.toolId}):"adapter.event"===t.type?function(t){const e=t.event;if(n(e)&&"string"==typeof e.phase){const o=function(t,e){const o=function(t){const e=a(t);return"request"===e||"tool"===e||"adapter"===e||"memory"===e||"artifact"===e||"plan"===e||"delegation"===e?e:void 0}(e.traceType),n=a(e.traceLabel);if(o&&n)return r(t,o,n,e)}(t,e);return o||r(t,"adapter",`adapter.${e.phase}`,e)}return r(t,"adapter","adapter.event",{event:e})}(t):"artifact.created"===t.type?r(t,"artifact","artifact.created",{artifact:t.artifact}):t.type.startsWith("memory.")?r(t,"memory",t.type):void 0}export function readPlanTodos(r){const o=function(t){if(n(t))return t;if("string"==typeof t)try{const e=JSON.parse(t);return n(e)?e:void 0}catch{return}}(r),a=function(t){const e=n(t?.args)?t.args:void 0;return Array.isArray(t?.todos)?t.todos:Array.isArray(e?.todos)?e.todos:[]}(o);return a.map(t).filter(e)}function t(t){if(n(t)&&"string"==typeof t.content)return{content:t.content,status:"string"==typeof t.status?t.status:"pending"}}function e(t){return void 0!==t}function r(t,e,r,o){return{type:e,label:r,agentId:t.agentId,requestId:t.requestId,detail:o}}function o(t){return void 0!==t}function n(t){return"object"==typeof t&&null!==t&&!Array.isArray(t)}function a(t){return"string"==typeof t&&t.trim()?t:void 0}
+export function projectRuntimeTrace(e){return e.events.map(projectEvent).filter(isTraceEntry)}export function projectEvent(e){return"runtime.request.started"===e.type||"runtime.request.completed"===e.type||"runtime.request.failed"===e.type?base(e,"request",e.type):"runtime.request.cancelled"===e.type?base(e,"request",e.type,{reason:e.reason}):"runtime.execution.contract.failed"===e.type?base(e,"request",e.type,{reason:e.reason,missingEvidenceTools:e.missingEvidenceTools}):"runtime.tool.direct.started"===e.type?base(e,"tool","runtime.tool.direct.started",{toolId:e.toolId}):"runtime.tool.direct.completed"===e.type?base(e,"tool","runtime.tool.direct.completed",{toolId:e.toolId}):"runtime.workflow.started"===e.type||"runtime.workflow.completed"===e.type?base(e,"workflow",e.type,{workflowId:e.workflowId,adapter:e.adapter}):function isSpecDrivenPhaseEvent(e){return e.type.startsWith("runtime.specDriven.phase.")}(e)?base(e,"spec",e.type,{phaseId:e.phaseId,..."workflowId"in e&&e.workflowId?{workflowId:e.workflowId}:{},..."reason"in e?{reason:e.reason}:{},..."artifact"in e&&e.artifact?{artifact:e.artifact}:{}}):"runtime.adapter.event"===e.type?function adapterTrace(e){const t=e.event;if(isRecord(t)&&"string"==typeof t.phase){const r=function semanticAdapterTrace(e,t){const r=function readTraceType(e){const t=readString(e);return"request"===t||"tool"===t||"workflow"===t||"spec"===t||"adapter"===t||"memory"===t||"artifact"===t||"progress"===t||"plan"===t||"delegation"===t?t:void 0}(t.traceType),o=readString(t.traceLabel);if(r&&o)return base(e,r,o,t)}(e,t);return r||base(e,"adapter",t.phase.startsWith("agent.")?t.phase:`adapter.${t.phase}`,t)}return base(e,"adapter","runtime.adapter.event",{event:t})}(e):"runtime.artifact.created"===e.type?base(e,"artifact","runtime.artifact.created",{artifact:e.artifact}):e.type.startsWith("runtime.memory.")?base(e,"memory",e.type):"runtime.progress.narration"===e.type?base(e,"progress",e.type,{message:e.message,provider:e.provider,sourceEventTypes:e.sourceEventTypes}):void 0}export function readPlanTodos(e){const t=function readPlanRecord(e){if(isRecord(e))return e;if("string"==typeof e)try{const t=JSON.parse(e);return isRecord(t)?t:void 0}catch{return}}(e),r=function readTodosArray(e){const t=isRecord(e?.args)?e.args:void 0;return Array.isArray(e?.todos)?e.todos:Array.isArray(t?.todos)?t.todos:[]}(t);return r.map(readTodo).filter(isPlanTodoItem)}function readTodo(e){if(isRecord(e)&&"string"==typeof e.content)return{content:e.content,status:"string"==typeof e.status?e.status:"pending"}}function isPlanTodoItem(e){return void 0!==e}function base(e,t,r,o){return{type:t,label:r,agentId:e.agentId,requestId:e.requestId,detail:o}}function isTraceEntry(e){return void 0!==e}function isRecord(e){return"object"==typeof e&&null!==e&&!Array.isArray(e)}function readString(e){return"string"==typeof e&&e.trim()?e:void 0}

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

@@ -1,14 +1,18 @@
 import type { MemoryProvider, MemoryRecord, RuntimeMemoryStore } from "@stable-harness/memory";
 import type { ApprovalQueue } from "@stable-harness/governance";
 import type { RuntimeWorkflowAdapter, RuntimeWorkflowRequest, WorkspaceWorkflow } from "./workflows/index.js";
+import type { SpecDrivenWorkflowState } from "./spec-driven/index.js";
 import type { RuntimeEvent, RuntimeEventListener, RuntimeEmit } from "./runtime/events.js";
 import type { RuntimeArtifact, RuntimeOutput, RuntimeRecordState, RuntimeRequest, RuntimeResponse, 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 { RuntimeProgressNarrationOptions, RuntimeProgressNarrationProvider } from "./runtime/progress-narration.js";
 export type { RuntimeArtifact, RuntimeArtifactFilter, RuntimeArtifactInput, RuntimeArtifactRecord, RuntimeArtifactStore, RuntimeCancelIntentInput, RuntimeHeartbeatInput, RuntimeMemoryCandidateInput, RuntimeOutput, RuntimeQueueClaimInput, RuntimeQueueRecord, RuntimeQueueStore, RuntimeRecoveryIntent, RuntimeRecordState, RuntimeRequest, RuntimeRequestControlRecord, RuntimeRequestMemory, RuntimeResponse, RuntimeRunFilter, RuntimeRunRecord, RuntimeStore, RuntimeStoreRunPatch, RuntimeStuckRequestInput, } from "./runtime/types.js";
 export type { CompiledWorkspace, WorkspaceAdapterPolicy, WorkspaceAgent, WorkspaceMemory, WorkspaceModel, WorkspaceRetryPolicy, WorkspaceRetryReason, WorkspaceRetryTargetPolicy, WorkspaceRuntimePolicy, WorkspaceSkill, WorkspaceTool, WorkspaceToolRetryPolicy, } from "./workspace/types.js";
-export type { RuntimeToolCallRequest, RuntimeToolGateway, RuntimeToolGatewayContext, RuntimeToolGatewayTool, } from "./runtime/tool-gateway.js";
+export type { WorkspaceEvaluation, WorkspaceEvaluationCase, } from "./evaluations/index.js";
+export type { SpecDrivenPhaseId, SpecDrivenPhaseRecord, SpecDrivenPhaseStatus, SpecDrivenPhaseTransition, SpecDrivenWorkflowState, WorkspaceSpecDrivenPhase, WorkspaceSpecDrivenWorkflowPolicy, } from "./spec-driven/index.js";
+export type { RuntimeToolCallRequest, RuntimeToolGateway, RuntimeToolGatewayContext, RuntimeToolRepairModel, RuntimeToolGatewayTool, } from "./runtime/tool-gateway.js";
 export type RuntimeAdapterContext = {
     workspace: CompiledWorkspace;
     agent: WorkspaceAgent;
@@ -18,6 +22,7 @@ export type RuntimeAdapterContext = {
     memory?: RuntimeMemoryContext;
     pluginMemories?: RuntimeMemoryContext[];
     toolGateway?: RuntimeToolGateway;
+    requestState?: Map<string, unknown>;
     emit: RuntimeEmit;
 };
 export type RuntimeMemoryContext = {
@@ -46,12 +51,20 @@ export type RuntimeInspectionSnapshot = {
     workspaceRoot: string;
     agents: string[];
     workflows: string[];
+    specDrivenWorkflow?: RuntimeSpecDrivenWorkflowInspection;
+    evaluations: string[];
     defaultWorkflowId?: string;
     workflowRoutes: string[];
     models: string[];
     tools: string[];
     runs: RuntimeRunRecord[];
 };
+export type RuntimeSpecDrivenWorkflowInspection = {
+    enabled: boolean;
+    artifactsDir: string;
+    constitution?: string;
+    phases: string[];
+};
 export type RuntimeRequestSummary = {
     requestId: string;
     sessionId: string;
@@ -93,6 +106,7 @@ export type RuntimeRequestInspection = {
     metadata?: Record<string, unknown>;
     artifacts: RuntimeArtifact[];
     runtimeSnapshot: RuntimeBindingSnapshot;
+    specDrivenWorkflow?: SpecDrivenWorkflowState;
     timeline: RuntimeTimelineItem[];
 };
 export type RuntimeClient = {

package/packages/core/dist/workflows/index.js

@@ -1 +1 @@
-export function compileWorkflowPlan(n){const e=n.entry??n.nodes[0]?.id;if(!e)throw new Error(`Workflow ${n.id} has no entry node`);const o=function(n){const e=new Map(n.nodes.map(n=>[n.id,[]]));for(const o of n.edges)e.get(o.from)?.push(o.to);return e}(n),r=function(n,e){const o=new Set,t=[n];for(;t.length>0;){const n=t.pop();o.has(n)||(o.add(n),t.push(...e.get(n)??[]))}return o}(e,o),i=function(n,e){const o=[];for(const r of n)t(r,r,e,[],o);return function(n){const e=new Set;return n.filter(n=>{const o=function(n){const e=n.slice(0,-1);return e.map((n,o)=>[...e.slice(o),...e.slice(0,o)].join("|")).sort()[0]??""}(n);return!e.has(o)&&(e.add(o),!0)})}(o)}(n.nodes.map(n=>n.id),o);return{workflowId:n.id,...n.adapter?{adapter:n.adapter}:{},entry:e,nodes:n.nodes,edges:n.edges,terminalNodes:n.nodes.map(n=>n.id).filter(n=>0===(o.get(n)??[]).length),unreachableNodes:n.nodes.map(n=>n.id).filter(n=>!r.has(n)),cycles:i}}export function renderWorkflowMermaid(n){const e=["flowchart TD"];for(const o of n.nodes)e.push(`  ${r(o.id)}["${i(`${o.id}\\n${o.use}`)}"]`);for(const o of n.edges){const n=o.condition?`|${i(o.condition)}|`:"";e.push(`  ${r(o.from)} --\x3e${n} ${r(o.to)}`)}return e.join("\n")}export function renderAgentMermaid(t,d){const a=t.agents.get(d);if(!a)throw new Error(`Agent is not defined: ${d}`);const s=function(e){return[...e.subagents.map(e=>n("agent",e)),...(e.skills??[]).map(e=>n("skill",e)),...e.tools.map(e=>n("tool",e))]}(a),c=["flowchart TD",`  START_${r(a.id)}([START])`,`  END_${r(a.id)}([END])`];for(const n of s)c.push(`  ${n.diagramId}["${i(`${n.id}\\n${n.label}`)}"]`);return 0===s.length?(c.push(`  START_${r(a.id)} --\x3e END_${r(a.id)}`),c.join("\n")):[...c,...a.edges?.length?e(a,s):o(a,s)].join("\n")}function n(n,e){return{id:e,diagramId:`${n}_${r(e)}`,label:`${n}: ${e}`}}function e(n,e){const o=new Map(e.map(n=>[n.id,n.diagramId])),t=new Set((n.edges??[]).map(n=>n.to)),d=new Set((n.edges??[]).map(n=>n.from)),a=e.filter(n=>!t.has(n.id)).map(n=>n.diagramId),s=e.filter(n=>!d.has(n.id)).map(n=>n.diagramId);return[...a.map(e=>`  START_${r(n.id)} --\x3e ${r(e)}`),...(n.edges??[]).flatMap(n=>function(n,e){const o=e.get(n.from),t=e.get(n.to);return o&&t?[`  ${o} --\x3e${n.condition?`|${i(n.condition)}|`:""} ${t}`]:[]}(n,o)),...s.map(e=>`  ${r(e)} --\x3e END_${r(n.id)}`)]}function o(n,e){return e.flatMap(e=>[`  START_${r(n.id)} -. available .-> ${e.diagramId}`,`  ${e.diagramId} -.-> END_${r(n.id)}`])}function t(n,e,o,r,i){const d=[...r,e];for(const a of o.get(e)??[])a===n?i.push([...d,n]):r.includes(a)||t(n,a,o,d,i)}function r(n){return n.replace(/[^A-Za-z0-9_]/gu,"_")}function i(n){return n.replace(/"/gu,'\\"')}
+export function compileWorkflowPlan(e){const n=e.entry??e.nodes[0]?.id;if(!n)throw new Error(`Workflow ${e.id} has no entry node`);const t=function buildAdjacency(e){const n=new Map(e.nodes.map(e=>[e.id,[]]));for(const t of e.edges)n.get(t.from)?.push(t.to);return n}(e),o=function collectReachable(e,n){const t=new Set,o=[e];for(;o.length>0;){const e=o.pop();t.has(e)||(t.add(e),o.push(...n.get(e)??[]))}return t}(n,t),a=function findCycles(e,n){const t=[];for(const o of e)collectCycles(o,o,n,[],t);return function dedupeCycles(e){const n=new Set;return e.filter(e=>{const t=function canonicalCycleKey(e){const n=e.slice(0,-1);return n.map((e,t)=>[...n.slice(t),...n.slice(0,t)].join("|")).sort()[0]??""}(e);return!n.has(t)&&(n.add(t),!0)})}(t)}(e.nodes.map(e=>e.id),t);return{workflowId:e.id,...e.adapter?{adapter:e.adapter}:{},entry:n,nodes:e.nodes,edges:e.edges,terminalNodes:e.nodes.map(e=>e.id).filter(e=>0===(t.get(e)??[]).length),unreachableNodes:e.nodes.map(e=>e.id).filter(e=>!o.has(e)),cycles:a}}export function renderWorkflowMermaid(e){const n=["flowchart TD"];for(const t of e.nodes)n.push(`  ${escapeId(t.id)}["${escapeLabel(`${t.id}\\n${t.use}`)}"]`);for(const t of e.edges){const e=t.condition?`|${escapeLabel(t.condition)}|`:"";n.push(`  ${escapeId(t.from)} --\x3e${e} ${escapeId(t.to)}`)}return n.join("\n")}export function renderAgentMermaid(e,n){const t=e.agents.get(n);if(!t)throw new Error(`Agent is not defined: ${n}`);const o=function agentGraphNodes(e){return[...e.subagents.map(e=>agentGraphNode("agent",e)),...(e.skills??[]).map(e=>agentGraphNode("skill",e)),...e.tools.map(e=>agentGraphNode("tool",e))]}(t),a=["flowchart TD",`  START_${escapeId(t.id)}([START])`,`  END_${escapeId(t.id)}([END])`];for(const e of o)a.push(`  ${e.diagramId}["${escapeLabel(`${e.id}\\n${e.label}`)}"]`);return 0===o.length?(a.push(`  START_${escapeId(t.id)} --\x3e END_${escapeId(t.id)}`),a.join("\n")):[...a,...t.edges?.length?explicitAgentMermaidEdges(t,o):inventoryAgentMermaidEdges(t,o)].join("\n")}function agentGraphNode(e,n){return{id:n,diagramId:`${e}_${escapeId(n)}`,label:`${e}: ${n}`}}function explicitAgentMermaidEdges(e,n){const t=new Map(n.map(e=>[e.id,e.diagramId])),o=new Set((e.edges??[]).map(e=>e.to)),a=new Set((e.edges??[]).map(e=>e.from)),d=n.filter(e=>!o.has(e.id)).map(e=>e.diagramId),r=n.filter(e=>!a.has(e.id)).map(e=>e.diagramId);return[...d.map(n=>`  START_${escapeId(e.id)} --\x3e ${escapeId(n)}`),...(e.edges??[]).flatMap(e=>function renderAgentEdge(e,n){const t=n.get(e.from),o=n.get(e.to);return t&&o?[`  ${t} --\x3e${e.condition?`|${escapeLabel(e.condition)}|`:""} ${o}`]:[]}(e,t)),...r.map(n=>`  ${escapeId(n)} --\x3e END_${escapeId(e.id)}`)]}function inventoryAgentMermaidEdges(e,n){return n.flatMap(n=>[`  START_${escapeId(e.id)} -. available .-> ${n.diagramId}`,`  ${n.diagramId} -.-> END_${escapeId(e.id)}`])}function collectCycles(e,n,t,o,a){const d=[...o,n];for(const r of t.get(n)??[])r===e?a.push([...d,e]):o.includes(r)||collectCycles(e,r,t,d,a)}function escapeId(e){return e.replace(/[^A-Za-z0-9_]/gu,"_")}function escapeLabel(e){return e.replace(/"/gu,'\\"')}

package/packages/core/dist/workflows/runtime.js

@@ -1 +1 @@
-export async function runWorkflowRequest(e){const o=function(e,o){const t=o.routeId?e.runtime.workflowRouting?.routes?.find(e=>e.id===o.routeId):void 0;if(o.routeId&&!t)throw new Error(`Workflow route is not defined: ${o.routeId}`);const r=o.workflowId??t?.workflowId??e.runtime.workflowRouting?.defaultWorkflowId;if(!r)throw new Error("Workflow request requires workflowId, routeId, or runtime.workflowRouting.defaultWorkflowId");const n=e.workflows.get(r);if(!n)throw new Error(`Workflow is not defined: ${r}`);return n}(e.workspace,e.request),t=function(e,o){const t=o?e.find(e=>e.name===o):e[0];if(!t)throw new Error("No workflow adapter is configured"+(o?` for ${o}`:""));return t}(e.adapters,o.adapter);e.emit({type:"adapter.event",requestId:e.requestId,sessionId:e.sessionId,agentId:e.agentId,event:{adapter:t.name,phase:"workflow.start",workflowId:o.id}});const r=await t.run({workspace:e.workspace,workflow:o,request:e.request,requestId:e.requestId,sessionId:e.sessionId,toolGateway:e.toolGateway,emit:o=>e.emit({type:"adapter.event",requestId:e.requestId,sessionId:e.sessionId,agentId:e.agentId,event:o})});return e.emit({type:"adapter.event",requestId:e.requestId,sessionId:e.sessionId,agentId:e.agentId,event:{adapter:t.name,phase:"workflow.complete",workflowId:o.id}}),"string"==typeof r?{text:r}:r}
+export async function runWorkflowRequest(e){const o=function resolveWorkflow(e,o){const r=o.routeId?e.runtime.workflowRouting?.routes?.find(e=>e.id===o.routeId):void 0;if(o.routeId&&!r)throw new Error(`Workflow route is not defined: ${o.routeId}`);const t=o.workflowId??r?.workflowId??e.runtime.workflowRouting?.defaultWorkflowId;if(!t)throw new Error("Workflow request requires workflowId, routeId, or runtime.workflowRouting.defaultWorkflowId");const n=e.workflows.get(t);if(!n)throw new Error(`Workflow is not defined: ${t}`);return n}(e.workspace,e.request),r=function resolveWorkflowAdapter(e,o){const r=o?e.find(e=>e.name===o):e[0];if(!r)throw new Error("No workflow adapter is configured"+(o?` for ${o}`:""));return r}(e.adapters,o.adapter);e.emit({type:"runtime.workflow.started",requestId:e.requestId,sessionId:e.sessionId,agentId:e.agentId,adapter:r.name,workflowId:o.id});const t=await r.run({workspace:e.workspace,workflow:o,request:e.request,requestId:e.requestId,sessionId:e.sessionId,toolGateway:e.toolGateway,emit:o=>e.emit({type:"runtime.adapter.event",requestId:e.requestId,sessionId:e.sessionId,agentId:e.agentId,event:o})});return e.emit({type:"runtime.workflow.completed",requestId:e.requestId,sessionId:e.sessionId,agentId:e.agentId,adapter:r.name,workflowId:o.id}),"string"==typeof t?{text:t}:t}

package/packages/core/dist/workspace/types.d.ts

@@ -1,3 +1,5 @@
+import type { WorkspaceEvaluation } from "../evaluations/index.js";
+import type { WorkspaceSpecDrivenWorkflowPolicy } from "../spec-driven/index.js";
 import type { WorkspaceWorkflow, WorkspaceWorkflowEdge, WorkspaceWorkflowRoutingPolicy } from "../workflows/index.js";
 export type WorkspaceModel = {
     id: string;
@@ -51,11 +53,17 @@ export type WorkspaceRuntimePolicy = {
     profile?: string;
     adapters?: WorkspaceAdapterPolicy[];
     workflowRouting?: WorkspaceWorkflowRoutingPolicy;
+    specDrivenWorkflow?: WorkspaceSpecDrivenWorkflowPolicy;
     approvals?: Record<string, unknown>;
     recovery?: Record<string, unknown>;
     retry?: WorkspaceRetryPolicy;
+    toolGateway?: Record<string, unknown>;
     memory?: Record<string, unknown>;
     protocols?: Record<string, unknown>;
+    progress?: Record<string, unknown>;
+    cli?: Record<string, unknown>;
+    responseLanguage?: Record<string, unknown>;
+    responsePresentation?: Record<string, unknown>;
 };
 export type WorkspaceAdapterPolicy = {
     name: string;
@@ -89,4 +97,5 @@ export type CompiledWorkspace = {
     skills: Map<string, WorkspaceSkill>;
     memories: Map<string, WorkspaceMemory>;
     workflows: Map<string, WorkspaceWorkflow>;
+    evaluations?: Map<string, WorkspaceEvaluation>;
 };

package/packages/governance/dist/src/skill-candidates.js

@@ -1 +1 @@
-import{randomUUID as e}from"node:crypto";import{mkdirSync as t}from"node:fs";import n from"node:path";import{DatabaseSync as r}from"node:sqlite";export function createSqliteSkillCandidateStore(c){t(n.dirname(c),{recursive:!0});const o=new r(c);return function(e){e.exec("\n    create table if not exists skill_candidates (\n      id text primary key, workspace_id text not null, name text not null,\n      status text not null, confidence real not null, evidence_count integer not null,\n      proposed_path text, title text not null, summary text not null,\n      draft_markdown text not null, created_at text not null, updated_at text not null,\n      reviewed_at text, reviewed_by text, rejection_reason text,\n      unique(workspace_id, name)\n    );\n    create table if not exists skill_candidate_evidence (\n      id text primary key, candidate_id text not null, evidence_type text not null,\n      evidence_ref text not null, summary text, weight real, created_at text not null,\n      foreign key(candidate_id) references skill_candidates(id)\n    );\n  ")}(o),{async upsert(t){const n=(new Date).toISOString(),r=function(e,t,n){const r=e.prepare("select * from skill_candidates where workspace_id = ? and name = ?").get(t,n);return r?d(r):void 0}(o,t.workspaceId,t.name),i=r?function(e,t,n,r){return e.prepare("\n    update skill_candidates\n    set status = ?, confidence = ?, evidence_count = ?, proposed_path = ?,\n        title = ?, summary = ?, draft_markdown = ?, updated_at = ?\n    where id = ?\n  ").run(n.status??"review_required",n.confidence,n.evidence.length,n.proposedPath??null,n.title,n.summary,n.draftMarkdown,r,t),a(e,t)}(o,r.id,t,n):function(t,n,r){const d=String(e());return t.prepare("\n    insert into skill_candidates\n    (id, workspace_id, name, status, confidence, evidence_count, proposed_path,\n     title, summary, draft_markdown, created_at, updated_at)\n    values (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)\n  ").run(d,n.workspaceId,n.name,n.status??"review_required",n.confidence,n.evidence.length,n.proposedPath??null,n.title,n.summary,n.draftMarkdown,r,r),a(t,d)}(o,t,n);return function(t,n,r,a){t.prepare("delete from skill_candidate_evidence where candidate_id = ?").run(n);const d=t.prepare("\n    insert into skill_candidate_evidence\n    (id, candidate_id, evidence_type, evidence_ref, summary, weight, created_at)\n    values (?, ?, ?, ?, ?, ?, ?)\n  ");for(const t of r)d.run(String(e()),n,t.evidenceType,t.evidenceRef,t.summary??null,t.weight??null,a)}(o,i.id,t.evidence,n),i},list:async(e={})=>function(e,t,n){return(t&&n?e.prepare("select * from skill_candidates where workspace_id = ? and status = ? order by updated_at desc").all(t,n):t?e.prepare("select * from skill_candidates where workspace_id = ? order by updated_at desc").all(t):e.prepare("select * from skill_candidates order by updated_at desc").all()).map(e=>d(e))}(o,e.workspaceId,e.status),get:async e=>a(o,e),listEvidence:async e=>function(e,t){return e.prepare("select * from skill_candidate_evidence where candidate_id = ? order by created_at asc").all(t).map(e=>function(e){return{id:String(e.id),candidateId:String(e.candidate_id),evidenceType:e.evidence_type,evidenceRef:String(e.evidence_ref),summary:i(e.summary),weight:"number"==typeof e.weight?e.weight:void 0,createdAt:String(e.created_at)}}(e))}(o,e),async updateStatus(e){const t=(new Date).toISOString();return o.prepare("\n        update skill_candidates\n        set status = ?, reviewed_at = ?, reviewed_by = ?, rejection_reason = ?, updated_at = ?\n        where id = ?\n      ").run(e.status,t,e.reviewedBy??null,e.rejectionReason??null,t,e.id),a(o,e.id)}}}function a(e,t){const n=e.prepare("select * from skill_candidates where id = ?").get(t);return n?d(n):void 0}function d(e){return{id:String(e.id),workspaceId:String(e.workspace_id),name:String(e.name),status:e.status,confidence:Number(e.confidence),evidenceCount:Number(e.evidence_count),proposedPath:i(e.proposed_path),title:String(e.title),summary:String(e.summary),draftMarkdown:String(e.draft_markdown),createdAt:String(e.created_at),updatedAt:String(e.updated_at),reviewedAt:i(e.reviewed_at),reviewedBy:i(e.reviewed_by),rejectionReason:i(e.rejection_reason)}}function i(e){return"string"==typeof e&&e?e:void 0}
+import{randomUUID as e}from"node:crypto";import{mkdirSync as t}from"node:fs";import n from"node:path";import{DatabaseSync as a}from"node:sqlite";export function createSqliteSkillCandidateStore(d){t(n.dirname(d),{recursive:!0});const r=new a(d);return function init(e){e.exec("\n    create table if not exists skill_candidates (\n      id text primary key, workspace_id text not null, name text not null,\n      status text not null, confidence real not null, evidence_count integer not null,\n      proposed_path text, title text not null, summary text not null,\n      draft_markdown text not null, created_at text not null, updated_at text not null,\n      reviewed_at text, reviewed_by text, rejection_reason text,\n      unique(workspace_id, name)\n    );\n    create table if not exists skill_candidate_evidence (\n      id text primary key, candidate_id text not null, evidence_type text not null,\n      evidence_ref text not null, summary text, weight real, created_at text not null,\n      foreign key(candidate_id) references skill_candidates(id)\n    );\n  ")}(r),{async upsert(t){const n=(new Date).toISOString(),a=function findByName(e,t,n){const a=e.prepare("select * from skill_candidates where workspace_id = ? and name = ?").get(t,n);return a?rowToCandidate(a):void 0}(r,t.workspaceId,t.name),d=a?function updateCandidate(e,t,n,a){return e.prepare("\n    update skill_candidates\n    set status = ?, confidence = ?, evidence_count = ?, proposed_path = ?,\n        title = ?, summary = ?, draft_markdown = ?, updated_at = ?\n    where id = ?\n  ").run(n.status??"review_required",n.confidence,n.evidence.length,n.proposedPath??null,n.title,n.summary,n.draftMarkdown,a,t),readCandidate(e,t)}(r,a.id,t,n):function insertCandidate(t,n,a){const d=String(e());return t.prepare("\n    insert into skill_candidates\n    (id, workspace_id, name, status, confidence, evidence_count, proposed_path,\n     title, summary, draft_markdown, created_at, updated_at)\n    values (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)\n  ").run(d,n.workspaceId,n.name,n.status??"review_required",n.confidence,n.evidence.length,n.proposedPath??null,n.title,n.summary,n.draftMarkdown,a,a),readCandidate(t,d)}(r,t,n);return function replaceEvidence(t,n,a,d){t.prepare("delete from skill_candidate_evidence where candidate_id = ?").run(n);const r=t.prepare("\n    insert into skill_candidate_evidence\n    (id, candidate_id, evidence_type, evidence_ref, summary, weight, created_at)\n    values (?, ?, ?, ?, ?, ?, ?)\n  ");for(const t of a)r.run(String(e()),n,t.evidenceType,t.evidenceRef,t.summary??null,t.weight??null,d)}(r,d.id,t.evidence,n),d},list:async(e={})=>function listCandidates(e,t,n){return(t&&n?e.prepare("select * from skill_candidates where workspace_id = ? and status = ? order by updated_at desc").all(t,n):t?e.prepare("select * from skill_candidates where workspace_id = ? order by updated_at desc").all(t):e.prepare("select * from skill_candidates order by updated_at desc").all()).map(e=>rowToCandidate(e))}(r,e.workspaceId,e.status),get:async e=>readCandidate(r,e),listEvidence:async e=>function listEvidence(e,t){return e.prepare("select * from skill_candidate_evidence where candidate_id = ? order by created_at asc").all(t).map(e=>function rowToEvidence(e){return{id:String(e.id),candidateId:String(e.candidate_id),evidenceType:e.evidence_type,evidenceRef:String(e.evidence_ref),summary:readOptionalString(e.summary),weight:"number"==typeof e.weight?e.weight:void 0,createdAt:String(e.created_at)}}(e))}(r,e),async updateStatus(e){const t=(new Date).toISOString();return r.prepare("\n        update skill_candidates\n        set status = ?, reviewed_at = ?, reviewed_by = ?, rejection_reason = ?, updated_at = ?\n        where id = ?\n      ").run(e.status,t,e.reviewedBy??null,e.rejectionReason??null,t,e.id),readCandidate(r,e.id)}}}function readCandidate(e,t){const n=e.prepare("select * from skill_candidates where id = ?").get(t);return n?rowToCandidate(n):void 0}function rowToCandidate(e){return{id:String(e.id),workspaceId:String(e.workspace_id),name:String(e.name),status:e.status,confidence:Number(e.confidence),evidenceCount:Number(e.evidence_count),proposedPath:readOptionalString(e.proposed_path),title:String(e.title),summary:String(e.summary),draftMarkdown:String(e.draft_markdown),createdAt:String(e.created_at),updatedAt:String(e.updated_at),reviewedAt:readOptionalString(e.reviewed_at),reviewedBy:readOptionalString(e.reviewed_by),rejectionReason:readOptionalString(e.rejection_reason)}}function readOptionalString(e){return"string"==typeof e&&e?e:void 0}

package/packages/memory/dist/src/langmem-service.js

@@ -1 +1 @@
-export function createLangMemServiceProvider(r){const t=function(e){return e.replace(/\/+$/u,"")}(r.baseUrl),a={...r.config,provider:"langmem-service"};return{name:"langmem-service",config:a,propose:async n=>(await e(t,"/memory/propose",{...n,config:a},r)).candidates??[],async search(o){const i=await(o.store?.list({namespace:o.namespace,kinds:o.kinds}))??[];return(await e(t,"/memory/search",{...n(o),records:i,config:a},r)).records??[]},consolidate:async n=>(await e(t,"/memory/consolidate",{...n,config:a},r)).operations??[]}}async function e(e,n,r,t){const a=new AbortController,o=setTimeout(()=>a.abort(),t.timeoutMs??3e4);try{const o=await fetch(`${e}${n}`,{method:"POST",headers:{"content-type":"application/json",...t.headers},body:JSON.stringify(r),signal:a.signal});return await async function(e,n){const r=await e.text();if(!e.ok)throw new Error(`LangMem service ${n} failed with ${e.status}: ${r}`);return r?JSON.parse(r):{}}(o,n)}finally{clearTimeout(o)}}function n(e){return{namespace:e.namespace,query:e.query,limit:e.limit,kinds:e.kinds,records:[]}}
+export function createLangMemServiceProvider(e){const n=function normalizeBaseUrl(e){return e.replace(/\/+$/u,"")}(e.baseUrl),t={...e.config,provider:"langmem-service"};return{name:"langmem-service",config:t,propose:async o=>(await postJson(n,"/memory/propose",{...o,config:t},e)).candidates??[],async search(o){const r=await(o.store?.list({namespace:o.namespace,kinds:o.kinds}))??[];return(await postJson(n,"/memory/search",{...withoutStore(o),records:r,config:t},e)).records??[]},consolidate:async o=>(await postJson(n,"/memory/consolidate",{...o,config:t},e)).operations??[]}}async function postJson(e,n,t,o){const r=new AbortController,a=setTimeout(()=>r.abort(),o.timeoutMs??3e4);try{const a=await fetch(`${e}${n}`,{method:"POST",headers:{"content-type":"application/json",...o.headers},body:JSON.stringify(t),signal:r.signal});return await async function readResponse(e,n){const t=await e.text();if(!e.ok)throw new Error(`LangMem service ${n} failed with ${e.status}: ${t}`);return t?JSON.parse(t):{}}(a,n)}finally{clearTimeout(a)}}function withoutStore(e){return{namespace:e.namespace,query:e.query,limit:e.limit,kinds:e.kinds,records:[]}}

package/packages/memory/dist/src/maintenance.js

@@ -1 +1 @@
-export async function applyMemoryMaintenance(e,n){const t=[];for(const r of n)t.push(await a(e,r));return t}async function a(a,n){return"archive"===n.action?e(n,await a.archive(n.recordId,n.reason)):"mark_stale"===n.action?e(n,await a.update({id:n.recordId,status:"stale",metadata:{maintenanceReason:n.reason}})):"refresh"===n.action?e(n,await a.update({id:n.recordId,status:"active",metadata:{maintenanceReason:n.reason}})):e(n,await a.update({id:n.recordId,status:"archived",metadata:{maintenanceReason:n.reason,supersededBy:n.replacementRecordId}}))}function e(a,e){return{operation:a,record:e,applied:Boolean(e),reason:e?a.reason:"record not found"}}
+export async function applyMemoryMaintenance(a,e){const t=[];for(const n of e)t.push(await applyOperation(a,n));return t}async function applyOperation(a,e){return"archive"===e.action?result(e,await a.archive(e.recordId,e.reason)):"mark_stale"===e.action?result(e,await a.update({id:e.recordId,status:"stale",metadata:{maintenanceReason:e.reason}})):"refresh"===e.action?result(e,await a.update({id:e.recordId,status:"active",metadata:{maintenanceReason:e.reason}})):result(e,await a.update({id:e.recordId,status:"archived",metadata:{maintenanceReason:e.reason,supersededBy:e.replacementRecordId}}))}function result(a,e){return{operation:a,record:e,applied:Boolean(e),reason:e?a.reason:"record not found"}}

package/packages/memory/dist/src/policy.js

@@ -1 +1 @@
-export function createDefaultMemoryPolicy(){return{decide:i=>i.noStore?{action:"reject",reason:"candidate marked noStore",reviewRequired:!1}:i.content.trim()?"sensitive"===i.sensitivity||"restricted"===i.sensitivity?{action:"review",reason:"sensitive memory requires operator approval",kind:i.kindHint??"semantic",scope:i.scopeHint??"workspace",confidence:e(i.confidenceHint),reviewRequired:!0}:{action:"store",reason:"candidate accepted by default runtime policy",kind:i.kindHint??"semantic",scope:i.scopeHint??"workspace",confidence:e(i.confidenceHint),retrievalPriority:0,reviewRequired:!1}:{action:"reject",reason:"candidate content is empty",reviewRequired:!1}}}function e(e){return void 0===e||Number.isNaN(e)?.6:Math.min(1,Math.max(0,e))}
+export function createDefaultMemoryPolicy(){return{decide:e=>e.noStore?{action:"reject",reason:"candidate marked noStore",reviewRequired:!1}:e.content.trim()?"sensitive"===e.sensitivity||"restricted"===e.sensitivity?{action:"review",reason:"sensitive memory requires operator approval",kind:e.kindHint??"semantic",scope:e.scopeHint??"workspace",confidence:normalizeConfidence(e.confidenceHint),reviewRequired:!0}:{action:"store",reason:"candidate accepted by default runtime policy",kind:e.kindHint??"semantic",scope:e.scopeHint??"workspace",confidence:normalizeConfidence(e.confidenceHint),retrievalPriority:0,reviewRequired:!1}:{action:"reject",reason:"candidate content is empty",reviewRequired:!1}}}function normalizeConfidence(e){return void 0===e||Number.isNaN(e)?.6:Math.min(1,Math.max(0,e))}

package/packages/memory/dist/src/provider.js

@@ -1 +1 @@
-export function createEmbeddedMemoryProvider(e={}){return{name:"embedded",config:e,async propose(n){const s=n.kindHint??function(e){const n=e.toLowerCase();return n.includes("must ")||n.includes("should ")?"procedural":n.includes("run ")||n.includes("failed ")?"episodic":"semantic"}(n.content);return function(e,n){return!1!==e.types?.[n]}(e,s)?[{namespace:n.namespace,content:n.content,sourceType:n.sourceType,sourceRef:n.sourceRef,kindHint:s,scopeHint:n.scopeHint??e.defaults?.scope??"workspace",sensitivity:n.sensitivity??e.defaults?.sensitivity??"internal",confidenceHint:.6,metadata:n.metadata}]:[]},search:async e=>e.store?(await e.store.recall({namespace:e.namespace,query:e.query,limit:e.limit,kinds:e.kinds})).records:[],consolidate:async e=>e.records.filter(e=>"stale"===e.status).map(e=>({action:"archive",recordId:e.id,reason:"embedded provider archives stale records during consolidation"}))}}
+export function createEmbeddedMemoryProvider(e={}){return{name:"embedded",config:e,async propose(n){const s=n.kindHint??function inferKind(e){const n=e.toLowerCase();return n.includes("must ")||n.includes("should ")?"procedural":n.includes("run ")||n.includes("failed ")?"episodic":"semantic"}(n.content);return function isKindEnabled(e,n){return!1!==e.types?.[n]}(e,s)?[{namespace:n.namespace,content:n.content,sourceType:n.sourceType,sourceRef:n.sourceRef,kindHint:s,scopeHint:n.scopeHint??e.defaults?.scope??"workspace",sensitivity:n.sensitivity??e.defaults?.sensitivity??"internal",confidenceHint:.6,metadata:n.metadata}]:[]},search:async e=>e.store?(await e.store.recall({namespace:e.namespace,query:e.query,limit:e.limit,kinds:e.kinds})).records:[],consolidate:async e=>e.records.filter(e=>"stale"===e.status).map(e=>({action:"archive",recordId:e.id,reason:"embedded provider archives stale records during consolidation"}))}}

package/packages/memory/dist/src/store.js

@@ -1 +1 @@
-import{randomUUID as e}from"node:crypto";import{createDefaultMemoryPolicy as t}from"./policy.js";import{cloneRecords as n}from"./persistence.js";export function createInMemoryRuntimeMemoryStore(e={}){const d=e.policy??t(),m=n(e.records??[]);return{async submitCandidate(e){const t=d.decide(e);if("store"!==t.action)return{candidate:e,decision:t};const n=a({namespace:e.namespace,content:e.content,kind:t.kind,scope:t.scope,summary:e.summary,confidence:t.confidence,tags:e.tags,sensitivity:e.sensitivity,sourceType:e.sourceType,sourceRef:e.sourceRef,metadata:e.metadata,provenance:e.provenance,observedAt:e.observedAt,retrievalPriority:t.retrievalPriority});return m.push(n),{candidate:e,decision:{...t,recordId:n.id},record:r(n)}},async memorize(e){const t=a(e);return m.push(t),r(t)},async recall(e){const t=e.query.toLowerCase(),n=s(m,e).filter(e=>function(e,t){return[e.canonicalKey,e.content,e.summary??"",...e.tags].join("\n").toLowerCase().includes(t)}(e,t)).sort(i).slice(0,e.limit??10);return{records:n,context:c(n)}},list:async e=>n(s(m,e)),async update(e){const t=m.find(t=>t.id===e.id);if(t)return function(e,t){e.content=t.content??e.content,e.summary=t.summary??e.summary,e.status=t.status??e.status,e.confidence=o(t.confidence??e.confidence),e.tags=t.tags??e.tags,e.metadata=t.metadata?{...e.metadata,...t.metadata}:e.metadata,e.lastConfirmedAt=(new Date).toISOString(),e.revision+=1}(t,e),r(t)},async archive(e,t){const n=m.find(t=>t.id===e);if(n)return n.status="archived",n.metadata={...n.metadata,archiveReason:t},n.revision+=1,r(n)}}}function r(e){return n([e])[0]}function a(t){const n=(new Date).toISOString();return{id:e(),namespace:t.namespace,canonicalKey:(r=t.namespace,a=t.content,`${r}:${a.trim().toLowerCase().replace(/\s+/gu," ").slice(0,120)}`),kind:t.kind??"semantic",scope:t.scope??"workspace",status:"active",content:t.content,summary:t.summary,confidence:o(t.confidence),sourceType:t.sourceType,sourceRefs:t.sourceRef?[t.sourceRef]:[],tags:t.tags??[],sensitivity:t.sensitivity??"internal",metadata:t.metadata??{},createdAt:n,observedAt:t.observedAt??n,lastConfirmedAt:n,provenance:t.provenance??{},revision:1,supersedes:[],conflictsWith:[],retrievalPriority:t.retrievalPriority??0};var r,a}function s(e,t){return e.filter(e=>e.namespace===t.namespace).filter(e=>!t.kinds||t.kinds.includes(e.kind)).filter(e=>!t.scopes||t.scopes.includes(e.scope)).filter(e=>(t.statuses??["active"]).includes(e.status))}function i(e,t){return t.retrievalPriority-e.retrievalPriority||t.confidence-e.confidence||t.lastConfirmedAt.localeCompare(e.lastConfirmedAt)}function c(e){return e.map(e=>`- [${e.kind}/${e.scope}] ${e.summary??e.content}`).join("\n")}function o(e){return void 0===e||Number.isNaN(e)?.6:Math.min(1,Math.max(0,e))}
+import{randomUUID as e}from"node:crypto";import{createDefaultMemoryPolicy as t}from"./policy.js";import{cloneRecords as n}from"./persistence.js";export function createInMemoryRuntimeMemoryStore(e={}){const r=e.policy??t(),o=n(e.records??[]);return{async submitCandidate(e){const t=r.decide(e);if("store"!==t.action)return{candidate:e,decision:t};const n=createRecord({namespace:e.namespace,content:e.content,kind:t.kind,scope:t.scope,summary:e.summary,confidence:t.confidence,tags:e.tags,sensitivity:e.sensitivity,sourceType:e.sourceType,sourceRef:e.sourceRef,metadata:e.metadata,provenance:e.provenance,observedAt:e.observedAt,retrievalPriority:t.retrievalPriority});return o.push(n),{candidate:e,decision:{...t,recordId:n.id},record:cloneRecord(n)}},async memorize(e){const t=createRecord(e);return o.push(t),cloneRecord(t)},async recall(e){const t=e.query.toLowerCase(),n=filterRecords(o,e).filter(e=>function matchesQuery(e,t){return[e.canonicalKey,e.content,e.summary??"",...e.tags].join("\n").toLowerCase().includes(t)}(e,t)).sort(compareRecallPriority).slice(0,e.limit??10);return{records:n,context:buildMemoryContext(n)}},list:async e=>n(filterRecords(o,e)),async update(e){const t=o.find(t=>t.id===e.id);if(t)return function applyUpdate(e,t){e.content=t.content??e.content,e.summary=t.summary??e.summary,e.status=t.status??e.status,e.confidence=normalizeConfidence(t.confidence??e.confidence),e.tags=t.tags??e.tags,e.metadata=t.metadata?{...e.metadata,...t.metadata}:e.metadata,e.lastConfirmedAt=(new Date).toISOString(),e.revision+=1}(t,e),cloneRecord(t)},async archive(e,t){const n=o.find(t=>t.id===e);if(n)return n.status="archived",n.metadata={...n.metadata,archiveReason:t},n.revision+=1,cloneRecord(n)}}}function cloneRecord(e){return n([e])[0]}function createRecord(t){const n=(new Date).toISOString();return{id:e(),namespace:t.namespace,canonicalKey:(r=t.namespace,o=t.content,`${r}:${o.trim().toLowerCase().replace(/\s+/gu," ").slice(0,120)}`),kind:t.kind??"semantic",scope:t.scope??"workspace",status:"active",content:t.content,summary:t.summary,confidence:normalizeConfidence(t.confidence),sourceType:t.sourceType,sourceRefs:t.sourceRef?[t.sourceRef]:[],tags:t.tags??[],sensitivity:t.sensitivity??"internal",metadata:t.metadata??{},createdAt:n,observedAt:t.observedAt??n,lastConfirmedAt:n,provenance:t.provenance??{},revision:1,supersedes:[],conflictsWith:[],retrievalPriority:t.retrievalPriority??0};var r,o}function filterRecords(e,t){return e.filter(e=>e.namespace===t.namespace).filter(e=>!t.kinds||t.kinds.includes(e.kind)).filter(e=>!t.scopes||t.scopes.includes(e.scope)).filter(e=>(t.statuses??["active"]).includes(e.status))}function compareRecallPriority(e,t){return t.retrievalPriority-e.retrievalPriority||t.confidence-e.confidence||t.lastConfirmedAt.localeCompare(e.lastConfirmedAt)}function buildMemoryContext(e){return e.map(e=>`- [${e.kind}/${e.scope}] ${e.summary??e.content}`).join("\n")}function normalizeConfidence(e){return void 0===e||Number.isNaN(e)?.6:Math.min(1,Math.max(0,e))}

package/packages/protocols/dist/src/http-server.js

@@ -1 +1 @@
-import{createServer as t}from"node:http";import{compileWorkflowPlan as o,projectRuntimeTrace as e,renderWorkflowMermaid as r}from"@stable-harness/core";export function createHttpServer(i){return t(async(t,u)=>{try{if("GET"===t.method&&"/health"===t.url)return void s(u,200,{ok:!0});if("GET"===t.method&&"/inspect"===t.url)return void s(u,200,i.inspect());if("GET"===t.method&&"/requests"===t.url)return void s(u,200,i.listRequests());if("GET"===t.method&&"/sessions"===t.url)return void s(u,200,i.listSessions());if("GET"===t.method&&"/workflows"===t.url)return void s(u,200,i.inspect().workflows);const a=function(t){const o=(t??"").match(/^\/workflows\/([^/]+)\/mermaid$/u);return o?.[1]?decodeURIComponent(o[1]):void 0}(t.url);if("GET"===t.method&&a){const t=i.getWorkflow(a);return void s(u,t?200:404,t?{mermaid:r(t)}:{error:"workflow_not_found"})}const d=function(t){const o=(t??"").match(/^\/workflows\/([^/]+)\/plan$/u);return o?.[1]?decodeURIComponent(o[1]):void 0}(t.url);if("GET"===t.method&&d){const t=i.getWorkflow(d);return void s(u,t?200:404,t?o(t):{error:"workflow_not_found"})}const f=function(t){const o=(t??"").match(/^\/requests\/([^/]+)$/u);return o?.[1]?decodeURIComponent(o[1]):void 0}(t.url);if("GET"===t.method&&f){const t=i.inspectRequest(f);return void s(u,t?200:404,t??{error:"request_not_found"})}const c=function(t){const o=(t??"").match(/^\/runs\/([^/]+)\/trace$/u);return o?.[1]?decodeURIComponent(o[1]):void 0}(t.url);if("GET"===t.method&&c){const t=i.getRun(c);return void s(u,t?200:404,t?e(t):{error:"run_not_found"})}if("POST"===t.method&&"/requests"===t.url){const o=await async function(t){const o=[];for await(const e of t)o.push(Buffer.isBuffer(e)?e:Buffer.from(e));return 0===o.length?{}:JSON.parse(Buffer.concat(o).toString("utf8"))}(t);return void s(u,200,await i.request(function(t){const o=function(t){if("object"!=typeof t||null===t)return;const o=t;return"string"==typeof o.toolId?{toolId:o.toolId,args:o.args}:void 0}(t.toolCall),e=function(t){const o=n(t);if(o)return{..."string"==typeof o.workflowId?{workflowId:o.workflowId}:{},..."string"==typeof o.routeId?{routeId:o.routeId}:{},...void 0!==o.input?{input:o.input}:{},..."object"==typeof o.metadata&&o.metadata?{metadata:o.metadata}:{}}}(t.workflow),r=function(t){const o=n(t);if(o)return{..."string"==typeof o.namespace?{namespace:o.namespace}:{},...!1===o.recall||n(o.recall)?{recall:o.recall}:{},...Array.isArray(o.candidates)?{candidates:o.candidates}:{}}}(t.memory),s=n(t.metadata);return{input:"string"==typeof t.input?t.input:"",..."string"==typeof t.agentId?{agentId:t.agentId}:{},..."string"==typeof t.sessionId?{sessionId:t.sessionId}:{},..."string"==typeof t.requestId?{requestId:t.requestId}:{},..."string"==typeof t.parentRunId?{parentRunId:t.parentRunId}:{},...o?{toolCall:o}:{},...e?{workflow:e}:{},...r?{memory:r}:{},...s?{metadata:s}:{}}}(o)))}s(u,404,{error:"not_found"})}catch(t){s(u,500,{error:t instanceof Error?t.message:String(t)})}})}function n(t){return"object"!=typeof t||null===t||Array.isArray(t)?void 0:t}function s(t,o,e){t.writeHead(o,{"content-type":"application/json"}),t.end(JSON.stringify(e))}
+import{createServer as e}from"node:http";import{compileWorkflowPlan as o,projectRuntimeTrace as t,renderWorkflowMermaid as r}from"@stable-harness/core";export function createHttpServer(n){return e(async(e,s)=>{try{if("GET"===e.method&&"/health"===e.url)return void sendJson(s,200,{ok:!0});if("GET"===e.method&&"/inspect"===e.url)return void sendJson(s,200,n.inspect());if("GET"===e.method&&"/requests"===e.url)return void sendJson(s,200,n.listRequests());if("GET"===e.method&&"/sessions"===e.url)return void sendJson(s,200,n.listSessions());if("GET"===e.method&&"/workflows"===e.url)return void sendJson(s,200,n.inspect().workflows);const d=function readWorkflowMermaidId(e){const o=(e??"").match(/^\/workflows\/([^/]+)\/mermaid$/u);return o?.[1]?decodeURIComponent(o[1]):void 0}(e.url);if("GET"===e.method&&d){const e=n.getWorkflow(d);return void sendJson(s,e?200:404,e?{mermaid:r(e)}:{error:"workflow_not_found"})}const a=function readWorkflowPlanId(e){const o=(e??"").match(/^\/workflows\/([^/]+)\/plan$/u);return o?.[1]?decodeURIComponent(o[1]):void 0}(e.url);if("GET"===e.method&&a){const e=n.getWorkflow(a);return void sendJson(s,e?200:404,e?o(e):{error:"workflow_not_found"})}const i=function readRequestInspectionId(e){const o=(e??"").match(/^\/requests\/([^/]+)$/u);return o?.[1]?decodeURIComponent(o[1]):void 0}(e.url);if("GET"===e.method&&i){const e=n.inspectRequest(i);return void sendJson(s,e?200:404,e??{error:"request_not_found"})}const u=function readTraceRequestId(e){const o=(e??"").match(/^\/runs\/([^/]+)\/trace$/u);return o?.[1]?decodeURIComponent(o[1]):void 0}(e.url);if("GET"===e.method&&u){const e=n.getRun(u);return void sendJson(s,e?200:404,e?t(e):{error:"run_not_found"})}if("POST"===e.method&&"/requests"===e.url){const o=await async function readJson(e){const o=[];for await(const t of e)o.push(Buffer.isBuffer(t)?t:Buffer.from(t));return 0===o.length?{}:JSON.parse(Buffer.concat(o).toString("utf8"))}(e);return void sendJson(s,200,await n.request(function readRuntimeRequest(e){const o=function readToolCall(e){if("object"!=typeof e||null===e)return;const o=e;return"string"==typeof o.toolId?{toolId:o.toolId,args:o.args}:void 0}(e.toolCall),t=function readWorkflow(e){const o=readRecord(e);if(o)return{..."string"==typeof o.workflowId?{workflowId:o.workflowId}:{},..."string"==typeof o.routeId?{routeId:o.routeId}:{},...void 0!==o.input?{input:o.input}:{},..."object"==typeof o.metadata&&o.metadata?{metadata:o.metadata}:{}}}(e.workflow),r=function readMemory(e){const o=readRecord(e);if(o)return{..."string"==typeof o.namespace?{namespace:o.namespace}:{},...!1===o.recall||readRecord(o.recall)?{recall:o.recall}:{},...Array.isArray(o.candidates)?{candidates:o.candidates}:{}}}(e.memory),n=readRecord(e.metadata);return{input:"string"==typeof e.input?e.input:"",..."string"==typeof e.agentId?{agentId:e.agentId}:{},..."string"==typeof e.sessionId?{sessionId:e.sessionId}:{},..."string"==typeof e.requestId?{requestId:e.requestId}:{},..."string"==typeof e.parentRunId?{parentRunId:e.parentRunId}:{},...o?{toolCall:o}:{},...t?{workflow:t}:{},...r?{memory:r}:{},...n?{metadata:n}:{}}}(o)))}sendJson(s,404,{error:"not_found"})}catch(e){sendJson(s,500,{error:e instanceof Error?e.message:String(e)})}})}function readRecord(e){return"object"!=typeof e||null===e||Array.isArray(e)?void 0:e}function sendJson(e,o,t){e.writeHead(o,{"content-type":"application/json"}),e.end(JSON.stringify(t))}

package/packages/protocols/dist/src/openai-compatible.js

@@ -1 +1 @@
-import{createServer as e}from"node:http";import{createCapabilitiesResponse as t,createModelsResponse as r,resolveAgentId as o,toChatCompletion as n,toRuntimeRequest as s}from"./openai-payload.js";import{createContentChunk as i,createRoleChunk as a,createStopChunk as c,missingFinalDelta as u,writeChatSse as l,writeRuntimeStreamEvent as d,writeSseHeaders as f}from"./openai-stream.js";export function createOpenAiCompatibleHttpServer(v,O={}){const w=function(e,t){const r=function(e){const t=m(e)??{};return m(t.openaiCompatible)??m(t["openai-compatible"])??m(t.openai)??{}}(e.getRuntimePolicy().protocols);return{bearerToken:t.bearerToken??y(r.bearerToken),corsOrigins:t.corsOrigins??(o=r.corsOrigins,Array.isArray(o)?o.filter(e=>"string"==typeof e&&e.trim().length>0):void 0),modelAgentMap:t.modelAgentMap??p(r.modelAgentMap),defaultModel:t.defaultModel??y(r.defaultModel)};var o}(v,O);return e(async(e,m)=>{try{if(function(e,t,r){const o=function(e,t){if(e)return t.corsOrigins?.includes("*")?"*":t.corsOrigins?.includes(e)||function(e){try{const t=new URL(e);return"http:"===t.protocol&&["localhost","127.0.0.1","[::1]"].includes(t.hostname)}catch{return!1}}(e)?e:void 0}(e.headers.origin,r);o&&(t.setHeader("access-control-allow-origin",o),t.setHeader("vary","origin"))}(e,m,w),function(e,t){return"OPTIONS"===e.method&&(t.writeHead(204,{"access-control-allow-headers":"authorization, content-type, idempotency-key","access-control-allow-methods":"GET, POST, OPTIONS"}),t.end(),!0)}(e,m))return;if(!function(e,t){return!t.bearerToken||e.headers.authorization===`Bearer ${t.bearerToken}`}(e,w))return void g(m,401,{error:{message:"unauthorized",type:"invalid_request_error"}});if("GET"===e.method&&"/v1/models"===e.url)return void g(m,200,r(v,w));if("GET"===e.method&&"/v1/capabilities"===e.url)return void g(m,200,t());if("POST"===e.method&&"/v1/chat/completions"===e.url)return void await async function(e,t,r,m){const p=await async function(e){const t=[];for await(const r of e)t.push(Buffer.isBuffer(r)?r:Buffer.from(r));return 0===t.length?{}:JSON.parse(Buffer.concat(t).toString("utf8"))}(t);if(p.model&&!o(p.model,e,m))return void g(r,404,{error:{message:`model_not_found: ${p.model}`,type:"invalid_request_error"}});const y=s(p,e,m,{sessionId:h(t.headers["x-stable-harness-session-id"])});if(p.stream)return void await async function(e,t,r,o){f(t,{"access-control-allow-headers":"authorization, content-type, idempotency-key","access-control-allow-methods":"GET, POST, OPTIONS"}),l(t,a(o.requestId,r.model));let n="";const s=e.subscribe(e=>{e.requestId===o.requestId&&(n+=d(t,e,o.requestId,r.model)??"")});try{const s=await e.request(o),a=u(n,s.output);a&&l(t,i(o.requestId,r.model,a)),l(t,c(o.requestId,r.model)),t.write("data: [DONE]\n\n"),t.end()}finally{s()}}(e,r,p,y);const v=await e.request(y);g(r,200,n(p,v))}(v,e,m,w);g(m,404,{error:{message:"not_found",type:"invalid_request_error"}})}catch(e){g(m,400,{error:{message:e instanceof Error?e.message:String(e),type:"invalid_request_error"}})}})}function m(e){return"object"!=typeof e||null===e||Array.isArray(e)?void 0:e}function p(e){const t=m(e);if(t)return Object.fromEntries(Object.entries(t).filter(e=>"string"==typeof e[1]))}function y(e){if("string"!=typeof e||!e.trim())return;const t=e.match(/^\$\{env:([A-Za-z_][A-Za-z0-9_]*)(?::-(.*))?\}$/u);return t?process.env[t[1]]??t[2]:e}function h(e){const t=Array.isArray(e)?e[0]:e;return t&&t.trim()?t:void 0}function g(e,t,r,o){e.writeHead(t,{"content-type":"application/json","access-control-allow-headers":"authorization, content-type, idempotency-key","access-control-allow-methods":"GET, POST, OPTIONS"}),e.end(JSON.stringify(r))}
+import{createServer as e}from"node:http";import{createCapabilitiesResponse as r,createModelsResponse as t,resolveAgentId as o,toChatCompletion as n,toRuntimeRequest as s}from"./openai-payload.js";import{createContentChunk as a,createRoleChunk as i,createStopChunk as d,missingFinalDelta as c,writeChatSse as l,writeRuntimeStreamEvent as u,writeSseHeaders as f}from"./openai-stream.js";export function createOpenAiCompatibleHttpServer(p,m={}){const g=function resolveServerOptions(e,r){const t=function readOpenAiProtocolConfig(e){const r=readRecord(e)??{};return readRecord(r.openaiCompatible)??readRecord(r["openai-compatible"])??readRecord(r.openai)??{}}(e.getRuntimePolicy().protocols);return{bearerToken:r.bearerToken??readConfigString(t.bearerToken),corsOrigins:r.corsOrigins??(o=t.corsOrigins,Array.isArray(o)?o.filter(e=>"string"==typeof e&&e.trim().length>0):void 0),modelAgentMap:r.modelAgentMap??readStringRecord(t.modelAgentMap),defaultModel:r.defaultModel??readConfigString(t.defaultModel)};var o}(p,m);return e(async(e,m)=>{try{if(function applyCorsHeaders(e,r,t){const o=function allowedCorsOrigin(e,r){if(e)return r.corsOrigins?.includes("*")?"*":r.corsOrigins?.includes(e)||function isLoopbackOrigin(e){try{const r=new URL(e);return"http:"===r.protocol&&["localhost","127.0.0.1","[::1]"].includes(r.hostname)}catch{return!1}}(e)?e:void 0}(e.headers.origin,t);o&&(r.setHeader("access-control-allow-origin",o),r.setHeader("vary","origin"))}(e,m,g),function handleCors(e,r){return"OPTIONS"===e.method&&(r.writeHead(204,{"access-control-allow-headers":"authorization, content-type, idempotency-key","access-control-allow-methods":"GET, POST, OPTIONS"}),r.end(),!0)}(e,m))return;if(!function isAuthorized(e,r){return!r.bearerToken||e.headers.authorization===`Bearer ${r.bearerToken}`}(e,g))return void sendJson(m,401,{error:{message:"unauthorized",type:"invalid_request_error"}});if("GET"===e.method&&"/v1/models"===e.url)return void sendJson(m,200,t(p,g));if("GET"===e.method&&"/v1/capabilities"===e.url)return void sendJson(m,200,r());if("POST"===e.method&&"/v1/chat/completions"===e.url)return void await async function handleChatCompletion(e,r,t,p){const m=await async function readJson(e){const r=[];for await(const t of e)r.push(Buffer.isBuffer(t)?t:Buffer.from(t));return 0===r.length?{}:JSON.parse(Buffer.concat(r).toString("utf8"))}(r);if(m.model&&!o(m.model,e,p))return void sendJson(t,404,{error:{message:`model_not_found: ${m.model}`,type:"invalid_request_error"}});const g=s(m,e,p,{sessionId:readHeaderString(r.headers["x-stable-harness-session-id"])});if(m.stream)return void await async function streamChatCompletion(e,r,t,o){f(r,{"access-control-allow-headers":"authorization, content-type, idempotency-key","access-control-allow-methods":"GET, POST, OPTIONS"}),l(r,i(o.requestId,t.model));let n="";const s=e.subscribe(e=>{e.requestId===o.requestId&&(n+=u(r,e,o.requestId,t.model)??"")});try{const s=await e.request(o),i=c(n,s.output);i&&l(r,a(o.requestId,t.model,i)),l(r,d(o.requestId,t.model)),r.write("data: [DONE]\n\n"),r.end()}finally{s()}}(e,t,m,g);const h=await e.request(g);sendJson(t,200,n(m,h))}(p,e,m,g);sendJson(m,404,{error:{message:"not_found",type:"invalid_request_error"}})}catch(e){sendJson(m,400,{error:{message:e instanceof Error?e.message:String(e),type:"invalid_request_error"}})}})}function readRecord(e){return"object"!=typeof e||null===e||Array.isArray(e)?void 0:e}function readStringRecord(e){const r=readRecord(e);if(r)return Object.fromEntries(Object.entries(r).filter(e=>"string"==typeof e[1]))}function readConfigString(e){if("string"!=typeof e||!e.trim())return;const r=e.match(/^\$\{env:([A-Za-z_][A-Za-z0-9_]*)(?::-(.*))?\}$/u);return r?process.env[r[1]]??r[2]:e}function readHeaderString(e){const r=Array.isArray(e)?e[0]:e;return r&&r.trim()?r:void 0}function sendJson(e,r,t,o){e.writeHead(r,{"content-type":"application/json","access-control-allow-headers":"authorization, content-type, idempotency-key","access-control-allow-methods":"GET, POST, OPTIONS"}),e.end(JSON.stringify(t))}

package/packages/protocols/dist/src/openai-payload.js

@@ -1 +1 @@
-import{randomUUID as t}from"node:crypto";export function toRuntimeRequest(o,r,s,a={}){const i=function(t){if(!Array.isArray(t)||0===t.length)throw new Error("messages must be a non-empty array");return t.map(t=>`${t.role??"user"}: ${n(t.content)}`).join("\n\n")}(o.messages),c=`chatcmpl-${t()}`,u=a.sessionId??function(t){const e=t?.sessionId??t?.session_id??t?.conversationId??t?.conversation_id;return"string"==typeof e&&e.trim()?e:void 0}(o.metadata),l=e(o.messages),p=u?function(t,n,o){if(function(t){return t.some(t=>"assistant"===t.role)||t.filter(t=>"user"===t.role).length>1}(o))return o;const r=t.listRequests({sessionId:n,state:"completed"}).flatMap(n=>function(t,n){const o=t.inspectRequest(n),r=o?.output?.trim(),s=(a=o?.metadata?.openaiMessages,e(Array.isArray(a)?a:void 0).filter(t=>"user"===t.role&&t.content.trim()).at(-1))?.content;var a;return s&&r?[{role:"user",content:s},{role:"assistant",content:r}]:[]}(t,n.requestId)).slice(-12);return r.length>0?[...r,...o]:o}(r,u,l):l;return{input:i,requestId:c,agentId:resolveAgentId(o.model,r,s),...u?{sessionId:u}:{},metadata:{protocol:"openai-compatible",openaiStream:!0===o.stream,openaiMessages:p,openaiSessionHistory:p.length>l.length,model:o.model,user:o.user,clientMetadata:o.metadata}}}export function resolveAgentId(t,e,n){if(!t)return;const o=n.modelAgentMap?.[t];return o||(e.inspect().agents.includes(t)?t:void 0)}export function createModelsResponse(t,e){const n=Object.keys(e.modelAgentMap??{});return{object:"list",data:[...new Set([...t.inspect().agents,...n])].sort().map(t=>({id:t,object:"model",created:0,owned_by:"stable-harness"}))}}export function createCapabilitiesResponse(){return{object:"stable_harness.capabilities",endpoints:["/v1/models","/v1/chat/completions","/v1/capabilities"],streaming:!0,toolProgressEvents:!0}}export function toChatCompletion(t,e){return{id:e.requestId,object:"chat.completion",created:Math.floor(Date.now()/1e3),model:t.model??e.agentId,choices:[{index:0,message:{role:"assistant",content:e.output},finish_reason:"stop"}],usage:r(t.messages,e.output),metadata:{sessionId:e.sessionId,agentId:e.agentId,state:e.state}}}function e(t){return Array.isArray(t)?t.map(t=>({role:t.role??"user",content:n(t.content)})):[]}function n(t){if("string"==typeof t)return t;if(!Array.isArray(t))throw new Error("message content must be a string or content part array");return t.map(o).join("\n")}function o(t){if("object"!=typeof t||null===t)throw new Error("message content parts must be objects");const e=t;if("text"===e.type&&"string"==typeof e.text)return e.text;const n=e.image_url;if("image_url"===e.type&&"string"==typeof n?.url)return`[image:${n.url}]`;throw new Error("unsupported_content_type")}function r(t,e){const o=s(Array.isArray(t)?t.map(t=>n(t.content)).join("\n"):""),r=s(e);return{prompt_tokens:o,completion_tokens:r,total_tokens:o+r}}function s(t){return t.trim()?Math.ceil(1.3*t.trim().split(/\s+/u).length):0}
+import{randomUUID as e}from"node:crypto";export function toRuntimeRequest(t,n,s,o={}){const r=function messagesToInput(e){if(!Array.isArray(e)||0===e.length)throw new Error("messages must be a non-empty array");return e.map(e=>`${e.role??"user"}: ${contentToText(e.content)}`).join("\n\n")}(t.messages),a=`chatcmpl-${e()}`,i=o.sessionId??function readSessionId(e){const t=e?.sessionId??e?.session_id??e?.conversationId??e?.conversation_id;return"string"==typeof t&&t.trim()?t:void 0}(t.metadata),c=normalizeOpenAiMessages(t.messages),u=i?function prependSessionMessages(e,t,n){if(function hasClientHistory(e){return e.some(e=>"assistant"===e.role)||e.filter(e=>"user"===e.role).length>1}(n))return n;const s=e.listRequests({sessionId:t,state:"completed"}).flatMap(t=>function inspectSessionTurn(e,t){const n=e.inspectRequest(t),s=n?.output?.trim(),o=function lastUserMessage(e){return normalizeOpenAiMessages(Array.isArray(e)?e:void 0).filter(e=>"user"===e.role&&e.content.trim()).at(-1)}(n?.metadata?.openaiMessages)?.content;return o&&s?[{role:"user",content:o},{role:"assistant",content:s}]:[]}(e,t.requestId)).slice(-12);return s.length>0?[...s,...n]:n}(n,i,c):c;return{input:r,requestId:a,agentId:resolveAgentId(t.model,n,s),...i?{sessionId:i}:{},metadata:{protocol:"openai-compatible",openaiStream:!0===t.stream,openaiMessages:u,openaiSessionHistory:u.length>c.length,model:t.model,user:t.user,clientMetadata:t.metadata}}}export function resolveAgentId(e,t,n){if(!e)return;const s=n.modelAgentMap?.[e];return s||(t.inspect().agents.includes(e)?e:void 0)}export function createModelsResponse(e,t){const n=Object.keys(t.modelAgentMap??{});return{object:"list",data:[...new Set([...e.inspect().agents,...n])].sort().map(e=>({id:e,object:"model",created:0,owned_by:"stable-harness"}))}}export function createCapabilitiesResponse(){return{object:"stable_harness.capabilities",endpoints:["/v1/models","/v1/chat/completions","/v1/capabilities"],streaming:!0,toolProgressEvents:!0}}export function toChatCompletion(e,t){return{id:t.requestId,object:"chat.completion",created:Math.floor(Date.now()/1e3),model:e.model??t.agentId,choices:[{index:0,message:{role:"assistant",content:t.output},finish_reason:"stop"}],usage:estimateUsage(e.messages,t.output),metadata:{sessionId:t.sessionId,agentId:t.agentId,state:t.state}}}function normalizeOpenAiMessages(e){return Array.isArray(e)?e.map(e=>({role:e.role??"user",content:contentToText(e.content)})):[]}function contentToText(e){if("string"==typeof e)return e;if(!Array.isArray(e))throw new Error("message content must be a string or content part array");return e.map(contentPartToText).join("\n")}function contentPartToText(e){if("object"!=typeof e||null===e)throw new Error("message content parts must be objects");const t=e;if("text"===t.type&&"string"==typeof t.text)return t.text;const n=t.image_url;if("image_url"===t.type&&"string"==typeof n?.url)return`[image:${n.url}]`;throw new Error("unsupported_content_type")}function estimateUsage(e,t){const n=estimateTokens(Array.isArray(e)?e.map(e=>contentToText(e.content)).join("\n"):""),s=estimateTokens(t);return{prompt_tokens:n,completion_tokens:s,total_tokens:n+s}}function estimateTokens(e){return e.trim()?Math.ceil(1.3*e.trim().split(/\s+/u).length):0}

package/packages/protocols/dist/src/openai-stream.js

@@ -1 +1 @@
-export function missingFinalDelta(t,e){return t?!e||t.includes(e)?"":e.startsWith(t)?e.slice(t.length):e:e}export function createRoleChunk(e,n){return t(e,n,{role:"assistant"},null)}export function createContentChunk(e,n,o){return t(e,n,{content:o},null)}export function createStopChunk(e,n){return t(e,n,{},"stop")}export function writeRuntimeStreamEvent(t,e,n,o){const r=function(t){if("adapter.event"!==t.type||"object"!=typeof t.event||null===t.event)return;const e=t.event;return"output.delta"===e.phase&&"string"==typeof e.text?e.text:void 0}(e);if(r)return writeChatSse(t,createContentChunk(n,o,r)),r;!function(t,e){const n=function(t){if("tool.started"===t.type||"tool.completed"===t.type)return{request_id:t.requestId,session_id:t.sessionId,agent_id:t.agentId,type:t.type,tool_id:t.toolId};if("adapter.event"!==t.type||"object"!=typeof t.event||null===t.event)return;const e=t.event,n="tool.start"===e.phase?"tool.started":"tool.result"===e.phase?"tool.completed":void 0,o="string"==typeof e.toolId?e.toolId:void 0;return n&&o?{request_id:t.requestId,session_id:t.sessionId,agent_id:t.agentId,type:n,tool_id:o,adapter:e.adapter}:void 0}(e);n&&function(t,e,n){t.write("event: stable_harness.tool.progress\n"),t.write(`data: ${JSON.stringify(n)}\n\n`)}(t,0,n)}(t,e)}export function writeSseHeaders(t,e){t.writeHead(200,{"content-type":"text/event-stream","cache-control":"no-cache",connection:"keep-alive",...e})}export function writeChatSse(t,e){t.write(`data: ${JSON.stringify(e)}\n\n`)}function t(t,e,n,o){return{id:t,object:"chat.completion.chunk",created:Math.floor(Date.now()/1e3),model:e??"stable-harness",choices:[{index:0,delta:n,finish_reason:o}]}}
+export function missingFinalDelta(e,t){return e?!t||e.includes(t)?"":t.startsWith(e)?t.slice(e.length):t:t}export function createRoleChunk(e,t){return createChunk(e,t,{role:"assistant"},null)}export function createContentChunk(e,t,n){return createChunk(e,t,{content:n},null)}export function createStopChunk(e,t){return createChunk(e,t,{},"stop")}export function writeRuntimeStreamEvent(e,t,n,r){const o=function readAdapterDelta(e){if("runtime.adapter.event"!==e.type||"object"!=typeof e.event||null===e.event)return;const t=e.event;return"agent.output.delta"===t.phase&&"string"==typeof t.text?t.text:void 0}(t);if(o)return writeChatSse(e,createContentChunk(n,r,o)),o;!function writeProgressEvent(e,t){const n=function readToolProgress(e){if("runtime.tool.direct.started"===e.type||"runtime.tool.direct.completed"===e.type)return{request_id:e.requestId,session_id:e.sessionId,agent_id:e.agentId,type:e.type,tool_id:e.toolId};if("runtime.adapter.event"!==e.type||"object"!=typeof e.event||null===e.event)return;const t=e.event,n="agent.tool.start"===t.phase||"agent.tool.result"===t.phase?t.phase:void 0,r="string"==typeof t.toolId?t.toolId:void 0;return n&&r?{request_id:e.requestId,session_id:e.sessionId,agent_id:e.agentId,type:n,tool_id:r,adapter:t.adapter}:void 0}(t);n&&writeSse(e,"stable_harness.tool.progress",n)}(e,t),function writeNarrationEvent(e,t){"runtime.progress.narration"===t.type&&writeSse(e,"stable_harness.progress.narration",{request_id:t.requestId,session_id:t.sessionId,agent_id:t.agentId,type:t.type,message:t.message,provider:t.provider,source_event_types:t.sourceEventTypes,source_event_ids:t.sourceEventIds,model:t.model,style:t.style})}(e,t)}export function writeSseHeaders(e,t){e.writeHead(200,{"content-type":"text/event-stream","cache-control":"no-cache",connection:"keep-alive",...t})}export function writeChatSse(e,t){e.write(`data: ${JSON.stringify(t)}\n\n`)}function createChunk(e,t,n,r){return{id:e,object:"chat.completion.chunk",created:Math.floor(Date.now()/1e3),model:t??"stable-harness",choices:[{index:0,delta:n,finish_reason:r}]}}function writeSse(e,t,n){e.write(`event: ${t}\n`),e.write(`data: ${JSON.stringify(n)}\n\n`)}

package/packages/tool-gateway/dist/src/argument-guard.d.ts

@@ -1,4 +1,4 @@
-import type { BetterToolLike, RepairFunction, RepairModelLike } from "@botbotgo/better-call";
+import type { BetterToolLike, RepairFunction, RepairModelLike, RepairPolicy } from "@botbotgo/better-call";
 import type { ToolArgumentGuard, ToolArgumentIssue, ToolGatewayContext, ToolGatewayTool } from "./types.js";
 type ToolGatewayRuntimeTool = ToolGatewayTool & {
     validationTool?: BetterToolLike;
@@ -7,6 +7,7 @@ export type BetterCallArgumentRepairOptions = {
     mode?: "guard" | "repair" | "review";
     repair?: RepairFunction;
     repairModel?: RepairModelLike;
+    repairPolicy?: RepairPolicy;
 };
 export type ToolArgumentGuardOptions = {
     betterCall?: BetterCallArgumentRepairOptions;

package/packages/tool-gateway/dist/src/argument-guard.js

@@ -1 +1 @@
-import{BetterToolValidationError as o,betterTools as t,defaultRepair as e,reliableToolCalls as r}from"@botbotgo/better-call";import{isRecord as a,validateWithZodSchema as i}from"./schema-validation.js";export class ToolArgumentValidationError extends Error{toolId;issues;constructor(o,t){super(`Tool argument validation failed for ${o}: ${t.map(o=>`${o.path} ${o.message}`).join("; ")}`),this.toolId=o,this.issues=t,this.name="ToolArgumentValidationError"}}export function createDefaultArgumentGuard(t={}){return{async validate(e){const r=e.tool.validateArgs?await e.tool.validateArgs({args:e.args,context:e.context}):{action:"allow",args:e.args};if("reject"===r.action)return r;const n=await async function(t,e,r){return i(t.schema,e)||(a(t.schema)?async function(t,e,r){try{return{action:"allow",args:await s(t,r).invoke(e)}}catch(t){if(t instanceof o)return{action:"reject",reason:"BetterCall validation failed",issues:t.issues.map(c)};throw t}}(t,e,r):{action:"allow",args:e})}(e.tool,r.args,t.betterCall);return"reject"===n.action?n:"repair"===r.action?{...r,args:n.args}:n}}}export function assertToolArguments(o,t,e,r){return Promise.resolve(r.validate({tool:o,args:t,context:e})).then(t=>{if("reject"===t.action)throw new ToolArgumentValidationError(o.id,t.issues);return t.args})}export function prepareBetterCallTools(o,e){const r=t(o.map(n),d(e));return o.map((o,t)=>({...o,validationTool:r[t]}))}export async function repairBetterCallToolSelection(o){const t=(i=o.options,i?.repair??(i?.repairModel?e(i.repairModel):void 0));var i;if(!t||0===o.tools.length)return;const s=await r({userInput:JSON.stringify({tool:o.toolId,args:o.args}),tools:o.tools.map(l),calls:[{tool:o.toolId,args:(n=o.args,a(n)?n:{input:n})}],repair:t,mode:o.options?.mode??"repair"});var n;const c=s.ok?s.calls.find(t=>o.tools.some(o=>o.id===t.tool)):void 0;return c?{toolId:c.tool,args:c.args}:void 0}function s(o,e){return o.validationTool??t([n(o)],d(e))[0]}function n(o){return{name:o.id,description:o.description,schema:o.schema,invoke:o=>o}}function l(o){return{name:o.id,description:o.description,schema:a(o.schema)?o.schema:void 0}}function c(o){return{path:o.path.replace(/^\$\.calls\[\d+\]\.args/u,"$"),message:o.message,expected:void 0===o.expected?void 0:String(o.expected),actual:o.actual}}function d(o){return{mode:o?.mode??"repair",repair:o?.repair,repairModel:o?.repairModel}}
+import{BetterToolValidationError as o,betterTools as t,defaultRepair as e,reliableToolCalls as a}from"@botbotgo/better-call";import{isRecord as r,validateWithZodSchema as i}from"./schema-validation.js";export class ToolArgumentValidationError extends Error{toolId;issues;constructor(o,t){super(`Tool argument validation failed for ${o}: ${t.map(o=>`${o.path} ${o.message}`).join("; ")}`),this.toolId=o,this.issues=t,this.name="ToolArgumentValidationError"}}export function createDefaultArgumentGuard(t={}){return{async validate(e){const a=e.tool.validateArgs?await e.tool.validateArgs({args:e.args,context:e.context}):{action:"allow",args:e.args};if("reject"===a.action)return a;const r=await async function validateWithBetterCall(t,e,a){const r=i(t.schema,e);if(void 0===t.schema)return r??{action:"allow",args:e};const l=await async function invokeBetterCallValidation(t,e,a){try{return{action:"allow",args:await createBetterCallValidationTool(t,a).invoke(e)}}catch(t){if(t instanceof o)return{action:"reject",reason:"BetterCall validation failed",issues:t.issues.map(toToolArgumentIssue)};throw t}}(t,"allow"===r?.action?r.args:e,a);return r?"allow"===r.action?l:"reject"===l.action?r:i(t.schema,l.args)||l:l}(e.tool,a.args,t.betterCall);return"reject"===r.action?r:"repair"===a.action?{...a,args:r.args}:r}}}export function assertToolArguments(o,t,e,a){return Promise.resolve(a.validate({tool:o,args:t,context:e})).then(t=>{if("reject"===t.action)throw new ToolArgumentValidationError(o.id,t.issues);return t.args})}export function prepareBetterCallTools(o,e){const a=t(o.map(toBetterCallTool),toBetterToolsOptions(e));return o.map((o,t)=>({...o,validationTool:a[t]}))}export async function repairBetterCallToolSelection(o){const t=function resolveRepair(o){return o?.repair??(o?.repairModel?e(o.repairModel):void 0)}(o.options);if(!t||0===o.tools.length)return;const i=await a({userInput:JSON.stringify({tool:o.toolId,args:o.args}),tools:o.tools.map(toToolDefinition),calls:[{tool:o.toolId,args:(l=o.args,r(l)?l:{input:l})}],repair:t,repairPolicy:o.options?.repairPolicy??{allowCoercion:!0,allowClamp:!0,allowArrayStringSplit:!0,allowModelRepair:!0},mode:o.options?.mode??"repair"});var l;const n=i.ok?i.calls.find(t=>o.tools.some(o=>o.id===t.tool)):void 0;return n?{toolId:n.tool,args:n.args}:void 0}function createBetterCallValidationTool(o,e){return o.validationTool??t([toBetterCallTool(o)],toBetterToolsOptions(e))[0]}function toBetterCallTool(o){return{name:o.id,description:o.description,schema:o.schema,invoke:o=>o}}function toToolDefinition(o){return{name:o.id,description:o.description,schema:o.schema}}function toToolArgumentIssue(o){return{path:o.path.replace(/^\$\.calls\[\d+\]\.args/u,"$"),message:o.message,expected:void 0===o.expected?void 0:String(o.expected),actual:o.actual}}function toBetterToolsOptions(o){return{mode:o?.mode??"repair",repair:o?.repair,repairModel:o?.repairModel,repairPolicy:o?.repairPolicy??{allowCoercion:!0,allowClamp:!0,allowArrayStringSplit:!0,allowModelRepair:!0}}}

package/packages/tool-gateway/dist/src/in-memory.js

@@ -1 +1 @@
-import{assertToolArguments as o,createDefaultArgumentGuard as t,prepareBetterCallTools as e,repairBetterCallToolSelection as a}from"./argument-guard.js";export function createInMemoryToolGateway(r,l={}){const s=new Map(e(r,l.betterCall).map(o=>[o.id,o])),n=t(l),i=async o=>{const t=o.allowedToolIds?new Set(o.allowedToolIds):void 0,e=[...s.values()].filter(o=>!t||t.has(o.id));return a({toolId:o.toolId,args:o.args,tools:e,options:l.betterCall})};return{list:()=>[...s.values()],get:o=>s.get(o),repairToolCall:i,async invoke(t){const e=s.has(t.toolId)?void 0:await i(t),a=e?.toolId??t.toolId,r=s.get(a);if(!r)throw new Error(`Tool is not registered: ${t.toolId}`);const l=await o(r,e?.args??t.args,t.context,n);return{toolId:r.id,output:await r.invoke(l,t.context)}}}}
+import{assertToolArguments as o,createDefaultArgumentGuard as t,prepareBetterCallTools as e,repairBetterCallToolSelection as r,ToolArgumentValidationError as a}from"./argument-guard.js";export function createInMemoryToolGateway(l,i={}){const s=new Map(e(l,i.betterCall).map(o=>[o.id,o])),n=t(i),repairToolCall=async o=>{const t=o.allowedToolIds?new Set(o.allowedToolIds):void 0,e=[...s.values()].filter(o=>!t||t.has(o.id));return r({toolId:o.toolId,args:o.args,tools:e,options:withRequestRepairModel(i.betterCall,o.repairModel)})};return{list:()=>[...s.values()],get:o=>s.get(o),repairToolCall:repairToolCall,async invoke(t){const e=s.has(t.toolId)?void 0:await repairToolCall(t),r=e?.toolId??t.toolId,l=s.get(r);if(!l)throw new Error(`Tool is not registered: ${t.toolId}`);const i=await async function assertToolArgumentsWithRepair(t){try{return await o(t.tool,t.initialArgs,t.request.context,t.guard)}catch(e){if(!(e instanceof a))throw e;const r=await t.repairToolCall({...t.request,args:t.initialArgs,allowedToolIds:[t.tool.id]});if(!r||r.toolId!==t.tool.id)throw e;return o(t.tool,r.args,t.request.context,t.guard)}}({request:t,tool:l,initialArgs:e?.args??t.args,repairToolCall:repairToolCall,guard:n});return{toolId:l.id,output:await l.invoke(i,t.context)}}}}function withRequestRepairModel(o,t){return!t||o?.repair||o?.repairModel?o:{...o,mode:o?.mode??"repair",repairModel:t}}

package/packages/tool-gateway/dist/src/module-loader.js

@@ -1 +1 @@
-import o from"node:path";import{pathToFileURL as e}from"node:url";import{createInMemoryToolGateway as t}from"./in-memory.js";export async function createModuleToolGateway(o){const e=[];for(const t of o.tools){const o=await r(t);o&&e.push(o)}return t(e,o.options)}async function r(t){if(!t.sourcePath)return;const r=await import(e(o.resolve(t.sourcePath)).href),n=r[t.name??t.id]??r.default;var i;return"object"==typeof(i=n)&&null!==i&&"invoke"in i&&"function"==typeof i.invoke?{id:t.id,description:t.description??n.description,schema:t.schema??n.schema,validateArgs:n.validateArgs,invoke:(o,e)=>async function(o,e,t){const r=process.cwd();try{return process.chdir(t.workspaceRoot),await o(e)}finally{process.chdir(r)}}(n.invoke,o,e)}:void 0}
+import o from"node:path";import{pathToFileURL as e}from"node:url";import{createInMemoryToolGateway as t}from"./in-memory.js";export async function createModuleToolGateway(o){const e=[];for(const t of o.tools){const o=await loadModuleTool(t);o&&e.push(o)}return t(e,o.options)}async function loadModuleTool(t){if(!t.sourcePath)return;const n=await import(e(o.resolve(t.sourcePath)).href),r=n[t.name??t.id]??n.default;return function hasInvoke(o){return"object"==typeof o&&null!==o&&"invoke"in o&&"function"==typeof o.invoke}(r)?{id:t.id,description:t.description??r.description,schema:t.schema??r.schema,validateArgs:r.validateArgs,invoke:(o,e)=>async function invokeWithWorkspaceCwd(o,e,t){const n=process.cwd();try{return process.chdir(t.workspaceRoot),await o(e)}finally{process.chdir(n)}}(r.invoke,o,e)}:void 0}

package/packages/tool-gateway/dist/src/schema-validation.js

@@ -1 +1 @@
-export function validateWithZodSchema(r,a){return s(r)?e(r.safeParse(a??{})):isRecord(t=r)&&Object.values(t).length>0&&Object.values(t).every(s)?function(s,r){const a=isRecord(r)?r:{},t={},o=[];for(const[e,r]of Object.entries(s)){const s=r.safeParse(a[e]);s.success?void 0!==s.data&&(t[e]=s.data):o.push(...s.error.issues.map(s=>({...s,path:[e,...s.path]})))}return o.length>0?e({success:!1,error:{issues:o}}):{action:"allow",args:t}}(r,a):void 0;var t}export function isRecord(e){return"object"==typeof e&&null!==e&&!Array.isArray(e)}function e(e){return e.success?{action:"allow",args:e.data}:{action:"reject",reason:"Zod schema validation failed",issues:e.error.issues.map(e=>{return{path:(s=e.path,s.length>0?`$.${s.map(String).join(".")}`:"$"),message:e.message,expected:"schema"};var s})}}function s(e){return isRecord(e)&&"function"==typeof e.safeParse}
+import{normalizeArgsBySchema as e}from"@botbotgo/better-call";export function validateWithZodSchema(t,o){return isZodLike(t)?toZodGuardResult(t.safeParse(o??{})):function isZodShape(e){return isRecord(e)&&Object.values(e).length>0&&Object.values(e).every(isZodLike)}(t)?function validateWithZodShape(t,o){const r=function normalizeZodShapeArgs(t,o){const r=isRecord(o)?o:{};return e(t,r,{allowCoercion:!0,allowClamp:!0,allowArrayStringSplit:!0}).args}(t,o),a={},s=[];for(const[e,o]of Object.entries(t)){const t=o.safeParse(r[e]);t.success?void 0!==t.data&&(a[e]=t.data):s.push(...t.error.issues.map(t=>({...t,path:[e,...t.path]})))}return s.length>0?toZodGuardResult({success:!1,error:{issues:s}}):{action:"allow",args:a}}(t,o):void 0}export function isRecord(e){return"object"==typeof e&&null!==e&&!Array.isArray(e)}function toZodGuardResult(e){return e.success?{action:"allow",args:e.data}:{action:"reject",reason:"Zod schema validation failed",issues:e.error.issues.map(e=>{return{path:(t=e.path,t.length>0?`$.${t.map(String).join(".")}`:"$"),message:e.message,expected:"schema"};var t})}}function isZodLike(e){return isRecord(e)&&"function"==typeof e.safeParse}

package/packages/tool-gateway/dist/src/types.d.ts

@@ -44,6 +44,9 @@ export type ToolArgumentValidator = (input: {
 export type ToolGatewayInvokeRequest = {
     toolId: string;
     args?: unknown;
+    repairModel?: {
+        invoke(input: unknown): Promise<unknown> | unknown;
+    };
     context: ToolGatewayContext;
 };
 export type ToolGatewayRepairRequest = ToolGatewayInvokeRequest & {

package/packages/tool-gateway/package.json

@@ -10,6 +10,6 @@
   "main": "dist/src/index.js",
   "types": "dist/src/index.d.ts",
   "dependencies": {
-    "@botbotgo/better-call": "^0.1.1"
+    "@botbotgo/better-call": "^0.1.18"
   }
 }