@plurnk/plurnk-contracts 6.0.1 → 7.0.0

package/dist/schema/A2aAgentDefinition.json

@@ -1,76 +0,0 @@
-{
-    "$schema": "https://json-schema.org/draft/2020-12/schema",
-    "$id": "https://schemas.plurnk.xyz/v0/A2aAgentDefinition.json",
-    "title": "A2aAgentDefinition",
-    "description": "One outbound A2A agent as the Worker Functionality coordinator persists it: the local alias, the remote base URL whose standard Agent Card is authoritative, and optional local connection facts. Secrets stay symbolic environment references.",
-    "type": "object",
-    "additionalProperties": false,
-    "required": ["name", "url"],
-    "properties": {
-        "name": {
-            "description": "The local alias: the `a2a://<name>` authority.",
-            "type": "string",
-            "pattern": "^[a-z][a-z0-9-]*$"
-        },
-        "url": {
-            "description": "The remote agent's absolute HTTP(S) base URL; its Agent Card is discovered at the standard well-known path unless `cardPath` names another.",
-            "type": "string",
-            "pattern": "^https?://"
-        },
-        "cardPath": {
-            "description": "An absolute URL pathname replacing the standard Agent Card path.",
-            "type": "string",
-            "pattern": "^/[^?#]*$"
-        },
-        "headers": {
-            "description": "Extra request headers; values may be symbolic `${NAME}` environment references.",
-            "type": "object",
-            "additionalProperties": { "type": "string" }
-        },
-        "authorization": {
-            "description": "How the daemon authenticates to the agent: a fixed bearer, or OAuth 2.0 client credentials obtained from the agent's declared token endpoint.",
-            "oneOf": [
-                {
-                    "type": "object",
-                    "additionalProperties": false,
-                    "required": ["type", "token"],
-                    "properties": {
-                        "type": { "const": "bearer" },
-                        "token": {
-                            "description": "A symbolic `${NAME}` environment reference; the secret is never persisted.",
-                            "type": "string",
-                            "pattern": "^\\$\\{[A-Za-z_][A-Za-z0-9_]*\\}$"
-                        }
-                    }
-                },
-                {
-                    "type": "object",
-                    "additionalProperties": false,
-                    "required": ["type", "clientId", "clientSecret"],
-                    "properties": {
-                        "type": { "const": "oauth2" },
-                        "clientId": {
-                            "description": "The client id the agent's authorization server knows this daemon by.",
-                            "type": "string",
-                            "minLength": 1
-                        },
-                        "clientSecret": {
-                            "description": "A symbolic `${NAME}` environment reference to the client secret; the secret is never persisted.",
-                            "type": "string",
-                            "pattern": "^\\$\\{[A-Za-z_][A-Za-z0-9_]*\\}$"
-                        },
-                        "tokenUrl": {
-                            "description": "The token endpoint; omitted, the Agent Card's clientCredentials flow names it.",
-                            "type": "string",
-                            "pattern": "^https?://"
-                        },
-                        "scope": {
-                            "description": "The scope to request, space-separated; omitted, every scope the card's flow offers.",
-                            "type": "string"
-                        }
-                    }
-                }
-            ]
-        }
-    }
-}

package/dist/schema/AguiClientConformance.json

@@ -1,74 +0,0 @@
-{
-    "$schema": "https://json-schema.org/draft/2020-12/schema",
-    "$id": "https://schemas.plurnk.xyz/v0/AguiClientConformance.json",
-    "title": "AguiClientConformance",
-    "description": "One client's exhaustive, evidence-bearing disposition for an installed AG-UI discovery surface.",
-    "type": "object",
-    "required": ["schemaVersion", "client", "actions", "notifications"],
-    "additionalProperties": false,
-    "properties": {
-        "schemaVersion": { "const": 1 },
-        "client": { "type": "string", "minLength": 1 },
-        "actions": {
-            "type": "object",
-            "propertyNames": { "type": "string", "minLength": 1 },
-            "additionalProperties": { "$ref": "#/$defs/disposition" }
-        },
-        "notifications": {
-            "type": "object",
-            "propertyNames": { "type": "string", "minLength": 1 },
-            "additionalProperties": { "$ref": "#/$defs/disposition" }
-        }
-    },
-    "$defs": {
-        "evidence": {
-            "type": "array",
-            "minItems": 1,
-            "uniqueItems": true,
-            "items": { "type": "string", "minLength": 1 }
-        },
-        "dimensions": {
-            "type": "array",
-            "minItems": 1,
-            "uniqueItems": true,
-            "items": {
-                "enum": [
-                    "admission",
-                    "projection",
-                    "framing",
-                    "success",
-                    "failure",
-                    "lifecycle",
-                    "durability",
-                    "composition",
-                    "presentation"
-                ]
-            }
-        },
-        "disposition": {
-            "oneOf": [
-                {
-                    "type": "object",
-                    "required": ["posture", "dimensions", "evidence"],
-                    "additionalProperties": false,
-                    "properties": {
-                        "posture": { "enum": ["native", "generic"] },
-                        "dimensions": { "$ref": "#/$defs/dimensions" },
-                        "evidence": { "$ref": "#/$defs/evidence" }
-                    }
-                },
-                {
-                    "type": "object",
-                    "required": ["posture", "reason", "dimensions", "evidence"],
-                    "additionalProperties": false,
-                    "properties": {
-                        "posture": { "const": "unsupported" },
-                        "reason": { "type": "string", "minLength": 1 },
-                        "dimensions": { "$ref": "#/$defs/dimensions" },
-                        "evidence": { "$ref": "#/$defs/evidence" }
-                    }
-                }
-            ]
-        }
-    }
-}

package/dist/schema/AguiConformanceKit.json

@@ -1,111 +0,0 @@
-{
-    "$schema": "https://json-schema.org/draft/2020-12/schema",
-    "$id": "https://schemas.plurnk.xyz/v0/AguiConformanceKit.json",
-    "title": "AguiConformanceKit",
-    "description": "Language-neutral raw SSE and AG-UI lifecycle specimens consumed by every Plurnk client.",
-    "type": "object",
-    "required": ["schemaVersion", "transport", "lifecycles"],
-    "additionalProperties": false,
-    "properties": {
-        "schemaVersion": { "const": 1 },
-        "transport": {
-            "type": "array",
-            "minItems": 1,
-            "items": { "$ref": "#/$defs/transportSpecimen" }
-        },
-        "lifecycles": {
-            "type": "array",
-            "minItems": 1,
-            "items": { "$ref": "#/$defs/lifecycleSpecimen" }
-        }
-    },
-    "$defs": {
-        "name": {
-            "type": "string",
-            "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$"
-        },
-        "event": {
-            "type": "object",
-            "required": ["type"],
-            "properties": { "type": { "type": "string", "minLength": 1 } },
-            "additionalProperties": true
-        },
-        "transportSpecimen": {
-            "type": "object",
-            "required": ["name", "chunks", "eof", "expect"],
-            "additionalProperties": false,
-            "properties": {
-                "name": { "$ref": "#/$defs/name" },
-                "chunks": {
-                    "type": "array",
-                    "minItems": 1,
-                    "items": { "type": "string", "minLength": 1 }
-                },
-                "eof": { "type": "boolean" },
-                "expect": {
-                    "oneOf": [
-                        {
-                            "type": "object",
-                            "required": ["events"],
-                            "additionalProperties": false,
-                            "properties": {
-                                "events": {
-                                    "type": "array",
-                                    "items": { "$ref": "#/$defs/event" }
-                                }
-                            }
-                        },
-                        {
-                            "type": "object",
-                            "required": ["error"],
-                            "additionalProperties": false,
-                            "properties": {
-                                "error": { "enum": ["invalid-json"] }
-                            }
-                        }
-                    ]
-                }
-            }
-        },
-        "actionExpectation": {
-            "type": "object",
-            "required": ["kind", "ok"],
-            "additionalProperties": false,
-            "properties": {
-                "kind": { "type": "string", "minLength": 1 },
-                "ok": { "type": "boolean" },
-                "status": { "type": "integer", "minimum": 100, "maximum": 599 }
-            }
-        },
-        "lifecycleExpectation": {
-            "type": "object",
-            "required": ["completion", "families"],
-            "additionalProperties": false,
-            "properties": {
-                "completion": { "enum": ["success", "interrupt", "error", "dead-stream"] },
-                "families": {
-                    "type": "array",
-                    "uniqueItems": true,
-                    "items": { "type": "string", "minLength": 1 }
-                },
-                "status": { "type": "integer", "minimum": 100, "maximum": 599 },
-                "interrupt": { "enum": ["proposal", "interaction"] },
-                "action": { "$ref": "#/$defs/actionExpectation" }
-            }
-        },
-        "lifecycleSpecimen": {
-            "type": "object",
-            "required": ["name", "events", "expect"],
-            "additionalProperties": false,
-            "properties": {
-                "name": { "$ref": "#/$defs/name" },
-                "events": {
-                    "type": "array",
-                    "minItems": 1,
-                    "items": { "$ref": "#/$defs/event" }
-                },
-                "expect": { "$ref": "#/$defs/lifecycleExpectation" }
-            }
-        }
-    }
-}

package/dist/src/AguiConformance.d.ts

@@ -1,11 +0,0 @@
-import type { Dimensions } from "./types.generated.ts";
-export interface AguiConformanceRow {
-    readonly kind: "action" | "notification";
-    readonly name: string;
-    readonly posture: "native" | "generic" | "unsupported";
-    readonly dimensions: Dimensions;
-    readonly evidence: readonly string[];
-    readonly reason?: string;
-}
-export declare const aguiConformanceReport: (discoveryValue: unknown, conformanceValue: unknown) => AguiConformanceRow[];
-//# sourceMappingURL=AguiConformance.d.ts.map

package/dist/src/AguiConformance.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"AguiConformance.d.ts","sourceRoot":"","sources":["../../src/AguiConformance.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAEvD,MAAM,WAAW,kBAAkB;IAC/B,QAAQ,CAAC,IAAI,EAAE,QAAQ,GAAG,cAAc,CAAC;IACzC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,QAAQ,GAAG,SAAS,GAAG,aAAa,CAAC;IACvD,QAAQ,CAAC,UAAU,EAAE,UAAU,CAAC;IAChC,QAAQ,CAAC,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAC;IACrC,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED,eAAO,MAAM,qBAAqB,mBACd,OAAO,oBACL,OAAO,KAC1B,kBAAkB,EAmBpB,CAAC"}

package/dist/src/AguiConformance.js

@@ -1,16 +0,0 @@
-import Validator from "./Validator.js";
-export const aguiConformanceReport = (discoveryValue, conformanceValue) => {
-    const conformance = Validator.assertAguiClientConformance(discoveryValue, conformanceValue);
-    const rows = (kind, label) => Object.entries(conformance[kind])
-        .toSorted(([left], [right]) => left.localeCompare(right))
-        .map(([name, disposition]) => ({
-        kind: label,
-        name,
-        posture: disposition.posture,
-        dimensions: disposition.dimensions,
-        evidence: disposition.evidence,
-        ...(disposition.posture === "unsupported" ? { reason: disposition.reason } : {}),
-    }));
-    return [...rows("actions", "action"), ...rows("notifications", "notification")];
-};
-//# sourceMappingURL=AguiConformance.js.map

package/dist/src/AguiConformance.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"AguiConformance.js","sourceRoot":"","sources":["../../src/AguiConformance.ts"],"names":[],"mappings":"AAAA,OAAO,SAAS,MAAM,gBAAgB,CAAC;AAYvC,MAAM,CAAC,MAAM,qBAAqB,GAAG,CACjC,cAAuB,EACvB,gBAAyB,EACL,EAAE;IACtB,MAAM,WAAW,GAAG,SAAS,CAAC,2BAA2B,CACrD,cAAc,EACd,gBAAgB,CACnB,CAAC;IACF,MAAM,IAAI,GAAG,CACT,IAAiC,EACjC,KAAiC,EACb,EAAE,CAAC,MAAM,CAAC,OAAO,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC;SACvD,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,KAAK,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC;SACxD,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,WAAW,CAAC,EAAE,EAAE,CAAC,CAAC;QAC3B,IAAI,EAAE,KAAK;QACX,IAAI;QACJ,OAAO,EAAE,WAAW,CAAC,OAAO;QAC5B,UAAU,EAAE,WAAW,CAAC,UAAU;QAClC,QAAQ,EAAE,WAAW,CAAC,QAAQ;QAC9B,GAAG,CAAC,WAAW,CAAC,OAAO,KAAK,aAAa,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,WAAW,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KACnF,CAAC,CAAC,CAAC;IACR,OAAO,CAAC,GAAG,IAAI,CAAC,SAAS,EAAE,QAAQ,CAAC,EAAE,GAAG,IAAI,CAAC,eAAe,EAAE,cAAc,CAAC,CAAC,CAAC;AACpF,CAAC,CAAC"}