stable-harness 0.0.2 → 0.0.4

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

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

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

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

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

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

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

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

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

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

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

@@ -0,0 +1,101 @@
+import type { WorkspaceEvaluation } from "../evaluations/index.js";
+import type { WorkspaceSpecDrivenWorkflowPolicy } from "../spec-driven/index.js";
+import type { WorkspaceWorkflow, WorkspaceWorkflowEdge, WorkspaceWorkflowRoutingPolicy } from "../workflows/index.js";
+export type WorkspaceModel = {
+    id: string;
+    provider: string;
+    model: string;
+    config?: Record<string, unknown>;
+};
+export type WorkspaceTool = {
+    id: string;
+    description?: string;
+    schema?: unknown;
+    implementation?: string;
+    sourcePath?: string;
+};
+export type WorkspaceSkill = {
+    id: string;
+    path: string;
+    description?: string;
+    allowedTools: string[];
+};
+export type WorkspaceMemory = {
+    id: string;
+    provider: string;
+    profile?: string;
+    mode?: string;
+    enabled: boolean;
+    prompts?: {
+        semantic?: string;
+        episodic?: string;
+        procedural?: string;
+    };
+    config?: Record<string, unknown>;
+};
+export type WorkspaceAgent = {
+    id: string;
+    description?: string;
+    sourcePath?: string;
+    backend: string;
+    modelRef?: string;
+    systemPrompt?: string;
+    tools: string[];
+    skills?: string[];
+    memory?: unknown[];
+    subagents: string[];
+    edges?: WorkspaceWorkflowEdge[];
+    config: Record<string, unknown>;
+};
+export type WorkspaceRuntimePolicy = {
+    defaultAgentId: string;
+    workspaceId?: string;
+    profile?: string;
+    adapters?: WorkspaceAdapterPolicy[];
+    workflowRouting?: WorkspaceWorkflowRoutingPolicy;
+    specDrivenWorkflow?: WorkspaceSpecDrivenWorkflowPolicy;
+    approvals?: Record<string, unknown>;
+    recovery?: Record<string, unknown>;
+    retry?: WorkspaceRetryPolicy;
+    toolGateway?: Record<string, unknown>;
+    memory?: Record<string, unknown>;
+    protocols?: Record<string, unknown>;
+    progress?: Record<string, unknown>;
+    cli?: Record<string, unknown>;
+    responseLanguage?: Record<string, unknown>;
+    responsePresentation?: Record<string, unknown>;
+};
+export type WorkspaceAdapterPolicy = {
+    name: string;
+    enabled?: boolean;
+    config?: Record<string, unknown>;
+};
+export type WorkspaceRetryPolicy = {
+    model?: WorkspaceRetryTargetPolicy;
+    tools?: WorkspaceToolRetryPolicy;
+};
+export type WorkspaceRetryTargetPolicy = {
+    enabled?: boolean;
+    maxRetries?: number;
+    retryOn?: WorkspaceRetryReason[];
+    backoffFactor?: number;
+    initialDelayMs?: number;
+    maxDelayMs?: number;
+    jitter?: boolean;
+    onFailure?: "continue" | "error";
+};
+export type WorkspaceToolRetryPolicy = WorkspaceRetryTargetPolicy & {
+    tools?: string[];
+};
+export type WorkspaceRetryReason = "timeout" | "network" | "rateLimit" | "serverError";
+export type CompiledWorkspace = {
+    root: string;
+    runtime: WorkspaceRuntimePolicy;
+    agents: Map<string, WorkspaceAgent>;
+    models: Map<string, WorkspaceModel>;
+    tools: Map<string, WorkspaceTool>;
+    skills: Map<string, WorkspaceSkill>;
+    memories: Map<string, WorkspaceMemory>;
+    workflows: Map<string, WorkspaceWorkflow>;
+    evaluations?: Map<string, WorkspaceEvaluation>;
+};

package/packages/core/dist/workspace/types.js

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