stable-harness 0.0.2 → 0.0.3

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

@@ -0,0 +1,92 @@
+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;
+    approvals?: Record<string, unknown>;
+    recovery?: Record<string, unknown>;
+    retry?: WorkspaceRetryPolicy;
+    memory?: Record<string, unknown>;
+    protocols?: 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>;
+};

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

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

package/packages/governance/dist/src/types.d.ts

@@ -66,7 +66,7 @@ export type SkillCandidate = {
 export type SkillCandidateEvidence = {
     id: string;
     candidateId: string;
-    evidenceType: "memory_record" | "run" | "tool_event" | "validation" | "user_correction" | "deepagents_memory_file";
+    evidenceType: "memory_record" | "memory_file" | "run" | "tool_event" | "validation" | "user_correction";
     evidenceRef: string;
     summary?: string;
     weight?: number;

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

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

package/packages/protocols/dist/src/in-process-client.js

@@ -1 +1 @@
-export function createInProcessClient(e){return{request:s=>e.request(s),subscribe:s=>e.subscribe(s),inspect:()=>e.inspect(),getRun:s=>e.getRun(s),listRequests:s=>e.listRequests(s),listSessions:()=>e.listSessions(),inspectRequest:s=>e.inspectRequest(s),cancel:(s,t)=>e.cancel(s,t),stop:()=>e.stop()}}
+export function createInProcessClient(e){return{request:s=>e.request(s),subscribe:s=>e.subscribe(s),inspect:()=>e.inspect(),getRuntimePolicy:()=>e.getRuntimePolicy(),getWorkflow:s=>e.getWorkflow(s),getRun:s=>e.getRun(s),listRequests:s=>e.listRequests(s),listSessions:()=>e.listSessions(),inspectRequest:s=>e.inspectRequest(s),cancel:(s,t)=>e.cancel(s,t),stop:()=>e.stop()}}

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

@@ -1 +1 @@
-import{createServer as e}from"node:http";import{randomUUID as t}from"node:crypto";export function createOpenAiCompatibleHttpServer(r,c={}){return e(async(e,p)=>{try{if(function(e,t,n){return"OPTIONS"===e.method&&(t.writeHead(204,l(n)),t.end(),!0)}(e,p,c))return;if(!function(e,t){return!t.bearerToken||e.headers.authorization===`Bearer ${t.bearerToken}`}(e,c))return void u(p,401,{error:{message:"unauthorized",type:"invalid_request_error"}},c);if("GET"===e.method&&"/v1/models"===e.url)return void u(p,200,function(e,t){const n=Object.keys(t.modelAgentMap??{});return{object:"list",data:[...new Set([...e.inspect().agents,...n])].sort().map(e=>({id:e,object:"model",created:0,owned_by:"stable-harness"}))}}(r,c),c);if("GET"===e.method&&"/v1/capabilities"===e.url)return void u(p,200,{object:"stable_harness.capabilities",endpoints:["/v1/models","/v1/chat/completions","/v1/capabilities"],streaming:!0,toolProgressEvents:!0},c);if("POST"===e.method&&"/v1/chat/completions"===e.url)return void await async function(e,r,c,p){const f=await async function(e){const t=[];for await(const n of e)t.push(Buffer.isBuffer(n)?n:Buffer.from(n));return 0===t.length?{}:JSON.parse(Buffer.concat(t).toString("utf8"))}(r);if(f.model&&!o(f.model,e,p))return void u(c,404,{error:{message:`model_not_found: ${f.model}`,type:"invalid_request_error"}},p);const m=function(e,r,s){const a=function(e){if(!Array.isArray(e)||0===e.length)throw new Error("messages must be a non-empty array");return e.map(e=>`${e.role??"user"}: ${n(e.content)}`).join("\n\n")}(e.messages);return{input:a,requestId:`chatcmpl-${t()}`,agentId:o(e.model,r,s),metadata:{protocol:"openai-compatible",openaiStream:!0===e.stream,openaiMessages:(i=e.messages,Array.isArray(i)?i.map(e=>({role:e.role??"user",content:n(e.content)})):[]),model:e.model,user:e.user,clientMetadata:e.metadata}};var i}(f,e,p);f.stream?await async function(e,t,n,r,o){(function(e,t){e.writeHead(200,{"content-type":"text/event-stream","cache-control":"no-cache",connection:"keep-alive",...l(t)})})(t,o),d(t,a(r.requestId,n.model,{role:"assistant"},null));let i="";const c=e.subscribe(e=>{e.requestId===r.requestId&&(i+=function(e,t,n,r){const o=function(e){if("adapter.event"!==e.type||"object"!=typeof e.event||null===e.event)return;const t=e.event;return"output.delta"===t.phase&&"string"==typeof t.text?t.text:void 0}(t);if(o)return d(e,s(n,r,o)),o;!function(e,t){const n=function(e){if("tool.started"===e.type||"tool.completed"===e.type)return{request_id:e.requestId,session_id:e.sessionId,agent_id:e.agentId,type:e.type,tool_id:e.toolId};if("adapter.event"!==e.type||"object"!=typeof e.event||null===e.event)return;const t=e.event,n="tool.start"===t.phase?"tool.started":"tool.result"===t.phase?"tool.completed":void 0,r="string"==typeof t.toolId?t.toolId:void 0;return n&&r?{request_id:e.requestId,session_id:e.sessionId,agent_id:e.agentId,type:n,tool_id:r,adapter:t.adapter}:void 0}(t);n&&function(e,t,n){e.write("event: stable_harness.tool.progress\n"),e.write(`data: ${JSON.stringify(n)}\n\n`)}(e,0,n)}(e,t)}(t,e,r.requestId,n.model)??"")});try{const o=await e.request(r),c=function(e,t){return e?!t||e.includes(t)?"":t.startsWith(e)?t.slice(e.length):t:t}(i,o.output);c&&d(t,s(r.requestId,n.model,c)),d(t,function(e,t){return a(e,t,{},"stop")}(r.requestId,n.model)),t.write("data: [DONE]\n\n"),t.end()}finally{c()}}(e,c,f,m,p):u(c,200,function(e,t){return{id:t.requestId,object:"chat.completion",created:Math.floor(Date.now()/1e3),model:e.model??t.agentId,choices:[{index:0,message:{role:"assistant",content:t.output},finish_reason:"stop"}],usage:i(e.messages,t.output),metadata:{sessionId:t.sessionId,agentId:t.agentId,state:t.state}}}(f,await e.request(m)),p)}(r,e,p,c);u(p,404,{error:{message:"not_found",type:"invalid_request_error"}},c)}catch(e){u(p,400,{error:{message:e instanceof Error?e.message:String(e),type:"invalid_request_error"}},c)}})}function n(e){if("string"==typeof e)return e;if(!Array.isArray(e))throw new Error("message content must be a string or content part array");return e.map(r).join("\n")}function r(e){if("object"!=typeof e||null===e)throw new Error("message content parts must be objects");const t=e;if("text"===t.type&&"string"==typeof t.text)return t.text;const n=t.image_url;if("image_url"===t.type&&"string"==typeof n?.url)return`[image:${n.url}]`;throw new Error("unsupported_content_type")}function o(e,t,n){if(!e)return;const r=n.modelAgentMap?.[e];return r||(t.inspect().agents.includes(e)?e:void 0)}function s(e,t,n){return a(e,t,{content:n},null)}function a(e,t,n,r){return{id:e,object:"chat.completion.chunk",created:Math.floor(Date.now()/1e3),model:t??"stable-harness",choices:[{index:0,delta:n,finish_reason:r}]}}function i(e,t){const r=c(Array.isArray(e)?e.map(e=>n(e.content)).join("\n"):""),o=c(t);return{prompt_tokens:r,completion_tokens:o,total_tokens:r+o}}function c(e){return e.trim()?Math.ceil(1.3*e.trim().split(/\s+/u).length):0}function u(e,t,n,r){e.writeHead(t,{"content-type":"application/json",...l(r)}),e.end(JSON.stringify(n))}function d(e,t){e.write(`data: ${JSON.stringify(t)}\n\n`)}function l(e){return e.corsOrigins?.length?{"access-control-allow-origin":e.corsOrigins.join(", "),"access-control-allow-headers":"authorization, content-type, idempotency-key","access-control-allow-methods":"GET, POST, OPTIONS"}:{}}
+import{createServer as e}from"node:http";import{createCapabilitiesResponse as t,createModelsResponse as r,resolveAgentId as o,toChatCompletion as n,toRuntimeRequest as s}from"./openai-payload.js";import{createContentChunk as i,createRoleChunk as a,createStopChunk as c,missingFinalDelta as u,writeChatSse as l,writeRuntimeStreamEvent as d,writeSseHeaders as f}from"./openai-stream.js";export function createOpenAiCompatibleHttpServer(v,O={}){const w=function(e,t){const r=function(e){const t=m(e)??{};return m(t.openaiCompatible)??m(t["openai-compatible"])??m(t.openai)??{}}(e.getRuntimePolicy().protocols);return{bearerToken:t.bearerToken??y(r.bearerToken),corsOrigins:t.corsOrigins??(o=r.corsOrigins,Array.isArray(o)?o.filter(e=>"string"==typeof e&&e.trim().length>0):void 0),modelAgentMap:t.modelAgentMap??p(r.modelAgentMap),defaultModel:t.defaultModel??y(r.defaultModel)};var o}(v,O);return e(async(e,m)=>{try{if(function(e,t,r){const o=function(e,t){if(e)return t.corsOrigins?.includes("*")?"*":t.corsOrigins?.includes(e)||function(e){try{const t=new URL(e);return"http:"===t.protocol&&["localhost","127.0.0.1","[::1]"].includes(t.hostname)}catch{return!1}}(e)?e:void 0}(e.headers.origin,r);o&&(t.setHeader("access-control-allow-origin",o),t.setHeader("vary","origin"))}(e,m,w),function(e,t){return"OPTIONS"===e.method&&(t.writeHead(204,{"access-control-allow-headers":"authorization, content-type, idempotency-key","access-control-allow-methods":"GET, POST, OPTIONS"}),t.end(),!0)}(e,m))return;if(!function(e,t){return!t.bearerToken||e.headers.authorization===`Bearer ${t.bearerToken}`}(e,w))return void g(m,401,{error:{message:"unauthorized",type:"invalid_request_error"}});if("GET"===e.method&&"/v1/models"===e.url)return void g(m,200,r(v,w));if("GET"===e.method&&"/v1/capabilities"===e.url)return void g(m,200,t());if("POST"===e.method&&"/v1/chat/completions"===e.url)return void await async function(e,t,r,m){const p=await async function(e){const t=[];for await(const r of e)t.push(Buffer.isBuffer(r)?r:Buffer.from(r));return 0===t.length?{}:JSON.parse(Buffer.concat(t).toString("utf8"))}(t);if(p.model&&!o(p.model,e,m))return void g(r,404,{error:{message:`model_not_found: ${p.model}`,type:"invalid_request_error"}});const y=s(p,e,m,{sessionId:h(t.headers["x-stable-harness-session-id"])});if(p.stream)return void await async function(e,t,r,o){f(t,{"access-control-allow-headers":"authorization, content-type, idempotency-key","access-control-allow-methods":"GET, POST, OPTIONS"}),l(t,a(o.requestId,r.model));let n="";const s=e.subscribe(e=>{e.requestId===o.requestId&&(n+=d(t,e,o.requestId,r.model)??"")});try{const s=await e.request(o),a=u(n,s.output);a&&l(t,i(o.requestId,r.model,a)),l(t,c(o.requestId,r.model)),t.write("data: [DONE]\n\n"),t.end()}finally{s()}}(e,r,p,y);const v=await e.request(y);g(r,200,n(p,v))}(v,e,m,w);g(m,404,{error:{message:"not_found",type:"invalid_request_error"}})}catch(e){g(m,400,{error:{message:e instanceof Error?e.message:String(e),type:"invalid_request_error"}})}})}function m(e){return"object"!=typeof e||null===e||Array.isArray(e)?void 0:e}function p(e){const t=m(e);if(t)return Object.fromEntries(Object.entries(t).filter(e=>"string"==typeof e[1]))}function y(e){if("string"!=typeof e||!e.trim())return;const t=e.match(/^\$\{env:([A-Za-z_][A-Za-z0-9_]*)(?::-(.*))?\}$/u);return t?process.env[t[1]]??t[2]:e}function h(e){const t=Array.isArray(e)?e[0]:e;return t&&t.trim()?t:void 0}function g(e,t,r,o){e.writeHead(t,{"content-type":"application/json","access-control-allow-headers":"authorization, content-type, idempotency-key","access-control-allow-methods":"GET, POST, OPTIONS"}),e.end(JSON.stringify(r))}

package/packages/protocols/dist/src/openai-payload.d.ts

@@ -0,0 +1,74 @@
+import type { RuntimeResponse, StableHarnessRuntime } from "@stable-harness/core";
+import type { OpenAiCompatibleServerOptions } from "./openai-compatible.js";
+export type ChatMessage = {
+    role?: string;
+    content?: unknown;
+};
+export type ChatCompletionRequest = {
+    model?: string;
+    messages?: ChatMessage[];
+    stream?: boolean;
+    user?: string;
+    metadata?: Record<string, unknown>;
+};
+export type ChatProtocolContext = {
+    sessionId?: string;
+};
+export declare function toRuntimeRequest(body: ChatCompletionRequest, runtime: StableHarnessRuntime, options: OpenAiCompatibleServerOptions, context?: ChatProtocolContext): {
+    metadata: {
+        protocol: string;
+        openaiStream: boolean;
+        openaiMessages: {
+            role: string;
+            content: string;
+        }[];
+        openaiSessionHistory: boolean;
+        model: string | undefined;
+        user: string | undefined;
+        clientMetadata: Record<string, unknown> | undefined;
+    };
+    sessionId?: string | undefined;
+    input: string;
+    requestId: string;
+    agentId: string | undefined;
+};
+export declare function resolveAgentId(model: string | undefined, runtime: StableHarnessRuntime, options: OpenAiCompatibleServerOptions): string | undefined;
+export declare function createModelsResponse(runtime: StableHarnessRuntime, options: OpenAiCompatibleServerOptions): {
+    object: string;
+    data: {
+        id: string;
+        object: string;
+        created: number;
+        owned_by: string;
+    }[];
+};
+export declare function createCapabilitiesResponse(): {
+    object: string;
+    endpoints: string[];
+    streaming: boolean;
+    toolProgressEvents: boolean;
+};
+export declare function toChatCompletion(body: ChatCompletionRequest, result: RuntimeResponse): {
+    id: string;
+    object: string;
+    created: number;
+    model: string;
+    choices: {
+        index: number;
+        message: {
+            role: string;
+            content: string;
+        };
+        finish_reason: string;
+    }[];
+    usage: {
+        prompt_tokens: number;
+        completion_tokens: number;
+        total_tokens: number;
+    };
+    metadata: {
+        sessionId: string;
+        agentId: string;
+        state: import("@stable-harness/core").RuntimeRecordState;
+    };
+};

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

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

package/packages/protocols/dist/src/openai-stream.d.ts

@@ -0,0 +1,39 @@
+import type { ServerResponse } from "node:http";
+import type { RuntimeEvent } from "@stable-harness/core";
+export declare function missingFinalDelta(streamedContent: string, finalOutput: string): string;
+export declare function createRoleChunk(id: string, model: string | undefined): {
+    id: string;
+    object: string;
+    created: number;
+    model: string;
+    choices: {
+        index: number;
+        delta: Record<string, unknown>;
+        finish_reason: string | null;
+    }[];
+};
+export declare function createContentChunk(id: string, model: string | undefined, content: string): {
+    id: string;
+    object: string;
+    created: number;
+    model: string;
+    choices: {
+        index: number;
+        delta: Record<string, unknown>;
+        finish_reason: string | null;
+    }[];
+};
+export declare function createStopChunk(id: string, model: string | undefined): {
+    id: string;
+    object: string;
+    created: number;
+    model: string;
+    choices: {
+        index: number;
+        delta: Record<string, unknown>;
+        finish_reason: string | null;
+    }[];
+};
+export declare function writeRuntimeStreamEvent(response: ServerResponse, event: RuntimeEvent, id: string, model: string | undefined): string | undefined;
+export declare function writeSseHeaders(response: ServerResponse, headers: Record<string, string>): void;
+export declare function writeChatSse(response: ServerResponse, body: unknown): void;

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

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

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

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

package/packages/tool-gateway/dist/src/schema-validation.d.ts

@@ -0,0 +1,3 @@
+import type { ToolArgumentGuardResult } from "./types.js";
+export declare function validateWithZodSchema(schema: unknown, args: unknown): ToolArgumentGuardResult | undefined;
+export declare function isRecord(value: unknown): value is Record<string, unknown>;

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

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

package/packages/workspace-yaml/dist/discovery.d.ts

@@ -0,0 +1,4 @@
+import type { WorkspaceSkill, WorkspaceTool } from "@stable-harness/core";
+export declare function listYamlFiles(root: string): Promise<string[]>;
+export declare function discoverModuleTools(workspaceRoot: string): Promise<WorkspaceTool[]>;
+export declare function discoverSkills(workspaceRoot: string): Promise<WorkspaceSkill[]>;

package/packages/workspace-yaml/dist/discovery.js

@@ -0,0 +1 @@
+import{readdir as t,readFile as e}from"node:fs/promises";import r from"node:path";import{parseAllDocuments as i}from"yaml";export async function listYamlFiles(e){const i=await t(e,{withFileTypes:!0});return(await Promise.all(i.map(async t=>{const i=r.join(e,t.name);return t.isDirectory()?listYamlFiles(i):t.isFile()&&/\.ya?ml$/iu.test(t.name)?[i]:[]}))).flat().sort()}export async function discoverModuleTools(i){const a=r.join(i,"resources","tools");let s;try{s=await t(a,{withFileTypes:!0})}catch{return[]}return(await Promise.all(s.filter(t=>t.isFile()&&t.name.endsWith(".mjs")&&!t.name.startsWith("_")).map(t=>async function(t){const i=[...(await e(t,"utf8")).matchAll(/export\s+const\s+([A-Za-z_][A-Za-z0-9_]*)\s*=\s*tool\s*\(/gu)].map(t=>t[1]).filter(t=>"default"!==t);return(i.length>0?i:[r.basename(t,".mjs")]).map(e=>({id:e,sourcePath:t}))}(r.join(a,t.name))))).flat()}export async function discoverSkills(s){const n=r.join(s,"resources","skills");let o;try{o=await t(n,{withFileTypes:!0})}catch{return[]}return(await Promise.all(o.filter(t=>t.isDirectory()).map(t=>async function(t,s){const n=r.join(t,"SKILL.md");let o;try{o=await e(n,"utf8")}catch{return}const l=function(t){const e=t.match(/^---\n([\s\S]*?)\n---/u);if(!e)return{};const r=i(e[1]).at(0)?.toJSON();return"object"!=typeof r||null===r||Array.isArray(r)?{}:r}(o);return{id:a(l.name)??s,path:n,...a(l.description)?{description:a(l.description)}:{},allowedTools:(c=l["allowed-tools"],Array.isArray(c)?c.filter(t=>"string"==typeof t&&t.trim().length>0):[])};var c}(r.join(n,t.name),t.name)))).filter(t=>Boolean(t))}function a(t){return"string"==typeof t&&t.trim()?t.trim():void 0}

package/packages/workspace-yaml/dist/documents.d.ts

@@ -0,0 +1,16 @@
+import type { WorkspaceAgent, WorkspaceMemory, WorkspaceModel, WorkspaceRuntimePolicy, WorkspaceTool } from "@stable-harness/core";
+export type RawDocument = {
+    apiVersion?: unknown;
+    kind?: unknown;
+    metadata?: {
+        name?: unknown;
+        description?: unknown;
+    };
+    spec?: unknown;
+};
+export declare function compileRuntime(document: RawDocument): WorkspaceRuntimePolicy;
+export declare function compileAgent(document: RawDocument, sourcePath: string): WorkspaceAgent;
+export declare function compileModel(document: RawDocument): WorkspaceModel;
+export declare function compileModelSpec(spec: Record<string, unknown>, fallback?: string): WorkspaceModel;
+export declare function compileTool(document: RawDocument): WorkspaceTool;
+export declare function compileMemory(document: RawDocument): WorkspaceMemory;

package/packages/workspace-yaml/dist/documents.js

@@ -0,0 +1 @@
+function e(e,r){if("object"!=typeof e||null===e||Array.isArray(e))throw new Error(`${r} must be an object`);return e}function r(e,r){const o=e.metadata?.name;if("string"==typeof o&&o.trim())return o.trim();if(r)return r;throw new Error(`Document kind ${String(e.kind)} requires metadata.name`)}function o(e){const r=e.metadata?.description;return"string"==typeof r&&r.trim()?r.trim():void 0}function t(e){return"string"==typeof e&&e.trim()?e.trim():void 0}function n(e){return Array.isArray(e)?e.filter(e=>"string"==typeof e&&e.trim().length>0):[]}function i(e){if("string"!=typeof e)return e;const r=e.match(/^\$\{env:([A-Za-z_][A-Za-z0-9_]*)(?::-(.*))?\}$/u);return r?process.env[r[1]]??r[2]??"":e}export function compileRuntime(r){const o=e(r.spec,"Runtime.spec"),n=e(o.routing??{},"Runtime.spec.routing");return{defaultAgentId:"string"==typeof n.defaultAgentId&&n.defaultAgentId.trim()?n.defaultAgentId.trim():"orchestra",...t(o.workspaceId)?{workspaceId:t(o.workspaceId)}:{},...t(o.profile)?{profile:t(o.profile)}:{},...void 0!==o.adapters?{adapters:p(o.adapters)}:{},..."object"==typeof o.workflowRouting&&o.workflowRouting?{workflowRouting:s(o.workflowRouting)}:{},..."object"==typeof o.approvals&&o.approvals?{approvals:o.approvals}:{},..."object"==typeof o.recovery&&o.recovery?{recovery:o.recovery}:{},..."object"==typeof o.retry&&o.retry?{retry:o.retry}:{},..."object"==typeof o.memory&&o.memory?{memory:o.memory}:{},..."object"==typeof o.protocols&&o.protocols?{protocols:o.protocols}:{}}}export function compileAgent(i,s){const p=e(i.spec,"Agent.spec"),m=r(i),a=t(p.backend);if(!a)throw new Error(`Agent ${m} requires spec.backend`);const d="object"==typeof p.config&&p.config?p.config:{},f="string"==typeof p.systemPrompt?p.systemPrompt:"string"==typeof d.systemPrompt?d.systemPrompt:void 0;return{id:m,...o(i)?{description:o(i)}:{},sourcePath:s,backend:a,..."string"==typeof p.modelRef&&p.modelRef.trim()?{modelRef:(u=p.modelRef,u.replace(/^[^/]+\//u,""))}:{},...void 0!==f?{systemPrompt:f}:{},tools:n(p.tools),skills:n(p.skills),memory:Array.isArray(p.memory)?p.memory:[],subagents:n(p.subagents),...void 0!==p.edges?{edges:c(p.edges,m)}:{},config:d};var u}export function compileModel(o){return compileModelSpec(e(o.spec,"Model.spec"),r(o))}export function compileModelSpec(e,r){const o="string"==typeof e.name&&e.name.trim()?e.name.trim():r??"default",t=i(e.provider),n=i(e.model),s="string"==typeof t&&t.trim()?t.trim():"unknown",p="string"==typeof n&&n.trim()?n.trim():o,c={...e};return delete c.name,delete c.provider,delete c.model,{id:o,provider:s,model:p,config:Object.fromEntries(Object.entries(c).map(([e,r])=>[e,i(r)]))}}export function compileTool(o){const t=e(o.spec,"Tool.spec");return{id:r(o),..."string"==typeof t.description?{description:t.description}:{},...void 0!==t.schema?{schema:t.schema}:{},..."string"==typeof t.implementation?{implementation:t.implementation}:{}}}export function compileMemory(o){const n=e(o.spec,"Memory.spec"),i=r(o),s={...n};return delete s.provider,delete s.profile,delete s.mode,delete s.enabled,delete s.prompts,{id:i,provider:t(n.provider)??"langmem",...t(n.profile)?{profile:t(n.profile)}:{},...t(n.mode)?{mode:t(n.mode)}:{},enabled:!1!==n.enabled,..."object"==typeof n.prompts&&n.prompts?{prompts:a(n.prompts)}:{},...Object.keys(s).length>0?{config:s}:{}}}function s(r){const o=e(r,"Runtime.spec.workflowRouting"),n=void 0===o.routes?void 0:function(r){if(!Array.isArray(r))throw new Error("Runtime.spec.workflowRouting.routes must be an array");return r.map(r=>{const o=e(r,"Runtime.spec.workflowRouting.routes[]"),n=t(o.id),i=t(o.workflowId);if(!n||!i)throw new Error("Runtime.spec.workflowRouting.routes[] requires id and workflowId");return{id:n,workflowId:i,...t(o.description)?{description:t(o.description)}:{},..."object"==typeof o.metadata&&o.metadata?{metadata:o.metadata}:{}}})}(o.routes);return{...t(o.defaultWorkflowId)?{defaultWorkflowId:t(o.defaultWorkflowId)}:{},...n?{routes:n}:{}}}function p(e){if(!Array.isArray(e))throw new Error("Runtime.spec.adapters must be an array");return e.map(m)}function c(r,o){if(!Array.isArray(r))throw new Error(`Agent ${o} spec.edges must be an array`);return r.map(r=>{const n=e(r,`Agent ${o} spec.edges[]`),i=t(n.from),s=t(n.to);if(!i||!s)throw new Error(`Agent ${o} spec.edges[] requires from and to`);return{from:i,to:s,...t(n.condition)?{condition:t(n.condition)}:{}}})}function m(r){if("string"==typeof r&&r.trim())return{name:r.trim()};const o=e(r,"Runtime.spec.adapters[]"),n=t(o.name)??t(o.id)??t(o.backend);if(!n)throw new Error("Runtime.spec.adapters[] requires name");return{name:n,..."boolean"==typeof o.enabled?{enabled:o.enabled}:{},..."object"==typeof o.config&&o.config?{config:o.config}:{}}}function a(r){const o=e(r,"Memory.spec.prompts");return{...t(o.semantic)?{semantic:t(o.semantic)}:{},...t(o.episodic)?{episodic:t(o.episodic)}:{},...t(o.procedural)?{procedural:t(o.procedural)}:{}}}

package/packages/workspace-yaml/dist/loader.js

@@ -1 +1 @@
-import{readdir as e,readFile as t}from"node:fs/promises";import o from"node:path";import{parseAllDocuments as r}from"yaml";async function n(t){const r=await e(t,{withFileTypes:!0});return(await Promise.all(r.map(async e=>{const r=o.join(t,e.name);return e.isDirectory()?n(r):e.isFile()&&/\.ya?ml$/iu.test(e.name)?[r]:[]}))).flat().sort()}function i(e,t){if("object"!=typeof e||null===e||Array.isArray(e))throw new Error(`${t} must be an object`);return e}function s(e,t){const o=e.metadata?.name;if("string"==typeof o&&o.trim())return o.trim();if(t)return t;throw new Error(`Document kind ${String(e.kind)} requires metadata.name`)}function a(e){const t=e.metadata?.description;return"string"==typeof t&&t.trim()?t.trim():void 0}function c(e){return Array.isArray(e)?e.filter(e=>"string"==typeof e&&e.trim().length>0):[]}function p(e){if("string"!=typeof e)return e;const t=e.match(/^\$\{env:([A-Za-z_][A-Za-z0-9_]*)(?::-(.*))?\}$/u);return t?process.env[t[1]]??t[2]??"":e}function m(e){const t=i(e.spec,"Runtime.spec"),o=i(t.routing??{},"Runtime.spec.routing");return{defaultAgentId:"string"==typeof o.defaultAgentId&&o.defaultAgentId.trim()?o.defaultAgentId.trim():"orchestra",...b(t.workspaceId)?{workspaceId:b(t.workspaceId)}:{},...b(t.profile)?{profile:b(t.profile)}:{},..."object"==typeof t.approvals&&t.approvals?{approvals:t.approvals}:{},..."object"==typeof t.recovery&&t.recovery?{recovery:t.recovery}:{},..."object"==typeof t.retry&&t.retry?{retry:t.retry}:{},..."object"==typeof t.memory&&t.memory?{memory:t.memory}:{},..."object"==typeof t.protocols&&t.protocols?{protocols:t.protocols}:{}}}function l(e,t){const o=i(e.spec,"Agent.spec"),r=s(e),n="string"==typeof o.backend&&o.backend.trim()?o.backend.trim():"deepagents",p="object"==typeof o.config&&o.config?o.config:{},m="string"==typeof o.systemPrompt?o.systemPrompt:"string"==typeof p.systemPrompt?p.systemPrompt:void 0;return{id:r,...a(e)?{description:a(e)}:{},sourcePath:t,backend:"deepagent"===n?"deepagents":n,..."string"==typeof o.modelRef&&o.modelRef.trim()?{modelRef:(l=o.modelRef,l.replace(/^[^/]+\//u,""))}:{},...void 0!==m?{systemPrompt:m}:{},tools:c(o.tools),skills:c(o.skills),memory:Array.isArray(o.memory)?o.memory:[],subagents:c(o.subagents),config:p};var l}function f(e,t){const o="string"==typeof e.name&&e.name.trim()?e.name.trim():t??"default",r=p(e.provider),n=p(e.model),i="string"==typeof r&&r.trim()?r.trim():"unknown",s="string"==typeof n&&n.trim()?n.trim():o,a={...e};return delete a.name,delete a.provider,delete a.model,{id:o,provider:i,model:s,config:Object.fromEntries(Object.entries(a).map(([e,t])=>[e,p(t)]))}}function d(e){return f(i(e.spec,"Model.spec"),s(e))}function u(e){const t=i(e.spec,"Tool.spec");return{id:s(e),..."string"==typeof t.description?{description:t.description}:{},...void 0!==t.schema?{schema:t.schema}:{},..."string"==typeof t.implementation?{implementation:t.implementation}:{}}}function y(e){const t=i(e.spec,"Memory.spec"),o=s(e),r={...t};return delete r.provider,delete r.profile,delete r.mode,delete r.enabled,delete r.prompts,{id:o,provider:b(t.provider)??"langmem",...b(t.profile)?{profile:b(t.profile)}:{},...b(t.mode)?{mode:b(t.mode)}:{},enabled:!1!==t.enabled,..."object"==typeof t.prompts&&t.prompts?{prompts:g(t.prompts)}:{},...Object.keys(r).length>0?{config:r}:{}}}function g(e){const t=i(e,"Memory.spec.prompts");return{...b(t.semantic)?{semantic:b(t.semantic)}:{},...b(t.episodic)?{episodic:b(t.episodic)}:{},...b(t.procedural)?{procedural:b(t.procedural)}:{}}}function b(e){return"string"==typeof e&&e.trim()?e.trim():void 0}export async function loadWorkspaceFromYaml(i){const s=o.join(i,"config"),a=await n(s),p=[],g=new Map,w=new Map,h=new Map,A=new Map,k=new Map;for(const e of a){const o=await t(e,"utf8"),n=r(o).map(e=>e.toJSON()).filter(e=>null!==e);for(const t of n)if("string"==typeof t.kind)switch(t.kind){case"Runtime":p.push(m(t));break;case"Agent":{const o=l(t,e);g.set(o.id,o);break}case"Model":{const e=d(t);w.set(e.id,e);break}case"Models":if(Array.isArray(t.spec))for(const e of t.spec)if("object"==typeof e&&null!==e&&!Array.isArray(e)){const t=f(e);w.set(t.id,t)}break;case"Tool":{const e=u(t);h.set(e.id,e);break}case"Memory":{const e=y(t);k.set(e.id,e);break}}}for(const r of await async function(r){const n=o.join(r,"resources","tools");let i;try{i=await e(n,{withFileTypes:!0})}catch{return[]}return(await Promise.all(i.filter(e=>e.isFile()&&e.name.endsWith(".mjs")&&!e.name.startsWith("_")).map(e=>async function(e){const r=[...(await t(e,"utf8")).matchAll(/export\s+const\s+([A-Za-z_][A-Za-z0-9_]*)\s*=\s*tool\s*\(/gu)].map(e=>e[1]).filter(e=>"default"!==e);return(r.length>0?r:[o.basename(e,".mjs")]).map(t=>({id:t,sourcePath:e}))}(o.join(n,e.name))))).flat()}(i))h.has(r.id)||h.set(r.id,r);for(const n of await async function(n){const i=o.join(n,"resources","skills");let s;try{s=await e(i,{withFileTypes:!0})}catch{return[]}return(await Promise.all(s.filter(e=>e.isDirectory()).map(e=>async function(e,n){const i=o.join(e,"SKILL.md");let s;try{s=await t(i,"utf8")}catch{return}const a=function(e){const t=e.match(/^---\n([\s\S]*?)\n---/u);if(!t)return{};const o=r(t[1]).at(0)?.toJSON();return"object"!=typeof o||null===o||Array.isArray(o)?{}:o}(s);return{id:b(a.name)??n,path:i,...b(a.description)?{description:b(a.description)}:{},allowedTools:c(a["allowed-tools"])}}(o.join(i,e.name),e.name)))).filter(e=>Boolean(e))}(i))A.set(n.id,n);return{root:i,runtime:p.at(-1)??{defaultAgentId:"orchestra"},agents:g,models:w,tools:h,skills:A,memories:k}}
+import{readFile as o}from"node:fs/promises";import e from"node:path";import{parseAllDocuments as s}from"yaml";import{discoverModuleTools as r,discoverSkills as t,listYamlFiles as a}from"./discovery.js";import{compileAgent as i,compileMemory as n,compileModel as l,compileModelSpec as f,compileRuntime as c,compileTool as w}from"./documents.js";import{compileWorkflow as d,validateWorkflows as m}from"./workflows.js";export async function loadWorkspaceFromYaml(k){const p=e.join(k,"config"),u=await a(p),M=[],y=new Map,g=new Map,h=new Map,b=new Map,A=new Map,W=new Map;for(const e of u){const r=await o(e,"utf8"),t=s(r).map(o=>o.toJSON()).filter(o=>null!==o);for(const o of t)if("string"==typeof o.kind)switch(o.kind){case"Runtime":M.push(c(o));break;case"Agent":{const s=i(o,e);y.set(s.id,s);break}case"Model":{const e=l(o);g.set(e.id,e);break}case"Models":if(Array.isArray(o.spec))for(const e of o.spec)if("object"==typeof e&&null!==e&&!Array.isArray(e)){const o=f(e);g.set(o.id,o)}break;case"Tool":{const e=w(o);h.set(e.id,e);break}case"Memory":{const e=n(o);A.set(e.id,e);break}case"Workflow":{const s=d(o,e);W.set(s.id,s);break}}}for(const o of await r(k))h.has(o.id)||h.set(o.id,o);for(const o of await t(k))b.set(o.id,o);const I=M.at(-1)??{defaultAgentId:"orchestra"};return m({workflows:W,agents:y,tools:h,skills:b}),function(o,e){const s=o.workflowRouting;if(s){if(s.defaultWorkflowId&&!e.has(s.defaultWorkflowId))throw new Error(`Runtime workflowRouting.defaultWorkflowId references unknown workflow ${s.defaultWorkflowId}`);for(const o of s.routes??[])if(!e.has(o.workflowId))throw new Error(`Runtime workflowRouting route ${o.id} references unknown workflow ${o.workflowId}`)}}(I,W),{root:k,runtime:I,agents:y,models:g,tools:h,skills:b,memories:A,workflows:W}}

package/packages/workspace-yaml/dist/workflows.d.ts

@@ -0,0 +1,16 @@
+import type { WorkspaceAgent, WorkspaceSkill, WorkspaceTool, WorkspaceWorkflow } from "@stable-harness/core";
+type RawDocument = {
+    metadata?: {
+        name?: unknown;
+        description?: unknown;
+    };
+    spec?: unknown;
+};
+export declare function compileWorkflow(document: RawDocument, sourcePath: string): WorkspaceWorkflow;
+export declare function validateWorkflows(input: {
+    workflows: Map<string, WorkspaceWorkflow>;
+    agents: Map<string, WorkspaceAgent>;
+    tools: Map<string, WorkspaceTool>;
+    skills: Map<string, WorkspaceSkill>;
+}): void;
+export {};

package/packages/workspace-yaml/dist/workflows.js

@@ -0,0 +1 @@
+export function compileWorkflow(n,t){const s=i(n.spec,"Workflow.spec"),d="object"==typeof s.config&&s.config?s.config:{};return{id:f(n),...c(n)?{description:c(n)}:{},sourcePath:t,...a(s.adapter)?{adapter:a(s.adapter)}:{},...a(s.entry)?{entry:a(s.entry)}:{},..."object"==typeof s.state&&s.state?{state:o(s.state)}:{},nodes:e(s.nodes),edges:r(s.edges),..."object"==typeof s.policies&&s.policies?{policies:s.policies}:{},...Object.keys(d).length>0?{config:d}:{}}}export function validateWorkflows(o){for(const e of o.workflows.values()){const r=new Set(e.nodes.map(o=>o.id));n(e,r),t(e,r);for(const r of e.nodes)s(r.use,o)}}function o(o){const e=i(o,"Workflow.spec.state");return{...a(e.schema)?{schema:a(e.schema)}:{},..."object"==typeof e.config&&e.config?{config:e.config}:{}}}function e(o){if(!Array.isArray(o)||0===o.length)throw new Error("Workflow.spec.nodes must be a non-empty array");return o.map(o=>{const e=i(o,"Workflow.spec.nodes[]"),r=a(e.id),n=a(e.use);if(!r||!n)throw new Error("Workflow.spec.nodes[] requires id and use");return{id:r,use:n,...a(e.type)?{type:a(e.type)}:{},..."object"==typeof e.config&&e.config?{config:e.config}:{}}})}function r(o){if(!Array.isArray(o))throw new Error("Workflow.spec.edges must be an array");return o.map(o=>{const e=i(o,"Workflow.spec.edges[]"),r=a(e.from),n=a(e.to);if(!r||!n)throw new Error("Workflow.spec.edges[] requires from and to");return{from:r,to:n,...a(e.condition)?{condition:a(e.condition)}:{}}})}function n(o,e){if(o.entry&&!e.has(o.entry))throw new Error(`Workflow ${o.id} entry references unknown node ${o.entry}`)}function t(o,e){for(const r of o.edges)if(!e.has(r.from)||!e.has(r.to))throw new Error(`Workflow ${o.id} edge references unknown node ${r.from}->${r.to}`)}function s(o,e){const r=o.indexOf("."),n=r>0?o.slice(0,r):"",t=r>0?o.slice(r+1):"";if(!n||!t)throw new Error(`Workflow node use must reference inventory as agents.<id>, tools.<id>, skills.<id>, or workflows.<id>: ${o}`);const s="agents"===n?e.agents:"tools"===n?e.tools:"skills"===n?e.skills:"workflows"===n?e.workflows:void 0;if(!s?.has(t))throw new Error(`Workflow node references unknown ${n}.${t}`)}function i(o,e){if("object"!=typeof o||null===o||Array.isArray(o))throw new Error(`${e} must be an object`);return o}function f(o){const e=o.metadata?.name;if("string"==typeof e&&e.trim())return e.trim();throw new Error("Workflow document requires metadata.name")}function c(o){const e=o.metadata?.description;return"string"==typeof e&&e.trim()?e.trim():void 0}function a(o){return"string"==typeof o&&o.trim()?o.trim():void 0}

package/packages/adapter-deepagents/dist/src/builtin-tool-policy.js

@@ -1 +0,0 @@
-import{ToolMessage as e}from"@langchain/core/messages";const t=new Set(["ls","read_file","write_file","edit_file","glob","grep"]);export function createBuiltinToolPolicyMiddleware(e){return{name:"StableHarnessBuiltinToolPolicy",async wrapModelCall(t,r){if(!function(e){return n(e)||!o(e)}(e))return r(t);const l=Array.isArray(t.tools)?t.tools.filter(t=>i(e,t.name)):t.tools,s=function(e,t){return"required"===t||function(e,t){return"string"==typeof t?.function?.name&&!i(e,t.function.name)}(e,t)?"auto":t}(e,t.toolChoice);return r({...t,tools:l,toolChoice:s})}}}export function validateFilesystemBuiltinCall(o,i,r){if(n(o)&&t.has(i))return new e({tool_call_id:r.toolCall?.id??`stable-harness-${i}-policy`,name:i,content:`Filesystem builtin tool '${i}' is disabled for this agent. Do not retry filesystem tools; use the agent's registered workspace tools and already collected evidence instead.`})}function n(e){const t=r(e.agent.config,"builtinTools");return!1===t?.filesystem}function o(e){const t=r(e.agent.config,"builtinTools")?.modelExposed;return!1!==t&&(!Array.isArray(t)||t.includes("task"))}function i(e,i){return(!n(e)||!function(e){return"string"==typeof e&&t.has(e)}(i))&&("task"!==i||o(e))}function r(e,t){const n=l(e)?e:{};return l(n[t])?n[t]:void 0}function l(e){return"object"==typeof e&&null!==e&&!Array.isArray(e)}