@dexto/server 1.2.5

package/dist/hono/routes/a2a-tasks.d.ts

@@ -0,0 +1,530 @@
+/**
+ * A2A REST Task API (Compliant with A2A Protocol v0.3.0)
+ *
+ * RESTful HTTP+JSON endpoints for A2A Protocol task management.
+ * Follows the /v1/ URL pattern per A2A specification.
+ *
+ * Endpoint mappings per spec:
+ * - POST /v1/message:send → message/send
+ * - GET  /v1/tasks/{id} → tasks/get
+ * - GET  /v1/tasks → tasks/list
+ * - POST /v1/tasks/{id}:cancel → tasks/cancel
+ */
+import { OpenAPIHono } from '@hono/zod-openapi';
+import type { DextoAgent } from '@dexto/core';
+import type { A2ASseEventSubscriber } from '../../events/a2a-sse-subscriber.js';
+/**
+ * Create A2A REST Task router
+ *
+ * Exposes RESTful endpoints for A2A task management per v0.3.0 spec.
+ *
+ * Endpoints:
+ * - POST   /v1/message:send        - Send message to agent
+ * - POST   /v1/message:stream      - Send message with SSE streaming
+ * - GET    /v1/tasks/{id}          - Get task
+ * - GET    /v1/tasks               - List tasks
+ * - POST   /v1/tasks/{id}:cancel   - Cancel task
+ *
+ * @param getAgent Function to get current DextoAgent instance
+ * @param sseSubscriber SSE event subscriber for streaming
+ * @returns OpenAPIHono router with REST task endpoints
+ */
+export declare function createA2ATasksRouter(getAgent: () => DextoAgent, sseSubscriber: A2ASseEventSubscriber): OpenAPIHono<import("hono").Env, {
+    "/v1/message:send": {
+        $post: {
+            input: {
+                json: {
+                    message: {
+                        role: "user" | "agent";
+                        kind: "message";
+                        parts: ({
+                            text: string;
+                            kind: "text";
+                            metadata?: Record<string, any> | undefined;
+                        } | {
+                            file: {
+                                bytes: string;
+                                mimeType?: string | undefined;
+                                name?: string | undefined;
+                            } | {
+                                uri: string;
+                                mimeType?: string | undefined;
+                                name?: string | undefined;
+                            };
+                            kind: "file";
+                            metadata?: Record<string, any> | undefined;
+                        } | {
+                            data: Record<string, any>;
+                            kind: "data";
+                            metadata?: Record<string, any> | undefined;
+                        })[];
+                        messageId: string;
+                        metadata?: Record<string, any> | undefined;
+                        contextId?: string | undefined;
+                        taskId?: string | undefined;
+                        extensions?: string[] | undefined;
+                        referenceTaskIds?: string[] | undefined;
+                    };
+                    metadata?: Record<string, any> | undefined;
+                    configuration?: {
+                        blocking?: boolean | undefined;
+                        acceptedOutputModes?: string[] | undefined;
+                        historyLength?: number | undefined;
+                        pushNotificationConfig?: {
+                            url: string;
+                            headers?: Record<string, string> | undefined;
+                        } | undefined;
+                    } | undefined;
+                };
+            };
+            output: {
+                status: {
+                    state: "unknown" | "submitted" | "working" | "input-required" | "completed" | "canceled" | "failed" | "rejected" | "auth-required";
+                    message?: {
+                        role: "user" | "agent";
+                        kind: "message";
+                        parts: ({
+                            text: string;
+                            kind: "text";
+                            metadata?: {
+                                [x: string]: any;
+                            } | undefined;
+                        } | {
+                            file: {
+                                bytes: string;
+                                mimeType?: string | undefined;
+                                name?: string | undefined;
+                            } | {
+                                uri: string;
+                                mimeType?: string | undefined;
+                                name?: string | undefined;
+                            };
+                            kind: "file";
+                            metadata?: {
+                                [x: string]: any;
+                            } | undefined;
+                        } | {
+                            data: {
+                                [x: string]: any;
+                            };
+                            kind: "data";
+                            metadata?: {
+                                [x: string]: any;
+                            } | undefined;
+                        })[];
+                        messageId: string;
+                        metadata?: {
+                            [x: string]: any;
+                        } | undefined;
+                        contextId?: string | undefined;
+                        taskId?: string | undefined;
+                        extensions?: string[] | undefined;
+                        referenceTaskIds?: string[] | undefined;
+                    } | undefined;
+                    timestamp?: string | undefined;
+                };
+                id: string;
+                kind: "task";
+                contextId: string;
+                metadata?: {
+                    [x: string]: any;
+                } | undefined;
+                history?: {
+                    role: "user" | "agent";
+                    kind: "message";
+                    parts: ({
+                        text: string;
+                        kind: "text";
+                        metadata?: {
+                            [x: string]: any;
+                        } | undefined;
+                    } | {
+                        file: {
+                            bytes: string;
+                            mimeType?: string | undefined;
+                            name?: string | undefined;
+                        } | {
+                            uri: string;
+                            mimeType?: string | undefined;
+                            name?: string | undefined;
+                        };
+                        kind: "file";
+                        metadata?: {
+                            [x: string]: any;
+                        } | undefined;
+                    } | {
+                        data: {
+                            [x: string]: any;
+                        };
+                        kind: "data";
+                        metadata?: {
+                            [x: string]: any;
+                        } | undefined;
+                    })[];
+                    messageId: string;
+                    metadata?: {
+                        [x: string]: any;
+                    } | undefined;
+                    contextId?: string | undefined;
+                    taskId?: string | undefined;
+                    extensions?: string[] | undefined;
+                    referenceTaskIds?: string[] | undefined;
+                }[] | undefined;
+                artifacts?: any[] | undefined;
+            };
+            outputFormat: "json";
+            status: 200;
+        };
+    };
+} & {
+    "/v1/tasks": {
+        $get: {
+            input: {
+                query: {
+                    status?: "unknown" | "submitted" | "working" | "input-required" | "completed" | "canceled" | "failed" | "rejected" | "auth-required" | undefined;
+                    contextId?: string | undefined;
+                    pageSize?: string | undefined;
+                    historyLength?: string | undefined;
+                    pageToken?: string | undefined;
+                    lastUpdatedAfter?: string | undefined;
+                    includeArtifacts?: string | undefined;
+                };
+            };
+            output: {
+                tasks: {
+                    status: {
+                        state: "unknown" | "submitted" | "working" | "input-required" | "completed" | "canceled" | "failed" | "rejected" | "auth-required";
+                        message?: {
+                            role: "user" | "agent";
+                            kind: "message";
+                            parts: ({
+                                text: string;
+                                kind: "text";
+                                metadata?: {
+                                    [x: string]: any;
+                                } | undefined;
+                            } | {
+                                file: {
+                                    bytes: string;
+                                    mimeType?: string | undefined;
+                                    name?: string | undefined;
+                                } | {
+                                    uri: string;
+                                    mimeType?: string | undefined;
+                                    name?: string | undefined;
+                                };
+                                kind: "file";
+                                metadata?: {
+                                    [x: string]: any;
+                                } | undefined;
+                            } | {
+                                data: {
+                                    [x: string]: any;
+                                };
+                                kind: "data";
+                                metadata?: {
+                                    [x: string]: any;
+                                } | undefined;
+                            })[];
+                            messageId: string;
+                            metadata?: {
+                                [x: string]: any;
+                            } | undefined;
+                            contextId?: string | undefined;
+                            taskId?: string | undefined;
+                            extensions?: string[] | undefined;
+                            referenceTaskIds?: string[] | undefined;
+                        } | undefined;
+                        timestamp?: string | undefined;
+                    };
+                    id: string;
+                    kind: "task";
+                    contextId: string;
+                    metadata?: {
+                        [x: string]: any;
+                    } | undefined;
+                    history?: {
+                        role: "user" | "agent";
+                        kind: "message";
+                        parts: ({
+                            text: string;
+                            kind: "text";
+                            metadata?: {
+                                [x: string]: any;
+                            } | undefined;
+                        } | {
+                            file: {
+                                bytes: string;
+                                mimeType?: string | undefined;
+                                name?: string | undefined;
+                            } | {
+                                uri: string;
+                                mimeType?: string | undefined;
+                                name?: string | undefined;
+                            };
+                            kind: "file";
+                            metadata?: {
+                                [x: string]: any;
+                            } | undefined;
+                        } | {
+                            data: {
+                                [x: string]: any;
+                            };
+                            kind: "data";
+                            metadata?: {
+                                [x: string]: any;
+                            } | undefined;
+                        })[];
+                        messageId: string;
+                        metadata?: {
+                            [x: string]: any;
+                        } | undefined;
+                        contextId?: string | undefined;
+                        taskId?: string | undefined;
+                        extensions?: string[] | undefined;
+                        referenceTaskIds?: string[] | undefined;
+                    }[] | undefined;
+                    artifacts?: any[] | undefined;
+                }[];
+                totalSize: number;
+                pageSize: number;
+                nextPageToken: string;
+            };
+            outputFormat: "json";
+            status: 200;
+        };
+    };
+} & {
+    "/v1/tasks/:id": {
+        $get: {
+            input: {
+                param: {
+                    id: string;
+                };
+            };
+            output: {};
+            outputFormat: string;
+            status: 404;
+        } | {
+            input: {
+                param: {
+                    id: string;
+                };
+            };
+            output: {
+                status: {
+                    state: "unknown" | "submitted" | "working" | "input-required" | "completed" | "canceled" | "failed" | "rejected" | "auth-required";
+                    message?: {
+                        role: "user" | "agent";
+                        kind: "message";
+                        parts: ({
+                            text: string;
+                            kind: "text";
+                            metadata?: {
+                                [x: string]: any;
+                            } | undefined;
+                        } | {
+                            file: {
+                                bytes: string;
+                                mimeType?: string | undefined;
+                                name?: string | undefined;
+                            } | {
+                                uri: string;
+                                mimeType?: string | undefined;
+                                name?: string | undefined;
+                            };
+                            kind: "file";
+                            metadata?: {
+                                [x: string]: any;
+                            } | undefined;
+                        } | {
+                            data: {
+                                [x: string]: any;
+                            };
+                            kind: "data";
+                            metadata?: {
+                                [x: string]: any;
+                            } | undefined;
+                        })[];
+                        messageId: string;
+                        metadata?: {
+                            [x: string]: any;
+                        } | undefined;
+                        contextId?: string | undefined;
+                        taskId?: string | undefined;
+                        extensions?: string[] | undefined;
+                        referenceTaskIds?: string[] | undefined;
+                    } | undefined;
+                    timestamp?: string | undefined;
+                };
+                id: string;
+                kind: "task";
+                contextId: string;
+                metadata?: {
+                    [x: string]: any;
+                } | undefined;
+                history?: {
+                    role: "user" | "agent";
+                    kind: "message";
+                    parts: ({
+                        text: string;
+                        kind: "text";
+                        metadata?: {
+                            [x: string]: any;
+                        } | undefined;
+                    } | {
+                        file: {
+                            bytes: string;
+                            mimeType?: string | undefined;
+                            name?: string | undefined;
+                        } | {
+                            uri: string;
+                            mimeType?: string | undefined;
+                            name?: string | undefined;
+                        };
+                        kind: "file";
+                        metadata?: {
+                            [x: string]: any;
+                        } | undefined;
+                    } | {
+                        data: {
+                            [x: string]: any;
+                        };
+                        kind: "data";
+                        metadata?: {
+                            [x: string]: any;
+                        } | undefined;
+                    })[];
+                    messageId: string;
+                    metadata?: {
+                        [x: string]: any;
+                    } | undefined;
+                    contextId?: string | undefined;
+                    taskId?: string | undefined;
+                    extensions?: string[] | undefined;
+                    referenceTaskIds?: string[] | undefined;
+                }[] | undefined;
+                artifacts?: any[] | undefined;
+            };
+            outputFormat: "json";
+            status: 200;
+        };
+    };
+} & {
+    "/v1/tasks/:id:cancel": {
+        $post: {
+            input: {
+                param: {
+                    id: string;
+                };
+            };
+            output: {};
+            outputFormat: string;
+            status: 404;
+        } | {
+            input: {
+                param: {
+                    id: string;
+                };
+            };
+            output: {
+                status: {
+                    state: "unknown" | "submitted" | "working" | "input-required" | "completed" | "canceled" | "failed" | "rejected" | "auth-required";
+                    message?: {
+                        role: "user" | "agent";
+                        kind: "message";
+                        parts: ({
+                            text: string;
+                            kind: "text";
+                            metadata?: {
+                                [x: string]: any;
+                            } | undefined;
+                        } | {
+                            file: {
+                                bytes: string;
+                                mimeType?: string | undefined;
+                                name?: string | undefined;
+                            } | {
+                                uri: string;
+                                mimeType?: string | undefined;
+                                name?: string | undefined;
+                            };
+                            kind: "file";
+                            metadata?: {
+                                [x: string]: any;
+                            } | undefined;
+                        } | {
+                            data: {
+                                [x: string]: any;
+                            };
+                            kind: "data";
+                            metadata?: {
+                                [x: string]: any;
+                            } | undefined;
+                        })[];
+                        messageId: string;
+                        metadata?: {
+                            [x: string]: any;
+                        } | undefined;
+                        contextId?: string | undefined;
+                        taskId?: string | undefined;
+                        extensions?: string[] | undefined;
+                        referenceTaskIds?: string[] | undefined;
+                    } | undefined;
+                    timestamp?: string | undefined;
+                };
+                id: string;
+                kind: "task";
+                contextId: string;
+                metadata?: {
+                    [x: string]: any;
+                } | undefined;
+                history?: {
+                    role: "user" | "agent";
+                    kind: "message";
+                    parts: ({
+                        text: string;
+                        kind: "text";
+                        metadata?: {
+                            [x: string]: any;
+                        } | undefined;
+                    } | {
+                        file: {
+                            bytes: string;
+                            mimeType?: string | undefined;
+                            name?: string | undefined;
+                        } | {
+                            uri: string;
+                            mimeType?: string | undefined;
+                            name?: string | undefined;
+                        };
+                        kind: "file";
+                        metadata?: {
+                            [x: string]: any;
+                        } | undefined;
+                    } | {
+                        data: {
+                            [x: string]: any;
+                        };
+                        kind: "data";
+                        metadata?: {
+                            [x: string]: any;
+                        } | undefined;
+                    })[];
+                    messageId: string;
+                    metadata?: {
+                        [x: string]: any;
+                    } | undefined;
+                    contextId?: string | undefined;
+                    taskId?: string | undefined;
+                    extensions?: string[] | undefined;
+                    referenceTaskIds?: string[] | undefined;
+                }[] | undefined;
+                artifacts?: any[] | undefined;
+            };
+            outputFormat: "json";
+            status: 200;
+        };
+    };
+}, "/">;
+//# sourceMappingURL=a2a-tasks.d.ts.map

package/dist/hono/routes/a2a-tasks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"a2a-tasks.d.ts","sourceRoot":"","sources":["../../../src/hono/routes/a2a-tasks.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAE,WAAW,EAAkB,MAAM,mBAAmB,CAAC;AAChE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAG9C,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,oCAAoC,CAAC;AA4KhF;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,oBAAoB,CAChC,QAAQ,EAAE,MAAM,UAAU,EAC1B,aAAa,EAAE,qBAAqB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;QAwNvC"}