@hanphone/dsh-a2a 0.1.0

package/lib/types/protocol.d.ts

@@ -0,0 +1,194 @@
+/**
+ * Agent2Agent (A2A) Protocol v1.0 — types, task states, JSON-RPC methods and
+ * error codes used by this plugin's JSON-RPC over HTTP binding.
+ *
+ * The surface mirrors the normative `a2a.proto` of the A2A project (Apache-2.0);
+ * this file is the plugin's own transcription and the single source of protocol
+ * truth. Bindings other than JSON-RPC over HTTP (gRPC, REST) are not provided.
+ * @module dsh-a2a/protocol
+ */
+/** Task lifecycle states (spec `TaskState`). */
+export declare enum TaskState {
+    SUBMITTED = "SUBMITTED",
+    WORKING = "WORKING",
+    INPUT_REQUIRED = "INPUT_REQUIRED",
+    AUTH_REQUIRED = "AUTH_REQUIRED",
+    COMPLETED = "COMPLETED",
+    FAILED = "FAILED",
+    CANCELED = "CANCELED",
+    REJECTED = "REJECTED"
+}
+/** States that settle a task; a settled task no longer transitions. */
+export declare const TERMINAL_STATES: ReadonlySet<TaskState>;
+/** @returns whether the state settles the task. */
+export declare function isTerminal(state: TaskState): boolean;
+/** Message sender role (spec `Role`). */
+export declare enum Role {
+    USER = "user",
+    AGENT = "agent"
+}
+/** One message part: text, file (bytes or uri), or structured data. */
+export type Part = {
+    readonly text: string;
+    readonly metadata?: Record<string, unknown>;
+} | {
+    readonly file: {
+        readonly mimeType?: string;
+        readonly name?: string;
+        readonly bytes?: string;
+        readonly uri?: string;
+    };
+    readonly metadata?: Record<string, unknown>;
+} | {
+    readonly data: unknown;
+    readonly metadata?: Record<string, unknown>;
+};
+/** An interaction payload exchanged between agents. */
+export interface Message {
+    readonly messageId: string;
+    readonly role: Role;
+    readonly contextId?: string;
+    /** Continuation: attaches this message to an existing task's conversation. */
+    readonly taskId?: string;
+    readonly parts: readonly Part[];
+    readonly metadata?: Record<string, unknown>;
+}
+/** Current state of a task, with an optional explanatory message. */
+export interface TaskStatus {
+    readonly state: TaskState;
+    readonly message?: Message;
+    readonly timestamp: string;
+}
+/** A chunk of task output. */
+export interface Artifact {
+    readonly name?: string;
+    readonly parts: readonly Part[];
+    readonly artifactId?: string;
+}
+/** A task: the durable work unit of A2A. */
+export interface Task {
+    readonly id: string;
+    readonly contextId?: string;
+    readonly status: TaskStatus;
+    readonly artifacts?: readonly Artifact[];
+    readonly history?: readonly Message[];
+    readonly metadata?: Record<string, unknown>;
+}
+/** JSON-RPC 2.0 request as used by the A2A binding. */
+export interface JsonRpcRequest {
+    readonly jsonrpc: '2.0';
+    readonly id?: string | number | null;
+    readonly method: string;
+    readonly params?: unknown;
+}
+export interface JsonRpcSuccess {
+    readonly jsonrpc: '2.0';
+    readonly id: string | number | null;
+    readonly result: unknown;
+}
+export interface JsonRpcErrorBody {
+    readonly code: number;
+    readonly message: string;
+    readonly data?: unknown;
+}
+export interface JsonRpcError {
+    readonly jsonrpc: '2.0';
+    readonly id: string | number | null;
+    readonly error: JsonRpcErrorBody;
+}
+export type JsonRpcResponse = JsonRpcSuccess | JsonRpcError;
+/** A skill advertised by an agent. */
+export interface AgentSkill {
+    readonly id: string;
+    readonly name?: string;
+    readonly description?: string;
+    readonly tags?: readonly string[];
+    readonly examples?: readonly string[];
+    readonly inputModes?: readonly string[];
+    readonly outputModes?: readonly string[];
+}
+export interface AgentCapabilities {
+    readonly streaming?: boolean;
+    readonly pushNotifications?: boolean;
+    readonly stateTransitionHistory?: boolean;
+    readonly extensions?: readonly string[];
+}
+/** One supported interface (transport binding) of an agent. */
+export interface AgentInterface {
+    readonly url: string;
+    readonly protocolBinding?: 'JSONRPC' | 'REST' | 'gRPC' | string;
+    readonly protocolVersion?: string;
+    readonly authSchemes?: readonly string[];
+}
+/** Bearer-token security scheme advertised by the AgentCard. */
+export interface AgentSecurityScheme {
+    readonly type: 'http';
+    readonly scheme: 'bearer';
+    readonly description?: string;
+}
+/** The discovery manifest of an A2A agent. */
+export interface AgentCard {
+    readonly name: string;
+    readonly description: string;
+    readonly version: string;
+    readonly url?: string;
+    readonly provider?: {
+        readonly url: string;
+        readonly organization: string;
+    };
+    readonly skills?: readonly AgentSkill[];
+    readonly capabilities?: AgentCapabilities;
+    readonly defaultInputModes?: readonly string[];
+    readonly defaultOutputModes?: readonly string[];
+    readonly securitySchemes?: Record<string, AgentSecurityScheme>;
+    readonly securityRequirements?: readonly Record<string, readonly string[]>[];
+    readonly supportedInterfaces?: readonly AgentInterface[];
+    readonly custom?: Record<string, unknown>;
+}
+/** Streamed updates during a task run (SSE payloads). */
+export type StreamResponse = {
+    readonly statusUpdate: {
+        readonly taskId: string;
+        readonly contextId?: string;
+        readonly status: TaskStatus;
+    };
+} | {
+    readonly artifactUpdate: {
+        readonly taskId: string;
+        readonly contextId?: string;
+        readonly artifact: Artifact;
+        readonly lastChunk?: boolean;
+    };
+} | {
+    readonly task: Task;
+} | {
+    readonly error: {
+        readonly code: number;
+        readonly message: string;
+    };
+};
+/** A2A v1.0 JSON-RPC method names (canonical PascalCase as in a2a.proto). */
+export declare const A2A_METHODS: {
+    readonly sendMessage: "SendMessage";
+    readonly sendStreamingMessage: "SendStreamingMessage";
+    readonly getTask: "GetTask";
+    readonly listTasks: "ListTasks";
+    readonly cancelTask: "CancelTask";
+    readonly subscribeToTask: "SubscribeToTask";
+    readonly getExtendedAgentCard: "GetExtendedAgentCard";
+};
+/** JSON-RPC error codes for the A2A binding (spec §error codes). */
+export declare const A2A_ERROR_CODES: {
+    readonly INVALID_REQUEST: -32600;
+    readonly METHOD_NOT_FOUND: -32601;
+    readonly INVALID_PARAMS: -32602;
+    readonly INTERNAL_ERROR: -32603;
+    readonly UNAUTHORIZED: -32000;
+    readonly TASK_NOT_FOUND: -32001;
+    readonly TASK_CANCEL_NOT_ALLOWED: -32002;
+    readonly AGENT_CARD_NOT_FOUND: -32004;
+    readonly AGENT_CARD_SIGNATURE_INVALID: -32005;
+};
+/** Read a message's text parts as a single string (model-facing convenience). */
+export declare function partsToText(parts: readonly Part[] | undefined): string;
+//# sourceMappingURL=protocol.d.ts.map

package/lib/types/protocol.d.ts.map

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

package/lib/types/protocol.js

@@ -0,0 +1,78 @@
+/**
+ * Agent2Agent (A2A) Protocol v1.0 — types, task states, JSON-RPC methods and
+ * error codes used by this plugin's JSON-RPC over HTTP binding.
+ *
+ * The surface mirrors the normative `a2a.proto` of the A2A project (Apache-2.0);
+ * this file is the plugin's own transcription and the single source of protocol
+ * truth. Bindings other than JSON-RPC over HTTP (gRPC, REST) are not provided.
+ * @module dsh-a2a/protocol
+ */
+/** Task lifecycle states (spec `TaskState`). */
+export var TaskState;
+(function (TaskState) {
+    TaskState["SUBMITTED"] = "SUBMITTED";
+    TaskState["WORKING"] = "WORKING";
+    TaskState["INPUT_REQUIRED"] = "INPUT_REQUIRED";
+    TaskState["AUTH_REQUIRED"] = "AUTH_REQUIRED";
+    TaskState["COMPLETED"] = "COMPLETED";
+    TaskState["FAILED"] = "FAILED";
+    TaskState["CANCELED"] = "CANCELED";
+    TaskState["REJECTED"] = "REJECTED";
+})(TaskState || (TaskState = {}));
+/** States that settle a task; a settled task no longer transitions. */
+export const TERMINAL_STATES = new Set([
+    TaskState.COMPLETED,
+    TaskState.FAILED,
+    TaskState.CANCELED,
+    TaskState.REJECTED,
+]);
+/** @returns whether the state settles the task. */
+export function isTerminal(state) {
+    return TERMINAL_STATES.has(state);
+}
+/** Message sender role (spec `Role`). */
+export var Role;
+(function (Role) {
+    Role["USER"] = "user";
+    Role["AGENT"] = "agent";
+})(Role || (Role = {}));
+/** A2A v1.0 JSON-RPC method names (canonical PascalCase as in a2a.proto). */
+export const A2A_METHODS = {
+    sendMessage: 'SendMessage',
+    sendStreamingMessage: 'SendStreamingMessage',
+    getTask: 'GetTask',
+    listTasks: 'ListTasks',
+    cancelTask: 'CancelTask',
+    subscribeToTask: 'SubscribeToTask',
+    getExtendedAgentCard: 'GetExtendedAgentCard',
+};
+/** JSON-RPC error codes for the A2A binding (spec §error codes). */
+export const A2A_ERROR_CODES = {
+    INVALID_REQUEST: -32600,
+    METHOD_NOT_FOUND: -32601,
+    INVALID_PARAMS: -32602,
+    INTERNAL_ERROR: -32603,
+    UNAUTHORIZED: -32000,
+    TASK_NOT_FOUND: -32001,
+    TASK_CANCEL_NOT_ALLOWED: -32002,
+    AGENT_CARD_NOT_FOUND: -32004,
+    AGENT_CARD_SIGNATURE_INVALID: -32005,
+};
+/** Read a message's text parts as a single string (model-facing convenience). */
+export function partsToText(parts) {
+    if (!parts)
+        return '';
+    return parts
+        .map((p) => {
+        if ('text' in p && p.text)
+            return p.text;
+        if ('data' in p && p.data !== undefined)
+            return JSON.stringify(p.data);
+        if ('file' in p)
+            return p.file.uri ?? `[file ${p.file.name ?? p.file.mimeType ?? 'binary'}]`;
+        return '';
+    })
+        .filter(Boolean)
+        .join('\n');
+}
+//# sourceMappingURL=protocol.js.map

package/lib/types/protocol.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"protocol.js","sourceRoot":"","sources":["../../src/protocol.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,gDAAgD;AAChD,MAAM,CAAN,IAAY,SASX;AATD,WAAY,SAAS;IACnB,oCAAuB,CAAA;IACvB,gCAAmB,CAAA;IACnB,8CAAiC,CAAA;IACjC,4CAA+B,CAAA;IAC/B,oCAAuB,CAAA;IACvB,8BAAiB,CAAA;IACjB,kCAAqB,CAAA;IACrB,kCAAqB,CAAA;AACvB,CAAC,EATW,SAAS,KAAT,SAAS,QASpB;AAED,uEAAuE;AACvE,MAAM,CAAC,MAAM,eAAe,GAA2B,IAAI,GAAG,CAAC;IAC7D,SAAS,CAAC,SAAS;IACnB,SAAS,CAAC,MAAM;IAChB,SAAS,CAAC,QAAQ;IAClB,SAAS,CAAC,QAAQ;CACnB,CAAC,CAAA;AAEF,mDAAmD;AACnD,MAAM,UAAU,UAAU,CAAC,KAAgB;IACzC,OAAO,eAAe,CAAC,GAAG,CAAC,KAAK,CAAC,CAAA;AACnC,CAAC;AAED,yCAAyC;AACzC,MAAM,CAAN,IAAY,IAGX;AAHD,WAAY,IAAI;IACd,qBAAa,CAAA;IACb,uBAAe,CAAA;AACjB,CAAC,EAHW,IAAI,KAAJ,IAAI,QAGf;AAwID,6EAA6E;AAC7E,MAAM,CAAC,MAAM,WAAW,GAAG;IACzB,WAAW,EAAE,aAAa;IAC1B,oBAAoB,EAAE,sBAAsB;IAC5C,OAAO,EAAE,SAAS;IAClB,SAAS,EAAE,WAAW;IACtB,UAAU,EAAE,YAAY;IACxB,eAAe,EAAE,iBAAiB;IAClC,oBAAoB,EAAE,sBAAsB;CACpC,CAAA;AAEV,oEAAoE;AACpE,MAAM,CAAC,MAAM,eAAe,GAAG;IAC7B,eAAe,EAAE,CAAC,KAAK;IACvB,gBAAgB,EAAE,CAAC,KAAK;IACxB,cAAc,EAAE,CAAC,KAAK;IACtB,cAAc,EAAE,CAAC,KAAK;IACtB,YAAY,EAAE,CAAC,KAAK;IACpB,cAAc,EAAE,CAAC,KAAK;IACtB,uBAAuB,EAAE,CAAC,KAAK;IAC/B,oBAAoB,EAAE,CAAC,KAAK;IAC5B,4BAA4B,EAAE,CAAC,KAAK;CAC5B,CAAA;AAEV,iFAAiF;AACjF,MAAM,UAAU,WAAW,CAAC,KAAkC;IAC5D,IAAI,CAAC,KAAK;QAAE,OAAO,EAAE,CAAA;IACrB,OAAO,KAAK;SACT,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE;QACT,IAAI,MAAM,IAAI,CAAC,IAAI,CAAC,CAAC,IAAI;YAAE,OAAO,CAAC,CAAC,IAAI,CAAA;QACxC,IAAI,MAAM,IAAI,CAAC,IAAI,CAAC,CAAC,IAAI,KAAK,SAAS;YAAE,OAAO,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,CAAA;QACtE,IAAI,MAAM,IAAI,CAAC;YAAE,OAAO,CAAC,CAAC,IAAI,CAAC,GAAG,IAAI,SAAS,CAAC,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,CAAC,IAAI,CAAC,QAAQ,IAAI,QAAQ,GAAG,CAAA;QAC5F,OAAO,EAAE,CAAA;IACX,CAAC,CAAC;SACD,MAAM,CAAC,OAAO,CAAC;SACf,IAAI,CAAC,IAAI,CAAC,CAAA;AACf,CAAC"}

package/lib/types/server/a2a-server.d.ts

@@ -0,0 +1,98 @@
+/**
+ * The inbound A2A server: JSON-RPC dispatch, the task lifecycle, and SSE
+ * streaming. Transport-agnostic — `handle` / `handleStream` take a structural
+ * request and return bytes; the HTTP binding lives in routes.ts.
+ * @module dsh-a2a/server/a2a-server
+ */
+import { type AgentCard, type Part } from '../protocol.ts';
+import type { TaskStore } from './store.ts';
+import type { ExecutorSet } from './executor.ts';
+/** What the policy gate sees for one inbound task. */
+export interface GateInput {
+    readonly contextId: string;
+    readonly skill: string;
+    readonly parts: readonly Part[];
+    readonly remotePeerId: string | null;
+}
+export type GateResult = {
+    readonly ok: true;
+} | {
+    readonly ok: false;
+    readonly reason: string;
+};
+/** Observational facts about one inbound JSON-RPC request. */
+export interface InboundFacts {
+    readonly method: string;
+    readonly source?: string;
+    readonly taskIds: readonly string[];
+    readonly streaming: boolean;
+}
+export interface A2AServerOptions {
+    readonly card: AgentCard;
+    readonly store: TaskStore;
+    readonly executors: ExecutorSet;
+    /** Present when inbound bearer auth is configured. */
+    readonly authToken?: string;
+    /** Policy gate: skill allow-list + the `a2a/inbound-task` waterfall. */
+    readonly gate: (input: GateInput) => Promise<GateResult>;
+    readonly onInbound?: (facts: InboundFacts) => void;
+    readonly onTaskSettled?: (taskId: string) => void;
+}
+/** Structural request the server handles (HTTP adapter fills it). */
+export interface ServerRequest {
+    readonly method?: string;
+    readonly url?: string;
+    readonly headers?: Record<string, string>;
+    readonly socket?: {
+        readonly remoteAddress?: string;
+        readonly remotePort?: number;
+    };
+}
+export interface ServerResponseSpec {
+    readonly status: number;
+    readonly contentType: string;
+    readonly body: string;
+    readonly headers?: Record<string, string>;
+}
+/** A2A JSON-RPC / SSE server over a structural request. */
+export declare class A2AServer {
+    private readonly opts;
+    readonly card: AgentCard;
+    private readonly listeners;
+    private readonly waiters;
+    private readonly running;
+    constructor(opts: A2AServerOptions);
+    /**
+     * Abort a running task by control path (facade /a2a task cancel): abort the
+     * executor's signal, settle the task CANCELED, and wake stream waiters.
+     * @returns false when the task is unknown or already terminal.
+     */
+    abort(taskId: string): boolean;
+    /** True when the request carries the configured bearer token. */
+    authorized(req: ServerRequest): boolean;
+    /** Route one inbound HTTP request (GET card, POST JSON-RPC). */
+    handle(req: ServerRequest, body: string): Promise<ServerResponseSpec>;
+    /**
+     * Route one SSE request (SendStreamingMessage / SubscribeToTask). Frames are
+     * pushed to `onEvent` as they happen; the caller must have checked
+     * `authorized()` before writing 200 headers.
+     */
+    handleStream(req: ServerRequest, body: string, onEvent: (frame: string) => void): Promise<{
+        readonly status: number;
+        readonly headers?: Record<string, string>;
+    }>;
+    /** Dispatch one JSON-RPC request; throws {code, message} on errors. */
+    private dispatch;
+    /** Create (or continue) the task record for one message. */
+    private ensureTask;
+    /** Run one task to a terminal state, emitting status/artifact frames. */
+    private runTask;
+    /** Build the event sink that folds executor events into store + frames. */
+    private eventSink;
+    private emit;
+    private noteInbound;
+    private remotePeerOf;
+    private waitTerminal;
+    private settle;
+}
+//# sourceMappingURL=a2a-server.d.ts.map

package/lib/types/server/a2a-server.d.ts.map

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