@groundnuty/macf-channel-server 0.2.28 → 0.2.33

package/dist/agent-card.js

@@ -34,24 +34,54 @@
  * don't accidentally re-include it.
  */
 import { z } from 'zod';
+import { A2A_ENDPOINT_PATH } from './a2a-types.js';
 // ---------------------------------------------------------------------------
 // Zod schema (hand-rolled from A2A v1.0 spec § 4.4.1 + § 4.4.5 + § 4.5.6)
 // ---------------------------------------------------------------------------
 /**
- * AgentSkill — per spec § 4.4.5. Required: id, name. Optional:
- * description, tags, examples, inputModes, outputModes, metadata,
- * extensions.
+ * AgentSkill — per canonical proto (`a2aproject/A2A:specification/a2a.proto`
+ * `message AgentSkill`). Required per proto: id, name, description, tags.
+ * Optional: examples, input_modes, output_modes, security_requirements.
+ *
+ * JSON wire form uses canonical lowerCamelCase mapping from proto
+ * snake_case (`input_modes` → `inputModes`, etc.) per proto3 JSON spec.
+ *
+ * **macf#393 Phase 2c**: `description` + `tags` upgraded from optional
+ * (Phase 1's lenient shape) to required per proto. Strict-validating
+ * external A2A clients (Bedrock AgentCore, Microsoft Agent Framework,
+ * etc.) reject AgentCards with skill entries missing required fields.
  */
 export const AgentSkillSchema = z.object({
     id: z.string().min(1),
     name: z.string().min(1),
-    description: z.string().optional(),
-    tags: z.array(z.string()).optional(),
+    description: z.string().min(1),
+    tags: z.array(z.string()).min(1),
     examples: z.array(z.string()).optional(),
     inputModes: z.array(z.string()).optional(),
     outputModes: z.array(z.string()).optional(),
     metadata: z.record(z.string(), z.unknown()).optional(),
 });
+/**
+ * AgentInterface — per canonical proto `message AgentInterface`.
+ * Per AgentCard `supported_interfaces` (proto field 3, REQUIRED): the
+ * endpoint URL + protocol binding the agent serves. v1.0 moves the
+ * endpoint URL OUT of AgentCard top-level into the (repeated)
+ * AgentInterface entries.
+ *
+ * Required per proto: url, protocol_binding, protocol_version.
+ * Optional: tenant.
+ *
+ * JSON wire form: `protocolBinding` (lowerCamelCase) + `protocolVersion`.
+ */
+export const AgentInterfaceSchema = z.object({
+    url: z.string().url(),
+    /** Protocol binding identifier: `"JSONRPC"` | `"GRPC"` | `"HTTP+JSON"`. */
+    protocolBinding: z.string().min(1),
+    /** Optional tenant identifier for multi-tenant deployments. */
+    tenant: z.string().optional(),
+    /** A2A protocol version this interface serves, e.g. `"1.0"`. */
+    protocolVersion: z.string().min(1),
+});
 /**
  * MutualTlsSecurityScheme — per spec § 4.5.6. Type discriminator
  * `mutualTls`. No additional fields required at the scheme level;
@@ -83,29 +113,49 @@ export const AgentCapabilitiesSchema = z.object({
     pushNotifications: z.boolean().optional(),
 }).catchall(z.unknown());
 /**
- * AgentCard — per spec § 4.4.1. Required: id, name, url, version,
- * provider, capabilities, securitySchemes. Optional: description,
- * defaultInputModes, defaultOutputModes, skills, extensions, security,
- * metadata.
+ * AgentCard — per canonical proto `message AgentCard` (verified verbatim
+ * from `a2aproject/A2A:specification/a2a.proto` 2026-05-19).
+ *
+ * Required per proto: name, description, supported_interfaces,
+ * version, capabilities, default_input_modes, default_output_modes, skills.
+ * Optional: provider, documentation_url, security_schemes,
+ * security_requirements, signatures, icon_url.
+ *
+ * JSON wire form uses canonical lowerCamelCase mapping from proto
+ * snake_case (`supported_interfaces` → `supportedInterfaces`, etc.).
+ *
+ * **macf#393 Phase 2c** — schema realignment to canonical proto:
+ * - REMOVED top-level `id` (no such field in proto)
+ * - REMOVED top-level `url` (moves to `supportedInterfaces[0].url`)
+ * - ADDED `description` as required (was optional in Phase 1)
+ * - ADDED `supportedInterfaces` as required (endpoint URL lives here per v1.0)
+ * - ADDED `defaultInputModes` + `defaultOutputModes` as required
+ * - `skills` upgraded from optional to required (proto says REQUIRED)
+ *
+ * The schema change is structurally breaking for any consumer that parsed
+ * Phase 1's AgentCard shape; pre-flight grep on 2026-05-19 confirmed zero
+ * external consumers (Phase 1 shipped ~24h prior). Migration documented
+ * in DR-022 Amendment M.
  */
 export const AgentCardSchema = z.object({
-    id: z.string().min(1),
     name: z.string().min(1),
-    url: z.string().url(),
+    description: z.string().min(1),
+    supportedInterfaces: z.array(AgentInterfaceSchema).min(1),
     version: z.string().min(1),
-    provider: AgentProviderSchema,
+    provider: AgentProviderSchema.optional(),
     capabilities: AgentCapabilitiesSchema,
     // Phase 1 mTLS-only stance. Phase 2+ widening to a discriminated
     // union (OAuth/OIDC for external integrations per A2A spec § 4.5)
     // lives here when needed — replace `MutualTlsSecuritySchemeSchema`
     // with `z.discriminatedUnion('type', [MutualTls..., OAuth2..., ...])`.
     // Per #370 review (science-agent 2026-05-18).
-    securitySchemes: z.record(z.string(), MutualTlsSecuritySchemeSchema),
-    description: z.string().optional(),
-    defaultInputModes: z.array(z.string()).optional(),
-    defaultOutputModes: z.array(z.string()).optional(),
-    skills: z.array(AgentSkillSchema).optional(),
+    securitySchemes: z.record(z.string(), MutualTlsSecuritySchemeSchema).optional(),
+    defaultInputModes: z.array(z.string()).min(1),
+    defaultOutputModes: z.array(z.string()).min(1),
+    skills: z.array(AgentSkillSchema).min(1),
     security: z.array(z.record(z.string(), z.array(z.string()))).optional(),
+    documentationUrl: z.string().optional(),
+    iconUrl: z.string().optional(),
     metadata: z.record(z.string(), z.unknown()).optional(),
 });
 /**
@@ -116,25 +166,44 @@ export const AgentCardSchema = z.object({
  * clients SHOULD NOT depend on it. A source-level test in
  * `test/agent-card.test.ts` pins this invariant.
  *
- * Skills in Phase 1: empty array. The MACF coordination surfaces
- * (POST /notify for inbound peer notifications) are framework-internal,
- * not user-invocable agent skills in the A2A sense. Phase 2+ may add
- * skills as A2A's task lifecycle surfaces materialize.
+ * Skills in Phase 2a (macf#390): MACF domain capabilities — what the
+ * agent can DO, not what JSON-RPC methods it serves. Per spec § 4.4.5,
+ * skills describe agent-specific actions on top of the A2A protocol
+ * methods. Initial mapping (Phase 2a):
+ *
+ * - `macf.notify_peer` — Cross-Agent Notification (the canonical MACF
+ *   coordination primitive; #267)
+ * - `macf.checkpoint_to_memory` — Persist Context to Memory (the PreCompact
+ *   checkpoint MCP tool; #271 DR-023 §UC-3)
+ *
+ * Phase 3+ will add role-specific skills if the MACF MCP-tool surface
+ * grows. `/macf/sign` is intentionally absent — live cryptographic
+ * attestation stays MACF-only per DR-010 Path 2 + #371; a source-level
+ * test pins this invariant.
+ *
+ * `url` field: Phase 2a points AgentCard.url to the JSON-RPC endpoint
+ * (`<inputs.url>/a2a/v1`). A2A clients discover via
+ * `/.well-known/agent-card.json` then POST `message/send` to the
+ * advertised url.
  */
 export function buildAgentCard(inputs) {
+    // macf#393 Phase 2c: canonical proto-aligned AgentCard shape.
+    // - No top-level `id` or `url` (proto has neither at AgentCard level)
+    // - Endpoint URL lives in supportedInterfaces[].url
+    // - description, supportedInterfaces, defaultInputModes,
+    //   defaultOutputModes, skills are all REQUIRED per proto
+    const endpointUrl = `${inputs.url.replace(/\/+$/, '')}${A2A_ENDPOINT_PATH}`;
     const card = {
-        id: `${inputs.project}-${inputs.agentName}`,
         name: inputs.agentName,
-        description: `MACF agent (${inputs.agentRole}) in project ${inputs.project}. Coordinates with peer MACF agents over mTLS-authenticated channels.`,
-        url: inputs.url,
+        description: `MACF ${inputs.agentRole} agent in project ${inputs.project}. Coordinates with peer MACF agents over mTLS-authenticated channels; serves A2A v1.0 inbound message/send at /a2a/v1.`,
         version: inputs.version,
         provider: {
             organization: `groundnuty/macf (${inputs.project})`,
             url: 'https://github.com/groundnuty/macf',
         },
         capabilities: {
-        // Phase 1: no claimed capabilities; Phase 2 will populate as
-        // inbound A2A JSON-RPC `message/send` + task lifecycle land.
+            streaming: false,
+            pushNotifications: false,
         },
         securitySchemes: {
             mutual_tls: {
@@ -143,9 +212,33 @@ export function buildAgentCard(inputs) {
             },
         },
         security: [{ mutual_tls: [] }],
-        defaultInputModes: ['application/json'],
-        defaultOutputModes: ['application/json'],
-        skills: [],
+        supportedInterfaces: [
+            {
+                url: endpointUrl,
+                protocolBinding: 'JSONRPC',
+                protocolVersion: '1.0',
+            },
+        ],
+        defaultInputModes: ['text/plain', 'application/json'],
+        defaultOutputModes: ['text/plain', 'application/json'],
+        skills: [
+            {
+                id: 'macf.notify_peer',
+                name: 'Cross-Agent Notification',
+                description: 'Send a notification to a peer MACF agent. Used for issue/PR routing, CI-completion signaling, and ad-hoc cross-agent messaging. Sender-side delivery is mTLS-authenticated; receiver dispatches based on notification type.',
+                tags: ['notification', 'coordination', 'multi-agent'],
+                inputModes: ['application/json'],
+                outputModes: ['application/json'],
+            },
+            {
+                id: 'macf.checkpoint_to_memory',
+                name: 'Persist Context to Memory',
+                description: 'Persist current session context to MACF memory layer. Invoked via PreCompact hook (DR-023 §UC-3) or manually before long pauses. Returns a memory-file reference for later recall.',
+                tags: ['memory', 'persistence', 'checkpoint'],
+                inputModes: ['application/json'],
+                outputModes: ['application/json'],
+            },
+        ],
     };
     // Defense-in-depth: validate our own output before returning.
     // Catches bugs where a field shape drifts from the schema without

package/dist/agent-card.js.map

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

package/dist/https.d.ts

@@ -1,4 +1,5 @@
 import type { NotifyPayload, SignRequest, HealthResponse, HttpsServer, Logger } from '@groundnuty/macf-core';
+import type { TaskStore } from './a2a-task.js';
 export declare const PORT_RANGE_START = 8800;
 export declare const PORT_RANGE_SIZE = 1000;
 export declare const CLIENT_AUTH_EKU_OID = "1.3.6.1.5.5.7.3.2";
@@ -28,6 +29,17 @@ export declare function createHttpsServer(config: {
      * behavior change to existing endpoints.
      */
     readonly agentCard?: unknown;
+    /**
+     * A2A v1.0 inbound task store for `message/send` JSON-RPC handling
+     * at `/a2a/v1` (groundnuty/macf#390 Phase 2a). Optional — pre-#390
+     * channel-servers skip the route and return 404.
+     *
+     * Phase 2a: in-memory `Map<taskId, Task>`. Each request drives a
+     * fresh task through the happy path SUBMITTED → WORKING → COMPLETED.
+     * Phase 2b will exercise INPUT_REQUIRED / AUTH_REQUIRED + resume
+     * via `Message.taskId`.
+     */
+    readonly taskStore?: TaskStore;
     readonly logger: Logger;
 }): HttpsServer;
 //# sourceMappingURL=https.d.ts.map

package/dist/https.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"https.d.ts","sourceRoot":"","sources":["../src/https.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,aAAa,EAAE,WAAW,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAM7G,eAAO,MAAM,gBAAgB,OAAO,CAAC;AACrC,eAAO,MAAM,eAAe,OAAO,CAAC;AAQpC,eAAO,MAAM,mBAAmB,sBAAsB,CAAC;AAEvD;;;;;;GAMG;AACH,wBAAgB,wBAAwB,CAAC,QAAQ,EAAE;IACjD,QAAQ,CAAC,aAAa,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CAC5C,GAAG,OAAO,CAGV;AAUD,wBAAgB,UAAU,IAAI,MAAM,CAEnC;AAyDD,wBAAgB,iBAAiB,CAAC,MAAM,EAAE;IACxC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,QAAQ,EAAE,CAAC,OAAO,EAAE,aAAa,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC7D,QAAQ,CAAC,QAAQ,EAAE,MAAM,cAAc,CAAC;IACxC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,WAAW,KAAK,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IAC7E;;;;;;OAMG;IACH,QAAQ,CAAC,SAAS,CAAC,EAAE,OAAO,CAAC;IAC7B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB,GAAG,WAAW,CA6Yd"}
+{"version":3,"file":"https.d.ts","sourceRoot":"","sources":["../src/https.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,aAAa,EAAE,WAAW,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAC;AA+B7G,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAG/C,eAAO,MAAM,gBAAgB,OAAO,CAAC;AACrC,eAAO,MAAM,eAAe,OAAO,CAAC;AAQpC,eAAO,MAAM,mBAAmB,sBAAsB,CAAC;AAEvD;;;;;;GAMG;AACH,wBAAgB,wBAAwB,CAAC,QAAQ,EAAE;IACjD,QAAQ,CAAC,aAAa,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CAC5C,GAAG,OAAO,CAGV;AAUD,wBAAgB,UAAU,IAAI,MAAM,CAEnC;AA+ED,wBAAgB,iBAAiB,CAAC,MAAM,EAAE;IACxC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,QAAQ,EAAE,CAAC,OAAO,EAAE,aAAa,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC7D,QAAQ,CAAC,QAAQ,EAAE,MAAM,cAAc,CAAC;IACxC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,WAAW,KAAK,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IAC7E;;;;;;OAMG;IACH,QAAQ,CAAC,SAAS,CAAC,EAAE,OAAO,CAAC;IAC7B;;;;;;;;;OASG;IACH,QAAQ,CAAC,SAAS,CAAC,EAAE,SAAS,CAAC;IAC/B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB,GAAG,WAAW,CAkxBd"}