@botbotgo/agent-harness 0.0.308 → 0.0.310

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

@@ -0,0 +1,178 @@
+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",
+                })),
+            },
+        },
+    };
+}

package/dist/protocol/a2a/http-rpc.d.ts

@@ -0,0 +1,28 @@
+import type { IncomingMessage, ServerResponse } from "node:http";
+import type { AgentHarnessRuntime } from "../../runtime/harness.js";
+import { type A2aServiceParameters } from "./http-discovery.js";
+import type { A2aAgentCardBuildOptions, A2aHttpServerOptions, A2aJsonRpcRequest, A2aJsonRpcResponse, PendingA2aPushNotificationConfig, StoredA2aPushNotificationConfig } from "./http.js";
+type PushNotificationRegistry = {
+    register: (taskId: string, config: PendingA2aPushNotificationConfig) => StoredA2aPushNotificationConfig;
+    list: (taskId: string) => StoredA2aPushNotificationConfig[];
+    get: (taskId: string, configId: string) => StoredA2aPushNotificationConfig | undefined;
+    delete: (taskId: string, configId: string) => boolean;
+    dispatch: (taskId: string) => Promise<void>;
+};
+type HandleA2aJsonRpcRequestInput = {
+    runtime: AgentHarnessRuntime;
+    request: IncomingMessage;
+    response: ServerResponse;
+    payload: A2aJsonRpcRequest;
+    serviceParameters: A2aServiceParameters;
+    serverOptions: A2aHttpServerOptions;
+    buildCardOptions: () => A2aAgentCardBuildOptions;
+    pushNotifications: PushNotificationRegistry;
+};
+export declare function toError(id: string | number | null, code: number, message: string, data?: unknown): A2aJsonRpcResponse;
+export declare function readRequestBody(request: IncomingMessage): Promise<string>;
+export declare function createPushNotificationRegistry(runtime: AgentHarnessRuntime, createId: () => string): PushNotificationRegistry & {
+    unsubscribe: () => void;
+};
+export declare function handleA2aJsonRpcRequest(input: HandleA2aJsonRpcRequestInput): Promise<void>;
+export {};