stable-harness 0.0.3 → 0.0.5

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

@@ -1 +1 @@
-import{ToolMessage as t}from"@langchain/core/messages";import{stringifyDeepAgentResult as e}from"./gateway-tools.js";import{traceProjectionForBuiltinTool as o}from"./trace-projection.js";const r=new Set(["ls","read_file","write_file","edit_file","glob","grep"]),n=new Set(["write_todos","task",...r]);export function createBuiltinToolPolicyMiddleware(t){return{name:"StableHarnessBuiltinToolPolicy",async wrapModelCall(e,o){if(!function(t){return l(t)||!u(t)}(t))return o(e);const r=Array.isArray(e.tools)?e.tools.filter(e=>c(t,e.name)):e.tools,n=function(t,e){return"required"===e||function(t,e){return"string"==typeof e?.function?.name&&!c(t,e.function.name)}(t,e)?"auto":e}(t,e.toolChoice);return o({...e,tools:r,toolChoice:n})}}}export function validateFilesystemBuiltinCall(e,o,n){if(l(e)&&r.has(o))return new t({tool_call_id:n.toolCall?.id??`stable-harness-${o}-policy`,name:o,content:`Filesystem builtin tool '${o}' is disabled for this agent. Do not retry filesystem tools; use the agent's registered workspace tools and already collected evidence instead.`})}export function createObserverMiddleware(e){return{name:"StableHarnessObserver",async wrapToolCall(o,r){const a=o.toolCall?.name;if(!a||!n.has(a))return r(o);s(e,a,"tool.start",o.toolCall?.args);const l="task"===a?function(e,o){const r=function(t){const e=g(t)?t:{};return f(e.subagent_type)??f(e.subagentType)}(o.toolCall?.args),n=function(t){const e=d(t.agent.config,"builtinTools")?.modelExposed;return!1===e?[]:Array.isArray(e)?e.includes("task")?t.agent.subagents:[]:["general-purpose",...t.agent.subagents]}(e);if(void 0===n||r&&n.includes(r))return;const s=r?`: ${r}`:"",a=n.length>0?n.join(", "):"none";return new t({tool_call_id:o.toolCall?.id??"stable-harness-task-policy",name:"task",status:"error",content:`Task delegation target is not in the workspace inventory${s}. Allowed task targets: ${a}.`})}(e,o):void 0;if(l)return s(e,a,"tool.result",o.toolCall?.args,{output:l.content}),l;const u=validateFilesystemBuiltinCall(e,a,o);if(u)return s(e,a,"tool.result",o.toolCall?.args,{output:u.content}),u;const c=function(t,e){if("write_todos"!==t)return e;const o=g(e.toolCall?.args)?e.toolCall.args:{},r=function(t){if(!Array.isArray(t)&&"string"==typeof t&&t.trim())try{const e=JSON.parse(t);return Array.isArray(e)?e:void 0}catch{return}}(o.todos);return r?{...e,toolCall:{...e.toolCall,args:{...o,todos:r}}}:e}(a,o);try{const t=await r(c);return s(e,a,"tool.result",o.toolCall?.args,{output:i(a,c,t)}),t}catch(t){throw s(e,a,"tool.result",o.toolCall?.args,{error:p(t)}),t}}}}export function resolveFilesystemPermissions(t,e){const o=d(e?.config,"builtinTools"),r=[];if(!1!==o?.filesystem){if(a(t))return}else r.push(...function(t,e){return(e?.skills??[]).map(e=>t.workspace.skills.get(e)?.path).filter(t=>"string"==typeof t&&t.startsWith("/")).map(t=>({operations:["read"],paths:[t],mode:"allow"}))}(t,e)),r.push({operations:["read"],paths:["/memories/**"],mode:"allow"}),r.push({operations:["read","write"],paths:["/**"],mode:"deny"});return a(t)||r.push({operations:["write"],paths:["/memories/**"],mode:"deny"}),r.length>0?r:void 0}function s(t,e,r,n,s={}){t.emit({type:"adapter.event",requestId:t.requestId,sessionId:t.sessionId,agentId:t.agent.id,event:{adapter:"deepagents",phase:r,toolId:e,..."tool.start"===r?{args:n}:{},...s,...o(e,r,n)}})}function a(t){const e=d(t.workspace.runtime.memory,"deepagentsMem");return!1!==e?.write}function i(t,o,r){return"write_todos"===t?JSON.stringify({status:"recorded",args:o.toolCall?.args}):e(r)}function l(t){const e=d(t.agent.config,"builtinTools");return!1===e?.filesystem}function u(t){const e=d(t.agent.config,"builtinTools")?.modelExposed;return!1!==e&&(!Array.isArray(e)||e.includes("task"))}function c(t,e){return(!l(t)||!function(t){return"string"==typeof t&&r.has(t)}(e))&&("task"!==e||u(t))}function d(t,e){const o=g(t)?t:{};return g(o[e])?o[e]:void 0}function f(t){return"string"==typeof t&&t.trim()?t:void 0}function g(t){return"object"==typeof t&&null!==t&&!Array.isArray(t)}function p(t){return t instanceof Error?t.message:String(t)}
+import{realpathSync as e}from"node:fs";import{ToolMessage as t}from"@langchain/core/messages";import{normalizeArgsRecord as o,normalizeFilesystemArgs as r,normalizeWriteTodosArgs as n,shallowEqualRecord as i}from"./builtin-args.js";import{afterToolInvoke as l,beforeToolInvoke as a,createToolRepeatState as s,stringifyDeepAgentResult as u,toolControlProjection as c}from"./gateway-tools.js";import{validateSkillFileBuiltinCall as d}from"./skill-file-policy.js";import{filterRepeatLimitedTools as g}from"./tool-repeat-visibility.js";import{traceProjectionForBuiltinTool as p}from"./trace-projection.js";const f=new Set(["ls","read_file","write_file","edit_file","glob","grep"]),m=new Set(["write_todos","task",...f]);export function createBuiltinToolPolicyMiddleware(e,t={}){return{name:"StableHarnessBuiltinToolPolicy",async wrapModelCall(o,r){const n=Array.isArray(o.tools)?g(o.tools.filter(t=>!function hasHiddenBuiltins(e){return isFilesystemDisabled(e)||!isTaskVisible(e)}(e)||isModelVisibleBuiltin(e,t.name)),t.repeatState):o.tools,i=function normalizeToolChoice(e,t,o){return"required"===t?o&&o.length>0?t:"auto":function isForcedHiddenTool(e,t){return"string"==typeof t?.function?.name&&!isModelVisibleBuiltin(e,t.function.name)}(e,t)?"auto":t}(e,o.toolChoice,n);return r({...o,tools:n,toolChoice:i})}}}export function validateFilesystemBuiltinCall(e,o,r){if(isFilesystemDisabled(e)&&f.has(o))return new t({tool_call_id:r.toolCall?.id??`stable-harness-${o}-policy`,name:o,content:`Filesystem builtin tool '${o}' is disabled for this agent. Do not retry filesystem tools; use the agent's registered workspace tools and already collected evidence instead.`})}export function createObserverMiddleware(e,c={}){const g=c.repeatState??s(e.workspace.runtime.toolGateway);return{name:"StableHarnessObserver",async wrapToolCall(s,p){const h=s.toolCall?.name;if(!h||!m.has(h))return p(s);const y=function normalizeBuiltinToolRequest(e,t,l){return"write_todos"===t?{...l,toolCall:{...l.toolCall,args:n(l.toolCall?.args)}}:"task"===t?{...l,toolCall:{...l.toolCall,args:o(l.toolCall?.args)}}:f.has(t)?function normalizeFilesystemToolRequest(e,t,n){const l=o(n.toolCall?.args),a=r(t,l,e.workspace.root);return i(l,a)?n:{...n,toolCall:{...n.toolCall,args:a}}}(e,t,l):l}(e,h,s);emitToolEvent(e,h,"agent.tool.start",y.toolCall?.args);const v=g?a(h,y.toolCall?.args,g):void 0;if(v)return emitToolEvent(e,h,"agent.tool.result",y.toolCall?.args,{output:v.eventOutput}),builtinToolMessage(s,h,v.modelOutput);const b="task"===h?function validateTaskCall(e,o){const r=function readTaskSubagentType(e){const t=isRecord(e)?e:{};return readString(t.subagent_type)??readString(t.subagentType)}(o.toolCall?.args),n=function allowedTaskTypes(e){const t=readConfigRecord(e.agent.config,"builtinTools")?.modelExposed;return!1===t?[]:Array.isArray(t)?t.includes("task")?e.agent.subagents:[]:void 0}(e);if(void 0===n||r&&n.includes(r))return;const i=r?`: ${r}`:"",l=n.length>0?n.join(", "):"none";return new t({tool_call_id:o.toolCall?.id??"stable-harness-task-policy",name:"task",status:"error",content:`Task delegation target is not in the workspace inventory${i}. Allowed task targets: ${l}.`})}(e,y):void 0;if(b)return emitToolEvent(e,h,"agent.tool.result",y.toolCall?.args,{output:b.content}),b;const T=validateFilesystemBuiltinCall(e,h,y);if(T)return emitToolEvent(e,h,"agent.tool.result",y.toolCall?.args,{output:T.content}),T;const C=d(e,h,y);if(C)return emitToolEvent(e,h,"agent.tool.result",y.toolCall?.args,{output:C.content}),C;try{const t=await p(y),o=function observedToolOutput(e,t,o){return"write_todos"===e?JSON.stringify({status:"recorded",args:t.toolCall?.args}):u(o)}(h,y,t),r=g?l(h,y.toolCall?.args,o,t,g):{};return emitToolEvent(e,h,"agent.tool.result",y.toolCall?.args,{output:r.eventOutput??o}),c.observedToolIds?.add(h),void 0===r.modelOutput?t:builtinToolMessage(s,h,r.modelOutput)}catch(o){const r=function recoverableBuiltinToolError(e,o,r){const n=formatError(r);return"task"===e&&/repeat limit reached for tool/iu.test(n)?new t({tool_call_id:o.toolCall?.id??"stable-harness-task-repeat-limit",name:"task",content:JSON.stringify({status:"delegated_task_repeat_limit",finalizationRequired:!0,instruction:"The delegated agent reached a configured tool repeat limit. Stop delegating this evidence need, do not send a synthesis task to another subagent for the same need, and produce the best final answer now from the evidence already returned in this run. If coverage is incomplete, report the exact remaining evidence gap explicitly.",error:previewError(n)})}):/Received tool input did not match expected schema|Invalid input:/iu.test(n)?new t({tool_call_id:o.toolCall?.id??`stable-harness-${e}-argument-error`,name:e,status:"error",content:JSON.stringify({status:"tool_argument_error",toolId:e,instruction:"The upstream builtin tool rejected these arguments. Fix the tool arguments according to the tool schema, or choose a more appropriate available tool.",error:previewError(n)})}):void 0}(h,s,o);if(r)return emitToolEvent(e,h,"agent.tool.result",y.toolCall?.args,{output:r.content}),r;throw emitToolEvent(e,h,"agent.tool.result",y.toolCall?.args,{error:formatError(o)}),o}}}}function builtinToolMessage(e,o,r){return new t({tool_call_id:e.toolCall?.id??`stable-harness-${o}-repeat-guard`,name:o,content:r})}export function resolveFilesystemPermissions(e,t){const o=readConfigRecord(t?.config,"builtinTools"),r=[];if(r.push(...function skillReadPermissions(e,t){const o=[...new Set((t?.skills??[]).flatMap(t=>function skillReadPaths(e,t){return t?[...new Set([t,canonicalPath(t),backendSkillPath(e,t)])].flatMap(e=>function skillReadPathCandidates(e){const t=e.replace(/\/+$/u,""),o=t.endsWith("/SKILL.md")?t.slice(0,-9):t,r=function parentPath(e){const t=e.lastIndexOf("/");return t>0?e.slice(0,t):void 0}(o);return[t,o,`${o}/**`,...r?[r,`${r}/**`]:[]]}(e)):[]}(e.workspace.root,e.workspace.skills.get(t)?.path)).filter(e=>e.startsWith("/")))];return o.length>0?[{operations:["read"],paths:o,mode:"allow"}]:[]}(e,t)),!1!==o?.filesystem){if(deepagentsMemoryWritable(e))return r.length>0?r:void 0}else r.push({operations:["read"],paths:["/memories/**"],mode:"allow"}),r.push({operations:["read","write"],paths:["/**"],mode:"deny"});return deepagentsMemoryWritable(e)||r.push({operations:["write"],paths:["/memories/**"],mode:"deny"}),r.length>0?r:void 0}function emitToolEvent(e,t,o,r,n={}){e.emit({type:"runtime.adapter.event",requestId:e.requestId,sessionId:e.sessionId,agentId:e.agent.id,event:{adapter:"deepagents",phase:o,toolId:t,..."agent.tool.start"===o?{args:r}:{},...n,..."string"==typeof n.output?c(n.output):{},...p(t,o,r)}})}function backendSkillPath(e,t){const o=function pathRelative(e,t){const o=e.split("/").filter(Boolean),r=t.split("/").filter(Boolean);if(!(r.length<o.length)){for(let e=0;e<o.length;e+=1)if(o[e]!==r[e])return;return r.slice(o.length).join("/")}}(e,t);return void 0===o?t:`/${o.split("/").filter(Boolean).join("/")}`}function canonicalPath(t){try{return e.native(t)}catch{return t}}function deepagentsMemoryWritable(e){const t=readConfigRecord(e.workspace.runtime.memory,"deepagentsMem");return!1!==t?.write}function isFilesystemDisabled(e){const t=readConfigRecord(e.agent.config,"builtinTools");return!1===t?.filesystem}function isTaskVisible(e){const t=readConfigRecord(e.agent.config,"builtinTools")?.modelExposed;return!1!==t&&(!Array.isArray(t)||t.includes("task"))}function isModelVisibleBuiltin(e,t){return(!isFilesystemDisabled(e)||!function isFilesystemTool(e){return"string"==typeof e&&f.has(e)}(t))&&("task"!==t||isTaskVisible(e))}function readConfigRecord(e,t){const o=isRecord(e)?e:{};return isRecord(o[t])?o[t]:void 0}function readString(e){return"string"==typeof e&&e.trim()?e:void 0}function isRecord(e){return"object"==typeof e&&null!==e&&!Array.isArray(e)}function formatError(e){return e instanceof Error?e.message:String(e)}function previewError(e){const t=e.replace(/\s+/gu," ").trim();return t.length>800?`${t.slice(0,797)}...`:t}

package/packages/adapter-deepagents/dist/src/internal/gateway-tools.d.ts

@@ -1,4 +1,32 @@
 import { ToolMessage } from "@langchain/core/messages";
 import type { RuntimeAdapter } from "@stable-harness/core";
-export declare function buildGatewayTools(input: Parameters<RuntimeAdapter["run"]>[0], agentId: string, toolIds: string[]): import("@langchain/core/tools").DynamicTool<string | ToolMessage<import("@langchain/core/messages").MessageStructure<import("@langchain/core/messages").MessageToolSet>>, unknown>[];
+import type { RuntimeToolRepairModel } from "@stable-harness/core";
+export type ToolRepeatState = {
+    successfulCalls: Map<string, string>;
+    duplicateCallCounts: Map<string, number>;
+    latestSuccessfulOutputByTool: Map<string, string>;
+    successfulToolCounts: Map<string, number>;
+    toolCallCounts: Map<string, number>;
+    maxDuplicateCallsPerTool?: number;
+    maxCallsPerTool?: number;
+    maxSuccessfulCallsPerTool?: number;
+    maxCallsByTool: Map<string, number>;
+    maxSuccessfulCallsByTool: Map<string, number>;
+};
+export declare function buildGatewayTools(input: Parameters<RuntimeAdapter["run"]>[0], agentId: string, toolIds: string[], repairModel?: RuntimeToolRepairModel, repeatState?: ToolRepeatState | undefined): import("@langchain/core/tools").DynamicTool<string | ToolMessage<import("@langchain/core/messages").MessageStructure<import("@langchain/core/messages").MessageToolSet>>, unknown>[];
+export declare function createToolRepeatState(config: unknown): ToolRepeatState | undefined;
+export declare function beforeToolInvoke(toolId: string, args: unknown, state: ToolRepeatState): {
+    eventOutput: string;
+    modelOutput: string;
+} | undefined;
+export declare function isToolRepeatLimitReached(toolId: string, state: ToolRepeatState | undefined): boolean;
+export declare function afterToolInvoke(toolId: string, args: unknown, output: string, result: unknown, state: ToolRepeatState): {
+    eventOutput?: string;
+    modelOutput?: string;
+};
 export declare function stringifyDeepAgentResult(result: unknown): string;
+export declare function toolControlProjection(output: string): {
+    controlStatus: string;
+} | {
+    controlStatus?: undefined;
+};

package/packages/adapter-deepagents/dist/src/internal/gateway-tools.js

@@ -1 +1 @@
-import{ToolMessage as e}from"@langchain/core/messages";import{tool as t}from"@langchain/core/tools";export function buildGatewayTools(s,n,a){return s.toolGateway?a.flatMap(a=>{const i=s.toolGateway?.get(a);if(!i)return[];const u=s.workspace.tools.get(a);return[t(async t=>{s.emit({type:"adapter.event",requestId:s.requestId,sessionId:s.sessionId,agentId:n,event:{adapter:"deepagents",phase:"tool.start",toolId:a}});const i=await async function(t,s,n,a){try{return await t.toolGateway.invoke({toolId:n,args:a,context:{workspaceRoot:t.workspace.root,requestId:t.requestId,sessionId:t.sessionId,agentId:s}})}catch(s){if(function(e){return e instanceof Error&&"ToolArgumentValidationError"===e.name&&"string"==typeof e.toolId&&Array.isArray(e.issues)}(s))return new e({tool_call_id:`stable-harness-${n}-argument-guard`,name:n,status:"error",content:r(s)});if(t.workspace.runtime.retry?.tools?.enabled)throw s;return new e({tool_call_id:`stable-harness-${n}-execution-error`,name:n,status:"error",content:JSON.stringify({error:"tool_execution_failed",toolId:n,message:o(s),retry:"Use the error as evidence, adjust the tool arguments if possible, or return a final answer with the blocker."})})}}(s,n,a,t);return s.emit({type:"adapter.event",requestId:s.requestId,sessionId:s.sessionId,agentId:n,event:{adapter:"deepagents",phase:"tool.result",toolId:a}}),i instanceof e?i:stringifyDeepAgentResult(i.output)},{name:a,description:u?.description??i.description??a,schema:u?.schema??{type:"object",additionalProperties:!0}})]}):[]}export function stringifyDeepAgentResult(e){if("string"==typeof e)return e;if(s(e)){const t=e.structuredResponse??e.structured_response;if(void 0!==t)return"string"==typeof t?t:JSON.stringify(t);const r=(Array.isArray(e.messages)?e.messages:[]).at(-1);if(s(r)&&"string"==typeof r.content)return r.content}return JSON.stringify(e)}function r(e){return JSON.stringify({error:"tool_argument_validation_failed",toolId:e.toolId,issues:e.issues,retry:"Call the same tool again with arguments that satisfy the reported schema and semantic issues."})}function s(e){return"object"==typeof e&&null!==e&&!Array.isArray(e)}function o(e){return e instanceof Error?e.message:String(e)}
+import{ToolMessage as t}from"@langchain/core/messages";import{tool as e}from"@langchain/core/tools";export function buildGatewayTools(o,r,n,s,a=createToolRepeatState(o.workspace.runtime.toolGateway)){return o.toolGateway?n.flatMap(n=>{const l=o.toolGateway?.get(n);if(!l)return[];const i=o.workspace.tools.get(n),u=i?.schema??l.schema;return[e(async e=>async function invokeGuardedGatewayTool(e){emitToolResult(e.input,e.agentId,e.toolId,void 0);const o=e.repeatState?beforeToolInvoke(e.toolId,e.args,e.repeatState):void 0;if(o)return emitToolResult(e.input,e.agentId,e.toolId,o.eventOutput),o.modelOutput;const r=await async function invokeGatewayTool(e,o,r,n,s){try{return await e.toolGateway.invoke({toolId:r,args:n,repairModel:s,context:{workspaceRoot:e.workspace.root,requestId:e.requestId,sessionId:e.sessionId,agentId:o}})}catch(o){if(function isToolArgumentValidationError(t){return t instanceof Error&&"ToolArgumentValidationError"===t.name&&"string"==typeof t.toolId&&Array.isArray(t.issues)}(o))return new t({tool_call_id:`stable-harness-${r}-argument-guard`,name:r,status:"error",content:formatToolArgumentError(o)});if(e.workspace.runtime.retry?.tools?.enabled)throw o;return new t({tool_call_id:`stable-harness-${r}-execution-error`,name:r,status:"error",content:JSON.stringify({error:"tool_execution_failed",toolId:r,message:formatError(o),retry:"Use the error as evidence, adjust the tool arguments if possible, or return a final answer with the blocker."})})}}(e.input,e.agentId,e.toolId,e.args,e.repairModel),n=r instanceof t?String(r.content):stringifyDeepAgentResult(r.output),s=e.repeatState?afterToolInvoke(e.toolId,e.args,n,r,e.repeatState):{};return emitToolResult(e.input,e.agentId,e.toolId,s.eventOutput??n),void 0!==s.modelOutput?s.modelOutput:r instanceof t?r:n}({input:o,agentId:r,toolId:n,args:e,repairModel:s,repeatState:a}),{name:n,description:buildToolDescription(i?.description??l.description??n,u,o.workspace.runtime.toolGateway,n),schema:{type:"object",additionalProperties:!0}})]}):[]}export function createToolRepeatState(t){if(function repeatGuardEnabled(t){return!0===repeatGuardConfig(t).enabled}(t))return{successfulCalls:new Map,duplicateCallCounts:new Map,latestSuccessfulOutputByTool:new Map,successfulToolCounts:new Map,toolCallCounts:new Map,maxDuplicateCallsPerTool:readPositiveInteger(repeatGuardConfig(t).maxDuplicateCallsPerTool)??3,maxCallsPerTool:readPositiveInteger(repeatGuardConfig(t).maxCallsPerTool),maxSuccessfulCallsPerTool:readPositiveInteger(repeatGuardConfig(t).maxSuccessfulCallsPerTool),maxCallsByTool:readPositiveIntegerMap(repeatGuardConfig(t).maxCallsByTool),maxSuccessfulCallsByTool:readPositiveIntegerMap(repeatGuardConfig(t).maxSuccessfulCallsByTool)}}function repeatGuardConfig(t){return isRecord(t)&&isRecord(t.repeatGuard)?t.repeatGuard:{}}function readPositiveInteger(t){return"number"==typeof t&&Number.isInteger(t)&&t>0?t:void 0}function readPositiveIntegerMap(t){return isRecord(t)?new Map(Object.entries(t).map(([t,e])=>[t,readPositiveInteger(e)]).filter(t=>void 0!==t[1])):new Map}export function beforeToolInvoke(t,e,o){const r=o.toolCallCounts.get(t)??0;o.toolCallCounts.set(t,r+1);const n=o.maxCallsByTool.get(t)??o.maxCallsPerTool;if(void 0!==n&&r>=n)throw new Error(`Stable Harness repeat limit reached for tool '${t}' after ${n} call(s).`);const s=o.maxSuccessfulCallsByTool.get(t)??o.maxSuccessfulCallsPerTool;if(void 0!==s&&(o.successfulToolCounts.get(t)??0)>=s){const e=repeatedToolCallLimitContent(t,o.latestSuccessfulOutputByTool.get(t));return{eventOutput:e,modelOutput:e}}const a=stableToolCallKey(t,e),l=o.successfulCalls.get(a);if(void 0!==l){const e=o.duplicateCallCounts.get(a)??0;if(o.duplicateCallCounts.set(a,e+1),void 0!==o.maxDuplicateCallsPerTool&&e>=o.maxDuplicateCallsPerTool){const e=repeatedToolCallLimitContent(t);return{eventOutput:e,modelOutput:e}}const r=function duplicateToolCallContent(t,e){return JSON.stringify({status:"duplicate_tool_call",toolId:t,instruction:"This agent already completed an equivalent tool call. Use the prior evidence instead of calling the tool again.",previousOutput:e})}(t,l);return{eventOutput:r,modelOutput:l}}}export function isToolRepeatLimitReached(t,e){if(!e)return!1;const o=e.maxCallsByTool.get(t)??e.maxCallsPerTool;if(void 0!==o&&(e.toolCallCounts.get(t)??0)>=o)return!0;const r=e.maxSuccessfulCallsByTool.get(t)??e.maxSuccessfulCallsPerTool;return void 0!==r&&(e.successfulToolCounts.get(t)??0)>=r}export function afterToolInvoke(e,o,r,n,s){return n instanceof t&&"error"===n.status||(s.successfulCalls.set(stableToolCallKey(e,o),r),s.latestSuccessfulOutputByTool.set(e,r),s.successfulToolCounts.set(e,(s.successfulToolCounts.get(e)??0)+1)),{}}function emitToolResult(t,e,o,r){t.emit({type:"runtime.adapter.event",requestId:t.requestId,sessionId:t.sessionId,agentId:e,event:void 0===r?{adapter:"deepagents",phase:"agent.tool.start",toolId:o}:{adapter:"deepagents",phase:"agent.tool.result",toolId:o,output:previewToolOutput(r),...toolControlProjection(r)}})}function repeatedToolCallLimitContent(t,e){return JSON.stringify({status:"repeated_tool_call_limit",toolId:t,instruction:"This tool reached the configured repeat limit for this request. Do not call this tool or a substitute tool for the same evidence need again. Use previousOutput and the collected evidence to produce the final answer now, or report the remaining gap explicitly.",...void 0!==e?{previousOutput:e}:{}})}export function stringifyDeepAgentResult(e){if(e instanceof t)return function stringifyToolMessageContent(t){return"string"==typeof t?t:JSON.stringify(t)}(e.content);if("string"==typeof e)return e;if(isRecord(e)){const t=e.structuredResponse??e.structured_response;if(void 0!==t)return"string"==typeof t?t:JSON.stringify(t);const o=(Array.isArray(e.messages)?e.messages:[]).at(-1);if(isRecord(o)&&"string"==typeof o.content)return o.content;const r=(isRecord(e.update)&&Array.isArray(e.update.messages)?e.update.messages:[]).at(-1);if(isRecord(r)&&isRecord(r.kwargs)&&"string"==typeof r.kwargs.content)return r.kwargs.content;if(isRecord(r)&&"string"==typeof r.content)return r.content}return JSON.stringify(e)}function buildToolDescription(t,e,o,r){const n=function toolRepeatPolicyDescription(t,e){const o=repeatGuardConfig(t),r=readPositiveIntegerMap(o.maxSuccessfulCallsByTool).get(e)??readPositiveInteger(o.maxSuccessfulCallsPerTool);return void 0===r?"":`Stable runtime repeat policy: call this tool at most ${r} successful time(s) for this request. If more detail is needed, include the dimensions in the first call and synthesize after the result returns.`}(o,r),s=n?`${t}\n\n${n}`:t;return e?`${s}\n\nStable tool input schema:\n${previewToolOutput(JSON.stringify(e))}`:s}function previewToolOutput(t){const e=t.replace(/\s+/gu," ").trim();return e.length>500?`${e.slice(0,497)}...`:e}export function toolControlProjection(t){const e=function parseJsonRecord(t){try{const e=JSON.parse(t);return isRecord(e)?e:void 0}catch{return}}(t);return"string"==typeof e?.status?{controlStatus:e.status}:"string"==typeof e?.error?{controlStatus:e.error}:t.startsWith("Task delegation target is not in the workspace inventory")?{controlStatus:"task_inventory_blocked"}:{}}function stableToolCallKey(t,e){return`${t}:${stableJson(e)}`}function stableJson(t){return Array.isArray(t)?`[${t.map(stableJson).join(",")}]`:isRecord(t)?`{${Object.keys(t).sort().map(e=>`${JSON.stringify(e)}:${stableJson(t[e])}`).join(",")}}`:JSON.stringify(t)}function formatToolArgumentError(t){return JSON.stringify({error:"tool_argument_validation_failed",toolId:t.toolId,issues:t.issues,retry:"Call the same tool again with arguments that satisfy the reported schema and semantic issues."})}function isRecord(t){return"object"==typeof t&&null!==t&&!Array.isArray(t)}function formatError(t){return t instanceof Error?t.message:String(t)}

package/packages/adapter-deepagents/dist/src/internal/messages.js

@@ -1 +1 @@
-export function buildDeepAgentRequest(t){return{messages:e(t)}}function e(e){const t=(r=e.request.metadata?.openaiMessages,Array.isArray(r)?r.flatMap(e=>{const t=function(e){return"object"==typeof e&&null!==e&&!Array.isArray(e)}(e)?e:{},n=function(e){if("system"===e||"user"===e||"assistant"===e||"tool"===e)return e}(t.role),r="string"==typeof t.content?t.content:"";return n&&r?[{role:n,content:r}]:[]}):[]),n=function(e){const t=(e.pluginMemories??[]).filter(e=>e.context.trim()).map(e=>`Memory namespace: ${e.namespace}\n${e.context}`).join("\n\n");return t?`Relevant long-term memory:\n${t}`:void 0}(e);var r;return t.length>0?n?[{role:"system",content:n},...t]:t:[{role:"user",content:n?`${n}\n\nUser request:\n${e.request.input}`:e.request.input}]}
+export function buildDeepAgentRequest(e){return{messages:buildDeepAgentMessages(e)}}function buildDeepAgentMessages(e){const t=function readOpenAiMessages(e){return Array.isArray(e)?e.flatMap(e=>{const t=function isRecord(e){return"object"==typeof e&&null!==e&&!Array.isArray(e)}(e)?e:{},n=function readRole(e){if("system"===e||"user"===e||"assistant"===e||"tool"===e)return e}(t.role),r="string"==typeof t.content?t.content:"";return n&&r?[{role:n,content:r}]:[]}):[]}(e.request.metadata?.openaiMessages),n="tool_call"===e.request.metadata?.stableHarnessRecovery?void 0:function buildMemoryContext(e){const t=(e.pluginMemories??[]).filter(e=>e.context.trim()).map(e=>`Memory namespace: ${e.namespace}\n${e.context}`).join("\n\n");return t?`Relevant long-term memory:\n${t}`:void 0}(e);if(t.length>0){const r=function applyRecoveryPrompt(e,t){return"tool_call"!==t.request.metadata?.stableHarnessRecovery?e:[{role:"user",content:t.request.input}]}(t,e);return n?[{role:"system",content:n},...r]:r}const r={role:"user",content:e.request.input};return n?[{role:"system",content:n},r]:[r]}

package/packages/adapter-deepagents/dist/src/internal/raw-tool-call-parser.d.ts

@@ -0,0 +1,12 @@
+import type { RuntimeAdapter } from "@stable-harness/core";
+type AdapterRunInput = Parameters<RuntimeAdapter["run"]>[0];
+type ModelRequest = {
+    tools?: Array<{
+        name?: unknown;
+    }>;
+};
+export declare function createRawToolCallParserMiddleware(input: AdapterRunInput): {
+    name: string;
+    wrapModelCall(request: ModelRequest, handler: (request: unknown) => Promise<unknown>): Promise<unknown>;
+};
+export {};

package/packages/adapter-deepagents/dist/src/internal/raw-tool-call-parser.js

@@ -0,0 +1 @@
+import{AIMessage as e}from"@langchain/core/messages";export function createRawToolCallParserMiddleware(t){return{name:"StableHarnessRawToolCallParser",async wrapModelCall(n,r){const o=await r(n);if(!function rawToolCallParsingEnabled(e){const t=isRecord(e.workspace.runtime.recovery)?e.workspace.runtime.recovery:{};return!0===(isRecord(t.toolCall)?t.toolCall:{}).enabled}(t))return o;const a=function parseRawToolCallResponse(t,n){if(0===n.size||!function isModelResponse(e){return isRecord(e)}(t)||function hasToolCalls(e){return Array.isArray(e.tool_calls)&&e.tool_calls.length>0}(t))return;const r=function readContentText(e){return"string"==typeof e?e.trim()?e:void 0:Array.isArray(e)&&e.map(e=>isRecord(e)&&"string"==typeof e.text?e.text:"").join("\n").trim()||void 0}(t.content);if(!r)return;const o=function readRawToolCalls(e,t){const n=readXmlToolCalls(e,t);if(n.length>0)return n;const r=function stripToolMarkup(e){return e.replace(/^\s*```(?:json)?/iu,"").replace(/```\s*$/iu,"").replace(/^\s*<\s*tool_call[^>]*>\s*/iu,"").replace(/\s*<\s*\/\s*tool_call\s*>\s*$/iu,"").trim()}(e),o=readXmlToolCalls(r,t);if(o.length>0)return o;const a=function readFunctionToolCalls(e,t){const n=[];for(const r of t){const t=new RegExp(`(?:^|\\s)${escapeRegexp(r)}\\s*\\(([^)]*)\\)`,"giu");for(const o of e.matchAll(t)){const e=readFunctionArgs(o[1]??"");e&&Object.keys(e).length>0&&n.push({id:`stable-harness-${r}-${Date.now().toString(36)}`,name:r,args:e})}}return n}(r,t);return a.length>0?a:function parseJsonObjects(e){const t=[];let n=e.indexOf("{");for(;n>=0;){const r=readBalancedJsonObject(e,n);if(r){try{const e=JSON.parse(r);isRecord(e)&&t.push(e)}catch{}n=e.indexOf("{",n+r.length)}else n=e.indexOf("{",n+1)}return t}(r).flatMap(e=>function readJsonToolCall(e,t){const n=function readNestedToolCall(e,t){const n=Object.entries(e);if(1!==n.length)return;const[r,o]=n[0];return t.has(r)&&isRecord(o)?{id:`stable-harness-${r}-${Date.now().toString(36)}`,name:r,args:o}:void 0}(e,t);if(n)return n;const r=readString(e.name)??readString(e.tool_name)??readString(e.tool)??readString(e.type),o=t.has(r??"")?r:singleToolName(t),a=function readArgs(e){return isRecord(e.arguments)?e.arguments:isRecord(e.parameters)?e.parameters:isRecord(e.args)?e.args:"args"in e&&void 0!==e.args?{args:e.args}:void 0}(e)??function readInlineArgs(e){const t=Object.fromEntries(Object.entries(e).filter(([e])=>!["name","tool_name","tool","type"].includes(e)));return Object.keys(t).length>0?t:void 0}(e);return o&&t.has(o)&&a?{id:`stable-harness-${o}-${Date.now().toString(36)}`,name:o,args:a}:void 0}(e,t)??[])}(r,n);return 0!==o.length?new e({content:"",id:"string"==typeof t.id?t.id:void 0,name:"string"==typeof t.name?t.name:void 0,additional_kwargs:isRecord(t.additional_kwargs)?t.additional_kwargs:{},response_metadata:isRecord(t.response_metadata)?t.response_metadata:{},tool_calls:o.map(e=>({id:e.id,name:e.name,args:e.args,type:"tool_call"}))}):void 0}(o,function visibleToolNames(e){return new Set((e.tools??[]).map(e=>e.name).filter(e=>"string"==typeof e&&e.length>0))}(n));return a??o}}}function readXmlToolCalls(e,t){const n=[],r=/<\s*(tool_call|tool_code)\b[^>]*>(?:[\s\S]*?<\s*\/\s*\1\s*>)?/giu;for(const o of e.matchAll(r)){const e=readXmlToolCall(o[0],t);e&&n.push(e)}return n}function readXmlToolCall(e,t){const n=function readToolCallAttributes(e){const t=/<\s*(?:tool_call|tool_code)\b([^>]*)>/iu.exec(e);if(!t)return;const n=[...t[1].matchAll(/([a-zA-Z_][\w.-]*)\s*=\s*"([^"]*)"/gu)];return n.length>0?Object.fromEntries(n.map(e=>[e[1],e[2]])):void 0}(e),r=readString(n?.name)??readString(n?.tool_name)??readString(n?.tool)??readXmlTag(e,"tool_name")??readXmlTag(e,"name")??readXmlTag(e,"tool"),o=t.has(r??"")?r:singleToolName(t);if(!o||!t.has(o))return;const a=readXmlTag(e,"tool_args")??readXmlTag(e,"args")??readXmlTag(e,"arguments"),s=a?function readXmlArgs(e){const t=[...e.matchAll(/<\s*([a-zA-Z_][\w.-]*)\s*>([\s\S]*?)<\s*\/\s*\1\s*>/gu)];if(0===t.length){const t=e.trim();return t?{input:t}:void 0}return Object.fromEntries(t.map(e=>[e[1],e[2].trim()]))}(a):function readAttributeArgs(e){if(!e)return;const t=Object.fromEntries(Object.entries(e).filter(([e])=>!["name","tool_name","tool","type"].includes(e)));return Object.keys(t).length>0?t:void 0}(n);return s&&0!==Object.keys(s).length?{id:`stable-harness-${o}-${Date.now().toString(36)}`,name:o,args:s}:void 0}function readXmlTag(e,t){const n=new RegExp(`<\\s*${t}\\s*>([\\s\\S]*?)<\\s*\\/\\s*${t}\\s*>`,"iu").exec(e);return n?.[1]?.trim()||void 0}function readFunctionArgs(e){const t=[...e.matchAll(/([a-zA-Z_][\w.-]*)\s*=\s*(?:"([^"]*)"|'([^']*)'|([^,\s]+))/gu)];return t.length>0?Object.fromEntries(t.map(e=>[e[1],e[2]??e[3]??e[4]??""])):void 0}function readBalancedJsonObject(e,t){let n=0,r=!1,o=!1;for(let a=t;a<e.length;a+=1){const s=e[a];if(r)o="\\"===s&&!o,'"'!==s||o||(r=!1),"\\"!==s&&(o=!1);else if('"'===s&&(r=!0),"{"===s&&(n+=1),"}"===s&&(n-=1),0===n)return e.slice(t,a+1)}}function singleToolName(e){return 1===e.size?[...e][0]:void 0}function escapeRegexp(e){return e.replace(/[.*+?^${}()|[\]\\]/gu,"\\$&")}function readString(e){return"string"==typeof e&&e.trim()?e.trim():void 0}function isRecord(e){return"object"==typeof e&&null!==e&&!Array.isArray(e)}

package/packages/adapter-deepagents/dist/src/internal/skill-file-policy.d.ts

@@ -0,0 +1,10 @@
+import { ToolMessage } from "@langchain/core/messages";
+import type { RuntimeAdapter } from "@stable-harness/core";
+type AdapterRunInput = Parameters<RuntimeAdapter["run"]>[0];
+export declare function validateSkillFileBuiltinCall(input: AdapterRunInput, toolId: string, request: {
+    toolCall?: {
+        id?: string;
+        args?: unknown;
+    };
+}): ToolMessage<import("@langchain/core/messages").MessageStructure<import("@langchain/core/messages").MessageToolSet>> | undefined;
+export {};

package/packages/adapter-deepagents/dist/src/internal/skill-file-policy.js

@@ -0,0 +1 @@
+import{ToolMessage as e}from"@langchain/core/messages";export function validateSkillFileBuiltinCall(t,l,r){const i=function readFilesystemTarget(e){const t=function isRecord(e){return"object"==typeof e&&null!==e&&!Array.isArray(e)}(e)?e:{};for(const e of["file_path","path","pattern","query"]){const l=t[e];if("string"==typeof l&&l.trim())return l.trim()}}(r.toolCall?.args);if(i&&function targetsRegisteredSkill(e,t){return[...e.workspace.skills.values()].some(l=>{const r=function virtualSkillDir(e,t){const l=function pathRelative(e,t){const l=e.split("/").filter(Boolean),r=t.split("/").filter(Boolean);if(!(r.length<l.length)){for(let e=0;e<l.length;e+=1)if(l[e]!==r[e])return;return r.slice(l.length).join("/")}}(e,t);if(void 0===l)return;const r=l.split("/").filter(Boolean),i=r.lastIndexOf("skills");return i<0?`/${r.slice(0,-1).join("/")}`:`/${r.slice(0,i+2).join("/")}`}(e.workspace.root,l.path);return!!r&&function pathMatches(e,t){const l=t.replace(/\/+$/u,"");return e===l||e.startsWith(`${l}/`)||e.includes(`${l}/`)||e.includes("SKILL.md")}(t,r)})}(t,i))return new e({tool_call_id:r.toolCall?.id??`stable-harness-${l}-skill-policy`,name:l,status:"error",content:[`Filesystem builtin tool '${l}' targeted registered skill inventory: ${i}.`,"Skills are already registered with the backend and are not evidence files for the user request.","Do not read, list, glob, or grep SKILL.md files or skill directories.","Continue with the declared agent tools, the skill behavior already loaded by the backend, and the evidence already collected."].join(" ")})}

package/packages/adapter-deepagents/dist/src/internal/stream-events.js

@@ -1 +1 @@
-export async function streamDeepAgentResult(e,r,o){let i,s="";for await(const a of r){const r=t(a);r&&(s+=r,e.emit({type:"adapter.event",requestId:e.requestId,sessionId:e.sessionId,agentId:e.agent.id,event:{adapter:"deepagents",phase:"output.delta",text:r}}));const u=n(a,o);u&&(i=u)}return i??s}function t(t){const n=o(t)?t:{};if("on_chat_model_stream"===n.event)return function(t){const n=t?.content;return"string"==typeof n?n:Array.isArray(n)&&n.map(e).filter(Boolean).join("")||void 0}(r(r(n.data)?.chunk))}function e(t){if("string"==typeof t)return t;const e=o(t)?t:{};return"string"==typeof e.text&&e.text.trim()?e.text:void 0}function n(t,e){const n=o(t)?t:{};if("on_chain_end"!==n.event)return;const i=r(n.data)?.output;return e(i)||void 0}function r(t){return o(t)?t:void 0}function o(t){return"object"==typeof t&&null!==t&&!Array.isArray(t)}
+export async function streamDeepAgentResult(t,e,r){let n,o="";for await(const a of e){const e=readStreamDelta(a);e&&(o+=e,t.emit({type:"runtime.adapter.event",requestId:t.requestId,sessionId:t.sessionId,agentId:t.agent.id,event:{adapter:"deepagents",phase:"agent.output.delta",text:e}}));const d=readStreamFinalOutput(a,r);d&&(n=d)}return n??o}function readStreamDelta(t){const e=isRecord(t)?t:{};if("on_chat_model_stream"===e.event)return function readChunkText(t){const e=t?.content;return"string"==typeof e?e:Array.isArray(e)&&e.map(readContentPartText).filter(Boolean).join("")||void 0}(readRecord(readRecord(e.data)?.chunk))}function readContentPartText(t){if("string"==typeof t)return t;const e=isRecord(t)?t:{};return"string"==typeof e.text&&e.text.trim()?e.text:void 0}function readStreamFinalOutput(t,e){const r=isRecord(t)?t:{};if("on_chain_end"!==r.event)return;const n=readRecord(r.data)?.output;return e(n)||void 0}function readRecord(t){return isRecord(t)?t:void 0}function isRecord(t){return"object"==typeof t&&null!==t&&!Array.isArray(t)}

package/packages/adapter-deepagents/dist/src/internal/tool-repeat-visibility.d.ts

@@ -0,0 +1,4 @@
+import type { ToolRepeatState } from "./gateway-tools.js";
+export declare function filterRepeatLimitedTools<T extends {
+    name?: unknown;
+}>(tools: T[] | undefined, repeatState: ToolRepeatState | undefined): T[] | undefined;

package/packages/adapter-deepagents/dist/src/internal/tool-repeat-visibility.js

@@ -0,0 +1 @@
+import{isToolRepeatLimitReached as e}from"./gateway-tools.js";export function filterRepeatLimitedTools(t,o){return t&&o?t.filter(t=>"string"!=typeof t.name||!e(t.name,o)):t}

package/packages/adapter-deepagents/dist/src/internal/trace-projection.d.ts

@@ -1,4 +1,4 @@
-export declare function traceProjectionForBuiltinTool(toolId: string, phase: "tool.start" | "tool.result", args: unknown): {
+export declare function traceProjectionForBuiltinTool(toolId: string, phase: "agent.tool.start" | "agent.tool.result", args: unknown): {
     traceType: string;
     traceLabel: string;
     subagentType: string | undefined;

package/packages/adapter-deepagents/dist/src/internal/trace-projection.js

@@ -1 +1 @@
-export function traceProjectionForBuiltinTool(o,r,n){return"task"===o?{traceType:"delegation",traceLabel:"tool.start"===r?"delegation.start":"delegation.completed",subagentType:t(n)}:"write_todos"===o&&"tool.result"===r?{traceType:"plan",traceLabel:"plan.updated",todos:e(n)}:{}}function t(t){const e=o(t)?t:{};return r(e.subagent_type)??r(e.subagentType)}function e(t){const e=o(t)?t:{};return Array.isArray(e.todos)?e.todos:[]}function o(t){return"object"==typeof t&&null!==t&&!Array.isArray(t)}function r(t){return"string"==typeof t&&t.trim()?t:void 0}
+export function traceProjectionForBuiltinTool(t,e,r){return"task"===t?{traceType:"delegation",traceLabel:"agent.tool.start"===e?"delegation.start":"delegation.completed",subagentType:readTaskSubagentType(r)}:"write_todos"===t&&"agent.tool.result"===e?{traceType:"plan",traceLabel:"plan.updated",todos:readTodoArgs(r)}:{}}function readTaskSubagentType(t){const e=isRecord(t)?t:{};return readString(e.subagent_type)??readString(e.subagentType)}function readTodoArgs(t){const e=isRecord(t)?t:{};return Array.isArray(e.todos)?e.todos:[]}function isRecord(t){return"object"==typeof t&&null!==t&&!Array.isArray(t)}function readString(t){return"string"==typeof t&&t.trim()?t:void 0}

package/packages/adapter-deepagents/dist/src/memory.js

@@ -1 +1 @@
-import{resolveEnabledMemories as e}from"@stable-harness/core";export function resolveDeepAgentsNativeMemories(n){return!1===function(e,n,o){const t=r(e[n])??r(e[n.toLowerCase()]);return"boolean"==typeof t?.[o]?t[o]:void 0}(n.runtime.memory??{},"deepagentsMem","read")?[]:e(n,"all")}export function createDeepAgentsMemoryMaintenanceTarget(e={}){return{name:"deepagentsMem",run:async r=>e.run?e.run(r):{operations:[],metadata:{skipped:!0,reason:"No DeepAgents memory maintainer configured"}}}}function r(e){return"object"!=typeof e||null===e||Array.isArray(e)?void 0:e}
+import{resolveEnabledMemories as e}from"@stable-harness/core";export function resolveDeepAgentsNativeMemories(r){return!1===function readMemoryFlag(e,r,n){const o=readRecord(e[r])??readRecord(e[r.toLowerCase()]);return"boolean"==typeof o?.[n]?o[n]:void 0}(r.runtime.memory??{},"deepagentsMem","read")?[]:e(r,"all")}export function createDeepAgentsMemoryMaintenanceTarget(e={}){return{name:"deepagentsMem",run:async r=>e.run?e.run(r):{operations:[],metadata:{skipped:!0,reason:"No DeepAgents memory maintainer configured"}}}}function readRecord(e){return"object"!=typeof e||null===e||Array.isArray(e)?void 0:e}

package/packages/adapter-deepagents/dist/src/model-providers.d.ts

@@ -0,0 +1,4 @@
+import { ChatOllama } from "@langchain/ollama";
+import { ChatOpenAI } from "@langchain/openai";
+import type { WorkspaceModel } from "@stable-harness/core";
+export declare function createBackendModel(model: WorkspaceModel): string | ChatOpenAI<import("@langchain/openai").ChatOpenAICallOptions> | ChatOllama;

package/packages/adapter-deepagents/dist/src/model-providers.js

@@ -0,0 +1 @@
+import{ChatOllama as e}from"@langchain/ollama";import{ChatOpenAI as r}from"@langchain/openai";export function createBackendModel(r){return"ollama"===r.provider?function usesOpenAiCompatibleToolCalling(e){const r=readString(e.config?.toolCallingMode);return"openai-compatible"===r||"structured"===r}(r)?createOpenAiCompatibleModel({...r,config:{...r.config,baseURL:readOllamaOpenAiBaseUrl(r.config?.baseURL??r.config?.baseUrl)}}):function createOllamaModel(r){return new e(pruneUndefined({model:r.model,baseUrl:readString(r.config?.baseUrl),temperature:readNumber(r.config?.temperature),numCtx:readNumber(r.config?.numCtx),numPredict:readNumber(r.config?.numPredict),timeout:readNumber(r.config?.timeout),think:"boolean"==typeof r.config?.think?r.config.think:void 0}))}(r):"openai-compatible"===r.provider?createOpenAiCompatibleModel(r):r.model}function createOpenAiCompatibleModel(e){return new r(pruneUndefined({model:e.model,apiKey:readString(e.config?.apiKey),temperature:readNumber(e.config?.temperature),maxTokens:readNumber(e.config?.maxTokens)??readNumber(e.config?.numPredict),timeout:readNumber(e.config?.timeout),modelKwargs:readOpenAiCompatibleModelKwargs(e.config),configuration:pruneUndefined({baseURL:readString(e.config?.baseURL)??readString(e.config?.baseUrl),defaultHeaders:readStringRecord(e.config?.headers)})}))}function readOpenAiCompatibleModelKwargs(e){const r={...readRecord(e?.extraBody),...readRecord(e?.modelKwargs)},n=pruneUndefined({...r,think:r.think??("boolean"==typeof e?.think?e.think:void 0),num_ctx:r.num_ctx??readNumber(e?.numCtx),num_predict:r.num_predict??readNumber(e?.numPredict)});return Object.keys(n).length>0?n:void 0}function pruneUndefined(e){return Object.fromEntries(Object.entries(e).filter(([,e])=>void 0!==e))}function readString(e){return"string"==typeof e&&e.trim()?e:void 0}function readNumber(e){return"number"==typeof e&&Number.isFinite(e)?e:void 0}function readStringRecord(e){if("object"!=typeof e||null===e||Array.isArray(e))return;const r=Object.entries(e).filter(e=>"string"==typeof e[1]);return r.length>0?Object.fromEntries(r):void 0}function readRecord(e){return"object"!=typeof e||null===e||Array.isArray(e)?{}:e}function readOllamaOpenAiBaseUrl(e){const r=readString(e);if(!r)return;const n=r.replace(/\/+$/u,"");return n.endsWith("/v1")?n:`${n}/v1`}

package/packages/adapter-deepagents/dist/src/retry-policy.js

@@ -1 +1 @@
-import{modelRetryMiddleware as e,toolRetryMiddleware as t}from"langchain";export function createDeepAgentsRetryMiddleware(n){const o=[],i=r(n?.model);i&&o.push(e(i));const a=function(e){const t=r(e);if(!t)return;const n=Array.isArray(e?.tools)?e.tools.filter(e=>"string"==typeof e&&e.trim().length>0):void 0;return s({...t,tools:n})}(n?.tools);return a&&o.push(t(a)),o}function r(e){var t;if(e?.enabled)return s({maxRetries:n(e.maxRetries),backoffFactor:n(e.backoffFactor),initialDelayMs:n(e.initialDelayMs),maxDelayMs:n(e.maxDelayMs),jitter:"boolean"==typeof e.jitter?e.jitter:void 0,retryOn:o(e.retryOn),onFailure:(t=e.onFailure,"continue"===t||"error"===t?t:void 0)})}function n(e){return"number"==typeof e&&Number.isFinite(e)&&e>=0?e:void 0}function o(e){const t=function(e){const t=new Set(["timeout","network","rateLimit","serverError"]);if(!Array.isArray(e))return[...t];const r=e.filter(e=>t.has(e));return r.length>0?r:[...t]}(e);return e=>t.some(t=>i(e,t))}function i(e,t){const r=a(e)?e:{},n=function(e){const t=e.status??e.statusCode??e.code;return"number"==typeof t?t:Number.isInteger(Number(t))?Number(t):void 0}(r),o=`${String(r.name??"")} ${String(r.code??"")} ${String(r.message??e)}`,s=r.cause;return("timeout"===t?/timeout|timedout|etimedout|abort/i.test(o):"network"===t?/network|fetch failed|terminated|connection error|econnreset|econnrefused|enotfound|eai_again/i.test(o):"rateLimit"===t?429===n||/rate.?limit|too many requests/i.test(o):"serverError"===t&&Boolean(n&&n>=500&&n<600))||a(s)&&i(s,t)}function a(e){return"object"==typeof e&&null!==e&&!Array.isArray(e)}function s(e){return Object.fromEntries(Object.entries(e).filter(([,e])=>void 0!==e))}
+import{modelRetryMiddleware as e,toolRetryMiddleware as t}from"langchain";export function createDeepAgentsRetryMiddleware(r){const n=[],o=readRetryOptions(r?.model);o&&n.push(e(o));const i=function readToolRetryOptions(e){const t=readRetryOptions(e);if(!t)return;const r=Array.isArray(e?.tools)?e.tools.filter(e=>"string"==typeof e&&e.trim().length>0):void 0;return pruneUndefined({...t,tools:r})}(r?.tools);return i&&n.push(t(i)),n}function readRetryOptions(e){var t;if(e?.enabled)return pruneUndefined({maxRetries:readNonNegativeNumber(e.maxRetries),backoffFactor:readNonNegativeNumber(e.backoffFactor),initialDelayMs:readNonNegativeNumber(e.initialDelayMs),maxDelayMs:readNonNegativeNumber(e.maxDelayMs),jitter:"boolean"==typeof e.jitter?e.jitter:void 0,retryOn:createRetryPredicate(e.retryOn),onFailure:(t=e.onFailure,"continue"===t||"error"===t?t:void 0)})}function readNonNegativeNumber(e){return"number"==typeof e&&Number.isFinite(e)&&e>=0?e:void 0}function createRetryPredicate(e){const t=function readRetryReasons(e){const t=new Set(["timeout","network","rateLimit","serverError"]);if(!Array.isArray(e))return[...t];const r=e.filter(e=>t.has(e));return r.length>0?r:[...t]}(e);return e=>t.some(t=>matchesRetryReason(e,t))}function matchesRetryReason(e,t){const r=isRecord(e)?e:{},n=function readStatus(e){const t=e.status??e.statusCode??e.code;return"number"==typeof t?t:Number.isInteger(Number(t))?Number(t):void 0}(r),o=`${String(r.name??"")} ${String(r.code??"")} ${String(r.message??e)}`,i=r.cause;return("timeout"===t?/timeout|timedout|etimedout|abort/i.test(o):"network"===t?/network|fetch failed|terminated|connection error|eof|econnreset|econnrefused|enotfound|eai_again/i.test(o):"rateLimit"===t?429===n||/rate.?limit|too many requests/i.test(o):"serverError"===t&&Boolean(n&&n>=500&&n<600))||isRecord(i)&&matchesRetryReason(i,t)}function isRecord(e){return"object"==typeof e&&null!==e&&!Array.isArray(e)}function pruneUndefined(e){return Object.fromEntries(Object.entries(e).filter(([,e])=>void 0!==e))}

package/packages/adapter-deepagents/dist/src/types.d.ts

@@ -1,6 +1,12 @@
 import type { RuntimeAdapterContext, RuntimeAdapterResult } from "@stable-harness/core";
 export type DeepAgentFactory = (params?: Record<string, unknown>) => {
-    invoke(input: Record<string, unknown>): Promise<unknown>;
+    invoke(input: Record<string, unknown>, options?: Record<string, unknown>): Promise<unknown>;
     streamEvents?(input: Record<string, unknown>, options?: Record<string, unknown>): AsyncIterable<unknown>;
 };
+export type DeepAgentsModule = {
+    createDeepAgent?: unknown;
+    FilesystemBackend?: new (options: {
+        rootDir: string;
+    }) => unknown;
+};
 export type DeepAgentsAdapterRunner = (input: RuntimeAdapterContext) => Promise<RuntimeAdapterResult>;

package/packages/adapter-deepagents/package.json

@@ -12,6 +12,7 @@
   "dependencies": {
     "@langchain/core": "^1.1.43",
     "@langchain/ollama": "^1.2.7",
+    "@langchain/openai": "^1.4.5",
     "langchain": "^1.3.1",
     "@stable-harness/core": "0.0.1"
   },

package/packages/adapter-langgraph/dist/src/graph.js

@@ -1 +1 @@
-import{Annotation as o,END as e,START as t,StateGraph as n}from"@langchain/langgraph";import{compileWorkflowPlan as r}from"@stable-harness/core";import{resolveSkillProvider as a}from"./skill-providers.js";export async function runLangGraphWorkflow(a,s,u){!function(o){if(o.cycles.length>0)throw new Error(`LangGraph workflow adapter does not enable cyclic graphs by default: ${o.workflowId}`);if(o.unreachableNodes.length>0)throw new Error(`LangGraph workflow has unreachable nodes: ${o.unreachableNodes.join(", ")}`)}(r(a.workflow));const f=function(a,d,s){let u=new n(o.Root({input:o,outputs:o({reducer:(o,e)=>({...o,...e}),default:()=>({})}),trace:o({reducer:(o,e)=>[...o,...e],default:()=>[]})}));for(const o of a.workflow.nodes)u=u.addNode(o.id,async e=>i({input:a,node:o,state:e,options:d,adapterName:s}));u=u.addEdge(t,a.workflow.entry??a.workflow.nodes[0].id),u=function(o,e){for(const t of e.workflow.edges)t.condition||(o=o.addEdge(t.from,t.to));return o}(u,a),u=function(o,e,t){for(const[n,r]of function(o){const e=new Map;for(const t of o.workflow.edges){if(!t.condition)continue;const o=e.get(t.from)??[];o.push({condition:t.condition,to:t.to}),e.set(t.from,o)}return e}(e)){const a=t.conditionalRouters?.[n];if(!a)throw new Error(`LangGraph workflow conditional edges from ${n} require a conditional router`);o=o.addConditionalEdges(n,async o=>a({...e,from:n,edges:r,state:o}),Object.fromEntries(r.map(o=>[o.condition,o.to])))}return o}(u,a,d);for(const o of r(a.workflow).terminalNodes)u=u.addEdge(o,e);return u.compile()}(a,s,u);a.emit({adapter:u,phase:"langgraph.invoke",workflowId:a.workflow.id});const l=await f.invoke({input:a.request.input,outputs:{},trace:[]});return{text:d(l),metadata:{workflowId:a.workflow.id,adapter:u,outputs:l.outputs,trace:l.trace}}}async function i(o){const e=await function(o,e){const t=e.nodeHandlers?.[o.id]??e.nodeHandlers?.[o.use];if(t)return t;const n=function(o){const e=o.indexOf(".");if(!(e<=0||e===o.length-1))return{kind:o.slice(0,e),id:o.slice(e+1)}}(o.use);if("workflows"===n?.kind&&e.enableSubworkflows)return o=>async function(o,e){const t=o.workspace.workflows.get(o.id);if(!t)throw new Error(`LangGraph subworkflow is not defined: ${o.id}`);const n=function(o){const e=o?.subworkflowDepth;return"number"==typeof e&&Number.isFinite(e)?e:0}(o.request.metadata),r=e.maxSubworkflowDepth??8;if(n>=r)throw new Error(`LangGraph subworkflow depth exceeded ${r}`);return(await runLangGraphWorkflow({...o,workflow:t,request:{...o.request,input:o.state,metadata:{...o.request.metadata,subworkflowDepth:n+1}}},e,e.name??"langgraph")).text}({...o,id:n.id},e);const r=n?e.nodeResolvers?.[n.kind]:void 0;if(r&&n)return o=>r({...o,kind:n.kind,id:n.id});const i="skills"===n?.kind?a(e):void 0;if(i&&n)return o=>i.resolve({...o,kind:n.kind,id:n.id});const d=e.defaultNodeHandler;if(d)return d;throw new Error(`LangGraph workflow node ${o.id} (${o.use}) has no handler or resolver`)}(o.node,o.options)({...o.input,node:o.node,state:o.state});return o.input.emit({adapter:o.adapterName,phase:"node.completed",workflowId:o.input.workflow.id,nodeId:o.node.id}),{outputs:{[o.node.id]:e},trace:[{nodeId:o.node.id,use:o.node.use,output:e}]}}function d(o){const e=o.trace.at(-1)?.output;return"string"==typeof e?e:JSON.stringify(e??o.outputs)}
+import{Annotation as o,END as e,START as t,StateGraph as n}from"@langchain/langgraph";import{compileWorkflowPlan as r}from"@stable-harness/core";import{resolveSkillProvider as a}from"./skill-providers.js";export async function runLangGraphWorkflow(a,d,i){!function assertSupportedPlan(o){if(o.cycles.length>0)throw new Error(`LangGraph workflow adapter does not enable cyclic graphs by default: ${o.workflowId}`);if(o.unreachableNodes.length>0)throw new Error(`LangGraph workflow has unreachable nodes: ${o.unreachableNodes.join(", ")}`)}(r(a.workflow));const s=function compileLangGraph(a,d,i){let s=new n(function createStateAnnotation(){return o.Root({input:o,outputs:o({reducer:(o,e)=>({...o,...e}),default:()=>({})}),trace:o({reducer:(o,e)=>[...o,...e],default:()=>[]})})}());for(const o of a.workflow.nodes)s=s.addNode(o.id,async e=>runNode({input:a,node:o,state:e,options:d,adapterName:i}));s=s.addEdge(t,a.workflow.entry??a.workflow.nodes[0].id),s=function addStaticEdges(o,e){for(const t of e.workflow.edges)t.condition||(o=o.addEdge(t.from,t.to));return o}(s,a),s=function addConditionalEdges(o,e,t){for(const[n,r]of function conditionalEdgesBySource(o){const e=new Map;for(const t of o.workflow.edges){if(!t.condition)continue;const o=e.get(t.from)??[];o.push({condition:t.condition,to:t.to}),e.set(t.from,o)}return e}(e)){const a=t.conditionalRouters?.[n];if(!a)throw new Error(`LangGraph workflow conditional edges from ${n} require a conditional router`);o=o.addConditionalEdges(n,async o=>a({...e,from:n,edges:r,state:o}),Object.fromEntries(r.map(o=>[o.condition,o.to])))}return o}(s,a,d);for(const o of r(a.workflow).terminalNodes)s=s.addEdge(o,e);return s.compile()}(a,d,i);a.emit({adapter:i,phase:"agent.langgraph.invoke",workflowId:a.workflow.id});const u=await s.invoke({input:a.request.input,outputs:{},trace:[]});return{text:stringifyWorkflowOutput(u),metadata:{workflowId:a.workflow.id,adapter:i,outputs:u.outputs,trace:u.trace}}}async function runNode(o){const e=await function resolveNodeHandler(o,e){const t=e.nodeHandlers?.[o.id]??e.nodeHandlers?.[o.use];if(t)return t;const n=function parseNodeUse(o){const e=o.indexOf(".");if(!(e<=0||e===o.length-1))return{kind:o.slice(0,e),id:o.slice(e+1)}}(o.use);if("workflows"===n?.kind&&e.enableSubworkflows)return o=>async function runSubworkflow(o,e){const t=o.workspace.workflows.get(o.id);if(!t)throw new Error(`LangGraph subworkflow is not defined: ${o.id}`);const n=function readSubworkflowDepth(o){const e=o?.subworkflowDepth;return"number"==typeof e&&Number.isFinite(e)?e:0}(o.request.metadata),r=e.maxSubworkflowDepth??8;if(n>=r)throw new Error(`LangGraph subworkflow depth exceeded ${r}`);return(await runLangGraphWorkflow({...o,workflow:t,request:{...o.request,input:o.state,metadata:{...o.request.metadata,subworkflowDepth:n+1}}},e,e.name??"langgraph")).text}({...o,id:n.id},e);const r=n?e.nodeResolvers?.[n.kind]:void 0;if(r&&n)return o=>r({...o,kind:n.kind,id:n.id});const d="skills"===n?.kind?a(e):void 0;if(d&&n)return o=>d.resolve({...o,kind:n.kind,id:n.id});const i=e.defaultNodeHandler;if(i)return i;throw new Error(`LangGraph workflow node ${o.id} (${o.use}) has no handler or resolver`)}(o.node,o.options)({...o.input,node:o.node,state:o.state});return o.input.emit({adapter:o.adapterName,phase:"agent.node.completed",workflowId:o.input.workflow.id,nodeId:o.node.id}),{outputs:{[o.node.id]:e},trace:[{nodeId:o.node.id,use:o.node.use,output:e}]}}function stringifyWorkflowOutput(o){const e=o.trace.at(-1)?.output;return"string"==typeof e?e:JSON.stringify(e??o.outputs)}

package/packages/adapter-langgraph/dist/src/runtime.js

@@ -1 +1 @@
-import{runLangGraphWorkflow as e}from"./graph.js";export function createLangGraphRuntimeAdapter(t={}){const r=t.name??"langgraph";return{name:r,canRun:e=>e.backend===r,run:o=>async function(t,r,o){return e({workspace:t.workspace,workflow:n(t.agent,o),request:{input:t.request.input,metadata:t.request.metadata},requestId:t.requestId,sessionId:t.sessionId,toolGateway:t.toolGateway,emit:e=>t.emit({type:"adapter.event",requestId:t.requestId,sessionId:t.sessionId,agentId:t.agent.id,event:e})},r,o)}(o,t,r)}}function n(e,n){const r=e.edges??[],s=r.length>0?t(e):t(e).slice(0,1);return function(e,n){const t=new Set;for(const r of n){if(t.has(r.id))throw new Error(`LangGraph agent ${e.id} has duplicate graph node ${r.id}`);t.add(r.id)}for(const n of e.edges??[])if(!t.has(n.from)||!t.has(n.to))throw new Error(`LangGraph agent ${e.id} edge references unknown node ${n.from}->${n.to}`)}({...e,edges:r},s),{id:e.id,...e.description?{description:e.description}:{},...e.sourcePath?{sourcePath:e.sourcePath}:{},adapter:n,entry:o(e,s),nodes:s,edges:r,...Object.keys(e.config).length>0?{config:e.config}:{}}}function t(e){return[...e.subagents.map(e=>r("agents",e)),...(e.skills??[]).map(e=>r("skills",e)),...e.tools.map(e=>r("tools",e))]}function r(e,n){return{id:n,use:`${e}.${n}`}}function o(e,n){return e.edges?.[0]?.from??n[0]?.id}
+import{runLangGraphWorkflow as e}from"./graph.js";export function createLangGraphRuntimeAdapter(n={}){const t=n.name??"langgraph";return{name:t,canRun:e=>e.backend===t,run:r=>async function runLangGraphAgent(n,t,r){return e({workspace:n.workspace,workflow:workflowFromAgent(n.agent,r),request:{input:n.request.input,metadata:n.request.metadata},requestId:n.requestId,sessionId:n.sessionId,toolGateway:n.toolGateway,emit:e=>n.emit({type:"runtime.adapter.event",requestId:n.requestId,sessionId:n.sessionId,agentId:n.agent.id,event:e})},t,r)}(r,n,t)}}function workflowFromAgent(e,n){const t=e.edges??[],r=t.length>0?agentNodes(e):agentNodes(e).slice(0,1);return function validateAgentGraph(e,n){const t=new Set;for(const r of n){if(t.has(r.id))throw new Error(`LangGraph agent ${e.id} has duplicate graph node ${r.id}`);t.add(r.id)}for(const n of e.edges??[])if(!t.has(n.from)||!t.has(n.to))throw new Error(`LangGraph agent ${e.id} edge references unknown node ${n.from}->${n.to}`)}({...e,edges:t},r),{id:e.id,...e.description?{description:e.description}:{},...e.sourcePath?{sourcePath:e.sourcePath}:{},adapter:n,entry:readAgentEntry(e,r),nodes:r,edges:t,...Object.keys(e.config).length>0?{config:e.config}:{}}}function agentNodes(e){return[...e.subagents.map(e=>inventoryNode("agents",e)),...(e.skills??[]).map(e=>inventoryNode("skills",e)),...e.tools.map(e=>inventoryNode("tools",e))]}function inventoryNode(e,n){return{id:n,use:`${e}.${n}`}}function readAgentEntry(e,n){return e.edges?.[0]?.from??n[0]?.id}

package/packages/adapter-langgraph/dist/src/skill-providers.js

@@ -1 +1 @@
-import{readFile as e}from"node:fs/promises";import r from"node:path";export function createRegistrySkillResolverProvider(e={}){return{name:"registry-resolver",resolve:r=>async function(e,r){const o=e.workspace.skills.get(e.id);if(!o)throw new Error(`LangGraph skill resolver cannot find skill ${e.id}`);return{id:o.id,path:o.path,...o.description?{description:o.description}:{},allowedTools:o.allowedTools,...!1===r.includeContent?{}:{content:await t(o,r.maxBytes)}}}(r,e)}}export function createDeepAgentsMiddlewareSkillProvider(e={}){return{name:"deepagents-middleware",async createMiddleware(r){const t=await async function(e){return e.importDeepAgents?e.importDeepAgents():new Function("specifier","return import(specifier)")("deepagents")}(e),i=t.createSkillsMiddleware;if("function"!=typeof i)throw new Error("deepagents does not export createSkillsMiddleware");return i({backend:e.backend??o(t,r.workspace.root),sources:e.sources??n(r)})}}}export function resolveSkillProvider(e){if(!1!==e.skillProvider)return e.skillProvider??createRegistrySkillResolverProvider()}async function t(r,t=1048576){const o=await e(r.path,"utf8");if(Buffer.byteLength(o,"utf8")>t)throw new Error(`Skill ${r.id} exceeds registry resolver size limit of ${t} bytes`);return o}function o(e,r){if("function"!=typeof e.FilesystemBackend)throw new Error("deepagents does not export FilesystemBackend");return new e.FilesystemBackend({rootDir:r})}function n(e){const t=new Set([...(o=e.agent,o?.skills??[]),...i(e)]);var o;const n=new Set;for(const o of t){const t=e.workspace.skills.get(o);t&&n.add(s(r.relative(e.workspace.root,r.dirname(r.dirname(t.path)))))}return[...n].filter(e=>e&&!e.startsWith(".."))}function i(e){return e.workflow.nodes.map(e=>e.use.match(/^skills\.([^./][^.]*)$/u)?.[1]).filter(e=>Boolean(e))}function s(e){return e.split(r.sep).join("/")}
+import{readFile as e}from"node:fs/promises";import r from"node:path";export function createRegistrySkillResolverProvider(e={}){return{name:"registry-resolver",resolve:r=>async function resolveRegistrySkill(e,r){const t=e.workspace.skills.get(e.id);if(!t)throw new Error(`LangGraph skill resolver cannot find skill ${e.id}`);return{id:t.id,path:t.path,...t.description?{description:t.description}:{},allowedTools:t.allowedTools,...!1===r.includeContent?{}:{content:await readSkillContent(t,r.maxBytes)}}}(r,e)}}export function createDeepAgentsMiddlewareSkillProvider(e={}){return{name:"deepagents-middleware",async createMiddleware(r){const t=await async function loadDeepAgentsSkillsModule(e){return e.importDeepAgents?e.importDeepAgents():new Function("specifier","return import(specifier)")("deepagents")}(e),o=t.createSkillsMiddleware;if("function"!=typeof o)throw new Error("deepagents does not export createSkillsMiddleware");return o({backend:e.backend??createDeepAgentsFilesystemBackend(t,r.workspace.root),sources:e.sources??deriveDeepAgentsSkillSources(r)})}}}export function resolveSkillProvider(e){if(!1!==e.skillProvider)return e.skillProvider??createRegistrySkillResolverProvider()}async function readSkillContent(r,t=1048576){const o=await e(r.path,"utf8");if(Buffer.byteLength(o,"utf8")>t)throw new Error(`Skill ${r.id} exceeds registry resolver size limit of ${t} bytes`);return o}function createDeepAgentsFilesystemBackend(e,r){if("function"!=typeof e.FilesystemBackend)throw new Error("deepagents does not export FilesystemBackend");return new e.FilesystemBackend({rootDir:r})}function deriveDeepAgentsSkillSources(e){const t=new Set([...(o=e.agent,o?.skills??[]),...skillIdsFromWorkflow(e)]);var o;const i=new Set;for(const o of t){const t=e.workspace.skills.get(o);t&&i.add(toPosixPath(r.relative(e.workspace.root,r.dirname(r.dirname(t.path)))))}return[...i].filter(e=>e&&!e.startsWith(".."))}function skillIdsFromWorkflow(e){return e.workflow.nodes.map(e=>e.use.match(/^skills\.([^./][^.]*)$/u)?.[1]).filter(e=>Boolean(e))}function toPosixPath(e){return e.split(r.sep).join("/")}

package/packages/cli/dist/src/args.d.ts

@@ -1,17 +1,20 @@
 export type CliArgs = {
     workspaceRoot: string;
-    command: "request" | "start";
+    command: "request" | "start" | "stop";
     workflowRenderId?: string;
     workflowInspectId?: string;
+    workflowRunId?: string;
     agentRenderId?: string;
     agentId?: string;
+    sessionId?: string;
     toolId?: string;
     toolArgs: unknown;
     trace: boolean;
     traceJson: boolean;
+    progress: boolean;
     serveOpenAi: boolean;
-    host: string;
-    port: number;
+    host?: string;
+    port?: number;
     apiKey?: string;
     timeoutMs: number;
     help: boolean;

package/packages/cli/dist/src/args.js

@@ -1 +1 @@
-export function parseArgs(s){let a,i,l,d,w,c,p="request",u=process.cwd(),f=!1,g=!1,h=!1,k=process.env.STABLE_HARNESS_OPENAI_HOST??"127.0.0.1",I=Number(process.env.STABLE_HARNESS_OPENAI_PORT??8642),v=process.env.STABLE_HARNESS_OPENAI_API_KEY,S=Number(process.env.STABLE_HARNESS_CLI_TIMEOUT_MS??3e5),m=!1;const x=[];for(let E=0;E<s.length;E+=1){const R=o(s,E);if(0===E&&"start"===s[E])p="start",h=!0;else if(0===E&&"workflow"===s[E]){const r=e(s,E);a=r.workflowRenderId,i=r.workflowInspectId,E=r.index}else if(0===E&&"agent"===s[E]){const e=r(s,E);l=e.agentRenderId,E=e.index}else"-h"===s[E]||"--help"===s[E]?m=!0:"start"===p&&t(s[E])?h=!0:"-w"===s[E]||"--workspace"===s[E]?(u=R.value??u,E=R.index):"--agent"===s[E]?(d=R.value,E=R.index):"--tool"===s[E]?(w=R.value,E=R.index):"--tool-args-json"===s[E]?(c=n(R.value??"{}"),E=R.index):"--trace"===s[E]?f=!0:"--trace-json"===s[E]?g=!0:"--serve-openai"===s[E]?h=!0:"--host"===s[E]?(k=R.value??k,E=R.index):"--port"===s[E]?(I=Number(R.value??I),E=R.index):"--api-key"===s[E]?(v=R.value,E=R.index):"--timeout-ms"===s[E]?(S=Number(R.value??S),E=R.index):x.push(s[E])}return{workspaceRoot:u,command:p,workflowRenderId:a,workflowInspectId:i,agentRenderId:l,agentId:d,toolId:w,toolArgs:c,trace:f,traceJson:g,serveOpenAi:h,host:k,port:I,apiKey:v,timeoutMs:S,help:m,prompt:x.join(" "),shouldRunRequest:Boolean(w||x.length>0)}}export function helpText(){return["Usage:","  stable-harness -w <workspace> [--agent <id>] [prompt]","  stable-harness workflow render <workflow-id> -w <workspace>","  stable-harness workflow inspect <workflow-id> -w <workspace>","  stable-harness agent render <agent-id> -w <workspace>","  stable-harness start -w <workspace>","","Options:","  -w, --workspace <path>   Workspace root.","  --serve-openai           Legacy alias for start.","  --agent <id>             Select an agent for a request.","  --tool <id>              Invoke an explicit registered tool.","  --tool-args-json <json>  Tool arguments for --tool.","  --trace                  Print trace lines.","  --trace-json             Print trace JSON.","  --timeout-ms <ms>        Request timeout.","  -h, --help               Show this help.",""].join("\n")}function e(e,r){if("render"===e[r+1])return{index:r+2,workflowRenderId:e[r+2],workflowInspectId:void 0};if("inspect"===e[r+1])return{index:r+2,workflowRenderId:void 0,workflowInspectId:e[r+2]};throw new Error("Usage: stable-harness workflow <render|inspect> <workflow-id>")}function r(e,r){if("render"===e[r+1])return{index:r+2,agentRenderId:e[r+2]};throw new Error("Usage: stable-harness agent render <agent-id>")}function o(e,r){return{index:r+1,value:e[r+1]}}function n(e){try{return JSON.parse(e)}catch(e){const r=e instanceof Error?e.message:String(e);throw new Error(`Invalid --tool-args-json value: ${r}`)}}function t(e){return"openai"===e||"openai-compatible"===e}
+export function parseArgs(e){const r=function createDefaultArgs(){return{workspaceRoot:process.cwd(),command:"request",toolArgs:void 0,trace:!1,traceJson:!1,progress:!1,serveOpenAi:!1,host:process.env.STABLE_HARNESS_OPENAI_HOST,port:process.env.STABLE_HARNESS_OPENAI_PORT?Number(process.env.STABLE_HARNESS_OPENAI_PORT):void 0,apiKey:process.env.STABLE_HARNESS_OPENAI_API_KEY,timeoutMs:Number(process.env.STABLE_HARNESS_CLI_TIMEOUT_MS??3e5),help:!1,prompt:"",shouldRunRequest:!1}}(),t=[];for(let o=0;o<e.length;o+=1)o=parseOneArg(e,o,r,t);return{...r,prompt:t.join(" "),shouldRunRequest:Boolean(r.toolId||r.workflowRunId||t.length>0)}}function parseOneArg(e,r,t,o){const n=function readNextArg(e,r){return{index:r+1,value:e[r+1]}}(e,r);if(0===o.length&&function parseTopLevelCommand(e,r,t){return"start"===e[r]?(t.command="start",t.serveOpenAi=!0,!0):"stop"===e[r]?(t.command="stop",!0):"workflow"!==e[r]||"render"!==e[r+1]&&"inspect"!==e[r+1]?"agent"===e[r]&&"render"===e[r+1]&&(Object.assign(t,function parseAgentCommand(e,r){if("render"===e[r+1])return{index:r+2,agentRenderId:e[r+2]};throw new Error("Usage: stable-harness agent render <agent-id>")}(e,r)),!0):(Object.assign(t,function parseWorkflowCommand(e,r){if("render"===e[r+1])return{index:r+2,workflowRenderId:e[r+2],workflowInspectId:void 0};if("inspect"===e[r+1])return{index:r+2,workflowRenderId:void 0,workflowInspectId:e[r+2]};throw new Error("Usage: stable-harness workflow <render|inspect> <workflow-id>")}(e,r)),!0)}(e,r,t))return function stateIndex(e,r){return"workflow"===e[r]||"agent"===e[r]?r+2:r}(e,r);if("-h"===e[r]||"--help"===e[r])t.help=!0;else if("start"===t.command&&function isProtocolName(e){return"openai"===e||"openai-compatible"===e}(e[r]))t.serveOpenAi=!0;else{if("-w"===e[r]||"--workspace"===e[r])return setString(n,t,"workspaceRoot");if("--agent"===e[r])return setString(n,t,"agentId");if("--workflow"===e[r])return setString(n,t,"workflowRunId");if("--session-id"===e[r])return setString(n,t,"sessionId");if("--tool"===e[r])return setString(n,t,"toolId");if("--tool-args-json"===e[r])return t.toolArgs=function parseJsonArg(e){try{return JSON.parse(e)}catch(e){const r=e instanceof Error?e.message:String(e);throw new Error(`Invalid --tool-args-json value: ${r}`)}}(n.value??"{}"),n.index;if("--trace"===e[r])t.trace=!0;else if("--trace-json"===e[r])t.traceJson=!0;else if("--progress"===e[r])t.progress=!0;else if("--serve-openai"===e[r])t.serveOpenAi=!0;else{if("--host"===e[r])return setString(n,t,"host");if("--port"===e[r])return t.port=Number(n.value??t.port),n.index;if("--api-key"===e[r])return setString(n,t,"apiKey");if("--timeout-ms"===e[r])return t.timeoutMs=Number(n.value??t.timeoutMs),n.index;o.push(e[r])}}return r}function setString(e,r,t){return"string"==typeof e.value&&Object.assign(r,{[t]:e.value}),e.index}export function helpText(){return["Usage:","  stable-harness -w <workspace> [--agent <id>] [prompt]","  stable-harness workflow render <workflow-id> -w <workspace>","  stable-harness workflow inspect <workflow-id> -w <workspace>","  stable-harness agent render <agent-id> -w <workspace>","  stable-harness start -w <workspace>","  stable-harness stop -w <workspace>","","Options:","  -w, --workspace <path>   Workspace root.","  --serve-openai           Legacy alias for start.","  --agent <id>             Select an agent for a request.","  --workflow <id>          Run a configured workflow.","  --session-id <id>        Attach the request to an existing runtime session.","  --tool <id>              Invoke an explicit registered tool.","  --tool-args-json <json>  Tool arguments for --tool.","  --trace                  Print trace lines.","  --trace-json             Print trace JSON.","  --progress               Legacy alias; CLI events are controlled by runtime.cli.events.","  --timeout-ms <ms>        Request timeout.","  -h, --help               Show this help.",""].join("\n")}

package/packages/cli/dist/src/cli.js

@@ -1,2 +1,2 @@
 #!/usr/bin/env node
-import{realpathSync as e}from"node:fs";import{fileURLToPath as t}from"node:url";import{createDeepAgentsAdapter as r}from"@stable-harness/adapter-deepagents";import{createStableHarnessRuntime as o}from"@stable-harness/core";import{projectEvent as s,projectRuntimeTrace as a}from"@stable-harness/core";import{createModuleToolGateway as n}from"@stable-harness/tool-gateway";import{loadWorkspaceFromYaml as i}from"@stable-harness/workspace-yaml";import{helpText as c,parseArgs as p}from"./args.js";import{formatDetail as l,inspectWorkflow as d,renderAgent as u,renderWorkflow as m,workspaceStatus as f}from"./output.js";import{serveProtocol as w}from"./server.js";export async function runCli(e=process.argv.slice(2)){const t=p(e);if(t.help)return void process.stdout.write(c());const g=setTimeout(()=>{process.stderr.write(`stable-harness request timed out after ${t.timeoutMs}ms\n`),process.exit(124)},t.timeoutMs),I=t.workspaceRoot;try{const e=await i(I);if(t.workflowRenderId)return void process.stdout.write(m(e,t.workflowRenderId));if(t.workflowInspectId)return void process.stdout.write(d(e,t.workflowInspectId));if(t.agentRenderId)return void process.stdout.write(u(e,t.agentRenderId));const c=await n({tools:e.tools.values()}),p=o({workspace:e,toolGateway:c,adapters:[r()]});if(t.serveOpenAi)return clearTimeout(g),void await w(p,t);if(!t.shouldRunRequest)return void process.stdout.write(f(e,I));t.trace&&p.subscribe(e=>{const t=s(e);t&&process.stdout.write(`trace:${t.agentId}:${t.label}${l(t.detail)}\n`)});const v=await p.request({input:t.prompt,agentId:t.agentId,toolCall:t.toolId?{toolId:t.toolId,args:t.toolArgs}:void 0});if(t.trace||t.traceJson){const e=p.getRun(v.requestId),r=e?a(e):[];t.traceJson&&process.stdout.write(`${JSON.stringify({trace:r})}\n`)}process.stdout.write(`${v.output}\n`)}finally{clearTimeout(g)}}(function(){const r=process.argv[1];return Boolean(r)&&e(t(import.meta.url))===e(r)})()&&runCli().catch(e=>{process.stderr.write(`${e instanceof Error?e.message:String(e)}\n`),process.exitCode=1});
+import{realpathSync as e}from"node:fs";import{fileURLToPath as t}from"node:url";import{createDeepAgentsAdapter as r}from"@stable-harness/adapter-deepagents";import{createLangGraphWorkflowAdapter as o}from"@stable-harness/adapter-langgraph";import{createStableHarnessRuntime as s}from"@stable-harness/core";import{projectEvent as a,projectRuntimeTrace as i}from"@stable-harness/core";import{createModuleToolGateway as n}from"@stable-harness/tool-gateway";import{loadWorkspaceFromYaml as u}from"@stable-harness/workspace-yaml";import{helpText as l,parseArgs as d}from"./args.js";import{formatCliRuntimeEvent as p,readCliEventViewConfig as c,shouldEnableCliProgressNarration as w}from"./event-view.js";import{ensureCliMemoryServices as f}from"./memory/lifecycle.js";import{createCliMemoryProviders as m}from"./memory/providers.js";import{formatDetail as g,inspectWorkflow as I,renderAgent as v,renderWorkflow as y,workspaceStatus as k}from"./output.js";import{serveProtocol as h,stopProtocol as b}from"./server.js";export async function runCli(e=process.argv.slice(2)){const t=d(e);if(t.help)return void process.stdout.write(l());const o=setTimeout(()=>{process.stderr.write(`stable-harness request timed out after ${t.timeoutMs}ms\n`),process.exit(124)},t.timeoutMs),q=t.workspaceRoot;try{const e=await u(q);if(t.workflowRenderId)return void process.stdout.write(y(e,t.workflowRenderId));if(t.workflowInspectId)return void process.stdout.write(I(e,t.workflowInspectId));if(t.agentRenderId)return void process.stdout.write(v(e,t.agentRenderId));if("stop"===t.command)return clearTimeout(o),void await b(e,t);const l=await n({tools:e.tools.values(),options:{betterCall:{mode:"repair"}}});await f(e);const d=m(e),R=c(e.runtime);let C;if(C=s({workspace:e,toolGateway:l,memoryProviders:d,adapters:[r()],workflowAdapters:[createCliWorkflowAdapter(l,()=>C)],progressNarration:w(R,e.runtime)?{enabled:!0,style:"cli"}:void 0}),t.serveOpenAi)return clearTimeout(o),void await h(C,t);if(!t.shouldRunRequest)return void process.stdout.write(k(e,q));t.trace&&C.subscribe(e=>{const t=a(e);t&&process.stdout.write(`trace:${t.agentId}:${t.label}${g(t.detail)}\n`)}),C.subscribe(e=>{const t=p(e,R);t&&process.stdout.write(`${t}\n`)});const $=await C.request({input:t.prompt,agentId:t.agentId,sessionId:t.sessionId,toolCall:t.toolId?{toolId:t.toolId,args:t.toolArgs}:void 0,workflow:t.workflowRunId?{workflowId:t.workflowRunId,input:t.prompt}:void 0});if(t.trace||t.traceJson){const e=C.getRun($.requestId),r=e?i(e):[];t.traceJson&&process.stdout.write(`${JSON.stringify({trace:r})}\n`)}process.stdout.write(`${$.output}\n`)}finally{clearTimeout(o)}}function createCliWorkflowAdapter(e,t){return o({nodeResolvers:{tools:async({id:t,node:r,request:o,requestId:s,sessionId:a,state:i,workspace:n})=>{return(await e.invoke({toolId:t,args:(u=r.config,l=o.input,d=i.outputs,!0===u?.inputFromState?{...u,requestInput:l,outputs:d}:u&&"requiredInput"in u?u.requiredInput:u&&("args"in u||"cwd"in u||"timeoutMs"in u)?u:"object"==typeof l&&null!==l?l:{}),context:{workspaceRoot:n.root,requestId:s,sessionId:a,agentId:`workflow:${r.id}`}})).output;var u,l,d},agents:async({id:e,node:r,request:o,sessionId:s,state:a})=>{var i,n,u,l;return(await t().request({input:(i=e,n=o.input,u=a.outputs,l=r.config,[`Workflow node agents.${i}: synthesize the workflow evidence into the requested final output.`,`Original request: ${"string"==typeof n?n:JSON.stringify(n)}`,"Requirements:","- Produce the final answer now; do not ask follow-up questions.","- Match the original request language unless workflow config explicitly says otherwise.","- Use only the workflow outputs as evidence; call out uncertainty directly.",...l?[`Workflow node config: ${JSON.stringify(l)}`]:[],"Prior workflow outputs:",JSON.stringify(u)].join("\n")),agentId:e,sessionId:s,metadata:o.metadata})).output}}})}(function isCliEntrypoint(){const r=process.argv[1];if(!r)return!1;try{return e(t(import.meta.url))===e(r)}catch{return!1}})()&&runCli().catch(e=>{process.stderr.write(`${e instanceof Error?e.message:String(e)}\n`),process.exitCode=1});

package/packages/cli/dist/src/event-view.d.ts

@@ -0,0 +1,9 @@
+import type { RuntimeEvent } from "@stable-harness/core";
+export type CliEventViewConfig = {
+    enabled: boolean;
+    include: string[];
+    exclude: string[];
+};
+export declare function readCliEventViewConfig(runtimePolicy: Record<string, unknown>): CliEventViewConfig;
+export declare function shouldEnableCliProgressNarration(config: CliEventViewConfig, runtimePolicy: Record<string, unknown>): boolean;
+export declare function formatCliRuntimeEvent(event: RuntimeEvent, config: CliEventViewConfig): string | undefined;

package/packages/cli/dist/src/event-view.js

@@ -0,0 +1 @@
+export function readCliEventViewConfig(e){const t=readRecord(e.cli),r=readRecord(t?.events);return{enabled:readBoolean(r?.enabled)??!0,include:readStringList(r?.include)??["runtime.progress.narration"],exclude:readStringList(r?.exclude)??[]}}export function shouldEnableCliProgressNarration(e,t){if(!e.enabled)return!1;const r=readRecord(readRecord(t.progress)?.narration);return!1!==readBoolean(r?.enabled)&&e.include.some(e=>matchesEventPattern("runtime.progress.narration",e))}export function formatCliRuntimeEvent(e,t){if(!t.enabled||!function isIncluded(e,t){const r=function eventKeys(e){return"runtime.adapter.event"===e.type&&isRecord(e.event)&&"string"==typeof e.event.phase?[e.type,e.event.phase]:[e.type]}(e),n=t.include.some(e=>r.some(t=>matchesEventPattern(t,e))),i=t.exclude.some(e=>r.some(t=>matchesEventPattern(t,e)));return n&&!i}(e,t))return;const r=function projectCliEventView(e){return"runtime.progress.narration"===e.type?{group:"Progress",title:e.message}:e.type.startsWith("runtime.request.")?{group:"Run",title:e.type}:"runtime.tool.direct.started"===e.type||"runtime.tool.direct.completed"===e.type?{group:"Tool",title:e.type,detail:e.toolId}:"runtime.workflow.started"===e.type||"runtime.workflow.completed"===e.type?{group:"Workflow",title:e.type,detail:e.workflowId}:e.type.startsWith("runtime.memory.")?{group:"Memory",title:e.type,detail:memoryDetail(e)}:"runtime.skill.candidate.created"===e.type?{group:"Skill",title:e.type,detail:e.name}:"runtime.artifact.created"===e.type?{group:"Artifact",title:e.type}:"runtime.execution.contract.failed"===e.type?{group:"Contract",title:e.type,detail:e.reason}:"runtime.adapter.event"===e.type?function adapterEventView(e){if(!isRecord(e))return{group:"Adapter",title:"runtime.adapter.event"};const t="string"==typeof e.phase?e.phase:"runtime.adapter.event";return t.startsWith("agent.tool.")?{group:"Agent Tool",title:t,detail:readString(e.toolId)}:t.startsWith("agent.output.")?{group:"Agent Output",title:t,detail:readString(e.text)}:t.startsWith("agent.")?{group:"Agent",title:t,detail:readString(e.adapter)}:{group:"Adapter",title:t,detail:readString(e.adapter)}}(e.event):{group:"event",title:e.type}}(e);return`[${r.group}] ${e.agentId} | ${r.title}${r.detail?` | ${r.detail}`:""}`}function matchesEventPattern(e,t){return"*"===t||(t.endsWith(".*")?e===t.slice(0,-2)||e.startsWith(t.slice(0,-1)):e===t)}function memoryDetail(e){return"runtime.memory.recall.completed"===e.type?`${e.recordIds.length} records`:"provider"in e?e.provider:"target"in e?e.target:void 0}function readRecord(e){return isRecord(e)?e:void 0}function isRecord(e){return"object"==typeof e&&null!==e&&!Array.isArray(e)}function readBoolean(e){return"boolean"==typeof e?e:void 0}function readStringList(e){return Array.isArray(e)?e.filter(e=>"string"==typeof e&&e.trim().length>0):void 0}function readString(e){return"string"==typeof e&&e.trim()?e:void 0}

package/packages/cli/dist/src/index.d.ts

@@ -1 +1,4 @@
 export { runCli } from "./cli.js";
+export { parseArgs } from "./args.js";
+export { ensureCliMemoryServices } from "./memory/lifecycle.js";
+export { createCliMemoryProviders } from "./memory/providers.js";

package/packages/cli/dist/src/index.js

@@ -1 +1 @@
-export{runCli}from"./cli.js";
+export{runCli}from"./cli.js";export{parseArgs}from"./args.js";export{ensureCliMemoryServices}from"./memory/lifecycle.js";export{createCliMemoryProviders}from"./memory/providers.js";

package/packages/cli/dist/src/langgraph-env.d.ts

@@ -0,0 +1,5 @@
+export type LangGraphEnvConfig = {
+    env?: unknown;
+    envFile?: unknown;
+};
+export declare function applyLangGraphEnvironment(workspaceRoot: string, config?: LangGraphEnvConfig): Promise<void>;

package/packages/cli/dist/src/langgraph-env.js

@@ -0,0 +1 @@
+import{readFile as n}from"node:fs/promises";import t from"node:path";export async function applyLangGraphEnvironment(e,r={}){const o=function resolveEnvFile(n,e){if(!1===e.envFile)return;const r="string"==typeof e.env?e.env:e.envFile,o="string"==typeof r&&r.trim()?r.trim():".env";return t.isAbsolute(o)?o:t.join(n,o)}(e,r);!function applyEnv(n){for(const[t,e]of Object.entries(n))process.env[t]||(process.env[t]=e)}({...o?await async function readEnvFile(t){try{return function parseEnv(n){const t={};for(const e of n.split(/\r?\n/u)){const n=e.trim();if(!n||n.startsWith("#"))continue;const r=n.match(/^(?:export\s+)?([A-Za-z_][A-Za-z0-9_]*)\s*=\s*(.*)$/u);r&&(t[r[1]]=unquoteEnvValue(r[2]??""))}return t}(await n(t,"utf8"))}catch(n){if(function isMissingFileError(n){return"object"==typeof n&&null!==n&&"code"in n&&"ENOENT"===n.code}(n))return{};throw n}}(o):{},...function readInlineEnv(n){return"object"!=typeof n||null===n||Array.isArray(n)?{}:Object.fromEntries(Object.entries(n).flatMap(([n,t])=>{if(!/^[A-Za-z_][A-Za-z0-9_]*$/u.test(n))return[];const e=function resolveEnvValue(n){if("string"==typeof n){const t=n.match(/^\$\{env:([A-Za-z_][A-Za-z0-9_]*)(?::-(.*))?\}$/u);return t?process.env[t[1]]??t[2]??"":n}if("number"==typeof n||"boolean"==typeof n)return String(n)}(t);return void 0===e?[]:[[n,e]]}))}(r.env)})}function unquoteEnvValue(n){const t=n.trim();if(t.startsWith('"')&&t.endsWith('"')||t.startsWith("'")&&t.endsWith("'"))return t.slice(1,-1);const e=t.match(/^(.*?)\s+#/u);return e?e[1].trim():t}

package/packages/cli/dist/src/langgraph-official.d.ts

@@ -4,6 +4,8 @@ export type LangGraphOfficialConfig = {
     port: number;
     nWorkers: number;
     exposeAgents?: string[];
+    env?: unknown;
+    envFile?: unknown;
 };
 export declare function startOfficialLangGraphServer(runtime: ReturnType<typeof createStableHarnessRuntime>, config: LangGraphOfficialConfig): Promise<{
     url: string;

package/packages/cli/dist/src/langgraph-official.js

@@ -1 +1 @@
-import{mkdir as n,writeFile as e}from"node:fs/promises";import{createRequire as t}from"node:module";import s from"node:path";import{fileURLToPath as a,pathToFileURL as r}from"node:url";import{startServer as o}from"@langchain/langgraph-api/server";export async function startOfficialLangGraphServer(t,c){const u=t.inspect().workspaceRoot,l=function(n,e){const t=new Set(n.inspect().agents),s=e&&e.length>0?e:[...t].sort();for(const n of s)if(!t.has(n))throw new Error(`LangGraph protocol references unknown agent: ${n}`);return s.map((n,e)=>({id:n,exportName:`agent_${e}_${g(n)}`}))}(t,c.exposeAgents),m=await async function(t,o){const g=s.join(t,".stable-harness","langgraph"),c=s.join(g,"bridge.mjs");return await n(g,{recursive:!0}),await e(c,function(n,e){const t=r(s.join(s.resolve(s.dirname(a(import.meta.url)),"../../../.."),"dist","index.js")).toString(),o=r(i.resolve("@langchain/langgraph")).toString(),g=e.map(n=>`export const ${n.exportName} = createBridgeGraph(${JSON.stringify(n.id)});`).join("\n");return`import langgraph from ${JSON.stringify(o)};\nimport { createStableHarnessRuntime } from ${JSON.stringify(t)};\n\nconst { END, MessagesAnnotation, START, StateGraph } = langgraph;\nconst workspaceRoot = ${JSON.stringify(n)};\nlet runtimePromise;\n\nfunction createBridgeGraph(agentId) {\n  const graph = new StateGraph(MessagesAnnotation)\n    .addNode("stable_harness", async (state, config) => {\n      const runtime = await getRuntime();\n      const result = await runtime.request({\n        input: lastMessageText(state.messages),\n        agentId,\n        sessionId: readConfigString(config, "thread_id"),\n        requestId: readConfigString(config, "run_id"),\n        metadata: {\n          protocol: "langgraph",\n          openaiMessages: normalizeMessages(state.messages),\n          executionContract: { enabled: false },\n          toolCallRecovery: { onFailure: "message" },\n        },\n      });\n      return { messages: [{ type: "ai", content: result.output }] };\n    })\n    .addEdge(START, "stable_harness")\n    .addEdge("stable_harness", END);\n  return graph.compile();\n}\n\nfunction getRuntime() {\n  runtimePromise ??= createStableHarnessRuntime(workspaceRoot);\n  return runtimePromise;\n}\n\nfunction lastMessageText(messages) {\n  const message = Array.isArray(messages) ? messages.at(-1) : undefined;\n  const content = message?.content;\n  if (typeof content === "string") return content;\n  return content == null ? "" : JSON.stringify(content);\n}\n\nfunction normalizeMessages(messages) {\n  if (!Array.isArray(messages)) return [];\n  return messages.flatMap((message) => {\n    const role = messageRole(message);\n    const content = messageContent(message);\n    return role && content ? [{ role, content }] : [];\n  });\n}\n\nfunction messageRole(message) {\n  const value = message?.role ?? message?.type;\n  if (value === "human") return "user";\n  if (value === "ai") return "assistant";\n  return value === "system" || value === "user" || value === "assistant" || value === "tool"\n    ? value\n    : undefined;\n}\n\nfunction messageContent(message) {\n  const content = message?.content;\n  if (typeof content === "string") return content;\n  return content == null ? "" : JSON.stringify(content);\n}\n\nfunction readConfigString(config, key) {\n  const value = config?.configurable?.[key];\n  return typeof value === "string" && value ? value : undefined;\n}\n\n${g}\n`}(t,o)),{file:c,relativePath:`./${s.relative(t,c).split(s.sep).join("/")}`}}(u,l),p=Object.fromEntries(l.map(n=>[n.id,`${m.relativePath}:${n.exportName}`])),f=await o({host:c.host,port:c.port,nWorkers:c.nWorkers,cwd:u,graphs:p});return{url:`http://${f.host}`,cleanup:f.cleanup}}const i=t(import.meta.url);function g(n){const e=n.replace(/[^A-Za-z0-9_$]/gu,"_");return/^[A-Za-z_$]/u.test(e)?e:`_${e}`}
+import{mkdir as e,writeFile as n}from"node:fs/promises";import{createRequire as t}from"node:module";import s from"node:path";import{fileURLToPath as r,pathToFileURL as a}from"node:url";import{startServer as o}from"@langchain/langgraph-api/server";import{applyLangGraphEnvironment as i}from"./langgraph-env.js";export async function startOfficialLangGraphServer(t,c){const l=t.inspect().workspaceRoot,g=function exposedAgents(e,n){const t=new Set(e.inspect().agents),s=n&&n.length>0?n:[...t].sort();for(const e of s)if(!t.has(e))throw new Error(`LangGraph protocol references unknown agent: ${e}`);return s.map((e,n)=>({id:e,exportName:`agent_${n}_${safeIdentifier(e)}`}))}(t,c.exposeAgents),p=await async function writeBridgeModule(t,o){const i=s.join(t,".stable-harness","langgraph"),c=s.join(i,"bridge.mjs");return await e(i,{recursive:!0}),await n(c,function bridgeSource(e,n){const t=a(s.join(function packageRoot(){return s.resolve(s.dirname(r(import.meta.url)),"../../../..")}(),"dist","index.js")).toString(),o=a(u.resolve("@langchain/langgraph")).toString(),i=n.map(e=>`export const ${e.exportName} = createBridgeGraph(${JSON.stringify(e.id)});`).join("\n");return[(c={workspaceRoot:e,stableHarnessUrl:t,langGraphUrl:o},`import langgraph from ${JSON.stringify(c.langGraphUrl)};\nimport { containsRecoverableResultOutput, createStableHarnessRuntime, loadWorkspaceFromYaml } from ${JSON.stringify(c.stableHarnessUrl)};\n\nconst { END, MessagesZodState, START, StateGraph } = langgraph;\nconst workspaceRoot = ${JSON.stringify(c.workspaceRoot)};\nlet runtimePromise;\nlet workspacePromise;\n`),'function createBridgeGraph(agentId) {\n  const graph = new StateGraph(MessagesZodState)\n    .addNode("stable_harness", async (state, config) => {\n      const runtime = await getRuntime();\n      const protocolMessages = normalizeMessages(state.messages);\n      const result = await runtime.request({\n        input: currentTurnInput(protocolMessages),\n        agentId,\n        sessionId: readConfigString(config, "thread_id"),\n        requestId: readConfigString(config, "run_id"),\n        metadata: {\n          protocol: "langgraph",\n          openaiMessages: contextualMessages(protocolMessages),\n        },\n      });\n      const content = protocolOutput(runtime, result);\n      return { messages: [{ type: "ai", content }] };\n    })\n    .addEdge(START, "stable_harness")\n    .addEdge("stable_harness", END);\n  const compiled = graph.compile();\n  compiled.getGraphAsync = async () => createInspectionGraph(agentId);\n  return compiled;\n}\n\nfunction getRuntime() {\n  runtimePromise ??= createStableHarnessRuntime(workspaceRoot);\n  return runtimePromise;\n}\n','\nfunction currentTurnInput(messages) {\n  const message = lastUserMessage(messages) ?? messages.at(-1);\n  const content = message?.content ?? "";\n  const context = recentContext(messages.slice(0, -1));\n  return context ? [\n    "Recent conversation context:",\n    context,\n    "",\n    "Current user request:",\n    content,\n  ].join("\\n") : content;\n}\n\nfunction contextualMessages(messages) {\n  const lastUserIndex = messages.findLastIndex((message) => message.role === "user");\n  if (lastUserIndex < 0) return messages;\n  const context = recentContext(messages.slice(0, lastUserIndex));\n  if (!context) return messages;\n  return messages.map((message, index) => index === lastUserIndex ? {\n    ...message,\n    content: [\n      "Recent conversation context:",\n      context,\n      "",\n      "Current user request:",\n      message.content,\n    ].join("\\n"),\n  } : message);\n}\n\nfunction lastUserMessage(messages) {\n  return [...messages].reverse().find((entry) => entry.role === "user");\n}\n\nfunction recentContext(messages) {\n  return messages\n    .filter((message) => message.content.trim())\n    .slice(-6)\n    .map((message) => `${message.role}: ${compactText(message.content)}`)\n    .join("\\n\\n");\n}\n\nfunction compactText(value) {\n  const normalized = value.replace(/\\s+/gu, " ").trim();\n  return normalized.length > 4000 ? `${normalized.slice(0, 4000)}...` : normalized;\n}\n\nfunction normalizeMessages(messages) {\n  if (!Array.isArray(messages)) return [];\n  return messages.flatMap((message) => {\n    const role = messageRole(message);\n    const content = messageContent(message);\n    return role && content ? [{ role, content }] : [];\n  });\n}\n\nfunction messageRole(message) {\n  const value = message?.role ?? message?.type;\n  if (value === "human") return "user";\n  if (value === "ai") return "assistant";\n  return value === "system" || value === "user" || value === "assistant" || value === "tool"\n    ? value\n    : undefined;\n}\n\nfunction messageContent(message) {\n  const content = message?.content;\n  if (typeof content === "string") return content;\n  if (Array.isArray(content)) {\n    return content.map((part) => {\n      if (typeof part === "string") return part;\n      if (typeof part?.text === "string") return part.text;\n      if (typeof part?.content === "string") return part.content;\n      return "";\n    }).filter(Boolean).join("\\n");\n  }\n  return content == null ? "" : JSON.stringify(content);\n}\n\nfunction readConfigString(config, key) {\n  const value = config?.configurable?.[key];\n  return typeof value === "string" && value ? value : undefined;\n}\n','function protocolOutput(runtime, result) {\n  if (!containsRecoverableResultOutput(result.output, runtime.getRuntimePolicy?.() ?? {})) {\n    return result.output;\n  }\n  return traceFallbackOutput(runtime.inspectRequest(result.requestId)) ?? [\n    "The model returned recoverable tool-call or tool-error text instead of a final answer.",\n    "stable-harness could not find a completed tool result to project as the Studio response.",\n  ].join(" ");\n}\n\nfunction traceFallbackOutput(inspection) {\n  const timeline = Array.isArray(inspection?.timeline) ? inspection.timeline : [];\n  for (const item of [...timeline].reverse()) {\n    const event = item?.event;\n    const adapterEvent = event?.type === "runtime.adapter.event" ? event.event : undefined;\n    const text = extractText(adapterEvent?.output);\n    if (isUsableOutput(text)) return text;\n  }\n  return undefined;\n}\n\nfunction extractText(value) {\n  if (typeof value === "string") {\n    const parsed = parseJson(value);\n    return parsed === undefined ? value : extractText(parsed);\n  }\n  if (!value || typeof value !== "object") return undefined;\n  if (typeof value.content === "string") return value.content;\n  if (typeof value.text === "string") return value.text;\n  if (typeof value.output === "string") return extractText(value.output);\n  if (typeof value.structuredResponse === "string") return value.structuredResponse;\n  const messages = Array.isArray(value.messages) ? value.messages : Array.isArray(value.update?.messages) ? value.update.messages : [];\n  for (const message of [...messages].reverse()) {\n    const text = extractText(message?.kwargs ?? message);\n    if (text) return text;\n  }\n  return undefined;\n}\n\nfunction parseJson(value) {\n  try {\n    return JSON.parse(value);\n  } catch {\n    return undefined;\n  }\n}\n\nfunction isUsableOutput(value) {\n  return typeof value === "string"\n    && value.trim().length > 0\n    && !containsRecoverableResultOutput(value, { recovery: { toolCall: { enabled: true } } });\n}\n\n','async function createInspectionGraph(agentId) {\n  const workspace = await getWorkspace();\n  const agent = workspace.agents.get(agentId);\n  const snapshot = agent ? {\n    tools: agent.tools,\n    subagents: agent.subagents,\n    skills: agent.skills ?? [],\n  } : { tools: [], subagents: [], skills: [] };\n  return {\n    toJSON() {\n      return inventoryGraph(agentId, snapshot);\n    },\n  };\n}\n\nfunction getWorkspace() {\n  workspacePromise ??= loadWorkspaceFromYaml(workspaceRoot);\n  return workspacePromise;\n}\n\nfunction inventoryGraph(agentId, snapshot) {\n  const nodes = [\n    schemaNode("__start__"),\n    runnableNode(agentId, "stable-harness agent"),\n    ...snapshot.subagents.map((id) => runnableNode("agent_" + id, "agent:" + id)),\n    ...snapshot.tools.map((id) => runnableNode("tool_" + id, "tool:" + id)),\n    ...snapshot.skills.map((id) => runnableNode("skill_" + id, "skill:" + id)),\n    schemaNode("__end__"),\n  ];\n  const edges = [\n    edge("__start__", agentId, false),\n    ...snapshot.subagents.map((id) => edge(agentId, "agent_" + id, true)),\n    ...snapshot.tools.map((id) => edge(agentId, "tool_" + id, true)),\n    ...snapshot.skills.map((id) => edge(agentId, "skill_" + id, true)),\n    edge(agentId, "__end__", true),\n  ];\n  return { nodes, edges };\n}\n\nfunction schemaNode(id) {\n  return {\n    id,\n    type: "schema",\n    data: { "$schema": "https://json-schema.org/draft/2020-12/schema" },\n  };\n}\n\nfunction runnableNode(id, label) {\n  return {\n    id,\n    type: "runnable",\n    data: {\n      id: ["stable-harness", label],\n      name: label,\n    },\n  };\n}\n\nfunction edge(source, target, conditional) {\n  return { source, target, conditional };\n}\n',i,""].join("\n");var c}(t,o)),{file:c,relativePath:`./${s.relative(t,c).split(s.sep).join("/")}`}}(l,g);await i(l,c);const m=Object.fromEntries(g.map(e=>[e.id,`${p.relativePath}:${e.exportName}`])),d=await o({host:c.host,port:c.port,nWorkers:c.nWorkers,cwd:l,graphs:m});return{url:`http://${d.host}`,cleanup:d.cleanup}}const u=t(import.meta.url);function safeIdentifier(e){const n=e.replace(/[^A-Za-z0-9_$]/gu,"_");return/^[A-Za-z_$]/u.test(n)?n:`_${n}`}

package/packages/cli/dist/src/memory/lifecycle.d.ts

@@ -0,0 +1,2 @@
+import type { CompiledWorkspace } from "@stable-harness/core";
+export declare function ensureCliMemoryServices(workspace: CompiledWorkspace): Promise<void>;

package/packages/cli/dist/src/memory/lifecycle.js

@@ -0,0 +1 @@
+import{spawn as e}from"node:child_process";import{existsSync as r}from"node:fs";import t from"node:path";import{fileURLToPath as n}from"node:url";export async function ensureCliMemoryServices(r){const t=function readLangMemServiceConfig(e){const r=readRecord(e.runtime.memory?.LangMem)??readRecord(e.runtime.memory?.langmem);if(!function shouldAutoStart(e,r){return!1!==(e.runtime.memory??{}).enabled&&!1!==r?.enabled&&(!1!==r?.read||!1!==r?.write)&&[...e.memories.values()].some(e=>e.enabled&&"langmem"===e.provider)}(e,r))return;const t=readString(r?.baseUrl)??readString(r?.url)??process.env.STABLE_HARNESS_LANGMEM_URL;var n;return t?{baseUrl:t,autoStart:!1!==r?.autoStart,command:readString(r?.command)??"python3",args:(n=r?.args,(Array.isArray(n)?n.filter(e=>"string"==typeof e&&e.trim().length>0):void 0)??["-m","stable_harness_langmem_service"]),env:{...defaultLangMemEnv(e,t),...readStringRecord(r?.env)}}:void 0}(r);if(!t||!t.autoStart||!function isLocalBaseUrl(e){const r=new URL(e);return["localhost","127.0.0.1","::1"].includes(r.hostname)}(t.baseUrl)||await isHealthy(t.baseUrl))return;const n=e(t.command,t.args,{cwd:r.root,detached:!0,env:{...process.env,...t.env},stdio:"ignore"});n.unref(),await async function waitForStartedService(e,r){await Promise.race([waitForHealth(r.baseUrl),new Promise((r,t)=>e.once("error",t)),new Promise((t,n)=>{e.once("exit",(e,t)=>{n(new Error(`LangMem service exited before becoming healthy: ${r.command} code=${e??"null"} signal=${t??"null"}`))})})])}(n,t)}function defaultLangMemEnv(e,o){const a=new URL(o),i=readString(e.runtime.dataRoot)??".stable-harness",s=t.resolve(function packageRoot(){return t.resolve(t.dirname(n(import.meta.url)),"../../../../..")}(),"services/langmem-python/src");return{HOST:"localhost"===a.hostname?"127.0.0.1":a.hostname,PORT:a.port||("https:"===a.protocol?"443":"80"),LANGMEM_SQLITE_PATH:t.join(t.resolve(e.root,i),"memory/langmem/langmem.sqlite"),...r(s)?{PYTHONPATH:mergePythonPath(s)}:{}}}async function waitForHealth(e){for(let r=0;r<60;r+=1){if(await isHealthy(e))return;await new Promise(e=>setTimeout(e,500))}throw new Error(`LangMem service did not become healthy at ${e}`)}async function isHealthy(e){try{const r=await fetch(`${e.replace(/\/+$/u,"")}/health`,{signal:AbortSignal.timeout(1e3)}),t=await r.json();return r.ok&&!0===t.ok}catch{return!1}}function mergePythonPath(e){return process.env.PYTHONPATH?`${e}${t.delimiter}${process.env.PYTHONPATH}`:e}function readRecord(e){return"object"!=typeof e||null===e||Array.isArray(e)?void 0:e}function readString(e){return"string"==typeof e&&e.trim()?e.trim():void 0}function readStringRecord(e){const r=readRecord(e);return Object.fromEntries(Object.entries(r??{}).filter(e=>"string"==typeof e[1]))}

package/packages/cli/dist/src/memory/providers.d.ts

@@ -0,0 +1,3 @@
+import type { CompiledWorkspace } from "@stable-harness/core";
+import { type MemoryProvider } from "@stable-harness/memory";
+export declare function createCliMemoryProviders(workspace: CompiledWorkspace): MemoryProvider[];

package/packages/cli/dist/src/memory/providers.js

@@ -0,0 +1 @@
+import{createLangMemServiceProvider as e}from"@stable-harness/memory";export function createCliMemoryProviders(r){const o=readRecord(r.runtime.memory?.LangMem)??readRecord(r.runtime.memory?.langmem);if(!function shouldEnableLangMemProvider(e,r){return!1!==(e.runtime.memory??{}).enabled&&!1!==r?.enabled&&(!1!==r?.read||!1!==r?.write)&&[...e.memories.values()].some(e=>e.enabled&&"langmem"===e.provider)}(r,o))return[];const d=readString(o?.baseUrl)??readString(o?.url)??process.env.STABLE_HARNESS_LANGMEM_URL;return d?[e({baseUrl:d,timeoutMs:(n=o?.timeoutMs,("number"==typeof n&&Number.isFinite(n)?n:void 0)??readEnvNumber("STABLE_HARNESS_LANGMEM_TIMEOUT_MS")),config:readProviderConfig(o)})]:[];var n}function readProviderConfig(e){return{provider:"langmem-service",...readRecord(e?.mode)?{mode:readRecord(e?.mode)}:{},...readRecord(e?.types)?{types:readRecord(e?.types)}:{},...readRecord(e?.approval)?{approval:readRecord(e?.approval)}:{},...readRecord(e?.defaults)?{defaults:readRecord(e?.defaults)}:{}}}function readRecord(e){return"object"!=typeof e||null===e||Array.isArray(e)?void 0:e}function readString(e){return"string"==typeof e&&e.trim()?e.trim():void 0}function readEnvNumber(e){const r=process.env[e];return r?Number(r):void 0}

package/packages/cli/dist/src/output.js

@@ -1 +1 @@
-import{compileWorkflowPlan as r,renderAgentMermaid as o,renderWorkflowMermaid as e}from"@stable-harness/core";export function workspaceStatus(r,o){return[`stable-harness workspace: ${r.runtime.workspaceId??o}`,`root: ${r.root}`,`default agent: ${r.runtime.defaultAgentId}`,`agents: ${[...r.agents.keys()].sort().join(", ")||"none"}`,`workflows: ${[...r.workflows.keys()].sort().join(", ")||"none"}`,`default workflow: ${r.runtime.workflowRouting?.defaultWorkflowId??"none"}`,`workflow routes: ${t(r)}`,`tools: ${r.tools.size}`,"","Run a request with:","  stable-harness [prompt]","  stable-harness --agent <id> [prompt]","  stable-harness workflow render <workflow-id>","  stable-harness workflow inspect <workflow-id>","  stable-harness agent render <agent-id>","  stable-harness start",""].join("\n")}export function renderWorkflow(r,o){const t=n(r,o,"render");return`${e(t)}\n`}export function renderAgent(r,e){if(!e)throw new Error("Usage: stable-harness agent render <agent-id>");return`${o(r,e)}\n`}export function inspectWorkflow(o,e){const t=n(o,e,"inspect");return`${JSON.stringify({workflow:t,plan:r(t)},null,2)}\n`}export function formatDetail(r){return r&&"string"==typeof r.toolId?`:${r.toolId}`:""}function n(r,o,e){if(!o)throw new Error(`Usage: stable-harness workflow ${e} <workflow-id>`);const n=r.workflows.get(o);if(!n)throw new Error(`Workflow is not defined: ${o}`);return n}function t(r){return(r.runtime.workflowRouting?.routes??[]).map(r=>r.id).sort().join(", ")||"none"}
+import{compileWorkflowPlan as o,renderAgentMermaid as r,renderWorkflowMermaid as e}from"@stable-harness/core";export function workspaceStatus(o,r){return[`stable-harness workspace: ${o.runtime.workspaceId??r}`,`root: ${o.root}`,`default agent: ${o.runtime.defaultAgentId}`,`agents: ${[...o.agents.keys()].sort().join(", ")||"none"}`,`workflows: ${[...o.workflows.keys()].sort().join(", ")||"none"}`,`evaluations: ${[...o.evaluations?.keys()??[]].sort().join(", ")||"none"}`,`default workflow: ${o.runtime.workflowRouting?.defaultWorkflowId??"none"}`,`workflow routes: ${formatWorkflowRoutes(o)}`,`tools: ${o.tools.size}`,"","Run a request with:","  stable-harness [prompt]","  stable-harness --agent <id> [prompt]","  stable-harness workflow render <workflow-id>","  stable-harness workflow inspect <workflow-id>","  stable-harness agent render <agent-id>","  stable-harness start",""].join("\n")}export function renderWorkflow(o,r){const n=readWorkflow(o,r,"render");return`${e(n)}\n`}export function renderAgent(o,e){if(!e)throw new Error("Usage: stable-harness agent render <agent-id>");return`${r(o,e)}\n`}export function inspectWorkflow(r,e){const n=readWorkflow(r,e,"inspect");return`${JSON.stringify({workflow:n,plan:o(n)},null,2)}\n`}export function formatDetail(o){return o&&"string"==typeof o.toolId?`:${o.toolId}`:""}function readWorkflow(o,r,e){if(!r)throw new Error(`Usage: stable-harness workflow ${e} <workflow-id>`);const n=o.workflows.get(r);if(!n)throw new Error(`Workflow is not defined: ${r}`);return n}function formatWorkflowRoutes(o){return(o.runtime.workflowRouting?.routes??[]).map(o=>o.id).sort().join(", ")||"none"}

package/packages/cli/dist/src/server.d.ts

@@ -1,3 +1,5 @@
 import type { createStableHarnessRuntime } from "@stable-harness/core";
+import type { CompiledWorkspace } from "@stable-harness/core";
 import type { CliArgs } from "./args.js";
 export declare function serveProtocol(runtime: ReturnType<typeof createStableHarnessRuntime>, args: CliArgs): Promise<void>;
+export declare function stopProtocol(workspace: CompiledWorkspace, args: CliArgs): Promise<void>;

package/packages/cli/dist/src/server.js

@@ -1 +1 @@
-import{createOpenAiCompatibleHttpServer as t}from"@stable-harness/protocols";import{startOfficialLangGraphServer as o}from"./langgraph-official.js";const e="127.0.0.1";export async function serveProtocol(t,e){const a=function(t,o){const e=p(t.getRuntimePolicy().protocols)??{},a=s(e,"openaiCompatible","openai-compatible","openai")??{},c=s(e,"langgraph")??{};return[...i(a)?[r(t,a,o)]:[],...i(c)?[n(c)]:[]]}(t,e),c=[];for(const e of a)if("http"===e.kind){await l(e),c.push(()=>f(e.server));const t=e.server.address(),o="object"==typeof t&&t?t.port:e.port;process.stdout.write(`stable-harness ${e.protocol} API listening on http://${e.host}:${o}/v1\n`)}else{const r=await o(t,e.config);c.push(r.cleanup),process.stdout.write(`stable-harness ${e.protocol} API listening on ${r.url}\n`)}await async function(t){const o=setInterval(()=>{},864e5);await new Promise(e=>{const r=()=>{clearInterval(o),Promise.allSettled(t.map(t=>t())).finally(()=>process.exit(0))};process.once("SIGINT",r),process.once("SIGTERM",r)})}(c)}function r(o,r,n){const s=a(r.host)??e,i=c(r.port)??8642,p=a(r.bearerToken)??a(r.apiKey)??n.apiKey;return{kind:"http",protocol:"openai-compatible",server:t(o,{bearerToken:p}),host:s,port:i}}function n(t){const o=a(t.host)??e,r=c(t.port)??2024,n=function(t){if(Array.isArray(t)&&t.every(t=>"string"==typeof t))return t.filter(t=>t.trim()).map(t=>t.trim())}(t.exposeAgents);return{kind:"langgraph",protocol:"langgraph-compatible",config:{host:o,port:r,nWorkers:c(t.nWorkers)??10,...n?{exposeAgents:n}:{}}}}function s(t,...o){for(const e of o){const o=p(t[e]);if(o)return o}}function i(t){return!1!==t.enabled}function a(t){if("string"!=typeof t||!t.trim())return;const o=t.match(/^\$\{env:([A-Za-z_][A-Za-z0-9_]*)(?::-(.*))?\}$/u);return o?process.env[o[1]]??o[2]:t}function c(t){return"number"==typeof t&&Number.isFinite(t)?t:"string"==typeof t&&t.trim()?Number(t):void 0}function p(t){return"object"!=typeof t||null===t||Array.isArray(t)?void 0:t}async function l(t){await new Promise(o=>t.server.listen(t.port,t.host,o))}async function f(t){await new Promise((o,e)=>{t.close(t=>{t?e(t):o()})})}
+import{execFile as r}from"node:child_process";import{promisify as t}from"node:util";import{createOpenAiCompatibleHttpServer as o}from"@stable-harness/protocols";import{startOfficialLangGraphServer as e}from"./langgraph-official.js";const n="127.0.0.1",s=t(r);export async function serveProtocol(r,t){const o=createConfiguredServers(r,t),e=[];let n=0;for(const t of o)if("http"===t.kind){if(!await listen(t)){process.stdout.write(`stable-harness ${t.protocol} API already running on http://${t.host}:${t.port}/v1\n`);continue}e.push(()=>closeHttpServer(t.server)),n+=1;const r=t.server.address(),o="object"==typeof r&&r?r.port:t.port;process.stdout.write(`stable-harness ${t.protocol} API listening on http://${t.host}:${o}/v1\n`)}else{const o=await startLangGraphServer(r,t);if(!o){process.stdout.write(`stable-harness ${t.protocol} API already running on http://${t.config.host}:${t.config.port}\n`);continue}e.push(o.cleanup),n+=1,process.stdout.write(`stable-harness ${t.protocol} API listening on ${o.url}\n`)}0!==n&&await async function waitForShutdown(r){const t=setInterval(()=>{},864e5);await new Promise(o=>{const shutdown=()=>{clearInterval(t),Promise.allSettled(r.map(r=>r())).finally(()=>process.exit(0))};process.once("SIGINT",shutdown),process.once("SIGTERM",shutdown)})}(e)}export async function stopProtocol(r,t){const o=createConfiguredServers({getRuntimePolicy:()=>r.runtime},t).map(r=>"http"===r.kind?{protocol:r.protocol,host:r.host,port:r.port}:{protocol:r.protocol,host:r.config.host,port:r.config.port}),e=await Promise.all(o.map(async r=>({target:r,pids:await stableHarnessListenerPids(r.port)}))),n=[...new Set(e.flatMap(r=>r.pids))];for(const r of n)process.kill(r,"SIGTERM");for(const{target:r,pids:t}of e)0!==t.length?process.stdout.write(`stable-harness ${r.protocol} API stopped on ${r.host}:${r.port} pid=${t.join(",")}\n`):process.stdout.write(`stable-harness ${r.protocol} API not running on ${r.host}:${r.port}\n`)}function createConfiguredServers(r,t){const o=readRecord(r.getRuntimePolicy().protocols)??{},e=protocolConfig(o,"openaiCompatible","openai-compatible","openai")??{},n=protocolConfig(o,"langgraph")??{};return[...enabled(e)?[openAiServer(r,e,t)]:[],...enabled(n)?[langGraphServer(n)]:[]]}function openAiServer(r,t,e){const s=configString(t.host)??n,i=e.port??configNumber(t.port)??8642,a=e.host??s,c=configString(t.bearerToken)??configString(t.apiKey)??e.apiKey;return{kind:"http",protocol:"openai-compatible",server:o(r,{bearerToken:c}),host:a,port:i,...c?{bearerToken:c}:{}}}function langGraphServer(r){const t=configString(r.host)??n,o=configNumber(r.port)??2024,e=function configStringArray(r){if(Array.isArray(r)&&r.every(r=>"string"==typeof r))return r.filter(r=>r.trim()).map(r=>r.trim())}(r.exposeAgents);return{kind:"langgraph",protocol:"langgraph-compatible",config:{host:t,port:o,nWorkers:configNumber(r.nWorkers)??10,...e?{exposeAgents:e}:{},...void 0!==r.env?{env:r.env}:{},...void 0!==r.envFile?{envFile:r.envFile}:{}}}}function protocolConfig(r,...t){for(const o of t){const t=readRecord(r[o]);if(t)return t}}function enabled(r){return!1!==r.enabled}function configString(r){if("string"!=typeof r||!r.trim())return;const t=r.match(/^\$\{env:([A-Za-z_][A-Za-z0-9_]*)(?::-(.*))?\}$/u);return t?process.env[t[1]]??t[2]:r}function configNumber(r){return"number"==typeof r&&Number.isFinite(r)?r:"string"==typeof r&&r.trim()?Number(r):void 0}function readRecord(r){return"object"!=typeof r||null===r||Array.isArray(r)?void 0:r}async function listen(r){try{return await new Promise((t,o)=>{r.server.once("error",o),r.server.listen(r.port,r.host,()=>{r.server.off("error",o),t()})}),!0}catch(t){if(isAddressInUse(t)&&await async function isOpenAiServerAlreadyRunning(r){const t=await fetchJson(`http://${r.host}:${r.port}/v1/capabilities`,{...r.bearerToken?{authorization:`Bearer ${r.bearerToken}`}:{}});return"stable_harness.capabilities"===t?.object}(r))return!1;throw portConflictError(t,r.protocol,r.host,r.port)}}async function startLangGraphServer(r,t){if(!await isLangGraphServerAlreadyRunning(t))try{return await e(r,t.config)}catch(r){if(isAddressInUse(r)&&await isLangGraphServerAlreadyRunning(t))return;throw portConflictError(r,t.protocol,t.config.host,t.config.port)}}async function isLangGraphServerAlreadyRunning(r){const t=await fetchJson(`http://${r.config.host}:${r.config.port}/ok`);return!0===t?.ok}async function fetchJson(r,t={}){try{const o=await fetch(r,{headers:t});if(!o.ok)return;return await o.json()}catch{return}}function isAddressInUse(r){return"EADDRINUSE"===function readErrorCode(r){return"object"==typeof r&&null!==r&&"code"in r?r.code:void 0}(r)||String(r).includes("EADDRINUSE")}function portConflictError(r,t,o,e){return isAddressInUse(r)?new Error([`stable-harness ${t} port is already in use: ${o}:${e}.`,`Use --port <port>, update config/runtime/workspace.yaml, or stop the process currently listening on ${o}:${e}.`].join("\n")):r}async function stableHarnessListenerPids(r){const t=await async function listenerPids(r){try{const{stdout:t}=await s("lsof",[`-tiTCP:${r}`,"-sTCP:LISTEN"]);return t.split(/\s+/u).map(r=>Number(r)).filter(r=>Number.isInteger(r)&&r>0)}catch{return[]}}(r);return(await Promise.all(t.map(async r=>{const t=await async function processCommand(r){try{const{stdout:t}=await s("ps",["-p",String(r),"-o","command="]);return t.trim()}catch{return""}}(r);return function isStableHarnessStartCommand(r){return/\bstable-harness\b/u.test(r)&&/\bstart\b/u.test(r)}(t)?r:void 0}))).filter(r=>"number"==typeof r)}async function closeHttpServer(r){await new Promise((t,o)=>{r.close(r=>{r?o(r):t()})})}