@evalops/maestro 0.10.18 → 0.10.20

package/dist/platform/a2a-fleet.d.ts

@@ -0,0 +1,41 @@
+import { type A2AAgentCard } from "./a2a-client.js";
+import type { A2AWorkGraphMetadata } from "./a2a-work-graph.js";
+export interface A2AFleetOptions {
+    registryPath?: string;
+    tasksPath?: string;
+    timeoutMs?: number;
+}
+export interface A2AFleetSummary {
+    generatedAt: string;
+    registryPath: string;
+    tasksPath: string;
+    peers: A2AFleetPeerSummary[];
+}
+export interface A2AFleetPeerSummary {
+    name: string;
+    displayName?: string;
+    url: string;
+    agentCardUrl?: string;
+    status: "online" | "unreachable";
+    error?: string;
+    auth?: string;
+    protocolBinding?: string;
+    protocolVersion?: string;
+    provider?: A2AAgentCard["provider"];
+    capabilities?: A2AAgentCard["capabilities"];
+    skills?: A2AAgentCard["skills"];
+    model?: string;
+    cwd?: string;
+    lastTask?: A2AFleetTaskSummary;
+}
+export interface A2AFleetTaskSummary {
+    id: string;
+    ledgerId: string;
+    state: string;
+    text: string;
+    responseText?: string;
+    workGraph?: A2AWorkGraphMetadata;
+    updatedAt: string;
+}
+export declare function inspectA2AFleet(options?: A2AFleetOptions): Promise<A2AFleetSummary>;
+//# sourceMappingURL=a2a-fleet.d.ts.map

package/dist/platform/a2a-fleet.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"a2a-fleet.d.ts","sourceRoot":"","sources":["../../src/platform/a2a-fleet.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,YAAY,EAAwB,MAAM,iBAAiB,CAAC;AAY1E,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAIhE,MAAM,WAAW,eAAe;IAC/B,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,eAAe;IAC/B,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,mBAAmB,EAAE,CAAC;CAC7B;AAED,MAAM,WAAW,mBAAmB;IACnC,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,MAAM,EAAE,QAAQ,GAAG,aAAa,CAAC;IACjC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,EAAE,YAAY,CAAC,UAAU,CAAC,CAAC;IACpC,YAAY,CAAC,EAAE,YAAY,CAAC,cAAc,CAAC,CAAC;IAC5C,MAAM,CAAC,EAAE,YAAY,CAAC,QAAQ,CAAC,CAAC;IAChC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,mBAAmB,CAAC;CAC/B;AAED,MAAM,WAAW,mBAAmB;IACnC,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,SAAS,CAAC,EAAE,oBAAoB,CAAC;IACjC,SAAS,EAAE,MAAM,CAAC;CAClB;AAED,wBAAsB,eAAe,CACpC,OAAO,GAAE,eAAoB,GAC3B,OAAO,CAAC,eAAe,CAAC,CAqB1B"}

package/dist/platform/a2a-fleet.js

@@ -0,0 +1,109 @@
+import { isAbortError } from "../utils/abort-error.js";
+import { discoverA2AAgentCard } from "./a2a-client.js";
+import { listA2APeers, resolveA2APeer, } from "./a2a-peer-registry.js";
+import { getA2ATaskLedgerPath, latestA2ATaskForPeer, loadA2ATaskLedger, } from "./a2a-task-ledger.js";
+const DEFAULT_A2A_FLEET_PROBE_TIMEOUT_MS = 10_000;
+export async function inspectA2AFleet(options = {}) {
+    const [{ path: registryPath, registry }, ledger] = await Promise.all([
+        listA2APeers({ path: options.registryPath }),
+        loadA2ATaskLedger({ path: options.tasksPath }),
+    ]);
+    const peers = await Promise.all(Object.entries(registry.peers)
+        .sort(([left], [right]) => left.localeCompare(right))
+        .map(async ([name, entry]) => inspectPeer(name, entry, latestA2ATaskForPeer(ledger, name), {
+        ...options,
+        registryTimeoutMs: registry.timeoutMs,
+    })));
+    return {
+        generatedAt: new Date().toISOString(),
+        registryPath,
+        tasksPath: getA2ATaskLedgerPath(options.tasksPath),
+        peers,
+    };
+}
+function fleetTaskSummary(entry) {
+    if (!entry) {
+        return undefined;
+    }
+    return {
+        id: entry.taskId,
+        ledgerId: entry.id,
+        state: entry.state,
+        text: entry.text,
+        ...(entry.responseText ? { responseText: entry.responseText } : {}),
+        ...(entry.workGraph ? { workGraph: entry.workGraph } : {}),
+        updatedAt: entry.updatedAt,
+    };
+}
+async function inspectPeer(name, entry, lastTask, options) {
+    const base = basePeerSummary(name, entry, lastTask);
+    try {
+        const peer = await resolveA2APeer(name, {
+            path: options.registryPath,
+            timeoutMs: options.timeoutMs,
+        });
+        const card = await discoverA2AAgentCard({
+            ...peer.config,
+            timeoutMs: fleetProbeTimeoutMs(peer.config.timeoutMs, entry, options),
+            maxAttempts: 1,
+        });
+        return {
+            ...base,
+            status: "online",
+            displayName: card.name || base.displayName,
+            provider: card.provider,
+            capabilities: card.capabilities,
+            skills: card.skills,
+            protocolBinding: card.supportedInterfaces[0]?.protocolBinding ?? base.protocolBinding,
+            protocolVersion: card.supportedInterfaces[0]?.protocolVersion ?? base.protocolVersion,
+        };
+    }
+    catch (error) {
+        if (isAbortError(error)) {
+            throw error;
+        }
+        return {
+            ...base,
+            status: "unreachable",
+            error: error instanceof Error ? error.message : String(error),
+        };
+    }
+}
+function fleetProbeTimeoutMs(resolvedTimeoutMs, entry, options) {
+    if (options.timeoutMs || entry.timeoutMs || options.registryTimeoutMs) {
+        return resolvedTimeoutMs;
+    }
+    return Math.min(resolvedTimeoutMs, DEFAULT_A2A_FLEET_PROBE_TIMEOUT_MS);
+}
+function basePeerSummary(name, entry, lastTask) {
+    return {
+        name,
+        ...(entry.displayName ? { displayName: entry.displayName } : {}),
+        url: entry.url,
+        ...(entry.agentCardUrl ? { agentCardUrl: entry.agentCardUrl } : {}),
+        status: "unreachable",
+        ...(entry.tokenEnv
+            ? { auth: `env:${entry.tokenEnv}` }
+            : entry.tokenFile
+                ? { auth: "file" }
+                : {}),
+        ...(entry.protocolBinding
+            ? { protocolBinding: entry.protocolBinding }
+            : {}),
+        ...(entry.protocolVersion
+            ? { protocolVersion: entry.protocolVersion }
+            : {}),
+        ...(stringMetadata(entry, "model")
+            ? { model: stringMetadata(entry, "model") }
+            : {}),
+        ...(stringMetadata(entry, "cwd")
+            ? { cwd: stringMetadata(entry, "cwd") }
+            : {}),
+        ...(lastTask ? { lastTask: fleetTaskSummary(lastTask) } : {}),
+    };
+}
+function stringMetadata(entry, key) {
+    const value = entry.metadata?.[key];
+    return typeof value === "string" && value.trim() ? value.trim() : undefined;
+}
+//# sourceMappingURL=a2a-fleet.js.map

package/dist/platform/a2a-fleet.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"a2a-fleet.js","sourceRoot":"","sources":["../../src/platform/a2a-fleet.ts"],"names":[],"mappings":"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","sourcesContent":["import { isAbortError } from \"../utils/abort-error.js\";\nimport { type A2AAgentCard, discoverA2AAgentCard } from \"./a2a-client.js\";\nimport {\n\ttype A2APeerRegistryEntry,\n\tlistA2APeers,\n\tresolveA2APeer,\n} from \"./a2a-peer-registry.js\";\nimport {\n\ttype A2ATaskLedgerEntry,\n\tgetA2ATaskLedgerPath,\n\tlatestA2ATaskForPeer,\n\tloadA2ATaskLedger,\n} from \"./a2a-task-ledger.js\";\nimport type { A2AWorkGraphMetadata } from \"./a2a-work-graph.js\";\n\nconst DEFAULT_A2A_FLEET_PROBE_TIMEOUT_MS = 10_000;\n\nexport interface A2AFleetOptions {\n\tregistryPath?: string;\n\ttasksPath?: string;\n\ttimeoutMs?: number;\n}\n\nexport interface A2AFleetSummary {\n\tgeneratedAt: string;\n\tregistryPath: string;\n\ttasksPath: string;\n\tpeers: A2AFleetPeerSummary[];\n}\n\nexport interface A2AFleetPeerSummary {\n\tname: string;\n\tdisplayName?: string;\n\turl: string;\n\tagentCardUrl?: string;\n\tstatus: \"online\" | \"unreachable\";\n\terror?: string;\n\tauth?: string;\n\tprotocolBinding?: string;\n\tprotocolVersion?: string;\n\tprovider?: A2AAgentCard[\"provider\"];\n\tcapabilities?: A2AAgentCard[\"capabilities\"];\n\tskills?: A2AAgentCard[\"skills\"];\n\tmodel?: string;\n\tcwd?: string;\n\tlastTask?: A2AFleetTaskSummary;\n}\n\nexport interface A2AFleetTaskSummary {\n\tid: string;\n\tledgerId: string;\n\tstate: string;\n\ttext: string;\n\tresponseText?: string;\n\tworkGraph?: A2AWorkGraphMetadata;\n\tupdatedAt: string;\n}\n\nexport async function inspectA2AFleet(\n\toptions: A2AFleetOptions = {},\n): Promise<A2AFleetSummary> {\n\tconst [{ path: registryPath, registry }, ledger] = await Promise.all([\n\t\tlistA2APeers({ path: options.registryPath }),\n\t\tloadA2ATaskLedger({ path: options.tasksPath }),\n\t]);\n\tconst peers = await Promise.all(\n\t\tObject.entries(registry.peers)\n\t\t\t.sort(([left], [right]) => left.localeCompare(right))\n\t\t\t.map(async ([name, entry]) =>\n\t\t\t\tinspectPeer(name, entry, latestA2ATaskForPeer(ledger, name), {\n\t\t\t\t\t...options,\n\t\t\t\t\tregistryTimeoutMs: registry.timeoutMs,\n\t\t\t\t}),\n\t\t\t),\n\t);\n\treturn {\n\t\tgeneratedAt: new Date().toISOString(),\n\t\tregistryPath,\n\t\ttasksPath: getA2ATaskLedgerPath(options.tasksPath),\n\t\tpeers,\n\t};\n}\n\nfunction fleetTaskSummary(\n\tentry: A2ATaskLedgerEntry | undefined,\n): A2AFleetTaskSummary | undefined {\n\tif (!entry) {\n\t\treturn undefined;\n\t}\n\treturn {\n\t\tid: entry.taskId,\n\t\tledgerId: entry.id,\n\t\tstate: entry.state,\n\t\ttext: entry.text,\n\t\t...(entry.responseText ? { responseText: entry.responseText } : {}),\n\t\t...(entry.workGraph ? { workGraph: entry.workGraph } : {}),\n\t\tupdatedAt: entry.updatedAt,\n\t};\n}\n\nasync function inspectPeer(\n\tname: string,\n\tentry: A2APeerRegistryEntry,\n\tlastTask: A2ATaskLedgerEntry | undefined,\n\toptions: A2AFleetOptions & { registryTimeoutMs?: number },\n): Promise<A2AFleetPeerSummary> {\n\tconst base = basePeerSummary(name, entry, lastTask);\n\ttry {\n\t\tconst peer = await resolveA2APeer(name, {\n\t\t\tpath: options.registryPath,\n\t\t\ttimeoutMs: options.timeoutMs,\n\t\t});\n\t\tconst card = await discoverA2AAgentCard({\n\t\t\t...peer.config,\n\t\t\ttimeoutMs: fleetProbeTimeoutMs(peer.config.timeoutMs, entry, options),\n\t\t\tmaxAttempts: 1,\n\t\t});\n\t\treturn {\n\t\t\t...base,\n\t\t\tstatus: \"online\",\n\t\t\tdisplayName: card.name || base.displayName,\n\t\t\tprovider: card.provider,\n\t\t\tcapabilities: card.capabilities,\n\t\t\tskills: card.skills,\n\t\t\tprotocolBinding:\n\t\t\t\tcard.supportedInterfaces[0]?.protocolBinding ?? base.protocolBinding,\n\t\t\tprotocolVersion:\n\t\t\t\tcard.supportedInterfaces[0]?.protocolVersion ?? base.protocolVersion,\n\t\t};\n\t} catch (error) {\n\t\tif (isAbortError(error)) {\n\t\t\tthrow error;\n\t\t}\n\t\treturn {\n\t\t\t...base,\n\t\t\tstatus: \"unreachable\",\n\t\t\terror: error instanceof Error ? error.message : String(error),\n\t\t};\n\t}\n}\n\nfunction fleetProbeTimeoutMs(\n\tresolvedTimeoutMs: number,\n\tentry: A2APeerRegistryEntry,\n\toptions: A2AFleetOptions & { registryTimeoutMs?: number },\n): number {\n\tif (options.timeoutMs || entry.timeoutMs || options.registryTimeoutMs) {\n\t\treturn resolvedTimeoutMs;\n\t}\n\treturn Math.min(resolvedTimeoutMs, DEFAULT_A2A_FLEET_PROBE_TIMEOUT_MS);\n}\n\nfunction basePeerSummary(\n\tname: string,\n\tentry: A2APeerRegistryEntry,\n\tlastTask: A2ATaskLedgerEntry | undefined,\n): A2AFleetPeerSummary {\n\treturn {\n\t\tname,\n\t\t...(entry.displayName ? { displayName: entry.displayName } : {}),\n\t\turl: entry.url,\n\t\t...(entry.agentCardUrl ? { agentCardUrl: entry.agentCardUrl } : {}),\n\t\tstatus: \"unreachable\",\n\t\t...(entry.tokenEnv\n\t\t\t? { auth: `env:${entry.tokenEnv}` }\n\t\t\t: entry.tokenFile\n\t\t\t\t? { auth: \"file\" }\n\t\t\t\t: {}),\n\t\t...(entry.protocolBinding\n\t\t\t? { protocolBinding: entry.protocolBinding }\n\t\t\t: {}),\n\t\t...(entry.protocolVersion\n\t\t\t? { protocolVersion: entry.protocolVersion }\n\t\t\t: {}),\n\t\t...(stringMetadata(entry, \"model\")\n\t\t\t? { model: stringMetadata(entry, \"model\") }\n\t\t\t: {}),\n\t\t...(stringMetadata(entry, \"cwd\")\n\t\t\t? { cwd: stringMetadata(entry, \"cwd\") }\n\t\t\t: {}),\n\t\t...(lastTask ? { lastTask: fleetTaskSummary(lastTask) } : {}),\n\t};\n}\n\nfunction stringMetadata(\n\tentry: A2APeerRegistryEntry,\n\tkey: string,\n): string | undefined {\n\tconst value = entry.metadata?.[key];\n\treturn typeof value === \"string\" && value.trim() ? value.trim() : undefined;\n}\n"]}

package/dist/platform/a2a-maestro-peer.d.ts

@@ -0,0 +1,20 @@
+import type { PlatformAgentA2APeerProjection, PlatformAgentA2ASkill } from "./agent-registry-client.js";
+export declare const MAESTRO_A2A_PROTOCOL_VERSION = "1.0";
+export declare const MAESTRO_A2A_PROTOCOL_BINDING = "HTTP+JSON";
+export declare const MAESTRO_A2A_AGENT_CARD_PATH = "/.well-known/agent-card.json";
+export declare const EVALOPS_A2A_OPERATING_PLANE_EXTENSION_URI = "https://evalops.com/a2a/extensions/operating-plane/v1";
+export interface BuildMaestroA2APeerProjectionInput {
+    publicEndpointUrl: string;
+    internalEndpointUrl?: string;
+    agentCardUrl?: string;
+    protocolVersion?: string;
+    agentCardETag?: string;
+    agentCardHash?: string;
+    pushNotifications?: boolean;
+    securitySchemes?: string[];
+    attributes?: Record<string, string>;
+}
+export declare function defaultMaestroA2ACapabilities(): string[];
+export declare function buildMaestroA2APeerProjection(input: BuildMaestroA2APeerProjectionInput): PlatformAgentA2APeerProjection;
+export declare function maestroA2AAgentSkills(): PlatformAgentA2ASkill[];
+//# sourceMappingURL=a2a-maestro-peer.d.ts.map

package/dist/platform/a2a-maestro-peer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"a2a-maestro-peer.d.ts","sourceRoot":"","sources":["../../src/platform/a2a-maestro-peer.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EACX,8BAA8B,EAC9B,qBAAqB,EACrB,MAAM,4BAA4B,CAAC;AAEpC,eAAO,MAAM,4BAA4B,QAAQ,CAAC;AAClD,eAAO,MAAM,4BAA4B,cAAc,CAAC;AACxD,eAAO,MAAM,2BAA2B,iCAAiC,CAAC;AAC1E,eAAO,MAAM,yCAAyC,0DACE,CAAC;AAgBzD,MAAM,WAAW,kCAAkC;IAClD,iBAAiB,EAAE,MAAM,CAAC;IAC1B,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;IAC3B,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACpC;AAED,wBAAgB,6BAA6B,IAAI,MAAM,EAAE,CASxD;AAED,wBAAgB,6BAA6B,CAC5C,KAAK,EAAE,kCAAkC,GACvC,8BAA8B,CA+BhC;AAED,wBAAgB,qBAAqB,IAAI,qBAAqB,EAAE,CAO/D"}

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

@@ -0,0 +1,176 @@
+import { CODEX_SUBAGENT_DISPATCH_TABLE, } from "../codex/subagent-dispatch-table.js";
+export const MAESTRO_A2A_PROTOCOL_VERSION = "1.0";
+export const MAESTRO_A2A_PROTOCOL_BINDING = "HTTP+JSON";
+export const MAESTRO_A2A_AGENT_CARD_PATH = "/.well-known/agent-card.json";
+export const EVALOPS_A2A_OPERATING_PLANE_EXTENSION_URI = "https://evalops.com/a2a/extensions/operating-plane/v1";
+const MAESTRO_TUI_TURN_SKILL = {
+    id: "maestro-tui-turn",
+    name: "Maestro TUI turn",
+    description: "Run a prompt through the local Maestro native TUI agent runner.",
+    tags: ["maestro", "tui", "codex", "a2a", "fleet"],
+    inputModes: ["text/plain"],
+    outputModes: ["text/plain", "application/json"],
+    attributes: {
+        evalopsSkillKind: "maestro-turn",
+        operatingPlaneExtension: EVALOPS_A2A_OPERATING_PLANE_EXTENSION_URI,
+    },
+};
+export function defaultMaestroA2ACapabilities() {
+    return uniqueStrings([
+        "maestro:a2a",
+        "maestro:cli",
+        "maestro:subagents",
+        ...CODEX_SUBAGENT_DISPATCH_TABLE.a2aSkillLanes.flatMap((lane) => lane.capabilityAliases.filter((capability) => capability.includes(":"))),
+    ]);
+}
+export function buildMaestroA2APeerProjection(input) {
+    const publicEndpointUrl = normalizeEndpoint(input.publicEndpointUrl);
+    const internalEndpointUrl = input.internalEndpointUrl
+        ? normalizeEndpoint(input.internalEndpointUrl)
+        : undefined;
+    const agentCardUrl = input.agentCardUrl?.trim() ||
+        `${publicEndpointUrl}${MAESTRO_A2A_AGENT_CARD_PATH}`;
+    return stripUndefinedValues({
+        publicEndpointUrl,
+        internalEndpointUrl,
+        agentCardUrl,
+        protocolBinding: MAESTRO_A2A_PROTOCOL_BINDING,
+        protocolVersion: input.protocolVersion ?? MAESTRO_A2A_PROTOCOL_VERSION,
+        supportedExtensions: [EVALOPS_A2A_OPERATING_PLANE_EXTENSION_URI],
+        skills: maestroA2AAgentSkills(),
+        securitySchemes: input.securitySchemes && input.securitySchemes.length > 0
+            ? uniqueStrings(input.securitySchemes)
+            : ["evalops-agent-token"],
+        agentCardETag: input.agentCardETag,
+        agentCardHash: input.agentCardHash,
+        pushNotifications: input.pushNotifications ?? true,
+        attributes: {
+            runtime: "maestro",
+            controlPlane: "rust-control-plane",
+            subagentDispatchTable: CODEX_SUBAGENT_DISPATCH_TABLE.schemaVersion,
+            operatingPlaneExtension: EVALOPS_A2A_OPERATING_PLANE_EXTENSION_URI,
+            ...(input.attributes ?? {}),
+        },
+    });
+}
+export function maestroA2AAgentSkills() {
+    return [
+        MAESTRO_TUI_TURN_SKILL,
+        ...CODEX_SUBAGENT_DISPATCH_TABLE.a2aSkillLanes.map(maestroSubagentLaneSkill),
+    ];
+}
+function maestroSubagentLaneSkill(lane) {
+    const policy = laneSkillPolicy(lane.laneId);
+    return {
+        id: lane.skillId,
+        name: lane.displayName,
+        description: lane.description,
+        tags: [...lane.tags],
+        inputModes: ["text/plain", "application/json"],
+        outputModes: ["text/plain", "application/json"],
+        requiredContextGrants: policy.requiredContextGrants,
+        approvalPolicyRef: `maestro.subagent.${lane.laneId}.target-policy`,
+        maxAutonomy: "bounded",
+        requiredArtifactKinds: policy.requiredArtifactKinds,
+        optionalArtifactKinds: policy.optionalArtifactKinds,
+        allowedTaskClasses: policy.allowedTaskClasses,
+        deniedTaskClasses: [
+            "credential.materialization",
+            "secret.exfiltration",
+            "unbounded.repository.write",
+        ],
+        attributes: {
+            evalopsSkillKind: "maestro-subagent",
+            subagentLaneId: lane.laneId,
+            requestMetadataPath: "evalops.subagentRequest",
+            operatingPlaneExtension: EVALOPS_A2A_OPERATING_PLANE_EXTENSION_URI,
+        },
+        metadata: {
+            evalopsSkillKind: "maestro-subagent",
+            subagentLaneId: lane.laneId,
+            operatingPlaneExtension: EVALOPS_A2A_OPERATING_PLANE_EXTENSION_URI,
+            requestMetadataPath: "evalops.subagentRequest",
+            approvalPolicy: "target-maestro-policy",
+            contextGrantPolicy: "bounded-policy-grants",
+            resultPolicy: "summary-and-artifacts",
+            workGraph: "target AgentRun child-agent work items",
+        },
+    };
+}
+function laneSkillPolicy(laneId) {
+    switch (laneId) {
+        case "code-writer":
+            return {
+                requiredContextGrants: [
+                    "repo:read",
+                    "repo:write-scoped",
+                    "tool:execute-tests",
+                ],
+                requiredArtifactKinds: ["patch.summary"],
+                optionalArtifactKinds: ["test.report", "review.summary"],
+                allowedTaskClasses: ["code.implementation", "code.refactor"],
+            };
+        case "code-review":
+            return {
+                requiredContextGrants: [
+                    "repo:read",
+                    "pull-request:read",
+                    "evidence:read",
+                ],
+                requiredArtifactKinds: ["review.summary"],
+                optionalArtifactKinds: ["risk.finding", "test.plan"],
+                allowedTaskClasses: ["code.review", "risk.analysis"],
+            };
+        case "test-runner":
+            return {
+                requiredContextGrants: [
+                    "repo:read",
+                    "tool:execute-tests",
+                    "evidence:write",
+                ],
+                requiredArtifactKinds: ["test.report"],
+                optionalArtifactKinds: ["failure.triage", "coverage.summary"],
+                allowedTaskClasses: ["test.execution", "ci.triage"],
+            };
+        case "repo-explorer":
+            return {
+                requiredContextGrants: ["repo:read", "evidence:write"],
+                requiredArtifactKinds: ["repo.map"],
+                optionalArtifactKinds: ["evidence.index"],
+                allowedTaskClasses: ["repo.inspect", "context.gathering"],
+            };
+        case "release-shepherd":
+            return {
+                requiredContextGrants: [
+                    "repo:read",
+                    "pull-request:write",
+                    "deploy:read",
+                    "evidence:write",
+                ],
+                requiredArtifactKinds: ["release.evidence"],
+                optionalArtifactKinds: ["ci.summary", "deploy.status"],
+                allowedTaskClasses: ["release.follow-through", "deployment.smoke"],
+            };
+        default:
+            return {
+                requiredContextGrants: ["repo:read"],
+                requiredArtifactKinds: ["subagent.summary"],
+                optionalArtifactKinds: ["evidence.index"],
+                allowedTaskClasses: ["agent.delegation"],
+            };
+    }
+}
+function normalizeEndpoint(value) {
+    const endpoint = value.trim().replace(/\/+$/u, "");
+    if (!endpoint) {
+        throw new Error("A2A endpoint URL is required");
+    }
+    return endpoint;
+}
+function uniqueStrings(values) {
+    return Array.from(new Set(values.map((value) => value.trim()).filter(Boolean)));
+}
+function stripUndefinedValues(record) {
+    return Object.fromEntries(Object.entries(record).filter(([, value]) => value !== undefined));
+}
+//# sourceMappingURL=a2a-maestro-peer.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"a2a-maestro-peer.js","sourceRoot":"","sources":["../../src/platform/a2a-maestro-peer.ts"],"names":[],"mappings":"AAAA,OAAO,EACN,6BAA6B,GAE7B,MAAM,qCAAqC,CAAC;AAM7C,MAAM,CAAC,MAAM,4BAA4B,GAAG,KAAK,CAAC;AAClD,MAAM,CAAC,MAAM,4BAA4B,GAAG,WAAW,CAAC;AACxD,MAAM,CAAC,MAAM,2BAA2B,GAAG,8BAA8B,CAAC;AAC1E,MAAM,CAAC,MAAM,yCAAyC,GACrD,uDAAuD,CAAC;AAEzD,MAAM,sBAAsB,GAA0B;IACrD,EAAE,EAAE,kBAAkB;IACtB,IAAI,EAAE,kBAAkB;IACxB,WAAW,EACV,iEAAiE;IAClE,IAAI,EAAE,CAAC,SAAS,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,CAAC;IACjD,UAAU,EAAE,CAAC,YAAY,CAAC;IAC1B,WAAW,EAAE,CAAC,YAAY,EAAE,kBAAkB,CAAC;IAC/C,UAAU,EAAE;QACX,gBAAgB,EAAE,cAAc;QAChC,uBAAuB,EAAE,yCAAyC;KAClE;CACD,CAAC;AAcF,MAAM,UAAU,6BAA6B;IAC5C,OAAO,aAAa,CAAC;QACpB,aAAa;QACb,aAAa;QACb,mBAAmB;QACnB,GAAG,6BAA6B,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,EAAE,CAC/D,IAAI,CAAC,iBAAiB,CAAC,MAAM,CAAC,CAAC,UAAU,EAAE,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CACvE;KACD,CAAC,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,6BAA6B,CAC5C,KAAyC;IAEzC,MAAM,iBAAiB,GAAG,iBAAiB,CAAC,KAAK,CAAC,iBAAiB,CAAC,CAAC;IACrE,MAAM,mBAAmB,GAAG,KAAK,CAAC,mBAAmB;QACpD,CAAC,CAAC,iBAAiB,CAAC,KAAK,CAAC,mBAAmB,CAAC;QAC9C,CAAC,CAAC,SAAS,CAAC;IACb,MAAM,YAAY,GACjB,KAAK,CAAC,YAAY,EAAE,IAAI,EAAE;QAC1B,GAAG,iBAAiB,GAAG,2BAA2B,EAAE,CAAC;IACtD,OAAO,oBAAoB,CAAC;QAC3B,iBAAiB;QACjB,mBAAmB;QACnB,YAAY;QACZ,eAAe,EAAE,4BAA4B;QAC7C,eAAe,EAAE,KAAK,CAAC,eAAe,IAAI,4BAA4B;QACtE,mBAAmB,EAAE,CAAC,yCAAyC,CAAC;QAChE,MAAM,EAAE,qBAAqB,EAAE;QAC/B,eAAe,EACd,KAAK,CAAC,eAAe,IAAI,KAAK,CAAC,eAAe,CAAC,MAAM,GAAG,CAAC;YACxD,CAAC,CAAC,aAAa,CAAC,KAAK,CAAC,eAAe,CAAC;YACtC,CAAC,CAAC,CAAC,qBAAqB,CAAC;QAC3B,aAAa,EAAE,KAAK,CAAC,aAAa;QAClC,aAAa,EAAE,KAAK,CAAC,aAAa;QAClC,iBAAiB,EAAE,KAAK,CAAC,iBAAiB,IAAI,IAAI;QAClD,UAAU,EAAE;YACX,OAAO,EAAE,SAAS;YAClB,YAAY,EAAE,oBAAoB;YAClC,qBAAqB,EAAE,6BAA6B,CAAC,aAAa;YAClE,uBAAuB,EAAE,yCAAyC;YAClE,GAAG,CAAC,KAAK,CAAC,UAAU,IAAI,EAAE,CAAC;SAC3B;KACD,CAAmC,CAAC;AACtC,CAAC;AAED,MAAM,UAAU,qBAAqB;IACpC,OAAO;QACN,sBAAsB;QACtB,GAAG,6BAA6B,CAAC,aAAa,CAAC,GAAG,CACjD,wBAAwB,CACxB;KACD,CAAC;AACH,CAAC;AAED,SAAS,wBAAwB,CAChC,IAA+B;IAE/B,MAAM,MAAM,GAAG,eAAe,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IAC5C,OAAO;QACN,EAAE,EAAE,IAAI,CAAC,OAAO;QAChB,IAAI,EAAE,IAAI,CAAC,WAAW;QACtB,WAAW,EAAE,IAAI,CAAC,WAAW;QAC7B,IAAI,EAAE,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC;QACpB,UAAU,EAAE,CAAC,YAAY,EAAE,kBAAkB,CAAC;QAC9C,WAAW,EAAE,CAAC,YAAY,EAAE,kBAAkB,CAAC;QAC/C,qBAAqB,EAAE,MAAM,CAAC,qBAAqB;QACnD,iBAAiB,EAAE,oBAAoB,IAAI,CAAC,MAAM,gBAAgB;QAClE,WAAW,EAAE,SAAS;QACtB,qBAAqB,EAAE,MAAM,CAAC,qBAAqB;QACnD,qBAAqB,EAAE,MAAM,CAAC,qBAAqB;QACnD,kBAAkB,EAAE,MAAM,CAAC,kBAAkB;QAC7C,iBAAiB,EAAE;YAClB,4BAA4B;YAC5B,qBAAqB;YACrB,4BAA4B;SAC5B;QACD,UAAU,EAAE;YACX,gBAAgB,EAAE,kBAAkB;YACpC,cAAc,EAAE,IAAI,CAAC,MAAM;YAC3B,mBAAmB,EAAE,yBAAyB;YAC9C,uBAAuB,EAAE,yCAAyC;SAClE;QACD,QAAQ,EAAE;YACT,gBAAgB,EAAE,kBAAkB;YACpC,cAAc,EAAE,IAAI,CAAC,MAAM;YAC3B,uBAAuB,EAAE,yCAAyC;YAClE,mBAAmB,EAAE,yBAAyB;YAC9C,cAAc,EAAE,uBAAuB;YACvC,kBAAkB,EAAE,uBAAuB;YAC3C,YAAY,EAAE,uBAAuB;YACrC,SAAS,EAAE,wCAAwC;SACnD;KACD,CAAC;AACH,CAAC;AAED,SAAS,eAAe,CAAC,MAAc;IAMtC,QAAQ,MAAM,EAAE,CAAC;QAChB,KAAK,aAAa;YACjB,OAAO;gBACN,qBAAqB,EAAE;oBACtB,WAAW;oBACX,mBAAmB;oBACnB,oBAAoB;iBACpB;gBACD,qBAAqB,EAAE,CAAC,eAAe,CAAC;gBACxC,qBAAqB,EAAE,CAAC,aAAa,EAAE,gBAAgB,CAAC;gBACxD,kBAAkB,EAAE,CAAC,qBAAqB,EAAE,eAAe,CAAC;aAC5D,CAAC;QACH,KAAK,aAAa;YACjB,OAAO;gBACN,qBAAqB,EAAE;oBACtB,WAAW;oBACX,mBAAmB;oBACnB,eAAe;iBACf;gBACD,qBAAqB,EAAE,CAAC,gBAAgB,CAAC;gBACzC,qBAAqB,EAAE,CAAC,cAAc,EAAE,WAAW,CAAC;gBACpD,kBAAkB,EAAE,CAAC,aAAa,EAAE,eAAe,CAAC;aACpD,CAAC;QACH,KAAK,aAAa;YACjB,OAAO;gBACN,qBAAqB,EAAE;oBACtB,WAAW;oBACX,oBAAoB;oBACpB,gBAAgB;iBAChB;gBACD,qBAAqB,EAAE,CAAC,aAAa,CAAC;gBACtC,qBAAqB,EAAE,CAAC,gBAAgB,EAAE,kBAAkB,CAAC;gBAC7D,kBAAkB,EAAE,CAAC,gBAAgB,EAAE,WAAW,CAAC;aACnD,CAAC;QACH,KAAK,eAAe;YACnB,OAAO;gBACN,qBAAqB,EAAE,CAAC,WAAW,EAAE,gBAAgB,CAAC;gBACtD,qBAAqB,EAAE,CAAC,UAAU,CAAC;gBACnC,qBAAqB,EAAE,CAAC,gBAAgB,CAAC;gBACzC,kBAAkB,EAAE,CAAC,cAAc,EAAE,mBAAmB,CAAC;aACzD,CAAC;QACH,KAAK,kBAAkB;YACtB,OAAO;gBACN,qBAAqB,EAAE;oBACtB,WAAW;oBACX,oBAAoB;oBACpB,aAAa;oBACb,gBAAgB;iBAChB;gBACD,qBAAqB,EAAE,CAAC,kBAAkB,CAAC;gBAC3C,qBAAqB,EAAE,CAAC,YAAY,EAAE,eAAe,CAAC;gBACtD,kBAAkB,EAAE,CAAC,wBAAwB,EAAE,kBAAkB,CAAC;aAClE,CAAC;QACH;YACC,OAAO;gBACN,qBAAqB,EAAE,CAAC,WAAW,CAAC;gBACpC,qBAAqB,EAAE,CAAC,kBAAkB,CAAC;gBAC3C,qBAAqB,EAAE,CAAC,gBAAgB,CAAC;gBACzC,kBAAkB,EAAE,CAAC,kBAAkB,CAAC;aACxC,CAAC;IACJ,CAAC;AACF,CAAC;AAED,SAAS,iBAAiB,CAAC,KAAa;IACvC,MAAM,QAAQ,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;IACnD,IAAI,CAAC,QAAQ,EAAE,CAAC;QACf,MAAM,IAAI,KAAK,CAAC,8BAA8B,CAAC,CAAC;IACjD,CAAC;IACD,OAAO,QAAQ,CAAC;AACjB,CAAC;AAED,SAAS,aAAa,CAAC,MAAyB;IAC/C,OAAO,KAAK,CAAC,IAAI,CAChB,IAAI,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAC5D,CAAC;AACH,CAAC;AAED,SAAS,oBAAoB,CAC5B,MAA+B;IAE/B,OAAO,MAAM,CAAC,WAAW,CACxB,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,KAAK,KAAK,SAAS,CAAC,CACjE,CAAC;AACH,CAAC","sourcesContent":["import {\n\tCODEX_SUBAGENT_DISPATCH_TABLE,\n\ttype CodexSubagentDispatchLane,\n} from \"../codex/subagent-dispatch-table.js\";\nimport type {\n\tPlatformAgentA2APeerProjection,\n\tPlatformAgentA2ASkill,\n} from \"./agent-registry-client.js\";\n\nexport const MAESTRO_A2A_PROTOCOL_VERSION = \"1.0\";\nexport const MAESTRO_A2A_PROTOCOL_BINDING = \"HTTP+JSON\";\nexport const MAESTRO_A2A_AGENT_CARD_PATH = \"/.well-known/agent-card.json\";\nexport const EVALOPS_A2A_OPERATING_PLANE_EXTENSION_URI =\n\t\"https://evalops.com/a2a/extensions/operating-plane/v1\";\n\nconst MAESTRO_TUI_TURN_SKILL: PlatformAgentA2ASkill = {\n\tid: \"maestro-tui-turn\",\n\tname: \"Maestro TUI turn\",\n\tdescription:\n\t\t\"Run a prompt through the local Maestro native TUI agent runner.\",\n\ttags: [\"maestro\", \"tui\", \"codex\", \"a2a\", \"fleet\"],\n\tinputModes: [\"text/plain\"],\n\toutputModes: [\"text/plain\", \"application/json\"],\n\tattributes: {\n\t\tevalopsSkillKind: \"maestro-turn\",\n\t\toperatingPlaneExtension: EVALOPS_A2A_OPERATING_PLANE_EXTENSION_URI,\n\t},\n};\n\nexport interface BuildMaestroA2APeerProjectionInput {\n\tpublicEndpointUrl: string;\n\tinternalEndpointUrl?: string;\n\tagentCardUrl?: string;\n\tprotocolVersion?: string;\n\tagentCardETag?: string;\n\tagentCardHash?: string;\n\tpushNotifications?: boolean;\n\tsecuritySchemes?: string[];\n\tattributes?: Record<string, string>;\n}\n\nexport function defaultMaestroA2ACapabilities(): string[] {\n\treturn uniqueStrings([\n\t\t\"maestro:a2a\",\n\t\t\"maestro:cli\",\n\t\t\"maestro:subagents\",\n\t\t...CODEX_SUBAGENT_DISPATCH_TABLE.a2aSkillLanes.flatMap((lane) =>\n\t\t\tlane.capabilityAliases.filter((capability) => capability.includes(\":\")),\n\t\t),\n\t]);\n}\n\nexport function buildMaestroA2APeerProjection(\n\tinput: BuildMaestroA2APeerProjectionInput,\n): PlatformAgentA2APeerProjection {\n\tconst publicEndpointUrl = normalizeEndpoint(input.publicEndpointUrl);\n\tconst internalEndpointUrl = input.internalEndpointUrl\n\t\t? normalizeEndpoint(input.internalEndpointUrl)\n\t\t: undefined;\n\tconst agentCardUrl =\n\t\tinput.agentCardUrl?.trim() ||\n\t\t`${publicEndpointUrl}${MAESTRO_A2A_AGENT_CARD_PATH}`;\n\treturn stripUndefinedValues({\n\t\tpublicEndpointUrl,\n\t\tinternalEndpointUrl,\n\t\tagentCardUrl,\n\t\tprotocolBinding: MAESTRO_A2A_PROTOCOL_BINDING,\n\t\tprotocolVersion: input.protocolVersion ?? MAESTRO_A2A_PROTOCOL_VERSION,\n\t\tsupportedExtensions: [EVALOPS_A2A_OPERATING_PLANE_EXTENSION_URI],\n\t\tskills: maestroA2AAgentSkills(),\n\t\tsecuritySchemes:\n\t\t\tinput.securitySchemes && input.securitySchemes.length > 0\n\t\t\t\t? uniqueStrings(input.securitySchemes)\n\t\t\t\t: [\"evalops-agent-token\"],\n\t\tagentCardETag: input.agentCardETag,\n\t\tagentCardHash: input.agentCardHash,\n\t\tpushNotifications: input.pushNotifications ?? true,\n\t\tattributes: {\n\t\t\truntime: \"maestro\",\n\t\t\tcontrolPlane: \"rust-control-plane\",\n\t\t\tsubagentDispatchTable: CODEX_SUBAGENT_DISPATCH_TABLE.schemaVersion,\n\t\t\toperatingPlaneExtension: EVALOPS_A2A_OPERATING_PLANE_EXTENSION_URI,\n\t\t\t...(input.attributes ?? {}),\n\t\t},\n\t}) as PlatformAgentA2APeerProjection;\n}\n\nexport function maestroA2AAgentSkills(): PlatformAgentA2ASkill[] {\n\treturn [\n\t\tMAESTRO_TUI_TURN_SKILL,\n\t\t...CODEX_SUBAGENT_DISPATCH_TABLE.a2aSkillLanes.map(\n\t\t\tmaestroSubagentLaneSkill,\n\t\t),\n\t];\n}\n\nfunction maestroSubagentLaneSkill(\n\tlane: CodexSubagentDispatchLane,\n): PlatformAgentA2ASkill {\n\tconst policy = laneSkillPolicy(lane.laneId);\n\treturn {\n\t\tid: lane.skillId,\n\t\tname: lane.displayName,\n\t\tdescription: lane.description,\n\t\ttags: [...lane.tags],\n\t\tinputModes: [\"text/plain\", \"application/json\"],\n\t\toutputModes: [\"text/plain\", \"application/json\"],\n\t\trequiredContextGrants: policy.requiredContextGrants,\n\t\tapprovalPolicyRef: `maestro.subagent.${lane.laneId}.target-policy`,\n\t\tmaxAutonomy: \"bounded\",\n\t\trequiredArtifactKinds: policy.requiredArtifactKinds,\n\t\toptionalArtifactKinds: policy.optionalArtifactKinds,\n\t\tallowedTaskClasses: policy.allowedTaskClasses,\n\t\tdeniedTaskClasses: [\n\t\t\t\"credential.materialization\",\n\t\t\t\"secret.exfiltration\",\n\t\t\t\"unbounded.repository.write\",\n\t\t],\n\t\tattributes: {\n\t\t\tevalopsSkillKind: \"maestro-subagent\",\n\t\t\tsubagentLaneId: lane.laneId,\n\t\t\trequestMetadataPath: \"evalops.subagentRequest\",\n\t\t\toperatingPlaneExtension: EVALOPS_A2A_OPERATING_PLANE_EXTENSION_URI,\n\t\t},\n\t\tmetadata: {\n\t\t\tevalopsSkillKind: \"maestro-subagent\",\n\t\t\tsubagentLaneId: lane.laneId,\n\t\t\toperatingPlaneExtension: EVALOPS_A2A_OPERATING_PLANE_EXTENSION_URI,\n\t\t\trequestMetadataPath: \"evalops.subagentRequest\",\n\t\t\tapprovalPolicy: \"target-maestro-policy\",\n\t\t\tcontextGrantPolicy: \"bounded-policy-grants\",\n\t\t\tresultPolicy: \"summary-and-artifacts\",\n\t\t\tworkGraph: \"target AgentRun child-agent work items\",\n\t\t},\n\t};\n}\n\nfunction laneSkillPolicy(laneId: string): {\n\trequiredContextGrants: string[];\n\trequiredArtifactKinds: string[];\n\toptionalArtifactKinds: string[];\n\tallowedTaskClasses: string[];\n} {\n\tswitch (laneId) {\n\t\tcase \"code-writer\":\n\t\t\treturn {\n\t\t\t\trequiredContextGrants: [\n\t\t\t\t\t\"repo:read\",\n\t\t\t\t\t\"repo:write-scoped\",\n\t\t\t\t\t\"tool:execute-tests\",\n\t\t\t\t],\n\t\t\t\trequiredArtifactKinds: [\"patch.summary\"],\n\t\t\t\toptionalArtifactKinds: [\"test.report\", \"review.summary\"],\n\t\t\t\tallowedTaskClasses: [\"code.implementation\", \"code.refactor\"],\n\t\t\t};\n\t\tcase \"code-review\":\n\t\t\treturn {\n\t\t\t\trequiredContextGrants: [\n\t\t\t\t\t\"repo:read\",\n\t\t\t\t\t\"pull-request:read\",\n\t\t\t\t\t\"evidence:read\",\n\t\t\t\t],\n\t\t\t\trequiredArtifactKinds: [\"review.summary\"],\n\t\t\t\toptionalArtifactKinds: [\"risk.finding\", \"test.plan\"],\n\t\t\t\tallowedTaskClasses: [\"code.review\", \"risk.analysis\"],\n\t\t\t};\n\t\tcase \"test-runner\":\n\t\t\treturn {\n\t\t\t\trequiredContextGrants: [\n\t\t\t\t\t\"repo:read\",\n\t\t\t\t\t\"tool:execute-tests\",\n\t\t\t\t\t\"evidence:write\",\n\t\t\t\t],\n\t\t\t\trequiredArtifactKinds: [\"test.report\"],\n\t\t\t\toptionalArtifactKinds: [\"failure.triage\", \"coverage.summary\"],\n\t\t\t\tallowedTaskClasses: [\"test.execution\", \"ci.triage\"],\n\t\t\t};\n\t\tcase \"repo-explorer\":\n\t\t\treturn {\n\t\t\t\trequiredContextGrants: [\"repo:read\", \"evidence:write\"],\n\t\t\t\trequiredArtifactKinds: [\"repo.map\"],\n\t\t\t\toptionalArtifactKinds: [\"evidence.index\"],\n\t\t\t\tallowedTaskClasses: [\"repo.inspect\", \"context.gathering\"],\n\t\t\t};\n\t\tcase \"release-shepherd\":\n\t\t\treturn {\n\t\t\t\trequiredContextGrants: [\n\t\t\t\t\t\"repo:read\",\n\t\t\t\t\t\"pull-request:write\",\n\t\t\t\t\t\"deploy:read\",\n\t\t\t\t\t\"evidence:write\",\n\t\t\t\t],\n\t\t\t\trequiredArtifactKinds: [\"release.evidence\"],\n\t\t\t\toptionalArtifactKinds: [\"ci.summary\", \"deploy.status\"],\n\t\t\t\tallowedTaskClasses: [\"release.follow-through\", \"deployment.smoke\"],\n\t\t\t};\n\t\tdefault:\n\t\t\treturn {\n\t\t\t\trequiredContextGrants: [\"repo:read\"],\n\t\t\t\trequiredArtifactKinds: [\"subagent.summary\"],\n\t\t\t\toptionalArtifactKinds: [\"evidence.index\"],\n\t\t\t\tallowedTaskClasses: [\"agent.delegation\"],\n\t\t\t};\n\t}\n}\n\nfunction normalizeEndpoint(value: string): string {\n\tconst endpoint = value.trim().replace(/\\/+$/u, \"\");\n\tif (!endpoint) {\n\t\tthrow new Error(\"A2A endpoint URL is required\");\n\t}\n\treturn endpoint;\n}\n\nfunction uniqueStrings(values: readonly string[]): string[] {\n\treturn Array.from(\n\t\tnew Set(values.map((value) => value.trim()).filter(Boolean)),\n\t);\n}\n\nfunction stripUndefinedValues(\n\trecord: Record<string, unknown>,\n): Record<string, unknown> {\n\treturn Object.fromEntries(\n\t\tObject.entries(record).filter(([, value]) => value !== undefined),\n\t);\n}\n"]}

package/dist/platform/a2a-peer-pairing.d.ts

@@ -0,0 +1,107 @@
+import { type A2AAgentCard, type A2AAgentInterface } from "./a2a-client.js";
+export declare const A2A_PEER_PAIRING_CODE_PREFIX = "maestro-pair-v1";
+export interface A2APeerPairingCapabilities {
+    streaming?: boolean;
+    pushNotifications?: boolean;
+    extendedAgentCard?: boolean;
+}
+export interface A2APeerPairingSkillSummary {
+    id: string;
+    name: string;
+    description?: string;
+    tags?: string[];
+    examples?: string[];
+    inputModes?: string[];
+    outputModes?: string[];
+    requiredContextGrants?: string[];
+    approvalPolicyRef?: string;
+    maxAutonomy?: string;
+    requiredArtifactKinds?: string[];
+    optionalArtifactKinds?: string[];
+    allowedTaskClasses?: string[];
+    deniedTaskClasses?: string[];
+    attributes?: Record<string, string>;
+    metadata?: Record<string, string | number | boolean>;
+}
+export interface A2APeerPairingProvider {
+    organization?: string;
+    url?: string;
+}
+export interface A2APeerPairingRelayHints {
+    host?: string;
+    port?: number;
+    tailscaleName?: string;
+    path?: string;
+}
+export interface A2APeerPairingPayload {
+    version: 1;
+    displayName: string;
+    agentCardUrl: string;
+    transportUrl: string;
+    protocolBinding: string;
+    protocolVersion: string;
+    issuedAt: string;
+    expiresAt: string;
+    peerId?: string;
+    provider?: A2APeerPairingProvider;
+    capabilities?: A2APeerPairingCapabilities;
+    skills?: A2APeerPairingSkillSummary[];
+    keyFingerprint?: string;
+    relayHints?: A2APeerPairingRelayHints;
+    metadata?: Record<string, string | number | boolean>;
+}
+export interface CreateA2APeerPairingPayloadInput {
+    displayName: string;
+    agentCardUrl: string;
+    transportUrl: string;
+    protocolBinding?: string;
+    protocolVersion?: string;
+    issuedAt?: Date | string;
+    expiresAt?: Date | string;
+    ttlMs?: number;
+    peerId?: string;
+    provider?: A2APeerPairingProvider;
+    capabilities?: A2APeerPairingCapabilities;
+    skills?: A2APeerPairingSkillSummary[];
+    keyFingerprint?: string;
+    relayHints?: A2APeerPairingRelayHints;
+    metadata?: Record<string, string | number | boolean>;
+    now?: Date;
+}
+export interface CreateA2APeerPairingPayloadFromAgentCardInput {
+    agentCard: A2AAgentCard;
+    agentCardUrl: string;
+    displayName?: string;
+    issuedAt?: Date | string;
+    expiresAt?: Date | string;
+    ttlMs?: number;
+    peerId?: string;
+    keyFingerprint?: string;
+    relayHints?: A2APeerPairingRelayHints;
+    metadata?: Record<string, string | number | boolean>;
+    now?: Date;
+}
+export interface DecodeA2APeerPairingCodeOptions {
+    now?: Date;
+    allowExpired?: boolean;
+}
+export interface A2APeerConnection {
+    peerId: string;
+    displayName: string;
+    baseUrl: string;
+    agentCardUrl: string;
+    protocolBinding: string;
+    protocolVersion: string;
+    capabilities?: A2APeerPairingCapabilities;
+    skills?: A2APeerPairingSkillSummary[];
+    keyFingerprint?: string;
+    metadata?: Record<string, string | number | boolean>;
+}
+export declare function createA2APeerPairingPayload(input: CreateA2APeerPairingPayloadInput): A2APeerPairingPayload;
+export declare function createA2APeerPairingPayloadFromAgentCard(input: CreateA2APeerPairingPayloadFromAgentCardInput): A2APeerPairingPayload;
+export declare function encodeA2APeerPairingCode(payload: A2APeerPairingPayload): string;
+export declare function decodeA2APeerPairingCode(code: string, options?: DecodeA2APeerPairingCodeOptions): A2APeerPairingPayload;
+export declare function a2aPeerConnectionFromPairingPayload(payload: A2APeerPairingPayload): A2APeerConnection;
+export declare function selectA2AAgentInterface(agentCard: A2AAgentCard): A2AAgentInterface;
+export declare function resolveA2AAgentCardUrl(input: string): string;
+//# sourceMappingURL=a2a-peer-pairing.d.ts.map

package/dist/platform/a2a-peer-pairing.d.ts.map

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