stable-harness 0.0.1 → 0.0.3

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

@@ -1,12 +1,15 @@
 import type { ApprovalQueue } from "@stable-harness/governance";
 import type { MemoryProvider, RuntimeMemoryStore } from "@stable-harness/memory";
-import type { CompiledWorkspace, RuntimeToolGateway, RuntimeAdapter, RuntimeStore, StableHarnessRuntime } from "./types.js";
-export declare function createStableHarnessRuntime(input: {
+import type { CompiledWorkspace, RuntimeToolGateway, RuntimeAdapter, RuntimeStore, RuntimeWorkflowAdapter, StableHarnessRuntime } from "./types.js";
+type RuntimeFactoryInput = {
     workspace: CompiledWorkspace;
     adapters: RuntimeAdapter[];
+    workflowAdapters?: RuntimeWorkflowAdapter[];
     memory?: RuntimeMemoryStore;
     memoryProviders?: MemoryProvider[];
     approvals?: ApprovalQueue;
     toolGateway?: RuntimeToolGateway;
     store?: RuntimeStore;
-}): StableHarnessRuntime;
+};
+export declare function createStableHarnessRuntime(input: RuntimeFactoryInput): StableHarnessRuntime;
+export {};

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"./inspection.js";import{recallMemoryPlugins as n,runMemoryPlugins as a}from"./memory-plugins.js";import{createInMemoryRuntimeStore as d}from"./stores.js";export function createStableHarnessRuntime(I){const m=new Set,l=I.store??d(),p=e=>{l.appendEvent(e);for(const t of m)t(e)};return{async request(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)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}}(I,s),d=s.requestId??e(),m=s.sessionId??e();l.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,d,m,r)),p({type:"request.started",requestId:d,sessionId:m,agentId:r.id});try{if(s.toolCall){const e=await async function(e){const t=e.request.toolCall;if(!t)throw new Error("Direct tool call request is missing");if(!e.gateway)throw new Error("Runtime tool gateway is not configured");const s=await async function(e){if(e.agent.tools.includes(e.toolId)&&e.gateway.get(e.toolId))return{toolId:e.toolId,args:e.args};const t=await(e.gateway.repairToolCall?.({toolId:e.toolId,args:e.args,allowedToolIds:e.agent.tools,context:{workspaceRoot:e.workspace.root,requestId:e.requestId,sessionId:e.sessionId,agentId:e.agent.id}}));if(t&&e.agent.tools.includes(t.toolId)&&e.gateway.get(t.toolId))return t;if(!e.agent.tools.includes(e.toolId))throw new Error(`Tool ${e.toolId} is not assigned to agent ${e.agent.id}`);throw new Error(`Tool is not registered: ${e.toolId}`)}({gateway:e.gateway,workspace:e.workspace,requestId:e.requestId,sessionId:e.sessionId,agent:e.agent,toolId:t.toolId,args:t.args});e.emit({type:"tool.started",requestId:e.requestId,sessionId:e.sessionId,agentId:e.agent.id,toolId:s.toolId});const r=await e.gateway.invoke({toolId:s.toolId,args:s.args,context:{workspaceRoot:e.workspace.root,requestId:e.requestId,sessionId:e.sessionId,agentId:e.agent.id}});return e.emit({type:"tool.completed",requestId:e.requestId,sessionId:e.sessionId,agentId:e.agent.id,toolId:r.toolId,output:r.output}),{text:(o=r.output,"string"==typeof o?o:JSON.stringify(o)),metadata:{toolCall:{toolId:r.toolId}}};var o}({gateway:I.toolGateway,workspace:I.workspace,emit:p,request:s,requestId:d,sessionId:m,agent:r});return c({store:l,emit:p,requestId:d,sessionId:m,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=await async function(e){if(!e.memory)return;if(i(e.memory,e.emit,e.requestId,e.sessionId,e.agent.id,"read-before-plan"),!1===e.request.memory?.recall)return;const t=u(e.workspace,e.agent,e.request),s=e.request.memory?.recall?.query??e.request.input,r=await e.memory.recall({namespace:t,query:s,limit:e.request.memory?.recall?.limit});return e.emit({type:"memory.recall.completed",requestId:e.requestId,sessionId:e.sessionId,agentId:e.agent.id,namespace:t,recordIds:r.records.map(e=>e.id),context:r.context}),{namespace:t,records:r.records,context:r.context}}({memory:e.input.memory,emit:e.emit,request:e.request,requestId:e.requestId,sessionId:e.sessionId,agent:e.agent,workspace:e.input.workspace}),r=await n({providers:e.input.memoryProviders,request:e.request,agent:e.agent,workspace:e.input.workspace}),o=function(e){return"string"==typeof e?{text:e}:e}(await e.adapter.run({workspace:e.input.workspace,agent:e.agent,request:e.request,requestId:e.requestId,sessionId:e.sessionId,memory:s,pluginMemories:r,toolGateway:e.input.toolGateway,emit:e.emit}));i(e.input.memory,e.emit,e.requestId,e.sessionId,e.agent.id,"read-before-finalize"),await async function(e){if(!e.memory||!e.request.memory?.candidates?.length)return;i(e.memory,e.emit,e.requestId,e.sessionId,e.agent.id,"write-after-run");const t=u(e.workspace,e.agent,e.request);for(const s of e.request.memory.candidates){const r={...s,namespace:s.namespace??t},o=await e.memory.submitCandidate(r);if(e.emit({type:"memory.candidate.submitted",requestId:e.requestId,sessionId:e.sessionId,agentId:e.agent.id,candidate:o.candidate,decision:o.decision,record:o.record}),"review"===o.decision.action&&e.approvals){const t=await e.approvals.create({kind:"memory_write",reason:o.decision.reason,requestId:e.requestId,sessionId:e.sessionId,agentId:e.agent.id,subject:{candidate:o.candidate,decision:o.decision}});e.emit({type:"memory.approval.requested",requestId:e.requestId,sessionId:e.sessionId,agentId:e.agent.id,approval:t})}}}({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});const d=c({store:e.store,emit:e.emit,requestId:e.requestId,sessionId:e.sessionId,agent:e.agent,result:o});return await a({providers:e.input.memoryProviders,emit:e.emit,request:e.request,requestId:e.requestId,sessionId:e.sessionId,agent:e.agent,workspace:e.input.workspace,result:o}),d}({input:I,store:l,emit:p,adapter:o,request:s,requestId:d,sessionId:m,agent:r})}catch(e){return function(e){const t=e.error instanceof Error?e.error.message:String(e.error);return e.store.getRun(e.requestId)&&e.store.updateRun(e.requestId,{state:"failed",error:t,completedAt:(new Date).toISOString()}),e.emit({type:"request.failed",requestId:e.requestId,sessionId:e.sessionId,agentId:e.agent.id,error:t}),{requestId:e.requestId,sessionId:e.sessionId,agentId:e.agent.id,state:"failed",output:t}}({store:l,emit:p,requestId:d,sessionId:m,agent:r,error:e})}},subscribe:e=>(m.add(e),()=>m.delete(e)),inspect:()=>({workspaceRoot:I.workspace.root,agents:[...I.workspace.agents.keys()].sort(),models:[...I.workspace.models.keys()].sort(),tools:[...I.workspace.tools.keys()].sort(),runs:l.listRuns()}),getRun:e=>l.getRun(e),listRequests:e=>l.listRuns(e).map(r),listSessions:()=>o(l.listRuns()),inspectRequest(e){const t=l.getRun(e);return t?s(I.workspace,t):void 0},cancel(e,t){const s=l.getRun(e);s&&"running"===s.state&&(l.updateRun(e,{state:"cancelled",completedAt:(new Date).toISOString()}),p({type:"request.cancelled",requestId:e,sessionId:s.sessionId,agentId:s.agentId,reason:t}))},async stop(){m.clear()}}}function i(e,t,s,r,o,n){e&&t({type:"memory.lifecycle",requestId:s,sessionId:r,agentId:o,hook:n})}function u(e,t,s){return s.memory?.namespace??`${e.root}:${t.id}`}function c(e){const t=e.store.getRun(e.requestId);if("cancelled"===t?.state)return I(e,"cancelled");t&&e.store.updateRun(e.requestId,{state:"completed",output:e.result.text,metadata:{...t.metadata,...e.result.metadata},artifacts:[...t.artifacts,...e.result.artifacts??[]],completedAt:(new Date).toISOString()});for(const t of e.result.artifacts??[])e.emit({type:"artifact.created",requestId:e.requestId,sessionId:e.sessionId,agentId:e.agent.id,artifact:t});return e.emit({type:"request.completed",requestId:e.requestId,sessionId:e.sessionId,agentId:e.agent.id,output:e.result.text}),I(e,"completed")}function I(e,t){return{requestId:e.requestId,sessionId:e.sessionId,agentId:e.agent.id,state:t,output:e.result.text,metadata:e.result.metadata,artifacts:e.result.artifacts}}
+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}

package/packages/core/dist/trace.js

@@ -1 +1 @@
-export function projectRuntimeTrace(t){return t.events.map(projectEvent).filter(r)}export function projectEvent(t){return"request.started"===t.type||"request.completed"===t.type||"request.failed"===t.type?o(t,"request",t.type):"request.cancelled"===t.type?o(t,"request",t.type,{reason:t.reason}):"execution.contract.failed"===t.type?o(t,"request",t.type,{reason:t.reason,missingEvidenceTools:t.missingEvidenceTools}):"tool.started"===t.type?o(t,"tool","tool.started",{toolId:t.toolId}):"tool.completed"===t.type?"write_todos"===t.toolId?o(t,"plan","plan.updated",{toolId:t.toolId,todos:readPlanTodos(t.output)}):o(t,"tool","tool.completed",{toolId:t.toolId}):"adapter.event"===t.type?function(t){const e=t.event;if(n(e)&&"string"==typeof e.phase){if("tool.result"===e.phase&&"write_todos"===e.toolId)return o(t,"plan","plan.updated",e);const r=function(t,e){if("task"!==e.toolId)return;const r=function(t){const e=n(t.args)?t.args:void 0,o=n(t.output)?t.output:void 0;return a(e?.subagent_type)??a(e?.subagentType)??a(o?.subagent_type)??a(o?.subagentType)}(e);return"tool.start"===e.phase?o(t,"delegation","delegation.start",{...e,subagentType:r}):"tool.result"===e.phase?o(t,"delegation","delegation.completed",{...e,subagentType:r}):void 0}(t,e);return r||o(t,"adapter",`adapter.${e.phase}`,e)}return o(t,"adapter","adapter.event",{event:e})}(t):"artifact.created"===t.type?o(t,"artifact","artifact.created",{artifact:t.artifact}):t.type.startsWith("memory.")?o(t,"memory",t.type):void 0}export function readPlanTodos(o){const r=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}}(o),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:[]}(r);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 o(t,e,o,r){return{type:e,label:o,agentId:t.agentId,requestId:t.requestId,detail:r}}function r(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(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}

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

@@ -1,398 +1,14 @@
-import type { MemoryCandidate, MemoryDecision, MemoryProvider, MemoryRecord, RuntimeMemoryStore } from "@stable-harness/memory";
-import type { ApprovalQueue, ApprovalRequest } from "@stable-harness/governance";
-export type RuntimeRecordState = "queued" | "running" | "completed" | "failed" | "cancelled";
-export type RuntimeOutput = {
-    text: string;
-    metadata?: Record<string, unknown>;
-    artifacts?: RuntimeArtifact[];
-};
-export type RuntimeArtifact = {
-    id: string;
-    kind: string;
-    uri?: string;
-    metadata?: Record<string, unknown>;
-};
-export type RuntimeArtifactRecord = RuntimeArtifact & {
-    requestId: string;
-    sessionId: string;
-    agentId: string;
-    createdAt: string;
-    contentType?: string;
-    size?: number;
-};
-export type RuntimeArtifactInput = RuntimeArtifact & {
-    requestId: string;
-    sessionId: string;
-    agentId: string;
-    content?: unknown;
-    contentType?: string;
-    createdAt?: string;
-};
-export type RuntimeArtifactStore = {
-    createArtifact(input: RuntimeArtifactInput): RuntimeArtifactRecord;
-    listArtifacts(filter?: RuntimeArtifactFilter): RuntimeArtifactRecord[];
-    readArtifact(id: string): unknown;
-};
-export type RuntimeArtifactFilter = {
-    requestId?: string;
-    sessionId?: string;
-    agentId?: string;
-};
-export type WorkspaceModel = {
-    id: string;
-    provider: string;
-    model: string;
-    config?: Record<string, unknown>;
-};
-export type WorkspaceTool = {
-    id: string;
-    description?: string;
-    schema?: unknown;
-    implementation?: string;
-    sourcePath?: string;
-};
-export type WorkspaceSkill = {
-    id: string;
-    path: string;
-    description?: string;
-    allowedTools: string[];
-};
-export type WorkspaceMemory = {
-    id: string;
-    provider: string;
-    profile?: string;
-    mode?: string;
-    enabled: boolean;
-    prompts?: {
-        semantic?: string;
-        episodic?: string;
-        procedural?: string;
-    };
-    config?: Record<string, unknown>;
-};
-export type WorkspaceAgent = {
-    id: string;
-    description?: string;
-    sourcePath?: string;
-    backend: string;
-    modelRef?: string;
-    systemPrompt?: string;
-    tools: string[];
-    skills?: string[];
-    memory?: unknown[];
-    subagents: string[];
-    config: Record<string, unknown>;
-};
-export type WorkspaceRuntimePolicy = {
-    defaultAgentId: string;
-    workspaceId?: string;
-    profile?: string;
-    approvals?: Record<string, unknown>;
-    recovery?: Record<string, unknown>;
-    retry?: WorkspaceRetryPolicy;
-    memory?: Record<string, unknown>;
-    protocols?: Record<string, unknown>;
-};
-export type WorkspaceRetryPolicy = {
-    model?: WorkspaceRetryTargetPolicy;
-    tools?: WorkspaceToolRetryPolicy;
-};
-export type WorkspaceRetryTargetPolicy = {
-    enabled?: boolean;
-    maxRetries?: number;
-    retryOn?: WorkspaceRetryReason[];
-    backoffFactor?: number;
-    initialDelayMs?: number;
-    maxDelayMs?: number;
-    jitter?: boolean;
-    onFailure?: "continue" | "error";
-};
-export type WorkspaceToolRetryPolicy = WorkspaceRetryTargetPolicy & {
-    tools?: string[];
-};
-export type WorkspaceRetryReason = "timeout" | "network" | "rateLimit" | "serverError";
-export type CompiledWorkspace = {
-    root: string;
-    runtime: WorkspaceRuntimePolicy;
-    agents: Map<string, WorkspaceAgent>;
-    models: Map<string, WorkspaceModel>;
-    tools: Map<string, WorkspaceTool>;
-    skills: Map<string, WorkspaceSkill>;
-    memories: Map<string, WorkspaceMemory>;
-};
-export type RuntimeRequest = {
-    input: string;
-    agentId?: string;
-    sessionId?: string;
-    requestId?: string;
-    parentRunId?: string;
-    toolCall?: RuntimeToolCallRequest;
-    memory?: RuntimeRequestMemory;
-    metadata?: Record<string, unknown>;
-};
-export type RuntimeToolCallRequest = {
-    toolId: string;
-    args?: unknown;
-};
-export type RuntimeRequestMemory = {
-    namespace?: string;
-    recall?: false | {
-        query?: string;
-        limit?: number;
-    };
-    candidates?: RuntimeMemoryCandidateInput[];
-};
-export type RuntimeMemoryCandidateInput = Omit<MemoryCandidate, "namespace"> & {
-    namespace?: string;
-};
-export type RuntimeResponse = {
-    requestId: string;
-    sessionId: string;
-    agentId: string;
-    state: RuntimeRecordState;
-    output: string;
-    metadata?: Record<string, unknown>;
-    artifacts?: RuntimeArtifact[];
-};
-export type RuntimeRunRecord = {
-    requestId: string;
-    sessionId: string;
-    agentId: string;
-    input: string;
-    state: RuntimeRecordState;
-    output?: string;
-    error?: string;
-    parentRunId?: string;
-    metadata?: Record<string, unknown>;
-    artifacts: RuntimeArtifact[];
-    startedAt: string;
-    completedAt?: string;
-    events: RuntimeEvent[];
-};
-export type RuntimeStoreRunPatch = Partial<Pick<RuntimeRunRecord, "state" | "output" | "error" | "metadata" | "artifacts" | "completedAt">>;
-export type RuntimeRunFilter = {
-    agentId?: string;
-    sessionId?: string;
-    state?: RuntimeRecordState;
-};
-export type RuntimeStore = {
-    createRun(record: RuntimeRunRecord): void;
-    updateRun(requestId: string, patch: RuntimeStoreRunPatch): RuntimeRunRecord | undefined;
-    appendEvent(event: RuntimeEvent): RuntimeRunRecord | undefined;
-    getRun(requestId: string): RuntimeRunRecord | undefined;
-    listRuns(filter?: RuntimeRunFilter): RuntimeRunRecord[];
-};
-export type RuntimeQueueRecord = {
-    requestId: string;
-    sessionId: string;
-    priority: number;
-    queueKey?: string;
-    enqueuedAt: string;
-    availableAt: string;
-    claimedBy?: string;
-    claimedAt?: string;
-    leaseExpiresAt?: string;
-    attemptCount: number;
-    lastError?: string;
-};
-export type RuntimeRequestControlRecord = {
-    requestId: string;
-    cancelRequested: boolean;
-    cancelReason?: string;
-    cancelRequestedAt?: string;
-    heartbeatAt?: string;
-    workerId?: string;
-    workerStartedAt?: string;
-};
-export type RuntimeRecoveryIntent = {
-    requestId: string;
-    sessionId: string;
-    kind: "approval-decision" | "restart-request";
-    savedAt: string;
-    checkpointRef?: string;
-    resumePayload?: unknown;
-    attempts: number;
-};
-export type RuntimeQueueStore = {
-    enqueue(record: Omit<RuntimeQueueRecord, "attemptCount" | "enqueuedAt"> & {
-        attemptCount?: number;
-        enqueuedAt?: string;
-    }): RuntimeQueueRecord;
-    listQueue(): RuntimeQueueRecord[];
-    getQueuedRequest(requestId: string): RuntimeQueueRecord | undefined;
-    claimNext(input: RuntimeQueueClaimInput): RuntimeQueueRecord | undefined;
-    heartbeat(input: RuntimeHeartbeatInput): RuntimeRequestControlRecord | undefined;
-    requestCancel(input: RuntimeCancelIntentInput): RuntimeRequestControlRecord;
-    getControl(requestId: string): RuntimeRequestControlRecord | undefined;
-    listStuck(input: RuntimeStuckRequestInput): RuntimeQueueRecord[];
-    saveRecoveryIntent(intent: RuntimeRecoveryIntent): RuntimeRecoveryIntent;
-    getRecoveryIntent(requestId: string): RuntimeRecoveryIntent | undefined;
-    clearRecoveryIntent(requestId: string): boolean;
-};
-export type RuntimeQueueClaimInput = {
-    workerId: string;
-    now?: string;
-    leaseMs: number;
-    queueKey?: string;
-};
-export type RuntimeHeartbeatInput = {
-    requestId: string;
-    workerId: string;
-    now?: string;
-};
-export type RuntimeCancelIntentInput = {
-    requestId: string;
-    reason?: string;
-    now?: string;
-};
-export type RuntimeStuckRequestInput = {
-    now?: string;
-    staleAfterMs: number;
-};
-export type RuntimeEvent = {
-    type: "request.started";
-    requestId: string;
-    sessionId: string;
-    agentId: string;
-} | {
-    type: "request.completed";
-    requestId: string;
-    sessionId: string;
-    agentId: string;
-    output: string;
-} | {
-    type: "request.failed";
-    requestId: string;
-    sessionId: string;
-    agentId: string;
-    error: string;
-} | {
-    type: "request.cancelled";
-    requestId: string;
-    sessionId: string;
-    agentId: string;
-    reason?: string;
-} | {
-    type: "artifact.created";
-    requestId: string;
-    sessionId: string;
-    agentId: string;
-    artifact: RuntimeArtifact;
-} | {
-    type: "execution.contract.failed";
-    requestId: string;
-    sessionId: string;
-    agentId: string;
-    reason: string;
-    missingEvidenceTools?: string[];
-} | {
-    type: "tool.started";
-    requestId: string;
-    sessionId: string;
-    agentId: string;
-    toolId: string;
-} | {
-    type: "tool.completed";
-    requestId: string;
-    sessionId: string;
-    agentId: string;
-    toolId: string;
-    output: unknown;
-} | {
-    type: "memory.lifecycle";
-    requestId: string;
-    sessionId: string;
-    agentId: string;
-    hook: RuntimeMemoryHook;
-} | {
-    type: "memory.recall.completed";
-    requestId: string;
-    sessionId: string;
-    agentId: string;
-    namespace: string;
-    recordIds: string[];
-    context: string;
-} | {
-    type: "memory.candidate.submitted";
-    requestId: string;
-    sessionId: string;
-    agentId: string;
-    candidate: MemoryCandidate;
-    decision: MemoryDecision;
-    record?: MemoryRecord;
-} | {
-    type: "memory.approval.requested";
-    requestId: string;
-    sessionId: string;
-    agentId: string;
-    approval: ApprovalRequest;
-} | {
-    type: "memory.plugin.started";
-    requestId: string;
-    sessionId: string;
-    agentId: string;
-    memoryId: string;
-    provider: string;
-    namespace: string;
-} | {
-    type: "memory.plugin.completed";
-    requestId: string;
-    sessionId: string;
-    agentId: string;
-    memoryId: string;
-    provider: string;
-    namespace: string;
-    candidateCount: number;
-} | {
-    type: "memory.plugin.failed";
-    requestId: string;
-    sessionId: string;
-    agentId: string;
-    memoryId: string;
-    provider: string;
-    namespace: string;
-    error: string;
-} | {
-    type: "memory.maintenance.started";
-    requestId: string;
-    sessionId: string;
-    agentId: string;
-    target: string;
-} | {
-    type: "memory.maintenance.completed";
-    requestId: string;
-    sessionId: string;
-    agentId: string;
-    target: string;
-    operationCount: number;
-} | {
-    type: "memory.maintenance.failed";
-    requestId: string;
-    sessionId: string;
-    agentId: string;
-    target: string;
-    error: string;
-} | {
-    type: "skill.candidate.created";
-    requestId: string;
-    sessionId: string;
-    agentId: string;
-    candidateId: string;
-    name: string;
-    confidence: number;
-    evidenceCount: number;
-    status: string;
-    proposedPath?: string;
-} | {
-    type: "adapter.event";
-    requestId: string;
-    sessionId: string;
-    agentId: string;
-    event: unknown;
-};
-export type RuntimeMemoryHook = "read-before-plan" | "read-before-finalize" | "write-after-run";
-export type RuntimeEventListener = (event: RuntimeEvent) => void;
-export type RuntimeEmit = (event: RuntimeEvent) => void;
+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 { 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 { 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 RuntimeAdapterContext = {
     workspace: CompiledWorkspace;
     agent: WorkspaceAgent;
@@ -415,6 +31,7 @@ export type RuntimeAdapter = {
     canRun(agent: WorkspaceAgent): boolean;
     run(input: RuntimeAdapterContext): Promise<RuntimeAdapterResult>;
 };
+export type { RuntimeWorkflowAdapter, RuntimeWorkflowRequest };
 export type RuntimeMemoryServices = {
     store: RuntimeMemoryStore;
     providers?: MemoryProvider[];
@@ -425,40 +42,12 @@ export type RuntimeGovernanceServices = {
 export type RuntimeToolServices = {
     gateway?: RuntimeToolGateway;
 };
-export type RuntimeToolGatewayContext = {
-    workspaceRoot: string;
-    requestId: string;
-    sessionId: string;
-    agentId: string;
-};
-export type RuntimeToolGatewayTool = {
-    id: string;
-    description?: string;
-    schema?: unknown;
-};
-export type RuntimeToolGateway = {
-    get(toolId: string): RuntimeToolGatewayTool | undefined;
-    repairToolCall?(request: {
-        toolId: string;
-        args?: unknown;
-        allowedToolIds?: string[];
-        context: RuntimeToolGatewayContext;
-    }): Promise<{
-        toolId: string;
-        args: unknown;
-    } | undefined>;
-    invoke(request: {
-        toolId: string;
-        args?: unknown;
-        context: RuntimeToolGatewayContext;
-    }): Promise<{
-        toolId: string;
-        output: unknown;
-    }>;
-};
 export type RuntimeInspectionSnapshot = {
     workspaceRoot: string;
     agents: string[];
+    workflows: string[];
+    defaultWorkflowId?: string;
+    workflowRoutes: string[];
     models: string[];
     tools: string[];
     runs: RuntimeRunRecord[];
@@ -514,6 +103,8 @@ export type RuntimeEventSource = {
 };
 export type RuntimeInspector = {
     inspect(): RuntimeInspectionSnapshot;
+    getRuntimePolicy(): WorkspaceRuntimePolicy;
+    getWorkflow(workflowId: string): WorkspaceWorkflow | undefined;
     getRun(requestId: string): RuntimeRunRecord | undefined;
     listRequests(filter?: RuntimeRunFilter): RuntimeRequestSummary[];
     listSessions(): RuntimeSessionSummary[];

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

@@ -0,0 +1,70 @@
+import type { CompiledWorkspace, RuntimeOutput, RuntimeToolGateway } from "../types.js";
+export type WorkspaceWorkflow = {
+    id: string;
+    description?: string;
+    sourcePath?: string;
+    adapter?: string;
+    entry?: string;
+    state?: WorkspaceWorkflowState;
+    nodes: WorkspaceWorkflowNode[];
+    edges: WorkspaceWorkflowEdge[];
+    policies?: Record<string, unknown>;
+    config?: Record<string, unknown>;
+};
+export type WorkspaceWorkflowState = {
+    schema?: string;
+    config?: Record<string, unknown>;
+};
+export type WorkspaceWorkflowNode = {
+    id: string;
+    use: string;
+    type?: string;
+    config?: Record<string, unknown>;
+};
+export type WorkspaceWorkflowEdge = {
+    from: string;
+    to: string;
+    condition?: string;
+};
+export type WorkspaceWorkflowRoutingPolicy = {
+    defaultWorkflowId?: string;
+    routes?: WorkspaceWorkflowRoute[];
+};
+export type WorkspaceWorkflowRoute = {
+    id: string;
+    workflowId: string;
+    description?: string;
+    metadata?: Record<string, unknown>;
+};
+export type RuntimeWorkflowRequest = {
+    workflowId?: string;
+    routeId?: string;
+    input?: unknown;
+    metadata?: Record<string, unknown>;
+};
+export type RuntimeWorkflowAdapterInput = {
+    workspace: CompiledWorkspace;
+    workflow: WorkspaceWorkflow;
+    request: RuntimeWorkflowRequest;
+    requestId: string;
+    sessionId: string;
+    toolGateway?: RuntimeToolGateway;
+    emit: (event: unknown) => void;
+};
+export type RuntimeWorkflowAdapter = {
+    name: string;
+    run(input: RuntimeWorkflowAdapterInput): Promise<string | RuntimeOutput>;
+};
+export type WorkflowPlan = {
+    workflowId: string;
+    adapter?: string;
+    entry: string;
+    nodes: WorkspaceWorkflowNode[];
+    edges: WorkspaceWorkflowEdge[];
+    terminalNodes: string[];
+    unreachableNodes: string[];
+    cycles: string[][];
+};
+export declare function compileWorkflowPlan(workflow: WorkspaceWorkflow): WorkflowPlan;
+export declare function renderWorkflowMermaid(workflow: WorkspaceWorkflow): string;
+export declare function renderAgentMermaid(workspace: CompiledWorkspace, agentId: string): string;

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

@@ -0,0 +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,'\\"')}

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

@@ -0,0 +1,12 @@
+import type { CompiledWorkspace, RuntimeEvent, RuntimeOutput } from "../types.js";
+import type { RuntimeWorkflowAdapter, RuntimeWorkflowAdapterInput, RuntimeWorkflowRequest } from "./index.js";
+export declare function runWorkflowRequest(input: {
+    workspace: CompiledWorkspace;
+    adapters: RuntimeWorkflowAdapter[];
+    toolGateway?: RuntimeWorkflowAdapterInput["toolGateway"];
+    request: RuntimeWorkflowRequest;
+    requestId: string;
+    sessionId: string;
+    agentId: string;
+    emit: (event: RuntimeEvent) => void;
+}): Promise<RuntimeOutput>;

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

@@ -0,0 +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}