@datalayer/agent-runtimes 1.0.3 → 1.0.5

package/lib/specs/envvars.d.ts

@@ -8,6 +8,7 @@
  */
 import type { EnvvarSpec } from '../types';
 export declare const ALPHAVANTAGE_API_KEY_SPEC_0_0_1: EnvvarSpec;
+export declare const DATALAYER_API_KEY_SPEC_0_0_1: EnvvarSpec;
 export declare const GITHUB_TOKEN_SPEC_0_0_1: EnvvarSpec;
 export declare const GOOGLE_OAUTH_CLIENT_ID_SPEC_0_0_1: EnvvarSpec;
 export declare const GOOGLE_OAUTH_CLIENT_SECRET_SPEC_0_0_1: EnvvarSpec;

package/lib/specs/envvars.js

@@ -15,6 +15,16 @@ export const ALPHAVANTAGE_API_KEY_SPEC_0_0_1 = {
     icon: 'key',
     emoji: '🔑',
 };
+export const DATALAYER_API_KEY_SPEC_0_0_1 = {
+    id: 'DATALAYER_API_KEY',
+    version: '0.0.1',
+    name: 'Datalayer API Key',
+    description: 'API key for authenticating with Datalayer services, including datalayer-skills such as datalayer-whoami.',
+    registrationUrl: 'https://datalayer.app',
+    tags: ['authentication', 'api-key', 'datalayer', 'skill'],
+    icon: 'key',
+    emoji: '🔑',
+};
 export const GITHUB_TOKEN_SPEC_0_0_1 = {
     id: 'GITHUB_TOKEN',
     version: '0.0.1',
@@ -116,6 +126,7 @@ export const TAVILY_API_KEY_SPEC_0_0_1 = {
 // ============================================================================
 export const ENVVAR_CATALOG = {
     ALPHAVANTAGE_API_KEY: ALPHAVANTAGE_API_KEY_SPEC_0_0_1,
+    DATALAYER_API_KEY: DATALAYER_API_KEY_SPEC_0_0_1,
     GITHUB_TOKEN: GITHUB_TOKEN_SPEC_0_0_1,
     GOOGLE_OAUTH_CLIENT_ID: GOOGLE_OAUTH_CLIENT_ID_SPEC_0_0_1,
     GOOGLE_OAUTH_CLIENT_SECRET: GOOGLE_OAUTH_CLIENT_SECRET_SPEC_0_0_1,

package/lib/specs/events.d.ts

@@ -13,6 +13,7 @@ export declare const TOOL_APPROVAL_REQUESTED_EVENT_SPEC_0_0_1: EventSpec;
 export declare const EVENT_KIND_AGENT_ENDED = "agent-ended";
 export declare const EVENT_KIND_AGENT_STARTED = "agent-started";
 export declare const EVENT_KIND_TOOL_APPROVAL_REQUESTED = "tool-approval-requested";
+export declare const EVENT_KIND_AGENT_ASSIGNED = "agent-assigned";
 export declare const EVENT_CATALOG: Record<string, EventSpec>;
 export declare function getEventSpecs(): EventSpec[];
 export declare function getEventSpec(eventId: string): EventSpec | undefined;

package/lib/specs/events.js

@@ -155,6 +155,7 @@ export const TOOL_APPROVAL_REQUESTED_EVENT_SPEC_0_0_1 = {
 export const EVENT_KIND_AGENT_ENDED = 'agent-ended';
 export const EVENT_KIND_AGENT_STARTED = 'agent-started';
 export const EVENT_KIND_TOOL_APPROVAL_REQUESTED = 'tool-approval-requested';
+export const EVENT_KIND_AGENT_ASSIGNED = 'agent-assigned';
 // ============================================================================
 // Event Catalog
 // ============================================================================

package/lib/specs/index.d.ts

@@ -13,6 +13,7 @@ export * from './memory';
 export * from './models';
 export * from './notifications';
 export * from './outputs';
+export * from './personas';
 export * from './skills';
 export * from './tools';
 export * from './triggers';

package/lib/specs/index.js

@@ -17,6 +17,7 @@ export * from './memory';
 export * from './models';
 export * from './notifications';
 export * from './outputs';
+export * from './personas';
 export * from './skills';
 export * from './tools';
 export * from './triggers';

package/lib/specs/personas.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Persona Catalog
+ *
+ * Predefined Persona configurations built on top of agent specs.
+ *
+ * This file is AUTO-GENERATED from YAML specifications.
+ * DO NOT EDIT MANUALLY - run 'make specs' to regenerate.
+ */
+import type { PersonaSpec } from '../types';
+export declare const Personas: {
+    readonly CODE: "code";
+    readonly FORECASTER: "forecaster";
+    readonly INTRUSION: "intrusion";
+    readonly JOVYAN: "jovyan";
+    readonly MARKETING: "marketing";
+    readonly PENTEST: "pentest";
+    readonly PHARMA: "pharma";
+    readonly POIROT: "poirot";
+    readonly SENTINEL: "sentinel";
+    readonly TRADER: "trader";
+    readonly TUTOR: "tutor";
+    readonly TWIN: "twin";
+};
+export type PersonaId = (typeof Personas)[keyof typeof Personas];
+export declare const CODE_PERSONA_0_0_1: PersonaSpec;
+export declare const FORECASTER_PERSONA_0_0_1: PersonaSpec;
+export declare const INTRUSION_PERSONA_0_0_1: PersonaSpec;
+export declare const JOVYAN_PERSONA_0_0_1: PersonaSpec;
+export declare const MARKETING_PERSONA_0_0_1: PersonaSpec;
+export declare const PENTEST_PERSONA_0_0_1: PersonaSpec;
+export declare const PHARMA_PERSONA_0_0_1: PersonaSpec;
+export declare const POIROT_PERSONA_0_0_1: PersonaSpec;
+export declare const SENTINEL_PERSONA_0_0_1: PersonaSpec;
+export declare const TRADER_PERSONA_0_0_1: PersonaSpec;
+export declare const TUTOR_PERSONA_0_0_1: PersonaSpec;
+export declare const TWIN_PERSONA_0_0_1: PersonaSpec;
+export declare const PERSONA_CATALOGUE: Record<string, PersonaSpec>;
+/** Get a persona specification by ID. */
+export declare function getPersona(personaId: string): PersonaSpec | undefined;
+/** List all available personas. */
+export declare function listPersonas(): PersonaSpec[];

package/lib/specs/personas.js

@@ -0,0 +1,168 @@
+/*
+ * Copyright (c) 2025-2026 Datalayer, Inc.
+ * Distributed under the terms of the Modified BSD License.
+ */
+// ============================================================================
+// Personas Enum
+// ============================================================================
+export const Personas = {
+    CODE: 'code',
+    FORECASTER: 'forecaster',
+    INTRUSION: 'intrusion',
+    JOVYAN: 'jovyan',
+    MARKETING: 'marketing',
+    PENTEST: 'pentest',
+    PHARMA: 'pharma',
+    POIROT: 'poirot',
+    SENTINEL: 'sentinel',
+    TRADER: 'trader',
+    TUTOR: 'tutor',
+    TWIN: 'twin',
+};
+// ============================================================================
+// Persona Definitions
+// ============================================================================
+export const CODE_PERSONA_0_0_1 = {
+    id: 'code',
+    version: '0.0.1',
+    name: 'Code',
+    description: 'A pragmatic coding companion focused on writing, reviewing and refactoring software. Pairs well with editors, terminals and code execution sandboxes.',
+    tags: ['coding', 'development', 'engineering', 'assistant'],
+    icon: 'code',
+    emoji: '🧑‍💻',
+};
+export const FORECASTER_PERSONA_0_0_1 = {
+    id: 'forecaster',
+    version: '0.0.1',
+    name: 'Forecaster',
+    description: 'A predictive-analytics persona that builds and explains time-series forecasts — sales pipelines, demand planning, revenue projection and scenario analysis.',
+    tags: ['forecasting', 'analytics', 'sales', 'time-series'],
+    icon: 'graph',
+    emoji: '📈',
+};
+export const INTRUSION_PERSONA_0_0_1 = {
+    id: 'intrusion',
+    version: '0.0.1',
+    name: 'Intrusion',
+    description: 'A defensive security persona focused on intrusion detection, log analysis, threat hunting and incident response across networks, endpoints and cloud workloads.',
+    tags: ['security', 'intrusion-detection', 'threat-hunting', 'blue-team'],
+    icon: 'shield-lock',
+    emoji: '🛡️',
+};
+export const JOVYAN_PERSONA_0_0_1 = {
+    id: 'jovyan',
+    version: '0.0.1',
+    name: 'Jovyan',
+    description: 'A Jupyter-native companion that lives in notebooks and lexical documents, runs cells, inspects kernels and helps you explore data, narratives and computations.',
+    tags: ['jupyter', 'notebook', 'data-science', 'kernels'],
+    icon: 'zap',
+    emoji: '🪐',
+};
+export const MARKETING_PERSONA_0_0_1 = {
+    id: 'marketing',
+    version: '0.0.1',
+    name: 'Marketing',
+    description: 'A creative marketing persona that drafts campaigns, social posts, newsletters and product copy — adapting tone, channel and audience to maximize engagement.',
+    tags: ['marketing', 'content', 'social-media', 'copywriting'],
+    icon: 'megaphone',
+    emoji: '📣',
+};
+export const PENTEST_PERSONA_0_0_1 = {
+    id: 'pentest',
+    version: '0.0.1',
+    name: 'Pentest',
+    description: 'An offensive security persona that helps with authorized penetration testing — reconnaissance, vulnerability assessment, exploit reasoning and reporting.',
+    tags: ['security', 'penetration-testing', 'red-team', 'vulnerability'],
+    icon: 'bug',
+    emoji: '🕷️',
+};
+export const PHARMA_PERSONA_0_0_1 = {
+    id: 'pharma',
+    version: '0.0.1',
+    name: 'Pharma',
+    description: 'A life-sciences persona for pharmaceutical and clinical workflows — literature review, trial data exploration, regulatory reporting and drug-safety signal triage.',
+    tags: ['pharma', 'life-sciences', 'clinical', 'regulatory'],
+    icon: 'beaker',
+    emoji: '💊',
+};
+export const POIROT_PERSONA_0_0_1 = {
+    id: 'poirot',
+    version: '0.0.1',
+    name: 'Poirot',
+    description: 'A meticulous detective persona for investigative workflows — root cause analysis, evidence correlation, timeline reconstruction and hypothesis testing across heterogeneous data.',
+    tags: ['investigation', 'root-cause', 'forensics', 'reasoning'],
+    icon: 'search',
+    emoji: '🕵️',
+};
+export const SENTINEL_PERSONA_0_0_1 = {
+    id: 'sentinel',
+    version: '0.0.1',
+    name: 'Sentinel',
+    description: 'A vigilant monitoring persona for real-time signal detection, anomaly spotting and early-warning alerts — including use cases such as seismic activity, infrastructure health and live event streams.',
+    tags: ['monitoring', 'detection', 'alerting', 'real-time', 'earthquake'],
+    icon: 'shield',
+    emoji: '🛰️',
+};
+export const TRADER_PERSONA_0_0_1 = {
+    id: 'trader',
+    version: '0.0.1',
+    name: 'Trader',
+    description: 'A markets persona for stock and portfolio analysis — quote retrieval, technical indicators, portfolio tracking and trading research workflows.',
+    tags: ['finance', 'stocks', 'markets', 'portfolio'],
+    icon: 'pulse',
+    emoji: '💹',
+};
+export const TUTOR_PERSONA_0_0_1 = {
+    id: 'tutor',
+    version: '0.0.1',
+    name: 'Tutor',
+    description: "A patient teaching companion that explains concepts, walks through examples step by step, asks questions and adapts its style to the learner's level.",
+    tags: ['education', 'learning', 'teaching', 'mentorship'],
+    icon: 'book',
+    emoji: '🎓',
+};
+export const TWIN_PERSONA_0_0_1 = {
+    id: 'twin',
+    version: '0.0.1',
+    name: 'Twin',
+    description: 'A digital twin of you — mirrors your context, preferences and history to assist with personal productivity, decision making and continuity across tools and sessions.',
+    tags: ['personal', 'productivity', 'context', 'assistant'],
+    icon: 'person',
+    emoji: '👤',
+};
+// ============================================================================
+// Persona Catalog
+// ============================================================================
+export const PERSONA_CATALOGUE = {
+    code: CODE_PERSONA_0_0_1,
+    forecaster: FORECASTER_PERSONA_0_0_1,
+    intrusion: INTRUSION_PERSONA_0_0_1,
+    jovyan: JOVYAN_PERSONA_0_0_1,
+    marketing: MARKETING_PERSONA_0_0_1,
+    pentest: PENTEST_PERSONA_0_0_1,
+    pharma: PHARMA_PERSONA_0_0_1,
+    poirot: POIROT_PERSONA_0_0_1,
+    sentinel: SENTINEL_PERSONA_0_0_1,
+    trader: TRADER_PERSONA_0_0_1,
+    tutor: TUTOR_PERSONA_0_0_1,
+    twin: TWIN_PERSONA_0_0_1,
+};
+function resolvePersonaId(personaId) {
+    if (personaId in PERSONA_CATALOGUE)
+        return personaId;
+    const idx = personaId.lastIndexOf(':');
+    if (idx > 0) {
+        const base = personaId.slice(0, idx);
+        if (base in PERSONA_CATALOGUE)
+            return base;
+    }
+    return personaId;
+}
+/** Get a persona specification by ID. */
+export function getPersona(personaId) {
+    return PERSONA_CATALOGUE[resolvePersonaId(personaId)];
+}
+/** List all available personas. */
+export function listPersonas() {
+    return Object.values(PERSONA_CATALOGUE);
+}

package/lib/specs/skills.d.ts

@@ -8,11 +8,12 @@
  */
 import type { SkillSpec } from '../types';
 export declare const CRAWL_SKILL_SPEC_0_0_1: SkillSpec;
+export declare const DATALAYER_WHOAMI_SKILL_SPEC_0_0_1: SkillSpec;
 export declare const EVENTS_SKILL_SPEC_0_0_1: SkillSpec;
 export declare const GITHUB_SKILL_SPEC_0_0_1: SkillSpec;
 export declare const JOKES_SKILL_SPEC_0_0_1: SkillSpec;
 export declare const PDF_SKILL_SPEC_0_0_1: SkillSpec;
 export declare const TEXT_SUMMARIZER_SKILL_SPEC_0_0_1: SkillSpec;
-export declare const SKILL_CATALOG: Record<string, SkillSpec>;
+export declare const SKILLS_CATALOG: Record<string, SkillSpec>;
 export declare function getSkillSpecs(): SkillSpec[];
 export declare function getSkillSpec(skillId: string): SkillSpec | undefined;

package/lib/specs/skills.js

@@ -22,6 +22,23 @@ export const CRAWL_SKILL_SPEC_0_0_1 = {
     emoji: '🌐',
     enabled: true,
 };
+export const DATALAYER_WHOAMI_SKILL_SPEC_0_0_1 = {
+    id: 'datalayer-whoami',
+    version: '0.0.1',
+    name: 'Datalayer Whoami Skill',
+    description: 'Retrieve the authenticated Datalayer user profile using the datalayer-skills package.',
+    module: 'datalayer_skills.skills.whoami',
+    package: undefined,
+    method: undefined,
+    path: undefined,
+    requiredEnvVars: ['DATALAYER_API_KEY:0.0.1'],
+    optionalEnvVars: [],
+    dependencies: ['datalayer_skills>=0.1.0'],
+    tags: ['datalayer', 'iam', 'identity', 'profile'],
+    icon: 'person',
+    emoji: '👤',
+    enabled: true,
+};
 export const EVENTS_SKILL_SPEC_0_0_1 = {
     id: 'events',
     version: '0.0.1',
@@ -110,8 +127,9 @@ export const TEXT_SUMMARIZER_SKILL_SPEC_0_0_1 = {
 // ============================================================================
 // Skill Catalog
 // ============================================================================
-export const SKILL_CATALOG = {
+export const SKILLS_CATALOG = {
     crawl: CRAWL_SKILL_SPEC_0_0_1,
+    'datalayer-whoami': DATALAYER_WHOAMI_SKILL_SPEC_0_0_1,
     events: EVENTS_SKILL_SPEC_0_0_1,
     github: GITHUB_SKILL_SPEC_0_0_1,
     jokes: JOKES_SKILL_SPEC_0_0_1,
@@ -119,19 +137,19 @@ export const SKILL_CATALOG = {
     'text-summarizer': TEXT_SUMMARIZER_SKILL_SPEC_0_0_1,
 };
 export function getSkillSpecs() {
-    return Object.values(SKILL_CATALOG);
+    return Object.values(SKILLS_CATALOG);
 }
 function resolveSkillId(skillId) {
-    if (skillId in SKILL_CATALOG)
+    if (skillId in SKILLS_CATALOG)
         return skillId;
     const idx = skillId.lastIndexOf(':');
     if (idx > 0) {
         const base = skillId.slice(0, idx);
-        if (base in SKILL_CATALOG)
+        if (base in SKILLS_CATALOG)
             return base;
     }
     return skillId;
 }
 export function getSkillSpec(skillId) {
-    return SKILL_CATALOG[resolveSkillId(skillId)];
+    return SKILLS_CATALOG[resolveSkillId(skillId)];
 }

package/lib/specs/tools.js

@@ -13,6 +13,7 @@ export const RUNTIME_ECHO_TOOL_SPEC_0_0_1 = {
     tags: ['runtime', 'utility'],
     enabled: true,
     approval: 'auto',
+    timeout: undefined,
     requiresApproval: false,
     runtime: {
         language: 'python',
@@ -30,6 +31,7 @@ export const RUNTIME_SEND_MAIL_TOOL_SPEC_0_0_1 = {
     tags: ['runtime', 'approval', 'mail'],
     enabled: true,
     approval: 'manual',
+    timeout: undefined,
     requiresApproval: true,
     runtime: {
         language: 'python',
@@ -47,6 +49,7 @@ export const RUNTIME_SENSITIVE_ECHO_TOOL_SPEC_0_0_1 = {
     tags: ['runtime', 'approval'],
     enabled: true,
     approval: 'manual',
+    timeout: undefined,
     requiresApproval: true,
     runtime: {
         language: 'python',

package/lib/stores/agentRuntimeStore.d.ts

@@ -0,0 +1,204 @@
+import type { ServiceManager } from '@jupyterlab/services';
+import type { IRuntimeOptions } from '@datalayer/core/lib/stateful/runtimes/apis';
+import type { AgentStatus, AgentConnection, AgentConfig, Protocol } from '../types';
+import type { AgentStreamSnapshotPayload, AgentStreamToolApprovalPayload, CodemodeStatusData } from '../types/stream';
+import type { ContextSnapshotData } from '../types/context';
+import type { McpToolsetsStatusResponse } from '../types/mcp';
+import type { LoadedSkillInfo } from '../types/skills';
+/**
+ * A URL-addressable agent that has been previously connected.
+ * May originate from an agent runtime pod OR from the stable agents service.
+ */
+export interface AgentRegistryEntry {
+    id: string;
+    name: string;
+    description: string;
+    baseUrl: string;
+    protocol: Protocol;
+    status: AgentStatus;
+    error?: string | null;
+    lastUpdated: number;
+    documentId?: string;
+    runtimeId?: string;
+    author?: string;
+    avatarUrl?: string;
+}
+export type AgentRuntimeWsState = 'closed' | 'connecting' | 'connected';
+export interface LocalTokenTurn {
+    turnNumber: number;
+    timestampMs: number;
+    systemPromptTokens: number;
+    toolsDescriptionTokens: number;
+    userMessageTokens: number;
+    aiMessageTokens: number;
+    toolsUsageTokens: number;
+    totalTokens: number;
+}
+export interface LocalCostPoint {
+    timestampMs: number;
+    cumulativeUsd: number;
+}
+export interface MonitoringCacheEntry {
+    tokenTurns: LocalTokenTurn[];
+    costPoints: LocalCostPoint[];
+}
+export declare function getMonitoringCacheKey(serviceName?: string, agentId?: string): string;
+export interface AgentRuntimeStoreState {
+    agents: readonly AgentRegistryEntry[];
+    runtime: AgentConnection | null;
+    status: AgentStatus;
+    error: string | null;
+    isLaunching: boolean;
+    wsState: AgentRuntimeWsState;
+    approvals: AgentStreamToolApprovalPayload[];
+    pendingApprovalCount: number;
+    contextSnapshot: ContextSnapshotData | null;
+    costUsage: ContextSnapshotData['costUsage'] | null;
+    mcpStatus: McpToolsetsStatusResponse | null;
+    codemodeStatus: CodemodeStatusData | null;
+    fullContext: Record<string, unknown> | null;
+    monitoringCache: Record<string, MonitoringCacheEntry>;
+    loadedSkillsByAgentId: Record<string, LoadedSkillInfo[]>;
+}
+export interface AgentRuntimeStoreActions {
+    upsertAgent: (agent: Partial<AgentRegistryEntry> & {
+        id: string;
+        baseUrl: string;
+        protocol: Protocol;
+    }) => void;
+    getAgentById: (id: string) => AgentRegistryEntry | undefined;
+    getAgentByUrl: (baseUrl: string, protocol: Protocol) => AgentRegistryEntry | undefined;
+    updateAgentStatus: (id: string, status: AgentStatus, error?: string | null) => void;
+    toggleAgentStatus: (id: string) => void;
+    deleteAgent: (id: string) => void;
+    clearAgents: () => void;
+    setLoadedSkillsForAgent: (agentId: string, skills: LoadedSkillInfo[]) => void;
+    getLoadedSkillsForAgent: (agentId: string) => LoadedSkillInfo[];
+    clearLoadedSkillsForAgent: (agentId: string) => void;
+    launchAgent: (options: IRuntimeOptions) => Promise<AgentConnection>;
+    connectAgent: (connection: {
+        podName: string;
+        environmentName: string;
+        serviceManager?: ServiceManager.IManager;
+        jupyterBaseUrl?: string;
+        kernelId?: string;
+    }) => void;
+    createAgent: (config?: AgentConfig) => Promise<Pick<AgentConnection, 'agentId' | 'endpoint' | 'isReady'>>;
+    disconnect: () => void;
+    clearError: () => void;
+    setError: (error: string) => void;
+    setWsState: (state: AgentRuntimeWsState) => void;
+    setWs: (ws: WebSocket | null, agentId?: string) => void;
+    applySnapshot: (payload: AgentStreamSnapshotPayload) => void;
+    upsertApproval: (approval: AgentStreamToolApprovalPayload) => void;
+    removeApproval: (approvalId: string) => void;
+    sendDecision: (approvalId: string, approved: boolean, note?: string, toolCallId?: string, agentId?: string) => boolean;
+    requestRefresh: (agentId?: string) => boolean;
+    sendRawMessage: (payload: Record<string, unknown>, agentId?: string) => boolean;
+    appendLocalTokenTurn: (params: {
+        serviceName?: string;
+        agentId?: string;
+        timestampMs: number;
+        promptTokens: number;
+        completionTokens: number;
+        totalTokens: number;
+    }) => void;
+    mergeTokenTurns: (params: {
+        serviceName?: string;
+        agentId?: string;
+        turns: LocalTokenTurn[];
+    }) => void;
+    appendLocalTokenTurnFull: (params: {
+        serviceName?: string;
+        agentId?: string;
+        timestampMs: number;
+        systemPromptTokens: number;
+        toolsDescriptionTokens: number;
+        userMessageTokens: number;
+        aiMessageTokens: number;
+        toolsUsageTokens: number;
+        totalTokens: number;
+    }) => void;
+    upsertLocalCostPoint: (params: {
+        serviceName?: string;
+        agentId?: string;
+        timestampMs: number;
+        cumulativeUsd: number;
+    }) => void;
+    mergeCostPoints: (params: {
+        serviceName?: string;
+        agentId?: string;
+        points: LocalCostPoint[];
+    }) => void;
+    reset: () => void;
+    resetWs: () => void;
+}
+export type AgentRuntimeStore = AgentRuntimeStoreState & AgentRuntimeStoreActions;
+export declare const agentRuntimeStore: Omit<Omit<import("zustand").StoreApi<AgentRuntimeStore>, "subscribe"> & {
+    subscribe: {
+        (listener: (selectedState: AgentRuntimeStore, previousSelectedState: AgentRuntimeStore) => void): () => void;
+        <U>(selector: (state: AgentRuntimeStore) => U, listener: (selectedState: U, previousSelectedState: U) => void, options?: {
+            equalityFn?: ((a: U, b: U) => boolean) | undefined;
+            fireImmediately?: boolean;
+        } | undefined): () => void;
+    };
+}, "persist"> & {
+    persist: {
+        setOptions: (options: Partial<import("zustand/middleware").PersistOptions<AgentRuntimeStore, unknown>>) => void;
+        clearStorage: () => void;
+        rehydrate: () => Promise<void> | void;
+        hasHydrated: () => boolean;
+        onHydrate: (fn: (state: AgentRuntimeStore) => void) => () => void;
+        onFinishHydration: (fn: (state: AgentRuntimeStore) => void) => () => void;
+        getOptions: () => Partial<import("zustand/middleware").PersistOptions<AgentRuntimeStore, unknown>>;
+    };
+};
+export declare function useAgentRuntimeStore(): AgentRuntimeStore;
+export declare function useAgentRuntimeStore<T>(selector: (state: AgentRuntimeStore) => T): T;
+export declare const useAgentRuntimeConnection: () => AgentConnection | null;
+export declare const useAgentRuntimeStatus: () => AgentStatus;
+export declare const useAgentRuntimeError: () => string | null;
+export declare const useAgentRuntimeIsLaunching: () => boolean;
+export declare const useAgentRuntimeApprovals: () => AgentStreamToolApprovalPayload[];
+export declare const useAgentRuntimePendingCount: () => number;
+export declare const useAgentRuntimeMcpStatus: () => McpToolsetsStatusResponse | null;
+export declare const useAgentRuntimeFullContext: () => Record<string, unknown> | null;
+export declare const useAgentRuntimeContextSnapshot: () => ContextSnapshotData | null;
+export declare const useAgentRuntimeCostUsage: () => {
+    lastTurnCostUsd: number;
+    cumulativeCostUsd: number;
+    perRunBudgetUsd: number | null;
+    cumulativeBudgetUsd: number | null;
+    requestCount: number;
+    totalTokensUsed: number;
+    modelBreakdown: Array<{
+        model: string;
+        inputTokens: number;
+        outputTokens: number;
+        costUsd: number;
+        requests: number;
+    }>;
+    runs: Array<{
+        timestamp: string;
+        model: string;
+        inputTokens: number;
+        outputTokens: number;
+        runCostUsd: number;
+        cumulativeCostUsd: number;
+        pricePerInputToken: number | null;
+        pricePerOutputToken: number | null;
+        pricingResolved: boolean;
+    }>;
+    lastUpdated: string | null;
+} | null | undefined;
+export declare const useAgentRuntimeCodemodeStatus: () => CodemodeStatusData | null;
+export declare const useAgentRuntimeWsState: () => AgentRuntimeWsState;
+export declare const useAgentRuntimeLoadedSkills: (agentId?: string) => LoadedSkillInfo[];
+export declare const getAgentRuntimeState: () => AgentRuntimeStore;
+export declare const subscribeToAgentRuntime: {
+    (listener: (selectedState: AgentRuntimeStore, previousSelectedState: AgentRuntimeStore) => void): () => void;
+    <U>(selector: (state: AgentRuntimeStore) => U, listener: (selectedState: U, previousSelectedState: U) => void, options?: {
+        equalityFn?: ((a: U, b: U) => boolean) | undefined;
+        fireImmediately?: boolean;
+    } | undefined): () => void;
+};