@evalops/maestro 0.10.18 → 0.10.21

package/dist/platform/a2a-peer-registry.js

@@ -0,0 +1,320 @@
+import { mkdir, readFile, rename, writeFile } from "node:fs/promises";
+import { homedir } from "node:os";
+import { dirname, join, resolve } from "node:path";
+import { normalizeA2ABaseUrl } from "./a2a-client.js";
+import { a2aPeerConnectionFromPairingPayload, } from "./a2a-peer-pairing.js";
+import { getEnvValue, trimString } from "./client.js";
+const DEFAULT_TIMEOUT_MS = 600_000;
+const DEFAULT_MAX_ATTEMPTS = 1;
+export function getA2APeerRegistryPath(path) {
+    const configured = trimString(path) ??
+        getEnvValue(["MAESTRO_A2A_PEERS_FILE", "CODEX_A2A_PEERS_FILE"]);
+    if (configured) {
+        return expandHome(configured);
+    }
+    return join(homedir(), ".maestro", "a2a", "peers.json");
+}
+export async function loadA2APeerRegistry(options = {}) {
+    const path = getA2APeerRegistryPath(options.path);
+    let raw;
+    try {
+        raw = await readFile(path, "utf8");
+    }
+    catch (error) {
+        if (hasNodeCode(error, "ENOENT")) {
+            return { peers: {} };
+        }
+        throw error;
+    }
+    const parsed = JSON.parse(raw);
+    if (!isRecord(parsed)) {
+        throw new Error(`A2A peer registry at ${path} must be a JSON object`);
+    }
+    const peers = isRecord(parsed.peers) ? parsed.peers : {};
+    const registry = {
+        peers: Object.fromEntries(Object.entries(peers).map(([name, value]) => [
+            name,
+            normalizeRegistryEntry(value, `peers.${name}`),
+        ])),
+    };
+    if (typeof parsed.defaultPeer === "string" && parsed.defaultPeer.trim()) {
+        registry.defaultPeer = parsed.defaultPeer.trim();
+    }
+    if (typeof parsed.timeoutMs === "number" && parsed.timeoutMs > 0) {
+        registry.timeoutMs = parsed.timeoutMs;
+    }
+    if (typeof parsed.maxAttempts === "number" && parsed.maxAttempts > 0) {
+        registry.maxAttempts = parsed.maxAttempts;
+    }
+    return registry;
+}
+export async function saveA2APeerRegistry(registry, options = {}) {
+    const path = getA2APeerRegistryPath(options.path);
+    await mkdir(dirname(path), { recursive: true, mode: 0o700 });
+    await writeFile(`${path}.tmp`, `${JSON.stringify(registry, null, 2)}\n`, {
+        mode: 0o600,
+    });
+    await rename(`${path}.tmp`, path);
+    return path;
+}
+export async function upsertA2APeerFromPairingPayload(payload, options = {}) {
+    const registry = await loadA2APeerRegistry(options);
+    const connection = a2aPeerConnectionFromPairingPayload(payload);
+    const name = normalizePeerName(options.name ?? connection.peerId);
+    const now = (options.now ?? new Date()).toISOString();
+    const previous = registry.peers[name];
+    const { tokenEnv: previousTokenEnv, tokenFile: previousTokenFile, ...previousFields } = previous ?? {};
+    const entry = {
+        ...previousFields,
+        url: connection.baseUrl,
+        displayName: connection.displayName,
+        agentCardUrl: connection.agentCardUrl,
+        protocolBinding: connection.protocolBinding,
+        protocolVersion: connection.protocolVersion,
+        ...resolveUpsertTokenFields({
+            previousTokenEnv,
+            previousTokenFile,
+            tokenEnv: options.tokenEnv,
+            tokenFile: options.tokenFile,
+        }),
+        ...(options.organizationId
+            ? { organizationId: options.organizationId }
+            : {}),
+        ...(options.workspaceId ? { workspaceId: options.workspaceId } : {}),
+        ...(connection.capabilities
+            ? { capabilities: connection.capabilities }
+            : {}),
+        ...(connection.skills ? { skills: connection.skills } : {}),
+        ...(connection.keyFingerprint
+            ? { keyFingerprint: connection.keyFingerprint }
+            : {}),
+        ...(connection.metadata ? { metadata: connection.metadata } : {}),
+        createdAt: previous?.createdAt ?? now,
+        updatedAt: now,
+    };
+    registry.peers[name] = entry;
+    if (options.makeDefault || !registry.defaultPeer) {
+        registry.defaultPeer = name;
+    }
+    const path = await saveA2APeerRegistry(registry, options);
+    return { name, entry, path };
+}
+export async function listA2APeers(options = {}) {
+    return {
+        path: getA2APeerRegistryPath(options.path),
+        registry: await loadA2APeerRegistry(options),
+    };
+}
+export async function resolveA2APeer(name, options = {}) {
+    const registry = await loadA2APeerRegistry(options);
+    const resolvedName = normalizePeerName(name ?? registry.defaultPeer);
+    const entry = registry.peers[resolvedName];
+    if (!entry) {
+        throw new Error(`Unknown A2A peer "${resolvedName}". Run "maestro a2a peers" to list registered peers.`);
+    }
+    const token = options.token ?? (await resolvePeerToken(entry));
+    const config = {
+        baseUrl: normalizeA2ABaseUrl(entry.url),
+        ...(token ? { token } : {}),
+        ...(entry.organizationId ? { organizationId: entry.organizationId } : {}),
+        ...(entry.workspaceId ? { workspaceId: entry.workspaceId } : {}),
+        ...(entry.agentId ? { agentId: entry.agentId } : { agentId: "maestro" }),
+        ...(entry.sessionId ? { sessionId: entry.sessionId } : {}),
+        ...(entry.actorId ? { actorId: entry.actorId } : {}),
+        timeoutMs: options.timeoutMs ??
+            entry.timeoutMs ??
+            registry.timeoutMs ??
+            DEFAULT_TIMEOUT_MS,
+        maxAttempts: options.maxAttempts ??
+            entry.maxAttempts ??
+            registry.maxAttempts ??
+            DEFAULT_MAX_ATTEMPTS,
+    };
+    return { name: resolvedName, entry, config };
+}
+export async function resolvePeerToken(entry) {
+    if (entry.tokenEnv) {
+        const envToken = trimString(process.env[entry.tokenEnv]);
+        if (envToken) {
+            return envToken;
+        }
+    }
+    if (entry.tokenFile) {
+        return trimString(await readFile(expandHome(entry.tokenFile), "utf8"));
+    }
+    return undefined;
+}
+export function normalizePeerName(name) {
+    const normalized = name?.trim();
+    if (!normalized) {
+        throw new Error("A2A peer name is required");
+    }
+    if (!/^[A-Za-z0-9_.-]{1,80}$/u.test(normalized)) {
+        throw new Error("A2A peer names may only contain letters, numbers, dots, underscores, and dashes");
+    }
+    return normalized;
+}
+function resolveUpsertTokenFields(input) {
+    const tokenEnv = trimString(input.tokenEnv);
+    const tokenFile = trimString(input.tokenFile);
+    if (tokenEnv && tokenFile) {
+        return { tokenEnv, tokenFile: expandHome(tokenFile) };
+    }
+    if (tokenEnv) {
+        return { tokenEnv };
+    }
+    if (tokenFile) {
+        return { tokenFile: expandHome(tokenFile) };
+    }
+    return {
+        ...(input.previousTokenEnv ? { tokenEnv: input.previousTokenEnv } : {}),
+        ...(input.previousTokenFile ? { tokenFile: input.previousTokenFile } : {}),
+    };
+}
+function normalizeRegistryEntry(input, label) {
+    if (!isRecord(input)) {
+        throw new Error(`${label} must be an object`);
+    }
+    const url = typeof input.url === "string" ? input.url.trim() : "";
+    if (!url) {
+        throw new Error(`${label}.url is required`);
+    }
+    return {
+        url,
+        ...copyString(input, "displayName"),
+        ...copyString(input, "agentCardUrl"),
+        ...copyString(input, "protocolBinding"),
+        ...copyString(input, "protocolVersion"),
+        ...copyString(input, "tokenEnv"),
+        ...copyString(input, "tokenFile"),
+        ...copyString(input, "organizationId"),
+        ...copyString(input, "workspaceId"),
+        ...copyString(input, "agentId"),
+        ...copyString(input, "sessionId"),
+        ...copyString(input, "actorId"),
+        ...(typeof input.timeoutMs === "number" && input.timeoutMs > 0
+            ? { timeoutMs: input.timeoutMs }
+            : {}),
+        ...(typeof input.maxAttempts === "number" && input.maxAttempts > 0
+            ? { maxAttempts: input.maxAttempts }
+            : {}),
+        ...(isRecord(input.capabilities)
+            ? {
+                capabilities: {
+                    ...(typeof input.capabilities.streaming === "boolean"
+                        ? { streaming: input.capabilities.streaming }
+                        : {}),
+                    ...(typeof input.capabilities.pushNotifications === "boolean"
+                        ? { pushNotifications: input.capabilities.pushNotifications }
+                        : {}),
+                    ...(typeof input.capabilities.extendedAgentCard === "boolean"
+                        ? { extendedAgentCard: input.capabilities.extendedAgentCard }
+                        : {}),
+                },
+            }
+            : {}),
+        ...(Array.isArray(input.skills)
+            ? { skills: normalizeRegistrySkills(input.skills) }
+            : {}),
+        ...copyString(input, "keyFingerprint"),
+        ...(isRecord(input.metadata)
+            ? {
+                metadata: input.metadata,
+            }
+            : {}),
+        ...copyString(input, "createdAt"),
+        ...copyString(input, "updatedAt"),
+    };
+}
+function normalizeRegistrySkills(input) {
+    return input
+        .filter(isRecord)
+        .map((skill) => ({
+        id: typeof skill.id === "string" ? skill.id : "",
+        name: typeof skill.name === "string" ? skill.name : "",
+        ...copyString(skill, "description"),
+        ...copyStringList(skill, "tags"),
+        ...copyStringList(skill, "examples"),
+        ...copyStringList(skill, "inputModes"),
+        ...copyStringList(skill, "outputModes"),
+        ...copyStringList(skill, "requiredContextGrants"),
+        ...copyString(skill, "approvalPolicyRef"),
+        ...copyString(skill, "maxAutonomy"),
+        ...copyStringList(skill, "requiredArtifactKinds"),
+        ...copyStringList(skill, "optionalArtifactKinds"),
+        ...copyStringList(skill, "allowedTaskClasses"),
+        ...copyStringList(skill, "deniedTaskClasses"),
+        ...copyStringRecord(skill, "attributes"),
+        ...copyPrimitiveRecord(skill, "metadata"),
+    }))
+        .filter((skill) => skill.id.trim() && skill.name.trim());
+}
+function copyStringList(input, key) {
+    const value = input[key];
+    if (!Array.isArray(value)) {
+        return {};
+    }
+    const strings = value
+        .filter((item) => typeof item === "string")
+        .map((item) => item.trim())
+        .filter(Boolean);
+    return strings.length > 0 ? { [key]: strings } : {};
+}
+function copyStringRecord(input, key) {
+    const value = input[key];
+    if (!isRecord(value)) {
+        return {};
+    }
+    const entries = Object.entries(value)
+        .map(([entryKey, entryValue]) => [
+        entryKey.trim(),
+        typeof entryValue === "string" ? entryValue.trim() : "",
+    ])
+        .filter((entry) => Boolean(entry[0]) && Boolean(entry[1]));
+    return entries.length > 0 ? { [key]: Object.fromEntries(entries) } : {};
+}
+function copyPrimitiveRecord(input, key) {
+    const value = input[key];
+    if (!isRecord(value)) {
+        return {};
+    }
+    const output = {};
+    for (const [entryKey, entryValue] of Object.entries(value)) {
+        const normalizedKey = entryKey.trim();
+        if (!normalizedKey) {
+            continue;
+        }
+        if (typeof entryValue === "string" ||
+            typeof entryValue === "number" ||
+            typeof entryValue === "boolean") {
+            output[normalizedKey] =
+                typeof entryValue === "string" ? entryValue.trim() : entryValue;
+        }
+    }
+    return Object.keys(output).length > 0 ? { [key]: output } : {};
+}
+function copyString(input, key) {
+    const value = input[key];
+    return typeof value === "string" && value.trim()
+        ? { [key]: value.trim() }
+        : {};
+}
+function expandHome(path) {
+    if (path === "~") {
+        return homedir();
+    }
+    if (path.startsWith("~/")) {
+        return resolve(homedir(), path.slice(2));
+    }
+    return resolve(path);
+}
+function isRecord(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function hasNodeCode(error, code) {
+    return (typeof error === "object" &&
+        error !== null &&
+        "code" in error &&
+        error.code === code);
+}
+//# sourceMappingURL=a2a-peer-registry.js.map

package/dist/platform/a2a-peer-registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"a2a-peer-registry.js","sourceRoot":"","sources":["../../src/platform/a2a-peer-registry.ts"],"names":[],"mappings":"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","sourcesContent":["import { mkdir, readFile, rename, writeFile } from \"node:fs/promises\";\nimport { homedir } from \"node:os\";\nimport { dirname, join, resolve } from \"node:path\";\nimport { type A2AServiceConfig, normalizeA2ABaseUrl } from \"./a2a-client.js\";\nimport {\n\ttype A2APeerConnection,\n\ttype A2APeerPairingPayload,\n\ta2aPeerConnectionFromPairingPayload,\n} from \"./a2a-peer-pairing.js\";\nimport { getEnvValue, trimString } from \"./client.js\";\n\nconst DEFAULT_TIMEOUT_MS = 600_000;\nconst DEFAULT_MAX_ATTEMPTS = 1;\n\nexport interface A2APeerRegistryEntry {\n\turl: string;\n\tdisplayName?: string;\n\tagentCardUrl?: string;\n\tprotocolBinding?: string;\n\tprotocolVersion?: string;\n\ttokenEnv?: string;\n\ttokenFile?: string;\n\torganizationId?: string;\n\tworkspaceId?: string;\n\tagentId?: string;\n\tsessionId?: string;\n\tactorId?: string;\n\ttimeoutMs?: number;\n\tmaxAttempts?: number;\n\tcapabilities?: A2APeerConnection[\"capabilities\"];\n\tskills?: A2APeerConnection[\"skills\"];\n\tkeyFingerprint?: string;\n\tmetadata?: Record<string, string | number | boolean>;\n\tcreatedAt?: string;\n\tupdatedAt?: string;\n}\n\nexport interface A2APeerRegistryFile {\n\tdefaultPeer?: string;\n\ttimeoutMs?: number;\n\tmaxAttempts?: number;\n\tpeers: Record<string, A2APeerRegistryEntry>;\n}\n\nexport interface A2APeerRegistryOptions {\n\tpath?: string;\n\tnow?: Date;\n}\n\nexport interface UpsertA2APeerOptions extends A2APeerRegistryOptions {\n\tname?: string;\n\tmakeDefault?: boolean;\n\ttokenEnv?: string;\n\ttokenFile?: string;\n\tworkspaceId?: string;\n\torganizationId?: string;\n}\n\nexport interface ResolveA2APeerOptions extends A2APeerRegistryOptions {\n\ttoken?: string;\n\ttimeoutMs?: number;\n\tmaxAttempts?: number;\n}\n\nexport interface ResolvedA2APeer {\n\tname: string;\n\tentry: A2APeerRegistryEntry;\n\tconfig: A2AServiceConfig;\n}\n\nexport function getA2APeerRegistryPath(path?: string): string {\n\tconst configured =\n\t\ttrimString(path) ??\n\t\tgetEnvValue([\"MAESTRO_A2A_PEERS_FILE\", \"CODEX_A2A_PEERS_FILE\"]);\n\tif (configured) {\n\t\treturn expandHome(configured);\n\t}\n\treturn join(homedir(), \".maestro\", \"a2a\", \"peers.json\");\n}\n\nexport async function loadA2APeerRegistry(\n\toptions: A2APeerRegistryOptions = {},\n): Promise<A2APeerRegistryFile> {\n\tconst path = getA2APeerRegistryPath(options.path);\n\tlet raw: string;\n\ttry {\n\t\traw = await readFile(path, \"utf8\");\n\t} catch (error) {\n\t\tif (hasNodeCode(error, \"ENOENT\")) {\n\t\t\treturn { peers: {} };\n\t\t}\n\t\tthrow error;\n\t}\n\tconst parsed = JSON.parse(raw) as unknown;\n\tif (!isRecord(parsed)) {\n\t\tthrow new Error(`A2A peer registry at ${path} must be a JSON object`);\n\t}\n\tconst peers = isRecord(parsed.peers) ? parsed.peers : {};\n\tconst registry: A2APeerRegistryFile = {\n\t\tpeers: Object.fromEntries(\n\t\t\tObject.entries(peers).map(([name, value]) => [\n\t\t\t\tname,\n\t\t\t\tnormalizeRegistryEntry(value, `peers.${name}`),\n\t\t\t]),\n\t\t),\n\t};\n\tif (typeof parsed.defaultPeer === \"string\" && parsed.defaultPeer.trim()) {\n\t\tregistry.defaultPeer = parsed.defaultPeer.trim();\n\t}\n\tif (typeof parsed.timeoutMs === \"number\" && parsed.timeoutMs > 0) {\n\t\tregistry.timeoutMs = parsed.timeoutMs;\n\t}\n\tif (typeof parsed.maxAttempts === \"number\" && parsed.maxAttempts > 0) {\n\t\tregistry.maxAttempts = parsed.maxAttempts;\n\t}\n\treturn registry;\n}\n\nexport async function saveA2APeerRegistry(\n\tregistry: A2APeerRegistryFile,\n\toptions: A2APeerRegistryOptions = {},\n): Promise<string> {\n\tconst path = getA2APeerRegistryPath(options.path);\n\tawait mkdir(dirname(path), { recursive: true, mode: 0o700 });\n\tawait writeFile(`${path}.tmp`, `${JSON.stringify(registry, null, 2)}\\n`, {\n\t\tmode: 0o600,\n\t});\n\tawait rename(`${path}.tmp`, path);\n\treturn path;\n}\n\nexport async function upsertA2APeerFromPairingPayload(\n\tpayload: A2APeerPairingPayload,\n\toptions: UpsertA2APeerOptions = {},\n): Promise<{\n\tname: string;\n\tentry: A2APeerRegistryEntry;\n\tpath: string;\n}> {\n\tconst registry = await loadA2APeerRegistry(options);\n\tconst connection = a2aPeerConnectionFromPairingPayload(payload);\n\tconst name = normalizePeerName(options.name ?? connection.peerId);\n\tconst now = (options.now ?? new Date()).toISOString();\n\tconst previous = registry.peers[name];\n\tconst {\n\t\ttokenEnv: previousTokenEnv,\n\t\ttokenFile: previousTokenFile,\n\t\t...previousFields\n\t} = previous ?? {};\n\tconst entry: A2APeerRegistryEntry = {\n\t\t...previousFields,\n\t\turl: connection.baseUrl,\n\t\tdisplayName: connection.displayName,\n\t\tagentCardUrl: connection.agentCardUrl,\n\t\tprotocolBinding: connection.protocolBinding,\n\t\tprotocolVersion: connection.protocolVersion,\n\t\t...resolveUpsertTokenFields({\n\t\t\tpreviousTokenEnv,\n\t\t\tpreviousTokenFile,\n\t\t\ttokenEnv: options.tokenEnv,\n\t\t\ttokenFile: options.tokenFile,\n\t\t}),\n\t\t...(options.organizationId\n\t\t\t? { organizationId: options.organizationId }\n\t\t\t: {}),\n\t\t...(options.workspaceId ? { workspaceId: options.workspaceId } : {}),\n\t\t...(connection.capabilities\n\t\t\t? { capabilities: connection.capabilities }\n\t\t\t: {}),\n\t\t...(connection.skills ? { skills: connection.skills } : {}),\n\t\t...(connection.keyFingerprint\n\t\t\t? { keyFingerprint: connection.keyFingerprint }\n\t\t\t: {}),\n\t\t...(connection.metadata ? { metadata: connection.metadata } : {}),\n\t\tcreatedAt: previous?.createdAt ?? now,\n\t\tupdatedAt: now,\n\t};\n\tregistry.peers[name] = entry;\n\tif (options.makeDefault || !registry.defaultPeer) {\n\t\tregistry.defaultPeer = name;\n\t}\n\tconst path = await saveA2APeerRegistry(registry, options);\n\treturn { name, entry, path };\n}\n\nexport async function listA2APeers(\n\toptions: A2APeerRegistryOptions = {},\n): Promise<{\n\tpath: string;\n\tregistry: A2APeerRegistryFile;\n}> {\n\treturn {\n\t\tpath: getA2APeerRegistryPath(options.path),\n\t\tregistry: await loadA2APeerRegistry(options),\n\t};\n}\n\nexport async function resolveA2APeer(\n\tname: string | undefined,\n\toptions: ResolveA2APeerOptions = {},\n): Promise<ResolvedA2APeer> {\n\tconst registry = await loadA2APeerRegistry(options);\n\tconst resolvedName = normalizePeerName(name ?? registry.defaultPeer);\n\tconst entry = registry.peers[resolvedName];\n\tif (!entry) {\n\t\tthrow new Error(\n\t\t\t`Unknown A2A peer \"${resolvedName}\". Run \"maestro a2a peers\" to list registered peers.`,\n\t\t);\n\t}\n\tconst token = options.token ?? (await resolvePeerToken(entry));\n\tconst config: A2AServiceConfig = {\n\t\tbaseUrl: normalizeA2ABaseUrl(entry.url),\n\t\t...(token ? { token } : {}),\n\t\t...(entry.organizationId ? { organizationId: entry.organizationId } : {}),\n\t\t...(entry.workspaceId ? { workspaceId: entry.workspaceId } : {}),\n\t\t...(entry.agentId ? { agentId: entry.agentId } : { agentId: \"maestro\" }),\n\t\t...(entry.sessionId ? { sessionId: entry.sessionId } : {}),\n\t\t...(entry.actorId ? { actorId: entry.actorId } : {}),\n\t\ttimeoutMs:\n\t\t\toptions.timeoutMs ??\n\t\t\tentry.timeoutMs ??\n\t\t\tregistry.timeoutMs ??\n\t\t\tDEFAULT_TIMEOUT_MS,\n\t\tmaxAttempts:\n\t\t\toptions.maxAttempts ??\n\t\t\tentry.maxAttempts ??\n\t\t\tregistry.maxAttempts ??\n\t\t\tDEFAULT_MAX_ATTEMPTS,\n\t};\n\treturn { name: resolvedName, entry, config };\n}\n\nexport async function resolvePeerToken(\n\tentry: Pick<A2APeerRegistryEntry, \"tokenEnv\" | \"tokenFile\">,\n): Promise<string | undefined> {\n\tif (entry.tokenEnv) {\n\t\tconst envToken = trimString(process.env[entry.tokenEnv]);\n\t\tif (envToken) {\n\t\t\treturn envToken;\n\t\t}\n\t}\n\tif (entry.tokenFile) {\n\t\treturn trimString(await readFile(expandHome(entry.tokenFile), \"utf8\"));\n\t}\n\treturn undefined;\n}\n\nexport function normalizePeerName(name: string | undefined): string {\n\tconst normalized = name?.trim();\n\tif (!normalized) {\n\t\tthrow new Error(\"A2A peer name is required\");\n\t}\n\tif (!/^[A-Za-z0-9_.-]{1,80}$/u.test(normalized)) {\n\t\tthrow new Error(\n\t\t\t\"A2A peer names may only contain letters, numbers, dots, underscores, and dashes\",\n\t\t);\n\t}\n\treturn normalized;\n}\n\nfunction resolveUpsertTokenFields(input: {\n\tpreviousTokenEnv?: string;\n\tpreviousTokenFile?: string;\n\ttokenEnv?: string;\n\ttokenFile?: string;\n}): Pick<A2APeerRegistryEntry, \"tokenEnv\" | \"tokenFile\"> {\n\tconst tokenEnv = trimString(input.tokenEnv);\n\tconst tokenFile = trimString(input.tokenFile);\n\tif (tokenEnv && tokenFile) {\n\t\treturn { tokenEnv, tokenFile: expandHome(tokenFile) };\n\t}\n\tif (tokenEnv) {\n\t\treturn { tokenEnv };\n\t}\n\tif (tokenFile) {\n\t\treturn { tokenFile: expandHome(tokenFile) };\n\t}\n\treturn {\n\t\t...(input.previousTokenEnv ? { tokenEnv: input.previousTokenEnv } : {}),\n\t\t...(input.previousTokenFile ? { tokenFile: input.previousTokenFile } : {}),\n\t};\n}\n\nfunction normalizeRegistryEntry(\n\tinput: unknown,\n\tlabel: string,\n): A2APeerRegistryEntry {\n\tif (!isRecord(input)) {\n\t\tthrow new Error(`${label} must be an object`);\n\t}\n\tconst url = typeof input.url === \"string\" ? input.url.trim() : \"\";\n\tif (!url) {\n\t\tthrow new Error(`${label}.url is required`);\n\t}\n\treturn {\n\t\turl,\n\t\t...copyString(input, \"displayName\"),\n\t\t...copyString(input, \"agentCardUrl\"),\n\t\t...copyString(input, \"protocolBinding\"),\n\t\t...copyString(input, \"protocolVersion\"),\n\t\t...copyString(input, \"tokenEnv\"),\n\t\t...copyString(input, \"tokenFile\"),\n\t\t...copyString(input, \"organizationId\"),\n\t\t...copyString(input, \"workspaceId\"),\n\t\t...copyString(input, \"agentId\"),\n\t\t...copyString(input, \"sessionId\"),\n\t\t...copyString(input, \"actorId\"),\n\t\t...(typeof input.timeoutMs === \"number\" && input.timeoutMs > 0\n\t\t\t? { timeoutMs: input.timeoutMs }\n\t\t\t: {}),\n\t\t...(typeof input.maxAttempts === \"number\" && input.maxAttempts > 0\n\t\t\t? { maxAttempts: input.maxAttempts }\n\t\t\t: {}),\n\t\t...(isRecord(input.capabilities)\n\t\t\t? {\n\t\t\t\t\tcapabilities: {\n\t\t\t\t\t\t...(typeof input.capabilities.streaming === \"boolean\"\n\t\t\t\t\t\t\t? { streaming: input.capabilities.streaming }\n\t\t\t\t\t\t\t: {}),\n\t\t\t\t\t\t...(typeof input.capabilities.pushNotifications === \"boolean\"\n\t\t\t\t\t\t\t? { pushNotifications: input.capabilities.pushNotifications }\n\t\t\t\t\t\t\t: {}),\n\t\t\t\t\t\t...(typeof input.capabilities.extendedAgentCard === \"boolean\"\n\t\t\t\t\t\t\t? { extendedAgentCard: input.capabilities.extendedAgentCard }\n\t\t\t\t\t\t\t: {}),\n\t\t\t\t\t},\n\t\t\t\t}\n\t\t\t: {}),\n\t\t...(Array.isArray(input.skills)\n\t\t\t? { skills: normalizeRegistrySkills(input.skills) }\n\t\t\t: {}),\n\t\t...copyString(input, \"keyFingerprint\"),\n\t\t...(isRecord(input.metadata)\n\t\t\t? {\n\t\t\t\t\tmetadata: input.metadata as Record<string, string | number | boolean>,\n\t\t\t\t}\n\t\t\t: {}),\n\t\t...copyString(input, \"createdAt\"),\n\t\t...copyString(input, \"updatedAt\"),\n\t};\n}\n\nfunction normalizeRegistrySkills(\n\tinput: readonly unknown[],\n): A2APeerConnection[\"skills\"] {\n\treturn input\n\t\t.filter(isRecord)\n\t\t.map((skill) => ({\n\t\t\tid: typeof skill.id === \"string\" ? skill.id : \"\",\n\t\t\tname: typeof skill.name === \"string\" ? skill.name : \"\",\n\t\t\t...copyString(skill, \"description\"),\n\t\t\t...copyStringList(skill, \"tags\"),\n\t\t\t...copyStringList(skill, \"examples\"),\n\t\t\t...copyStringList(skill, \"inputModes\"),\n\t\t\t...copyStringList(skill, \"outputModes\"),\n\t\t\t...copyStringList(skill, \"requiredContextGrants\"),\n\t\t\t...copyString(skill, \"approvalPolicyRef\"),\n\t\t\t...copyString(skill, \"maxAutonomy\"),\n\t\t\t...copyStringList(skill, \"requiredArtifactKinds\"),\n\t\t\t...copyStringList(skill, \"optionalArtifactKinds\"),\n\t\t\t...copyStringList(skill, \"allowedTaskClasses\"),\n\t\t\t...copyStringList(skill, \"deniedTaskClasses\"),\n\t\t\t...copyStringRecord(skill, \"attributes\"),\n\t\t\t...copyPrimitiveRecord(skill, \"metadata\"),\n\t\t}))\n\t\t.filter((skill) => skill.id.trim() && skill.name.trim());\n}\n\nfunction copyStringList(\n\tinput: Record<string, unknown>,\n\tkey: string,\n): Record<string, string[]> {\n\tconst value = input[key];\n\tif (!Array.isArray(value)) {\n\t\treturn {};\n\t}\n\tconst strings = value\n\t\t.filter((item): item is string => typeof item === \"string\")\n\t\t.map((item) => item.trim())\n\t\t.filter(Boolean);\n\treturn strings.length > 0 ? { [key]: strings } : {};\n}\n\nfunction copyStringRecord(\n\tinput: Record<string, unknown>,\n\tkey: string,\n): Record<string, Record<string, string>> {\n\tconst value = input[key];\n\tif (!isRecord(value)) {\n\t\treturn {};\n\t}\n\tconst entries = Object.entries(value)\n\t\t.map(([entryKey, entryValue]) => [\n\t\t\tentryKey.trim(),\n\t\t\ttypeof entryValue === \"string\" ? entryValue.trim() : \"\",\n\t\t])\n\t\t.filter(\n\t\t\t(entry): entry is [string, string] =>\n\t\t\t\tBoolean(entry[0]) && Boolean(entry[1]),\n\t\t);\n\treturn entries.length > 0 ? { [key]: Object.fromEntries(entries) } : {};\n}\n\nfunction copyPrimitiveRecord(\n\tinput: Record<string, unknown>,\n\tkey: string,\n): Record<string, Record<string, string | number | boolean>> {\n\tconst value = input[key];\n\tif (!isRecord(value)) {\n\t\treturn {};\n\t}\n\tconst output: Record<string, string | number | boolean> = {};\n\tfor (const [entryKey, entryValue] of Object.entries(value)) {\n\t\tconst normalizedKey = entryKey.trim();\n\t\tif (!normalizedKey) {\n\t\t\tcontinue;\n\t\t}\n\t\tif (\n\t\t\ttypeof entryValue === \"string\" ||\n\t\t\ttypeof entryValue === \"number\" ||\n\t\t\ttypeof entryValue === \"boolean\"\n\t\t) {\n\t\t\toutput[normalizedKey] =\n\t\t\t\ttypeof entryValue === \"string\" ? entryValue.trim() : entryValue;\n\t\t}\n\t}\n\treturn Object.keys(output).length > 0 ? { [key]: output } : {};\n}\n\nfunction copyString(\n\tinput: Record<string, unknown>,\n\tkey: string,\n): Record<string, string> {\n\tconst value = input[key];\n\treturn typeof value === \"string\" && value.trim()\n\t\t? { [key]: value.trim() }\n\t\t: {};\n}\n\nfunction expandHome(path: string): string {\n\tif (path === \"~\") {\n\t\treturn homedir();\n\t}\n\tif (path.startsWith(\"~/\")) {\n\t\treturn resolve(homedir(), path.slice(2));\n\t}\n\treturn resolve(path);\n}\n\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n\treturn typeof value === \"object\" && value !== null && !Array.isArray(value);\n}\n\nfunction hasNodeCode(error: unknown, code: string): boolean {\n\treturn (\n\t\ttypeof error === \"object\" &&\n\t\terror !== null &&\n\t\t\"code\" in error &&\n\t\t(error as { code?: unknown }).code === code\n\t);\n}\n"]}

package/dist/platform/a2a-task-ledger.d.ts

@@ -0,0 +1,86 @@
+import type { A2ATask } from "./a2a-client.js";
+import { type A2AWorkGraphMetadata } from "./a2a-work-graph.js";
+export type A2ATaskKind = "delegation" | "message";
+export type A2ATranscriptRole = "user" | "agent";
+export interface A2ATaskTranscriptEntry {
+    at: string;
+    role: A2ATranscriptRole;
+    text: string;
+    state?: string;
+    messageId?: string;
+}
+export interface A2ATaskLedgerEntry {
+    id: string;
+    kind: A2ATaskKind;
+    peer: string;
+    peerDisplayName?: string;
+    taskId: string;
+    contextId?: string;
+    messageId?: string;
+    text: string;
+    role?: string;
+    cwd?: string;
+    state: string;
+    responseText?: string;
+    metadata?: Record<string, string | number | boolean>;
+    workGraph?: A2AWorkGraphMetadata;
+    transcript: A2ATaskTranscriptEntry[];
+    createdAt: string;
+    updatedAt: string;
+    completedAt?: string;
+}
+export interface A2ATaskLedgerFile {
+    tasks: A2ATaskLedgerEntry[];
+}
+export interface A2ATaskLedgerOptions {
+    path?: string;
+    now?: Date;
+}
+export interface RecordA2ATaskStartInput extends A2ATaskLedgerOptions {
+    peer: string;
+    peerDisplayName?: string;
+    task: A2ATask;
+    text: string;
+    messageId?: string;
+    contextId?: string;
+    kind?: A2ATaskKind;
+    role?: string;
+    cwd?: string;
+    metadata?: Record<string, string | number | boolean | undefined>;
+}
+export interface UpdateA2ATaskInput extends A2ATaskLedgerOptions {
+    peer: string;
+    task: A2ATask;
+}
+export interface RecordA2ATaskReplyInput extends A2ATaskLedgerOptions {
+    peer: string;
+    peerDisplayName?: string;
+    task: A2ATask;
+    text: string;
+    messageId: string;
+    metadata?: Record<string, string | number | boolean | undefined>;
+}
+export declare function getA2ATaskLedgerPath(path?: string): string;
+export declare function loadA2ATaskLedger(options?: A2ATaskLedgerOptions): Promise<A2ATaskLedgerFile>;
+export declare function saveA2ATaskLedger(ledger: A2ATaskLedgerFile, options?: A2ATaskLedgerOptions): Promise<string>;
+export declare function recordA2ATaskStart(input: RecordA2ATaskStartInput): Promise<{
+    entry: A2ATaskLedgerEntry;
+    path: string;
+}>;
+export declare function recordA2ATaskReply(input: RecordA2ATaskReplyInput): Promise<{
+    entry: A2ATaskLedgerEntry;
+    path: string;
+}>;
+export declare function updateA2ATaskInLedger(input: UpdateA2ATaskInput): Promise<{
+    entry: A2ATaskLedgerEntry | null;
+    path: string;
+}>;
+export declare function listA2ATaskEntries(ledger: A2ATaskLedgerFile, options?: {
+    peer?: string;
+}): A2ATaskLedgerEntry[];
+export declare function latestA2ATaskForPeer(ledger: A2ATaskLedgerFile, peer: string): A2ATaskLedgerEntry | undefined;
+export declare function extractA2ATaskText(task: A2ATask): string | undefined;
+export declare function isTerminalA2AState(state: string): boolean;
+export declare function isFinalA2AState(state: string): boolean;
+export declare function isActionRequiredA2AState(state: string): boolean;
+//# sourceMappingURL=a2a-task-ledger.d.ts.map

package/dist/platform/a2a-task-ledger.d.ts.map

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