@datalayer/agent-runtimes 1.0.3 → 1.0.5

package/lib/client/AgentsMixin.d.ts

@@ -11,8 +11,8 @@
  * @module client/AgentsMixin
  */
 import type { Constructor } from '@datalayer/core/lib/client/utils/mixins';
-import type { AgentEvent, CreateAgentEventRequest, GetAgentEventResponse, ListAgentEventsParams, ListAgentEventsResponse, UpdateAgentEventRequest, RunningAgent, AgentUsageSummary, ConversationCheckpoint, AgentNotification, NotificationFilters, OutputArtifact, EvalReport, RunEvalsRequest, ContextUsage, CostUsage } from '../types';
-import type { ToolApproval, ToolApprovalFilters } from '../types/tool-approvals';
+import type { AgentEvent, CreateAgentEventRequest, GetAgentEventResponse, ListAgentEventsParams, ListAgentEventsResponse, UpdateAgentEventRequest, RunningAgent, AgentUsageSummary, ConversationCheckpoint, AgentNotification, NotificationFilters, OutputArtifact, EvalReport, RunEvalsRequest, ContextUsage, CostUsage, AgentSpec } from '../types';
+import type { CreateAgentRuntimeRequest, CreateRuntimeApiResponse } from '../types/agents-lifecycle';
 /** Agents mixin providing durable agent management. */
 export declare function AgentsMixin<TBase extends Constructor>(Base: TBase): {
     new (...args: any[]): {
@@ -52,23 +52,6 @@ export declare function AgentsMixin<TBase extends Constructor>(Base: TBase): {
          * @returns Usage summary including tokens, cost, iterations
          */
         getAgentUsage(podName: string, agentId?: string): Promise<AgentUsageSummary>;
-        /**
-         * List tool approval requests, optionally filtered.
-         * @param filters - Optional filters (status, agentId)
-         * @returns Array of tool approval records
-         */
-        getToolApprovals(filters?: ToolApprovalFilters): Promise<ToolApproval[]>;
-        /**
-         * Approve a tool execution request.
-         * @param approvalId - ID of the approval to approve
-         */
-        approveToolRequest(approvalId: string): Promise<void>;
-        /**
-         * Reject a tool execution request.
-         * @param approvalId - ID of the approval to reject
-         * @param reason - Optional rejection reason
-         */
-        rejectToolRequest(approvalId: string, reason?: string): Promise<void>;
         /**
          * List notifications, optionally filtered.
          * @param filters - Optional filters (level, read status)
@@ -165,5 +148,51 @@ export declare function AgentsMixin<TBase extends Constructor>(Base: TBase): {
          * @returns Cost usage including per-model breakdown
          */
         getCostUsage(agentId: string): Promise<CostUsage>;
+        /**
+         * Get an agent specification by ID.
+         * @param agentSpecId - Agent spec identifier.
+         * @returns The agent spec, or undefined if not found.
+         */
+        getAgentSpec(agentSpecId: string): AgentSpec | undefined;
+        /**
+         * List all available agent specifications.
+         * @param prefix - If provided, only return specs whose ID starts with this prefix.
+         * @returns Array of agent specifications.
+         */
+        listAgentSpecs(prefix?: string): AgentSpec[];
+        /**
+         * Get required environment variables for an agent spec.
+         * @param spec - The agent specification.
+         * @returns Deduplicated array of required environment variable names.
+         */
+        getAgentSpecRequiredEnvVars(spec: AgentSpec): string[];
+        /**
+         * Assign an agent runtime to a project.
+         * @param projectUid - Project UID.
+         * @param agentPodName - Agent runtime pod name.
+         * @param agentSpecId - Agent spec ID.
+         * @param agentGivenName - Human-readable runtime name.
+         * @returns Updated project.
+         */
+        assignAgentToProject(projectUid: string, agentPodName: string, agentSpecId?: string, agentGivenName?: string): Promise<any>;
+        /**
+         * Remove the agent assignment from a project.
+         * @param projectUid - Project UID.
+         * @returns Updated project.
+         */
+        unassignAgentFromProject(projectUid: string): Promise<any>;
+        /**
+         * Create an agent runtime.
+         * @param data - Runtime creation parameters.
+         * @returns The created runtime response.
+         */
+        createAgentRuntime(data: CreateAgentRuntimeRequest): Promise<CreateRuntimeApiResponse>;
+        /**
+         * Create an agent runtime and assign it to a project.
+         * @param projectUid - The project UID to assign the agent to.
+         * @param data - Runtime creation parameters.
+         * @returns The created runtime response.
+         */
+        createAgentRuntimeForProject(projectUid: string, data: CreateAgentRuntimeRequest): Promise<CreateRuntimeApiResponse>;
     };
 } & TBase;

package/lib/client/AgentsMixin.js

@@ -3,12 +3,13 @@
  * Distributed under the terms of the Modified BSD License.
  */
 import * as agents from '../api/agents';
-import * as toolApprovals from '../api/tool-approvals';
 import * as notifications from '../api/notifications';
 import * as events from '../api/events';
 import * as output from '../api/output';
 import * as evals from '../api/evals';
 import * as context from '../api/context';
+import * as agentSpecs from '../specs/agents';
+import { requestDatalayerAPI } from '@datalayer/core/lib/api/DatalayerApi';
 /** Agents mixin providing durable agent management. */
 export function AgentsMixin(Base) {
     return class extends Base {
@@ -78,35 +79,12 @@ export function AgentsMixin(Base) {
         // ========================================================================
         // Tool Approvals
         // ========================================================================
-        /**
-         * List tool approval requests, optionally filtered.
-         * @param filters - Optional filters (status, agentId)
-         * @returns Array of tool approval records
-         */
-        async getToolApprovals(filters) {
-            const token = this.getToken();
-            const baseUrl = this.getIamRunUrl();
-            return toolApprovals.getToolApprovals(token, filters, baseUrl);
-        }
-        /**
-         * Approve a tool execution request.
-         * @param approvalId - ID of the approval to approve
-         */
-        async approveToolRequest(approvalId) {
-            const token = this.getToken();
-            const baseUrl = this.getIamRunUrl();
-            return toolApprovals.approveToolRequest(token, approvalId, baseUrl);
-        }
-        /**
-         * Reject a tool execution request.
-         * @param approvalId - ID of the approval to reject
-         * @param reason - Optional rejection reason
-         */
-        async rejectToolRequest(approvalId, reason) {
-            const token = this.getToken();
-            const baseUrl = this.getIamRunUrl();
-            return toolApprovals.rejectToolRequest(token, approvalId, reason, baseUrl);
-        }
+        //
+        // Tool approval interactions have been removed from the REST mixin.
+        // All approval flows (list / approve / reject / realtime updates) now
+        // travel exclusively over the AI Agents websocket stream. Use the
+        // `useToolApprovals` React hook (or send `tool_approval_decision`
+        // messages directly on the stream) instead.
         // ========================================================================
         // Notifications
         // ========================================================================
@@ -275,5 +253,112 @@ export function AgentsMixin(Base) {
             const baseUrl = this.getIamRunUrl();
             return context.getCostUsage(token, agentId, baseUrl);
         }
+        // ========================================================================
+        // Agent Specs
+        // ========================================================================
+        /**
+         * Get an agent specification by ID.
+         * @param agentSpecId - Agent spec identifier.
+         * @returns The agent spec, or undefined if not found.
+         */
+        getAgentSpec(agentSpecId) {
+            return agentSpecs.getAgentSpecs(agentSpecId);
+        }
+        /**
+         * List all available agent specifications.
+         * @param prefix - If provided, only return specs whose ID starts with this prefix.
+         * @returns Array of agent specifications.
+         */
+        listAgentSpecs(prefix) {
+            return agentSpecs.listAgentSpecs(prefix);
+        }
+        /**
+         * Get required environment variables for an agent spec.
+         * @param spec - The agent specification.
+         * @returns Deduplicated array of required environment variable names.
+         */
+        getAgentSpecRequiredEnvVars(spec) {
+            return agentSpecs.getAgentSpecRequiredEnvVars(spec);
+        }
+        // ========================================================================
+        // Project Agent Assignment
+        // ========================================================================
+        /**
+         * Assign an agent runtime to a project.
+         * @param projectUid - Project UID.
+         * @param agentPodName - Agent runtime pod name.
+         * @param agentSpecId - Agent spec ID.
+         * @param agentGivenName - Human-readable runtime name.
+         * @returns Updated project.
+         */
+        async assignAgentToProject(projectUid, agentPodName, agentSpecId, agentGivenName) {
+            // Backend requires name and description on every update
+            const project = await this.getProject(projectUid);
+            return this.updateProject(projectUid, {
+                name: project.name,
+                description: project.description,
+                attached_agent_pod_name_s: agentPodName,
+                attached_agent_spec_id_s: agentSpecId || '',
+                attached_agent_given_name_s: agentGivenName || '',
+            });
+        }
+        /**
+         * Remove the agent assignment from a project.
+         * @param projectUid - Project UID.
+         * @returns Updated project.
+         */
+        async unassignAgentFromProject(projectUid) {
+            // Backend requires name and description on every update
+            const project = await this.getProject(projectUid);
+            return this.updateProject(projectUid, {
+                name: project.name,
+                description: project.description,
+                attached_agent_pod_name_s: '',
+                attached_agent_spec_id_s: '',
+                attached_agent_given_name_s: '',
+            });
+        }
+        // ========================================================================
+        // Agent Runtime Lifecycle
+        // ========================================================================
+        /**
+         * Create an agent runtime.
+         * @param data - Runtime creation parameters.
+         * @returns The created runtime response.
+         */
+        async createAgentRuntime(data) {
+            const token = this.getToken();
+            const runtimesRunUrl = this.getRuntimesRunUrl();
+            return requestDatalayerAPI({
+                url: `${runtimesRunUrl}/api/runtimes/v1/runtimes`,
+                method: 'POST',
+                token,
+                body: {
+                    environment_name: data.environmentName || 'ai-agents-env',
+                    given_name: data.givenName || 'Agent',
+                    credits_limit: data.creditsLimit || 10,
+                    type: data.type || 'notebook',
+                    editor_variant: data.editorVariant || 'none',
+                    enable_codemode: data.enableCodemode ?? false,
+                    agent_spec_id: data.agentSpecId || undefined,
+                    agent_spec: data.agentSpec || undefined,
+                },
+            });
+        }
+        /**
+         * Create an agent runtime and assign it to a project.
+         * @param projectUid - The project UID to assign the agent to.
+         * @param data - Runtime creation parameters.
+         * @returns The created runtime response.
+         */
+        async createAgentRuntimeForProject(projectUid, data) {
+            const response = await this.createAgentRuntime(data);
+            if (response.success && response.runtime) {
+                const podName = response.runtime.pod_name;
+                const givenName = response.runtime.given_name || data.givenName || data.agentSpecId;
+                await this.assignAgentToProject(projectUid, podName, data.agentSpecId, givenName);
+            }
+            return response;
+        }
     };
 }

package/lib/client/IAgentRuntimesClient.d.ts

@@ -0,0 +1,215 @@
+/**
+ * Domain-level interface abstracting every operation the chat component and
+ * hooks need against the Datalayer agent runtime platform.
+ *
+ * Two concrete implementations are expected:
+ *
+ * 1. `SdkAgentRuntimesClient` — the default browser / Node implementation
+ *    that delegates to a `DatalayerClient` composed with `AgentsMixin`.
+ *    Makes real HTTP calls against the configured service URLs.
+ *
+ * 2. A bridge implementation hosted inside the VSCode webview sandbox (lives
+ *    in the `vscode-datalayer` extension, not in this package). It implements
+ *    the same interface but tunnels every call to the extension host via
+ *    `postMessage` correlation IDs. The extension host answers the calls
+ *    using its own `SdkAgentRuntimesClient` so the webview never touches the
+ *    network or the auth token directly.
+ *
+ * The interface is deliberately transport-agnostic: consumers depend on
+ * semantic method names (`listRunningAgents`, `getAgentStatus`) rather
+ * than on URLs, fetch options, or WebSocket frames.
+ *
+ * @module client/IAgentRuntimesClient
+ */
+import type { AgentEvent, AgentNotification, AgentUsageSummary, ContextUsage, ConversationCheckpoint, CostUsage, CreateAgentEventRequest, EvalReport, GetAgentEventResponse, ListAgentEventsParams, ListAgentEventsResponse, NotificationFilters, OutputArtifact, RunEvalsRequest, RunningAgent, UpdateAgentEventRequest } from '../types';
+import type { CreateAgentRuntimeRequest, CreateRuntimeApiResponse } from '../types/agents-lifecycle';
+/**
+ * Unified client contract for the Datalayer agent-runtimes control plane.
+ *
+ * Every method corresponds one-to-one with an operation on
+ * `AgentsMixin`. Phase 1 of the interface covers the non-streaming
+ * surface. Streaming chat (`streamChat`), chat config, history, and related
+ * transport-specific operations will be added in a follow-up once
+ * `AgentsMixin` grows typed wrappers for them.
+ */
+export interface IAgentRuntimesClient {
+    /**
+     * Lists every running agent across all runtimes the caller can see.
+     *
+     * @returns Array of running agent summaries.
+     */
+    listRunningAgents(): Promise<RunningAgent[]>;
+    /**
+     * Retrieves the detailed status of a specific running agent.
+     *
+     * @param podName - Pod name hosting the agent.
+     * @param agentId - Optional agent ID within the pod (for multi-agent pods).
+     *
+     * @returns The agent's current status record.
+     */
+    getAgentStatus(podName: string, agentId?: string): Promise<RunningAgent>;
+    /**
+     * Pauses a running agent (light checkpoint by default).
+     *
+     * @param podName - Pod name hosting the agent.
+     */
+    pauseAgent(podName: string): Promise<void>;
+    /**
+     * Resumes a previously paused / checkpointed agent.
+     *
+     * @param podName - Pod name hosting the agent.
+     */
+    resumeAgent(podName: string): Promise<void>;
+    /**
+     * Lists conversation checkpoints for an agent.
+     *
+     * @param podName - Pod name hosting the agent.
+     * @param agentId - Optional agent ID within the pod.
+     *
+     * @returns Array of conversation checkpoints.
+     */
+    getAgentCheckpoints(podName: string, agentId?: string): Promise<ConversationCheckpoint[]>;
+    /**
+     * Retrieves the token and cost usage summary for an agent.
+     *
+     * @param podName - Pod name hosting the agent.
+     * @param agentId - Optional agent ID within the pod.
+     *
+     * @returns Aggregated usage totals.
+     */
+    getAgentUsage(podName: string, agentId?: string): Promise<AgentUsageSummary>;
+    /**
+     * Lists agent notifications, optionally filtered by level or read status.
+     *
+     * @param filters - Optional filter predicates.
+     *
+     * @returns Array of notifications matching the filters.
+     */
+    listNotifications(filters?: NotificationFilters): Promise<AgentNotification[]>;
+    /**
+     * Marks a single notification as read.
+     *
+     * @param notificationId - ID of the notification.
+     */
+    markNotificationRead(notificationId: string): Promise<void>;
+    /**
+     * Marks every notification for the caller as read.
+     */
+    markAllNotificationsRead(): Promise<void>;
+    /**
+     * Creates a new event for an agent.
+     *
+     * @param data - Event payload.
+     *
+     * @returns The created event wrapped in a success envelope.
+     */
+    createEvent(data: CreateAgentEventRequest): Promise<{
+        success: boolean;
+        event: AgentEvent;
+    }>;
+    /**
+     * Lists events for an agent with optional filters.
+     *
+     * @param agentId - Agent identifier whose events are being listed.
+     * @param params - Optional list filters (pagination, type, status).
+     *
+     * @returns Paginated events response.
+     */
+    listEvents(agentId: string, params?: Omit<ListAgentEventsParams, 'agent_id'>): Promise<ListAgentEventsResponse>;
+    /**
+     * Retrieves a single event by identifier.
+     *
+     * @param agentId - Agent that owns the event.
+     * @param eventId - Event identifier.
+     *
+     * @returns The requested event.
+     */
+    getEvent(agentId: string, eventId: string): Promise<GetAgentEventResponse>;
+    /**
+     * Patches an existing event.
+     *
+     * @param agentId - Agent that owns the event.
+     * @param eventId - Event identifier.
+     * @param data - Partial event fields to update.
+     *
+     * @returns The updated event.
+     */
+    updateEvent(agentId: string, eventId: string, data: UpdateAgentEventRequest): Promise<GetAgentEventResponse>;
+    /**
+     * Lists every output artifact an agent has generated.
+     *
+     * @param agentId - Agent identifier.
+     *
+     * @returns Array of output artifacts.
+     */
+    getAgentOutputs(agentId: string): Promise<OutputArtifact[]>;
+    /**
+     * Retrieves a single output artifact by identifier.
+     *
+     * @param agentId - Agent identifier.
+     * @param outputId - Output artifact identifier.
+     *
+     * @returns The requested output artifact.
+     */
+    getAgentOutput(agentId: string, outputId: string): Promise<OutputArtifact>;
+    /**
+     * Generates a new output artifact for an agent.
+     *
+     * @param agentId - Agent identifier.
+     * @param format - Requested output format (e.g. `"pdf"`).
+     * @param options - Optional format-specific generation options.
+     *
+     * @returns The newly generated output artifact.
+     */
+    generateAgentOutput(agentId: string, format: string, options?: Record<string, unknown>): Promise<OutputArtifact>;
+    /**
+     * Runs an evaluation batch against an agent.
+     *
+     * @param agentId - Agent identifier.
+     * @param request - Eval configuration payload.
+     *
+     * @returns Eval report capturing results and metrics.
+     */
+    runEvals(agentId: string, request: RunEvalsRequest): Promise<EvalReport>;
+    /**
+     * Lists past eval reports for an agent.
+     *
+     * @param agentId - Agent identifier.
+     *
+     * @returns Array of eval reports in reverse-chronological order.
+     */
+    listEvals(agentId: string): Promise<EvalReport[]>;
+    /**
+     * Retrieves a single eval report by identifier.
+     *
+     * @param agentId - Agent identifier.
+     * @param evalId - Eval report identifier.
+     *
+     * @returns The requested eval report.
+     */
+    getEval(agentId: string, evalId: string): Promise<EvalReport>;
+    /**
+     * Retrieves the current context window usage for an agent.
+     *
+     * @param agentId - Agent identifier.
+     *
+     * @returns Context usage details.
+     */
+    getContextUsage(agentId: string): Promise<ContextUsage>;
+    /**
+     * Retrieves the per-model cost usage for an agent.
+     *
+     * @param agentId - Agent identifier.
+     *
+     * @returns Cost usage aggregates.
+     */
+    getCostUsage(agentId: string): Promise<CostUsage>;
+    /**
+     * Creates a new agent runtime.
+     *
+     * @param data - Runtime creation parameters.
+     *
+     * @returns The creation response with the provisioned runtime descriptor.
+     */
+    createAgentRuntime(data: CreateAgentRuntimeRequest): Promise<CreateRuntimeApiResponse>;
+}

package/lib/client/IAgentRuntimesClient.js

@@ -0,0 +1,5 @@
+/*
+ * Copyright (c) 2025-2026 Datalayer, Inc.
+ * Distributed under the terms of the Modified BSD License.
+ */
+export {};

package/lib/client/SdkAgentRuntimesClient.d.ts

@@ -0,0 +1,151 @@
+/**
+ * Default implementation of {@link IAgentRuntimesClient} that delegates to a
+ * `DatalayerClient` composed with `AgentsMixin`.
+ *
+ * This is the implementation used by browser, Node, JupyterLab, and standalone
+ * examples of the chat component. The VSCode extension provides its own
+ * implementation (`BridgeAgentRuntimesClient`) that tunnels calls through a
+ * message-passing bridge to an extension-host instance of this same class.
+ *
+ * @module client/SdkAgentRuntimesClient
+ */
+import type { AgentEvent, AgentNotification, AgentUsageSummary, ContextUsage, ConversationCheckpoint, CostUsage, CreateAgentEventRequest, EvalReport, GetAgentEventResponse, ListAgentEventsParams, ListAgentEventsResponse, NotificationFilters, OutputArtifact, RunEvalsRequest, RunningAgent, UpdateAgentEventRequest } from '../types';
+import type { CreateAgentRuntimeRequest, CreateRuntimeApiResponse } from '../types/agents-lifecycle';
+import type { IAgentRuntimesClient } from './IAgentRuntimesClient';
+/**
+ * Structural type describing the subset of methods {@link SdkAgentRuntimesClient}
+ * needs on the underlying SDK instance. Any `DatalayerClient` composed with
+ * `AgentsMixin` satisfies this shape; accepting it structurally avoids a
+ * hard type dependency on `@datalayer/core` inside this file, which keeps the
+ * default implementation drop-in replaceable in alternative deployments.
+ */
+export interface AgentsSdkLike {
+    /** Lists every running agent across runtimes the caller can see. */
+    getRunningAgents(): Promise<RunningAgent[]>;
+    /** Retrieves the detailed status of a specific running agent. */
+    getAgentStatus(podName: string, agentId?: string): Promise<RunningAgent>;
+    /** Pauses a running agent. */
+    pauseAgent(podName: string): Promise<void>;
+    /** Resumes a previously paused agent. */
+    resumeAgent(podName: string): Promise<void>;
+    /** Lists conversation checkpoints for an agent. */
+    getAgentCheckpoints(podName: string, agentId?: string): Promise<ConversationCheckpoint[]>;
+    /** Retrieves the token and cost usage summary for an agent. */
+    getAgentUsage(podName: string, agentId?: string): Promise<AgentUsageSummary>;
+    /** Lists agent notifications with optional filters. */
+    getNotifications(filters?: NotificationFilters): Promise<AgentNotification[]>;
+    /** Marks a single notification as read. */
+    markNotificationRead(notificationId: string): Promise<void>;
+    /** Marks every notification for the caller as read. */
+    markAllNotificationsRead(): Promise<void>;
+    /** Creates a new event for an agent. */
+    createEvent(data: CreateAgentEventRequest): Promise<{
+        success: boolean;
+        event: AgentEvent;
+    }>;
+    /** Lists events for an agent. */
+    listEvents(agentId: string, params?: Omit<ListAgentEventsParams, 'agent_id'>): Promise<ListAgentEventsResponse>;
+    /** Retrieves a single event. */
+    getEvent(agentId: string, eventId: string): Promise<GetAgentEventResponse>;
+    /** Updates an event. */
+    updateEvent(agentId: string, eventId: string, data: UpdateAgentEventRequest): Promise<GetAgentEventResponse>;
+    /** Lists output artifacts for an agent. */
+    getAgentOutputs(agentId: string): Promise<OutputArtifact[]>;
+    /** Retrieves a single output artifact. */
+    getAgentOutput(agentId: string, outputId: string): Promise<OutputArtifact>;
+    /** Generates a new output artifact. */
+    generateAgentOutput(agentId: string, format: string, options?: Record<string, unknown>): Promise<OutputArtifact>;
+    /** Runs an evaluation batch. */
+    runEvals(agentId: string, request: RunEvalsRequest): Promise<EvalReport>;
+    /** Lists eval reports for an agent. */
+    listEvals(agentId: string): Promise<EvalReport[]>;
+    /** Retrieves a single eval report. */
+    getEval(agentId: string, evalId: string): Promise<EvalReport>;
+    /** Retrieves context window usage. */
+    getContextUsage(agentId: string): Promise<ContextUsage>;
+    /** Retrieves cost usage. */
+    getCostUsage(agentId: string): Promise<CostUsage>;
+    /** Creates a new agent runtime. */
+    createAgentRuntime(data: CreateAgentRuntimeRequest): Promise<CreateRuntimeApiResponse>;
+}
+/**
+ * {@link IAgentRuntimesClient} implementation that forwards every call to a
+ * pre-composed `DatalayerClient + AgentsMixin` instance.
+ *
+ * Construct with:
+ *
+ * ```ts
+ * import { DatalayerClient } from '@datalayer/core/lib/client';
+ * import { AgentsMixin, SdkAgentRuntimesClient } from '@datalayer/agent-runtimes';
+ *
+ * const ClientWithAgents = AgentsMixin(DatalayerClient);
+ * const sdk = new ClientWithAgents({ iamRunUrl, runtimesRunUrl, spacerRunUrl });
+ * const client = new SdkAgentRuntimesClient(sdk);
+ * ```
+ */
+export declare class SdkAgentRuntimesClient implements IAgentRuntimesClient {
+    private readonly sdk;
+    /**
+     * Constructs the default client.
+     *
+     * @param sdk - A composed `DatalayerClient + AgentsMixin` instance whose
+     *   `getToken()` / service URL resolvers already return valid values.
+     *   When `null`, every method throws — pass a real SDK to use the client.
+     */
+    constructor(sdk: AgentsSdkLike | null);
+    /**
+     * Asserts the SDK is available for control-plane operations.
+     *
+     * @throws When the client was constructed without an SDK.
+     *
+     * @returns The SDK instance.
+     */
+    private requireSdk;
+    /** @inheritdoc */
+    listRunningAgents(): Promise<RunningAgent[]>;
+    /** @inheritdoc */
+    getAgentStatus(podName: string, agentId?: string): Promise<RunningAgent>;
+    /** @inheritdoc */
+    pauseAgent(podName: string): Promise<void>;
+    /** @inheritdoc */
+    resumeAgent(podName: string): Promise<void>;
+    /** @inheritdoc */
+    getAgentCheckpoints(podName: string, agentId?: string): Promise<ConversationCheckpoint[]>;
+    /** @inheritdoc */
+    getAgentUsage(podName: string, agentId?: string): Promise<AgentUsageSummary>;
+    /** @inheritdoc */
+    listNotifications(filters?: NotificationFilters): Promise<AgentNotification[]>;
+    /** @inheritdoc */
+    markNotificationRead(notificationId: string): Promise<void>;
+    /** @inheritdoc */
+    markAllNotificationsRead(): Promise<void>;
+    /** @inheritdoc */
+    createEvent(data: CreateAgentEventRequest): Promise<{
+        success: boolean;
+        event: AgentEvent;
+    }>;
+    /** @inheritdoc */
+    listEvents(agentId: string, params?: Omit<ListAgentEventsParams, 'agent_id'>): Promise<ListAgentEventsResponse>;
+    /** @inheritdoc */
+    getEvent(agentId: string, eventId: string): Promise<GetAgentEventResponse>;
+    /** @inheritdoc */
+    updateEvent(agentId: string, eventId: string, data: UpdateAgentEventRequest): Promise<GetAgentEventResponse>;
+    /** @inheritdoc */
+    getAgentOutputs(agentId: string): Promise<OutputArtifact[]>;
+    /** @inheritdoc */
+    getAgentOutput(agentId: string, outputId: string): Promise<OutputArtifact>;
+    /** @inheritdoc */
+    generateAgentOutput(agentId: string, format: string, options?: Record<string, unknown>): Promise<OutputArtifact>;
+    /** @inheritdoc */
+    runEvals(agentId: string, request: RunEvalsRequest): Promise<EvalReport>;
+    /** @inheritdoc */
+    listEvals(agentId: string): Promise<EvalReport[]>;
+    /** @inheritdoc */
+    getEval(agentId: string, evalId: string): Promise<EvalReport>;
+    /** @inheritdoc */
+    getContextUsage(agentId: string): Promise<ContextUsage>;
+    /** @inheritdoc */
+    getCostUsage(agentId: string): Promise<CostUsage>;
+    /** @inheritdoc */
+    createAgentRuntime(data: CreateAgentRuntimeRequest): Promise<CreateRuntimeApiResponse>;
+}