@dexto/server 1.2.5

package/dist/a2a/jsonrpc/types.d.ts

@@ -0,0 +1,91 @@
+/**
+ * JSON-RPC 2.0 Type Definitions
+ *
+ * Implements JSON-RPC 2.0 specification for A2A Protocol transport.
+ * @see https://www.jsonrpc.org/specification
+ */
+/**
+ * JSON-RPC 2.0 Request
+ */
+export interface JsonRpcRequest {
+    /** JSON-RPC version (must be "2.0") */
+    jsonrpc: '2.0';
+    /** Method name to invoke */
+    method: string;
+    /** Method parameters (optional) */
+    params?: any;
+    /** Request ID (can be string, number, or null for notifications) */
+    id?: string | number | null;
+}
+/**
+ * JSON-RPC 2.0 Response (Success)
+ */
+export interface JsonRpcSuccessResponse {
+    /** JSON-RPC version (must be "2.0") */
+    jsonrpc: '2.0';
+    /** Result of the method invocation */
+    result: any;
+    /** Request ID (matches request) */
+    id: string | number | null;
+}
+/**
+ * JSON-RPC 2.0 Response (Error)
+ */
+export interface JsonRpcErrorResponse {
+    /** JSON-RPC version (must be "2.0") */
+    jsonrpc: '2.0';
+    /** Error object */
+    error: JsonRpcError;
+    /** Request ID (matches request, or null if ID couldn't be determined) */
+    id: string | number | null;
+}
+/**
+ * JSON-RPC 2.0 Error Object
+ */
+export interface JsonRpcError {
+    /** Error code (integer) */
+    code: number;
+    /** Error message (short description) */
+    message: string;
+    /** Optional additional error data */
+    data?: any;
+}
+/**
+ * Union type for JSON-RPC responses
+ */
+export type JsonRpcResponse = JsonRpcSuccessResponse | JsonRpcErrorResponse;
+/**
+ * JSON-RPC 2.0 Batch Request
+ */
+export type JsonRpcBatchRequest = JsonRpcRequest[];
+/**
+ * JSON-RPC 2.0 Batch Response
+ */
+export type JsonRpcBatchResponse = JsonRpcResponse[];
+/**
+ * Standard JSON-RPC 2.0 Error Codes
+ */
+export declare enum JsonRpcErrorCode {
+    /** Invalid JSON was received by the server */
+    PARSE_ERROR = -32700,
+    /** The JSON sent is not a valid Request object */
+    INVALID_REQUEST = -32600,
+    /** The method does not exist / is not available */
+    METHOD_NOT_FOUND = -32601,
+    /** Invalid method parameter(s) */
+    INVALID_PARAMS = -32602,
+    /** Internal JSON-RPC error */
+    INTERNAL_ERROR = -32603,
+    /** Reserved for implementation-defined server-errors (-32000 to -32099) */
+    SERVER_ERROR_START = -32099,
+    SERVER_ERROR_END = -32000
+}
+/**
+ * Type guard to check if response is an error
+ */
+export declare function isJsonRpcError(response: JsonRpcResponse): response is JsonRpcErrorResponse;
+/**
+ * Type guard to check if response is success
+ */
+export declare function isJsonRpcSuccess(response: JsonRpcResponse): response is JsonRpcSuccessResponse;
+//# sourceMappingURL=types.d.ts.map

package/dist/a2a/jsonrpc/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/a2a/jsonrpc/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;GAEG;AACH,MAAM,WAAW,cAAc;IAC3B,uCAAuC;IACvC,OAAO,EAAE,KAAK,CAAC;IACf,4BAA4B;IAC5B,MAAM,EAAE,MAAM,CAAC;IACf,mCAAmC;IACnC,MAAM,CAAC,EAAE,GAAG,CAAC;IACb,oEAAoE;IACpE,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC;CAC/B;AAED;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACnC,uCAAuC;IACvC,OAAO,EAAE,KAAK,CAAC;IACf,sCAAsC;IACtC,MAAM,EAAE,GAAG,CAAC;IACZ,mCAAmC;IACnC,EAAE,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC;CAC9B;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACjC,uCAAuC;IACvC,OAAO,EAAE,KAAK,CAAC;IACf,mBAAmB;IACnB,KAAK,EAAE,YAAY,CAAC;IACpB,yEAAyE;IACzE,EAAE,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC;CAC9B;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IACzB,2BAA2B;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,wCAAwC;IACxC,OAAO,EAAE,MAAM,CAAC;IAChB,qCAAqC;IACrC,IAAI,CAAC,EAAE,GAAG,CAAC;CACd;AAED;;GAEG;AACH,MAAM,MAAM,eAAe,GAAG,sBAAsB,GAAG,oBAAoB,CAAC;AAE5E;;GAEG;AACH,MAAM,MAAM,mBAAmB,GAAG,cAAc,EAAE,CAAC;AAEnD;;GAEG;AACH,MAAM,MAAM,oBAAoB,GAAG,eAAe,EAAE,CAAC;AAErD;;GAEG;AACH,oBAAY,gBAAgB;IACxB,8CAA8C;IAC9C,WAAW,SAAS;IACpB,kDAAkD;IAClD,eAAe,SAAS;IACxB,mDAAmD;IACnD,gBAAgB,SAAS;IACzB,kCAAkC;IAClC,cAAc,SAAS;IACvB,8BAA8B;IAC9B,cAAc,SAAS;IACvB,2EAA2E;IAC3E,kBAAkB,SAAS;IAC3B,gBAAgB,SAAS;CAC5B;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,eAAe,GAAG,QAAQ,IAAI,oBAAoB,CAE1F;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,eAAe,GAAG,QAAQ,IAAI,sBAAsB,CAE9F"}

package/dist/a2a/jsonrpc/types.js

@@ -0,0 +1,21 @@
+var JsonRpcErrorCode = /* @__PURE__ */ ((JsonRpcErrorCode2) => {
+  JsonRpcErrorCode2[JsonRpcErrorCode2["PARSE_ERROR"] = -32700] = "PARSE_ERROR";
+  JsonRpcErrorCode2[JsonRpcErrorCode2["INVALID_REQUEST"] = -32600] = "INVALID_REQUEST";
+  JsonRpcErrorCode2[JsonRpcErrorCode2["METHOD_NOT_FOUND"] = -32601] = "METHOD_NOT_FOUND";
+  JsonRpcErrorCode2[JsonRpcErrorCode2["INVALID_PARAMS"] = -32602] = "INVALID_PARAMS";
+  JsonRpcErrorCode2[JsonRpcErrorCode2["INTERNAL_ERROR"] = -32603] = "INTERNAL_ERROR";
+  JsonRpcErrorCode2[JsonRpcErrorCode2["SERVER_ERROR_START"] = -32099] = "SERVER_ERROR_START";
+  JsonRpcErrorCode2[JsonRpcErrorCode2["SERVER_ERROR_END"] = -32e3] = "SERVER_ERROR_END";
+  return JsonRpcErrorCode2;
+})(JsonRpcErrorCode || {});
+function isJsonRpcError(response) {
+  return "error" in response;
+}
+function isJsonRpcSuccess(response) {
+  return "result" in response;
+}
+export {
+  JsonRpcErrorCode,
+  isJsonRpcError,
+  isJsonRpcSuccess
+};

package/dist/a2a/types.cjs

@@ -0,0 +1,16 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var types_exports = {};
+module.exports = __toCommonJS(types_exports);

package/dist/a2a/types.d.ts

@@ -0,0 +1,250 @@
+/**
+ * TODO: fetch from a2a sdk to avoid drift over time
+ * A2A Protocol Type Definitions
+ *
+ * Type definitions compliant with A2A Protocol v0.3.0 specification.
+ * Based on: https://a2a-protocol.org/latest/specification
+ *
+ * @module a2a/types
+ */
+/**
+ * Task state per A2A Protocol specification.
+ *
+ * States:
+ * - submitted: Task has been submitted
+ * - working: Task is being processed
+ * - input-required: Task needs user input
+ * - completed: Task completed successfully
+ * - canceled: Task was canceled
+ * - failed: Task failed with error
+ * - rejected: Task was rejected
+ * - auth-required: Authentication required
+ * - unknown: State is unknown
+ */
+export type TaskState = 'submitted' | 'working' | 'input-required' | 'completed' | 'canceled' | 'failed' | 'rejected' | 'auth-required' | 'unknown';
+/**
+ * Message role per A2A Protocol specification.
+ */
+export type MessageRole = 'user' | 'agent';
+/**
+ * Base interface for all part types.
+ */
+export interface PartBase {
+    metadata?: {
+        [key: string]: any;
+    };
+}
+/**
+ * Text part - contains text content.
+ */
+export interface TextPart extends PartBase {
+    readonly kind: 'text';
+    text: string;
+}
+/**
+ * File base interface.
+ */
+export interface FileBase {
+    name?: string;
+    mimeType?: string;
+}
+/**
+ * File with base64-encoded bytes.
+ */
+export interface FileWithBytes extends FileBase {
+    bytes: string;
+    uri?: never;
+}
+/**
+ * File with URI reference.
+ */
+export interface FileWithUri extends FileBase {
+    uri: string;
+    bytes?: never;
+}
+/**
+ * File part - contains file data.
+ */
+export interface FilePart extends PartBase {
+    readonly kind: 'file';
+    file: FileWithBytes | FileWithUri;
+}
+/**
+ * Data part - contains structured JSON data.
+ */
+export interface DataPart extends PartBase {
+    readonly kind: 'data';
+    data: {
+        [key: string]: any;
+    };
+}
+/**
+ * Union of all part types per A2A specification.
+ */
+export type Part = TextPart | FilePart | DataPart;
+/**
+ * A2A Protocol message structure.
+ */
+export interface Message {
+    readonly role: MessageRole;
+    parts: Part[];
+    metadata?: {
+        [key: string]: any;
+    };
+    extensions?: string[];
+    referenceTaskIds?: string[];
+    messageId: string;
+    taskId?: string;
+    contextId?: string;
+    readonly kind: 'message';
+}
+/**
+ * Task status structure.
+ */
+export interface TaskStatus {
+    state: TaskState;
+    message?: Message;
+    timestamp?: string;
+}
+/**
+ * Artifact - generated output from the agent.
+ */
+export interface Artifact {
+    artifactId: string;
+    name?: string;
+    description?: string;
+    parts: Part[];
+    metadata?: {
+        [key: string]: any;
+    };
+    extensions?: string[];
+}
+/**
+ * A2A Protocol task structure.
+ */
+export interface Task {
+    id: string;
+    contextId: string;
+    status: TaskStatus;
+    history?: Message[];
+    artifacts?: Artifact[];
+    metadata?: {
+        [key: string]: any;
+    };
+    readonly kind: 'task';
+}
+/**
+ * Task status update event (streaming).
+ */
+export interface TaskStatusUpdateEvent {
+    taskId: string;
+    contextId: string;
+    readonly kind: 'status-update';
+    status: TaskStatus;
+    final: boolean;
+    metadata?: {
+        [key: string]: any;
+    };
+}
+/**
+ * Task artifact update event (streaming).
+ */
+export interface TaskArtifactUpdateEvent {
+    taskId: string;
+    contextId: string;
+    readonly kind: 'artifact-update';
+    artifact: Artifact;
+    append?: boolean;
+    lastChunk?: boolean;
+    metadata?: {
+        [key: string]: any;
+    };
+}
+/**
+ * Push notification configuration.
+ */
+export interface PushNotificationConfig {
+    url: string;
+    headers?: {
+        [key: string]: string;
+    };
+}
+/**
+ * Message send configuration.
+ */
+export interface MessageSendConfiguration {
+    acceptedOutputModes?: string[];
+    historyLength?: number;
+    pushNotificationConfig?: PushNotificationConfig;
+    blocking?: boolean;
+}
+/**
+ * Parameters for message/send and message/stream methods.
+ */
+export interface MessageSendParams {
+    message: Message;
+    configuration?: MessageSendConfiguration;
+    metadata?: {
+        [key: string]: any;
+    };
+}
+/**
+ * Parameters for tasks/get method.
+ */
+export interface TaskQueryParams {
+    id: string;
+    historyLength?: number;
+    metadata?: {
+        [key: string]: any;
+    };
+}
+/**
+ * Parameters for tasks/list method.
+ */
+export interface ListTasksParams {
+    contextId?: string;
+    status?: TaskState;
+    pageSize?: number;
+    pageToken?: string;
+    historyLength?: number;
+    lastUpdatedAfter?: number;
+    includeArtifacts?: boolean;
+    metadata?: {
+        [key: string]: any;
+    };
+}
+/**
+ * Result for tasks/list method.
+ */
+export interface ListTasksResult {
+    tasks: Task[];
+    totalSize: number;
+    pageSize: number;
+    nextPageToken: string;
+}
+/**
+ * Parameters for tasks/cancel and tasks/resubscribe methods.
+ */
+export interface TaskIdParams {
+    id: string;
+    metadata?: {
+        [key: string]: any;
+    };
+}
+/**
+ * Converted message parts for internal use (compatibility layer).
+ * Used by adapters to convert between A2A and Dexto internal format.
+ */
+export interface ConvertedMessage {
+    text: string;
+    image: {
+        image: string;
+        mimeType: string;
+    } | undefined;
+    file: {
+        data: string;
+        mimeType: string;
+        filename?: string;
+    } | undefined;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/a2a/types.d.ts.map

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

package/dist/approval/approval-coordinator.cjs

@@ -0,0 +1,87 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var approval_coordinator_exports = {};
+__export(approval_coordinator_exports, {
+  ApprovalCoordinator: () => ApprovalCoordinator
+});
+module.exports = __toCommonJS(approval_coordinator_exports);
+var import_node_events = require("node:events");
+class ApprovalCoordinator extends import_node_events.EventEmitter {
+  // Track approvalId -> sessionId mapping for multi-client SSE routing
+  approvalSessions = /* @__PURE__ */ new Map();
+  /**
+   * Emit an approval request.
+   * Called by ManualApprovalHandler when tool/command needs approval.
+   */
+  emitRequest(request) {
+    this.approvalSessions.set(request.approvalId, request.sessionId);
+    this.emit("approval:request", request);
+  }
+  /**
+   * Emit an approval response.
+   * Called by API routes when user submits decision.
+   */
+  emitResponse(response) {
+    this.emit("approval:response", response);
+    this.approvalSessions.delete(response.approvalId);
+  }
+  /**
+   * Get the sessionId associated with an approval request.
+   * Used by API routes to attach sessionId to responses for SSE routing.
+   */
+  getSessionId(approvalId) {
+    return this.approvalSessions.get(approvalId);
+  }
+  /**
+   * Subscribe to approval requests.
+   * Used by streaming endpoints to forward requests to SSE clients.
+   *
+   * @param handler Callback to handle approval requests
+   * @param options Optional AbortSignal for cleanup
+   */
+  onRequest(handler, options) {
+    const listener = (request) => handler(request);
+    this.on("approval:request", listener);
+    if (options?.signal) {
+      options.signal.addEventListener("abort", () => {
+        this.off("approval:request", listener);
+      });
+    }
+  }
+  /**
+   * Subscribe to approval responses.
+   * Used by ManualApprovalHandler to resolve pending approval promises.
+   *
+   * @param handler Callback to handle approval responses
+   * @param options Optional AbortSignal for cleanup
+   */
+  onResponse(handler, options) {
+    const listener = (response) => handler(response);
+    this.on("approval:response", listener);
+    if (options?.signal) {
+      options.signal.addEventListener("abort", () => {
+        this.off("approval:response", listener);
+      });
+    }
+  }
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  ApprovalCoordinator
+});

package/dist/approval/approval-coordinator.d.ts

@@ -0,0 +1,52 @@
+import { EventEmitter } from 'node:events';
+import type { ApprovalRequest, ApprovalResponse } from '@dexto/core';
+/**
+ * Event coordinator for approval request/response flow between handler and server.
+ *
+ * Provides explicit separation between agent lifecycle events (on AgentEventBus)
+ * and server-mode coordination events (on ApprovalCoordinator).
+ *
+ * Used by:
+ * - ManualApprovalHandler: Emits requests, listens for responses
+ * - Streaming endpoints: Listens for requests, helps emit responses
+ * - Approval routes: Emits responses from client submissions
+ */
+export declare class ApprovalCoordinator extends EventEmitter {
+    private approvalSessions;
+    /**
+     * Emit an approval request.
+     * Called by ManualApprovalHandler when tool/command needs approval.
+     */
+    emitRequest(request: ApprovalRequest): void;
+    /**
+     * Emit an approval response.
+     * Called by API routes when user submits decision.
+     */
+    emitResponse(response: ApprovalResponse): void;
+    /**
+     * Get the sessionId associated with an approval request.
+     * Used by API routes to attach sessionId to responses for SSE routing.
+     */
+    getSessionId(approvalId: string): string | undefined;
+    /**
+     * Subscribe to approval requests.
+     * Used by streaming endpoints to forward requests to SSE clients.
+     *
+     * @param handler Callback to handle approval requests
+     * @param options Optional AbortSignal for cleanup
+     */
+    onRequest(handler: (request: ApprovalRequest) => void, options?: {
+        signal?: AbortSignal;
+    }): void;
+    /**
+     * Subscribe to approval responses.
+     * Used by ManualApprovalHandler to resolve pending approval promises.
+     *
+     * @param handler Callback to handle approval responses
+     * @param options Optional AbortSignal for cleanup
+     */
+    onResponse(handler: (response: ApprovalResponse) => void, options?: {
+        signal?: AbortSignal;
+    }): void;
+}
+//# sourceMappingURL=approval-coordinator.d.ts.map

package/dist/approval/approval-coordinator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"approval-coordinator.d.ts","sourceRoot":"","sources":["../../src/approval/approval-coordinator.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,KAAK,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAErE;;;;;;;;;;GAUG;AACH,qBAAa,mBAAoB,SAAQ,YAAY;IAEjD,OAAO,CAAC,gBAAgB,CAAyC;IAEjE;;;OAGG;IACI,WAAW,CAAC,OAAO,EAAE,eAAe,GAAG,IAAI;IAMlD;;;OAGG;IACI,YAAY,CAAC,QAAQ,EAAE,gBAAgB,GAAG,IAAI;IAMrD;;;OAGG;IACI,YAAY,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;IAI3D;;;;;;OAMG;IACI,SAAS,CACZ,OAAO,EAAE,CAAC,OAAO,EAAE,eAAe,KAAK,IAAI,EAC3C,OAAO,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,WAAW,CAAA;KAAE,GACnC,IAAI;IAYP;;;;;;OAMG;IACI,UAAU,CACb,OAAO,EAAE,CAAC,QAAQ,EAAE,gBAAgB,KAAK,IAAI,EAC7C,OAAO,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,WAAW,CAAA;KAAE,GACnC,IAAI;CAWV"}

package/dist/approval/approval-coordinator.js

@@ -0,0 +1,63 @@
+import { EventEmitter } from "node:events";
+class ApprovalCoordinator extends EventEmitter {
+  // Track approvalId -> sessionId mapping for multi-client SSE routing
+  approvalSessions = /* @__PURE__ */ new Map();
+  /**
+   * Emit an approval request.
+   * Called by ManualApprovalHandler when tool/command needs approval.
+   */
+  emitRequest(request) {
+    this.approvalSessions.set(request.approvalId, request.sessionId);
+    this.emit("approval:request", request);
+  }
+  /**
+   * Emit an approval response.
+   * Called by API routes when user submits decision.
+   */
+  emitResponse(response) {
+    this.emit("approval:response", response);
+    this.approvalSessions.delete(response.approvalId);
+  }
+  /**
+   * Get the sessionId associated with an approval request.
+   * Used by API routes to attach sessionId to responses for SSE routing.
+   */
+  getSessionId(approvalId) {
+    return this.approvalSessions.get(approvalId);
+  }
+  /**
+   * Subscribe to approval requests.
+   * Used by streaming endpoints to forward requests to SSE clients.
+   *
+   * @param handler Callback to handle approval requests
+   * @param options Optional AbortSignal for cleanup
+   */
+  onRequest(handler, options) {
+    const listener = (request) => handler(request);
+    this.on("approval:request", listener);
+    if (options?.signal) {
+      options.signal.addEventListener("abort", () => {
+        this.off("approval:request", listener);
+      });
+    }
+  }
+  /**
+   * Subscribe to approval responses.
+   * Used by ManualApprovalHandler to resolve pending approval promises.
+   *
+   * @param handler Callback to handle approval responses
+   * @param options Optional AbortSignal for cleanup
+   */
+  onResponse(handler, options) {
+    const listener = (response) => handler(response);
+    this.on("approval:response", listener);
+    if (options?.signal) {
+      options.signal.addEventListener("abort", () => {
+        this.off("approval:response", listener);
+      });
+    }
+  }
+}
+export {
+  ApprovalCoordinator
+};