@botbotgo/agent-harness 0.0.475 → 0.0.476

package/dist/projections/upstream-events.js

@@ -1,201 +1 @@
-import { extractInterruptPayload, extractReasoningStreamOutput, extractToolResult } from "../runtime/parsing/stream-event-parsing.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") : [];
-}
-function normalizeSegment(value) {
-    return value
-        .replace(/[_-]+/g, " ")
-        .replace(/\s+/g, " ")
-        .trim();
-}
-function titleCase(value) {
-    return normalizeSegment(value)
-        .split(" ")
-        .filter(Boolean)
-        .map((part) => part.charAt(0).toUpperCase() + part.slice(1))
-        .join(" ");
-}
-function readEventContext(event) {
-    const typed = asObject(event);
-    return {
-        eventName: typeof typed?.event === 'string' ? typed.event : "",
-        name: typeof typed?.name === 'string' ? typed.name : "",
-        runType: typeof typed?.run_type === 'string' ? typed.run_type : "",
-        tags: readStringArray(typed?.tags),
-        ns: readStringArray(typed?.ns),
-    };
-}
-function normalizeSemanticHint(value) {
-    return value
-        .replace(/([a-z0-9])([A-Z])/g, "$1 $2")
-        .replace(/[.:/]+/g, " ")
-        .replace(/[_-]+/g, " ")
-        .replace(/\s+/g, " ")
-        .trim()
-        .toLowerCase();
-}
-function isExactSemanticHint(values, expected) {
-    return values.includes(expected);
-}
-function classifyStepCategory(context) {
-    const hints = [context.name, context.runType, ...context.tags, ...context.ns].map(normalizeSemanticHint);
-    if (context.runType === "memory"
-        || isExactSemanticHint(hints, "memory")) {
-        return "memory";
-    }
-    if (isExactSemanticHint(hints, "skill")) {
-        return "skill";
-    }
-    if (context.eventName.startsWith("on_tool_") || context.runType === "tool") {
-        return "tool";
-    }
-    return "chain";
-}
-function buildStepLabel(category, status, name) {
-    const displayName = titleCase(name || category);
-    if (category === "llm") {
-        return status === "started" ? `Calling LLM ${displayName}` : `Completed LLM ${displayName}`;
-    }
-    if (category === "tool") {
-        if (status === "failed") {
-            return `Tool ${displayName} failed`;
-        }
-        return status === "started" ? `Calling tool ${displayName}` : `Completed tool ${displayName}`;
-    }
-    if (category === "skill") {
-        return status === "started" ? `Calling skill ${displayName}` : `Completed skill ${displayName}`;
-    }
-    if (category === "memory") {
-        return status === "started" ? `Accessing memory ${displayName}` : `Completed memory ${displayName}`;
-    }
-    return status === "started" ? `Running ${displayName}` : `Completed ${displayName}`;
-}
-function createProjectionKey(parts) {
-    return JSON.stringify(parts, (_key, value) => {
-        if (typeof value === "string" && value.length > 512) {
-            return `${value.slice(0, 497)}...[${value.length} chars]`;
-        }
-        return value;
-    });
-}
-export function createUpstreamTimelineReducer() {
-    const emittedStepKeys = new Set();
-    const emittedToolResultKeys = new Set();
-    return {
-        consume(event) {
-            const projections = [];
-            const context = readEventContext(event);
-            const reasoning = extractReasoningStreamOutput(event);
-            if (reasoning) {
-                projections.push({
-                    type: "thinking",
-                    text: reasoning,
-                });
-            }
-            const interruptPayload = extractInterruptPayload(event);
-            if (interruptPayload) {
-                const key = createProjectionKey(["approval", context.eventName || "interrupt", interruptPayload]);
-                if (!emittedStepKeys.has(key)) {
-                    emittedStepKeys.add(key);
-                    projections.push({
-                        type: "step",
-                        step: "Waiting for approval",
-                        category: "approval",
-                        status: "started",
-                        key,
-                    });
-                }
-            }
-            if (context.eventName === "on_chat_model_start") {
-                const stepName = context.name || "model";
-                const key = createProjectionKey(["llm", "started", stepName]);
-                if (!emittedStepKeys.has(key)) {
-                    emittedStepKeys.add(key);
-                    projections.push({
-                        type: "step",
-                        step: buildStepLabel("llm", "started", stepName),
-                        category: "llm",
-                        status: "started",
-                        key,
-                    });
-                }
-            }
-            if (context.eventName === "on_chat_model_end") {
-                const stepName = context.name || "model";
-                const key = createProjectionKey(["llm", "completed", stepName]);
-                if (!emittedStepKeys.has(key)) {
-                    emittedStepKeys.add(key);
-                    projections.push({
-                        type: "step",
-                        step: buildStepLabel("llm", "completed", stepName),
-                        category: "llm",
-                        status: "completed",
-                        key,
-                    });
-                }
-            }
-            if (context.eventName === "on_tool_start"
-                || (context.eventName === "on_chain_start" && context.runType === "tool")
-                || context.eventName === "on_chain_start") {
-                const category = classifyStepCategory(context);
-                if (category !== "llm") {
-                    const stepName = context.name || context.runType || "chain";
-                    const key = createProjectionKey([category, "started", stepName]);
-                    if (!emittedStepKeys.has(key)) {
-                        emittedStepKeys.add(key);
-                        projections.push({
-                            type: "step",
-                            step: buildStepLabel(category, "started", stepName),
-                            category,
-                            status: "started",
-                            key,
-                        });
-                    }
-                }
-            }
-            const toolResult = extractToolResult(event);
-            if (toolResult) {
-                const resultKey = createProjectionKey(["tool-result", toolResult.toolName, toolResult.output, toolResult.isError === true]);
-                if (!emittedToolResultKeys.has(resultKey)) {
-                    emittedToolResultKeys.add(resultKey);
-                    projections.push({
-                        type: "tool-result",
-                        toolName: toolResult.toolName,
-                        output: toolResult.output,
-                        ...(toolResult.isError !== undefined ? { isError: toolResult.isError } : {}),
-                        key: resultKey,
-                    });
-                }
-                const stepKey = createProjectionKey(["tool", toolResult.isError ? "failed" : "completed", toolResult.toolName]);
-                if (!emittedStepKeys.has(stepKey)) {
-                    emittedStepKeys.add(stepKey);
-                    projections.push({
-                        type: "step",
-                        step: buildStepLabel("tool", toolResult.isError ? "failed" : "completed", toolResult.toolName),
-                        category: "tool",
-                        status: toolResult.isError ? "failed" : "completed",
-                        key: stepKey,
-                    });
-                }
-            }
-            if (context.eventName === "on_chain_end" && context.runType !== "tool" && context.name) {
-                const category = classifyStepCategory(context);
-                const key = createProjectionKey([category, "completed", context.name]);
-                if (!emittedStepKeys.has(key)) {
-                    emittedStepKeys.add(key);
-                    projections.push({
-                        type: "step",
-                        step: buildStepLabel(category, "completed", context.name),
-                        category,
-                        status: "completed",
-                        key,
-                    });
-                }
-            }
-            return projections;
-        },
-    };
-}
+import{extractInterruptPayload as g,extractReasoningStreamOutput as h,extractToolResult as _}from"../runtime/parsing/stream-event-parsing.js";function N(e){return typeof e=="object"&&e!==null?e:null}function d(e){return Array.isArray(e)?e.filter(t=>typeof t=="string"):[]}function $(e){return e.replace(/[_-]+/g," ").replace(/\s+/g," ").trim()}function k(e){return $(e).split(" ").filter(Boolean).map(t=>t.charAt(0).toUpperCase()+t.slice(1)).join(" ")}function C(e){const t=N(e);return{eventName:typeof t?.event=="string"?t.event:"",name:typeof t?.name=="string"?t.name:"",runType:typeof t?.run_type=="string"?t.run_type:"",tags:d(t?.tags),ns:d(t?.ns)}}function S(e){return e.replace(/([a-z0-9])([A-Z])/g,"$1 $2").replace(/[.:/]+/g," ").replace(/[_-]+/g," ").replace(/\s+/g," ").trim().toLowerCase()}function y(e,t){return e.includes(t)}function f(e){const t=[e.name,e.runType,...e.tags,...e.ns].map(S);return e.runType==="memory"||y(t,"memory")?"memory":y(t,"skill")?"skill":e.eventName.startsWith("on_tool_")||e.runType==="tool"?"tool":"chain"}function p(e,t,i){const n=k(i||e);return e==="llm"?t==="started"?`Calling LLM ${n}`:`Completed LLM ${n}`:e==="tool"?t==="failed"?`Tool ${n} failed`:t==="started"?`Calling tool ${n}`:`Completed tool ${n}`:e==="skill"?t==="started"?`Calling skill ${n}`:`Completed skill ${n}`:e==="memory"?t==="started"?`Accessing memory ${n}`:`Completed memory ${n}`:t==="started"?`Running ${n}`:`Completed ${n}`}function l(e){return JSON.stringify(e,(t,i)=>typeof i=="string"&&i.length>512?`${i.slice(0,497)}...[${i.length} chars]`:i)}function E(){const e=new Set,t=new Set;return{consume(i){const n=[],o=C(i),c=h(i);c&&n.push({type:"thinking",text:c});const u=g(i);if(u){const r=l(["approval",o.eventName||"interrupt",u]);e.has(r)||(e.add(r),n.push({type:"step",step:"Waiting for approval",category:"approval",status:"started",key:r}))}if(o.eventName==="on_chat_model_start"){const r=o.name||"model",s=l(["llm","started",r]);e.has(s)||(e.add(s),n.push({type:"step",step:p("llm","started",r),category:"llm",status:"started",key:s}))}if(o.eventName==="on_chat_model_end"){const r=o.name||"model",s=l(["llm","completed",r]);e.has(s)||(e.add(s),n.push({type:"step",step:p("llm","completed",r),category:"llm",status:"completed",key:s}))}if(o.eventName==="on_tool_start"||o.eventName==="on_chain_start"&&o.runType==="tool"||o.eventName==="on_chain_start"){const r=f(o);if(r!=="llm"){const s=o.name||o.runType||"chain",m=l([r,"started",s]);e.has(m)||(e.add(m),n.push({type:"step",step:p(r,"started",s),category:r,status:"started",key:m}))}}const a=_(i);if(a){const r=l(["tool-result",a.toolName,a.output,a.isError===!0]);t.has(r)||(t.add(r),n.push({type:"tool-result",toolName:a.toolName,output:a.output,...a.isError!==void 0?{isError:a.isError}:{},key:r}));const s=l(["tool",a.isError?"failed":"completed",a.toolName]);e.has(s)||(e.add(s),n.push({type:"step",step:p("tool",a.isError?"failed":"completed",a.toolName),category:"tool",status:a.isError?"failed":"completed",key:s}))}if(o.eventName==="on_chain_end"&&o.runType!=="tool"&&o.name){const r=f(o),s=l([r,"completed",o.name]);e.has(s)||(e.add(s),n.push({type:"step",step:p(r,"completed",o.name),category:r,status:"completed",key:s}))}return n}}}export{E as createUpstreamTimelineReducer};

package/dist/protocol/a2a/http-discovery.js

@@ -1,178 +1 @@
-import { AGENT_HARNESS_VERSION } from "../../package-version.js";
-export const SUPPORTED_A2A_VERSIONS = ["1.0", "0.3"];
-export function normalizePath(value, fallback) {
-    const source = typeof value === "string" && value.trim().length > 0 ? value.trim() : fallback;
-    return source.startsWith("/") ? source : `/${source}`;
-}
-export function writeJson(response, statusCode, payload) {
-    response.statusCode = statusCode;
-    response.setHeader("content-type", "application/json; charset=utf-8");
-    response.end(JSON.stringify(payload));
-}
-export function writeA2aDiscoveryHeaders(response) {
-    response.setHeader("A2A-Version", "1.0");
-    response.setHeader("A2A-Supported-Versions", SUPPORTED_A2A_VERSIONS.join(", "));
-}
-function normalizeNonEmptyStringArray(value) {
-    if (!Array.isArray(value)) {
-        return undefined;
-    }
-    const items = value.map((item) => item.trim()).filter((item) => item.length > 0);
-    return items.length > 0 ? items : undefined;
-}
-function buildDiscoveryMetadata(options) {
-    const registryUrls = normalizeNonEmptyStringArray(options.registryUrls);
-    const signature = options.agentCardSignature?.signature?.trim();
-    const algorithm = options.agentCardSignature?.algorithm?.trim();
-    const keyId = options.agentCardSignature?.keyId?.trim();
-    if (!registryUrls && (!signature || !algorithm)) {
-        return undefined;
-    }
-    return {
-        ...(registryUrls ? { registryUrls } : {}),
-        ...(signature && algorithm
-            ? {
-                signedAgentCard: {
-                    algorithm,
-                    signature,
-                    ...(keyId ? { keyId } : {}),
-                },
-            }
-            : {}),
-    };
-}
-export function writeOptionalAgentCardIntegrityHeaders(response, options) {
-    const registryUrls = normalizeNonEmptyStringArray(options.registryUrls);
-    if (registryUrls) {
-        response.setHeader("X-A2A-Registry-Urls", registryUrls.join(", "));
-    }
-    const signature = options.agentCardSignature?.signature?.trim();
-    const algorithm = options.agentCardSignature?.algorithm?.trim();
-    const keyId = options.agentCardSignature?.keyId?.trim();
-    if (signature && algorithm) {
-        response.setHeader("X-A2A-Agent-Card-Signature", signature);
-        response.setHeader("X-A2A-Agent-Card-Alg", algorithm);
-        if (keyId) {
-            response.setHeader("X-A2A-Agent-Card-Key-Id", keyId);
-        }
-    }
-}
-function readServiceParameter(requestUrl, request, name) {
-    const headerValue = request.headers[name.toLowerCase()];
-    if (typeof headerValue === "string") {
-        return headerValue;
-    }
-    if (Array.isArray(headerValue)) {
-        return headerValue.join(",");
-    }
-    return requestUrl.searchParams.get(name) ?? undefined;
-}
-export function parseA2aServiceParameters(requestUrl, request) {
-    const requestedVersion = readServiceParameter(requestUrl, request, "A2A-Version")?.trim() ?? "";
-    const normalizedVersion = requestedVersion.length === 0 ? "0.3" : requestedVersion;
-    if (!SUPPORTED_A2A_VERSIONS.includes(normalizedVersion)) {
-        return null;
-    }
-    const requestedExtensions = readServiceParameter(requestUrl, request, "A2A-Extensions") ?? "";
-    return {
-        version: normalizedVersion,
-        extensions: requestedExtensions
-            .split(",")
-            .map((entry) => entry.trim())
-            .filter((entry) => entry.length > 0),
-    };
-}
-export function acceptsSse(request) {
-    const accept = request.headers.accept;
-    if (accept === undefined) {
-        return false;
-    }
-    const values = Array.isArray(accept) ? accept : [accept];
-    return values.some((value) => value.includes("text/event-stream"));
-}
-export function buildAgentCard(runtime, options) {
-    const inventory = runtime.describeWorkspaceInventory();
-    const discovery = buildDiscoveryMetadata({
-        registryUrls: options.registryUrls,
-        agentCardSignature: options.agentCardSignature,
-    });
-    const skills = inventory.agents.map((agent) => ({
-        id: agent.id,
-        name: agent.id,
-        description: agent.description || `Agent ${agent.id}`,
-        tags: ["agent-harness", agent.parentAgentId ? "subagent" : "agent"],
-        examples: [`Send a task to ${agent.id}.`],
-    }));
-    return {
-        name: options.agentName,
-        description: options.agentDescription,
-        version: AGENT_HARNESS_VERSION,
-        protocolVersion: "1.0",
-        url: options.rpcUrl,
-        preferredTransport: "JSONRPC",
-        supportedInterfaces: [
-            {
-                url: options.rpcUrl,
-                protocolBinding: "JSONRPC",
-                protocolVersion: "1.0",
-            },
-            {
-                url: options.rpcUrl,
-                protocolBinding: "JSONRPC",
-                protocolVersion: "0.3",
-            },
-        ],
-        capabilities: {
-            streaming: true,
-            pushNotifications: true,
-            extendedAgentCard: true,
-        },
-        defaultInputModes: ["text/plain"],
-        defaultOutputModes: ["text/plain"],
-        skills,
-        ...(discovery
-            ? {
-                metadata: {
-                    agentHarness: {
-                        discovery,
-                    },
-                },
-            }
-            : {}),
-        ...(options.documentationUrl ? { documentationUrl: options.documentationUrl } : {}),
-        ...(options.provider ? { provider: options.provider } : {}),
-        ...(options.defaultAgentId ? { defaultAgentId: options.defaultAgentId } : {}),
-    };
-}
-export function buildExtendedAgentCard(runtime, options) {
-    const inventory = runtime.describeWorkspaceInventory();
-    const card = buildAgentCard(runtime, options);
-    const discovery = buildDiscoveryMetadata({
-        registryUrls: options.registryUrls,
-        agentCardSignature: options.agentCardSignature,
-    });
-    return {
-        ...card,
-        metadata: {
-            agentHarness: {
-                runtime: {
-                    product: "agent-harness",
-                    protocolSurface: "a2a-http",
-                    ...(options.defaultAgentId ? { defaultAgentId: options.defaultAgentId } : {}),
-                },
-                protocolSurfaces: ["A2A", "ACP", "AG-UI", "runtime MCP"],
-                inventory: {
-                    agentCount: inventory.agents.length,
-                    subagentCount: inventory.agents.filter((agent) => Boolean(agent.parentAgentId)).length,
-                },
-                ...(discovery ? { discovery } : {}),
-                agents: inventory.agents.map((agent) => ({
-                    id: agent.id,
-                    name: agent.id,
-                    description: agent.description || `Agent ${agent.id}`,
-                    kind: agent.parentAgentId ? "subagent" : "agent",
-                })),
-            },
-        },
-    };
-}
+import{AGENT_HARNESS_VERSION as g}from"../../package-version.js";const d=["1.0","0.3"];function A(t,e){const r=typeof t=="string"&&t.trim().length>0?t.trim():e;return r.startsWith("/")?r:`/${r}`}function f(t,e,r){t.statusCode=e,t.setHeader("content-type","application/json; charset=utf-8"),t.end(JSON.stringify(r))}function m(t){t.setHeader("A2A-Version","1.0"),t.setHeader("A2A-Supported-Versions",d.join(", "))}function s(t){if(!Array.isArray(t))return;const e=t.map(r=>r.trim()).filter(r=>r.length>0);return e.length>0?e:void 0}function o(t){const e=s(t.registryUrls),r=t.agentCardSignature?.signature?.trim(),n=t.agentCardSignature?.algorithm?.trim(),i=t.agentCardSignature?.keyId?.trim();if(!(!e&&(!r||!n)))return{...e?{registryUrls:e}:{},...r&&n?{signedAgentCard:{algorithm:n,signature:r,...i?{keyId:i}:{}}}:{}}}function p(t,e){const r=s(e.registryUrls);r&&t.setHeader("X-A2A-Registry-Urls",r.join(", "));const n=e.agentCardSignature?.signature?.trim(),i=e.agentCardSignature?.algorithm?.trim(),a=e.agentCardSignature?.keyId?.trim();n&&i&&(t.setHeader("X-A2A-Agent-Card-Signature",n),t.setHeader("X-A2A-Agent-Card-Alg",i),a&&t.setHeader("X-A2A-Agent-Card-Key-Id",a))}function u(t,e,r){const n=e.headers[r.toLowerCase()];return typeof n=="string"?n:Array.isArray(n)?n.join(","):t.searchParams.get(r)??void 0}function y(t,e){const r=u(t,e,"A2A-Version")?.trim()??"",n=r.length===0?"0.3":r;if(!d.includes(n))return null;const i=u(t,e,"A2A-Extensions")??"";return{version:n,extensions:i.split(",").map(a=>a.trim()).filter(a=>a.length>0)}}function S(t){const e=t.headers.accept;return e===void 0?!1:(Array.isArray(e)?e:[e]).some(n=>n.includes("text/event-stream"))}function c(t,e){const r=t.describeWorkspaceInventory(),n=o({registryUrls:e.registryUrls,agentCardSignature:e.agentCardSignature}),i=r.agents.map(a=>({id:a.id,name:a.id,description:a.description||`Agent ${a.id}`,tags:["agent-harness",a.parentAgentId?"subagent":"agent"],examples:[`Send a task to ${a.id}.`]}));return{name:e.agentName,description:e.agentDescription,version:g,protocolVersion:"1.0",url:e.rpcUrl,preferredTransport:"JSONRPC",supportedInterfaces:[{url:e.rpcUrl,protocolBinding:"JSONRPC",protocolVersion:"1.0"},{url:e.rpcUrl,protocolBinding:"JSONRPC",protocolVersion:"0.3"}],capabilities:{streaming:!0,pushNotifications:!0,extendedAgentCard:!0},defaultInputModes:["text/plain"],defaultOutputModes:["text/plain"],skills:i,...n?{metadata:{agentHarness:{discovery:n}}}:{},...e.documentationUrl?{documentationUrl:e.documentationUrl}:{},...e.provider?{provider:e.provider}:{},...e.defaultAgentId?{defaultAgentId:e.defaultAgentId}:{}}}function C(t,e){const r=t.describeWorkspaceInventory(),n=c(t,e),i=o({registryUrls:e.registryUrls,agentCardSignature:e.agentCardSignature});return{...n,metadata:{agentHarness:{runtime:{product:"agent-harness",protocolSurface:"a2a-http",...e.defaultAgentId?{defaultAgentId:e.defaultAgentId}:{}},protocolSurfaces:["A2A","ACP","AG-UI","runtime MCP"],inventory:{agentCount:r.agents.length,subagentCount:r.agents.filter(a=>!!a.parentAgentId).length},...i?{discovery:i}:{},agents:r.agents.map(a=>({id:a.id,name:a.id,description:a.description||`Agent ${a.id}`,kind:a.parentAgentId?"subagent":"agent"}))}}}}export{d as SUPPORTED_A2A_VERSIONS,S as acceptsSse,c as buildAgentCard,C as buildExtendedAgentCard,A as normalizePath,y as parseA2aServiceParameters,m as writeA2aDiscoveryHeaders,f as writeJson,p as writeOptionalAgentCardIntegrityHeaders};