octoflow-core 1.0.0

package/dist/adapters/transport/client.js

@@ -0,0 +1,324 @@
+import crypto from "node:crypto";
+import {
+  buildUserMessage,
+  consumeSse,
+  delay,
+  exitCodeForState,
+  extractContextIdFromSendResponse,
+  extractContextIdFromStream,
+  extractStateFromStream,
+  extractTaskIdFromStream,
+  extractTextFromSendResponse,
+  extractTextFromStream,
+  isTerminalState
+} from "./a2a-client-helpers.js";
+import {
+  A2AClientError,
+  A2AContractError
+} from "./client-errors.js";
+import { A2AClientError as A2AClientError2, A2AContractError as A2AContractError2 } from "./client-errors.js";
+function buildRequestSignal(timeoutMs, signal) {
+  const signals = [];
+  if (typeof timeoutMs === "number") {
+    signals.push(AbortSignal.timeout(timeoutMs));
+  }
+  if (signal) {
+    signals.push(signal);
+  }
+  if (signals.length === 0) {
+    return void 0;
+  }
+  return signals.length === 1 ? signals[0] : AbortSignal.any(signals);
+}
+function errorFromAbortSignal(signal) {
+  return signal.reason instanceof Error ? signal.reason : new Error(String(signal.reason ?? "Aborted"));
+}
+function streamErrorCode(initialSent) {
+  return initialSent ? "SSE_RECONNECT_EXHAUSTED" : "SSE_CONNECTION_FAILED";
+}
+async function delayWithSignal(ms, signal) {
+  if (!signal) {
+    await delay(ms);
+    return;
+  }
+  if (signal.aborted) {
+    throw errorFromAbortSignal(signal);
+  }
+  await new Promise((resolve, reject) => {
+    const timer = setTimeout(() => {
+      cleanup();
+      resolve();
+    }, ms);
+    const onAbort = () => {
+      cleanup();
+      reject(errorFromAbortSignal(signal));
+    };
+    const cleanup = () => {
+      clearTimeout(timer);
+      signal.removeEventListener("abort", onAbort);
+    };
+    signal.addEventListener("abort", onAbort, { once: true });
+  });
+}
+class A2ASession {
+  constructor(client, opts) {
+    this.client = client;
+    this.opts = opts;
+  }
+  client;
+  opts;
+  contextId = null;
+  turnCount = 0;
+  get turns() {
+    return this.turnCount;
+  }
+  get id() {
+    return this.contextId;
+  }
+  async send(prompt, opts) {
+    const result = await this.client.run(prompt, {
+      ...opts ?? this.opts,
+      contextId: this.contextId ?? void 0
+    });
+    this.contextId = result.sessionId;
+    this.turnCount++;
+    return result;
+  }
+  async stream(prompt, onEvent, opts) {
+    const result = await this.client.stream(prompt, onEvent, {
+      ...opts ?? this.opts,
+      contextId: this.contextId ?? void 0
+    });
+    this.contextId = result.sessionId;
+    this.turnCount++;
+    return result;
+  }
+  reset() {
+    this.contextId = null;
+    this.turnCount = 0;
+  }
+}
+function readRunContextId(opts) {
+  if (!opts || !("contextId" in opts)) return void 0;
+  return typeof opts.contextId === "string" ? opts.contextId : void 0;
+}
+class A2AClient {
+  url;
+  apiKey;
+  customHeaders;
+  timeoutMs;
+  maxReconnectAttempts;
+  reconnectDelayMs;
+  constructor(options) {
+    this.url = options.url;
+    this.apiKey = options.apiKey;
+    this.customHeaders = options.headers ?? {};
+    this.timeoutMs = options.timeoutMs ?? 3e5;
+    this.maxReconnectAttempts = options.maxReconnectAttempts ?? 3;
+    this.reconnectDelayMs = options.reconnectDelayMs ?? 1e3;
+  }
+  async isReady() {
+    try {
+      const baseUrl = this.url.replace(/\/rpc\/?$/, "");
+      const response = await fetch(`${baseUrl}/.well-known/agent.json`, {
+        headers: this.buildHeaders(),
+        signal: AbortSignal.timeout(5e3)
+      });
+      return response.ok;
+    } catch {
+      return false;
+    }
+  }
+  async run(prompt, opts) {
+    const rpcId = crypto.randomUUID();
+    const contextId = readRunContextId(opts);
+    const signal = buildRequestSignal(
+      opts?.timeoutMs ?? this.timeoutMs,
+      opts?.signal
+    );
+    const body = JSON.stringify({
+      jsonrpc: "2.0",
+      id: rpcId,
+      method: "SendMessage",
+      params: {
+        ...contextId ? { contextId } : {},
+        configuration: { returnImmediately: false },
+        message: buildUserMessage(prompt)
+      }
+    });
+    const response = await fetch(this.url, {
+      method: "POST",
+      headers: { ...this.buildHeaders(), "Content-Type": "application/json" },
+      body,
+      signal
+    });
+    if (!response.ok) {
+      throw new A2AClientError(
+        "HTTP_ERROR",
+        `HTTP ${response.status}: ${response.statusText}`
+      );
+    }
+    const json = await response.json();
+    if (json.error) {
+      throw new A2AClientError("REMOTE_ERROR", JSON.stringify(json.error));
+    }
+    const result = json.result;
+    const taskState = result?.task?.status.state;
+    const sessionId = result ? extractContextIdFromSendResponse(result) : null;
+    if (result && sessionId == null) {
+      throw new A2AContractError(
+        "contextId",
+        "A2A SendMessage response is missing contextId \u2014 multi-turn continuity requires it"
+      );
+    }
+    return {
+      text: result ? extractTextFromSendResponse(result) : "",
+      events: [],
+      sessionId,
+      usage: null,
+      costUsd: null,
+      exitCode: exitCodeForState(taskState),
+      backend: "a2a"
+    };
+  }
+  async stream(prompt, onEvent, opts) {
+    const rpcId = crypto.randomUUID();
+    const signal = buildRequestSignal(
+      opts?.timeoutMs ?? this.timeoutMs,
+      opts?.signal
+    );
+    const callerSignal = opts?.signal;
+    let attempt = 0;
+    let contextId = readRunContextId(opts);
+    let initialSent = false;
+    let lastEventId;
+    let lastText = "";
+    let taskId = crypto.randomUUID();
+    while (true) {
+      const isReconnect = initialSent && lastEventId != null;
+      const method = isReconnect ? "SubscribeToTask" : "SendStreamingMessage";
+      const params = isReconnect ? {
+        afterEventId: lastEventId,
+        ...contextId ? { contextId } : {},
+        id: taskId
+      } : {
+        ...contextId ? { contextId } : {},
+        configuration: { returnImmediately: true },
+        ...taskId ? { taskId } : {},
+        message: buildUserMessage(prompt)
+      };
+      const headers = {
+        ...this.buildHeaders(),
+        "Content-Type": "application/json",
+        Accept: "text/event-stream",
+        ...isReconnect && lastEventId ? { "Last-Event-ID": lastEventId } : {}
+      };
+      const body = JSON.stringify({
+        jsonrpc: "2.0",
+        id: rpcId,
+        method,
+        params
+      });
+      let response;
+      try {
+        response = await fetch(this.url, {
+          method: "POST",
+          headers,
+          body,
+          signal
+        });
+      } catch (err) {
+        if (callerSignal?.aborted) {
+          throw err;
+        }
+        if (signal?.aborted || attempt >= this.maxReconnectAttempts) {
+          throw new A2AClientError(streamErrorCode(initialSent), String(err));
+        }
+        await delayWithSignal(this.reconnectDelayMs * 2 ** attempt, signal);
+        attempt++;
+        continue;
+      }
+      if (!response.ok) {
+        throw new A2AClientError("SSE_HTTP_ERROR", `HTTP ${response.status}`);
+      }
+      initialSent = true;
+      try {
+        for await (const event of consumeSse(response)) {
+          if (event.id) lastEventId = event.id;
+          try {
+            const parsed = JSON.parse(
+              event.data
+            );
+            if (parsed.error) {
+              throw new A2AClientError(
+                "REMOTE_ERROR",
+                JSON.stringify(parsed.error)
+              );
+            }
+            const result = parsed.result;
+            if (!result) continue;
+            taskId = extractTaskIdFromStream(result) ?? taskId;
+            contextId = contextId ?? extractContextIdFromStream(result);
+            const text = extractTextFromStream(result);
+            if (text) lastText = text;
+            const state = extractStateFromStream(result);
+            const final = result.message != null || isTerminalState(state);
+            try {
+              await onEvent({ type: final ? "result" : "text", text });
+            } catch {
+            }
+            if (final) {
+              return {
+                text: lastText,
+                events: [],
+                sessionId: contextId ?? null,
+                usage: null,
+                costUsd: null,
+                exitCode: exitCodeForState(state),
+                backend: "a2a"
+              };
+            }
+          } catch (err) {
+            if (err instanceof A2AClientError) throw err;
+          }
+        }
+        if (attempt >= this.maxReconnectAttempts) {
+          throw new A2AClientError(
+            "SSE_RECONNECT_EXHAUSTED",
+            "Stream ended without terminal event"
+          );
+        }
+        await delayWithSignal(this.reconnectDelayMs * 2 ** attempt, signal);
+        attempt++;
+      } catch (err) {
+        if (err instanceof A2AClientError) throw err;
+        if (callerSignal?.aborted) throw err;
+        if (signal?.aborted) {
+          throw new A2AClientError(streamErrorCode(initialSent), String(err));
+        }
+        if (attempt >= this.maxReconnectAttempts) {
+          throw new A2AClientError("SSE_RECONNECT_EXHAUSTED", String(err));
+        }
+        await delayWithSignal(this.reconnectDelayMs * 2 ** attempt, signal);
+        attempt++;
+      }
+    }
+  }
+  session(opts) {
+    return new A2ASession(this, opts);
+  }
+  buildHeaders() {
+    return {
+      "A2A-Version": "1.0",
+      ...this.apiKey ? { Authorization: `Bearer ${this.apiKey}` } : {},
+      ...this.customHeaders
+    };
+  }
+}
+export {
+  A2AClient,
+  A2AClientError2 as A2AClientError,
+  A2AContractError2 as A2AContractError,
+  A2ASession
+};
+//# sourceMappingURL=client.js.map

package/dist/adapters/transport/client.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/adapters/transport/client.ts"],
+  "sourcesContent": ["import crypto from 'node:crypto';\n\nimport type {\n  Client,\n  ClientSession,\n  RunOptions,\n  RunResult,\n  StreamCallback,\n} from '../../domain/core-client.js';\nimport {\n  type A2AJsonRpcPayload,\n  type A2ARunOptions,\n  buildUserMessage,\n  consumeSse,\n  delay,\n  exitCodeForState,\n  extractContextIdFromSendResponse,\n  extractContextIdFromStream,\n  extractStateFromStream,\n  extractTaskIdFromStream,\n  extractTextFromSendResponse,\n  extractTextFromStream,\n  isTerminalState,\n} from './a2a-client-helpers.js';\nimport {\n  A2AClientError,\n  type A2AClientErrorCode,\n  A2AContractError,\n} from './client-errors.js';\nimport type {\n  A2ASendMessageResponse,\n  A2AStreamResponse,\n} from './wire-types.js';\n\nexport type { A2AClientErrorCode } from './client-errors.js';\nexport { A2AClientError, A2AContractError } from './client-errors.js';\n\nexport interface A2AClientOptions {\n  url: string;\n  apiKey?: string;\n  headers?: Record<string, string>;\n  timeoutMs?: number;\n  maxReconnectAttempts?: number;\n  reconnectDelayMs?: number;\n}\n\nfunction buildRequestSignal(\n  timeoutMs: number | undefined,\n  signal?: AbortSignal\n): AbortSignal | undefined {\n  const signals: AbortSignal[] = [];\n  if (typeof timeoutMs === 'number') {\n    signals.push(AbortSignal.timeout(timeoutMs));\n  }\n  if (signal) {\n    signals.push(signal);\n  }\n  if (signals.length === 0) {\n    return undefined;\n  }\n  return signals.length === 1 ? signals[0] : AbortSignal.any(signals);\n}\n\nfunction errorFromAbortSignal(signal: AbortSignal): Error {\n  return signal.reason instanceof Error\n    ? signal.reason\n    : new Error(String(signal.reason ?? 'Aborted'));\n}\n\nfunction streamErrorCode(initialSent: boolean): A2AClientErrorCode {\n  return initialSent ? 'SSE_RECONNECT_EXHAUSTED' : 'SSE_CONNECTION_FAILED';\n}\n\nasync function delayWithSignal(\n  ms: number,\n  signal?: AbortSignal\n): Promise<void> {\n  if (!signal) {\n    await delay(ms);\n    return;\n  }\n  if (signal.aborted) {\n    throw errorFromAbortSignal(signal);\n  }\n\n  await new Promise<void>((resolve, reject) => {\n    const timer = setTimeout(() => {\n      cleanup();\n      resolve();\n    }, ms);\n\n    const onAbort = () => {\n      cleanup();\n      reject(errorFromAbortSignal(signal));\n    };\n\n    const cleanup = () => {\n      clearTimeout(timer);\n      signal.removeEventListener('abort', onAbort);\n    };\n\n    signal.addEventListener('abort', onAbort, { once: true });\n  });\n}\nexport class A2ASession implements ClientSession {\n  private contextId: string | null = null;\n  private turnCount = 0;\n\n  constructor(\n    private readonly client: A2AClient,\n    private readonly opts?: RunOptions\n  ) {}\n\n  get turns(): number {\n    return this.turnCount;\n  }\n  get id(): string | null {\n    return this.contextId;\n  }\n\n  async send(prompt: string, opts?: RunOptions): Promise<RunResult> {\n    const result = await this.client.run(prompt, {\n      ...(opts ?? this.opts),\n      contextId: this.contextId ?? undefined,\n    } as A2ARunOptions);\n    this.contextId = result.sessionId;\n    this.turnCount++;\n    return result;\n  }\n\n  async stream(\n    prompt: string,\n    onEvent: StreamCallback,\n    opts?: RunOptions\n  ): Promise<RunResult> {\n    const result = await this.client.stream(prompt, onEvent, {\n      ...(opts ?? this.opts),\n      contextId: this.contextId ?? undefined,\n    } as A2ARunOptions);\n    this.contextId = result.sessionId;\n    this.turnCount++;\n    return result;\n  }\n\n  reset(): void {\n    this.contextId = null;\n    this.turnCount = 0;\n  }\n}\nfunction readRunContextId(opts?: RunOptions): string | undefined {\n  if (!opts || !('contextId' in opts)) return undefined;\n  return typeof opts.contextId === 'string' ? opts.contextId : undefined;\n}\n\nexport class A2AClient implements Client {\n  private readonly url: string;\n  private readonly apiKey?: string;\n  private readonly customHeaders: Record<string, string>;\n  private readonly timeoutMs: number;\n  private readonly maxReconnectAttempts: number;\n  private readonly reconnectDelayMs: number;\n\n  constructor(options: A2AClientOptions) {\n    this.url = options.url;\n    this.apiKey = options.apiKey;\n    this.customHeaders = options.headers ?? {};\n    this.timeoutMs = options.timeoutMs ?? 300_000;\n    this.maxReconnectAttempts = options.maxReconnectAttempts ?? 3;\n    this.reconnectDelayMs = options.reconnectDelayMs ?? 1000;\n  }\n\n  async isReady(): Promise<boolean> {\n    try {\n      const baseUrl = this.url.replace(/\\/rpc\\/?$/, '');\n      const response = await fetch(`${baseUrl}/.well-known/agent.json`, {\n        headers: this.buildHeaders(),\n        signal: AbortSignal.timeout(5000),\n      });\n      return response.ok;\n    } catch {\n      return false;\n    }\n  }\n\n  async run(prompt: string, opts?: RunOptions): Promise<RunResult> {\n    const rpcId = crypto.randomUUID();\n    const contextId = readRunContextId(opts);\n    const signal = buildRequestSignal(\n      opts?.timeoutMs ?? this.timeoutMs,\n      opts?.signal\n    );\n    const body = JSON.stringify({\n      jsonrpc: '2.0',\n      id: rpcId,\n      method: 'SendMessage',\n      params: {\n        ...(contextId ? { contextId } : {}),\n        configuration: { returnImmediately: false },\n        message: buildUserMessage(prompt),\n      },\n    });\n\n    const response = await fetch(this.url, {\n      method: 'POST',\n      headers: { ...this.buildHeaders(), 'Content-Type': 'application/json' },\n      body,\n      signal,\n    });\n    if (!response.ok) {\n      throw new A2AClientError(\n        'HTTP_ERROR',\n        `HTTP ${response.status}: ${response.statusText}`\n      );\n    }\n\n    const json =\n      (await response.json()) as A2AJsonRpcPayload<A2ASendMessageResponse>;\n    if (json.error) {\n      throw new A2AClientError('REMOTE_ERROR', JSON.stringify(json.error));\n    }\n\n    const result = json.result;\n    const taskState = result?.task?.status.state;\n    const sessionId = result ? extractContextIdFromSendResponse(result) : null;\n    if (result && sessionId == null) {\n      throw new A2AContractError(\n        'contextId',\n        'A2A SendMessage response is missing contextId \u2014 multi-turn continuity requires it'\n      );\n    }\n    return {\n      text: result ? extractTextFromSendResponse(result) : '',\n      events: [],\n      sessionId,\n      usage: null,\n      costUsd: null,\n      exitCode: exitCodeForState(taskState),\n      backend: 'a2a',\n    };\n  }\n\n  async stream(\n    prompt: string,\n    onEvent: StreamCallback,\n    opts?: RunOptions\n  ): Promise<RunResult> {\n    const rpcId = crypto.randomUUID();\n    const signal = buildRequestSignal(\n      opts?.timeoutMs ?? this.timeoutMs,\n      opts?.signal\n    );\n    const callerSignal = opts?.signal;\n    let attempt = 0;\n    let contextId = readRunContextId(opts);\n    let initialSent = false;\n    let lastEventId: string | undefined;\n    let lastText = '';\n    let taskId: string | undefined = crypto.randomUUID();\n\n    while (true) {\n      const isReconnect = initialSent && lastEventId != null;\n      const method = isReconnect ? 'SubscribeToTask' : 'SendStreamingMessage';\n      const params = isReconnect\n        ? {\n            afterEventId: lastEventId,\n            ...(contextId ? { contextId } : {}),\n            id: taskId,\n          }\n        : {\n            ...(contextId ? { contextId } : {}),\n            configuration: { returnImmediately: true },\n            ...(taskId ? { taskId } : {}),\n            message: buildUserMessage(prompt),\n          };\n\n      const headers: Record<string, string> = {\n        ...this.buildHeaders(),\n        'Content-Type': 'application/json',\n        Accept: 'text/event-stream',\n        ...(isReconnect && lastEventId ? { 'Last-Event-ID': lastEventId } : {}),\n      };\n      const body = JSON.stringify({\n        jsonrpc: '2.0',\n        id: rpcId,\n        method,\n        params,\n      });\n\n      let response: Response;\n      try {\n        response = await fetch(this.url, {\n          method: 'POST',\n          headers,\n          body,\n          signal,\n        });\n      } catch (err) {\n        if (callerSignal?.aborted) {\n          throw err;\n        }\n        if (signal?.aborted || attempt >= this.maxReconnectAttempts) {\n          throw new A2AClientError(streamErrorCode(initialSent), String(err));\n        }\n        await delayWithSignal(this.reconnectDelayMs * 2 ** attempt, signal);\n        attempt++;\n        continue;\n      }\n\n      if (!response.ok) {\n        throw new A2AClientError('SSE_HTTP_ERROR', `HTTP ${response.status}`);\n      }\n      initialSent = true;\n\n      try {\n        // sequential: SSE events are ordered; task/context/text state updates must follow event order\n        for await (const event of consumeSse(response)) {\n          if (event.id) lastEventId = event.id;\n          try {\n            const parsed = JSON.parse(\n              event.data\n            ) as A2AJsonRpcPayload<A2AStreamResponse>;\n            if (parsed.error) {\n              throw new A2AClientError(\n                'REMOTE_ERROR',\n                JSON.stringify(parsed.error)\n              );\n            }\n            const result = parsed.result;\n            if (!result) continue;\n\n            taskId = extractTaskIdFromStream(result) ?? taskId;\n            contextId = contextId ?? extractContextIdFromStream(result);\n            const text = extractTextFromStream(result);\n            if (text) lastText = text;\n            const state = extractStateFromStream(result);\n            const final = result.message != null || isTerminalState(state);\n\n            try {\n              // sequential: stream callback must mirror SSE order\n              await onEvent({ type: final ? 'result' : 'text', text });\n            } catch {\n              /* callback error */\n            }\n\n            if (final) {\n              return {\n                text: lastText,\n                events: [],\n                sessionId: contextId ?? null,\n                usage: null,\n                costUsd: null,\n                exitCode: exitCodeForState(state),\n                backend: 'a2a',\n              };\n            }\n          } catch (err) {\n            if (err instanceof A2AClientError) throw err;\n          }\n        }\n\n        if (attempt >= this.maxReconnectAttempts) {\n          throw new A2AClientError(\n            'SSE_RECONNECT_EXHAUSTED',\n            'Stream ended without terminal event'\n          );\n        }\n        await delayWithSignal(this.reconnectDelayMs * 2 ** attempt, signal);\n        attempt++;\n      } catch (err) {\n        if (err instanceof A2AClientError) throw err;\n        if (callerSignal?.aborted) throw err;\n        if (signal?.aborted) {\n          throw new A2AClientError(streamErrorCode(initialSent), String(err));\n        }\n        if (attempt >= this.maxReconnectAttempts) {\n          throw new A2AClientError('SSE_RECONNECT_EXHAUSTED', String(err));\n        }\n        await delayWithSignal(this.reconnectDelayMs * 2 ** attempt, signal);\n        attempt++;\n      }\n    }\n  }\n\n  session(opts?: RunOptions): A2ASession {\n    return new A2ASession(this, opts);\n  }\n\n  private buildHeaders(): Record<string, string> {\n    return {\n      'A2A-Version': '1.0',\n      ...(this.apiKey ? { Authorization: `Bearer ${this.apiKey}` } : {}),\n      ...this.customHeaders,\n    };\n  }\n}\n"],
+  "mappings": "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",
+  "names": ["A2AClientError", "A2AContractError"]
+}

package/dist/adapters/transport/helpers.d.ts

@@ -0,0 +1,13 @@
+import type { IncomingMessage, ServerResponse } from 'node:http';
+import type { ResolvedOctoFlowServerConfig } from '../../config/config.js';
+import type { RateLimitLease } from '../../utils/rate-limiter.js';
+export { buildAgentCard, buildRequestBaseUrl, getContextId, getStreamAfter, getTaskId, getTenant, toInteger, toListParams, toMessage, toSendParams, toTaskSnapshotOptions, } from './a2a-params.js';
+export { authorizeRequest, expandIpv6, getRemoteIdentity, hashIdentity, normalizeIp, } from './auth.js';
+export { CANONICAL_METHODS, errorResponse, type JsonRpcErrorResponse, type JsonRpcId, type JsonRpcRequest, jsonRpcStreamEvent, RpcFailure, successResponse, toJsonRpcId, } from './jsonrpc-wire.js';
+export declare function readBody(req: IncomingMessage, maxBytes?: number): Promise<string>;
+export declare function sendJson(res: ServerResponse, status: number, body: unknown): void;
+export declare function addCommonHeaders(res: ServerResponse, serverConfig: ResolvedOctoFlowServerConfig): void;
+export declare function applyRateLimitHeaders(res: ServerResponse, lease: RateLimitLease): void;
+export declare function withDisconnect<T>(iterable: AsyncIterable<T>, res: ServerResponse): AsyncIterable<T>;
+export declare function etagFor(body: string): string;
+//# sourceMappingURL=helpers.d.ts.map

package/dist/adapters/transport/helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"helpers.d.ts","sourceRoot":"","sources":["../../../src/adapters/transport/helpers.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAEjE,OAAO,KAAK,EAAE,4BAA4B,EAAE,MAAM,wBAAwB,CAAC;AAC3E,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAElE,OAAO,EACL,cAAc,EACd,mBAAmB,EACnB,YAAY,EACZ,cAAc,EACd,SAAS,EACT,SAAS,EACT,SAAS,EACT,YAAY,EACZ,SAAS,EACT,YAAY,EACZ,qBAAqB,GACtB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EACL,gBAAgB,EAChB,UAAU,EACV,iBAAiB,EACjB,YAAY,EACZ,WAAW,GACZ,MAAM,WAAW,CAAC;AACnB,OAAO,EACL,iBAAiB,EACjB,aAAa,EACb,KAAK,oBAAoB,EACzB,KAAK,SAAS,EACd,KAAK,cAAc,EACnB,kBAAkB,EAClB,UAAU,EACV,eAAe,EACf,WAAW,GACZ,MAAM,mBAAmB,CAAC;AAM3B,wBAAgB,QAAQ,CACtB,GAAG,EAAE,eAAe,EACpB,QAAQ,SAAyB,GAChC,OAAO,CAAC,MAAM,CAAC,CAgBjB;AAED,wBAAgB,QAAQ,CACtB,GAAG,EAAE,cAAc,EACnB,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,OAAO,GACZ,IAAI,CAGN;AAED,wBAAgB,gBAAgB,CAC9B,GAAG,EAAE,cAAc,EACnB,YAAY,EAAE,4BAA4B,GACzC,IAAI,CAEN;AAED,wBAAgB,qBAAqB,CACnC,GAAG,EAAE,cAAc,EACnB,KAAK,EAAE,cAAc,GACpB,IAAI,CAIN;AAED,wBAAgB,cAAc,CAAC,CAAC,EAC9B,QAAQ,EAAE,aAAa,CAAC,CAAC,CAAC,EAC1B,GAAG,EAAE,cAAc,GAClB,aAAa,CAAC,CAAC,CAAC,CAUlB;AAED,wBAAgB,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAE5C"}

package/dist/adapters/transport/helpers.js

@@ -0,0 +1,105 @@
+import { createHash } from "node:crypto";
+import { RpcFailure } from "./jsonrpc-wire.js";
+import {
+  buildAgentCard,
+  buildRequestBaseUrl,
+  getContextId,
+  getStreamAfter,
+  getTaskId,
+  getTenant,
+  toInteger,
+  toListParams,
+  toMessage,
+  toSendParams,
+  toTaskSnapshotOptions
+} from "./a2a-params.js";
+import {
+  authorizeRequest,
+  expandIpv6,
+  getRemoteIdentity,
+  hashIdentity,
+  normalizeIp
+} from "./auth.js";
+import {
+  CANONICAL_METHODS,
+  errorResponse,
+  jsonRpcStreamEvent,
+  RpcFailure as RpcFailure2,
+  successResponse,
+  toJsonRpcId
+} from "./jsonrpc-wire.js";
+const DEFAULT_MAX_BODY_BYTES = 1048576;
+function readBody(req, maxBytes = DEFAULT_MAX_BODY_BYTES) {
+  const chunks = [];
+  let received = 0;
+  return new Promise((resolve, reject) => {
+    req.on("data", (chunk) => {
+      received += chunk.length;
+      if (received > maxBytes) {
+        req.destroy();
+        reject(new RpcFailure(413, -32e3, "Request body too large"));
+        return;
+      }
+      chunks.push(chunk);
+    });
+    req.on("end", () => resolve(Buffer.concat(chunks).toString("utf8")));
+    req.on("error", reject);
+  });
+}
+function sendJson(res, status, body) {
+  res.writeHead(status, { "Content-Type": "application/json" });
+  res.end(JSON.stringify(body));
+}
+function addCommonHeaders(res, serverConfig) {
+  res.setHeader("A2A-Version", serverConfig.a2aVersion);
+}
+function applyRateLimitHeaders(res, lease) {
+  res.setHeader("RateLimit-Limit", lease.limit);
+  res.setHeader("RateLimit-Remaining", lease.remaining);
+  res.setHeader("RateLimit-Reset", Math.ceil(lease.resetMs / 1e3));
+}
+function withDisconnect(iterable, res) {
+  return {
+    [Symbol.asyncIterator]() {
+      const iterator = iterable[Symbol.asyncIterator]();
+      res.on("close", () => {
+        void iterator.return?.();
+      });
+      return iterator;
+    }
+  };
+}
+function etagFor(body) {
+  return `"${createHash("sha1").update(body).digest("hex")}"`;
+}
+export {
+  CANONICAL_METHODS,
+  RpcFailure2 as RpcFailure,
+  addCommonHeaders,
+  applyRateLimitHeaders,
+  authorizeRequest,
+  buildAgentCard,
+  buildRequestBaseUrl,
+  errorResponse,
+  etagFor,
+  expandIpv6,
+  getContextId,
+  getRemoteIdentity,
+  getStreamAfter,
+  getTaskId,
+  getTenant,
+  hashIdentity,
+  jsonRpcStreamEvent,
+  normalizeIp,
+  readBody,
+  sendJson,
+  successResponse,
+  toInteger,
+  toJsonRpcId,
+  toListParams,
+  toMessage,
+  toSendParams,
+  toTaskSnapshotOptions,
+  withDisconnect
+};
+//# sourceMappingURL=helpers.js.map

package/dist/adapters/transport/helpers.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/adapters/transport/helpers.ts"],
+  "sourcesContent": ["/**\n * Pure helper utilities for the A2A JSON-RPC server.\n *\n * This barrel re-exports from domain-specific modules and keeps the\n * HTTP/SSE utility functions that don't fit elsewhere.\n */\nimport { createHash } from 'node:crypto';\nimport type { IncomingMessage, ServerResponse } from 'node:http';\n\nimport type { ResolvedOctoFlowServerConfig } from '../../config/config.js';\nimport type { RateLimitLease } from '../../utils/rate-limiter.js';\nimport { RpcFailure } from './jsonrpc-wire.js';\nexport {\n  buildAgentCard,\n  buildRequestBaseUrl,\n  getContextId,\n  getStreamAfter,\n  getTaskId,\n  getTenant,\n  toInteger,\n  toListParams,\n  toMessage,\n  toSendParams,\n  toTaskSnapshotOptions,\n} from './a2a-params.js';\nexport {\n  authorizeRequest,\n  expandIpv6,\n  getRemoteIdentity,\n  hashIdentity,\n  normalizeIp,\n} from './auth.js';\nexport {\n  CANONICAL_METHODS,\n  errorResponse,\n  type JsonRpcErrorResponse,\n  type JsonRpcId,\n  type JsonRpcRequest,\n  jsonRpcStreamEvent,\n  RpcFailure,\n  successResponse,\n  toJsonRpcId,\n} from './jsonrpc-wire.js';\n\n// HTTP / SSE utilities\n\nconst DEFAULT_MAX_BODY_BYTES = 1_048_576; // 1 MB\n\nexport function readBody(\n  req: IncomingMessage,\n  maxBytes = DEFAULT_MAX_BODY_BYTES\n): Promise<string> {\n  const chunks: Buffer[] = [];\n  let received = 0;\n  return new Promise((resolve, reject) => {\n    req.on('data', (chunk: Buffer) => {\n      received += chunk.length;\n      if (received > maxBytes) {\n        req.destroy();\n        reject(new RpcFailure(413, -32000, 'Request body too large'));\n        return;\n      }\n      chunks.push(chunk);\n    });\n    req.on('end', () => resolve(Buffer.concat(chunks).toString('utf8')));\n    req.on('error', reject);\n  });\n}\n\nexport function sendJson(\n  res: ServerResponse,\n  status: number,\n  body: unknown\n): void {\n  res.writeHead(status, { 'Content-Type': 'application/json' });\n  res.end(JSON.stringify(body));\n}\n\nexport function addCommonHeaders(\n  res: ServerResponse,\n  serverConfig: ResolvedOctoFlowServerConfig\n): void {\n  res.setHeader('A2A-Version', serverConfig.a2aVersion);\n}\n\nexport function applyRateLimitHeaders(\n  res: ServerResponse,\n  lease: RateLimitLease\n): void {\n  res.setHeader('RateLimit-Limit', lease.limit);\n  res.setHeader('RateLimit-Remaining', lease.remaining);\n  res.setHeader('RateLimit-Reset', Math.ceil(lease.resetMs / 1000));\n}\n\nexport function withDisconnect<T>(\n  iterable: AsyncIterable<T>,\n  res: ServerResponse\n): AsyncIterable<T> {\n  return {\n    [Symbol.asyncIterator]() {\n      const iterator = iterable[Symbol.asyncIterator]();\n      res.on('close', () => {\n        void iterator.return?.();\n      });\n      return iterator;\n    },\n  };\n}\n\nexport function etagFor(body: string): string {\n  return `\"${createHash('sha1').update(body).digest('hex')}\"`;\n}\n"],
+  "mappings": "AAMA,SAAS,kBAAkB;AAK3B,SAAS,kBAAkB;AAC3B;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACK;AACP;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACK;AACP;AAAA,EACE;AAAA,EACA;AAAA,EAIA;AAAA,EACA,cAAAA;AAAA,EACA;AAAA,EACA;AAAA,OACK;AAIP,MAAM,yBAAyB;AAExB,SAAS,SACd,KACA,WAAW,wBACM;AACjB,QAAM,SAAmB,CAAC;AAC1B,MAAI,WAAW;AACf,SAAO,IAAI,QAAQ,CAAC,SAAS,WAAW;AACtC,QAAI,GAAG,QAAQ,CAAC,UAAkB;AAChC,kBAAY,MAAM;AAClB,UAAI,WAAW,UAAU;AACvB,YAAI,QAAQ;AACZ,eAAO,IAAI,WAAW,KAAK,OAAQ,wBAAwB,CAAC;AAC5D;AAAA,MACF;AACA,aAAO,KAAK,KAAK;AAAA,IACnB,CAAC;AACD,QAAI,GAAG,OAAO,MAAM,QAAQ,OAAO,OAAO,MAAM,EAAE,SAAS,MAAM,CAAC,CAAC;AACnE,QAAI,GAAG,SAAS,MAAM;AAAA,EACxB,CAAC;AACH;AAEO,SAAS,SACd,KACA,QACA,MACM;AACN,MAAI,UAAU,QAAQ,EAAE,gBAAgB,mBAAmB,CAAC;AAC5D,MAAI,IAAI,KAAK,UAAU,IAAI,CAAC;AAC9B;AAEO,SAAS,iBACd,KACA,cACM;AACN,MAAI,UAAU,eAAe,aAAa,UAAU;AACtD;AAEO,SAAS,sBACd,KACA,OACM;AACN,MAAI,UAAU,mBAAmB,MAAM,KAAK;AAC5C,MAAI,UAAU,uBAAuB,MAAM,SAAS;AACpD,MAAI,UAAU,mBAAmB,KAAK,KAAK,MAAM,UAAU,GAAI,CAAC;AAClE;AAEO,SAAS,eACd,UACA,KACkB;AAClB,SAAO;AAAA,IACL,CAAC,OAAO,aAAa,IAAI;AACvB,YAAM,WAAW,SAAS,OAAO,aAAa,EAAE;AAChD,UAAI,GAAG,SAAS,MAAM;AACpB,aAAK,SAAS,SAAS;AAAA,MACzB,CAAC;AACD,aAAO;AAAA,IACT;AAAA,EACF;AACF;AAEO,SAAS,QAAQ,MAAsB;AAC5C,SAAO,IAAI,WAAW,MAAM,EAAE,OAAO,IAAI,EAAE,OAAO,KAAK,CAAC;AAC1D;",
+  "names": ["RpcFailure"]
+}

package/dist/adapters/transport/jsonrpc-wire.d.ts

@@ -0,0 +1,39 @@
+export type JsonRpcId = string | number | null;
+export interface JsonRpcRequest {
+    id?: JsonRpcId;
+    jsonrpc?: string;
+    method?: string;
+    params?: Record<string, unknown>;
+}
+interface JsonRpcSuccess {
+    id: JsonRpcId;
+    jsonrpc: '2.0';
+    result: unknown;
+}
+export interface JsonRpcErrorResponse {
+    error: {
+        code: number;
+        data?: Record<string, unknown>;
+        message: string;
+    };
+    id: JsonRpcId;
+    jsonrpc: '2.0';
+}
+export interface AuthorizedRequest {
+    error: JsonRpcErrorResponse | null;
+    principal: string;
+}
+export declare class RpcFailure extends Error {
+    readonly status: number;
+    readonly code: number;
+    readonly data?: Record<string, unknown> | undefined;
+    constructor(status: number, code: number, message: string, data?: Record<string, unknown> | undefined);
+}
+export type CanonicalA2AMethod = 'SendMessage' | 'SendStreamingMessage' | 'GetTask' | 'ListTasks' | 'CancelTask' | 'SubscribeToTask' | 'SetTaskPushNotificationConfig' | 'GetTaskPushNotificationConfig' | 'GetExtendedAgentCard';
+export declare const CANONICAL_METHODS: Map<string, CanonicalA2AMethod>;
+export declare function errorResponse(id: JsonRpcId, code: number, message: string, data?: Record<string, unknown>): JsonRpcErrorResponse;
+export declare function successResponse(id: JsonRpcId, result: unknown): JsonRpcSuccess;
+export declare function toJsonRpcId(value: unknown): JsonRpcId;
+export declare function jsonRpcStreamEvent(id: JsonRpcId, event: unknown, eventId?: string): string;
+export {};
+//# sourceMappingURL=jsonrpc-wire.d.ts.map

package/dist/adapters/transport/jsonrpc-wire.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"jsonrpc-wire.d.ts","sourceRoot":"","sources":["../../../src/adapters/transport/jsonrpc-wire.ts"],"names":[],"mappings":"AAIA,MAAM,MAAM,SAAS,GAAG,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC;AAE/C,MAAM,WAAW,cAAc;IAC7B,EAAE,CAAC,EAAE,SAAS,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAClC;AAED,UAAU,cAAc;IACtB,EAAE,EAAE,SAAS,CAAC;IACd,OAAO,EAAE,KAAK,CAAC;IACf,MAAM,EAAE,OAAO,CAAC;CACjB;AAED,MAAM,WAAW,oBAAoB;IACnC,KAAK,EAAE;QACL,IAAI,EAAE,MAAM,CAAC;QACb,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QAC/B,OAAO,EAAE,MAAM,CAAC;KACjB,CAAC;IACF,EAAE,EAAE,SAAS,CAAC;IACd,OAAO,EAAE,KAAK,CAAC;CAChB;AAED,MAAM,WAAW,iBAAiB;IAChC,KAAK,EAAE,oBAAoB,GAAG,IAAI,CAAC;IACnC,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,qBAAa,UAAW,SAAQ,KAAK;IAEjC,QAAQ,CAAC,MAAM,EAAE,MAAM;IACvB,QAAQ,CAAC,IAAI,EAAE,MAAM;IAErB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;gBAH9B,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,EACrB,OAAO,EAAE,MAAM,EACN,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,YAAA;CAK1C;AAED,MAAM,MAAM,kBAAkB,GAC1B,aAAa,GACb,sBAAsB,GACtB,SAAS,GACT,WAAW,GACX,YAAY,GACZ,iBAAiB,GACjB,+BAA+B,GAC/B,+BAA+B,GAC/B,sBAAsB,CAAC;AAE3B,eAAO,MAAM,iBAAiB,iCAkB5B,CAAC;AAIH,wBAAgB,aAAa,CAC3B,EAAE,EAAE,SAAS,EACb,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,EACf,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC7B,oBAAoB,CAUtB;AAED,wBAAgB,eAAe,CAC7B,EAAE,EAAE,SAAS,EACb,MAAM,EAAE,OAAO,GACd,cAAc,CAEhB;AAED,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,GAAG,SAAS,CAMrD;AAED,wBAAgB,kBAAkB,CAChC,EAAE,EAAE,SAAS,EACb,KAAK,EAAE,OAAO,EACd,OAAO,CAAC,EAAE,MAAM,GACf,MAAM,CAER"}

package/dist/adapters/transport/jsonrpc-wire.js

@@ -0,0 +1,64 @@
+import { sanitizeErrorMessage } from "../../utils/sanitize.js";
+class RpcFailure extends Error {
+  constructor(status, code, message, data) {
+    super(message);
+    this.status = status;
+    this.code = code;
+    this.data = data;
+    this.name = "RpcFailure";
+  }
+  status;
+  code;
+  data;
+}
+const CANONICAL_METHODS = /* @__PURE__ */ new Map([
+  ["message/send", "SendMessage"],
+  ["SendMessage", "SendMessage"],
+  ["message/stream", "SendStreamingMessage"],
+  ["SendStreamingMessage", "SendStreamingMessage"],
+  ["tasks/get", "GetTask"],
+  ["GetTask", "GetTask"],
+  ["tasks/list", "ListTasks"],
+  ["ListTasks", "ListTasks"],
+  ["tasks/cancel", "CancelTask"],
+  ["CancelTask", "CancelTask"],
+  ["tasks/resubscribe", "SubscribeToTask"],
+  ["SubscribeToTask", "SubscribeToTask"],
+  ["tasks/pushNotificationConfig/set", "SetTaskPushNotificationConfig"],
+  ["SetTaskPushNotificationConfig", "SetTaskPushNotificationConfig"],
+  ["tasks/pushNotificationConfig/get", "GetTaskPushNotificationConfig"],
+  ["GetTaskPushNotificationConfig", "GetTaskPushNotificationConfig"],
+  ["GetExtendedAgentCard", "GetExtendedAgentCard"]
+]);
+function errorResponse(id, code, message, data) {
+  return {
+    jsonrpc: "2.0",
+    id,
+    error: {
+      code,
+      message: sanitizeErrorMessage(message),
+      ...data ? { data } : {}
+    }
+  };
+}
+function successResponse(id, result) {
+  return { jsonrpc: "2.0", id, result };
+}
+function toJsonRpcId(value) {
+  return typeof value === "string" || typeof value === "number" || value === null ? value : null;
+}
+function jsonRpcStreamEvent(id, event, eventId) {
+  return `${eventId ? `id: ${eventId}
+` : ""}data: ${JSON.stringify(successResponse(id, event))}
+
+`;
+}
+export {
+  CANONICAL_METHODS,
+  RpcFailure,
+  errorResponse,
+  jsonRpcStreamEvent,
+  successResponse,
+  toJsonRpcId
+};
+//# sourceMappingURL=jsonrpc-wire.js.map

package/dist/adapters/transport/jsonrpc-wire.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/adapters/transport/jsonrpc-wire.ts"],
+  "sourcesContent": ["import { sanitizeErrorMessage } from '../../utils/sanitize.js';\n\n// JSON-RPC wire types\n\nexport type JsonRpcId = string | number | null;\n\nexport interface JsonRpcRequest {\n  id?: JsonRpcId;\n  jsonrpc?: string;\n  method?: string;\n  params?: Record<string, unknown>;\n}\n\ninterface JsonRpcSuccess {\n  id: JsonRpcId;\n  jsonrpc: '2.0';\n  result: unknown;\n}\n\nexport interface JsonRpcErrorResponse {\n  error: {\n    code: number;\n    data?: Record<string, unknown>;\n    message: string;\n  };\n  id: JsonRpcId;\n  jsonrpc: '2.0';\n}\n\nexport interface AuthorizedRequest {\n  error: JsonRpcErrorResponse | null;\n  principal: string;\n}\n\nexport class RpcFailure extends Error {\n  constructor(\n    readonly status: number,\n    readonly code: number,\n    message: string,\n    readonly data?: Record<string, unknown>\n  ) {\n    super(message);\n    this.name = 'RpcFailure';\n  }\n}\n\nexport type CanonicalA2AMethod =\n  | 'SendMessage'\n  | 'SendStreamingMessage'\n  | 'GetTask'\n  | 'ListTasks'\n  | 'CancelTask'\n  | 'SubscribeToTask'\n  | 'SetTaskPushNotificationConfig'\n  | 'GetTaskPushNotificationConfig'\n  | 'GetExtendedAgentCard';\n\nexport const CANONICAL_METHODS = new Map<string, CanonicalA2AMethod>([\n  ['message/send', 'SendMessage'],\n  ['SendMessage', 'SendMessage'],\n  ['message/stream', 'SendStreamingMessage'],\n  ['SendStreamingMessage', 'SendStreamingMessage'],\n  ['tasks/get', 'GetTask'],\n  ['GetTask', 'GetTask'],\n  ['tasks/list', 'ListTasks'],\n  ['ListTasks', 'ListTasks'],\n  ['tasks/cancel', 'CancelTask'],\n  ['CancelTask', 'CancelTask'],\n  ['tasks/resubscribe', 'SubscribeToTask'],\n  ['SubscribeToTask', 'SubscribeToTask'],\n  ['tasks/pushNotificationConfig/set', 'SetTaskPushNotificationConfig'],\n  ['SetTaskPushNotificationConfig', 'SetTaskPushNotificationConfig'],\n  ['tasks/pushNotificationConfig/get', 'GetTaskPushNotificationConfig'],\n  ['GetTaskPushNotificationConfig', 'GetTaskPushNotificationConfig'],\n  ['GetExtendedAgentCard', 'GetExtendedAgentCard'],\n]);\n\n// JSON-RPC response helpers\n\nexport function errorResponse(\n  id: JsonRpcId,\n  code: number,\n  message: string,\n  data?: Record<string, unknown>\n): JsonRpcErrorResponse {\n  return {\n    jsonrpc: '2.0',\n    id,\n    error: {\n      code,\n      message: sanitizeErrorMessage(message),\n      ...(data ? { data } : {}),\n    },\n  };\n}\n\nexport function successResponse(\n  id: JsonRpcId,\n  result: unknown\n): JsonRpcSuccess {\n  return { jsonrpc: '2.0', id, result };\n}\n\nexport function toJsonRpcId(value: unknown): JsonRpcId {\n  return typeof value === 'string' ||\n    typeof value === 'number' ||\n    value === null\n    ? value\n    : null;\n}\n\nexport function jsonRpcStreamEvent(\n  id: JsonRpcId,\n  event: unknown,\n  eventId?: string\n): string {\n  return `${eventId ? `id: ${eventId}\\n` : ''}data: ${JSON.stringify(successResponse(id, event))}\\n\\n`;\n}\n"],
+  "mappings": "AAAA,SAAS,4BAA4B;AAkC9B,MAAM,mBAAmB,MAAM;AAAA,EACpC,YACW,QACA,MACT,SACS,MACT;AACA,UAAM,OAAO;AALJ;AACA;AAEA;AAGT,SAAK,OAAO;AAAA,EACd;AAAA,EAPW;AAAA,EACA;AAAA,EAEA;AAKb;AAaO,MAAM,oBAAoB,oBAAI,IAAgC;AAAA,EACnE,CAAC,gBAAgB,aAAa;AAAA,EAC9B,CAAC,eAAe,aAAa;AAAA,EAC7B,CAAC,kBAAkB,sBAAsB;AAAA,EACzC,CAAC,wBAAwB,sBAAsB;AAAA,EAC/C,CAAC,aAAa,SAAS;AAAA,EACvB,CAAC,WAAW,SAAS;AAAA,EACrB,CAAC,cAAc,WAAW;AAAA,EAC1B,CAAC,aAAa,WAAW;AAAA,EACzB,CAAC,gBAAgB,YAAY;AAAA,EAC7B,CAAC,cAAc,YAAY;AAAA,EAC3B,CAAC,qBAAqB,iBAAiB;AAAA,EACvC,CAAC,mBAAmB,iBAAiB;AAAA,EACrC,CAAC,oCAAoC,+BAA+B;AAAA,EACpE,CAAC,iCAAiC,+BAA+B;AAAA,EACjE,CAAC,oCAAoC,+BAA+B;AAAA,EACpE,CAAC,iCAAiC,+BAA+B;AAAA,EACjE,CAAC,wBAAwB,sBAAsB;AACjD,CAAC;AAIM,SAAS,cACd,IACA,MACA,SACA,MACsB;AACtB,SAAO;AAAA,IACL,SAAS;AAAA,IACT;AAAA,IACA,OAAO;AAAA,MACL;AAAA,MACA,SAAS,qBAAqB,OAAO;AAAA,MACrC,GAAI,OAAO,EAAE,KAAK,IAAI,CAAC;AAAA,IACzB;AAAA,EACF;AACF;AAEO,SAAS,gBACd,IACA,QACgB;AAChB,SAAO,EAAE,SAAS,OAAO,IAAI,OAAO;AACtC;AAEO,SAAS,YAAY,OAA2B;AACrD,SAAO,OAAO,UAAU,YACtB,OAAO,UAAU,YACjB,UAAU,OACR,QACA;AACN;AAEO,SAAS,mBACd,IACA,OACA,SACQ;AACR,SAAO,GAAG,UAAU,OAAO,OAAO;AAAA,IAAO,EAAE,SAAS,KAAK,UAAU,gBAAgB,IAAI,KAAK,CAAC,CAAC;AAAA;AAAA;AAChG;",
+  "names": []
+}

package/dist/adapters/transport/push-notifications.d.ts

@@ -0,0 +1,15 @@
+import type { Task } from '../../domain/core-task.js';
+import type { TaskStore } from '../data/task-store/index.js';
+import type { A2APushNotificationConfig, A2ATaskPushNotificationConfig } from './wire-types.js';
+export interface A2APushNotificationDeliveryOptions {
+    fetch?: typeof globalThis.fetch;
+}
+export declare function pushNotificationConfigId(config: A2APushNotificationConfig): string;
+export declare function setTaskPushNotificationConfig(store: TaskStore, config: A2ATaskPushNotificationConfig): Promise<A2ATaskPushNotificationConfig>;
+export declare function getTaskPushNotificationConfig(store: TaskStore, params: {
+    configId?: string;
+    id?: string;
+    taskId?: string;
+}): Promise<A2ATaskPushNotificationConfig>;
+export declare function notifyTaskPushNotifications(store: TaskStore, task: Task, options?: A2APushNotificationDeliveryOptions): Promise<void>;
+//# sourceMappingURL=push-notifications.d.ts.map

package/dist/adapters/transport/push-notifications.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"push-notifications.d.ts","sourceRoot":"","sources":["../../../src/adapters/transport/push-notifications.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,2BAA2B,CAAC;AACtD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,6BAA6B,CAAC;AAI7D,OAAO,KAAK,EACV,yBAAyB,EACzB,6BAA6B,EAC9B,MAAM,iBAAiB,CAAC;AAEzB,MAAM,WAAW,kCAAkC;IACjD,KAAK,CAAC,EAAE,OAAO,UAAU,CAAC,KAAK,CAAC;CACjC;AAKD,wBAAgB,wBAAwB,CACtC,MAAM,EAAE,yBAAyB,GAChC,MAAM,CAER;AAED,wBAAsB,6BAA6B,CACjD,KAAK,EAAE,SAAS,EAChB,MAAM,EAAE,6BAA6B,GACpC,OAAO,CAAC,6BAA6B,CAAC,CAUxC;AAED,wBAAsB,6BAA6B,CACjD,KAAK,EAAE,SAAS,EAChB,MAAM,EAAE;IAAE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAAC,EAAE,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,GAC1D,OAAO,CAAC,6BAA6B,CAAC,CAmBxC;AAED,wBAAsB,2BAA2B,CAC/C,KAAK,EAAE,SAAS,EAChB,IAAI,EAAE,IAAI,EACV,OAAO,GAAE,kCAAuC,GAC/C,OAAO,CAAC,IAAI,CAAC,CAaf"}