@datalayer/agent-runtimes 1.0.9 → 1.0.17

package/lib/runtimes/snapshots.js

@@ -0,0 +1,150 @@
+/*
+ * Copyright (c) 2025-2026 Datalayer, Inc.
+ * Distributed under the terms of the Modified BSD License.
+ */
+import { KernelExecutor } from '@datalayer/jupyter-react';
+import { createSandboxSnapshotDownloadURL, uploadCodeSandboxSnapshot } from '.';
+/**
+ * Snapshot a runtime through the frontend and upload it to the cloud.
+ *
+ * Note: You should use this only for browser runtimes.
+ */
+export async function createSandboxSnapshot(props) {
+    const { connection, metadata, onUploadProgress } = props;
+    const dump = await new KernelExecutor({ connection }).execute(GET_RUNTIME_SNAPSHOT_SNIPPET, {
+        storeHistory: false,
+    });
+    const serializedData = (dump.get(0)?.data['application/vnd.jupyter.stdout'] ??
+        '');
+    // Convert the data to blob.
+    const bytes = base64ToBytes(serializedData);
+    const file = new Blob([bytes.buffer]);
+    return uploadCodeSandboxSnapshot({
+        file,
+        metadata,
+        onProgress: onUploadProgress,
+    });
+}
+function base64ToBytes(base64) {
+    // Taken from https://developer.mozilla.org/en-US/docs/Web/API/Window/btoa#unicode_strings
+    const binString = atob(base64);
+    // @ts-expect-error TypeScript does not like this
+    return Uint8Array.from(binString, m => m.codePointAt(0));
+}
+/**
+ * Load a snapshot within a browser kernel.
+ *
+ * Note: You should use this only for browser kernels.
+ */
+export async function loadBrowserSandboxSnapshot({ connection, id, }) {
+    const downloadURL = createSandboxSnapshotDownloadURL(id);
+    const response = await fetch(downloadURL);
+    const buffer = await response.arrayBuffer();
+    const base64 = bytesToBase64(new Uint8Array(buffer));
+    await new KernelExecutor({
+        connection,
+    }).execute(getLoadSandboxSnapshotSnippet(base64), {
+        storeHistory: false,
+        silent: true,
+    });
+}
+function bytesToBase64(bytes) {
+    // Taken from https://developer.mozilla.org/en-US/docs/Web/API/Window/btoa#unicode_strings
+    const binString = Array.from(bytes, byte => String.fromCodePoint(byte)).join('');
+    return btoa(binString);
+}
+const GET_RUNTIME_SNAPSHOT_SNIPPET = `def _create_snapshot():
+    import logging
+    import os
+    import pickle
+    from base64 import encodebytes
+    from tempfile import TemporaryFile
+    from types import BuiltinFunctionType, BuiltinMethodType, FunctionType, MethodType, MethodWrapperType, ModuleType, TracebackType
+    
+    # print(pickle.DEFAULT_PROTOCOL)
+
+    class NotFound:
+        pass
+
+    missing = NotFound()
+
+    FORBIDDEN_TYPES = [type, BuiltinFunctionType, BuiltinMethodType, FunctionType, MethodType, MethodWrapperType, ModuleType, TracebackType, NotFound]
+    try:
+        from IPython.core.autocall import ExitAutocall
+        from IPython.core.interactiveshell import InteractiveShell
+        FORBIDDEN_TYPES.extend([ExitAutocall, InteractiveShell])
+    except ImportError:
+        pass
+    exclude = tuple(FORBIDDEN_TYPES)
+
+    all = frozenset(filter(lambda n: not n.startswith("_"), globals()))
+
+    line_separator = bytes(os.linesep, "utf-8")
+    with TemporaryFile() as dump:
+        for _n in all:
+            _v = globals().get(_n, missing)
+            
+            if not (
+                isinstance(_v, exclude) or
+                # Special IPython variables
+                (_n == "In" and isinstance(_v, list)) or
+                (_n == "Out" and isinstance(_v, dict))
+            ):
+                try:
+                    dumped_n = _n.encode("utf-8") + line_separator + pickle.dumps(_v) + line_separator + b"\\x00" + line_separator
+                    dump.write(dumped_n)
+                except BaseException as e:
+                    logging.warning("Failed to dump variable [%s ([%s])].", _n, type(_v).__qualname__, exc_info=e)
+                else:
+                    logging.debug("Variable [%s] dumped", _n)
+
+        dump.seek(0)
+        print(encodebytes(dump.read()).decode("ascii"))
+
+_create_snapshot()
+del _create_snapshot
+`;
+function getLoadSandboxSnapshotSnippet(content) {
+    return `async def _load_snapshot():
+    import os
+    import logging
+    import platform
+    import pickle
+    from base64 import decodebytes
+    is_pyodide = platform.node() == "emscripten"
+
+    snapshot = decodebytes("${content}".encode("ascii"))
+    line_sep = bytes(os.linesep, "utf-8")
+    variable_separator = b"\\x00" + line_sep
+    name = b""
+    value = b""
+    for line in snapshot.splitlines():
+        line += line_sep
+        if line == variable_separator:
+            name_s = name.strip().decode("utf-8")
+            try:
+                try:
+                    globals()[name_s] = pickle.loads(value)
+                except ModuleNotFoundError as m:
+                    if is_pyodide:
+                        import micropip
+                        logging.info(f'Installing %s...', m.name)
+                        await micropip.install(m.name)
+                        globals()[name_s] = pickle.loads(value)
+                    else:
+                        raise m
+            except BaseException as e:
+                logging.warning("Failed to load variable [%s].", name_s, exc_info=e)
+            else:
+                logging.debug("Variable [%s] loaded", name_s)
+
+            name = b""
+            value = b""
+        else:
+            if not name:
+                name = line
+            else:
+                value += line
+await _load_snapshot()
+del _load_snapshot`;
+}

package/lib/runtimes/utils.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Check whether the location is remote or not.
+ *
+ * @param location The location to test
+ * @returns The result
+ */
+export declare function isRuntimeRemote(location: string): boolean;

package/lib/runtimes/utils.js

@@ -0,0 +1,14 @@
+/*
+ * Copyright (c) 2025-2026 Datalayer, Inc.
+ * Distributed under the terms of the Modified BSD License.
+ */
+const NON_REMOTE_LOCATION = ['browser', 'local'];
+/**
+ * Check whether the location is remote or not.
+ *
+ * @param location The location to test
+ * @returns The result
+ */
+export function isRuntimeRemote(location) {
+    return !NON_REMOTE_LOCATION.includes(location);
+}

package/lib/services/DatalayerServiceManager.d.ts

@@ -0,0 +1,23 @@
+import { ServiceManager } from '@jupyterlab/services';
+/**
+ * Creates a ServiceManager configured for Datalayer.
+ *
+ * This function requests a new kernel from Datalayer's platform and
+ * returns a configured ServiceManager that connects to the allocated
+ * Jupyter server instance.
+ *
+ * @param environmentName - The name of the Datalayer environment to use
+ * @param credits - The credit limit for this kernel session
+ * @param runtimeName - Optional human-readable runtime name
+ * @returns A configured ServiceManager instance
+ * @throws Error if the kernel request fails or configuration is missing
+ *
+ * @example
+ * ```typescript
+ * const serviceManager = await createDatalayerServiceManager('ai-agents-env', 100);
+ * await serviceManager.ready;
+ * // Use the service manager with notebooks
+ * ```
+ */
+export declare const createDatalayerServiceManager: (environmentName?: string, credits?: number, runtimeName?: string) => Promise<ServiceManager.IManager>;
+export default createDatalayerServiceManager;

package/lib/services/DatalayerServiceManager.js

@@ -0,0 +1,90 @@
+/*
+ * Copyright (c) 2025-2026 Datalayer, Inc.
+ * Distributed under the terms of the Modified BSD License.
+ */
+import { ServerConnection, ServiceManager } from '@jupyterlab/services';
+import { coreStore } from '@datalayer/core/lib/state/substates/CoreState';
+import { DEFAULT_DATALAYER_CONFIG } from '@datalayer/core/lib/config/Configuration';
+import { createRuntime } from '../runtimes/actions';
+const normalizeEnvironmentName = (value) => {
+    if (!value) {
+        return undefined;
+    }
+    const normalized = String(value)
+        .trim()
+        .replace(/^["']+/, '')
+        .replace(/["']+$/, '')
+        .trim();
+    return normalized || undefined;
+};
+const normalizeRuntimeName = (value) => {
+    if (!value) {
+        return undefined;
+    }
+    const normalized = String(value)
+        .trim()
+        .replace(/^['"]+/, '')
+        .replace(/['"]+$/, '')
+        .replace(/\s+/g, ' ')
+        .trim();
+    return normalized || undefined;
+};
+/**
+ * Creates a ServiceManager configured for Datalayer.
+ *
+ * This function requests a new kernel from Datalayer's platform and
+ * returns a configured ServiceManager that connects to the allocated
+ * Jupyter server instance.
+ *
+ * @param environmentName - The name of the Datalayer environment to use
+ * @param credits - The credit limit for this kernel session
+ * @param runtimeName - Optional human-readable runtime name
+ * @returns A configured ServiceManager instance
+ * @throws Error if the kernel request fails or configuration is missing
+ *
+ * @example
+ * ```typescript
+ * const serviceManager = await createDatalayerServiceManager('ai-agents-env', 100);
+ * await serviceManager.ready;
+ * // Use the service manager with notebooks
+ * ```
+ */
+export const createDatalayerServiceManager = async (environmentName, credits, runtimeName) => {
+    const { configuration } = coreStore.getState();
+    const token = configuration?.token || '';
+    const defaultEnvironmentName = DEFAULT_DATALAYER_CONFIG.cpuEnvironment ?? 'ai-agents-env';
+    const defaultCredits = DEFAULT_DATALAYER_CONFIG.credits ?? 100;
+    // Use provided values or fall back to config or defaults
+    const actualEnvironmentName = normalizeEnvironmentName(environmentName) ||
+        normalizeEnvironmentName(configuration?.cpuEnvironment) ||
+        defaultEnvironmentName;
+    const actualCredits = credits ?? configuration?.credits ?? defaultCredits;
+    const actualRuntimeName = normalizeRuntimeName(runtimeName) ||
+        `Agent Runtime - ${new Date().toISOString()}`;
+    if (!token) {
+        throw new Error('Datalayer API token is required to create a service manager');
+    }
+    try {
+        // Use the existing createRuntime function which handles auth properly
+        const runtime = await createRuntime({
+            environmentName: actualEnvironmentName,
+            type: 'notebook',
+            givenName: actualRuntimeName,
+            creditsLimit: actualCredits,
+            capabilities: [],
+        });
+        const serverSettings = ServerConnection.makeSettings({
+            baseUrl: runtime.ingress,
+            wsUrl: runtime.ingress.replace(/^http/, 'ws'),
+            token: runtime.token,
+            appendToken: true,
+        });
+        const serviceManager = new ServiceManager({ serverSettings });
+        return serviceManager;
+    }
+    catch (error) {
+        console.error('Error creating Datalayer service manager:', error);
+        throw error;
+    }
+};
+export default createDatalayerServiceManager;

package/lib/services/reconnectToRuntime.d.ts

@@ -0,0 +1,32 @@
+import { ServiceManager } from '@jupyterlab/services';
+export interface RuntimeInfo {
+    runtimeId: string;
+    podName: string;
+    ingress: string;
+    token: string;
+    environmentName?: string;
+}
+/**
+ * Reconnects to an existing Datalayer runtime
+ *
+ * This function creates a ServiceManager that connects to an already
+ * allocated Jupyter server instance using stored runtime information.
+ *
+ * @param runtimeInfo - The stored runtime information
+ * @returns A configured ServiceManager instance
+ * @throws Error if the reconnection fails
+ *
+ * @example
+ * ```typescript
+ * const runtimeInfo = {
+ *   runtimeId: 'abc123',
+ *   podName: 'jupyter-pod-xyz',
+ *   ingress: 'https://jupyter.example.com',
+ *   token: 'secret-token'
+ * };
+ * const serviceManager = await reconnectToRuntime(runtimeInfo);
+ * await serviceManager.ready;
+ * ```
+ */
+export declare const reconnectToRuntime: (runtimeInfo: RuntimeInfo) => Promise<ServiceManager.IManager>;
+export default reconnectToRuntime;

package/lib/services/reconnectToRuntime.js

@@ -0,0 +1,59 @@
+/*
+ * Copyright (c) 2025-2026 Datalayer, Inc.
+ * Distributed under the terms of the Modified BSD License.
+ */
+import { ServerConnection, ServiceManager } from '@jupyterlab/services';
+/**
+ * Reconnects to an existing Datalayer runtime
+ *
+ * This function creates a ServiceManager that connects to an already
+ * allocated Jupyter server instance using stored runtime information.
+ *
+ * @param runtimeInfo - The stored runtime information
+ * @returns A configured ServiceManager instance
+ * @throws Error if the reconnection fails
+ *
+ * @example
+ * ```typescript
+ * const runtimeInfo = {
+ *   runtimeId: 'abc123',
+ *   podName: 'jupyter-pod-xyz',
+ *   ingress: 'https://jupyter.example.com',
+ *   token: 'secret-token'
+ * };
+ * const serviceManager = await reconnectToRuntime(runtimeInfo);
+ * await serviceManager.ready;
+ * ```
+ */
+export const reconnectToRuntime = async (runtimeInfo) => {
+    try {
+        const serverSettings = ServerConnection.makeSettings({
+            baseUrl: runtimeInfo.ingress,
+            wsUrl: runtimeInfo.ingress.replace(/^http/, 'ws'),
+            token: runtimeInfo.token,
+            appendToken: true,
+        });
+        const serviceManager = new ServiceManager({ serverSettings });
+        // Store runtime info on the serviceManager instance for access
+        serviceManager.__datalayerRuntime = {
+            environmentName: runtimeInfo.environmentName || 'unknown',
+            credits: 0,
+            reservationId: runtimeInfo.runtimeId,
+            podName: runtimeInfo.podName,
+            ingress: runtimeInfo.ingress,
+            token: runtimeInfo.token,
+            createdAt: new Date().toISOString(),
+        };
+        console.log('Reconnected to existing runtime:', {
+            runtimeId: runtimeInfo.runtimeId,
+            podName: runtimeInfo.podName,
+            ingress: runtimeInfo.ingress,
+        });
+        return serviceManager;
+    }
+    catch (error) {
+        console.error('Error reconnecting to runtime:', error);
+        throw error;
+    }
+};
+export default reconnectToRuntime;

package/lib/services/sandboxServiceManagers.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Central registry of Jupyter `ServiceManager`s connected to agent runtime
+ * sandbox pods, keyed by pod name.
+ *
+ * Multiple surfaces (files/terminal panel, ephemeral notebook, ephemeral
+ * document, ...) each open their own `ServiceManager` against the same
+ * sandbox ingress. When the runtime pod is terminated (or paused), every one
+ * of those managers must be disposed IMMEDIATELY, otherwise their background
+ * pollers (kernelspecs / sessions / users) keep hammering the dead ingress
+ * and produce endless CORS / ERR_FAILED noise.
+ *
+ * Every component that creates a manager against a sandbox pod registers it
+ * here; the runtime delete/pause mutations call
+ * {@link disposeSandboxServiceManagers} so teardown is centralized instead of
+ * relying on each component reacting to (possibly lagging) query cache
+ * updates.
+ */
+import type { ServiceManager } from '@jupyterlab/services';
+/**
+ * Register a `ServiceManager` connected to a sandbox pod.
+ *
+ * @returns An unregister function to call when the component disposes the
+ *   manager itself (cleanup). Unregistering does NOT dispose the manager.
+ */
+export declare function registerSandboxServiceManager(podName: string, manager: ServiceManager.IManager): () => void;
+/**
+ * Dispose (and unregister) every `ServiceManager` registered against a
+ * sandbox pod. Safe to call multiple times — `disposeServiceManager` is
+ * idempotent, and disposed managers are dropped from the registry.
+ */
+export declare function disposeSandboxServiceManagers(podName: string): void;

package/lib/services/sandboxServiceManagers.js

@@ -0,0 +1,57 @@
+/*
+ * Copyright (c) 2025-2026 Datalayer, Inc.
+ * Distributed under the terms of the Modified BSD License.
+ */
+import { disposeServiceManager } from '@datalayer/jupyter-react';
+const sandboxManagersByPod = new Map();
+/**
+ * Register a `ServiceManager` connected to a sandbox pod.
+ *
+ * @returns An unregister function to call when the component disposes the
+ *   manager itself (cleanup). Unregistering does NOT dispose the manager.
+ */
+export function registerSandboxServiceManager(podName, manager) {
+    const normalized = String(podName || '').trim();
+    if (!normalized || !manager) {
+        return () => { };
+    }
+    let managers = sandboxManagersByPod.get(normalized);
+    if (!managers) {
+        managers = new Set();
+        sandboxManagersByPod.set(normalized, managers);
+    }
+    managers.add(manager);
+    return () => {
+        const registered = sandboxManagersByPod.get(normalized);
+        if (registered) {
+            registered.delete(manager);
+            if (registered.size === 0) {
+                sandboxManagersByPod.delete(normalized);
+            }
+        }
+    };
+}
+/**
+ * Dispose (and unregister) every `ServiceManager` registered against a
+ * sandbox pod. Safe to call multiple times — `disposeServiceManager` is
+ * idempotent, and disposed managers are dropped from the registry.
+ */
+export function disposeSandboxServiceManagers(podName) {
+    const normalized = String(podName || '').trim();
+    if (!normalized) {
+        return;
+    }
+    const managers = sandboxManagersByPod.get(normalized);
+    if (!managers) {
+        return;
+    }
+    sandboxManagersByPod.delete(normalized);
+    managers.forEach(manager => {
+        try {
+            disposeServiceManager(manager);
+        }
+        catch (error) {
+            console.warn(`[sandboxServiceManagers] Failed disposing service manager for pod ${normalized}`, error);
+        }
+    });
+}

package/lib/specs/agents/agents.d.ts

@@ -5,67 +5,112 @@
  * THIS FILE IS AUTO-GENERATED. DO NOT EDIT MANUALLY.
  * Generated from YAML specifications in specs/agents/
  */
-import type { AgentSpec } from '../../types';
-export declare const ANALYZE_CAMPAIGN_PERFORMANCE_AGENT_SPEC_0_0_1: AgentSpec;
-export declare const ANALYZE_SUPPORT_TICKETS_AGENT_SPEC_0_0_1: AgentSpec;
-export declare const AUDIT_INVENTORY_LEVELS_AGENT_SPEC_0_0_1: AgentSpec;
-export declare const AUTOMATE_REGULATORY_REPORTING_AGENT_SPEC_0_0_1: AgentSpec;
-export declare const CLASSIFY_ROUTE_EMAILS_AGENT_SPEC_0_0_1: AgentSpec;
-export declare const COMPREHENSIVE_SALES_ANALYTICS_AGENT_SPEC_0_0_1: AgentSpec;
-export declare const CRAWLER_AGENT_SPEC_0_0_1: AgentSpec;
-export declare const DATA_ACQUISITION_AGENT_SPEC_0_0_1: AgentSpec;
-export declare const DEMO_OUTPUTS_AGENT_SPEC_0_0_1: AgentSpec;
-export declare const END_OF_MONTH_SALES_PERFORMANCE_AGENT_SPEC_0_0_1: AgentSpec;
-export declare const EVAL_EXPERIMENT_RUNNER_AGENT_SPEC_0_0_1: AgentSpec;
-export declare const EXAMPLE_CODEMODE_AGENT_SPEC_0_0_1: AgentSpec;
-export declare const EXAMPLE_EVALS_AGENT_SPEC_0_0_1: AgentSpec;
-export declare const EXAMPLE_FULL_AGENT_SPEC_0_0_1: AgentSpec;
-export declare const EXAMPLE_GUARDRAILS_AGENT_SPEC_0_0_1: AgentSpec;
-export declare const EXAMPLE_HOOKS_AGENT_SPEC_0_0_1: AgentSpec;
-export declare const EXAMPLE_INFERENCE_AGENT_SPEC_0_0_1: AgentSpec;
-export declare const EXAMPLE_MCP_AGENT_SPEC_0_0_1: AgentSpec;
-export declare const EXAMPLE_MEMORY_AGENT_SPEC_0_0_1: AgentSpec;
-export declare const EXAMPLE_MONITORING_AGENT_SPEC_0_0_1: AgentSpec;
-export declare const EXAMPLE_NO_CODEMODE_AGENT_SPEC_0_0_1: AgentSpec;
-export declare const EXAMPLE_NOTIFICATIONS_AGENT_SPEC_0_0_1: AgentSpec;
-export declare const EXAMPLE_ONE_TRIGGER_APPROVAL_AGENT_SPEC_0_0_1: AgentSpec;
-export declare const EXAMPLE_ONE_TRIGGER_AGENT_SPEC_0_0_1: AgentSpec;
-export declare const EXAMPLE_OTEL_AGENT_SPEC_0_0_1: AgentSpec;
-export declare const EXAMPLE_PARAMETERS_AGENT_SPEC_0_0_1: AgentSpec;
-export declare const EXAMPLE_SIMPLE_AGENT_SPEC_0_0_1: AgentSpec;
-export declare const EXAMPLE_SKILLS_AGENT_SPEC_0_0_1: AgentSpec;
-export declare const EXAMPLE_SUBAGENTS_AGENT_SPEC_0_0_1: AgentSpec;
-export declare const EXAMPLE_TOOL_APPROVALS_AGENT_SPEC_0_0_1: AgentSpec;
-export declare const EXTRACT_DATA_FROM_FILES_AGENT_SPEC_0_0_1: AgentSpec;
-export declare const FINANCIAL_VIZ_AGENT_SPEC_0_0_1: AgentSpec;
-export declare const FINANCIAL_AGENT_SPEC_0_0_1: AgentSpec;
-export declare const GENERATE_WEEKLY_REPORTS_AGENT_SPEC_0_0_1: AgentSpec;
-export declare const GITHUB_AGENT_SPEC_0_0_1: AgentSpec;
-export declare const INFORMATION_ROUTING_AGENT_SPEC_0_0_1: AgentSpec;
-export declare const MONITOR_SALES_KPIS_AGENT_SPEC_0_0_1: AgentSpec;
-export declare const OPTIMIZE_DYNAMIC_PRICING_AGENT_SPEC_0_0_1: AgentSpec;
-export declare const OPTIMIZE_GRID_OPERATIONS_AGENT_SPEC_0_0_1: AgentSpec;
-export declare const PROCESS_CITIZEN_REQUESTS_AGENT_SPEC_0_0_1: AgentSpec;
-export declare const PROCESS_CLINICAL_TRIAL_DATA_AGENT_SPEC_0_0_1: AgentSpec;
-export declare const PROCESS_FINANCIAL_TRANSACTIONS_AGENT_SPEC_0_0_1: AgentSpec;
-export declare const SPATIAL_DATA_ANALYSIS_AGENT_SPEC_0_0_1: AgentSpec;
-export declare const SUMMARIZE_DOCUMENTS_AGENT_SPEC_0_0_1: AgentSpec;
-export declare const SYNC_CRM_CONTACTS_AGENT_SPEC_0_0_1: AgentSpec;
-export declare const AGENT_SPECS: Record<string, AgentSpec>;
+import type { Agentspec } from '../../types';
+export declare const EXAMPLE_A2UI_AGENT_SPEC_0_0_1: Agentspec;
+export declare const EXAMPLE_AGENTIC_CHAT_AGENTSPEC_0_0_1: Agentspec;
+export declare const EXAMPLE_AGENTIC_GENERATIVE_UI_AGENTSPEC_0_0_1: Agentspec;
+export declare const EXAMPLE_BACKEND_TOOL_RENDERING_AGENTSPEC_0_0_1: Agentspec;
+export declare const EXAMPLE_CODEMODE_AGENTSPEC_0_0_1: Agentspec;
+export declare const EXAMPLE_EVALS_NOCODEMODE_AGENTSPEC_0_0_1: Agentspec;
+export declare const EXAMPLE_EVALS_AGENTSPEC_0_0_1: Agentspec;
+export declare const EXAMPLE_FULL_AGENTSPEC_0_0_1: Agentspec;
+export declare const EXAMPLE_GUARDRAILS_AGENTSPEC_0_0_1: Agentspec;
+export declare const EXAMPLE_HAIKU_GENERATIVE_UI_AGENTSPEC_0_0_1: Agentspec;
+export declare const EXAMPLE_HOOKS_AGENTSPEC_0_0_1: Agentspec;
+export declare const EXAMPLE_HUMAN_IN_THE_LOOP_AGENTSPEC_0_0_1: Agentspec;
+export declare const EXAMPLE_INFERENCE_AGENTSPEC_0_0_1: Agentspec;
+export declare const EXAMPLE_MCP_AGENTSPEC_0_0_1: Agentspec;
+export declare const EXAMPLE_MEMORY_AGENTSPEC_0_0_1: Agentspec;
+export declare const EXAMPLE_MONITORING_AGENTSPEC_0_0_1: Agentspec;
+export declare const EXAMPLE_NO_CODEMODE_AGENTSPEC_0_0_1: Agentspec;
+export declare const EXAMPLE_NOTIFICATIONS_AGENTSPEC_0_0_1: Agentspec;
+export declare const EXAMPLE_ONE_TRIGGER_APPROVAL_AGENTSPEC_0_0_1: Agentspec;
+export declare const EXAMPLE_ONE_TRIGGER_AGENTSPEC_0_0_1: Agentspec;
+export declare const EXAMPLE_OTEL_AGENTSPEC_0_0_1: Agentspec;
+export declare const EXAMPLE_OUTPUT_AGENTSPEC_0_0_1: Agentspec;
+export declare const EXAMPLE_PARAMETERS_AGENTSPEC_0_0_1: Agentspec;
+export declare const EXAMPLE_SHARED_STATE_AGENTSPEC_0_0_1: Agentspec;
+export declare const EXAMPLE_SIMPLE_AGENTSPEC_0_0_1: Agentspec;
+export declare const EXAMPLE_SKILLS_AGENTSPEC_0_0_1: Agentspec;
+export declare const EXAMPLE_SUBAGENTS_AGENTSPEC_0_0_1: Agentspec;
+export declare const EXAMPLE_TOOL_APPROVALS_AGENTSPEC_0_0_1: Agentspec;
+export declare const EXAMPLE_TOOL_BASED_GENERATIVE_UI_AGENTSPEC_0_0_1: Agentspec;
+export declare const GALLERY_ACCOUNTANT_AGENTSPEC_0_0_1: Agentspec;
+export declare const GALLERY_AGENT_CRITIC_LOOP_FOR_ANALYSIS_AGENTSPEC_0_0_1: Agentspec;
+export declare const GALLERY_AGENT_REVIEWS_SQL_AGENTSPEC_0_0_1: Agentspec;
+export declare const GALLERY_AI_CREATES_DASHBOARDS_AGENTSPEC_0_0_1: Agentspec;
+export declare const GALLERY_AI_EXPLAINS_NOTEBOOK_OUTPUT_AGENTSPEC_0_0_1: Agentspec;
+export declare const GALLERY_AI_WRITES_PANDAS_CODE_AGENTSPEC_0_0_1: Agentspec;
+export declare const GALLERY_ANALYZE_CAMPAIGN_PERFORMANCE_AGENTSPEC_0_0_1: Agentspec;
+export declare const GALLERY_ANALYZE_EXCEL_SPREADSHEET_AGENTSPEC_0_0_1: Agentspec;
+export declare const GALLERY_ANALYZE_SUPPORT_TICKETS_AGENTSPEC_0_0_1: Agentspec;
+export declare const GALLERY_AUDIT_INVENTORY_LEVELS_AGENTSPEC_0_0_1: Agentspec;
+export declare const GALLERY_AUTOMATE_REGULATORY_REPORTING_AGENTSPEC_0_0_1: Agentspec;
+export declare const GALLERY_BUILD_NOTEBOOK_WITH_ONE_PROMPT_AGENTSPEC_0_0_1: Agentspec;
+export declare const GALLERY_CLASSIFY_ROUTE_EMAILS_AGENTSPEC_0_0_1: Agentspec;
+export declare const GALLERY_COMPARE_TWO_SPREADSHEETS_AGENTSPEC_0_0_1: Agentspec;
+export declare const GALLERY_COMPLIANCE_REPORT_DRAFT_AGENTSPEC_0_0_1: Agentspec;
+export declare const GALLERY_COMPREHENSIVE_SALES_ANALYTICS_AGENTSPEC_0_0_1: Agentspec;
+export declare const GALLERY_COST_COMPARISON_REPORT_AGENTSPEC_0_0_1: Agentspec;
+export declare const GALLERY_CRAWLER_AGENTSPEC_0_0_1: Agentspec;
+export declare const GALLERY_CUSTOMER_CHURN_ANALYSIS_AGENTSPEC_0_0_1: Agentspec;
+export declare const GALLERY_DATA_ACQUISITION_AGENTSPEC_0_0_1: Agentspec;
+export declare const GALLERY_DOCUMENT_QA_AGENTSPEC_0_0_1: Agentspec;
+export declare const GALLERY_END_OF_MONTH_PERFORMANCE_AGENTSPEC_0_0_1: Agentspec;
+export declare const GALLERY_EXPLORE_SQL_DATABASE_AGENTSPEC_0_0_1: Agentspec;
+export declare const GALLERY_EXTRACT_DATA_FROM_FILES_AGENTSPEC_0_0_1: Agentspec;
+export declare const GALLERY_EXTRACT_KPIS_FROM_QUARTERLY_PDF_AGENTSPEC_0_0_1: Agentspec;
+export declare const GALLERY_FINANCIAL_RECONCILIATION_AGENTSPEC_0_0_1: Agentspec;
+export declare const GALLERY_FINANCIAL_VIZ_AGENTSPEC_0_0_1: Agentspec;
+export declare const GALLERY_FINANCIAL_AGENTSPEC_0_0_1: Agentspec;
+export declare const GALLERY_FIVE_AI_AGENTS_ANALYZE_CSV_AGENTSPEC_0_0_1: Agentspec;
+export declare const GALLERY_FIVE_NOTEBOOKS_IN_PARALLEL_AGENTSPEC_0_0_1: Agentspec;
+export declare const GALLERY_GENERATE_WEEKLY_REPORTS_AGENTSPEC_0_0_1: Agentspec;
+export declare const GALLERY_GITHUB_AGENT_SPEC_0_0_1: Agentspec;
+export declare const GALLERY_GPT_AND_CLAUDE_COLLABORATE_AGENTSPEC_0_0_1: Agentspec;
+export declare const GALLERY_HUMAN_APPROVED_AUTOMATION_AGENTSPEC_0_0_1: Agentspec;
+export declare const GALLERY_INFORMATION_ROUTING_AGENTSPEC_0_0_1: Agentspec;
+export declare const GALLERY_INSURANCE_CLAIMS_REVIEW_AGENTSPEC_0_0_1: Agentspec;
+export declare const GALLERY_INVENTORY_DEMAND_PLANNING_AGENTSPEC_0_0_1: Agentspec;
+export declare const GALLERY_LONG_RUNNING_AGENT_OVERNIGHT_AGENTSPEC_0_0_1: Agentspec;
+export declare const GALLERY_MARKETING_ANALYTICS_AGENTSPEC_0_0_1: Agentspec;
+export declare const GALLERY_MEDICAL_RESEARCH_REVIEW_AGENTSPEC_0_0_1: Agentspec;
+export declare const GALLERY_MONITOR_SALES_KPIS_AGENTSPEC_0_0_1: Agentspec;
+export declare const GALLERY_MULTI_AGENT_DATA_CLEANING_AGENTSPEC_0_0_1: Agentspec;
+export declare const GALLERY_MULTI_AGENT_ROOT_CAUSE_ANALYSIS_AGENTSPEC_0_0_1: Agentspec;
+export declare const GALLERY_OPTIMIZE_DYNAMIC_PRICING_AGENTSPEC_0_0_1: Agentspec;
+export declare const GALLERY_OPTIMIZE_GRID_OPERATIONS_AGENTSPEC_0_0_1: Agentspec;
+export declare const GALLERY_OPTIMIZE_SQL_QUERY_PERFORMANCE_AGENTSPEC_0_0_1: Agentspec;
+export declare const GALLERY_PROCESS_CITIZEN_REQUESTS_AGENTSPEC_0_0_1: Agentspec;
+export declare const GALLERY_PROCESS_CLINICAL_TRIAL_DATA_AGENTSPEC_0_0_1: Agentspec;
+export declare const GALLERY_PROCESS_FINANCIAL_TRANSACTIONS_AGENTSPEC_0_0_1: Agentspec;
+export declare const GALLERY_REPLACE_EXCEL_PIVOT_WORK_AGENTSPEC_0_0_1: Agentspec;
+export declare const GALLERY_RESUMABLE_ETL_WITH_CHECKPOINTS_AGENTSPEC_0_0_1: Agentspec;
+export declare const GALLERY_RUN_PYTHON_SAFELY_IN_THE_CLOUD_AGENTSPEC_0_0_1: Agentspec;
+export declare const GALLERY_SALES_FORECASTING_AGENTSPEC_0_0_1: Agentspec;
+export declare const GALLERY_SALES_PIPELINE_BOARD_REPORT_AGENTSPEC_0_0_1: Agentspec;
+export declare const GALLERY_SCHEDULED_NIGHTLY_DATA_QUALITY_CHECKS_AGENTSPEC_0_0_1: Agentspec;
+export declare const GALLERY_SCIENTIFIC_NOTEBOOK_ASSISTANT_AGENTSPEC_0_0_1: Agentspec;
+export declare const GALLERY_SPATIAL_DATA_ANALYSIS_AGENTSPEC_0_0_1: Agentspec;
+export declare const GALLERY_SUMMARIZE_10_PDFS_AGENTSPEC_0_0_1: Agentspec;
+export declare const GALLERY_SUMMARIZE_DOCUMENTS_AGENTSPEC_0_0_1: Agentspec;
+export declare const GALLERY_SYNC_CRM_CONTACTS_AGENTSPEC_0_0_1: Agentspec;
+export declare const GALLERY_WEEKLY_EXECUTIVE_BRIEFING_AGENTSPEC_0_0_1: Agentspec;
+export declare const AGENTSPECS: Record<string, Agentspec>;
 /**
  * Get an agent specification by ID.
  */
-export declare function getAgentSpecs(agentId: string): AgentSpec | undefined;
+export declare function getAgentspecs(agentId: string): Agentspec | undefined;
 /**
  * List all available agent specifications.
  *
  * @param prefix - If provided, only return specs whose ID starts with this prefix.
  */
-export declare function listAgentSpecs(prefix?: string): AgentSpec[];
+export declare function listAgentspecs(prefix?: string): Agentspec[];
 /**
  * Collect all required environment variables for an agent spec.
  *
  * Iterates over the spec's MCP servers and skills and returns the
  * deduplicated union of their `requiredEnvVars` arrays.
  */
-export declare function getAgentSpecRequiredEnvVars(spec: AgentSpec): string[];
+export declare function getAgentspecRequiredEnvVars(spec: Agentspec): string[];