@datalayer/agent-runtimes 1.0.28 → 1.3.10

package/lib/hooks/useProjects.d.ts

@@ -19,7 +19,7 @@ export type ProjectData = {
     /** Whether the project is public */
     isPublic: boolean;
     /** Attached agent (runtime) pod name, if any */
-    attachedAgentPodName?: string;
+    attachedAgentRuntimeName?: string;
     /** Attached agentspec ID (e.g. 'data-acquisition'), if any */
     attachedAgentSpecId?: string;
 };
@@ -64,7 +64,6 @@ export declare function useProjects(): {
     isEnabled: boolean;
     refetch: (options?: import("@tanstack/query-core").RefetchOptions) => Promise<import("@tanstack/query-core").QueryObserverResult<any, Error>>;
     fetchStatus: import("@tanstack/query-core").FetchStatus;
-    promise: Promise<any>;
     data: ProjectData[];
 } | {
     error: null;
@@ -91,7 +90,6 @@ export declare function useProjects(): {
     isEnabled: boolean;
     refetch: (options?: import("@tanstack/query-core").RefetchOptions) => Promise<import("@tanstack/query-core").QueryObserverResult<any, Error>>;
     fetchStatus: import("@tanstack/query-core").FetchStatus;
-    promise: Promise<any>;
     data: ProjectData[];
 } | {
     error: Error;
@@ -118,7 +116,6 @@ export declare function useProjects(): {
     isEnabled: boolean;
     refetch: (options?: import("@tanstack/query-core").RefetchOptions) => Promise<import("@tanstack/query-core").QueryObserverResult<any, Error>>;
     fetchStatus: import("@tanstack/query-core").FetchStatus;
-    promise: Promise<any>;
     data: ProjectData[];
 } | {
     error: null;
@@ -145,7 +142,6 @@ export declare function useProjects(): {
     isEnabled: boolean;
     refetch: (options?: import("@tanstack/query-core").RefetchOptions) => Promise<import("@tanstack/query-core").QueryObserverResult<any, Error>>;
     fetchStatus: import("@tanstack/query-core").FetchStatus;
-    promise: Promise<any>;
     data: ProjectData[];
 } | {
     error: null;
@@ -172,7 +168,6 @@ export declare function useProjects(): {
     isEnabled: boolean;
     refetch: (options?: import("@tanstack/query-core").RefetchOptions) => Promise<import("@tanstack/query-core").QueryObserverResult<any, Error>>;
     fetchStatus: import("@tanstack/query-core").FetchStatus;
-    promise: Promise<any>;
     data: ProjectData[];
 } | {
     isError: false;
@@ -199,7 +194,6 @@ export declare function useProjects(): {
     isEnabled: boolean;
     refetch: (options?: import("@tanstack/query-core").RefetchOptions) => Promise<import("@tanstack/query-core").QueryObserverResult<any, Error>>;
     fetchStatus: import("@tanstack/query-core").FetchStatus;
-    promise: Promise<any>;
     data: ProjectData[];
 };
 /**
@@ -230,7 +224,6 @@ export declare function useProject(uid: string | undefined): {
     isEnabled: boolean;
     refetch: (options?: import("@tanstack/query-core").RefetchOptions) => Promise<import("@tanstack/query-core").QueryObserverResult<any, Error>>;
     fetchStatus: import("@tanstack/query-core").FetchStatus;
-    promise: Promise<any>;
     data: ProjectData | undefined;
 } | {
     error: null;
@@ -257,7 +250,6 @@ export declare function useProject(uid: string | undefined): {
     isEnabled: boolean;
     refetch: (options?: import("@tanstack/query-core").RefetchOptions) => Promise<import("@tanstack/query-core").QueryObserverResult<any, Error>>;
     fetchStatus: import("@tanstack/query-core").FetchStatus;
-    promise: Promise<any>;
     data: ProjectData | undefined;
 } | {
     error: Error;
@@ -284,7 +276,6 @@ export declare function useProject(uid: string | undefined): {
     isEnabled: boolean;
     refetch: (options?: import("@tanstack/query-core").RefetchOptions) => Promise<import("@tanstack/query-core").QueryObserverResult<any, Error>>;
     fetchStatus: import("@tanstack/query-core").FetchStatus;
-    promise: Promise<any>;
     data: ProjectData | undefined;
 } | {
     error: null;
@@ -311,7 +302,6 @@ export declare function useProject(uid: string | undefined): {
     isEnabled: boolean;
     refetch: (options?: import("@tanstack/query-core").RefetchOptions) => Promise<import("@tanstack/query-core").QueryObserverResult<any, Error>>;
     fetchStatus: import("@tanstack/query-core").FetchStatus;
-    promise: Promise<any>;
     data: ProjectData | undefined;
 } | {
     error: null;
@@ -338,7 +328,6 @@ export declare function useProject(uid: string | undefined): {
     isEnabled: boolean;
     refetch: (options?: import("@tanstack/query-core").RefetchOptions) => Promise<import("@tanstack/query-core").QueryObserverResult<any, Error>>;
     fetchStatus: import("@tanstack/query-core").FetchStatus;
-    promise: Promise<any>;
     data: ProjectData | undefined;
 } | {
     isError: false;
@@ -365,7 +354,6 @@ export declare function useProject(uid: string | undefined): {
     isEnabled: boolean;
     refetch: (options?: import("@tanstack/query-core").RefetchOptions) => Promise<import("@tanstack/query-core").QueryObserverResult<any, Error>>;
     fetchStatus: import("@tanstack/query-core").FetchStatus;
-    promise: Promise<any>;
     data: ProjectData | undefined;
 };
 /**
@@ -527,7 +515,7 @@ export declare function useCreateProject(): {
  * Uses the spacer PUT endpoint via useUpdateSpace.
  */
 export declare function useUpdateProject(): {
-    assignAgent: (project: ProjectData, agentPodName: string, agentSpecId?: string) => Promise<any>;
+    assignAgent: (project: ProjectData, agentRuntimeName: string, agentSpecId?: string) => Promise<any>;
     unassignAgent: (project: ProjectData) => Promise<any>;
     renameProject: (project: ProjectData, newName: string) => Promise<any>;
     data: undefined;
@@ -547,7 +535,7 @@ export declare function useUpdateProject(): {
     submittedAt: number;
     mutateAsync: import("@tanstack/react-query").UseMutateAsyncFunction<any, Error, Partial<any> & Record<string, unknown>, unknown>;
 } | {
-    assignAgent: (project: ProjectData, agentPodName: string, agentSpecId?: string) => Promise<any>;
+    assignAgent: (project: ProjectData, agentRuntimeName: string, agentSpecId?: string) => Promise<any>;
     unassignAgent: (project: ProjectData) => Promise<any>;
     renameProject: (project: ProjectData, newName: string) => Promise<any>;
     data: undefined;
@@ -567,7 +555,7 @@ export declare function useUpdateProject(): {
     submittedAt: number;
     mutateAsync: import("@tanstack/react-query").UseMutateAsyncFunction<any, Error, Partial<any> & Record<string, unknown>, unknown>;
 } | {
-    assignAgent: (project: ProjectData, agentPodName: string, agentSpecId?: string) => Promise<any>;
+    assignAgent: (project: ProjectData, agentRuntimeName: string, agentSpecId?: string) => Promise<any>;
     unassignAgent: (project: ProjectData) => Promise<any>;
     renameProject: (project: ProjectData, newName: string) => Promise<any>;
     data: undefined;
@@ -587,7 +575,7 @@ export declare function useUpdateProject(): {
     submittedAt: number;
     mutateAsync: import("@tanstack/react-query").UseMutateAsyncFunction<any, Error, Partial<any> & Record<string, unknown>, unknown>;
 } | {
-    assignAgent: (project: ProjectData, agentPodName: string, agentSpecId?: string) => Promise<any>;
+    assignAgent: (project: ProjectData, agentRuntimeName: string, agentSpecId?: string) => Promise<any>;
     unassignAgent: (project: ProjectData) => Promise<any>;
     renameProject: (project: ProjectData, newName: string) => Promise<any>;
     data: any;
@@ -622,7 +610,7 @@ export type { ProjectDefaultItems } from '../models/ProjectDTO';
  * This calls the spacer `GET /spaces/:uid/default-items` endpoint which
  * returns the UID of the first notebook and first document in the space.
  */
-export declare function useProjectDefaultItems(projectUid: string | undefined): import("@tanstack/react-query").UseQueryResult<NoInfer<{
+export declare function useProjectDefaultItems(projectUid: string | undefined): import("@tanstack/react-query").UseQueryResult<{
     defaultNotebookUid: string | null;
     defaultDocumentUid: string | null;
-}>, Error>;
+}, Error>;

package/lib/hooks/useProjects.js

@@ -63,7 +63,7 @@ export function useProjects() {
             description: space.description ?? space.description_t ?? '',
             createdAt: space.created_at ? new Date(space.created_at) : new Date(),
             isPublic: space.public ?? space.public_b ?? false,
-            attachedAgentPodName: space.attached_agent_pod_name_s || undefined,
+            attachedAgentRuntimeName: space.attached_agent_runtime_name_s || undefined,
             attachedAgentSpecId: space.attached_agent_spec_id_s || undefined,
         }));
     }, [allSpaces]);
@@ -89,7 +89,7 @@ export function useProject(uid) {
             description: s.description ?? s.description_t ?? '',
             createdAt: s.created_at ? new Date(s.created_at) : new Date(),
             isPublic: s.public ?? s.public_b ?? false,
-            attachedAgentPodName: s.attached_agent_pod_name_s || undefined,
+            attachedAgentRuntimeName: s.attached_agent_runtime_name_s || undefined,
             attachedAgentSpecId: s.attached_agent_spec_id_s || undefined,
         };
     }, [space]);
@@ -130,12 +130,12 @@ export function useUpdateProject() {
     const { useUpdateSpace } = useCache();
     const updateSpaceMutation = useUpdateSpace();
     /** Assign an agent runtime to the project */
-    const assignAgent = useCallback(async (project, agentPodName, agentSpecId) => {
+    const assignAgent = useCallback(async (project, agentRuntimeName, agentSpecId) => {
         return updateSpaceMutation.mutateAsync({
             id: project.id,
             name: project.name,
             description: project.description,
-            attached_agent_pod_name_s: agentPodName,
+            attached_agent_runtime_name_s: agentRuntimeName,
             attached_agent_spec_id_s: agentSpecId || '',
         });
     }, [updateSpaceMutation]);
@@ -153,7 +153,7 @@ export function useUpdateProject() {
             id: project.id,
             name: project.name,
             description: project.description,
-            attached_agent_pod_name_s: '',
+            attached_agent_runtime_name_s: '',
             attached_agent_spec_id_s: '',
         });
     }, [updateSpaceMutation]);

package/lib/hooks/useSkills.d.ts

@@ -28,4 +28,3 @@ export declare function useSkillActions(agentId?: string): {
     approveSkill: (skillId: string) => boolean;
     unapproveSkill: (skillId: string) => boolean;
 };
-export { useAgentRuntimeLoadedSkills } from '../stores';

package/lib/hooks/useSkills.js

@@ -96,6 +96,10 @@ export function useSkillActions(agentId) {
     return { enableSkill, disableSkill, approveSkill, unapproveSkill };
 }
 // ---------------------------------------------------------------------------
-// Loaded skills (kept for backward compat with AgentSkillsExample sidebar)
+// Loaded skills
 // ---------------------------------------------------------------------------
-export { useAgentRuntimeLoadedSkills } from '../stores';
+//
+// Not re-exported here any more. It is a store selector, not a hook this
+// module defines, and forwarding it made `hooks/index.ts` the third link in a
+// re-export chain that webpack could not follow. Import it from `../stores`,
+// or as `useAgentLoadedSkills` from `../hooks`.

package/lib/hooks/useToolApprovals.d.ts

@@ -8,8 +8,8 @@ export type ApprovalRecord = {
     id: string;
     agent_id: string;
     agentId: string;
-    pod_name: string;
-    podName: string;
+    runtime_name: string;
+    runtimeName: string;
     tool_name: string;
     toolName: string;
     tool_call_id?: string;
@@ -52,10 +52,10 @@ interface DecisionMutationResult extends MutationResult {
     /** Live socket state so callers can tailor offline messaging. */
     connectionState: WSConnectionState;
 }
-export declare function useToolApprovalsQuery(filters?: ToolApprovalFilters): import("@tanstack/react-query").UseQueryResult<NoInfer<ApprovalsQueryData>, Error>;
-export declare function usePendingApprovalCount(): import("@tanstack/react-query").UseQueryResult<NoInfer<{
+export declare function useToolApprovalsQuery(filters?: ToolApprovalFilters): import("@tanstack/react-query").UseQueryResult<ApprovalsQueryData, Error>;
+export declare function usePendingApprovalCount(): import("@tanstack/react-query").UseQueryResult<{
     count: number;
-}>, Error>;
+}, Error>;
 export declare function useApproveToolRequest(): DecisionMutationResult;
 export declare function useRejectToolRequest(): DecisionMutationResult;
 export declare function useMarkToolApprovalRead(): MutationResult;
@@ -69,10 +69,10 @@ export declare function useMarkToolApprovalUnread(): MutationResult;
  */
 export declare function useDeleteToolApproval(): MutationResult;
 export declare function useToolApprovals(filters?: ToolApprovalFilters): {
-    approvalsQuery: import("@tanstack/react-query").UseQueryResult<NoInfer<ApprovalsQueryData>, Error>;
-    pendingCountQuery: import("@tanstack/react-query").UseQueryResult<NoInfer<{
+    approvalsQuery: import("@tanstack/react-query").UseQueryResult<ApprovalsQueryData, Error>;
+    pendingCountQuery: import("@tanstack/react-query").UseQueryResult<{
         count: number;
-    }>, Error>;
+    }, Error>;
     approve: DecisionMutationResult;
     reject: DecisionMutationResult;
     markRead: MutationResult;

package/lib/hooks/useToolApprovals.js

@@ -35,7 +35,7 @@ function normalizeApproval(raw) {
     if (!id)
         return null;
     const agent = str(rec.agent_id ?? rec.agentId);
-    const pod = str(rec.pod_name ?? rec.podName);
+    const pod = str(rec.runtime_name ?? rec.runtimeName);
     const tool = str(rec.tool_name ?? rec.toolName ?? 'unknown');
     const toolCall = rec.tool_call_id ?? rec.toolCallId;
     const args = rec.tool_args ??
@@ -58,8 +58,8 @@ function normalizeApproval(raw) {
         id,
         agent_id: agent,
         agentId: agent,
-        pod_name: pod,
-        podName: pod,
+        runtime_name: pod,
+        runtimeName: pod,
         tool_name: tool,
         toolName: tool,
         tool_call_id: typeof toolCall === 'string' ? toolCall : undefined,

package/lib/identity/AgentIdentity.d.ts

@@ -1,3 +1,10 @@
+/**
+ * AgentIdentity component - Shows connected identity providers with token status.
+ * Displays expiration details and allows reconnection if token expired.
+ *
+ * @module components/identity/AgentIdentity
+ */
+import React from 'react';
 import type { OAuthProvider, OAuthProviderConfig, Identity } from './types';
 /**
  * Token status information
@@ -47,7 +54,7 @@ export interface IdentityCardProps {
 /**
  * Single identity card with status and actions
  */
-export declare function IdentityCard({ identity, providerConfig, showExpirationDetails, allowReconnect, onConnect: _onConnect, onDisconnect, onError, }: IdentityCardProps): import("react/jsx-runtime").JSX.Element;
+export declare function IdentityCard({ identity, providerConfig, showExpirationDetails, allowReconnect, onConnect: _onConnect, onDisconnect, onError, }: IdentityCardProps): React.JSX.Element;
 /**
  * Props for AgentIdentity component
  */
@@ -88,5 +95,5 @@ export interface AgentIdentityProps {
  * - Allows reconnection if token expired
  * - Reusable across AgentDetails, AgentConfiguration, etc.
  */
-export declare function AgentIdentity({ providers, title, showHeader, showDescription, description, showExpirationDetails, allowReconnect, onConnect, onDisconnect, onError, }: AgentIdentityProps): import("react/jsx-runtime").JSX.Element | null;
+export declare function AgentIdentity({ providers, title, showHeader, showDescription, description, showExpirationDetails, allowReconnect, onConnect, onDisconnect, onError, }: AgentIdentityProps): React.JSX.Element | null;
 export default AgentIdentity;

package/lib/identity/index.d.ts

@@ -37,7 +37,7 @@
  * ```
  */
 export type { OAuthProvider, OAuthToken, Identity, ProviderUserInfo, OAuthProviderConfig, AuthorizationRequest, AuthorizationCallback, IdentityState, IdentityActions, IdentityStore, AuthType, TokenProviderConfig, OAuthIdentityProviderConfig, TokenIdentityProviderConfig, IdentityProviderConfig, IdentityProvidersConfig, } from './types';
-export { GITHUB_PROVIDER, GOOGLE_PROVIDER, KAGGLE_PROVIDER, KAGGLE_TOKEN_PROVIDER, } from './types';
+export { GITHUB_PROVIDER, GOOGLE_PROVIDER, KAGGLE_PROVIDER, KAGGLE_API_TOKEN_PROVIDER, } from './types';
 export { generateCodeVerifier, generateCodeChallenge, generateState, generatePKCEPair, } from './pkce';
 export { discoverAuthorizationServer, supportsDCR, registerClient, updateClientRegistration, deleteClientRegistration, getOrCreateDynamicClient, loadDynamicClient, saveDynamicClient, removeDynamicClient, getAllDynamicClients, clearAllDynamicClients, dynamicClientToProviderConfig, type AuthorizationServerMetadata, type ClientRegistrationRequest, type ClientRegistrationResponse, type ClientRegistrationError, type DynamicClient, } from './dcr';
 export { useIdentityStore, useConnectedIdentities, useConnectedProviders, useIdentity as useIdentitySelector, useIsProviderConnected, usePendingAuthorization, useIdentityLoading, useIdentityError, configureBuiltinProviders, } from './identityStore';

package/lib/identity/index.js

@@ -2,7 +2,7 @@
  * Copyright (c) 2025-2026 Datalayer, Inc.
  * Distributed under the terms of the Modified BSD License.
  */
-export { GITHUB_PROVIDER, GOOGLE_PROVIDER, KAGGLE_PROVIDER, KAGGLE_TOKEN_PROVIDER, } from './types';
+export { GITHUB_PROVIDER, GOOGLE_PROVIDER, KAGGLE_PROVIDER, KAGGLE_API_TOKEN_PROVIDER, } from './types';
 // PKCE utilities
 export { generateCodeVerifier, generateCodeChallenge, generateState, generatePKCEPair, } from './pkce';
 // Dynamic Client Registration (DCR)

package/lib/identity/types.d.ts

@@ -237,7 +237,7 @@ export interface TokenProviderConfig {
  * Kaggle token-based provider configuration.
  * Generate token at: https://www.kaggle.com/settings/account (API section)
  */
-export declare const KAGGLE_TOKEN_PROVIDER: TokenProviderConfig;
+export declare const KAGGLE_API_TOKEN_PROVIDER: TokenProviderConfig;
 /**
  * OAuth provider configuration for identity providers.
  */

package/lib/identity/types.js

@@ -63,7 +63,7 @@ export const KAGGLE_PROVIDER = {
  * Kaggle token-based provider configuration.
  * Generate token at: https://www.kaggle.com/settings/account (API section)
  */
-export const KAGGLE_TOKEN_PROVIDER = {
+export const KAGGLE_API_TOKEN_PROVIDER = {
     provider: 'kaggle',
     displayName: 'Kaggle',
     iconUrl: 'https://www.kaggle.com/static/images/favicon.ico',

package/lib/index.d.ts

@@ -7,4 +7,5 @@ export * from './stores';
 export * from './identity';
 export * from './config';
 export * from './specs';
+export * from './loop';
 export type { AgentRuntimeData, Agentspec, BenchmarkSpec, ChatCommonProps, TeamSpec, GuardrailSpec, EvalSpec, TriggerSpec, OutputSpec, NotificationChannelSpec, MCPServer, SkillSpec, SkillInfo, SkillStatus, EnvvarSpec, ToolCallStartContext, ToolCallCompleteContext, } from './types';

package/lib/index.js

@@ -11,3 +11,7 @@ export * from './stores';
 export * from './identity';
 export * from './config';
 export * from './specs';
+// The LOOP workspace and its plugins, for hosts that embed it: the Datalayer
+// application at /loop, and later the JupyterLab panel. Exported through one
+// surface rather than by deep import (§3.5).
+export * from './loop';

package/lib/jupyter/index.d.ts

@@ -1,2 +1,3 @@
 export * from './exec';
-export * from './kernelsHandler';
+export * from './serverExecution';
+export * from './useResumeServerExecutions';

package/lib/jupyter/index.js

@@ -3,4 +3,5 @@
  * Distributed under the terms of the Modified BSD License.
  */
 export * from './exec';
-export * from './kernelsHandler';
+export * from './serverExecution';
+export * from './useResumeServerExecutions';

package/lib/jupyter/serverExecution.d.ts

@@ -0,0 +1,78 @@
+/**
+ * Cells that keep running when the page goes away, for the editors of Datalayer.
+ *
+ * A cell run over the kernel websocket belongs to the page that sent it: close
+ * or refresh that page mid-run and the kernel goes on, but every output from
+ * that moment on is written to nobody. `jupyter-server-nbmodel` answers this
+ * on the server — a cell posted to its REST endpoint runs there, its outputs
+ * are kept there, and any page may read them back — and ships a JupyterLab
+ * executor and restorer for it. Neither reaches the editors here:
+ *
+ * - the executor is built once, on the settings of THE Jupyter server of the
+ *   application. The SaaS has none (it is serverless); the kernel of a
+ *   notebook lives on a sandbox pod the browser talks to directly, and the
+ *   REST endpoint it must post to is the pod's;
+ * - the restorer walks the notebook tracker of JupyterLab, which never sees a
+ *   React notebook.
+ *
+ * So this module does both, per notebook, against the server the notebook's
+ * kernel actually runs on: {@link serverExecutorFor} finds out whether that
+ * server has the extension and hands back an executor bound to it, and
+ * {@link resumeServerExecutions} picks up, after a reload, whatever a
+ * previous page left running — from the request recorded in the cell's
+ * metadata when there is one, and from the server's own list of active
+ * requests when there is not (the metadata is written a moment after the
+ * request is accepted, and a refresh can land in between).
+ *
+ * Both editors that need it — the notebook of a space and the ephemeral
+ * notebook beside an agent — keep their cells across a refresh (the one in
+ * the collaboration room of the spacer, the other in the persisted model), so
+ * the cells are there to resume into.
+ *
+ * @module jupyter/serverExecution
+ */
+import type { ISessionContext } from '@jupyterlab/apputils';
+import type { INotebookCellExecutor } from '@jupyterlab/notebook';
+import { ServerConnection } from '@jupyterlab/services';
+/**
+ * Whether the server at these settings runs cells on the server.
+ *
+ * Asked once per server and remembered, including the answer "no": the
+ * question is asked on the way to running a cell, and a cell must not wait
+ * on a round trip every time. A server that could not be reached is not
+ * remembered, so a sandbox still starting is asked again next time.
+ */
+export declare function hasServerExecution(settings: ServerConnection.ISettings): Promise<boolean>;
+/**
+ * The executor to run a cell of this session through, if its server has one.
+ *
+ * Bound to the server of the session's KERNEL — the sandbox pod — which is
+ * where the REST endpoint lives and where the request is then kept; the
+ * executor of the lab extension is bound to the application's own server,
+ * which is not that one and, on the SaaS, is not at all.
+ *
+ * `null` when the session has no kernel yet, or its server does not run
+ * cells: the caller then executes over the kernel connection as before.
+ */
+export declare function serverExecutorFor(sessionContext: ISessionContext | undefined): Promise<INotebookCellExecutor | null>;
+/** A notebook widget, as much of it as the sweep reads. */
+export interface ISweepableNotebook {
+    content: {
+        widgets: readonly unknown[];
+    };
+    sessionContext?: ISessionContext;
+    isDisposed?: boolean;
+}
+/**
+ * Resume, once, the server executions of the cells of this notebook.
+ *
+ * @param panel The notebook panel of the editor
+ * @param settings The server the executions were posted to — the one of the
+ *   notebook's kernel
+ * @returns how many requests were taken up in this pass
+ */
+export declare function resumeServerExecutions(panel: ISweepableNotebook): Promise<number>;
+/**
+ * Forget what was asked and resumed — for tests, which build servers anew.
+ */
+export declare function resetServerExecutionState(): void;