stable-harness 0.0.3 → 0.0.4

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

@@ -2,62 +2,108 @@ import type { MemoryCandidate, MemoryDecision, MemoryRecord } from "@stable-harn
 import type { ApprovalRequest } from "@stable-harness/governance";
 import type { RuntimeArtifact } from "../types.js";
 export type RuntimeEvent = {
-    type: "request.started";
+    type: "runtime.request.started";
     requestId: string;
     sessionId: string;
     agentId: string;
+    input?: string;
 } | {
-    type: "request.completed";
+    type: "runtime.request.completed";
     requestId: string;
     sessionId: string;
     agentId: string;
     output: string;
 } | {
-    type: "request.failed";
+    type: "runtime.request.failed";
     requestId: string;
     sessionId: string;
     agentId: string;
     error: string;
 } | {
-    type: "request.cancelled";
+    type: "runtime.request.cancelled";
     requestId: string;
     sessionId: string;
     agentId: string;
     reason?: string;
 } | {
-    type: "artifact.created";
+    type: "runtime.artifact.created";
     requestId: string;
     sessionId: string;
     agentId: string;
     artifact: RuntimeArtifact;
 } | {
-    type: "execution.contract.failed";
+    type: "runtime.execution.contract.failed";
     requestId: string;
     sessionId: string;
     agentId: string;
     reason: string;
     missingEvidenceTools?: string[];
 } | {
-    type: "tool.started";
+    type: "runtime.tool.direct.started";
     requestId: string;
     sessionId: string;
     agentId: string;
     toolId: string;
 } | {
-    type: "tool.completed";
+    type: "runtime.tool.direct.completed";
     requestId: string;
     sessionId: string;
     agentId: string;
     toolId: string;
     output: unknown;
 } | {
-    type: "memory.lifecycle";
+    type: "runtime.workflow.started";
+    requestId: string;
+    sessionId: string;
+    agentId: string;
+    workflowId: string;
+    adapter: string;
+} | {
+    type: "runtime.workflow.completed";
+    requestId: string;
+    sessionId: string;
+    agentId: string;
+    workflowId: string;
+    adapter: string;
+} | {
+    type: "runtime.specDriven.phase.started";
+    requestId: string;
+    sessionId: string;
+    agentId: string;
+    phaseId: string;
+    workflowId?: string;
+} | {
+    type: "runtime.specDriven.phase.blocked";
+    requestId: string;
+    sessionId: string;
+    agentId: string;
+    phaseId: string;
+    workflowId?: string;
+    reason: string;
+} | {
+    type: "runtime.specDriven.phase.completed";
+    requestId: string;
+    sessionId: string;
+    agentId: string;
+    phaseId: string;
+    workflowId?: string;
+    artifact?: RuntimeArtifact;
+} | {
+    type: "runtime.specDriven.phase.verified";
+    requestId: string;
+    sessionId: string;
+    agentId: string;
+    phaseId: string;
+    workflowId?: string;
+    artifact?: RuntimeArtifact;
+} | {
+    type: "runtime.memory.lifecycle";
     requestId: string;
     sessionId: string;
     agentId: string;
     hook: RuntimeMemoryHook;
 } | {
-    type: "memory.recall.completed";
+    type: "runtime.memory.recall.completed";
     requestId: string;
     sessionId: string;
     agentId: string;
@@ -65,7 +111,7 @@ export type RuntimeEvent = {
     recordIds: string[];
     context: string;
 } | {
-    type: "memory.candidate.submitted";
+    type: "runtime.memory.candidate.submitted";
     requestId: string;
     sessionId: string;
     agentId: string;
@@ -73,13 +119,13 @@ export type RuntimeEvent = {
     decision: MemoryDecision;
     record?: MemoryRecord;
 } | {
-    type: "memory.approval.requested";
+    type: "runtime.memory.approval.requested";
     requestId: string;
     sessionId: string;
     agentId: string;
     approval: ApprovalRequest;
 } | {
-    type: "memory.plugin.started";
+    type: "runtime.memory.plugin.started";
     requestId: string;
     sessionId: string;
     agentId: string;
@@ -87,7 +133,7 @@ export type RuntimeEvent = {
     provider: string;
     namespace: string;
 } | {
-    type: "memory.plugin.completed";
+    type: "runtime.memory.plugin.completed";
     requestId: string;
     sessionId: string;
     agentId: string;
@@ -96,7 +142,7 @@ export type RuntimeEvent = {
     namespace: string;
     candidateCount: number;
 } | {
-    type: "memory.plugin.failed";
+    type: "runtime.memory.plugin.failed";
     requestId: string;
     sessionId: string;
     agentId: string;
@@ -105,27 +151,27 @@ export type RuntimeEvent = {
     namespace: string;
     error: string;
 } | {
-    type: "memory.maintenance.started";
+    type: "runtime.memory.maintenance.started";
     requestId: string;
     sessionId: string;
     agentId: string;
     target: string;
 } | {
-    type: "memory.maintenance.completed";
+    type: "runtime.memory.maintenance.completed";
     requestId: string;
     sessionId: string;
     agentId: string;
     target: string;
     operationCount: number;
 } | {
-    type: "memory.maintenance.failed";
+    type: "runtime.memory.maintenance.failed";
     requestId: string;
     sessionId: string;
     agentId: string;
     target: string;
     error: string;
 } | {
-    type: "skill.candidate.created";
+    type: "runtime.skill.candidate.created";
     requestId: string;
     sessionId: string;
     agentId: string;
@@ -136,7 +182,18 @@ export type RuntimeEvent = {
     status: string;
     proposedPath?: string;
 } | {
-    type: "adapter.event";
+    type: "runtime.progress.narration";
+    requestId: string;
+    sessionId: string;
+    agentId: string;
+    message: string;
+    provider: string;
+    sourceEventTypes: string[];
+    sourceEventIds?: string[];
+    model?: string;
+    style?: string;
+} | {
+    type: "runtime.adapter.event";
     requestId: string;
     sessionId: string;
     agentId: string;

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

@@ -1 +1 @@
-export function emitMemoryLifecycle(e,t,r,s,n,o){e&&t({type:"memory.lifecycle",requestId:r,sessionId:s,agentId:n,hook:o})}export async function runMemoryRecall(t){if(!t.memory)return;if(emitMemoryLifecycle(t.memory,t.emit,t.requestId,t.sessionId,t.agent.id,"read-before-plan"),!1===t.request.memory?.recall)return;const r=e(t.workspace,t.agent,t.request),s=t.request.memory?.recall?.query??t.request.input,n=await t.memory.recall({namespace:r,query:s,limit:t.request.memory?.recall?.limit});return t.emit({type:"memory.recall.completed",requestId:t.requestId,sessionId:t.sessionId,agentId:t.agent.id,namespace:r,recordIds:n.records.map(e=>e.id),context:n.context}),{namespace:r,records:n.records,context:n.context}}export async function submitMemoryCandidates(t){if(!t.memory||!t.request.memory?.candidates?.length)return;emitMemoryLifecycle(t.memory,t.emit,t.requestId,t.sessionId,t.agent.id,"write-after-run");const r=e(t.workspace,t.agent,t.request);for(const e of t.request.memory.candidates){const s={...e,namespace:e.namespace??r},n=await t.memory.submitCandidate(s);if(t.emit({type:"memory.candidate.submitted",requestId:t.requestId,sessionId:t.sessionId,agentId:t.agent.id,candidate:n.candidate,decision:n.decision,record:n.record}),"review"===n.decision.action&&t.approvals){const e=await t.approvals.create({kind:"memory_write",reason:n.decision.reason,requestId:t.requestId,sessionId:t.sessionId,agentId:t.agent.id,subject:{candidate:n.candidate,decision:n.decision}});t.emit({type:"memory.approval.requested",requestId:t.requestId,sessionId:t.sessionId,agentId:t.agent.id,approval:e})}}}function e(e,t,r){return r.memory?.namespace??`${e.root}:${t.id}`}
+export function emitMemoryLifecycle(e,r,t,s,o,n){e&&r({type:"runtime.memory.lifecycle",requestId:t,sessionId:s,agentId:o,hook:n})}export async function runMemoryRecall(e){if(!e.memory)return;if(emitMemoryLifecycle(e.memory,e.emit,e.requestId,e.sessionId,e.agent.id,"read-before-plan"),!1===e.request.memory?.recall)return;const r=resolveMemoryNamespace(e.workspace,e.agent,e.request),t=e.request.memory?.recall?.query??e.request.input,s=await e.memory.recall({namespace:r,query:t,limit:e.request.memory?.recall?.limit});return e.emit({type:"runtime.memory.recall.completed",requestId:e.requestId,sessionId:e.sessionId,agentId:e.agent.id,namespace:r,recordIds:s.records.map(e=>e.id),context:s.context}),{namespace:r,records:s.records,context:s.context}}export async function submitMemoryCandidates(e){if(!e.memory||!e.request.memory?.candidates?.length)return;emitMemoryLifecycle(e.memory,e.emit,e.requestId,e.sessionId,e.agent.id,"write-after-run");const r=resolveMemoryNamespace(e.workspace,e.agent,e.request);for(const t of e.request.memory.candidates){const s={...t,namespace:t.namespace??r},o=await e.memory.submitCandidate(s);if(e.emit({type:"runtime.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 r=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:"runtime.memory.approval.requested",requestId:e.requestId,sessionId:e.sessionId,agentId:e.agent.id,approval:r})}}}function resolveMemoryNamespace(e,r,t){return t.memory?.namespace??`${e.root}:${r.id}`}

package/packages/core/dist/runtime/persistence/artifacts.js

@@ -1 +1 @@
-import{existsSync as t,mkdirSync as e,readFileSync as r,writeFileSync as n}from"node:fs";import i from"node:path";export function createInMemoryArtifactStore(t){const e=new Map((t?.records??[]).map(t=>[t.id,s(t)])),r=new Map(Object.entries(t?.contents??{}).map(([t,e])=>[t,structuredClone(e)]));return{createArtifact(t){const n=function(t){return{id:t.id,kind:t.kind,uri:t.uri,metadata:t.metadata,requestId:t.requestId,sessionId:t.sessionId,agentId:t.agentId,contentType:t.contentType,createdAt:t.createdAt??(new Date).toISOString(),size:(e=t.content,Buffer.byteLength(JSON.stringify(e??null),"utf8"))};var e}(t);return e.set(n.id,n),r.set(n.id,structuredClone(t.content??null)),s(n)},listArtifacts:t=>[...e.values()].filter(e=>function(t,e){return!e||!(e.requestId&&e.requestId!==t.requestId||e.sessionId&&e.sessionId!==t.sessionId||e.agentId&&e.agentId!==t.agentId)}(e,t)).map(s),readArtifact(t){if(!r.has(t))throw new Error(`Artifact not found: ${t}`);return structuredClone(r.get(t))}}}export function createJsonFileArtifactStore(s){const o=i.resolve(s),c=createInMemoryArtifactStore(function(e){if(!t(e))return{records:[],contents:{}};const n=JSON.parse(r(e,"utf8"));if("object"!=typeof(i=n)||null===i||!Array.isArray(i.records)||"object"!=typeof i.contents)throw new Error(`Invalid artifact store file: ${e}`);var i;return n}(o));return{createArtifact(t){const r=c.createArtifact(t);return function(t,r){e(i.dirname(t),{recursive:!0}),n(t,`${JSON.stringify({version:1,...r},null,2)}\n`)}(o,function(t){const e=t.listArtifacts(),r=Object.fromEntries(e.map(e=>[e.id,t.readArtifact(e.id)]));return{records:e,contents:r}}(c)),r},listArtifacts:t=>c.listArtifacts(t),readArtifact:t=>c.readArtifact(t)}}function s(t){return structuredClone(t)}
+import{existsSync as t,mkdirSync as e,readFileSync as r,writeFileSync as n}from"node:fs";import i from"node:path";export function createInMemoryArtifactStore(t){const e=new Map((t?.records??[]).map(t=>[t.id,cloneRecord(t)])),r=new Map(Object.entries(t?.contents??{}).map(([t,e])=>[t,structuredClone(e)]));return{createArtifact(t){const n=function toRecord(t){return{id:t.id,kind:t.kind,uri:t.uri,metadata:t.metadata,requestId:t.requestId,sessionId:t.sessionId,agentId:t.agentId,contentType:t.contentType,createdAt:t.createdAt??(new Date).toISOString(),size:(e=t.content,Buffer.byteLength(JSON.stringify(e??null),"utf8"))};var e}(t);return e.set(n.id,n),r.set(n.id,structuredClone(t.content??null)),cloneRecord(n)},listArtifacts:t=>[...e.values()].filter(e=>function matchesFilter(t,e){return!e||!(e.requestId&&e.requestId!==t.requestId||e.sessionId&&e.sessionId!==t.sessionId||e.agentId&&e.agentId!==t.agentId)}(e,t)).map(cloneRecord),readArtifact(t){if(!r.has(t))throw new Error(`Artifact not found: ${t}`);return structuredClone(r.get(t))}}}export function createJsonFileArtifactStore(c){const o=i.resolve(c),s=createInMemoryArtifactStore(function readArtifactFile(e){if(!t(e))return{records:[],contents:{}};const n=JSON.parse(r(e,"utf8"));if(!function isState(t){return"object"==typeof t&&null!==t&&Array.isArray(t.records)&&"object"==typeof t.contents}(n))throw new Error(`Invalid artifact store file: ${e}`);return n}(o));return{createArtifact(t){const r=s.createArtifact(t);return function writeArtifactFile(t,r){e(i.dirname(t),{recursive:!0}),n(t,`${JSON.stringify({version:1,...r},null,2)}\n`)}(o,function snapshot(t){const e=t.listArtifacts(),r=Object.fromEntries(e.map(e=>[e.id,t.readArtifact(e.id)]));return{records:e,contents:r}}(s)),r},listArtifacts:t=>s.listArtifacts(t),readArtifact:t=>s.readArtifact(t)}}function cloneRecord(t){return structuredClone(t)}

package/packages/core/dist/runtime/persistence/inspection.js

@@ -1 +1 @@
-export function projectRequestSummary(t){return{requestId:t.requestId,sessionId:t.sessionId,agentId:t.agentId,parentRunId:t.parentRunId,state:t.state,startedAt:t.startedAt,completedAt:t.completedAt,eventCount:t.events.length,artifactCount:t.artifacts.length}}export function projectSessionSummaries(t){const e=new Map;for(const n of t)e.set(n.sessionId,[...e.get(n.sessionId)??[],n]);return[...e.entries()].map(([t,e])=>function(t,e){const r=[...e].sort((t,e)=>t.startedAt.localeCompare(e.startedAt));return{sessionId:t,requestCount:e.length,agentIds:[...new Set(e.map(t=>t.agentId))].sort(),states:n(e),startedAt:r[0]?.startedAt??"",updatedAt:s(e)}}(t,e)).sort((t,e)=>e.updatedAt.localeCompare(t.updatedAt))}export function projectRequestInspection(n,s){return{summary:projectRequestSummary(s),input:s.input,output:s.output,error:s.error,metadata:s.metadata,artifacts:s.artifacts,runtimeSnapshot:t(n,s.agentId),timeline:e(s)}}function t(t,e){const n=t.agents.get(e);return{workspaceRoot:t.root,agentId:e,backend:n?.backend??"unknown",modelRef:n?.modelRef,tools:[...n?.tools??[]],skills:[...n?.skills??[]],subagents:[...n?.subagents??[]]}}function e(t){return t.events.map((t,e)=>({index:e,type:t.type,event:t}))}function n(t){return t.reduce((t,e)=>(t[e.state]=(t[e.state]??0)+1,t),{})}function s(t){return t.map(t=>t.completedAt??t.startedAt).sort((t,e)=>e.localeCompare(t))[0]??""}
+import{applySpecDrivenPhaseTransition as t,createSpecDrivenWorkflowState as e}from"../../spec-driven/index.js";export function projectRequestSummary(t){return{requestId:t.requestId,sessionId:t.sessionId,agentId:t.agentId,parentRunId:t.parentRunId,state:t.state,startedAt:t.startedAt,completedAt:t.completedAt,eventCount:t.events.length,artifactCount:t.artifacts.length}}export function projectSessionSummaries(t){const e=new Map;for(const n of t)e.set(n.sessionId,[...e.get(n.sessionId)??[],n]);return[...e.entries()].map(([t,e])=>function projectSessionSummary(t,e){const n=[...e].sort((t,e)=>t.startedAt.localeCompare(e.startedAt));return{sessionId:t,requestCount:e.length,agentIds:[...new Set(e.map(t=>t.agentId))].sort(),states:countStates(e),startedAt:n[0]?.startedAt??"",updatedAt:latestTimestamp(e)}}(t,e)).sort((t,e)=>e.updatedAt.localeCompare(t.updatedAt))}export function projectRequestInspection(t,e){return{summary:projectRequestSummary(e),input:e.input,output:e.output,error:e.error,metadata:e.metadata,artifacts:e.artifacts,runtimeSnapshot:projectBindingSnapshot(t,e.agentId),...t.runtime.specDrivenWorkflow?{specDrivenWorkflow:projectSpecDrivenState(t.runtime.specDrivenWorkflow,e)}:{},timeline:projectTimeline(e)}}function projectSpecDrivenState(n,r){const s=new Set(n.phases.map(t=>t.id));return r.events.map(specDrivenTransition).filter(t=>void 0!==t&&s.has(t.phaseId)).reduce(t,e(n))}function specDrivenTransition(t){if(!function isSpecDrivenPhaseEvent(t){return t.type.startsWith("runtime.specDriven.phase.")}(t))return;const e=t.type.slice(25);return["started","blocked","completed","verified"].includes(e)?{phaseId:t.phaseId,status:e,..."artifact"in t&&t.artifact?{artifact:t.artifact}:{},..."reason"in t?{reason:t.reason}:{}}:void 0}function projectBindingSnapshot(t,e){const n=t.agents.get(e);return{workspaceRoot:t.root,agentId:e,backend:n?.backend??"unknown",modelRef:n?.modelRef,tools:[...n?.tools??[]],skills:[...n?.skills??[]],subagents:[...n?.subagents??[]]}}function projectTimeline(t){return t.events.map((t,e)=>({index:e,type:t.type,event:t}))}function countStates(t){return t.reduce((t,e)=>(t[e.state]=(t[e.state]??0)+1,t),{})}function latestTimestamp(t){return t.map(t=>t.completedAt??t.startedAt).sort((t,e)=>e.localeCompare(t))[0]??""}

package/packages/core/dist/runtime/persistence/queue.js

@@ -1 +1 @@
-export function createInMemoryRuntimeQueueStore(){const s=new Map,a=new Map,o=new Map;return{enqueue(e){const t=e.enqueuedAt??(new Date).toISOString(),n=r({...e,enqueuedAt:t,attemptCount:e.attemptCount??0});return s.set(n.requestId,n),r(n)},listQueue:()=>e([...s.values()]).map(r),getQueuedRequest:e=>t(s.get(e),r),claimNext(t){const n=function(t,r){const n=Date.parse(r.now??(new Date).toISOString());return e(t).find(e=>{const t=Date.parse(e.availableAt)<=n,u=!r.queueKey||e.queueKey===r.queueKey,s=!e.leaseExpiresAt||Date.parse(e.leaseExpiresAt)<=n;return t&&u&&s})}([...s.values()],t);if(!n)return;const u=t.now??(new Date).toISOString(),o=function(e,t,r,n){return{...e,claimedBy:t,claimedAt:r,leaseExpiresAt:new Date(Date.parse(r)+n).toISOString(),attemptCount:e.attemptCount+1}}(n,t.workerId,u,t.leaseMs);return s.set(o.requestId,o),a.set(o.requestId,{requestId:o.requestId,cancelRequested:a.get(o.requestId)?.cancelRequested??!1,workerId:t.workerId,workerStartedAt:a.get(o.requestId)?.workerStartedAt??u,heartbeatAt:u}),r(o)},heartbeat(e){const t=a.get(e.requestId);if(!t||t.workerId!==e.workerId)return;const r={...t,heartbeatAt:e.now??(new Date).toISOString()};return a.set(e.requestId,r),n(r)},requestCancel(e){const t={...a.get(e.requestId),requestId:e.requestId,cancelRequested:!0,cancelReason:e.reason,cancelRequestedAt:e.now??(new Date).toISOString()};return a.set(e.requestId,t),n(t)},getControl:e=>t(a.get(e),n),listStuck(e){const t=Date.parse(e.now??(new Date).toISOString());return[...s.values()].filter(r=>function(e,t,r,n){if(!e.claimedAt)return!1;const u=Date.parse(t?.heartbeatAt??e.claimedAt);return!!e.leaseExpiresAt&&Date.parse(e.leaseExpiresAt)<r||r-u>n}(r,a.get(r.requestId),t,e.staleAfterMs)).map(r)},saveRecoveryIntent:e=>(o.set(e.requestId,u(e)),u(e)),getRecoveryIntent:e=>t(o.get(e),u),clearRecoveryIntent:e=>o.delete(e)}}function e(e){return[...e].sort((e,t)=>{const r=t.priority-e.priority;return 0===r?e.enqueuedAt.localeCompare(t.enqueuedAt):r})}function t(e,t){return e?t(e):void 0}function r(e){return structuredClone(e)}function n(e){return structuredClone(e)}function u(e){return structuredClone(e)}
+export function createInMemoryRuntimeQueueStore(){const e=new Map,t=new Map,r=new Map;return{enqueue(t){const r=t.enqueuedAt??(new Date).toISOString(),n=cloneQueueRecord({...t,enqueuedAt:r,attemptCount:t.attemptCount??0});return e.set(n.requestId,n),cloneQueueRecord(n)},listQueue:()=>sortQueue([...e.values()]).map(cloneQueueRecord),getQueuedRequest:t=>cloneOptional(e.get(t),cloneQueueRecord),claimNext(r){const n=function findClaimCandidate(e,t){const r=Date.parse(t.now??(new Date).toISOString());return sortQueue(e).find(e=>{const n=Date.parse(e.availableAt)<=r,o=!t.queueKey||e.queueKey===t.queueKey,u=!e.leaseExpiresAt||Date.parse(e.leaseExpiresAt)<=r;return n&&o&&u})}([...e.values()],r);if(!n)return;const o=r.now??(new Date).toISOString(),u=function claimRecord(e,t,r,n){return{...e,claimedBy:t,claimedAt:r,leaseExpiresAt:new Date(Date.parse(r)+n).toISOString(),attemptCount:e.attemptCount+1}}(n,r.workerId,o,r.leaseMs);return e.set(u.requestId,u),t.set(u.requestId,{requestId:u.requestId,cancelRequested:t.get(u.requestId)?.cancelRequested??!1,workerId:r.workerId,workerStartedAt:t.get(u.requestId)?.workerStartedAt??o,heartbeatAt:o}),cloneQueueRecord(u)},heartbeat(e){const r=t.get(e.requestId);if(!r||r.workerId!==e.workerId)return;const n={...r,heartbeatAt:e.now??(new Date).toISOString()};return t.set(e.requestId,n),cloneControl(n)},requestCancel(e){const r={...t.get(e.requestId),requestId:e.requestId,cancelRequested:!0,cancelReason:e.reason,cancelRequestedAt:e.now??(new Date).toISOString()};return t.set(e.requestId,r),cloneControl(r)},getControl:e=>cloneOptional(t.get(e),cloneControl),listStuck(r){const n=Date.parse(r.now??(new Date).toISOString());return[...e.values()].filter(e=>function isStuck(e,t,r,n){if(!e.claimedAt)return!1;const o=Date.parse(t?.heartbeatAt??e.claimedAt);return!!e.leaseExpiresAt&&Date.parse(e.leaseExpiresAt)<r||r-o>n}(e,t.get(e.requestId),n,r.staleAfterMs)).map(cloneQueueRecord)},saveRecoveryIntent:e=>(r.set(e.requestId,cloneRecovery(e)),cloneRecovery(e)),getRecoveryIntent:e=>cloneOptional(r.get(e),cloneRecovery),clearRecoveryIntent:e=>r.delete(e)}}function sortQueue(e){return[...e].sort((e,t)=>{const r=t.priority-e.priority;return 0===r?e.enqueuedAt.localeCompare(t.enqueuedAt):r})}function cloneOptional(e,t){return e?t(e):void 0}function cloneQueueRecord(e){return structuredClone(e)}function cloneControl(e){return structuredClone(e)}function cloneRecovery(e){return structuredClone(e)}

package/packages/core/dist/runtime/persistence/stores.js

@@ -1 +1 @@
-import{existsSync as e,mkdirSync as n,readFileSync as t,writeFileSync as r}from"node:fs";import u from"node:path";export function createInMemoryRuntimeStore(e=[]){const n=new Map(e.map(e=>[e.requestId,o(e)]));return{createRun(e){n.set(e.requestId,o(e))},updateRun(e,t){const r=n.get(e);if(r)return Object.assign(r,function(e){return structuredClone(e)}(t)),o(r)},appendEvent(e){const t=n.get(e.requestId);if(t)return t.events.push(function(e){return structuredClone(e)}(e)),o(t)},getRun(e){return(t=n.get(e))?o(t):void 0;var t},listRuns:e=>[...n.values()].filter(n=>function(e,n){return!n||!(n.agentId&&n.agentId!==e.agentId||n.sessionId&&n.sessionId!==e.sessionId||n.state&&n.state!==e.state)}(n,e)).map(o)}}export function createJsonFileRuntimeStore(n){const r=u.resolve(n),o=createInMemoryRuntimeStore(function(n){if(!e(n))return[];const r=JSON.parse(t(n,"utf8"));if(!a(r)||!Array.isArray(r.runs))throw new Error(`Invalid runtime store file: ${n}`);return r.runs.map(i)}(r));return{createRun(e){o.createRun(e),s(r,o.listRuns())},updateRun(e,n){const t=o.updateRun(e,n);return s(r,o.listRuns()),t},appendEvent(e){const n=o.appendEvent(e);return s(r,o.listRuns()),n},getRun:e=>o.getRun(e),listRuns:e=>o.listRuns(e)}}function s(e,t){n(u.dirname(e),{recursive:!0}),r(e,`${JSON.stringify({version:1,runs:t},null,2)}\n`)}function i(e){if(!a(e)||"string"!=typeof e.requestId)throw new Error("Invalid runtime run record in store file");return o(e)}function o(e){return structuredClone(e)}function a(e){return"object"==typeof e&&null!==e&&!Array.isArray(e)}
+import{existsSync as e,mkdirSync as t,readFileSync as n,writeFileSync as r}from"node:fs";import u from"node:path";export function createInMemoryRuntimeStore(e=[]){const t=new Map(e.map(e=>[e.requestId,cloneRun(e)]));return{createRun(e){t.set(e.requestId,cloneRun(e))},updateRun(e,n){const r=t.get(e);if(r)return Object.assign(r,function clonePatch(e){return structuredClone(e)}(n)),cloneRun(r)},appendEvent(e){const n=t.get(e.requestId);if(!n)return;const r=function eventArtifact(e){return"artifact"in e&&e.artifact?e.artifact:void 0}(e);return r&&!n.artifacts.some(e=>e.id===r.id)&&n.artifacts.push(structuredClone(r)),n.events.push(function cloneEvent(e){return structuredClone(e)}(e)),cloneRun(n)},getRun:e=>function cloneOptionalRun(e){return e?cloneRun(e):void 0}(t.get(e)),listRuns:e=>[...t.values()].filter(t=>function matchesFilter(e,t){return!t||!(t.agentId&&t.agentId!==e.agentId||t.sessionId&&t.sessionId!==e.sessionId||t.state&&t.state!==e.state)}(t,e)).map(cloneRun)}}export function createJsonFileRuntimeStore(t){const r=u.resolve(t),i=createInMemoryRuntimeStore(function readStoreFile(t){if(!e(t))return[];const r=JSON.parse(n(t,"utf8"));if(!isRecord(r)||!Array.isArray(r.runs))throw new Error(`Invalid runtime store file: ${t}`);return r.runs.map(assertRunRecord)}(r));return{createRun(e){i.createRun(e),writeStoreFile(r,i.listRuns())},updateRun(e,t){const n=i.updateRun(e,t);return writeStoreFile(r,i.listRuns()),n},appendEvent(e){const t=i.appendEvent(e);return writeStoreFile(r,i.listRuns()),t},getRun:e=>i.getRun(e),listRuns:e=>i.listRuns(e)}}function writeStoreFile(e,n){t(u.dirname(e),{recursive:!0}),r(e,`${JSON.stringify({version:1,runs:n},null,2)}\n`)}function assertRunRecord(e){if(!isRecord(e)||"string"!=typeof e.requestId)throw new Error("Invalid runtime run record in store file");return cloneRun(e)}function cloneRun(e){return structuredClone(e)}function isRecord(e){return"object"==typeof e&&null!==e&&!Array.isArray(e)}

package/packages/core/dist/runtime/progress-narration.d.ts

@@ -0,0 +1,33 @@
+import type { RuntimeEvent } from "./events.js";
+export type RuntimeProgressNarrationProvider = {
+    name: string;
+    narrate(event: RuntimeEvent, context: RuntimeProgressNarrationContext): RuntimeProgressNarrationResult;
+};
+export type RuntimeProgressNarrationResult = RuntimeProgressNarrationOutput | undefined | Promise<RuntimeProgressNarrationOutput | undefined>;
+export type RuntimeProgressNarrationContext = {
+    style?: string;
+    model?: string;
+};
+export type RuntimeProgressNarrationOutput = {
+    message: string;
+    sourceEventTypes?: string[];
+    sourceEventIds?: string[];
+    model?: string;
+    style?: string;
+};
+export type RuntimeProgressNarrationOptions = {
+    enabled?: boolean;
+    style?: string;
+    model?: string;
+    provider?: RuntimeProgressNarrationProvider;
+};
+export declare function resolveProgressNarrator(input: {
+    options?: RuntimeProgressNarrationOptions | false;
+    policy?: Record<string, unknown>;
+}): RuntimeProgressNarrationProvider | undefined;
+export declare function createProgressNarrationEvent(input: {
+    source: RuntimeEvent;
+    narrator: RuntimeProgressNarrationProvider | undefined;
+    options?: RuntimeProgressNarrationOptions | false;
+    policy?: Record<string, unknown>;
+}): RuntimeEvent | Promise<RuntimeEvent | undefined> | undefined;

package/packages/core/dist/runtime/progress-narration.js

@@ -0,0 +1 @@
+export function resolveProgressNarrator(e){if(!1===e.options)return;const t=readProgressPolicy(e.policy);return e.options?.enabled??t.enabled?e.options?.provider??function createTemplateProgressNarrator(){const e=new Map,t=new Map;return{name:"template",narrate(r,n){var o;"runtime.request.started"===r.type&&(e.set(r.requestId,{language:(o=r.input??"",/\p{Script=Han}/u.test(o)?"zh":void 0),input:r.input}),t.delete(r.requestId));const i=function templateMessage(e,t){const r="zh"===t?.language;return"runtime.request.started"===e.type?r?`我开始处理这个请求：${summarizeText(e.input)}`:`I'm starting on this request: ${summarizeText(e.input)}`:"runtime.request.completed"===e.type?r?"我已经完成执行链，正在交付最终结果。":"I've finished the execution chain and am returning the final result.":"runtime.request.failed"===e.type?r?"执行链失败了，我会保留具体错误方便定位。":"The execution chain failed; I'm keeping the concrete error visible for diagnosis.":"runtime.request.cancelled"===e.type?r?"这个请求已取消，后续执行会停止。":"The request was cancelled, so the remaining execution will stop.":"runtime.tool.direct.started"===e.type?r?`我正在运行 ${e.toolId}。`:`I'm running ${e.toolId}.`:"runtime.tool.direct.completed"===e.type?r?`${e.toolId} 已返回结果，我会继续使用这份证据。`:`${e.toolId} returned; I'll keep using that evidence.`:"runtime.workflow.started"===e.type?r?`我正在启动 workflow ${e.workflowId}。`:`I'm starting workflow ${e.workflowId}.`:"runtime.workflow.completed"===e.type?r?`workflow ${e.workflowId} 已完成。`:`Workflow ${e.workflowId} is complete.`:"runtime.specDriven.phase.started"===e.type?r?`我正在进入 spec-driven 阶段 ${e.phaseId}。`:`I'm starting spec-driven phase ${e.phaseId}.`:"runtime.specDriven.phase.blocked"===e.type?r?`spec-driven 阶段 ${e.phaseId} 被 gate 阻塞。`:`Spec-driven phase ${e.phaseId} is blocked by a gate.`:"runtime.specDriven.phase.completed"===e.type?r?`spec-driven 阶段 ${e.phaseId} 已完成。`:`Spec-driven phase ${e.phaseId} is complete.`:"runtime.specDriven.phase.verified"===e.type?r?`spec-driven 阶段 ${e.phaseId} 已验证。`:`Spec-driven phase ${e.phaseId} is verified.`:"runtime.artifact.created"===e.type?r?"我已经保存一份运行产物。":"I've saved a runtime artifact.":"runtime.execution.contract.failed"===e.type?r?"运行证据没有满足执行契约，我会进入恢复或失败路径。":"The run evidence did not satisfy the execution contract, so I'll recover or fail explicitly.":"runtime.skill.candidate.created"===e.type?r?`我发现一个可沉淀的 skill 候选：${e.name}。`:`I found a reusable skill candidate: ${e.name}.`:e.type.startsWith("runtime.memory.")?function memoryMessage(e,t){return"runtime.memory.lifecycle"===e.type?t?`我进入记忆阶段：${e.hook}。`:`I'm in the memory lifecycle phase: ${e.hook}.`:"runtime.memory.recall.completed"===e.type?t?`我召回了 ${e.recordIds.length} 条相关记忆。`:`I recalled ${e.recordIds.length} relevant memory records.`:"runtime.memory.candidate.submitted"===e.type?t?"我提交了一条候选记忆。":"I submitted a memory candidate.":"runtime.memory.approval.requested"===e.type?t?"我提交了记忆审批请求。":"I requested memory approval.":"runtime.memory.plugin.started"===e.type?t?`我正在运行记忆插件 ${e.provider}。`:`I'm running memory plugin ${e.provider}.`:"runtime.memory.plugin.completed"===e.type?t?`记忆插件 ${e.provider} 已完成。`:`Memory plugin ${e.provider} completed.`:"runtime.memory.plugin.failed"===e.type?t?`记忆插件 ${e.provider} 失败了；主任务会继续，不把它当成执行结果。`:`Memory plugin ${e.provider} failed; the main task will continue without treating it as the result.`:"runtime.memory.maintenance.started"===e.type?t?`我正在维护 ${e.target} 记忆。`:`I'm maintaining ${e.target} memory.`:"runtime.memory.maintenance.completed"===e.type?t?`${e.target} 记忆维护完成。`:`${e.target} memory maintenance completed.`:"runtime.memory.maintenance.failed"===e.type?t?`${e.target} 记忆维护失败。`:`${e.target} memory maintenance failed.`:void 0}(e,r):"runtime.adapter.event"===e.type?function adapterMessage(e,t){if(isRecord(e))return"agent.handoff"===e.phase?t?"我把请求交给上游 agent backend，让它负责规划和执行。":"I'm handing the request to the upstream agent backend for planning and execution.":"agent.tool.start"===e.phase&&"string"==typeof e.toolId?function toolStartMessage(e,t,r){if("task"===e){const e=function readTaskTarget(e){const t=isRecord(e)?e:{};return readString(t.subagent_type)??readString(t.subagentType)}(t),n=function readDescription(e){const t=isRecord(e)?e:{};return summarizeText(readString(t.description)??readString(t.task))}(t);if(e&&n)return r?`我正在请求 task 工具委派给 ${e}：${n}`:`I'm asking the task tool to delegate to ${e}: ${n}`;if(e)return r?`我正在请求 task 工具委派给 ${e}。`:`I'm asking the task tool to delegate to ${e}.`}return r?`我正在运行 ${e} 收集证据。`:`I'm running ${e} to gather evidence.`}(e.toolId,e.args,t):"agent.tool.result"===e.phase&&"string"==typeof e.toolId?function toolResultMessage(e,t,r,n,o){if(r)return o?`${e} 返回错误：${summarizeText(String(r))}`:`${e} returned an error: ${summarizeText(String(r))}`;const i="string"==typeof n?n:function readToolControlStatus(e){const t=function parseToolOutputRecord(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);return"string"==typeof t?.status?t.status:"string"==typeof t?.error?t.error:"string"==typeof e&&e.startsWith("Task delegation target is not in the workspace inventory")?"task_inventory_blocked":void 0}(t);if(i)return function toolControlMessage(e,t,r){return"duplicate_tool_call"===t?r?`${e} 重复调用已复用已有证据。`:`${e} repeated an equivalent call, so the existing evidence was reused.`:"repeated_tool_call_limit"===t?r?`${e} 出现重复调用循环，我会基于已有证据继续收敛。`:`${e} entered a repeated-call loop, so I'll continue from the evidence already collected.`:"tool_argument_error"===t||"tool_argument_validation_failed"===t?r?`${e} 参数被工具 schema 拒绝，我会让 agent 修正参数或改用合适工具。`:`${e} arguments were rejected by the tool schema; I'll have the agent repair them or choose a suitable tool.`:"task_inventory_blocked"===t?r?"task 委派目标不在当前 workspace inventory 中，已被运行时策略阻止。":"The task delegation target is not in the current workspace inventory and was blocked by runtime policy.":r?`${e} 返回运行时控制状态：${t}。`:`${e} returned runtime control status: ${t}.`}(e,i,o);if("task"===e)return o?"委派任务已返回结果，我会基于这些证据继续推进。":"The delegated task returned; I'll keep going with that evidence.";const a=function summarizeToolOutput(e){if("string"==typeof e)return summarizeText(e);if(isRecord(e)){if("string"==typeof e.status)return summarizeText(e.status);if("string"==typeof e.summary)return summarizeText(e.summary)}}(t);return o?`${e} 已返回${a?`：${a}`:"，我会继续判断下一步。"}`:`${e} returned${a?`: ${a}`:"; I'll decide the next step from here."}`}(e.toolId,e.output,e.error,e.controlStatus,t):"agent.langgraph.invoke"===e.phase?t?"我正在调用 workflow backend。":"I'm invoking the workflow backend.":"agent.node.completed"===e.phase&&"string"==typeof e.nodeId?t?`节点 ${e.nodeId} 已完成。`:`Node ${e.nodeId} is complete.`:void 0}(e.event,r):void 0}(r,e.get(r.requestId));if(i&&i!==t.get(r.requestId))return t.set(r.requestId,i),"runtime.request.failed"!==r.type&&"runtime.request.cancelled"!==r.type||(e.delete(r.requestId),t.delete(r.requestId)),function pruneRequestState(e,t){for(;e.size>200;){const r=e.keys().next().value;if(!r)break;e.delete(r),t.delete(r)}}(e,t),{message:i,style:n.style,model:n.model}}}}():void 0}export function createProgressNarrationEvent(e){if(!e.narrator||"runtime.progress.narration"===e.source.type)return;const t=readProgressPolicy(e.policy),r=!1===e.options?void 0:e.options,n=e.narrator.narrate(e.source,{style:r?.style??t.style,model:r?.model??t.model});return function isPromiseLike(e){return isRecord(e)&&"function"==typeof e.then}(n)?n.then(t=>toNarrationEvent(e.source,e.narrator,t)):toNarrationEvent(e.source,e.narrator,n)}function toNarrationEvent(e,t,r){if(r?.message.trim())return{type:"runtime.progress.narration",requestId:e.requestId,sessionId:e.sessionId,agentId:e.agentId,message:r.message,provider:t.name,sourceEventTypes:r.sourceEventTypes??[e.type],sourceEventIds:r.sourceEventIds,model:r.model,style:r.style}}function summarizeText(e){const t=e?.replace(/\s+/gu," ").trim();return t?t.length>120?`${t.slice(0,117)}...`:t:""}function readString(e){return"string"==typeof e&&e.trim()?e:void 0}function readProgressPolicy(e){const t=isRecord(e?.progress)?e.progress:{},r=isRecord(t.narration)?t.narration:{};return{enabled:"boolean"==typeof r.enabled?r.enabled:void 0,style:"string"==typeof r.style?r.style:void 0,model:"string"==typeof r.model?r.model:void 0}}function isRecord(e){return"object"==typeof e&&null!==e&&!Array.isArray(e)}

package/packages/core/dist/runtime/tool-gateway.d.ts

@@ -13,12 +13,16 @@ export type RuntimeToolGatewayTool = {
     description?: string;
     schema?: unknown;
 };
+export type RuntimeToolRepairModel = {
+    invoke(input: unknown): Promise<unknown> | unknown;
+};
 export type RuntimeToolGateway = {
     get(toolId: string): RuntimeToolGatewayTool | undefined;
     repairToolCall?(request: {
         toolId: string;
         args?: unknown;
         allowedToolIds?: string[];
+        repairModel?: RuntimeToolRepairModel;
         context: RuntimeToolGatewayContext;
     }): Promise<{
         toolId: string;
@@ -27,6 +31,7 @@ export type RuntimeToolGateway = {
     invoke(request: {
         toolId: string;
         args?: unknown;
+        repairModel?: RuntimeToolRepairModel;
         context: RuntimeToolGatewayContext;
     }): Promise<{
         toolId: string;

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

@@ -1,6 +1,6 @@
 import type { ApprovalQueue } from "@stable-harness/governance";
 import type { MemoryProvider, RuntimeMemoryStore } from "@stable-harness/memory";
-import type { CompiledWorkspace, RuntimeToolGateway, RuntimeAdapter, RuntimeStore, RuntimeWorkflowAdapter, StableHarnessRuntime } from "./types.js";
+import type { CompiledWorkspace, RuntimeToolGateway, RuntimeAdapter, RuntimeStore, RuntimeProgressNarrationOptions, RuntimeWorkflowAdapter, StableHarnessRuntime } from "./types.js";
 type RuntimeFactoryInput = {
     workspace: CompiledWorkspace;
     adapters: RuntimeAdapter[];
@@ -10,6 +10,7 @@ type RuntimeFactoryInput = {
     approvals?: ApprovalQueue;
     toolGateway?: RuntimeToolGateway;
     store?: RuntimeStore;
+    progressNarration?: RuntimeProgressNarrationOptions | false;
 };
 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"./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 = {