@datalayer/agent-runtimes 1.0.10 → 1.0.18

package/lib/examples2/notebooks/NotebookOutputs.ipynb.json

@@ -0,0 +1,49 @@
+{
+  "cells": [
+    {
+      "cell_type": "code",
+      "execution_count": 1,
+      "metadata": {},
+      "outputs": [
+        {
+          "data": {
+            "text/plain": ["2"]
+          },
+          "execution_count": 1,
+          "metadata": {},
+          "output_type": "execute_result"
+        }
+      ],
+      "source": ["1+1"]
+    },
+    {
+      "cell_type": "code",
+      "execution_count": 1,
+      "metadata": {},
+      "outputs": [
+        {
+          "ename": "NameError",
+          "evalue": "name 'HTML' is not defined",
+          "output_type": "error",
+          "traceback": [
+            "\u001b[0;31m---------------------------------------------------------------------------\u001b[0m",
+            "\u001b[0;31mNameError\u001b[0m                                 Traceback (most recent call last)",
+            "Cell \u001b[0;32mIn[1], line 1\u001b[0m\n\u001b[0;32m----> 1\u001b[0m display(\u001b[43mHTML\u001b[49m(\u001b[38;5;124m\"\u001b[39m\u001b[38;5;124m\"\u001b[39m));\n",
+            "\u001b[0;31mNameError\u001b[0m: name 'HTML' is not defined"
+          ]
+        }
+      ],
+      "source": ["display(HTML(\"\"));"]
+    },
+    {
+      "cell_type": "code",
+      "execution_count": null,
+      "metadata": {},
+      "outputs": [],
+      "source": []
+    }
+  ],
+  "metadata": {},
+  "nbformat": 4,
+  "nbformat_minor": 4
+}

package/lib/examples2/notebooks/NotebookToCExample.ipynb.json

@@ -0,0 +1,102 @@
+{
+  "cells": [
+    {
+      "cell_type": "markdown",
+      "id": "6ecc7b98-968d-43cd-9fbb-8ceadf863b74",
+      "metadata": {},
+      "source": ["# Heading 1"]
+    },
+    {
+      "cell_type": "markdown",
+      "id": "5099ba4a-88e8-4108-be32-a0ea52a58f79",
+      "metadata": {
+        "editable": true,
+        "slideshow": {
+          "slide_type": ""
+        },
+        "tags": []
+      },
+      "source": ["LOL"]
+    },
+    {
+      "cell_type": "markdown",
+      "id": "418b532a-c1eb-4f37-96c2-3465879122de",
+      "metadata": {},
+      "source": ["**Okay**"]
+    },
+    {
+      "cell_type": "markdown",
+      "id": "60a3ee36-8ee6-4648-93d7-af587bf3892f",
+      "metadata": {},
+      "source": ["## Heading 1-1"]
+    },
+    {
+      "cell_type": "code",
+      "execution_count": 2,
+      "id": "113f7bb9-220a-405f-9784-e0de940e0adf",
+      "metadata": {},
+      "outputs": [
+        {
+          "name": "stdin",
+          "output_type": "stream",
+          "text": ["Please input your name:  leon\n"]
+        },
+        {
+          "name": "stdout",
+          "output_type": "stream",
+          "text": ["Hello, leon!\n", "finish\n"]
+        }
+      ],
+      "source": [
+        "name = input(\"Please input your name: \")\n",
+        "print(f\"Hello, {name}!\") \n",
+        "import time\n",
+        "time.sleep(3)\n",
+        "print(\"finish\")"
+      ]
+    },
+    {
+      "cell_type": "markdown",
+      "id": "dfd17807-2ad3-4d2d-8371-5102d24e0d67",
+      "metadata": {},
+      "source": ["# Heading 2"]
+    },
+    {
+      "cell_type": "markdown",
+      "id": "de6a4139-4e4d-49d4-8824-0985baccf704",
+      "metadata": {
+        "editable": true,
+        "slideshow": {
+          "slide_type": ""
+        },
+        "tags": []
+      },
+      "source": [
+        "## Heading 2-1\n",
+        "\n",
+        "Man! **you know** what I am saying."
+      ]
+    }
+  ],
+  "metadata": {
+    "kernelspec": {
+      "display_name": "Python 3 (ipykernel)",
+      "language": "python",
+      "name": "python3"
+    },
+    "language_info": {
+      "codemirror_mode": {
+        "name": "ipython",
+        "version": 3
+      },
+      "file_extension": ".py",
+      "mimetype": "text/x-python",
+      "name": "python",
+      "nbconvert_exporter": "python",
+      "pygments_lexer": "ipython3",
+      "version": "3.10.4"
+    }
+  },
+  "nbformat": 4,
+  "nbformat_minor": 5
+}

package/lib/examples2/notebooks/OutputIPyWidgetsExample.d.ts

@@ -0,0 +1,145 @@
+export declare const view: {
+    version_major: number;
+    version_minor: number;
+    model_id: string;
+};
+export declare const state: {
+    version_major: number;
+    version_minor: number;
+    state: {
+        '8621699ecc804983a612f09b7dfe806b': {
+            model_name: string;
+            model_module: string;
+            model_module_version: string;
+            state: {
+                _view_module_version: string;
+                children: string[];
+                _model_module_version: string;
+                layout: string;
+                _view_count: number;
+            };
+        };
+        '961d612211fe4c64a70f48942d885c14': {
+            model_name: string;
+            model_module: string;
+            model_module_version: string;
+            state: {
+                _model_module_version: string;
+                _view_module_version: string;
+                _view_count: number;
+            };
+        };
+        '564e75ddea4c4ea0a32c4bd39ed0ed6d': {
+            model_name: string;
+            model_module: string;
+            model_module_version: string;
+            state: {
+                _model_module_version: string;
+                _view_module_version: string;
+                _view_count: number;
+            };
+        };
+        a8b1ae50aada4d929397b907115bfc2c: {
+            model_name: string;
+            model_module: string;
+            model_module_version: string;
+            state: {
+                style: string;
+                _view_module_version: string;
+                max: number;
+                value: number;
+                _model_module_version: string;
+                layout: string;
+                _view_count: number;
+            };
+        };
+        b63481ca8b7943aa85d097a114a931f5: {
+            model_name: string;
+            model_module: string;
+            model_module_version: string;
+            state: {
+                _model_module_version: string;
+                _view_module_version: string;
+                _view_count: number;
+            };
+        };
+        d86e0cb348eb48bf97f14906a9406731: {
+            model_name: string;
+            model_module: string;
+            model_module_version: string;
+            state: {
+                _model_module_version: string;
+                _view_module_version: string;
+                _view_count: number;
+            };
+        };
+        '289e54d14b7c4c6d8ac18b4c86ab514c': {
+            model_name: string;
+            model_module: string;
+            model_module_version: string;
+            state: {
+                style: string;
+                _view_module_version: string;
+                value: number;
+                _model_module_version: string;
+                layout: string;
+                _view_count: number;
+            };
+        };
+        bb589d8dc365404b94e73a153407128f: {
+            model_name: string;
+            model_module: string;
+            model_module_version: string;
+            state: {
+                _model_module_version: string;
+                _view_module_version: string;
+                _view_count: number;
+            };
+        };
+        '19a24d8ea5a248be8db79790290ae2a1': {
+            model_name: string;
+            model_module: string;
+            model_module_version: string;
+            state: {
+                _model_module_version: string;
+                _view_module_version: string;
+                _view_count: number;
+            };
+        };
+        '965bbfeaddd74b9baa488c7f6ac13027': {
+            model_name: string;
+            model_module: string;
+            model_module_version: string;
+            state: {
+                style: string;
+                _view_module_version: string;
+                icon: string;
+                _model_module_version: string;
+                layout: string;
+                _view_count: number;
+            };
+        };
+        '6edd9d3360cc47c8aceff0ba11edeca9': {
+            model_name: string;
+            model_module: string;
+            model_module_version: string;
+            state: {
+                _model_module_version: string;
+                target: string[];
+                source: string[];
+                _view_module_version: string;
+                _view_name: string;
+            };
+        };
+        d7d14e74f61f4b3bb5f53a713bcadced: {
+            model_name: string;
+            model_module: string;
+            model_module_version: string;
+            state: {
+                _model_module_version: string;
+                _view_module_version: string;
+                _view_count: number;
+            };
+        };
+    };
+};

package/lib/examples2/notebooks/OutputIPyWidgetsExample.js

@@ -0,0 +1,153 @@
+/*
+ * Copyright (c) 2025-2026 Datalayer, Inc.
+ * Distributed under the terms of the Modified BSD License.
+ */
+export const view = {
+    version_major: 2,
+    version_minor: 0,
+    model_id: '8621699ecc804983a612f09b7dfe806b',
+};
+export const state = {
+    version_major: 2,
+    version_minor: 0,
+    state: {
+        '8621699ecc804983a612f09b7dfe806b': {
+            model_name: 'VBoxModel',
+            model_module: '@jupyter-widgets/controls',
+            model_module_version: '1.0.0',
+            state: {
+                _view_module_version: '1.0.0',
+                children: [
+                    'IPY_MODEL_a8b1ae50aada4d929397b907115bfc2c',
+                    'IPY_MODEL_289e54d14b7c4c6d8ac18b4c86ab514c',
+                    'IPY_MODEL_965bbfeaddd74b9baa488c7f6ac13027',
+                ],
+                _model_module_version: '1.0.0',
+                layout: 'IPY_MODEL_d7d14e74f61f4b3bb5f53a713bcadced',
+                _view_count: 1,
+            },
+        },
+        '961d612211fe4c64a70f48942d885c14': {
+            model_name: 'LayoutModel',
+            model_module: '@jupyter-widgets/base',
+            model_module_version: '1.0.0',
+            state: {
+                _model_module_version: '1.0.0',
+                _view_module_version: '1.0.0',
+                _view_count: 1,
+            },
+        },
+        '564e75ddea4c4ea0a32c4bd39ed0ed6d': {
+            model_name: 'SliderStyleModel',
+            model_module: '@jupyter-widgets/controls',
+            model_module_version: '1.0.0',
+            state: {
+                _model_module_version: '1.0.0',
+                _view_module_version: '1.0.0',
+                _view_count: 1,
+            },
+        },
+        a8b1ae50aada4d929397b907115bfc2c: {
+            model_name: 'IntSliderModel',
+            model_module: '@jupyter-widgets/controls',
+            model_module_version: '1.0.0',
+            state: {
+                style: 'IPY_MODEL_564e75ddea4c4ea0a32c4bd39ed0ed6d',
+                _view_module_version: '1.0.0',
+                max: 200,
+                value: 100,
+                _model_module_version: '1.0.0',
+                layout: 'IPY_MODEL_961d612211fe4c64a70f48942d885c14',
+                _view_count: 1,
+            },
+        },
+        b63481ca8b7943aa85d097a114a931f5: {
+            model_name: 'LayoutModel',
+            model_module: '@jupyter-widgets/base',
+            model_module_version: '1.0.0',
+            state: {
+                _model_module_version: '1.0.0',
+                _view_module_version: '1.0.0',
+                _view_count: 1,
+            },
+        },
+        d86e0cb348eb48bf97f14906a9406731: {
+            model_name: 'SliderStyleModel',
+            model_module: '@jupyter-widgets/controls',
+            model_module_version: '1.0.0',
+            state: {
+                _model_module_version: '1.0.0',
+                _view_module_version: '1.0.0',
+                _view_count: 1,
+            },
+        },
+        '289e54d14b7c4c6d8ac18b4c86ab514c': {
+            model_name: 'IntSliderModel',
+            model_module: '@jupyter-widgets/controls',
+            model_module_version: '1.0.0',
+            state: {
+                style: 'IPY_MODEL_d86e0cb348eb48bf97f14906a9406731',
+                _view_module_version: '1.0.0',
+                value: 40,
+                _model_module_version: '1.0.0',
+                layout: 'IPY_MODEL_b63481ca8b7943aa85d097a114a931f5',
+                _view_count: 1,
+            },
+        },
+        bb589d8dc365404b94e73a153407128f: {
+            model_name: 'LayoutModel',
+            model_module: '@jupyter-widgets/base',
+            model_module_version: '1.0.0',
+            state: {
+                _model_module_version: '1.0.0',
+                _view_module_version: '1.0.0',
+                _view_count: 1,
+            },
+        },
+        '19a24d8ea5a248be8db79790290ae2a1': {
+            model_name: 'ButtonStyleModel',
+            model_module: '@jupyter-widgets/controls',
+            model_module_version: '1.0.0',
+            state: {
+                _model_module_version: '1.0.0',
+                _view_module_version: '1.0.0',
+                _view_count: 1,
+            },
+        },
+        '965bbfeaddd74b9baa488c7f6ac13027': {
+            model_name: 'ButtonModel',
+            model_module: '@jupyter-widgets/controls',
+            model_module_version: '1.0.0',
+            state: {
+                style: 'IPY_MODEL_19a24d8ea5a248be8db79790290ae2a1',
+                _view_module_version: '1.0.0',
+                icon: 'legal',
+                _model_module_version: '1.0.0',
+                layout: 'IPY_MODEL_bb589d8dc365404b94e73a153407128f',
+                _view_count: 1,
+            },
+        },
+        '6edd9d3360cc47c8aceff0ba11edeca9': {
+            model_name: 'DirectionalLinkModel',
+            model_module: '@jupyter-widgets/controls',
+            model_module_version: '1.0.0',
+            state: {
+                _model_module_version: '1.0.0',
+                target: ['IPY_MODEL_289e54d14b7c4c6d8ac18b4c86ab514c', 'max'],
+                source: ['IPY_MODEL_a8b1ae50aada4d929397b907115bfc2c', 'value'],
+                _view_module_version: '1.0.0',
+                _view_name: '',
+            },
+        },
+        d7d14e74f61f4b3bb5f53a713bcadced: {
+            model_name: 'LayoutModel',
+            model_module: '@jupyter-widgets/base',
+            model_module_version: '1.0.0',
+            state: {
+                _model_module_version: '1.0.0',
+                _view_module_version: '1.0.0',
+                _view_count: 1,
+            },
+        },
+    },
+};

package/lib/examples2/notebooks/PyGWalker.ipynb.json

@@ -0,0 +1,55 @@
+{
+  "cells": [
+    {
+      "cell_type": "code",
+      "execution_count": 1,
+      "metadata": {},
+      "outputs": [
+        {
+          "data": {
+            "text/plain": []
+          },
+          "execution_count": 1,
+          "metadata": {},
+          "output_type": "execute_result"
+        }
+      ],
+      "source": [
+        "import pygwalker as pyg\n",
+        "import pandas as pd\n",
+        "\n",
+        "df = pd.read_csv(\"https://kanaries-app.s3.ap-northeast-1.amazonaws.com/public-datasets/bike_sharing_dc.csv\")\n",
+        "\n",
+        "walker = pyg.walk(df)"
+      ]
+    },
+    {
+      "cell_type": "code",
+      "execution_count": null,
+      "metadata": {},
+      "outputs": [],
+      "source": []
+    }
+  ],
+  "metadata": {
+    "kernelspec": {
+      "display_name": "Python (ipykernel)",
+      "language": "python",
+      "name": "python"
+    },
+    "language_info": {
+      "codemirror_mode": {
+        "name": "ipython",
+        "version": 3
+      },
+      "file_extension": ".py",
+      "mimetype": "text/x-python",
+      "name": "python",
+      "nbconvert_exporter": "python",
+      "pygments_lexer": "ipython3",
+      "version": "3.10.4"
+    }
+  },
+  "nbformat": 4,
+  "nbformat_minor": 4
+}

package/lib/hooks/index.d.ts

@@ -70,7 +70,11 @@ export { useAgentRuntimes } from './useAgentRuntimes';
 /**
  * Runtime query and mutation hooks.
  */
-export { useAgentsRuntimes, useAgentRuntimesQuery, useAgentRuntimeByPodName, useCreateAgentRuntime, useDeleteAgentRuntime, useRefreshAgentRuntimes, agentQueryKeys, AGENT_QUERY_OPTIONS, useAgentLifecycleStore, getAgentLifecycleKey, } from './useAgentRuntimes';
+export { useAgentsRuntimes, useAgentRuntimesQuery, useAgentRuntimeByPodName, useCreateAgentRuntime, useDeleteAgentRuntime, useRefreshAgentRuntimes, agentQueryKeys, AGENT_QUERY_OPTIONS, useAgentLifecycleStore, getAgentLifecycleKey, markRuntimePodDeleted, clearRuntimePodDeleted, } from './useAgentRuntimes';
+/**
+ * Central registry of ServiceManagers connected to agent sandbox pods.
+ */
+export { registerSandboxServiceManager, disposeSandboxServiceManagers, } from '../services/sandboxServiceManagers';
 /**
  * Agent-runtime WebSocket stream hook.
  */
@@ -90,4 +94,8 @@ export { useCheckpoints, useCheckpointsQuery, useRefreshCheckpoints, useDeletePa
 export { useToolApprovals, useToolApprovalsQuery, usePendingApprovalCount, useApproveToolRequest, useRejectToolRequest, } from './useToolApprovals';
 export { useNotifications, useFilteredNotifications, useUnreadNotificationCount, useMarkNotificationRead, useMarkAllNotificationsRead, useAllAgentEvents, useAgentEvents, useAgentEvent, useCreateAgentEvent, useUpdateAgentEvent, useDeleteAgentEvent, useMarkEventRead, useMarkEventUnread, } from './useNotifications';
 export { useAIAgentsWebSocket, type UseAIAgentsWebSocketOptions, type UseAIAgentsWebSocketResult, type AIAgentsWebSocketCloseInfo, type AIAgentsWebSocketConnectionState, } from './useAIAgentsWebSocket';
+export { useProjects, useProject, useUpdateProject, useDeleteProject, useRefreshProjects, useProjectDefaultItems, type ProjectData, } from './useProjects';
 export { useOtelTotalTokens, fetchOtelTotalTokens, fetchOtelMetricTotal, fetchOtelMetricRows, toMetricValue, } from './useMonitoring';
+export { useProgressStore, type ProgressState } from './useProgressStore';
+export { useProgressTask } from './useProgressTask';
+export * from '@datalayer/core/lib/hooks';

package/lib/hooks/index.js

@@ -83,7 +83,11 @@ export { useAgentRuntimes } from './useAgentRuntimes';
 /**
  * Runtime query and mutation hooks.
  */
-export { useAgentsRuntimes, useAgentRuntimesQuery, useAgentRuntimeByPodName, useCreateAgentRuntime, useDeleteAgentRuntime, useRefreshAgentRuntimes, agentQueryKeys, AGENT_QUERY_OPTIONS, useAgentLifecycleStore, getAgentLifecycleKey, } from './useAgentRuntimes';
+export { useAgentsRuntimes, useAgentRuntimesQuery, useAgentRuntimeByPodName, useCreateAgentRuntime, useDeleteAgentRuntime, useRefreshAgentRuntimes, agentQueryKeys, AGENT_QUERY_OPTIONS, useAgentLifecycleStore, getAgentLifecycleKey, markRuntimePodDeleted, clearRuntimePodDeleted, } from './useAgentRuntimes';
+/**
+ * Central registry of ServiceManagers connected to agent sandbox pods.
+ */
+export { registerSandboxServiceManager, disposeSandboxServiceManagers, } from '../services/sandboxServiceManagers';
 /**
  * Agent-runtime WebSocket stream hook.
  */
@@ -103,4 +107,12 @@ export { useCheckpoints, useCheckpointsQuery, useRefreshCheckpoints, useDeletePa
 export { useToolApprovals, useToolApprovalsQuery, usePendingApprovalCount, useApproveToolRequest, useRejectToolRequest, } from './useToolApprovals';
 export { useNotifications, useFilteredNotifications, useUnreadNotificationCount, useMarkNotificationRead, useMarkAllNotificationsRead, useAllAgentEvents, useAgentEvents, useAgentEvent, useCreateAgentEvent, useUpdateAgentEvent, useDeleteAgentEvent, useMarkEventRead, useMarkEventUnread, } from './useNotifications';
 export { useAIAgentsWebSocket, } from './useAIAgentsWebSocket';
+export { useProjects, useProject, useUpdateProject, useDeleteProject, useRefreshProjects, useProjectDefaultItems, } from './useProjects';
 export { useOtelTotalTokens, fetchOtelTotalTokens, fetchOtelMetricTotal, fetchOtelMetricRows, toMetricValue, } from './useMonitoring';
+// Global top progress bar: a single shared store + a convenience hook so any
+// view can drive the one app-wide progress bar.
+export { useProgressStore } from './useProgressStore';
+export { useProgressTask } from './useProgressTask';
+// Re-export core hooks so consumers can progressively migrate imports to
+// agent-runtimes without splitting runtime/content and IAM hook sources.
+export * from '@datalayer/core/lib/hooks';

package/lib/hooks/useAIAgentsWebSocket.d.ts

@@ -18,7 +18,7 @@ export type AIAgentsWebSocketConnectionState = 'connecting' | 'connected' | 'clo
 export interface UseAIAgentsWebSocketOptions {
     /** Enable/disable the socket lifecycle. */
     enabled?: boolean;
-    /** Override the service base URL (defaults to aiagentsRunUrl). */
+    /** Override the service base URL (defaults to aiAgentsUrl). */
     baseUrl?: string;
     /** WebSocket path (or full http/https URL) for the stream endpoint. */
     path?: string;

package/lib/hooks/useAIAgentsWebSocket.js

@@ -23,7 +23,23 @@ function useAuthToken() {
 }
 function useBaseUrl() {
     const config = useCoreStore((s) => s.configuration);
-    return config?.aiagentsRunUrl ?? DEFAULT_SERVICE_URLS.AI_AGENTS;
+    return config?.aiAgentsUrl ?? DEFAULT_SERVICE_URLS.AI_AGENTS;
+}
+/**
+ * Redact sensitive query params (e.g. the auth `token`) from a WebSocket URL
+ * before logging it.
+ */
+function redactWsUrl(wsUrl) {
+    try {
+        const url = new URL(wsUrl);
+        if (url.searchParams.has('token')) {
+            url.searchParams.set('token', 'REDACTED');
+        }
+        return url.toString();
+    }
+    catch {
+        return wsUrl.replace(/([?&]token=)[^&]*/gi, '$1REDACTED');
+    }
 }
 // ─── Hook ────────────────────────────────────────────────────────────
 const RECONNECT_DELAY_MS = 3_000;
@@ -120,7 +136,7 @@ export function useAIAgentsWebSocket(options) {
                 setReconnectAttempt(0);
                 setConnectionState('connected');
                 setLastClose(null);
-                console.debug('[ws:connect] url=%s', wsUrl);
+                console.debug('[ws:connect] url=%s', redactWsUrl(wsUrl));
                 onOpenRef.current?.();
                 // Subscribe to extra channels.
                 const channels = channelsRef.current;
@@ -223,7 +239,27 @@ export function useAIAgentsWebSocket(options) {
                 clearTimeout(reconnectTimer.current);
                 reconnectTimer.current = null;
             }
-            wsRef.current?.close();
+            if (wsRef.current) {
+                // Avoid "WebSocket is closed before the connection is established"
+                // warnings during teardown races while still in CONNECTING.
+                if (wsRef.current.readyState === WebSocket.CONNECTING) {
+                    const pending = wsRef.current;
+                    pending.onopen = () => {
+                        try {
+                            pending.close();
+                        }
+                        catch {
+                            // no-op
+                        }
+                    };
+                    pending.onerror = () => {
+                        // no-op: expected while tearing down a pending handshake
+                    };
+                }
+                else {
+                    wsRef.current.close();
+                }
+            }
             wsRef.current = null;
             setConnectionState('closed');
         };

package/lib/hooks/useAgentRuntimes.d.ts

@@ -1,4 +1,4 @@
-import type { IRuntimeOptions } from '@datalayer/core/lib/stateful/runtimes/apis';
+import type { IRuntimeOptions } from '../runtimes/apis';
 import type { AgentConfig } from '../types/config';
 import type { AgentConnection } from '../types/connection';
 import type { AgentStatus, AgentRuntimeData } from '../types/agents';
@@ -56,6 +56,11 @@ export interface UseAgentReturn {
     serviceManager: ServiceManager.IManager | null;
     /** Create an agent on the runtime */
     createAgent: (config?: AgentConfig) => Promise<Pick<AgentConnection, 'agentId' | 'endpoint' | 'isReady'>>;
+    /**
+     * Delete the current agent on the server and reset in-process runtime state
+     * so a fresh runtime/agent can be launched.
+     */
+    teardown: () => Promise<void>;
     /** Whether agent creation is currently in progress */
     isCreating: boolean;
     /** Whether everything is ready (runtime + agent) */
@@ -85,6 +90,10 @@ export declare const agentQueryKeys: {
         readonly lists: () => readonly ["checkpoints", "list"];
     };
 };
+/** Mark a runtime pod as deleted by this client (tombstone). */
+export declare function markRuntimePodDeleted(podName: string): void;
+/** Clear a deleted-pod tombstone (pod legitimately exists again). */
+export declare function clearRuntimePodDeleted(podName: string): void;
 /**
  * Hook for managing agent runtimes.
  *
@@ -126,11 +135,11 @@ export declare function useAgentRuntimesQuery(scope?: {
 }, queryOptions?: {
     enabled?: boolean;
     refetchInterval?: number | false;
-}): import("@tanstack/react-query").UseQueryResult<AgentRuntimeData[], Error>;
+}): import("@tanstack/react-query").UseQueryResult<NoInfer<AgentRuntimeData[]>, Error>;
 /**
  * Hook to fetch a single agent runtime by pod name.
  */
-export declare function useAgentRuntimeByPodName(podName: string | undefined): import("@tanstack/react-query").UseQueryResult<AgentRuntimeData, Error>;
+export declare function useAgentRuntimeByPodName(podName: string | undefined): import("@tanstack/react-query").UseQueryResult<NoInfer<AgentRuntimeData>, Error>;
 /**
  * Hook to create a new agent runtime.
  */
@@ -164,6 +173,9 @@ export interface UseAgentsRuntimesReturn {
         data?: AgentRuntimeData[];
     }>;
     refreshRuntimes: () => void;
+    terminateRuntimeByPod: (podName: string, options?: {
+        beforeTerminate?: () => void | Promise<void>;
+    }) => Promise<unknown>;
     deleteRuntimeByPod: (podName: string) => Promise<unknown>;
     createRuntime: (data: CreateAgentRuntimeRequest) => Promise<CreateRuntimeApiResponse>;
 }