@dexto/server 1.5.8 → 1.6.1

package/dist/hono/index.d.ts

@@ -7,12 +7,20 @@ import { WebhookEventSubscriber } from '../events/webhook-subscriber.js';
 import { A2ASseEventSubscriber } from '../events/a2a-sse-subscriber.js';
 import { ApprovalCoordinator } from '../approval/approval-coordinator.js';
 export type GetAgentFn = (ctx: Context) => DextoAgent | Promise<DextoAgent>;
+export type GetAgentConfigPathFn = (ctx: Context) => string | undefined | Promise<string | undefined>;
 export type CreateDextoAppOptions = {
     /**
      * Prefix for API routes. Defaults to '/api'.
      */
     apiPrefix?: string;
     getAgent: GetAgentFn;
+    /**
+     * Optional active agent config path resolver.
+     *
+     * Used by file-based endpoints (e.g. /api/agent/config) for reading/writing YAML.
+     * Host layers (CLI/server/platform) own config file paths; core does not.
+     */
+    getAgentConfigPath?: GetAgentConfigPathFn;
     getAgentCard: () => AgentCard;
     approvalCoordinator: ApprovalCoordinator;
     webhookSubscriber: WebhookEventSubscriber;
@@ -48,7 +56,7 @@ export declare function createDextoApp(options: CreateDextoAppOptions): OpenAPIH
                     displayName: string;
                     filePath: string;
                     sizeBytes: number;
-                    source?: "manual" | "huggingface" | undefined;
+                    source?: "huggingface" | "manual" | undefined;
                     contextLength?: number | undefined;
                 }[];
             };
@@ -141,13 +149,9 @@ export declare function createDextoApp(options: CreateDextoAppOptions): OpenAPIH
         $get: {
             input: {};
             output: {
-                internalTools: {
-                    description: string;
-                    name: string;
-                }[];
-                customTools: {
+                blob: {
                     type: string;
-                    category: "customTools" | "compaction" | "blob" | "database";
+                    category: "blob" | "tools" | "compaction" | "database";
                     metadata?: {
                         [x: string]: import("hono/utils/types").JSONValue;
                         description?: string | undefined;
@@ -156,31 +160,35 @@ export declare function createDextoApp(options: CreateDextoAppOptions): OpenAPIH
                 }[];
                 compaction: {
                     type: string;
-                    category: "customTools" | "compaction" | "blob" | "database";
+                    category: "blob" | "tools" | "compaction" | "database";
                     metadata?: {
                         [x: string]: import("hono/utils/types").JSONValue;
                         description?: string | undefined;
                         displayName?: string | undefined;
                     } | undefined;
                 }[];
-                blob: {
+                database: {
                     type: string;
-                    category: "customTools" | "compaction" | "blob" | "database";
+                    category: "blob" | "tools" | "compaction" | "database";
                     metadata?: {
                         [x: string]: import("hono/utils/types").JSONValue;
                         description?: string | undefined;
                         displayName?: string | undefined;
                     } | undefined;
                 }[];
-                database: {
+                toolFactories: {
                     type: string;
-                    category: "customTools" | "compaction" | "blob" | "database";
+                    category: "blob" | "tools" | "compaction" | "database";
                     metadata?: {
                         [x: string]: import("hono/utils/types").JSONValue;
                         description?: string | undefined;
                         displayName?: string | undefined;
                     } | undefined;
                 }[];
+                builtinTools: {
+                    description: string;
+                    name: string;
+                }[];
             };
             outputFormat: "json";
             status: 200;
@@ -195,7 +203,7 @@ export declare function createDextoApp(options: CreateDextoAppOptions): OpenAPIH
                     description: string;
                     id: string;
                     name: string;
-                    source: "custom" | "mcp" | "internal";
+                    source: "local" | "mcp";
                     serverName?: string | undefined;
                     inputSchema?: {
                         [x: string]: import("hono/utils/types").JSONValue;
@@ -211,10 +219,12 @@ export declare function createDextoApp(options: CreateDextoAppOptions): OpenAPIH
                         } | undefined;
                         required?: string[] | undefined;
                     } | undefined;
+                    _meta?: {
+                        [x: string]: import("hono/utils/types").JSONValue;
+                    } | undefined;
                 }[];
                 totalCount: number;
-                internalCount: number;
-                customCount: number;
+                localCount: number;
                 mcpCount: number;
             };
             outputFormat: "json";
@@ -772,42 +782,583 @@ export declare function createDextoApp(options: CreateDextoAppOptions): OpenAPIH
         } | {
             input: {
                 param: {
-                    approvalId: string;
-                };
-            } & {
-                header: {
-                    'Idempotency-Key'?: string | undefined;
+                    approvalId: string;
+                };
+            } & {
+                header: {
+                    'Idempotency-Key'?: string | undefined;
+                };
+            } & {
+                json: {
+                    status: import("@dexto/core").ApprovalStatus.APPROVED | import("@dexto/core").ApprovalStatus.DENIED;
+                    formData?: Record<string, unknown> | undefined;
+                    rememberChoice?: boolean | undefined;
+                };
+            };
+            output: {};
+            outputFormat: string;
+            status: 503;
+        } | {
+            input: {
+                param: {
+                    approvalId: string;
+                };
+            } & {
+                header: {
+                    'Idempotency-Key'?: string | undefined;
+                };
+            } & {
+                json: {
+                    status: import("@dexto/core").ApprovalStatus.APPROVED | import("@dexto/core").ApprovalStatus.DENIED;
+                    formData?: Record<string, unknown> | undefined;
+                    rememberChoice?: boolean | undefined;
+                };
+            };
+            output: {
+                status: import("@dexto/core").ApprovalStatus.APPROVED | import("@dexto/core").ApprovalStatus.DENIED;
+                ok: boolean;
+                approvalId: string;
+            };
+            outputFormat: "json";
+            status: 200;
+        };
+    };
+}, "/api"> & import("hono/types").MergeSchemaPath<{
+    "/schedules": {
+        $get: {
+            input: {};
+            output: {
+                schedules: {
+                    id: string;
+                    name: string;
+                    createdAt: number;
+                    cronExpression: string;
+                    timezone: string;
+                    enabled: boolean;
+                    task: {
+                        instruction: string;
+                        metadata?: {
+                            [x: string]: import("hono/utils/types").JSONValue;
+                        } | undefined;
+                    };
+                    sessionMode: "fixed" | "ephemeral" | "dedicated" | "inherit";
+                    updatedAt: number;
+                    runCount: number;
+                    successCount: number;
+                    failureCount: number;
+                    sessionId?: string | undefined;
+                    workspacePath?: string | undefined;
+                    lastRunAt?: number | undefined;
+                    nextRunAt?: number | undefined;
+                    lastError?: string | undefined;
+                }[];
+            };
+            outputFormat: "json";
+            status: 200;
+        } | {
+            input: {};
+            output: {
+                error: {
+                    message: string;
+                    code?: string | undefined;
+                    details?: import("hono/utils/types").JSONValue;
+                };
+                ok: false;
+            };
+            outputFormat: "json";
+            status: 500;
+        } | {
+            input: {};
+            output: {
+                error: {
+                    message: string;
+                    code?: string | undefined;
+                    details?: import("hono/utils/types").JSONValue;
+                };
+                ok: false;
+            };
+            outputFormat: "json";
+            status: 503;
+        };
+    };
+} & {
+    "/schedules": {
+        $post: {
+            input: {
+                json: {
+                    name: string;
+                    instruction: string;
+                    cronExpression: string;
+                    timezone?: string | undefined;
+                    enabled?: boolean | undefined;
+                    workspacePath?: string | null | undefined;
+                };
+            };
+            output: {
+                error: {
+                    message: string;
+                    code?: string | undefined;
+                    details?: import("hono/utils/types").JSONValue;
+                };
+                ok: false;
+            };
+            outputFormat: "json";
+            status: 500;
+        } | {
+            input: {
+                json: {
+                    name: string;
+                    instruction: string;
+                    cronExpression: string;
+                    timezone?: string | undefined;
+                    enabled?: boolean | undefined;
+                    workspacePath?: string | null | undefined;
+                };
+            };
+            output: {
+                error: {
+                    message: string;
+                    code?: string | undefined;
+                    details?: import("hono/utils/types").JSONValue;
+                };
+                ok: false;
+            };
+            outputFormat: "json";
+            status: 503;
+        } | {
+            input: {
+                json: {
+                    name: string;
+                    instruction: string;
+                    cronExpression: string;
+                    timezone?: string | undefined;
+                    enabled?: boolean | undefined;
+                    workspacePath?: string | null | undefined;
+                };
+            };
+            output: {
+                schedule: {
+                    id: string;
+                    name: string;
+                    createdAt: number;
+                    cronExpression: string;
+                    timezone: string;
+                    enabled: boolean;
+                    task: {
+                        instruction: string;
+                        metadata?: {
+                            [x: string]: import("hono/utils/types").JSONValue;
+                        } | undefined;
+                    };
+                    sessionMode: "fixed" | "ephemeral" | "dedicated" | "inherit";
+                    updatedAt: number;
+                    runCount: number;
+                    successCount: number;
+                    failureCount: number;
+                    sessionId?: string | undefined;
+                    workspacePath?: string | undefined;
+                    lastRunAt?: number | undefined;
+                    nextRunAt?: number | undefined;
+                    lastError?: string | undefined;
+                };
+            };
+            outputFormat: "json";
+            status: 201;
+        } | {
+            input: {
+                json: {
+                    name: string;
+                    instruction: string;
+                    cronExpression: string;
+                    timezone?: string | undefined;
+                    enabled?: boolean | undefined;
+                    workspacePath?: string | null | undefined;
+                };
+            };
+            output: {
+                error: {
+                    message: string;
+                    code?: string | undefined;
+                    details?: import("hono/utils/types").JSONValue;
+                };
+                ok: false;
+            };
+            outputFormat: "json";
+            status: 400;
+        } | {
+            input: {
+                json: {
+                    name: string;
+                    instruction: string;
+                    cronExpression: string;
+                    timezone?: string | undefined;
+                    enabled?: boolean | undefined;
+                    workspacePath?: string | null | undefined;
+                };
+            };
+            output: {
+                error: {
+                    message: string;
+                    code?: string | undefined;
+                    details?: import("hono/utils/types").JSONValue;
+                };
+                ok: false;
+            };
+            outputFormat: "json";
+            status: 429;
+        };
+    };
+} & {
+    "/schedules/:scheduleId": {
+        $patch: {
+            input: {
+                param: {
+                    scheduleId: string;
+                };
+            } & {
+                json: {
+                    name?: string | undefined;
+                    instruction?: string | undefined;
+                    cronExpression?: string | undefined;
+                    timezone?: string | undefined;
+                    enabled?: boolean | undefined;
+                    workspacePath?: string | null | undefined;
+                };
+            };
+            output: {
+                error: {
+                    message: string;
+                    code?: string | undefined;
+                    details?: import("hono/utils/types").JSONValue;
+                };
+                ok: false;
+            };
+            outputFormat: "json";
+            status: 500;
+        } | {
+            input: {
+                param: {
+                    scheduleId: string;
+                };
+            } & {
+                json: {
+                    name?: string | undefined;
+                    instruction?: string | undefined;
+                    cronExpression?: string | undefined;
+                    timezone?: string | undefined;
+                    enabled?: boolean | undefined;
+                    workspacePath?: string | null | undefined;
+                };
+            };
+            output: {
+                error: {
+                    message: string;
+                    code?: string | undefined;
+                    details?: import("hono/utils/types").JSONValue;
+                };
+                ok: false;
+            };
+            outputFormat: "json";
+            status: 503;
+        } | {
+            input: {
+                param: {
+                    scheduleId: string;
+                };
+            } & {
+                json: {
+                    name?: string | undefined;
+                    instruction?: string | undefined;
+                    cronExpression?: string | undefined;
+                    timezone?: string | undefined;
+                    enabled?: boolean | undefined;
+                    workspacePath?: string | null | undefined;
+                };
+            };
+            output: {
+                error: {
+                    message: string;
+                    code?: string | undefined;
+                    details?: import("hono/utils/types").JSONValue;
+                };
+                ok: false;
+            };
+            outputFormat: "json";
+            status: 400;
+        } | {
+            input: {
+                param: {
+                    scheduleId: string;
+                };
+            } & {
+                json: {
+                    name?: string | undefined;
+                    instruction?: string | undefined;
+                    cronExpression?: string | undefined;
+                    timezone?: string | undefined;
+                    enabled?: boolean | undefined;
+                    workspacePath?: string | null | undefined;
+                };
+            };
+            output: {
+                schedule: {
+                    id: string;
+                    name: string;
+                    createdAt: number;
+                    cronExpression: string;
+                    timezone: string;
+                    enabled: boolean;
+                    task: {
+                        instruction: string;
+                        metadata?: {
+                            [x: string]: import("hono/utils/types").JSONValue;
+                        } | undefined;
+                    };
+                    sessionMode: "fixed" | "ephemeral" | "dedicated" | "inherit";
+                    updatedAt: number;
+                    runCount: number;
+                    successCount: number;
+                    failureCount: number;
+                    sessionId?: string | undefined;
+                    workspacePath?: string | undefined;
+                    lastRunAt?: number | undefined;
+                    nextRunAt?: number | undefined;
+                    lastError?: string | undefined;
+                };
+            };
+            outputFormat: "json";
+            status: 200;
+        } | {
+            input: {
+                param: {
+                    scheduleId: string;
+                };
+            } & {
+                json: {
+                    name?: string | undefined;
+                    instruction?: string | undefined;
+                    cronExpression?: string | undefined;
+                    timezone?: string | undefined;
+                    enabled?: boolean | undefined;
+                    workspacePath?: string | null | undefined;
+                };
+            };
+            output: {
+                error: {
+                    message: string;
+                    code?: string | undefined;
+                    details?: import("hono/utils/types").JSONValue;
+                };
+                ok: false;
+            };
+            outputFormat: "json";
+            status: 404;
+        };
+    };
+} & {
+    "/schedules/:scheduleId": {
+        $delete: {
+            input: {
+                param: {
+                    scheduleId: string;
+                };
+            };
+            output: {
+                error: {
+                    message: string;
+                    code?: string | undefined;
+                    details?: import("hono/utils/types").JSONValue;
+                };
+                ok: false;
+            };
+            outputFormat: "json";
+            status: 500;
+        } | {
+            input: {
+                param: {
+                    scheduleId: string;
+                };
+            };
+            output: {
+                error: {
+                    message: string;
+                    code?: string | undefined;
+                    details?: import("hono/utils/types").JSONValue;
+                };
+                ok: false;
+            };
+            outputFormat: "json";
+            status: 503;
+        } | {
+            input: {
+                param: {
+                    scheduleId: string;
+                };
+            };
+            output: {
+                error: {
+                    message: string;
+                    code?: string | undefined;
+                    details?: import("hono/utils/types").JSONValue;
+                };
+                ok: false;
+            };
+            outputFormat: "json";
+            status: 404;
+        } | {
+            input: {
+                param: {
+                    scheduleId: string;
+                };
+            };
+            output: {
+                deleted: boolean;
+            };
+            outputFormat: "json";
+            status: 200;
+        };
+    };
+} & {
+    "/schedules/:scheduleId/trigger": {
+        $post: {
+            input: {
+                param: {
+                    scheduleId: string;
+                };
+            };
+            output: {
+                error: {
+                    message: string;
+                    code?: string | undefined;
+                    details?: import("hono/utils/types").JSONValue;
+                };
+                ok: false;
+            };
+            outputFormat: "json";
+            status: 500;
+        } | {
+            input: {
+                param: {
+                    scheduleId: string;
+                };
+            };
+            output: {
+                error: {
+                    message: string;
+                    code?: string | undefined;
+                    details?: import("hono/utils/types").JSONValue;
+                };
+                ok: false;
+            };
+            outputFormat: "json";
+            status: 503;
+        } | {
+            input: {
+                param: {
+                    scheduleId: string;
                 };
-            } & {
-                json: {
-                    status: import("@dexto/core").ApprovalStatus.APPROVED | import("@dexto/core").ApprovalStatus.DENIED;
-                    formData?: Record<string, unknown> | undefined;
-                    rememberChoice?: boolean | undefined;
+            };
+            output: {
+                error: {
+                    message: string;
+                    code?: string | undefined;
+                    details?: import("hono/utils/types").JSONValue;
                 };
+                ok: false;
             };
-            output: {};
-            outputFormat: string;
-            status: 503;
+            outputFormat: "json";
+            status: 404;
         } | {
             input: {
                 param: {
-                    approvalId: string;
+                    scheduleId: string;
                 };
-            } & {
-                header: {
-                    'Idempotency-Key'?: string | undefined;
-                };
-            } & {
+            };
+            output: {
+                scheduled: boolean;
+                execution?: {
+                    status: "success" | "pending" | "failed" | "timeout";
+                    id: string;
+                    scheduleId: string;
+                    triggeredAt: number;
+                    completedAt?: number | undefined;
+                    duration?: number | undefined;
+                    error?: string | undefined;
+                    result?: string | undefined;
+                } | undefined;
+            };
+            outputFormat: "json";
+            status: 200;
+        };
+    };
+}, "/api"> & import("hono/types").MergeSchemaPath<{
+    "/workspaces": {
+        $get: {
+            input: {};
+            output: {
+                workspaces: {
+                    path: string;
+                    id: string;
+                    createdAt: number;
+                    lastActiveAt: number;
+                    name?: string | null | undefined;
+                }[];
+            };
+            outputFormat: "json";
+            status: 200;
+        };
+    };
+} & {
+    "/workspaces/active": {
+        $get: {
+            input: {};
+            output: {
+                workspace: {
+                    path: string;
+                    id: string;
+                    createdAt: number;
+                    lastActiveAt: number;
+                    name?: string | null | undefined;
+                } | null;
+            };
+            outputFormat: "json";
+            status: 200;
+        };
+    };
+} & {
+    "/workspaces/active": {
+        $post: {
+            input: {
                 json: {
-                    status: import("@dexto/core").ApprovalStatus.APPROVED | import("@dexto/core").ApprovalStatus.DENIED;
-                    formData?: Record<string, unknown> | undefined;
-                    rememberChoice?: boolean | undefined;
+                    path: string;
+                    name?: string | undefined;
                 };
             };
             output: {
-                status: import("@dexto/core").ApprovalStatus.APPROVED | import("@dexto/core").ApprovalStatus.DENIED;
-                ok: boolean;
-                approvalId: string;
+                workspace: {
+                    path: string;
+                    id: string;
+                    createdAt: number;
+                    lastActiveAt: number;
+                    name?: string | null | undefined;
+                };
+            };
+            outputFormat: "json";
+            status: 200;
+        };
+    };
+} & {
+    "/workspaces/active": {
+        $delete: {
+            input: {};
+            output: {
+                workspace: {
+                    path: string;
+                    id: string;
+                    createdAt: number;
+                    lastActiveAt: number;
+                    name?: string | null | undefined;
+                } | null;
             };
             outputFormat: "json";
             status: 200;
@@ -912,11 +1463,11 @@ export declare function createDextoApp(options: CreateDextoAppOptions): OpenAPIH
                 };
             } & {
                 json: {
-                    content?: string | undefined;
                     metadata?: import("zod").objectInputType<{
                         source: import("zod").ZodOptional<import("zod").ZodEnum<["user", "system"]>>;
                         pinned: import("zod").ZodOptional<import("zod").ZodBoolean>;
                     }, import("zod").ZodTypeAny, "passthrough"> | undefined;
+                    content?: string | undefined;
                     tags?: string[] | undefined;
                 };
             };
@@ -960,7 +1511,6 @@ export declare function createDextoApp(options: CreateDextoAppOptions): OpenAPIH
         $get: {
             input: {};
             output: {
-                ok: true;
                 resources: {
                     uri: string;
                     source: "mcp" | "internal";
@@ -974,6 +1524,7 @@ export declare function createDextoApp(options: CreateDextoAppOptions): OpenAPIH
                     size?: number | undefined;
                     lastModified?: string | undefined;
                 }[];
+                ok: true;
             };
             outputFormat: "json";
             status: 200;
@@ -1304,8 +1855,8 @@ export declare function createDextoApp(options: CreateDextoAppOptions): OpenAPIH
                         type: "stdio";
                         command: string;
                         timeout?: number | undefined;
-                        enabled?: boolean | undefined;
                         args?: string[] | undefined;
+                        enabled?: boolean | undefined;
                         env?: Record<string, string> | undefined;
                         connectionMode?: "strict" | "lenient" | undefined;
                     } | {
@@ -1350,6 +1901,138 @@ export declare function createDextoApp(options: CreateDextoAppOptions): OpenAPIH
             status: 200;
         };
     };
+} & {
+    "/mcp/servers/:serverId/config": {
+        $get: {
+            input: {
+                param: {
+                    serverId: string;
+                };
+            };
+            output: {};
+            outputFormat: string;
+            status: 404;
+        } | {
+            input: {
+                param: {
+                    serverId: string;
+                };
+            };
+            output: {
+                config: {
+                    timeout: number;
+                    type: "stdio";
+                    args: string[];
+                    command: string;
+                    enabled: boolean;
+                    env: {
+                        [x: string]: string;
+                    };
+                    connectionMode: "strict" | "lenient";
+                } | {
+                    timeout: number;
+                    type: "sse";
+                    enabled: boolean;
+                    connectionMode: "strict" | "lenient";
+                    url: string;
+                    headers: {
+                        [x: string]: string;
+                    };
+                } | {
+                    timeout: number;
+                    type: "http";
+                    enabled: boolean;
+                    connectionMode: "strict" | "lenient";
+                    url: string;
+                    headers: {
+                        [x: string]: string;
+                    };
+                };
+                name: string;
+            };
+            outputFormat: "json";
+            status: 200;
+        };
+    };
+} & {
+    "/mcp/servers/:serverId": {
+        $put: {
+            input: {
+                param: {
+                    serverId: string;
+                };
+            } & {
+                json: {
+                    config: {
+                        type: "stdio";
+                        command: string;
+                        timeout?: number | undefined;
+                        args?: string[] | undefined;
+                        enabled?: boolean | undefined;
+                        env?: Record<string, string> | undefined;
+                        connectionMode?: "strict" | "lenient" | undefined;
+                    } | {
+                        type: "sse";
+                        url: string;
+                        timeout?: number | undefined;
+                        enabled?: boolean | undefined;
+                        connectionMode?: "strict" | "lenient" | undefined;
+                        headers?: Record<string, string> | undefined;
+                    } | {
+                        type: "http";
+                        url: string;
+                        timeout?: number | undefined;
+                        enabled?: boolean | undefined;
+                        connectionMode?: "strict" | "lenient" | undefined;
+                        headers?: Record<string, string> | undefined;
+                    };
+                    persistToAgent?: boolean | undefined;
+                };
+            };
+            output: {};
+            outputFormat: string;
+            status: 404;
+        } | {
+            input: {
+                param: {
+                    serverId: string;
+                };
+            } & {
+                json: {
+                    config: {
+                        type: "stdio";
+                        command: string;
+                        timeout?: number | undefined;
+                        args?: string[] | undefined;
+                        enabled?: boolean | undefined;
+                        env?: Record<string, string> | undefined;
+                        connectionMode?: "strict" | "lenient" | undefined;
+                    } | {
+                        type: "sse";
+                        url: string;
+                        timeout?: number | undefined;
+                        enabled?: boolean | undefined;
+                        connectionMode?: "strict" | "lenient" | undefined;
+                        headers?: Record<string, string> | undefined;
+                    } | {
+                        type: "http";
+                        url: string;
+                        timeout?: number | undefined;
+                        enabled?: boolean | undefined;
+                        connectionMode?: "strict" | "lenient" | undefined;
+                        headers?: Record<string, string> | undefined;
+                    };
+                    persistToAgent?: boolean | undefined;
+                };
+            };
+            output: {
+                status: string;
+                name: string;
+            };
+            outputFormat: "json";
+            status: 200;
+        };
+    };
 } & {
     "/mcp/servers/:serverId/tools": {
         $get: {
@@ -1386,6 +2069,9 @@ export declare function createDextoApp(options: CreateDextoAppOptions): OpenAPIH
                         } | undefined;
                         required?: string[] | undefined;
                     } | undefined;
+                    _meta?: {
+                        [x: string]: import("hono/utils/types").JSONValue;
+                    } | undefined;
                 }[];
             };
             outputFormat: "json";
@@ -1492,7 +2178,6 @@ export declare function createDextoApp(options: CreateDextoAppOptions): OpenAPIH
                 };
             };
             output: {
-                success: boolean;
                 resources: {
                     uri: string;
                     source: "mcp" | "internal";
@@ -1506,6 +2191,7 @@ export declare function createDextoApp(options: CreateDextoAppOptions): OpenAPIH
                     size?: number | undefined;
                     lastModified?: string | undefined;
                 }[];
+                success: boolean;
             };
             outputFormat: "json";
             status: 200;
@@ -1631,9 +2317,9 @@ export declare function createDextoApp(options: CreateDextoAppOptions): OpenAPIH
                 results: {
                     sessionId: string;
                     metadata: {
+                        messageCount: number;
                         createdAt: number;
                         lastActivity: number;
-                        messageCount: number;
                     };
                     matchCount: number;
                     firstMatch: {
@@ -1708,10 +2394,36 @@ export declare function createDextoApp(options: CreateDextoAppOptions): OpenAPIH
             output: {
                 sessions: {
                     id: string;
+                    messageCount: number;
                     createdAt: number | null;
                     lastActivity: number | null;
-                    messageCount: number;
                     title?: string | null | undefined;
+                    tokenUsage?: {
+                        inputTokens: number;
+                        outputTokens: number;
+                        reasoningTokens: number;
+                        totalTokens: number;
+                        cacheReadTokens: number;
+                        cacheWriteTokens: number;
+                    } | undefined;
+                    estimatedCost?: number | undefined;
+                    modelStats?: {
+                        tokenUsage: {
+                            inputTokens: number;
+                            outputTokens: number;
+                            reasoningTokens: number;
+                            totalTokens: number;
+                            cacheReadTokens: number;
+                            cacheWriteTokens: number;
+                        };
+                        model: string;
+                        provider: string;
+                        messageCount: number;
+                        estimatedCost: number;
+                        firstUsedAt: number;
+                        lastUsedAt: number;
+                    }[] | undefined;
+                    workspaceId?: string | null | undefined;
                 }[];
             };
             outputFormat: "json";
@@ -1729,10 +2441,36 @@ export declare function createDextoApp(options: CreateDextoAppOptions): OpenAPIH
             output: {
                 session: {
                     id: string;
+                    messageCount: number;
                     createdAt: number | null;
                     lastActivity: number | null;
-                    messageCount: number;
                     title?: string | null | undefined;
+                    tokenUsage?: {
+                        inputTokens: number;
+                        outputTokens: number;
+                        reasoningTokens: number;
+                        totalTokens: number;
+                        cacheReadTokens: number;
+                        cacheWriteTokens: number;
+                    } | undefined;
+                    estimatedCost?: number | undefined;
+                    modelStats?: {
+                        tokenUsage: {
+                            inputTokens: number;
+                            outputTokens: number;
+                            reasoningTokens: number;
+                            totalTokens: number;
+                            cacheReadTokens: number;
+                            cacheWriteTokens: number;
+                        };
+                        model: string;
+                        provider: string;
+                        messageCount: number;
+                        estimatedCost: number;
+                        firstUsedAt: number;
+                        lastUsedAt: number;
+                    }[] | undefined;
+                    workspaceId?: string | null | undefined;
                 };
             };
             outputFormat: "json";
@@ -1750,11 +2488,37 @@ export declare function createDextoApp(options: CreateDextoAppOptions): OpenAPIH
             output: {
                 session: {
                     id: string;
+                    messageCount: number;
                     createdAt: number | null;
                     lastActivity: number | null;
-                    messageCount: number;
                     history: number;
                     title?: string | null | undefined;
+                    tokenUsage?: {
+                        inputTokens: number;
+                        outputTokens: number;
+                        reasoningTokens: number;
+                        totalTokens: number;
+                        cacheReadTokens: number;
+                        cacheWriteTokens: number;
+                    } | undefined;
+                    estimatedCost?: number | undefined;
+                    modelStats?: {
+                        tokenUsage: {
+                            inputTokens: number;
+                            outputTokens: number;
+                            reasoningTokens: number;
+                            totalTokens: number;
+                            cacheReadTokens: number;
+                            cacheWriteTokens: number;
+                        };
+                        model: string;
+                        provider: string;
+                        messageCount: number;
+                        estimatedCost: number;
+                        firstUsedAt: number;
+                        lastUsedAt: number;
+                    }[] | undefined;
+                    workspaceId?: string | null | undefined;
                 };
             };
             outputFormat: "json";
@@ -1876,11 +2640,37 @@ export declare function createDextoApp(options: CreateDextoAppOptions): OpenAPIH
             output: {
                 session: {
                     id: string;
+                    messageCount: number;
                     createdAt: number | null;
                     lastActivity: number | null;
-                    messageCount: number;
                     isBusy: boolean;
                     title?: string | null | undefined;
+                    tokenUsage?: {
+                        inputTokens: number;
+                        outputTokens: number;
+                        reasoningTokens: number;
+                        totalTokens: number;
+                        cacheReadTokens: number;
+                        cacheWriteTokens: number;
+                    } | undefined;
+                    estimatedCost?: number | undefined;
+                    modelStats?: {
+                        tokenUsage: {
+                            inputTokens: number;
+                            outputTokens: number;
+                            reasoningTokens: number;
+                            totalTokens: number;
+                            cacheReadTokens: number;
+                            cacheWriteTokens: number;
+                        };
+                        model: string;
+                        provider: string;
+                        messageCount: number;
+                        estimatedCost: number;
+                        firstUsedAt: number;
+                        lastUsedAt: number;
+                    }[] | undefined;
+                    workspaceId?: string | null | undefined;
                 };
             };
             outputFormat: "json";
@@ -1913,10 +2703,36 @@ export declare function createDextoApp(options: CreateDextoAppOptions): OpenAPIH
             output: {
                 session: {
                     id: string;
+                    messageCount: number;
                     createdAt: number | null;
                     lastActivity: number | null;
-                    messageCount: number;
                     title?: string | null | undefined;
+                    tokenUsage?: {
+                        inputTokens: number;
+                        outputTokens: number;
+                        reasoningTokens: number;
+                        totalTokens: number;
+                        cacheReadTokens: number;
+                        cacheWriteTokens: number;
+                    } | undefined;
+                    estimatedCost?: number | undefined;
+                    modelStats?: {
+                        tokenUsage: {
+                            inputTokens: number;
+                            outputTokens: number;
+                            reasoningTokens: number;
+                            totalTokens: number;
+                            cacheReadTokens: number;
+                            cacheWriteTokens: number;
+                        };
+                        model: string;
+                        provider: string;
+                        messageCount: number;
+                        estimatedCost: number;
+                        firstUsedAt: number;
+                        lastUsedAt: number;
+                    }[] | undefined;
+                    workspaceId?: string | null | undefined;
                 };
             };
             outputFormat: "json";
@@ -2396,9 +3212,9 @@ export declare function createDextoApp(options: CreateDextoAppOptions): OpenAPIH
         $post: {
             input: {
                 json: {
+                    apiKey?: string | undefined;
                     model?: string | undefined;
                     provider?: "openai" | "openai-compatible" | "anthropic" | "google" | "groq" | "xai" | "cohere" | "minimax" | "glm" | "openrouter" | "litellm" | "glama" | "vertex" | "bedrock" | "local" | "ollama" | "dexto-nova" | undefined;
-                    apiKey?: string | undefined;
                     maxInputTokens?: number | undefined;
                     maxIterations?: number | undefined;
                     baseURL?: string | undefined;
@@ -2505,8 +3321,8 @@ export declare function createDextoApp(options: CreateDextoAppOptions): OpenAPIH
                 };
             };
             output: {
-                ok: false;
                 error: string;
+                ok: false;
             };
             outputFormat: "json";
             status: 404;
@@ -2785,19 +3601,19 @@ export declare function createDextoApp(options: CreateDextoAppOptions): OpenAPIH
                     };
                     metadata?: Record<string, any> | undefined;
                     configuration?: {
-                        blocking?: boolean | undefined;
                         acceptedOutputModes?: string[] | undefined;
                         historyLength?: number | undefined;
                         pushNotificationConfig?: {
                             url: string;
                             headers?: Record<string, string> | undefined;
                         } | undefined;
+                        blocking?: boolean | undefined;
                     } | undefined;
                 };
             };
             output: {
                 status: {
-                    state: "unknown" | "auth-required" | "submitted" | "working" | "input-required" | "completed" | "canceled" | "failed" | "rejected";
+                    state: "unknown" | "failed" | "auth-required" | "submitted" | "working" | "input-required" | "completed" | "canceled" | "rejected";
                     message?: {
                         role: "user" | "agent";
                         kind: "message";
@@ -2899,7 +3715,7 @@ export declare function createDextoApp(options: CreateDextoAppOptions): OpenAPIH
         $get: {
             input: {
                 query: {
-                    status?: "unknown" | "auth-required" | "submitted" | "working" | "input-required" | "completed" | "canceled" | "failed" | "rejected" | undefined;
+                    status?: "unknown" | "failed" | "auth-required" | "submitted" | "working" | "input-required" | "completed" | "canceled" | "rejected" | undefined;
                     contextId?: string | undefined;
                     pageSize?: string | undefined;
                     historyLength?: string | undefined;
@@ -2911,7 +3727,7 @@ export declare function createDextoApp(options: CreateDextoAppOptions): OpenAPIH
             output: {
                 tasks: {
                     status: {
-                        state: "unknown" | "auth-required" | "submitted" | "working" | "input-required" | "completed" | "canceled" | "failed" | "rejected";
+                        state: "unknown" | "failed" | "auth-required" | "submitted" | "working" | "input-required" | "completed" | "canceled" | "rejected";
                         message?: {
                             role: "user" | "agent";
                             kind: "message";
@@ -3031,7 +3847,7 @@ export declare function createDextoApp(options: CreateDextoAppOptions): OpenAPIH
             };
             output: {
                 status: {
-                    state: "unknown" | "auth-required" | "submitted" | "working" | "input-required" | "completed" | "canceled" | "failed" | "rejected";
+                    state: "unknown" | "failed" | "auth-required" | "submitted" | "working" | "input-required" | "completed" | "canceled" | "rejected";
                     message?: {
                         role: "user" | "agent";
                         kind: "message";
@@ -3147,7 +3963,7 @@ export declare function createDextoApp(options: CreateDextoAppOptions): OpenAPIH
             };
             output: {
                 status: {
-                    state: "unknown" | "auth-required" | "submitted" | "working" | "input-required" | "completed" | "canceled" | "failed" | "rejected";
+                    state: "unknown" | "failed" | "auth-required" | "submitted" | "working" | "input-required" | "completed" | "canceled" | "rejected";
                     message?: {
                         role: "user" | "agent";
                         kind: "message";