@xrkseek/harness 0.4.3 → 0.4.5

package/node_modules/@xrkseek/a2a/dist/inbound.js

@@ -0,0 +1,263 @@
+import { timingSafeEqual } from "node:crypto";
+import { A2A_PROTOCOL_VERSION, ROLE_AGENT, ROLE_USER, STATE_COMPLETED, STATE_REJECTED, TurnTracker, extractText, maxPingpongTurns, newContextId, newTaskId, persistMessage, textMessage, } from "./protocol.js";
+function sendJson(res, status, body) {
+    const raw = JSON.stringify(body);
+    res.writeHead(status, {
+        "content-type": "application/json; charset=utf-8",
+        "cache-control": "no-store",
+    });
+    res.end(raw);
+}
+function readBody(req) {
+    return new Promise((resolve, reject) => {
+        const chunks = [];
+        req.on("data", (c) => chunks.push(c));
+        req.on("end", () => resolve(Buffer.concat(chunks).toString("utf8")));
+        req.on("error", reject);
+    });
+}
+function safeEqualToken(a, b) {
+    const ba = Buffer.from(a);
+    const bb = Buffer.from(b);
+    if (ba.length !== bb.length)
+        return false;
+    try {
+        return timingSafeEqual(ba, bb);
+    }
+    catch {
+        return false;
+    }
+}
+/** Parse `A2A_PEER_TOKENS=alice:tok1,bob:tok2` → name → token. */
+export function parsePeerTokens(raw) {
+    const out = new Map();
+    if (!raw?.trim())
+        return out;
+    for (const part of raw.split(",")) {
+        const idx = part.indexOf(":");
+        if (idx <= 0)
+            continue;
+        const name = part.slice(0, idx).trim();
+        const token = part.slice(idx + 1).trim();
+        if (name && token)
+            out.set(name, token);
+    }
+    return out;
+}
+export function buildA2aAgentCard(options) {
+    const iface = {
+        url: options.url,
+        protocolBinding: "JSONRPC",
+        protocolVersion: A2A_PROTOCOL_VERSION,
+    };
+    const card = {
+        name: options.name,
+        description: options.description,
+        url: options.url,
+        version: "1.0.0",
+        provider: { organization: "XRK Harness", url: options.url },
+        supportedInterfaces: [iface],
+        capabilities: {
+            streaming: false,
+            pushNotifications: false,
+            stateTransitionHistory: false,
+            extendedAgentCard: false,
+        },
+        defaultInputModes: ["text/plain"],
+        defaultOutputModes: ["text/plain"],
+        skills: [
+            {
+                id: "chat",
+                name: "chat",
+                description: "Send a text task to this XRK Host (message/send).",
+                tags: ["chat"],
+            },
+        ],
+    };
+    if (options.authRequired) {
+        card.securitySchemes = { bearer: { type: "http", scheme: "bearer" } };
+        card.security = [{ bearer: [] }];
+    }
+    return card;
+}
+function authorize(req, env) {
+    const bearer = env.XRK_A2A_BEARER_TOKEN?.trim() || env.A2A_BEARER_TOKEN?.trim();
+    const peers = parsePeerTokens(env.XRK_A2A_PEER_TOKENS?.trim() || env.A2A_PEER_TOKENS);
+    const authRequired = Boolean(bearer) || peers.size > 0;
+    if (!authRequired) {
+        return { ok: true, peer: `ip:${req.socket.remoteAddress ?? "local"}` };
+    }
+    const header = String(req.headers.authorization ?? "");
+    const m = /^Bearer\s+(\S+)/i.exec(header);
+    const token = m?.[1] ?? "";
+    if (!token) {
+        return {
+            ok: false,
+            status: 401,
+            error: {
+                jsonrpc: "2.0",
+                error: { code: -32050, message: "unauthorized" },
+                id: null,
+            },
+        };
+    }
+    for (const [name, peerTok] of peers) {
+        if (safeEqualToken(token, peerTok)) {
+            return { ok: true, peer: name };
+        }
+    }
+    if (bearer && safeEqualToken(token, bearer)) {
+        return { ok: true, peer: `ip:${req.socket.remoteAddress ?? "local"}` };
+    }
+    return {
+        ok: false,
+        status: 401,
+        error: {
+            jsonrpc: "2.0",
+            error: { code: -32050, message: "unauthorized" },
+            id: null,
+        },
+    };
+}
+async function handleMessageSend(params, peer, options, tracker) {
+    const message = (params.message ?? params);
+    const text = extractText(message).trim();
+    const contextId = String(message.contextId ?? params.contextId ?? "").trim() ||
+        newContextId();
+    const taskId = String(params.taskId ?? message.taskId ?? "").trim() || newTaskId();
+    const env = options.env ?? process.env;
+    const turns = tracker.track(contextId);
+    const cap = maxPingpongTurns(env);
+    if (turns > cap) {
+        return {
+            task: {
+                id: taskId,
+                contextId,
+                status: {
+                    state: STATE_REJECTED,
+                    message: textMessage(ROLE_AGENT, `rejected: pingpong turn cap ${cap} reached for context`, contextId),
+                },
+            },
+        };
+    }
+    const persistOpts = options.conversationsRoot
+        ? { root: options.conversationsRoot }
+        : undefined;
+    if (text) {
+        persistMessage(contextId, ROLE_USER, text, taskId, persistOpts);
+    }
+    let reply;
+    if (options.onMessage) {
+        reply = String(await options.onMessage({ text, contextId, taskId, peer })).trim();
+    }
+    else {
+        reply =
+            text.length > 0
+                ? `A2A inbound accepted from ${peer}: ${text.slice(0, 400)}`
+                : `A2A inbound accepted from ${peer} (empty message)`;
+    }
+    persistMessage(contextId, ROLE_AGENT, reply, taskId, persistOpts);
+    return {
+        task: {
+            id: taskId,
+            contextId,
+            status: {
+                state: STATE_COMPLETED,
+                message: textMessage(ROLE_AGENT, reply, contextId),
+            },
+        },
+    };
+}
+/**
+ * Claim A2A inbound paths. Returns true when the request was handled.
+ * Paths: `GET /.well-known/agent-card.json` · `GET /.well-known/agent.json` ·
+ * `POST /a2a` (JSON-RPC) · optional `GET /a2a/health`.
+ */
+export function createA2aInboundHandler(options) {
+    const env = options.env ?? process.env;
+    const tracker = options.turnTracker ?? new TurnTracker();
+    const name = options.name?.trim() || "XRK Harness";
+    const description = options.description?.trim() ||
+        "XRK Host A2A inbound (Agent Card + message/send). Face session injection optional.";
+    const authRequired = Boolean(env.XRK_A2A_BEARER_TOKEN?.trim() ||
+        env.A2A_BEARER_TOKEN?.trim() ||
+        env.XRK_A2A_PEER_TOKENS?.trim() ||
+        env.A2A_PEER_TOKENS?.trim());
+    const card = buildA2aAgentCard({
+        name,
+        url: options.url,
+        description,
+        authRequired,
+    });
+    return async (req, res) => {
+        const url = new URL(req.url ?? "/", "http://127.0.0.1");
+        const path = url.pathname;
+        const method = (req.method ?? "GET").toUpperCase();
+        if (method === "GET" &&
+            (path === "/.well-known/agent-card.json" ||
+                path === "/.well-known/agent.json")) {
+            sendJson(res, 200, card);
+            return true;
+        }
+        if (method === "GET" && path === "/a2a/health") {
+            sendJson(res, 200, {
+                ok: true,
+                protocol: A2A_PROTOCOL_VERSION,
+                authRequired,
+            });
+            return true;
+        }
+        if (method === "POST" && (path === "/a2a" || path === "/a2a/")) {
+            const auth = authorize(req, env);
+            if (!auth.ok) {
+                sendJson(res, auth.status, auth.error);
+                return true;
+            }
+            let body;
+            try {
+                body = JSON.parse((await readBody(req)) || "{}");
+            }
+            catch {
+                sendJson(res, 400, {
+                    jsonrpc: "2.0",
+                    error: { code: -32700, message: "parse error" },
+                    id: null,
+                });
+                return true;
+            }
+            const id = body.id ?? null;
+            const rpcMethod = String(body.method ?? "");
+            if (rpcMethod !== "message/send") {
+                sendJson(res, 200, {
+                    jsonrpc: "2.0",
+                    id,
+                    error: {
+                        code: -32601,
+                        message: `method not found: ${rpcMethod || "(missing)"}`,
+                    },
+                });
+                return true;
+            }
+            const params = body.params && typeof body.params === "object"
+                ? body.params
+                : {};
+            try {
+                const result = await handleMessageSend(params, auth.peer, options, tracker);
+                sendJson(res, 200, { jsonrpc: "2.0", id, result });
+            }
+            catch (err) {
+                sendJson(res, 200, {
+                    jsonrpc: "2.0",
+                    id,
+                    error: {
+                        code: -32000,
+                        message: err instanceof Error ? err.message : String(err),
+                    },
+                });
+            }
+            return true;
+        }
+        return false;
+    };
+}
+//# sourceMappingURL=inbound.js.map

package/node_modules/@xrkseek/a2a/dist/inbound.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"inbound.js","sourceRoot":"","sources":["../src/inbound.ts"],"names":[],"mappings":"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"}

package/node_modules/@xrkseek/a2a/dist/index.d.ts

@@ -0,0 +1,6 @@
+export { A2A_PROTOCOL_VERSION, ROLE_USER, ROLE_AGENT, STATE_COMPLETED, STATE_INPUT_REQUIRED, STATE_REJECTED, TurnTracker, a2aConversationsDir, extractText, listPersistedContexts, loadConversation, maxPingpongTurns, newContextId, newTaskId, persistMessage, textMessage, unwrapSendMessageResponse, type PersistedA2aMessage, } from "./protocol.js";
+export { loadA2aPeers, resolveA2aPeer, type A2aPeer, type A2aPeerAuth, type A2aPeerMap, } from "./peers.js";
+export { A2aClient, createA2aClient, type A2aCallResult, type A2aClientOptions, } from "./client.js";
+export { createA2aTools, type CreateA2aToolsOptions } from "./tools.js";
+export { buildA2aAgentCard, createA2aInboundHandler, parsePeerTokens, type A2aInboundOptions, } from "./inbound.js";
+//# sourceMappingURL=index.d.ts.map

package/node_modules/@xrkseek/a2a/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,oBAAoB,EACpB,SAAS,EACT,UAAU,EACV,eAAe,EACf,oBAAoB,EACpB,cAAc,EACd,WAAW,EACX,mBAAmB,EACnB,WAAW,EACX,qBAAqB,EACrB,gBAAgB,EAChB,gBAAgB,EAChB,YAAY,EACZ,SAAS,EACT,cAAc,EACd,WAAW,EACX,yBAAyB,EACzB,KAAK,mBAAmB,GACzB,MAAM,eAAe,CAAC;AAEvB,OAAO,EACL,YAAY,EACZ,cAAc,EACd,KAAK,OAAO,EACZ,KAAK,WAAW,EAChB,KAAK,UAAU,GAChB,MAAM,YAAY,CAAC;AAEpB,OAAO,EACL,SAAS,EACT,eAAe,EACf,KAAK,aAAa,EAClB,KAAK,gBAAgB,GACtB,MAAM,aAAa,CAAC;AAErB,OAAO,EAAE,cAAc,EAAE,KAAK,qBAAqB,EAAE,MAAM,YAAY,CAAC;AAExE,OAAO,EACL,iBAAiB,EACjB,uBAAuB,EACvB,eAAe,EACf,KAAK,iBAAiB,GACvB,MAAM,cAAc,CAAC"}

package/node_modules/@xrkseek/a2a/dist/index.js

@@ -0,0 +1,6 @@
+export { A2A_PROTOCOL_VERSION, ROLE_USER, ROLE_AGENT, STATE_COMPLETED, STATE_INPUT_REQUIRED, STATE_REJECTED, TurnTracker, a2aConversationsDir, extractText, listPersistedContexts, loadConversation, maxPingpongTurns, newContextId, newTaskId, persistMessage, textMessage, unwrapSendMessageResponse, } from "./protocol.js";
+export { loadA2aPeers, resolveA2aPeer, } from "./peers.js";
+export { A2aClient, createA2aClient, } from "./client.js";
+export { createA2aTools } from "./tools.js";
+export { buildA2aAgentCard, createA2aInboundHandler, parsePeerTokens, } from "./inbound.js";
+//# sourceMappingURL=index.js.map

package/node_modules/@xrkseek/a2a/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,oBAAoB,EACpB,SAAS,EACT,UAAU,EACV,eAAe,EACf,oBAAoB,EACpB,cAAc,EACd,WAAW,EACX,mBAAmB,EACnB,WAAW,EACX,qBAAqB,EACrB,gBAAgB,EAChB,gBAAgB,EAChB,YAAY,EACZ,SAAS,EACT,cAAc,EACd,WAAW,EACX,yBAAyB,GAE1B,MAAM,eAAe,CAAC;AAEvB,OAAO,EACL,YAAY,EACZ,cAAc,GAIf,MAAM,YAAY,CAAC;AAEpB,OAAO,EACL,SAAS,EACT,eAAe,GAGhB,MAAM,aAAa,CAAC;AAErB,OAAO,EAAE,cAAc,EAA8B,MAAM,YAAY,CAAC;AAExE,OAAO,EACL,iBAAiB,EACjB,uBAAuB,EACvB,eAAe,GAEhB,MAAM,cAAc,CAAC"}

package/node_modules/@xrkseek/a2a/dist/peers.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Resolve configured A2A peers from env (`XRK_A2A_AGENTS` JSON) or a home file.
+ */
+export interface A2aPeerAuth {
+    readonly type?: string;
+    readonly token?: string;
+}
+export interface A2aPeer {
+    readonly url: string;
+    readonly auth?: A2aPeerAuth;
+    readonly timeout?: number;
+    readonly capabilities?: readonly string[];
+    readonly tenant?: string;
+}
+export type A2aPeerMap = Readonly<Record<string, A2aPeer>>;
+/** Load peers from `XRK_A2A_AGENTS` or `{XRK_HOME}/a2a_agents.json`. */
+export declare function loadA2aPeers(env?: NodeJS.ProcessEnv): A2aPeerMap;
+/**
+ * Resolve a peer by configured name or accept a direct http(s) URL.
+ */
+export declare function resolveA2aPeer(agent: string, peers?: A2aPeerMap): {
+    readonly label: string;
+    readonly peer: A2aPeer;
+} | undefined;
+//# sourceMappingURL=peers.d.ts.map

package/node_modules/@xrkseek/a2a/dist/peers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"peers.d.ts","sourceRoot":"","sources":["../src/peers.ts"],"names":[],"mappings":"AAAA;;GAEG;AAMH,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,OAAO;IACtB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,IAAI,CAAC,EAAE,WAAW,CAAC;IAC5B,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,YAAY,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC1C,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,MAAM,UAAU,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;AAuD3D,wEAAwE;AACxE,wBAAgB,YAAY,CAAC,GAAG,GAAE,MAAM,CAAC,UAAwB,GAAG,UAAU,CAmB7E;AAED;;GAEG;AACH,wBAAgB,cAAc,CAC5B,KAAK,EAAE,MAAM,EACb,KAAK,GAAE,UAA2B,GACjC;IAAE,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAA;CAAE,GAAG,SAAS,CAShE"}

package/node_modules/@xrkseek/a2a/dist/peers.js

@@ -0,0 +1,90 @@
+/**
+ * Resolve configured A2A peers from env (`XRK_A2A_AGENTS` JSON) or a home file.
+ */
+import { readFileSync } from "node:fs";
+import path from "node:path";
+import { resolveXrkHome } from "@xrkseek/xrk-home-paths";
+function parsePeersJson(raw) {
+    const parsed = JSON.parse(raw);
+    if (parsed === null || typeof parsed !== "object" || Array.isArray(parsed)) {
+        throw new Error("XRK_A2A_AGENTS must be a JSON object of name → peer");
+    }
+    const out = {};
+    for (const [name, value] of Object.entries(parsed)) {
+        if (!name.trim() || value === null || typeof value !== "object")
+            continue;
+        const rec = value;
+        const url = typeof rec.url === "string" ? rec.url.trim() : "";
+        if (!url)
+            continue;
+        let auth;
+        if (rec.auth !== null && typeof rec.auth === "object") {
+            const authRaw = rec.auth;
+            const type = typeof authRaw.type === "string" && authRaw.type.trim()
+                ? authRaw.type.trim()
+                : undefined;
+            const token = typeof authRaw.token === "string" && authRaw.token.trim()
+                ? authRaw.token.trim()
+                : undefined;
+            if (type !== undefined || token !== undefined) {
+                auth = {
+                    ...(type !== undefined ? { type } : {}),
+                    ...(token !== undefined ? { token } : {}),
+                };
+            }
+        }
+        const capabilities = Array.isArray(rec.capabilities)
+            ? rec.capabilities.filter((c) => typeof c === "string")
+            : undefined;
+        const timeout = typeof rec.timeout === "number" ? rec.timeout : undefined;
+        const tenant = typeof rec.tenant === "string" && rec.tenant.trim()
+            ? rec.tenant.trim()
+            : undefined;
+        out[name.trim()] = {
+            url,
+            ...(timeout !== undefined ? { timeout } : {}),
+            ...(tenant !== undefined ? { tenant } : {}),
+            ...(capabilities !== undefined && capabilities.length > 0
+                ? { capabilities }
+                : {}),
+            ...(auth !== undefined ? { auth } : {}),
+        };
+    }
+    return out;
+}
+/** Load peers from `XRK_A2A_AGENTS` or `{XRK_HOME}/a2a_agents.json`. */
+export function loadA2aPeers(env = process.env) {
+    const inline = env.XRK_A2A_AGENTS?.trim();
+    if (inline) {
+        try {
+            return parsePeersJson(inline);
+        }
+        catch (err) {
+            throw new Error(`XRK_A2A_AGENTS: ${err instanceof Error ? err.message : String(err)}`);
+        }
+    }
+    const file = env.XRK_A2A_AGENTS_FILE?.trim() ||
+        path.join(resolveXrkHome(env), "a2a_agents.json");
+    try {
+        return parsePeersJson(readFileSync(file, "utf8"));
+    }
+    catch {
+        return {};
+    }
+}
+/**
+ * Resolve a peer by configured name or accept a direct http(s) URL.
+ */
+export function resolveA2aPeer(agent, peers = loadA2aPeers()) {
+    const key = agent.trim();
+    if (!key)
+        return undefined;
+    if (/^https?:\/\//i.test(key)) {
+        return { label: key, peer: { url: key } };
+    }
+    const peer = peers[key];
+    if (!peer?.url)
+        return undefined;
+    return { label: key, peer };
+}
+//# sourceMappingURL=peers.js.map

package/node_modules/@xrkseek/a2a/dist/peers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"peers.js","sourceRoot":"","sources":["../src/peers.ts"],"names":[],"mappings":"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"}

package/node_modules/@xrkseek/a2a/dist/protocol.d.ts

@@ -0,0 +1,45 @@
+/**
+ * A2A v1.0 wire helpers + conversation persistence + anti-loop turn tracker.
+ * Learned from Hermes `plugins/platforms/a2a/protocol.py` (stdlib-shaped).
+ */
+export declare const A2A_PROTOCOL_VERSION = "1.0";
+export declare const ROLE_USER = "ROLE_USER";
+export declare const ROLE_AGENT = "ROLE_AGENT";
+export declare const STATE_COMPLETED = "TASK_STATE_COMPLETED";
+export declare const STATE_INPUT_REQUIRED = "TASK_STATE_INPUT_REQUIRED";
+export declare const STATE_REJECTED = "TASK_STATE_REJECTED";
+export declare function newContextId(): string;
+export declare function newTaskId(): string;
+/** Anti-loop turn cap per context (`XRK_A2A_MAX_PINGPONG_TURNS`, hard max 20). */
+export declare function maxPingpongTurns(env?: NodeJS.ProcessEnv): number;
+export declare function textMessage(role: string, text: string, contextId?: string): Record<string, unknown>;
+export declare function extractText(node: unknown): string;
+export declare function unwrapSendMessageResponse(result: unknown): unknown;
+export interface PersistedA2aMessage {
+    readonly ts: number;
+    readonly role: string;
+    readonly text: string;
+    readonly task_id: string;
+}
+/** Counts turns per context_id; beyond {@link maxPingpongTurns} callers should reject. */
+export declare class TurnTracker {
+    private readonly turns;
+    track(contextId: string, now?: number): number;
+    reset(contextId: string): void;
+    peek(contextId: string): number;
+}
+export declare function a2aConversationsDir(env?: NodeJS.ProcessEnv): string;
+/** Append one message to the context's on-disk log. Never throws. */
+export declare function persistMessage(contextId: string, role: string, text: string, taskId?: string, options?: {
+    readonly root?: string;
+    readonly now?: number;
+}): void;
+/** Last `limit` messages for a context (empty if missing / unreadable). */
+export declare function loadConversation(contextId: string, limit?: number, options?: {
+    readonly root?: string;
+}): PersistedA2aMessage[];
+/** Context ids that have persisted conversations. */
+export declare function listPersistedContexts(options?: {
+    readonly root?: string;
+}): string[];
+//# sourceMappingURL=protocol.d.ts.map

package/node_modules/@xrkseek/a2a/dist/protocol.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"protocol.d.ts","sourceRoot":"","sources":["../src/protocol.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAOH,eAAO,MAAM,oBAAoB,QAAQ,CAAC;AAE1C,eAAO,MAAM,SAAS,cAAc,CAAC;AACrC,eAAO,MAAM,UAAU,eAAe,CAAC;AAEvC,eAAO,MAAM,eAAe,yBAAyB,CAAC;AACtD,eAAO,MAAM,oBAAoB,8BAA8B,CAAC;AAChE,eAAO,MAAM,cAAc,wBAAwB,CAAC;AAMpD,wBAAgB,YAAY,IAAI,MAAM,CAErC;AAED,wBAAgB,SAAS,IAAI,MAAM,CAElC;AASD,kFAAkF;AAClF,wBAAgB,gBAAgB,CAAC,GAAG,GAAE,MAAM,CAAC,UAAwB,GAAG,MAAM,CAG7E;AAED,wBAAgB,WAAW,CACzB,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EACZ,SAAS,SAAK,GACb,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAQzB;AAED,wBAAgB,WAAW,CAAC,IAAI,EAAE,OAAO,GAAG,MAAM,CAuBjD;AAED,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,OAAO,GAAG,OAAO,CAOlE;AAED,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B;AAED,0FAA0F;AAC1F,qBAAa,WAAW;IACtB,OAAO,CAAC,QAAQ,CAAC,KAAK,CAA0D;IAEhF,KAAK,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,SAAa,GAAG,MAAM;IAUlD,KAAK,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI;IAI9B,IAAI,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM;CAGhC;AAED,wBAAgB,mBAAmB,CACjC,GAAG,GAAE,MAAM,CAAC,UAAwB,GACnC,MAAM,CAIR;AAUD,qEAAqE;AACrE,wBAAgB,cAAc,CAC5B,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EACZ,MAAM,SAAK,EACX,OAAO,GAAE;IAAE,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAA;CAAO,GAC9D,IAAI,CAcN;AAED,2EAA2E;AAC3E,wBAAgB,gBAAgB,CAC9B,SAAS,EAAE,MAAM,EACjB,KAAK,SAAK,EACV,OAAO,GAAE;IAAE,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAO,GACvC,mBAAmB,EAAE,CAkBvB;AAED,qDAAqD;AACrD,wBAAgB,qBAAqB,CACnC,OAAO,GAAE;IAAE,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAO,GACvC,MAAM,EAAE,CAUV"}

package/node_modules/@xrkseek/a2a/dist/protocol.js

@@ -0,0 +1,172 @@
+/**
+ * A2A v1.0 wire helpers + conversation persistence + anti-loop turn tracker.
+ * Learned from Hermes `plugins/platforms/a2a/protocol.py` (stdlib-shaped).
+ */
+import { appendFileSync, mkdirSync, readdirSync, readFileSync } from "node:fs";
+import path from "node:path";
+import { randomUUID } from "node:crypto";
+import { resolveXrkHome } from "@xrkseek/xrk-home-paths";
+export const A2A_PROTOCOL_VERSION = "1.0";
+export const ROLE_USER = "ROLE_USER";
+export const ROLE_AGENT = "ROLE_AGENT";
+export const STATE_COMPLETED = "TASK_STATE_COMPLETED";
+export const STATE_INPUT_REQUIRED = "TASK_STATE_INPUT_REQUIRED";
+export const STATE_REJECTED = "TASK_STATE_REJECTED";
+const DEFAULT_MAX_PINGPONG = 5;
+const HARD_MAX_PINGPONG = 20;
+const TURN_TTL_MS = 60 * 60 * 1000;
+export function newContextId() {
+    return `ctx_${randomUUID().replace(/-/g, "")}`;
+}
+export function newTaskId() {
+    return `task_${randomUUID().replace(/-/g, "")}`;
+}
+function envInt(name, fallback, env) {
+    const raw = env[name]?.trim();
+    if (!raw)
+        return fallback;
+    const n = Number(raw);
+    return Number.isFinite(n) ? Math.trunc(n) : fallback;
+}
+/** Anti-loop turn cap per context (`XRK_A2A_MAX_PINGPONG_TURNS`, hard max 20). */
+export function maxPingpongTurns(env = process.env) {
+    const v = envInt("XRK_A2A_MAX_PINGPONG_TURNS", DEFAULT_MAX_PINGPONG, env);
+    return Math.max(1, Math.min(v, HARD_MAX_PINGPONG));
+}
+export function textMessage(role, text, contextId = "") {
+    const msg = {
+        role,
+        parts: [{ text }],
+        messageId: `msg_${randomUUID().replace(/-/g, "")}`,
+    };
+    if (contextId)
+        msg.contextId = contextId;
+    return msg;
+}
+export function extractText(node) {
+    if (node === null || node === undefined)
+        return "";
+    if (typeof node === "string")
+        return node;
+    if (typeof node !== "object")
+        return String(node);
+    const rec = node;
+    if (typeof rec.text === "string")
+        return rec.text;
+    if (Array.isArray(rec.parts)) {
+        return rec.parts
+            .map((p) => extractText(p))
+            .filter(Boolean)
+            .join("\n");
+    }
+    if (rec.message)
+        return extractText(rec.message);
+    if (Array.isArray(rec.artifacts)) {
+        for (const a of rec.artifacts) {
+            const t = extractText(a);
+            if (t)
+                return t;
+        }
+    }
+    if (rec.status && typeof rec.status === "object") {
+        return extractText(rec.status.message);
+    }
+    return "";
+}
+export function unwrapSendMessageResponse(result) {
+    if (result !== null && typeof result === "object") {
+        const rec = result;
+        if (rec.task && typeof rec.task === "object")
+            return rec.task;
+        if (rec.message && typeof rec.message === "object")
+            return rec.message;
+    }
+    return result;
+}
+/** Counts turns per context_id; beyond {@link maxPingpongTurns} callers should reject. */
+export class TurnTracker {
+    turns = new Map();
+    track(contextId, now = Date.now()) {
+        for (const [cid, v] of this.turns) {
+            if (now - v.lastSeen > TURN_TTL_MS)
+                this.turns.delete(cid);
+        }
+        const prev = this.turns.get(contextId);
+        const count = (prev?.count ?? 0) + 1;
+        this.turns.set(contextId, { count, lastSeen: now });
+        return count;
+    }
+    reset(contextId) {
+        this.turns.delete(contextId);
+    }
+    peek(contextId) {
+        return this.turns.get(contextId)?.count ?? 0;
+    }
+}
+export function a2aConversationsDir(env = process.env) {
+    const override = env.XRK_A2A_CONVERSATIONS_DIR?.trim();
+    if (override)
+        return path.resolve(override);
+    return path.join(resolveXrkHome(env), "a2a_conversations");
+}
+function convPath(contextId, root) {
+    const safe = [...(contextId || "default")]
+        .filter((c) => /[a-zA-Z0-9_-]/.test(c))
+        .join("") || "default";
+    return path.join(root, `${safe}.jsonl`);
+}
+/** Append one message to the context's on-disk log. Never throws. */
+export function persistMessage(contextId, role, text, taskId = "", options = {}) {
+    try {
+        const root = options.root ?? a2aConversationsDir();
+        mkdirSync(root, { recursive: true });
+        const row = {
+            ts: options.now ?? Date.now() / 1000,
+            role,
+            text,
+            task_id: taskId,
+        };
+        appendFileSync(convPath(contextId, root), `${JSON.stringify(row)}\n`, "utf8");
+    }
+    catch {
+        // Persistence must not break the live call path.
+    }
+}
+/** Last `limit` messages for a context (empty if missing / unreadable). */
+export function loadConversation(contextId, limit = 50, options = {}) {
+    try {
+        const root = options.root ?? a2aConversationsDir();
+        const raw = readFileSync(convPath(contextId, root), "utf8");
+        const out = [];
+        for (const line of raw.split(/\r?\n/)) {
+            if (!line.trim())
+                continue;
+            try {
+                const entry = JSON.parse(line);
+                if (entry && typeof entry.text === "string")
+                    out.push(entry);
+            }
+            catch {
+                /* skip corrupt line */
+            }
+        }
+        return out.slice(-Math.max(1, limit));
+    }
+    catch {
+        return [];
+    }
+}
+/** Context ids that have persisted conversations. */
+export function listPersistedContexts(options = {}) {
+    try {
+        const root = options.root ?? a2aConversationsDir();
+        return readdirSync(root)
+            .filter((n) => n.endsWith(".jsonl"))
+            .map((n) => n.slice(0, -".jsonl".length))
+            .sort();
+    }
+    catch {
+        return [];
+    }
+}
+//# sourceMappingURL=protocol.js.map