@botbotgo/agent-harness 0.0.475 → 0.0.476

package/dist/runtime/harness/run/surface-semantics.js

@@ -1,79 +1 @@
-import { readSkillMetadata } from "../../skills/skill-metadata.js";
-import { formatAgentName } from "../../../utils/agent-display.js";
-import { getBindingMemorySources, getBindingSkills, } from "../../support/compiled-binding.js";
-function asObject(value) {
-    return typeof value === "object" && value !== null ? value : null;
-}
-function readStringArray(value) {
-    return Array.isArray(value) ? value.filter((item) => typeof item === "string" && item.trim().length > 0) : [];
-}
-function normalizeLabel(value) {
-    return value.replace(/\s+/g, " ").trim();
-}
-export function normalizeSurfaceToken(value) {
-    return value
-        .toLowerCase()
-        .replace(/[^a-z0-9]+/g, "-")
-        .replace(/^-+|-+$/g, "")
-        .slice(0, 80) || "item";
-}
-export function buildSurfaceId(kind, value) {
-    void kind;
-    return normalizeSurfaceToken(value);
-}
-export function stripStepPrefix(label) {
-    return normalizeLabel(label)
-        .replace(/^Calling LLM\s+/i, "")
-        .replace(/^Completed LLM\s+/i, "")
-        .replace(/^Calling tool\s+/i, "")
-        .replace(/^Completed tool\s+/i, "")
-        .replace(/^Tool\s+/i, "")
-        .replace(/\s+failed$/i, "")
-        .replace(/^Calling skill\s+/i, "")
-        .replace(/^Completed skill\s+/i, "")
-        .replace(/^Accessing memory\s+/i, "")
-        .replace(/^Completed memory\s+/i, "");
-}
-function canonicalMemoryName(memorySource) {
-    const normalized = normalizeLabel(memorySource.replace(/^memory\//i, ""));
-    const segments = normalized.split(/[\\/]/).filter(Boolean);
-    return (segments.at(-1) ?? normalized).toLowerCase() || "memory";
-}
-export function resolveSurfaceDisplayName(input) {
-    const baseName = stripStepPrefix(input.step) || formatAgentName(input.kind);
-    if (input.kind === "memory" && input.binding && baseName.length === 0) {
-        const memorySources = getBindingMemorySources(input.binding).filter((name) => name.trim().length > 0);
-        return memorySources.length === 1 ? canonicalMemoryName(memorySources[0]) : baseName;
-    }
-    if (input.kind !== "skill" || !input.binding || baseName.length > 0) {
-        return baseName;
-    }
-    const skillNames = getBindingSkills(input.binding)
-        .map((skillPath) => readSkillMetadata(skillPath).name)
-        .filter((name) => typeof name === "string" && name.trim().length > 0);
-    return skillNames.length === 1 ? skillNames[0] : baseName;
-}
-function resolveMemoryAction(event) {
-    const typed = asObject(event);
-    const runType = typeof typed?.run_type === "string" ? typed.run_type.trim().toLowerCase() : "";
-    if (runType === "memory") {
-        return "access";
-    }
-    return "access";
-}
-export function resolveSurfaceAction(input) {
-    switch (input.kind) {
-        case "agent":
-            return "handoff";
-        case "llm":
-            return "call";
-        case "tool":
-            return "execute";
-        case "skill":
-            return "apply";
-        case "memory":
-            return resolveMemoryAction(input.event);
-        default:
-            return "run";
-    }
-}
+import{readSkillMetadata as l}from"../../skills/skill-metadata.js";import{formatAgentName as a}from"../../../utils/agent-display.js";import{getBindingMemorySources as s,getBindingSkills as c}from"../../support/compiled-binding.js";function m(e){return typeof e=="object"&&e!==null?e:null}function C(e){return Array.isArray(e)?e.filter(r=>typeof r=="string"&&r.trim().length>0):[]}function o(e){return e.replace(/\s+/g," ").trim()}function p(e){return e.toLowerCase().replace(/[^a-z0-9]+/g,"-").replace(/^-+|-+$/g,"").slice(0,80)||"item"}function S(e,r){return p(r)}function f(e){return o(e).replace(/^Calling LLM\s+/i,"").replace(/^Completed LLM\s+/i,"").replace(/^Calling tool\s+/i,"").replace(/^Completed tool\s+/i,"").replace(/^Tool\s+/i,"").replace(/\s+failed$/i,"").replace(/^Calling skill\s+/i,"").replace(/^Completed skill\s+/i,"").replace(/^Accessing memory\s+/i,"").replace(/^Completed memory\s+/i,"")}function u(e){const r=o(e.replace(/^memory\//i,""));return(r.split(/[\\/]/).filter(Boolean).at(-1)??r).toLowerCase()||"memory"}function b(e){const r=f(e.step)||a(e.kind);if(e.kind==="memory"&&e.binding&&r.length===0){const t=s(e.binding).filter(i=>i.trim().length>0);return t.length===1?u(t[0]):r}if(e.kind!=="skill"||!e.binding||r.length>0)return r;const n=c(e.binding).map(t=>l(t).name).filter(t=>typeof t=="string"&&t.trim().length>0);return n.length===1?n[0]:r}function g(e){const r=m(e);return(typeof r?.run_type=="string"?r.run_type.trim().toLowerCase():"")==="memory","access"}function h(e){switch(e.kind){case"agent":return"handoff";case"llm":return"call";case"tool":return"execute";case"skill":return"apply";case"memory":return g(e.event);default:return"run"}}export{S as buildSurfaceId,p as normalizeSurfaceToken,h as resolveSurfaceAction,b as resolveSurfaceDisplayName,f as stripStepPrefix};

package/dist/runtime/harness/runtime-defaults.js

@@ -1,39 +1 @@
-export function isSessionMemorySyncEnabled(workspace) {
-    const runtimeMemory = workspace.bindings.values().next().value?.harnessRuntime.runtimeMemory;
-    const syncConfig = typeof runtimeMemory?.sessionMemorySync === "object" && runtimeMemory.sessionMemorySync
-        ? runtimeMemory.sessionMemorySync
-        : undefined;
-    return runtimeMemory?.enabled === true && syncConfig?.enabled === true;
-}
-export function isInventoryEnabled(workspace) {
-    const runtime = workspace.refs.get("runtime/default");
-    const value = runtime && "value" in runtime && typeof runtime.value === "object" && runtime.value
-        ? runtime.value
-        : undefined;
-    const inventory = typeof value?.inventory === "object" && value.inventory
-        ? value.inventory
-        : undefined;
-    return inventory?.enabled === true;
-}
-export function createDefaultHealthSnapshot(activeRequestSlots, pendingRequestSlots) {
-    const updatedAt = new Date().toISOString();
-    const healthy = { status: "healthy", updatedAt, reason: "health monitor disabled" };
-    return {
-        status: "healthy",
-        updatedAt,
-        checks: {
-            runtime: healthy,
-            llm: healthy,
-            persistence: healthy,
-            capacity: healthy,
-            workload: healthy,
-        },
-        symptoms: [],
-        stats: {
-            activeRequestSlots,
-            pendingRequestSlots,
-            pendingApprovals: 0,
-            stuckRequests: 0,
-        },
-    };
-}
+function s(o){const e=o.bindings.values().next().value?.harnessRuntime.runtimeMemory,n=typeof e?.sessionMemorySync=="object"&&e.sessionMemorySync?e.sessionMemorySync:void 0;return e?.enabled===!0&&n?.enabled===!0}function r(o){const e=o.refs.get("runtime/default"),n=e&&"value"in e&&typeof e.value=="object"&&e.value?e.value:void 0;return(typeof n?.inventory=="object"&&n.inventory?n.inventory:void 0)?.enabled===!0}function a(o,e){const n=new Date().toISOString(),t={status:"healthy",updatedAt:n,reason:"health monitor disabled"};return{status:"healthy",updatedAt:n,checks:{runtime:t,llm:t,persistence:t,capacity:t,workload:t},symptoms:[],stats:{activeRequestSlots:o,pendingRequestSlots:e,pendingApprovals:0,stuckRequests:0}}}export{a as createDefaultHealthSnapshot,r as isInventoryEnabled,s as isSessionMemorySyncEnabled};

package/dist/runtime/harness/system/boundary-analysis.js

@@ -1,234 +1 @@
-import { existsSync, readdirSync, statSync } from "node:fs";
-import path from "node:path";
-import { readSkillMetadata } from "../../skills/skill-metadata.js";
-import { getBindingPrimaryTools, getBindingSkills, getBindingSubagents, } from "../../support/compiled-binding.js";
-const BUILTIN_SKILL_TOOLS = new Set(["read_todos", "write_todos"]);
-function uniqueSorted(values) {
-    return Array.from(new Set(values.filter((value) => value.trim().length > 0))).sort();
-}
-function addFinding(findings, options, finding) {
-    if (finding.severity === "info" && options.includeInfo === false) {
-        return;
-    }
-    findings.push(finding);
-}
-function discoverWorkspaceSkillPaths(workspaceRoot, referencedSkillPaths) {
-    const skillPaths = new Set(referencedSkillPaths);
-    const skillsRoot = path.join(workspaceRoot, "resources", "skills");
-    if (!existsSync(skillsRoot)) {
-        return uniqueSorted(Array.from(skillPaths));
-    }
-    for (const entry of readdirSync(skillsRoot)) {
-        const skillPath = path.join(skillsRoot, entry);
-        try {
-            if (statSync(skillPath).isDirectory() && existsSync(path.join(skillPath, "SKILL.md"))) {
-                skillPaths.add(skillPath);
-            }
-        }
-        catch {
-            continue;
-        }
-    }
-    return uniqueSorted(Array.from(skillPaths));
-}
-function describeTopLevelSurface(binding) {
-    return {
-        id: binding.agent.id,
-        description: binding.agent.description,
-        tools: uniqueSorted(getBindingPrimaryTools(binding).map((tool) => tool.name)),
-        skills: uniqueSorted(getBindingSkills(binding)),
-        subagents: uniqueSorted(getBindingSubagents(binding).map((subagent) => subagent.name)),
-        sourcePath: binding.agent.sourcePath,
-    };
-}
-function describeSubagentSurface(subagent, parentAgentId) {
-    return {
-        id: subagent.name,
-        description: subagent.description,
-        tools: uniqueSorted((subagent.tools ?? []).map((tool) => tool.name)),
-        skills: uniqueSorted(subagent.skills ?? []),
-        subagents: [],
-        parentAgentId,
-    };
-}
-function addOwner(index, key, agentId) {
-    const owners = index.get(key) ?? [];
-    owners.push(agentId);
-    index.set(key, owners);
-}
-function stripAgentRefPrefix(value) {
-    const prefix = "agent/";
-    return value.startsWith(prefix) ? value.slice(prefix.length) : value;
-}
-export function analyzeWorkspaceBoundaries(workspace, options = {}) {
-    const findings = [];
-    const agentSurfaces = [];
-    const referencedSkillPaths = [];
-    const toolOwners = new Map();
-    const skillOwners = new Map();
-    const skillSurfaceOwners = new Map();
-    for (const binding of workspace.bindings.values()) {
-        const topLevel = describeTopLevelSurface(binding);
-        agentSurfaces.push(topLevel);
-        for (const skillPath of topLevel.skills) {
-            referencedSkillPaths.push(skillPath);
-        }
-        for (const subagent of getBindingSubagents(binding)) {
-            const surface = describeSubagentSurface(subagent, binding.agent.id);
-            agentSurfaces.push(surface);
-            for (const skillPath of surface.skills) {
-                referencedSkillPaths.push(skillPath);
-            }
-        }
-    }
-    for (const surface of agentSurfaces) {
-        if (surface.description.trim().length === 0) {
-            addFinding(findings, options, {
-                severity: "warning",
-                code: "agent-missing-description",
-                message: `Agent '${surface.id}' has no description, making routing boundaries ambiguous.`,
-                agentId: surface.id,
-                parentAgentId: surface.parentAgentId,
-                sourcePath: surface.sourcePath,
-            });
-        }
-        if (surface.subagents.length > 0 && (surface.tools.length > 0 || surface.skills.length > 0)) {
-            addFinding(findings, options, {
-                severity: "warning",
-                code: "mixed-routing-and-execution-surface",
-                message: `Agent '${surface.id}' declares subagents and also exposes local tools or skills.`,
-                agentId: surface.id,
-                sourcePath: surface.sourcePath,
-            });
-        }
-        if (surface.subagents.length === 0 && surface.tools.length === 0 && surface.skills.length === 0) {
-            addFinding(findings, options, {
-                severity: "info",
-                code: "empty-execution-surface",
-                message: `Agent '${surface.id}' has no tools, skills, or subagents declared.`,
-                agentId: surface.id,
-                parentAgentId: surface.parentAgentId,
-                sourcePath: surface.sourcePath,
-            });
-        }
-        for (const toolName of surface.tools) {
-            addOwner(toolOwners, toolName, surface.id);
-        }
-        for (const skillPath of surface.skills) {
-            addOwner(skillOwners, skillPath, surface.id);
-            skillSurfaceOwners.set(skillPath, [...(skillSurfaceOwners.get(skillPath) ?? []), surface]);
-        }
-    }
-    for (const agent of workspace.agents.values()) {
-        for (const subagentRef of agent.subagentRefs) {
-            const subagentId = stripAgentRefPrefix(subagentRef);
-            if (!workspace.agents.has(subagentId)) {
-                addFinding(findings, options, {
-                    severity: "error",
-                    code: "missing-subagent-reference",
-                    message: `Agent '${agent.id}' references missing subagent '${subagentRef}'.`,
-                    agentId: agent.id,
-                    sourcePath: agent.sourcePath,
-                });
-            }
-        }
-    }
-    for (const [toolName, owners] of toolOwners) {
-        const uniqueOwners = uniqueSorted(owners);
-        if (uniqueOwners.length > 1) {
-            addFinding(findings, options, {
-                severity: "info",
-                code: "shared-tool-surface",
-                message: `Tool '${toolName}' is exposed by multiple agents; review whether the shared surface is intentional.`,
-                toolName,
-                relatedAgents: uniqueOwners,
-            });
-        }
-    }
-    for (const [skillPath, owners] of skillOwners) {
-        const uniqueOwners = uniqueSorted(owners);
-        if (uniqueOwners.length > 1) {
-            const metadata = readSkillMetadata(skillPath);
-            addFinding(findings, options, {
-                severity: "info",
-                code: "shared-skill-surface",
-                message: `Skill '${metadata.name}' is exposed by multiple agents; review whether the shared surface is intentional.`,
-                skillName: metadata.name,
-                skillPath,
-                relatedAgents: uniqueOwners,
-            });
-        }
-    }
-    for (const tool of workspace.tools.values()) {
-        if (!toolOwners.has(tool.name)) {
-            addFinding(findings, options, {
-                severity: "warning",
-                code: "unreferenced-tool",
-                message: `Tool '${tool.name}' is defined but not exposed by any agent or subagent.`,
-                toolName: tool.name,
-                sourcePath: tool.sourcePath,
-            });
-        }
-    }
-    const discoveredSkillPaths = discoverWorkspaceSkillPaths(workspace.workspaceRoot, referencedSkillPaths);
-    for (const skillPath of discoveredSkillPaths) {
-        const metadata = readSkillMetadata(skillPath);
-        const owners = skillOwners.get(skillPath) ?? [];
-        if (owners.length === 0) {
-            addFinding(findings, options, {
-                severity: "warning",
-                code: "unreferenced-skill",
-                message: `Skill '${metadata.name}' is present but not exposed by any agent or subagent.`,
-                skillName: metadata.name,
-                skillPath,
-            });
-            continue;
-        }
-        if (!metadata.allowedTools || metadata.allowedTools.length === 0) {
-            addFinding(findings, options, {
-                severity: "warning",
-                code: "skill-missing-allowed-tools",
-                message: `Skill '${metadata.name}' does not declare allowed-tools.`,
-                skillName: metadata.name,
-                skillPath,
-                relatedAgents: uniqueSorted(owners),
-            });
-            continue;
-        }
-        for (const surface of skillSurfaceOwners.get(skillPath) ?? []) {
-            const owner = surface.parentAgentId ? `${surface.parentAgentId}/${surface.id}` : surface.id;
-            const availableTools = new Set([...surface.tools, ...BUILTIN_SKILL_TOOLS]);
-            for (const allowedTool of metadata.allowedTools) {
-                if (!availableTools.has(allowedTool)) {
-                    addFinding(findings, options, {
-                        severity: "error",
-                        code: "skill-allowed-tool-unavailable",
-                        message: `Skill '${metadata.name}' allows tool '${allowedTool}', but agent '${owner}' does not expose it.`,
-                        agentId: surface.id,
-                        parentAgentId: surface.parentAgentId,
-                        toolName: allowedTool,
-                        skillName: metadata.name,
-                        skillPath,
-                    });
-                }
-            }
-        }
-    }
-    const errorCount = findings.filter((finding) => finding.severity === "error").length;
-    const warningCount = findings.filter((finding) => finding.severity === "warning").length;
-    const infoCount = findings.filter((finding) => finding.severity === "info").length;
-    return {
-        workspaceRoot: workspace.workspaceRoot,
-        summary: {
-            agentCount: agentSurfaces.length,
-            toolCount: workspace.tools.size,
-            skillCount: discoveredSkillPaths.length,
-            findingCount: findings.length,
-            errorCount,
-            warningCount,
-            infoCount,
-        },
-        agents: agentSurfaces,
-        findings,
-    };
-}
+import{existsSync as w,readdirSync as $,statSync as x}from"node:fs";import k from"node:path";import{readSkillMetadata as y}from"../../skills/skill-metadata.js";import{getBindingPrimaryTools as T,getBindingSkills as N,getBindingSubagents as S}from"../../support/compiled-binding.js";const L=new Set(["read_todos","write_todos"]);function l(t){return Array.from(new Set(t.filter(s=>s.trim().length>0))).sort()}function c(t,s,n){n.severity==="info"&&s.includeInfo===!1||t.push(n)}function O(t,s){const n=new Set(s),i=k.join(t,"resources","skills");if(!w(i))return l(Array.from(n));for(const g of $(i)){const d=k.join(i,g);try{x(d).isDirectory()&&w(k.join(d,"SKILL.md"))&&n.add(d)}catch{continue}}return l(Array.from(n))}function C(t){return{id:t.agent.id,description:t.agent.description,tools:l(T(t).map(s=>s.name)),skills:l(N(t)),subagents:l(S(t).map(s=>s.name)),sourcePath:t.agent.sourcePath}}function R(t,s){return{id:t.name,description:t.description,tools:l((t.tools??[]).map(n=>n.name)),skills:l(t.skills??[]),subagents:[],parentAgentId:s}}function P(t,s,n){const i=t.get(s)??[];i.push(n),t.set(s,i)}function B(t){const s="agent/";return t.startsWith(s)?t.slice(s.length):t}function W(t,s={}){const n=[],i=[],g=[],d=new Map,f=new Map,u=new Map;for(const e of t.bindings.values()){const o=C(e);i.push(o);for(const r of o.skills)g.push(r);for(const r of S(e)){const a=R(r,e.agent.id);i.push(a);for(const h of a.skills)g.push(h)}}for(const e of i){e.description.trim().length===0&&c(n,s,{severity:"warning",code:"agent-missing-description",message:`Agent '${e.id}' has no description, making routing boundaries ambiguous.`,agentId:e.id,parentAgentId:e.parentAgentId,sourcePath:e.sourcePath}),e.subagents.length>0&&(e.tools.length>0||e.skills.length>0)&&c(n,s,{severity:"warning",code:"mixed-routing-and-execution-surface",message:`Agent '${e.id}' declares subagents and also exposes local tools or skills.`,agentId:e.id,sourcePath:e.sourcePath}),e.subagents.length===0&&e.tools.length===0&&e.skills.length===0&&c(n,s,{severity:"info",code:"empty-execution-surface",message:`Agent '${e.id}' has no tools, skills, or subagents declared.`,agentId:e.id,parentAgentId:e.parentAgentId,sourcePath:e.sourcePath});for(const o of e.tools)P(d,o,e.id);for(const o of e.skills)P(f,o,e.id),u.set(o,[...u.get(o)??[],e])}for(const e of t.agents.values())for(const o of e.subagentRefs){const r=B(o);t.agents.has(r)||c(n,s,{severity:"error",code:"missing-subagent-reference",message:`Agent '${e.id}' references missing subagent '${o}'.`,agentId:e.id,sourcePath:e.sourcePath})}for(const[e,o]of d){const r=l(o);r.length>1&&c(n,s,{severity:"info",code:"shared-tool-surface",message:`Tool '${e}' is exposed by multiple agents; review whether the shared surface is intentional.`,toolName:e,relatedAgents:r})}for(const[e,o]of f){const r=l(o);if(r.length>1){const a=y(e);c(n,s,{severity:"info",code:"shared-skill-surface",message:`Skill '${a.name}' is exposed by multiple agents; review whether the shared surface is intentional.`,skillName:a.name,skillPath:e,relatedAgents:r})}}for(const e of t.tools.values())d.has(e.name)||c(n,s,{severity:"warning",code:"unreferenced-tool",message:`Tool '${e.name}' is defined but not exposed by any agent or subagent.`,toolName:e.name,sourcePath:e.sourcePath});const p=O(t.workspaceRoot,g);for(const e of p){const o=y(e),r=f.get(e)??[];if(r.length===0){c(n,s,{severity:"warning",code:"unreferenced-skill",message:`Skill '${o.name}' is present but not exposed by any agent or subagent.`,skillName:o.name,skillPath:e});continue}if(!o.allowedTools||o.allowedTools.length===0){c(n,s,{severity:"warning",code:"skill-missing-allowed-tools",message:`Skill '${o.name}' does not declare allowed-tools.`,skillName:o.name,skillPath:e,relatedAgents:l(r)});continue}for(const a of u.get(e)??[]){const h=a.parentAgentId?`${a.parentAgentId}/${a.id}`:a.id,I=new Set([...a.tools,...L]);for(const m of o.allowedTools)I.has(m)||c(n,s,{severity:"error",code:"skill-allowed-tool-unavailable",message:`Skill '${o.name}' allows tool '${m}', but agent '${h}' does not expose it.`,agentId:a.id,parentAgentId:a.parentAgentId,toolName:m,skillName:o.name,skillPath:e})}}const b=n.filter(e=>e.severity==="error").length,v=n.filter(e=>e.severity==="warning").length,A=n.filter(e=>e.severity==="info").length;return{workspaceRoot:t.workspaceRoot,summary:{agentCount:i.length,toolCount:t.tools.size,skillCount:p.length,findingCount:n.length,errorCount:b,warningCount:v,infoCount:A},agents:i,findings:n}}export{W as analyzeWorkspaceBoundaries};

package/dist/runtime/harness/system/health-monitor.js

@@ -1,258 +1 @@
-import { getRuntimeDefaults } from "../../../workspace/support/workspace-ref-utils.js";
-const DEFAULT_HEALTH_CONFIG = {
-    enabled: false,
-    evaluateIntervalSeconds: 30,
-    emitEvents: true,
-    thresholds: {
-        llmErrorRate: {
-            windowSeconds: 60,
-            degradedAbove: 0.15,
-            unhealthyAbove: 0.4,
-        },
-        llmP95LatencyMs: {
-            windowSeconds: 300,
-            degradedAbove: 8_000,
-            unhealthyAbove: 20_000,
-        },
-        pendingApprovals: {
-            degradedAbove: 20,
-            unhealthyAbove: 100,
-        },
-        stuckRunSeconds: {
-            degradedAbove: 300,
-            unhealthyAbove: 900,
-        },
-    },
-};
-const ACTIVE_REQUEST_STATES = [
-    "queued",
-    "claimed",
-    "running",
-    "waiting_for_approval",
-    "resuming",
-    "cancelling",
-];
-function asObject(value) {
-    return typeof value === "object" && value !== null && !Array.isArray(value) ? value : undefined;
-}
-function readPositiveNumber(value, fallback) {
-    return typeof value === "number" && Number.isFinite(value) && value > 0 ? value : fallback;
-}
-function readNonNegativeNumber(value, fallback) {
-    return typeof value === "number" && Number.isFinite(value) && value >= 0 ? value : fallback;
-}
-function maxStatus(left, right) {
-    const rank = { healthy: 0, degraded: 1, unhealthy: 2 };
-    return rank[left] >= rank[right] ? left : right;
-}
-function buildCheck(status, updatedAt, reason) {
-    return reason ? { status, updatedAt, reason } : { status, updatedAt };
-}
-function createSymptom(code, status, message, timestamp) {
-    return {
-        code,
-        severity: status === "unhealthy" ? "error" : status === "degraded" ? "warn" : "info",
-        message,
-        firstSeenAt: timestamp,
-        lastSeenAt: timestamp,
-    };
-}
-function describeThresholdStatus(value, thresholds) {
-    if (value >= thresholds.unhealthyAbove) {
-        return "unhealthy";
-    }
-    if (value >= thresholds.degradedAbove) {
-        return "degraded";
-    }
-    return "healthy";
-}
-function computeP95(values) {
-    if (values.length === 0) {
-        return undefined;
-    }
-    const sorted = [...values].sort((a, b) => a - b);
-    const index = Math.min(sorted.length - 1, Math.max(0, Math.ceil(sorted.length * 0.95) - 1));
-    return sorted[index];
-}
-export function readHealthMonitorConfig(workspace) {
-    const runtimeDefaults = getRuntimeDefaults(workspace.refs);
-    const observability = asObject(runtimeDefaults?.observability);
-    const health = asObject(observability?.health);
-    const thresholds = asObject(health?.thresholds);
-    const llmErrorRate = asObject(thresholds?.llmErrorRate);
-    const llmP95LatencyMs = asObject(thresholds?.llmP95LatencyMs);
-    const pendingApprovals = asObject(thresholds?.pendingApprovals);
-    const stuckRunSeconds = asObject(thresholds?.stuckRunSeconds);
-    return {
-        enabled: health?.enabled === true,
-        evaluateIntervalSeconds: readPositiveNumber(health?.evaluateIntervalSeconds, DEFAULT_HEALTH_CONFIG.evaluateIntervalSeconds),
-        emitEvents: health?.emitEvents !== false,
-        thresholds: {
-            llmErrorRate: {
-                windowSeconds: readPositiveNumber(llmErrorRate?.windowSeconds, DEFAULT_HEALTH_CONFIG.thresholds.llmErrorRate.windowSeconds),
-                degradedAbove: readNonNegativeNumber(llmErrorRate?.degradedAbove, DEFAULT_HEALTH_CONFIG.thresholds.llmErrorRate.degradedAbove),
-                unhealthyAbove: readNonNegativeNumber(llmErrorRate?.unhealthyAbove, DEFAULT_HEALTH_CONFIG.thresholds.llmErrorRate.unhealthyAbove),
-            },
-            llmP95LatencyMs: {
-                windowSeconds: readPositiveNumber(llmP95LatencyMs?.windowSeconds, DEFAULT_HEALTH_CONFIG.thresholds.llmP95LatencyMs.windowSeconds),
-                degradedAbove: readNonNegativeNumber(llmP95LatencyMs?.degradedAbove, DEFAULT_HEALTH_CONFIG.thresholds.llmP95LatencyMs.degradedAbove),
-                unhealthyAbove: readNonNegativeNumber(llmP95LatencyMs?.unhealthyAbove, DEFAULT_HEALTH_CONFIG.thresholds.llmP95LatencyMs.unhealthyAbove),
-            },
-            pendingApprovals: {
-                degradedAbove: readNonNegativeNumber(pendingApprovals?.degradedAbove, DEFAULT_HEALTH_CONFIG.thresholds.pendingApprovals.degradedAbove),
-                unhealthyAbove: readNonNegativeNumber(pendingApprovals?.unhealthyAbove, DEFAULT_HEALTH_CONFIG.thresholds.pendingApprovals.unhealthyAbove),
-            },
-            stuckRunSeconds: {
-                degradedAbove: readNonNegativeNumber(stuckRunSeconds?.degradedAbove, DEFAULT_HEALTH_CONFIG.thresholds.stuckRunSeconds.degradedAbove),
-                unhealthyAbove: readNonNegativeNumber(stuckRunSeconds?.unhealthyAbove, DEFAULT_HEALTH_CONFIG.thresholds.stuckRunSeconds.unhealthyAbove),
-            },
-        },
-    };
-}
-export class HealthMonitor {
-    options;
-    config;
-    llmSamples = [];
-    timer = null;
-    latestSnapshot = null;
-    constructor(options) {
-        this.options = options;
-        this.config = readHealthMonitorConfig(options.workspace);
-    }
-    recordLlmSuccess(latencyMs, nowMs = Date.now()) {
-        this.recordLlmSample({ timestampMs: nowMs, latencyMs, success: true });
-    }
-    recordLlmFailure(latencyMs, nowMs = Date.now()) {
-        this.recordLlmSample({ timestampMs: nowMs, latencyMs, success: false });
-    }
-    recordLlmSample(sample) {
-        this.llmSamples.push(sample);
-        const keepAfter = sample.timestampMs - Math.max(this.config.thresholds.llmErrorRate.windowSeconds, this.config.thresholds.llmP95LatencyMs.windowSeconds) * 1000;
-        while (this.llmSamples.length > 0 && this.llmSamples[0].timestampMs < keepAfter) {
-            this.llmSamples.shift();
-        }
-    }
-    async start() {
-        if (!this.config.enabled || this.timer) {
-            return;
-        }
-        await this.evaluate();
-        this.timer = setInterval(() => {
-            void this.evaluate();
-        }, this.config.evaluateIntervalSeconds * 1000);
-        this.timer.unref?.();
-    }
-    async stop() {
-        if (this.timer) {
-            clearInterval(this.timer);
-            this.timer = null;
-        }
-    }
-    async getSnapshot() {
-        return this.evaluate();
-    }
-    async evaluate(nowMs = Date.now()) {
-        const updatedAt = new Date(nowMs).toISOString();
-        const [requests, approvals] = await Promise.all([
-            Promise.all(ACTIVE_REQUEST_STATES.map((state) => this.options.persistence.listRequests({ state }))).then((groups) => groups.flat()),
-            this.options.persistence.listApprovals({ status: "pending" }),
-        ]);
-        const pendingApprovals = approvals.length;
-        const stuckRequests = this.countStuckRequests(requests, nowMs);
-        const llmCheck = this.evaluateLlmCheck(updatedAt, nowMs);
-        const workloadCheck = this.evaluateWorkloadCheck(updatedAt, pendingApprovals, stuckRequests);
-        const runtimeCheck = buildCheck("healthy", updatedAt, "runtime health monitoring enabled");
-        const persistenceCheck = buildCheck("healthy", updatedAt, "runtime persistence accessible");
-        const capacityCheck = buildCheck("healthy", updatedAt, "capacity checks disabled");
-        const symptoms = [];
-        if (describeThresholdStatus(pendingApprovals, this.config.thresholds.pendingApprovals) !== "healthy") {
-            symptoms.push(createSymptom("workload.pending-approvals", describeThresholdStatus(pendingApprovals, this.config.thresholds.pendingApprovals), `pendingApprovals=${pendingApprovals}`, updatedAt));
-        }
-        if (stuckRequests > 0) {
-            symptoms.push(createSymptom("workload.stuck-requests", workloadCheck.status, `stuckRequests=${stuckRequests}`, updatedAt));
-        }
-        if (llmCheck.status !== "healthy") {
-            symptoms.push(createSymptom("llm.invocations", llmCheck.status, llmCheck.reason ?? "llm health degraded", updatedAt));
-        }
-        let overallStatus = "healthy";
-        for (const check of [runtimeCheck, llmCheck, persistenceCheck, capacityCheck, workloadCheck]) {
-            overallStatus = maxStatus(overallStatus, check.status);
-        }
-        const snapshot = {
-            status: overallStatus,
-            updatedAt,
-            checks: {
-                runtime: runtimeCheck,
-                llm: llmCheck,
-                persistence: persistenceCheck,
-                capacity: capacityCheck,
-                workload: workloadCheck,
-            },
-            symptoms,
-            stats: {
-                activeRequestSlots: this.options.getActiveRequestSlots(),
-                pendingRequestSlots: this.options.getPendingRequestSlots(),
-                pendingApprovals,
-                stuckRequests,
-                ...this.llmStats(nowMs),
-            },
-        };
-        if (this.config.enabled &&
-            this.config.emitEvents &&
-            this.options.publishEvent &&
-            this.latestSnapshot &&
-            this.latestSnapshot.status !== snapshot.status) {
-            await this.options.publishEvent({
-                previousStatus: this.latestSnapshot.status,
-                status: snapshot.status,
-                checks: snapshot.checks,
-                stats: snapshot.stats,
-            });
-        }
-        this.latestSnapshot = snapshot;
-        return snapshot;
-    }
-    llmStats(nowMs) {
-        const recent = this.llmSamples.filter((sample) => nowMs - sample.timestampMs <= 60 * 1000);
-        const successes = recent.filter((sample) => sample.success).length;
-        return {
-            llmSuccessRate1m: recent.length > 0 ? successes / recent.length : undefined,
-            llmP95LatencyMs1m: computeP95(recent.map((sample) => sample.latencyMs)),
-        };
-    }
-    evaluateLlmCheck(updatedAt, nowMs) {
-        const errorSamples = this.llmSamples.filter((sample) => nowMs - sample.timestampMs <= this.config.thresholds.llmErrorRate.windowSeconds * 1000);
-        const latencySamples = this.llmSamples.filter((sample) => nowMs - sample.timestampMs <= this.config.thresholds.llmP95LatencyMs.windowSeconds * 1000);
-        if (errorSamples.length === 0 && latencySamples.length === 0) {
-            return buildCheck("healthy", updatedAt, "no recent llm invocations");
-        }
-        const errorRate = errorSamples.length > 0
-            ? errorSamples.filter((sample) => !sample.success).length / errorSamples.length
-            : 0;
-        const p95Latency = computeP95(latencySamples.map((sample) => sample.latencyMs));
-        let status = describeThresholdStatus(errorRate, this.config.thresholds.llmErrorRate);
-        if (p95Latency !== undefined) {
-            status = maxStatus(status, describeThresholdStatus(p95Latency, this.config.thresholds.llmP95LatencyMs));
-        }
-        return buildCheck(status, updatedAt, `errorRate=${errorRate.toFixed(2)}${p95Latency !== undefined ? ` p95LatencyMs=${Math.round(p95Latency)}` : ""}`);
-    }
-    evaluateWorkloadCheck(updatedAt, pendingApprovals, stuckRequests) {
-        let status = describeThresholdStatus(pendingApprovals, this.config.thresholds.pendingApprovals);
-        if (stuckRequests > 0) {
-            status = maxStatus(status, stuckRequests >= this.config.thresholds.stuckRunSeconds.unhealthyAbove ? "unhealthy" : "degraded");
-        }
-        return buildCheck(status, updatedAt, `pendingApprovals=${pendingApprovals} stuckRequests=${stuckRequests}`);
-    }
-    countStuckRequests(requests, nowMs) {
-        return requests.filter((request) => {
-            if (!["claimed", "running", "resuming", "queued", "cancelling"].includes(request.state)) {
-                return false;
-            }
-            const updatedAtMs = Date.parse(request.updatedAt);
-            if (!Number.isFinite(updatedAtMs)) {
-                return false;
-            }
-            return (nowMs - updatedAtMs) / 1000 >= this.config.thresholds.stuckRunSeconds.degradedAbove;
-        }).length;
-    }
-}
+import{getRuntimeDefaults as M}from"../../../workspace/support/workspace-ref-utils.js";const h={enabled:!1,evaluateIntervalSeconds:30,emitEvents:!0,thresholds:{llmErrorRate:{windowSeconds:60,degradedAbove:.15,unhealthyAbove:.4},llmP95LatencyMs:{windowSeconds:300,degradedAbove:8e3,unhealthyAbove:2e4},pendingApprovals:{degradedAbove:20,unhealthyAbove:100},stuckRunSeconds:{degradedAbove:300,unhealthyAbove:900}}},E=["queued","claimed","running","waiting_for_approval","resuming","cancelling"];function d(s){return typeof s=="object"&&s!==null&&!Array.isArray(s)?s:void 0}function S(s,e){return typeof s=="number"&&Number.isFinite(s)&&s>0?s:e}function c(s,e){return typeof s=="number"&&Number.isFinite(s)&&s>=0?s:e}function y(s,e){const t={healthy:0,degraded:1,unhealthy:2};return t[s]>=t[e]?s:e}function m(s,e,t){return t?{status:s,updatedAt:e,reason:t}:{status:s,updatedAt:e}}function b(s,e,t,n){return{code:s,severity:e==="unhealthy"?"error":e==="degraded"?"warn":"info",message:t,firstSeenAt:n,lastSeenAt:n}}function g(s,e){return s>=e.unhealthyAbove?"unhealthy":s>=e.degradedAbove?"degraded":"healthy"}function R(s){if(s.length===0)return;const e=[...s].sort((n,o)=>n-o),t=Math.min(e.length-1,Math.max(0,Math.ceil(e.length*.95)-1));return e[t]}function L(s){const e=M(s.refs),t=d(e?.observability),n=d(t?.health),o=d(n?.thresholds),r=d(o?.llmErrorRate),a=d(o?.llmP95LatencyMs),i=d(o?.pendingApprovals),l=d(o?.stuckRunSeconds);return{enabled:n?.enabled===!0,evaluateIntervalSeconds:S(n?.evaluateIntervalSeconds,h.evaluateIntervalSeconds),emitEvents:n?.emitEvents!==!1,thresholds:{llmErrorRate:{windowSeconds:S(r?.windowSeconds,h.thresholds.llmErrorRate.windowSeconds),degradedAbove:c(r?.degradedAbove,h.thresholds.llmErrorRate.degradedAbove),unhealthyAbove:c(r?.unhealthyAbove,h.thresholds.llmErrorRate.unhealthyAbove)},llmP95LatencyMs:{windowSeconds:S(a?.windowSeconds,h.thresholds.llmP95LatencyMs.windowSeconds),degradedAbove:c(a?.degradedAbove,h.thresholds.llmP95LatencyMs.degradedAbove),unhealthyAbove:c(a?.unhealthyAbove,h.thresholds.llmP95LatencyMs.unhealthyAbove)},pendingApprovals:{degradedAbove:c(i?.degradedAbove,h.thresholds.pendingApprovals.degradedAbove),unhealthyAbove:c(i?.unhealthyAbove,h.thresholds.pendingApprovals.unhealthyAbove)},stuckRunSeconds:{degradedAbove:c(l?.degradedAbove,h.thresholds.stuckRunSeconds.degradedAbove),unhealthyAbove:c(l?.unhealthyAbove,h.thresholds.stuckRunSeconds.unhealthyAbove)}}}}class C{options;config;llmSamples=[];timer=null;latestSnapshot=null;constructor(e){this.options=e,this.config=L(e.workspace)}recordLlmSuccess(e,t=Date.now()){this.recordLlmSample({timestampMs:t,latencyMs:e,success:!0})}recordLlmFailure(e,t=Date.now()){this.recordLlmSample({timestampMs:t,latencyMs:e,success:!1})}recordLlmSample(e){this.llmSamples.push(e);const t=e.timestampMs-Math.max(this.config.thresholds.llmErrorRate.windowSeconds,this.config.thresholds.llmP95LatencyMs.windowSeconds)*1e3;for(;this.llmSamples.length>0&&this.llmSamples[0].timestampMs<t;)this.llmSamples.shift()}async start(){!this.config.enabled||this.timer||(await this.evaluate(),this.timer=setInterval(()=>{this.evaluate()},this.config.evaluateIntervalSeconds*1e3),this.timer.unref?.())}async stop(){this.timer&&(clearInterval(this.timer),this.timer=null)}async getSnapshot(){return this.evaluate()}async evaluate(e=Date.now()){const t=new Date(e).toISOString(),[n,o]=await Promise.all([Promise.all(E.map(p=>this.options.persistence.listRequests({state:p}))).then(p=>p.flat()),this.options.persistence.listApprovals({status:"pending"})]),r=o.length,a=this.countStuckRequests(n,e),i=this.evaluateLlmCheck(t,e),l=this.evaluateWorkloadCheck(t,r,a),A=m("healthy",t,"runtime health monitoring enabled"),k=m("healthy",t,"runtime persistence accessible"),w=m("healthy",t,"capacity checks disabled"),v=[];g(r,this.config.thresholds.pendingApprovals)!=="healthy"&&v.push(b("workload.pending-approvals",g(r,this.config.thresholds.pendingApprovals),`pendingApprovals=${r}`,t)),a>0&&v.push(b("workload.stuck-requests",l.status,`stuckRequests=${a}`,t)),i.status!=="healthy"&&v.push(b("llm.invocations",i.status,i.reason??"llm health degraded",t));let f="healthy";for(const p of[A,i,k,w,l])f=y(f,p.status);const u={status:f,updatedAt:t,checks:{runtime:A,llm:i,persistence:k,capacity:w,workload:l},symptoms:v,stats:{activeRequestSlots:this.options.getActiveRequestSlots(),pendingRequestSlots:this.options.getPendingRequestSlots(),pendingApprovals:r,stuckRequests:a,...this.llmStats(e)}};return this.config.enabled&&this.config.emitEvents&&this.options.publishEvent&&this.latestSnapshot&&this.latestSnapshot.status!==u.status&&await this.options.publishEvent({previousStatus:this.latestSnapshot.status,status:u.status,checks:u.checks,stats:u.stats}),this.latestSnapshot=u,u}llmStats(e){const t=this.llmSamples.filter(o=>e-o.timestampMs<=6e4),n=t.filter(o=>o.success).length;return{llmSuccessRate1m:t.length>0?n/t.length:void 0,llmP95LatencyMs1m:R(t.map(o=>o.latencyMs))}}evaluateLlmCheck(e,t){const n=this.llmSamples.filter(l=>t-l.timestampMs<=this.config.thresholds.llmErrorRate.windowSeconds*1e3),o=this.llmSamples.filter(l=>t-l.timestampMs<=this.config.thresholds.llmP95LatencyMs.windowSeconds*1e3);if(n.length===0&&o.length===0)return m("healthy",e,"no recent llm invocations");const r=n.length>0?n.filter(l=>!l.success).length/n.length:0,a=R(o.map(l=>l.latencyMs));let i=g(r,this.config.thresholds.llmErrorRate);return a!==void 0&&(i=y(i,g(a,this.config.thresholds.llmP95LatencyMs))),m(i,e,`errorRate=${r.toFixed(2)}${a!==void 0?` p95LatencyMs=${Math.round(a)}`:""}`)}evaluateWorkloadCheck(e,t,n){let o=g(t,this.config.thresholds.pendingApprovals);return n>0&&(o=y(o,n>=this.config.thresholds.stuckRunSeconds.unhealthyAbove?"unhealthy":"degraded")),m(o,e,`pendingApprovals=${t} stuckRequests=${n}`)}countStuckRequests(e,t){return e.filter(n=>{if(!["claimed","running","resuming","queued","cancelling"].includes(n.state))return!1;const o=Date.parse(n.updatedAt);return Number.isFinite(o)?(t-o)/1e3>=this.config.thresholds.stuckRunSeconds.degradedAbove:!1}).length}}export{C as HealthMonitor,L as readHealthMonitorConfig};