stable-harness 0.0.37 → 0.0.38

package/node_modules/@stable-harness/core/dist/runtime/selection-repair.d.ts

@@ -0,0 +1,24 @@
+import type { CallCandidate, CallSelectionDiagnostics } from "@botbotgo/better-call";
+import type { RuntimeEvent, RuntimeInventoryRepairDiagnostic, RuntimeInventoryRepairLayer } from "./events.js";
+export type RuntimeSelectionRepairResult = {
+    ok: true;
+    id: string;
+    diagnostics?: CallSelectionDiagnostics;
+} | {
+    ok: false;
+    reason: string;
+    diagnostics?: CallSelectionDiagnostics;
+};
+export type RuntimeSelectionRepairTrace = {
+    layer: RuntimeInventoryRepairLayer;
+    owner: RuntimeInventoryRepairDiagnostic["owner"];
+    requestId: string;
+    sessionId: string;
+    agentId: string;
+    emit: (event: RuntimeEvent) => void;
+};
+export declare function repairRuntimeSelection(input: {
+    id: string;
+    candidates: CallCandidate[];
+    trace?: RuntimeSelectionRepairTrace;
+}): Promise<RuntimeSelectionRepairResult>;

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

@@ -0,0 +1 @@
+import{repairCallSelection as e}from"@botbotgo/better-call";export async function repairRuntimeSelection(i){const a=await e({rawIntent:i.id,candidates:i.candidates,mode:"repair"});return a.ok?(emitSelectionRepair(i,"repaired",a.candidateId,a.diagnostics),{ok:!0,id:a.candidateId,diagnostics:a.diagnostics}):(emitSelectionRepair(i,"blocked",void 0,a.diagnostics,a.reason),{ok:!1,reason:a.reason,diagnostics:a.diagnostics})}function emitSelectionRepair(e,i,a,t,n){const d=e.trace;d&&d.emit({type:"runtime.inventory.repair",requestId:d.requestId,sessionId:d.sessionId,agentId:d.agentId,status:i,diagnostic:{layer:d.layer,owner:d.owner,originalId:t?.originalId??e.id,repairedId:t?.repairedId??a,candidateIds:e.candidates.map(e=>e.id),reason:n,matchSource:t?.matchSource,confidence:t?.confidence}})}

package/node_modules/@stable-harness/core/dist/runtime/tool-failure.d.ts

@@ -0,0 +1,41 @@
+import type { RuntimeEvent } from "./events.js";
+export type RuntimeToolFailureKind = "transient" | "business" | "control" | "unknown";
+export type RuntimeToolFailureReason = "timeout" | "network" | "rate_limit" | "server_error" | "invalid_input" | "not_found" | "permission_denied" | "approval_required" | "schema_repair_failed" | "repeat_limit" | "tool_execution_failed" | "unknown";
+export type RuntimeToolFailureClassification = {
+    kind: RuntimeToolFailureKind;
+    reason: RuntimeToolFailureReason;
+    retryable: boolean;
+    message: string;
+};
+export type RuntimeToolFailurePolicy = {
+    enabled?: boolean;
+    circuitBreaker?: {
+        enabled?: boolean;
+        failureThreshold?: number;
+    };
+};
+export type RuntimeToolFailureTracker = {
+    isCircuitOpen(toolId: string): boolean;
+    recordFailure(toolId: string): boolean;
+    recordSuccess(toolId: string): void;
+};
+export declare function createToolFailureTracker(policy: RuntimeToolFailurePolicy | undefined): RuntimeToolFailureTracker;
+export declare function classifyToolFailure(error: unknown): RuntimeToolFailureClassification;
+export declare function toolFailureEvent(input: {
+    requestId: string;
+    sessionId: string;
+    agentId: string;
+    toolId: string;
+    error: unknown;
+}): Extract<RuntimeEvent, {
+    type: "runtime.tool.failure";
+}>;
+export declare function toolCircuitOpenEvent(input: {
+    requestId: string;
+    sessionId: string;
+    agentId: string;
+    toolId: string;
+    reason: RuntimeToolFailureReason;
+}): Extract<RuntimeEvent, {
+    type: "runtime.tool.circuit.opened";
+}>;

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

@@ -0,0 +1 @@
+export function createToolFailureTracker(e){const t=function readCircuitThreshold(e){const t=e?.circuitBreaker,i=t?.failureThreshold;return!1!==e?.enabled&&!0===t?.enabled&&"number"==typeof i&&Number.isInteger(i)&&i>0?i:void 0}(e),i=new Map,r=new Set;return{isCircuitOpen:e=>r.has(e),recordFailure(e){if(void 0===t)return!1;const n=(i.get(e)??0)+1;return i.set(e,n),n>=t&&(r.add(e),!0)},recordSuccess(e){i.delete(e),r.delete(e)}}}export function classifyToolFailure(e){const t=function formatToolFailureMessage(e){return e instanceof Error?e.message:String(e)}(e),i=t.toLowerCase();return/\b(timeout|timed out|etimedout)\b/u.test(i)?classification("transient","timeout",!0,t):/\b(econnreset|econnrefused|enotfound|network|fetch failed)\b/u.test(i)?classification("transient","network",!0,t):/\b(rate.?limit|too many requests|429)\b/u.test(i)?classification("transient","rate_limit",!0,t):/\b(500|502|503|504|server error|bad gateway)\b/u.test(i)?classification("transient","server_error",!0,t):/\b(approval_required|requires approval|permission denied|forbidden|401|403)\b/u.test(i)?classification("business",i.includes("approval")?"approval_required":"permission_denied",!1,t):/\b(schema repair failed|tool_argument_validation_failed|invalid input|expected .* received|validation)\b/u.test(i)?classification("control",i.includes("schema repair")?"schema_repair_failed":"invalid_input",!1,t):/\b(repeated_tool_call_limit|repeat limit)\b/u.test(i)?classification("control","repeat_limit",!1,t):/\b(not found|404)\b/u.test(i)?classification("business","not_found",!1,t):classification("unknown","tool_execution_failed",!1,t)}export function toolFailureEvent(e){const t=classifyToolFailure(e.error);return{type:"runtime.tool.failure",...e,failure:t}}export function toolCircuitOpenEvent(e){return{type:"runtime.tool.circuit.opened",...e}}function classification(e,t,i,r){return{kind:e,reason:t,retryable:i,message:r}}

package/node_modules/@stable-harness/core/dist/runtime/tool-gateway.d.ts

@@ -0,0 +1,59 @@
+export type RuntimeToolCallRequest = {
+    toolId: string;
+    args?: unknown;
+};
+export type RuntimeToolGatewayContext = {
+    workspaceRoot: string;
+    requestId: string;
+    sessionId: string;
+    agentId: string;
+    requestInput?: string;
+    observedEvidence?: string;
+    approvalIds?: string[];
+    sandbox?: RuntimeSandboxDecision;
+};
+export type RuntimeSandboxDecision = {
+    action: "allow" | "deny";
+    profile?: string;
+    reason?: string;
+    policyId?: string;
+    metadata?: Record<string, unknown>;
+};
+export type RuntimeSandboxPolicyInput = {
+    toolId: string;
+    args?: unknown;
+    context: RuntimeToolGatewayContext;
+};
+export type RuntimeSandboxPolicy = {
+    decide(input: RuntimeSandboxPolicyInput): Promise<RuntimeSandboxDecision> | RuntimeSandboxDecision;
+};
+export type RuntimeToolGatewayTool = {
+    id: string;
+    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;
+        args: unknown;
+    } | undefined>;
+    invoke(request: {
+        toolId: string;
+        args?: unknown;
+        repairModel?: RuntimeToolRepairModel;
+        context: RuntimeToolGatewayContext;
+    }): Promise<{
+        toolId: string;
+        output: unknown;
+    }>;
+};

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

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

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

@@ -0,0 +1,191 @@
+import type { MemoryCandidate } from "@stable-harness/memory";
+import type { RuntimeWorkflowRequest } from "../workflows/index.js";
+import type { RuntimeEvent } from "./events.js";
+import type { RuntimeToolCallRequest } from "./tool-gateway.js";
+export type RuntimeRecordState = "queued" | "running" | "completed" | "failed" | "cancelled";
+export type RuntimeOutput = {
+    text: string;
+    metadata?: Record<string, unknown>;
+    artifacts?: RuntimeOutputArtifact[];
+};
+export type RuntimeArtifact = {
+    id: string;
+    kind: string;
+    uri?: string;
+    metadata?: Record<string, unknown>;
+};
+export type RuntimeOutputArtifact = RuntimeArtifact & {
+    content?: unknown;
+    contentType?: string;
+};
+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 RuntimeReplayBundle = {
+    schemaVersion: 1;
+    kind: "stable-harness.replay-bundle";
+    requestId: string;
+    sessionId: string;
+    agentId: string;
+    createdAt: string;
+    run: RuntimeRunRecord;
+    events: RuntimeEvent[];
+    artifacts: RuntimeArtifactRecord[];
+    integrity: RuntimeReplayBundleIntegrity;
+};
+export type RuntimeReplayBundleIntegrity = {
+    algorithm: "sha256";
+    runHash: string;
+    eventsHash: string;
+    artifactsHash: string;
+    bundleHash: string;
+};
+export type RuntimeRequest = {
+    input: string;
+    agentId?: string;
+    sessionId?: string;
+    requestId?: string;
+    parentRunId?: string;
+    toolCall?: RuntimeToolCallRequest;
+    workflow?: RuntimeWorkflowRequest;
+    memory?: RuntimeRequestMemory;
+    metadata?: Record<string, 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;
+};

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

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

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

@@ -0,0 +1,21 @@
+import type { ApprovalQueue } from "@stable-harness/governance";
+import type { MemoryProvider, RuntimeMemoryStore } from "@stable-harness/memory";
+import type { QualityReviewModel } from "./quality/index.js";
+import type { CompiledWorkspace, RuntimeCapabilityModule, RuntimeToolGateway, RuntimeAdapter, RuntimeArtifactStore, RuntimeSandboxPolicy, RuntimeStore, RuntimeProgressNarrationOptions, RuntimeWorkflowAdapter, StableHarnessRuntime } from "./types.js";
+type RuntimeFactoryInput = {
+    workspace: CompiledWorkspace;
+    adapters: RuntimeAdapter[];
+    workflowAdapters?: RuntimeWorkflowAdapter[];
+    memory?: RuntimeMemoryStore;
+    memoryProviders?: MemoryProvider[];
+    approvals?: ApprovalQueue;
+    toolGateway?: RuntimeToolGateway;
+    sandbox?: RuntimeSandboxPolicy | false;
+    store?: RuntimeStore;
+    artifacts?: RuntimeArtifactStore;
+    progressNarration?: RuntimeProgressNarrationOptions | false;
+    qualityReviewModel?: QualityReviewModel;
+    capabilities?: RuntimeCapabilityModule[];
+};
+export declare function createStableHarnessRuntime(input: RuntimeFactoryInput): StableHarnessRuntime;
+export {};

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

@@ -0,0 +1 @@
+import{randomUUID as e}from"node:crypto";import{assertExecutionContract as t}from"./execution-contract.js";import{assertNoRawToolCallOutput as r,assertNoToolExecutionErrorOutput as a,buildAdapterErrorRecoveryPrompt as o,buildEvidenceSynthesisOutput as s,buildExecutionContractRecoveryRequest as n,buildResultRecoveryRequest as i,containsRawToolCallOutput as u,isRecoverableAdapterError as c,rawToolCallFailureMessage as l,toolCallRecoveryEnabled as p}from"./recovery/tool-call.js";import{recoverQualityReview as d,resolveQualityPolicy as m}from"./quality/index.js";import{completeRun as w,failRun as y}from"./runtime/completion.js";import{runDirectToolCall as f}from"./runtime/direct-tool-call.js";import{createApprovalGatedToolGateway as g}from"./runtime/governance/approval-gate.js";import{createSandboxedToolGateway as I}from"./runtime/governance/sandbox.js";import{createRuntimeInspectionMethods as q}from"./runtime/inspection/methods.js";import{createRuntimeCapabilityRegistry as R,normalizeAdapterResult as v}from"./runtime/capabilities.js";import{createMemoryRuntimeCapability as b}from"./runtime/memory.js";import{createInMemoryRuntimeStore as k}from"./runtime/persistence/stores.js";import{createProgressNarrationCapability as A}from"./runtime/progress-narration.js";import{repairRuntimeSelection as C}from"./runtime/selection-repair.js";import{createToolFailureTracker as x}from"./runtime/tool-failure.js";import{runWorkflowRequest as h}from"./workflows/runtime.js";export function createStableHarnessRuntime(t){const r=new Set,a=t.store??k(),s=R([b(t),A({options:t.progressNarration,policy:t.workspace.runtime}),...t.capabilities??[]]),emitBase=e=>{a.appendEvent(e);for(const t of r)t(e)},emit=e=>{emitBase(e),s.emitSideEffects(e,emitBase)},i=I({gateway:g({gateway:t.toolGateway,approvals:t.approvals,workspace:t.workspace,emit:emit}),workspace:t.workspace,sandbox:t.sandbox,emit:emit}),u={...t,toolGateway:i},l=x(function readToolFailurePolicy(e){if("object"!=typeof e||null===e||Array.isArray(e))return;const t=e.failurePolicy;return"object"!=typeof t||null===t||Array.isArray(t)?void 0:t}(t.workspace.runtime.toolGateway));return{request:async t=>async function runRuntimeRequest(t){const r=t.request.requestId??e(),a=t.request.sessionId??e(),s=[],{agent:i,adapter:u}=await async function resolveExecution(e,t,r){const a=t.agentId?await async function resolveRequestedAgentId(e,t,r){if(e.agents.has(t))return t;const a=await C({id:t,candidates:[...e.agents.values()].map(e=>({id:e.id,description:e.description})),trace:{...r,agentId:t,layer:"agent",owner:"stable_runtime_policy"}});return a.ok?a.id:t}(e.workspace,t.agentId,r):function resolveRoutedAgentId(e,t){for(const r of e.runtime.routes??[])if(routeMatches(r,t))return r.agentId;return e.runtime.defaultAgentId}(e.workspace,t.input),o=e.workspace.agents.get(a);if(!o)throw new Error(`Agent ${a} is not defined in the workspace`);if(t.toolCall||t.workflow)return{agent:o,adapter:void 0};const s=e.adapters.find(e=>e.canRun(o));if(!s)throw new Error(`No runtime adapter can run backend ${o.backend} for agent ${o.id}`);return{agent:o,adapter:s}}(t.input,t.request,{requestId:r,sessionId:a,emit:e=>s.push(e)});t.store.createRun(function createRunRecord(e,t,r,a){return{requestId:t,sessionId:r,agentId:a.id,input:e.input,state:"running",parentRunId:e.parentRunId,metadata:e.metadata,artifacts:[],startedAt:(new Date).toISOString(),events:[]}}(t.request,r,a,i)),s.forEach(t.emit),t.emit({type:"runtime.request.started",requestId:r,sessionId:a,agentId:i.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:r,sessionId:a,agentId:i.id,emit:t.emit});return w({store:t.store,emit:t.emit,requestId:r,sessionId:a,agent:i,result:e,artifacts:t.input.artifacts})}if(t.request.toolCall){const e=await f({gateway:t.input.toolGateway,workspace:t.input.workspace,emit:t.emit,request:t.request,requestId:r,sessionId:a,agent:i,toolFailureTracker:t.toolFailureTracker});return w({store:t.store,emit:t.emit,requestId:r,sessionId:a,agent:i,result:e,artifacts:t.input.artifacts})}return await async function runAdapterRequest(e){if(!e.adapter)throw new Error(`No runtime adapter can run backend ${e.agent.backend} for agent ${e.agent.id}`);const t=e.adapter,r=await e.capabilities.beforeAdapterRun(createCapabilityContext(e)),a=r.memory,s=r.pluginMemories??[],i=e.input.workspace.runtime,u=m(e.input.workspace.runtime,e.agent),l=new Map;let p;try{p=await runAdapterOnce(e,t,e.request,a,s,l)}catch(r){if(!c(r,i))throw r;p=await runAdapterOnce(e,t,o(e.request,r,i),a,s,l)}p=await recoverAdapterResultOutput(e,t,e.request,p,a,s,i,l),p=await d(createQualityRuntimeInput(e,a,s,l),e.request,p,u),await e.capabilities.beforeAdapterResultContract({...createCapabilityContext(e),result:p});try{assertRequestExecutionContract(e)}catch(r){const o=n({request:e.request,events:e.store.getRun(e.requestId)?.events??[],policy:i});if(!o)throw r;p=await runAdapterOnce(e,t,o,a,s,l),p=await recoverAdapterResultOutput(e,t,o,p,a,s,i,l),p=await d(createQualityRuntimeInput(e,a,s,l),o,p,u),assertRequestExecutionContract(e)}const y=w({store:e.store,emit:e.emit,requestId:e.requestId,sessionId:e.sessionId,agent:e.agent,result:p,artifacts:e.input.artifacts});return await e.capabilities.afterAdapterResponse({...createCapabilityContext(e),result:p,response:y}),y}({...t,adapter:u,requestId:r,sessionId:a,agent:i})}catch(e){return y({store:t.store,emit:t.emit,requestId:r,sessionId:a,agent:i,error:e})}}({input:u,capabilities:s,store:a,emit:emit,request:t,toolFailureTracker:l}),subscribe:e=>(r.add(e),()=>r.delete(e)),...q({workspace:t.workspace,store:a,artifacts:t.artifacts,approvals:t.approvals,emit:emit}),cancel(e,t){const r=a.getRun(e);r&&"running"===r.state&&(a.updateRun(e,{state:"cancelled",completedAt:(new Date).toISOString()}),emit({type:"runtime.request.cancelled",requestId:e,sessionId:r.sessionId,agentId:r.agentId,reason:t}))},async stop(){await s.stop(),r.clear()}}}function createCapabilityContext(e){return{workspace:e.input.workspace,store:e.store,emit:e.emit,request:e.request,requestId:e.requestId,sessionId:e.sessionId,agent:e.agent}}function createQualityRuntimeInput(e,t,r,a){return{workspace:e.input.workspace,agent:e.agent,request:e.request,requestId:e.requestId,sessionId:e.sessionId,events:e.store.getRun(e.requestId)?.events??[],emit:e.emit,getEvents:()=>e.store.getRun(e.requestId)?.events??[],runAdapter:o=>runAdapterOnce(e,e.adapter,o,t,r,a),reviewModel:e.input.qualityReviewModel,memory:t,pluginMemories:r}}async function recoverAdapterResultOutput(e,t,o,n,c,d,m,w){let y=o;const f=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,a="object"!=typeof r||null===r||Array.isArray(r)?void 0:r.maxResultRecoveryAttempts;return"number"==typeof a&&Number.isInteger(a)&&a>0?a:3}(m);let g=0;for(let r=0;r<f;r+=1){const r=e.store.getRun(e.requestId)?.events??[],a=i({request:y,output:n.text,events:r.slice(g),availableToolIds:e.agent.tools,policy:m});if(!a)break;y=a,g=e.store.getRun(e.requestId)?.events.length??0,n=await runAdapterOnce(e,t,a,c,d,w)}if(p(m)){let t=!1;u(n.text,m)&&function rawToolCallFailureReturnsMessage(e){return"message"===("object"!=typeof e?.toolCallRecovery||null===e.toolCallRecovery||Array.isArray(e.toolCallRecovery)?{}:e.toolCallRecovery).onFailure}(o.metadata)&&(n={...n,text:l(),metadata:{...n.metadata,toolCallRecovery:{failed:!0,reason:"raw_tool_call_output"}}});const i=s({request:o,output:n.text,events:e.store.getRun(e.requestId)?.events??[],policy:m});i&&(t=!0,n={...n,text:i,metadata:{...n.metadata,toolCallRecovery:{synthesized:!0,reason:"raw_tool_call_output_with_evidence"}}}),t||(r(n.text,m),a(n.text,m))}return n}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,a,o,s){return v(await t.run({workspace:e.input.workspace,agent:e.agent,request:r,requestId:e.requestId,sessionId:e.sessionId,memory:a,pluginMemories:o,toolGateway:e.input.toolGateway,toolFailureTracker:e.input.toolFailureTracker,requestState:s,emit:e.emit}))}function routeMatches(e,t){if(e.pattern)try{if(new RegExp(e.pattern,"iu").test(t))return!0}catch{return!1}const r=t.toLowerCase();return(e.keywords??[]).some(e=>r.includes(e.toLowerCase()))}

package/node_modules/@stable-harness/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/node_modules/@stable-harness/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/node_modules/@stable-harness/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/node_modules/@stable-harness/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/node_modules/@stable-harness/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/node_modules/@stable-harness/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/node_modules/@stable-harness/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/node_modules/@stable-harness/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/node_modules/@stable-harness/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/node_modules/@stable-harness/core/dist/spec-driven/types.js

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

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

@@ -0,0 +1,15 @@
+import type { RuntimeEvent, RuntimeRunRecord } from "./types.js";
+export type PlanTodoItem = {
+    content: string;
+    status: string;
+};
+export type RuntimeTraceEntry = {
+    type: "request" | "tool" | "workflow" | "spec" | "adapter" | "memory" | "artifact" | "progress" | "plan" | "delegation";
+    label: string;
+    agentId: string;
+    requestId: string;
+    detail?: Record<string, unknown>;
+};
+export declare function projectRuntimeTrace(run: RuntimeRunRecord): RuntimeTraceEntry[];
+export declare function projectEvent(event: RuntimeEvent): RuntimeTraceEntry | undefined;
+export declare function readPlanTodos(output: unknown): PlanTodoItem[];

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

@@ -0,0 +1 @@
+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.inventory.repair"===e.type?base(e,"adapter","runtime.inventory.repair",{status:e.status,...e.diagnostic}):"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.sandbox.decision"===e.type?base(e,"tool","runtime.sandbox.decision",{toolId:e.toolId,...e.decision}):"runtime.tool.failure"===e.type?base(e,"tool","runtime.tool.failure",{toolId:e.toolId,...e.failure}):"runtime.tool.circuit.opened"===e.type?base(e,"tool","runtime.tool.circuit.opened",{toolId:e.toolId,reason:e.reason}):"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){if("inventory.repair"===t.phase)return base(e,"adapter","runtime.inventory.repair",{status:t.status,...isRecord(t.diagnostic)?t.diagnostic:{}});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);return r&&o?base(e,r,o,t):void 0}(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/node_modules/@stable-harness/core/dist/types.d.ts

@@ -0,0 +1,144 @@
+import type { MemoryProvider, MemoryRecord, RuntimeMemoryStore } from "@stable-harness/memory";
+import type { ApprovalQueue, ApprovalRequest, ApprovalRequestStatus } 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 { RuntimeToolFailureTracker } from "./runtime/tool-failure.js";
+import type { RuntimeArtifact, RuntimeArtifactFilter, RuntimeArtifactRecord, RuntimeOutput, RuntimeRecordState, RuntimeRequest, RuntimeResponse, RuntimeReplayBundle, 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 { BoundaryScanFinding, BoundaryScanLayer, BoundaryScanLayerResult, BoundaryScanResource, BoundaryScanResult } from "./boundary-scan.js";
+export type { RuntimeCapabilityContext, RuntimeCapabilityModule, RuntimeCapabilityRegistry, RuntimeCapabilityState } from "./runtime/capabilities.js";
+export type { RuntimeProgressNarrationOptions, RuntimeProgressNarrationProvider } from "./runtime/progress-narration.js";
+export type { RuntimeArtifact, RuntimeArtifactFilter, RuntimeArtifactInput, RuntimeArtifactRecord, RuntimeArtifactStore, RuntimeOutputArtifact, RuntimeCancelIntentInput, RuntimeHeartbeatInput, RuntimeMemoryCandidateInput, RuntimeOutput, RuntimeQueueClaimInput, RuntimeQueueRecord, RuntimeQueueStore, RuntimeRecoveryIntent, RuntimeRecordState, RuntimeRequest, RuntimeRequestControlRecord, RuntimeRequestMemory, RuntimeResponse, RuntimeReplayBundle, RuntimeReplayBundleIntegrity, RuntimeRunFilter, RuntimeRunRecord, RuntimeStore, RuntimeStoreRunPatch, RuntimeStuckRequestInput, } from "./runtime/types.js";
+export type { CompiledWorkspace, WorkspaceAdapterPolicy, WorkspaceAgent, WorkspaceBoundaryDiagnostic, WorkspaceBoundaryDiagnosticCode, WorkspaceBoundaryScanPolicy, WorkspaceMemory, WorkspaceModel, WorkspaceRetryPolicy, WorkspaceRetryReason, WorkspaceRetryTargetPolicy, WorkspaceRuntimePolicy, WorkspaceSkill, WorkspaceTool, WorkspaceToolRetryPolicy, WorkspaceValidationPolicy, } from "./workspace/types.js";
+export type { WorkspaceToolQualityDiagnostic, WorkspaceToolQualityDiagnosticCode, WorkspaceToolQualityPolicy, } from "./workspace/tool-quality.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, RuntimeSandboxDecision, RuntimeSandboxPolicy, RuntimeSandboxPolicyInput, } from "./runtime/tool-gateway.js";
+export type { RuntimeToolFailureClassification, RuntimeToolFailureKind, RuntimeToolFailurePolicy, RuntimeToolFailureReason, RuntimeToolFailureTracker, } from "./runtime/tool-failure.js";
+export type RuntimeAdapterContext = {
+    workspace: CompiledWorkspace;
+    agent: WorkspaceAgent;
+    request: RuntimeRequest;
+    requestId: string;
+    sessionId: string;
+    memory?: RuntimeMemoryContext;
+    pluginMemories?: RuntimeMemoryContext[];
+    toolGateway?: RuntimeToolGateway;
+    toolFailureTracker?: RuntimeToolFailureTracker;
+    requestState?: Map<string, unknown>;
+    emit: RuntimeEmit;
+};
+export type RuntimeMemoryContext = {
+    namespace: string;
+    records: MemoryRecord[];
+    context: string;
+};
+export type RuntimeAdapterResult = string | RuntimeOutput;
+export type RuntimeAdapter = {
+    name: string;
+    canRun(agent: WorkspaceAgent): boolean;
+    run(input: RuntimeAdapterContext): Promise<RuntimeAdapterResult>;
+};
+export type { RuntimeWorkflowAdapter, RuntimeWorkflowRequest };
+export type RuntimeMemoryServices = {
+    store: RuntimeMemoryStore;
+    providers?: MemoryProvider[];
+};
+export type RuntimeGovernanceServices = {
+    approvals?: ApprovalQueue;
+};
+export type RuntimeToolServices = {
+    gateway?: RuntimeToolGateway;
+};
+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;
+    agentId: string;
+    parentRunId?: string;
+    state: RuntimeRecordState;
+    startedAt: string;
+    completedAt?: string;
+    eventCount: number;
+    artifactCount: number;
+};
+export type RuntimeSessionSummary = {
+    sessionId: string;
+    requestCount: number;
+    agentIds: string[];
+    states: Partial<Record<RuntimeRecordState, number>>;
+    startedAt: string;
+    updatedAt: string;
+};
+export type RuntimeBindingSnapshot = {
+    workspaceRoot: string;
+    agentId: string;
+    backend: string;
+    modelRef?: string;
+    tools: string[];
+    skills: string[];
+    subagents: string[];
+};
+export type RuntimeTimelineItem = {
+    index: number;
+    type: RuntimeEvent["type"];
+    event: RuntimeEvent;
+};
+export type RuntimeRequestInspection = {
+    summary: RuntimeRequestSummary;
+    input: string;
+    output?: string;
+    error?: string;
+    metadata?: Record<string, unknown>;
+    artifacts: RuntimeArtifact[];
+    runtimeSnapshot: RuntimeBindingSnapshot;
+    specDrivenWorkflow?: SpecDrivenWorkflowState;
+    timeline: RuntimeTimelineItem[];
+};
+export type RuntimeClient = {
+    request(request: RuntimeRequest): Promise<RuntimeResponse>;
+};
+export type RuntimeEventSource = {
+    subscribe(listener: RuntimeEventListener): () => void;
+};
+export type RuntimeInspector = {
+    inspect(): RuntimeInspectionSnapshot;
+    getRuntimePolicy(): WorkspaceRuntimePolicy;
+    getWorkflow(workflowId: string): WorkspaceWorkflow | undefined;
+    getRun(requestId: string): RuntimeRunRecord | undefined;
+    listArtifacts(filter?: RuntimeArtifactFilter): RuntimeArtifactRecord[];
+    getArtifact(id: string): RuntimeArtifactRecord | undefined;
+    readArtifact(id: string): unknown | undefined;
+    exportReplayBundle(requestId: string): RuntimeReplayBundle | undefined;
+    listRequests(filter?: RuntimeRunFilter): RuntimeRequestSummary[];
+    listSessions(): RuntimeSessionSummary[];
+    inspectRequest(requestId: string): RuntimeRequestInspection | undefined;
+    listApprovals(status?: ApprovalRequestStatus): Promise<ApprovalRequest[]>;
+    getApproval(id: string): Promise<ApprovalRequest | undefined>;
+    resolveApproval(id: string, status: Exclude<ApprovalRequestStatus, "pending">): Promise<ApprovalRequest | undefined>;
+};
+export type RuntimeLifecycle = {
+    cancel(requestId: string, reason?: string): void;
+    stop(): Promise<void>;
+};
+export type StableHarnessRuntime = RuntimeClient & RuntimeEventSource & RuntimeInspector & RuntimeLifecycle;

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

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