@datalayer/agent-runtimes 1.3.15 → 1.3.16

package/lib/specs/events.d.ts

@@ -7,13 +7,18 @@
  * DO NOT EDIT MANUALLY - run 'make specs' to regenerate.
  */
 import type { EventSpec } from '../types';
+export declare const AGENT_ASSIGNED_EVENT_SPEC_0_0_1: EventSpec;
 export declare const AGENT_ENDED_EVENT_SPEC_0_0_1: EventSpec;
+export declare const AGENT_OUTPUT_EVENT_SPEC_0_0_1: EventSpec;
 export declare const AGENT_STARTED_EVENT_SPEC_0_0_1: EventSpec;
+export declare const GENERIC_EVENT_SPEC_0_0_1: EventSpec;
 export declare const TOOL_APPROVAL_REQUESTED_EVENT_SPEC_0_0_1: EventSpec;
+export declare const EVENT_KIND_AGENT_ASSIGNED = "agent-assigned";
 export declare const EVENT_KIND_AGENT_ENDED = "agent-ended";
+export declare const EVENT_KIND_AGENT_OUTPUT = "agent-output";
 export declare const EVENT_KIND_AGENT_STARTED = "agent-started";
+export declare const EVENT_KIND_GENERIC = "generic";
 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

@@ -5,6 +5,64 @@
 // ============================================================================
 // Event Definitions
 // ============================================================================
+export const AGENT_ASSIGNED_EVENT_SPEC_0_0_1 = {
+    id: 'agent-assigned',
+    version: '0.0.1',
+    name: 'Agent Assigned',
+    description: 'Emitted when a running runtime is given its agent: the agent is created in the runtime, its MCP servers started and its environment set.',
+    kind: 'agent-assigned',
+    fields: [
+        {
+            name: 'agent_runtime_id',
+            label: 'Agent Runtime ID',
+            type: 'string',
+            required: true,
+            description: 'Runtime pod or instance identifier.',
+        },
+        {
+            name: 'agent_name',
+            label: 'Agent Name',
+            type: 'string',
+            required: true,
+            description: 'Name of the agent assigned to the runtime.',
+        },
+        {
+            name: 'assignment_source',
+            label: 'Assignment Source',
+            type: 'string',
+            required: true,
+            description: 'What assigned the agent (e.g. the launch request, the pool).',
+        },
+        {
+            name: 'assigned_at',
+            label: 'Assigned At',
+            type: 'string',
+            required: true,
+            description: 'ISO 8601 timestamp when the agent was assigned.',
+        },
+        {
+            name: 'sandbox_variant',
+            label: 'Sandbox Variant',
+            type: 'string',
+            required: false,
+            description: 'The sandbox the agent executes code in.',
+        },
+        {
+            name: 'mcp_proxy_url',
+            label: 'MCP Proxy URL',
+            type: 'string',
+            required: false,
+            description: 'Address of the MCP proxy the agent reaches its tools through.',
+        },
+        {
+            name: 'env_vars_set',
+            label: 'Env Vars Set',
+            type: 'number',
+            required: false,
+            description: 'How many environment variables were set for the agent.',
+        },
+    ],
+};
 export const AGENT_ENDED_EVENT_SPEC_0_0_1 = {
     id: 'agent-ended',
     version: '0.0.1',
@@ -70,6 +128,78 @@ export const AGENT_ENDED_EVENT_SPEC_0_0_1 = {
         },
     ],
 };
+export const AGENT_OUTPUT_EVENT_SPEC_0_0_1 = {
+    id: 'agent-output',
+    version: '0.0.1',
+    name: 'Agent Output',
+    description: "Emitted when an agent run produces its output: a triggered run that finished (with its timing and exit status) or a chat turn that completed. The event's status is the run's exit status.",
+    kind: 'agent-output',
+    fields: [
+        {
+            name: 'outputs',
+            label: 'Outputs',
+            type: 'string',
+            required: false,
+            description: 'The text the agent produced, or a summary of the artifacts it generated.',
+        },
+        {
+            name: 'exit_status',
+            label: 'Exit Status',
+            type: 'string',
+            required: true,
+            description: 'Final status of the run (e.g. completed, error).',
+        },
+        {
+            name: 'duration_ms',
+            label: 'Duration (ms)',
+            type: 'number',
+            required: true,
+            description: 'Execution time of the run or the turn, in milliseconds.',
+        },
+        {
+            name: 'agent_runtime_id',
+            label: 'Agent Runtime ID',
+            type: 'string',
+            required: false,
+            description: 'Runtime pod or instance identifier; set by a triggered run.',
+        },
+        {
+            name: 'agent_spec_id',
+            label: 'Agent Spec ID',
+            type: 'string',
+            required: false,
+            description: 'Identifier of the agent specification that ran; set by a triggered run.',
+        },
+        {
+            name: 'agent_id',
+            label: 'Agent ID',
+            type: 'string',
+            required: false,
+            description: 'Identifier of the agent in the runtime; set by a chat turn.',
+        },
+        {
+            name: 'started_at',
+            label: 'Started At',
+            type: 'string',
+            required: false,
+            description: 'ISO 8601 timestamp when the run started; set by a triggered run.',
+        },
+        {
+            name: 'ended_at',
+            label: 'Ended At',
+            type: 'string',
+            required: false,
+            description: 'ISO 8601 timestamp when the run ended; set by a triggered run.',
+        },
+        {
+            name: 'error_message',
+            label: 'Error Message',
+            type: 'string',
+            required: false,
+            description: 'Error description if the run failed.',
+        },
+    ],
+};
 export const AGENT_STARTED_EVENT_SPEC_0_0_1 = {
     id: 'agent-started',
     version: '0.0.1',
@@ -114,6 +244,14 @@ export const AGENT_STARTED_EVENT_SPEC_0_0_1 = {
         },
     ],
 };
+export const GENERIC_EVENT_SPEC_0_0_1 = {
+    id: 'generic',
+    version: '0.0.1',
+    name: 'Generic',
+    description: 'An event with no kind of its own: what the events client and the CLI create when none is named. It carries a title and a status, and no typed payload.',
+    kind: 'generic',
+    fields: [],
+};
 export const TOOL_APPROVAL_REQUESTED_EVENT_SPEC_0_0_1 = {
     id: 'tool-approval-requested',
     version: '0.0.1',
@@ -152,16 +290,21 @@ export const TOOL_APPROVAL_REQUESTED_EVENT_SPEC_0_0_1 = {
     ],
 };
 // Event kind constants for programmatic use
+export const EVENT_KIND_AGENT_ASSIGNED = 'agent-assigned';
 export const EVENT_KIND_AGENT_ENDED = 'agent-ended';
+export const EVENT_KIND_AGENT_OUTPUT = 'agent-output';
 export const EVENT_KIND_AGENT_STARTED = 'agent-started';
+export const EVENT_KIND_GENERIC = 'generic';
 export const EVENT_KIND_TOOL_APPROVAL_REQUESTED = 'tool-approval-requested';
-export const EVENT_KIND_AGENT_ASSIGNED = 'agent-assigned';
 // ============================================================================
 // Event Catalog
 // ============================================================================
 export const EVENT_CATALOG = {
+    'agent-assigned': AGENT_ASSIGNED_EVENT_SPEC_0_0_1,
     'agent-ended': AGENT_ENDED_EVENT_SPEC_0_0_1,
+    'agent-output': AGENT_OUTPUT_EVENT_SPEC_0_0_1,
     'agent-started': AGENT_STARTED_EVENT_SPEC_0_0_1,
+    generic: GENERIC_EVENT_SPEC_0_0_1,
     'tool-approval-requested': TOOL_APPROVAL_REQUESTED_EVENT_SPEC_0_0_1,
 };
 export function getEventSpecs() {

package/lib/specs/index.d.ts

@@ -12,8 +12,10 @@ export * from './loops';
 export * from './mcpServers';
 export * from './memory';
 export * from './models';
+export * from './modelProviders';
 export * from './notifications';
 export * from './outputs';
 export * from './skills';
 export * from './tools';
 export * from './triggers';
+export * from './uiPlugins';

package/lib/specs/index.js

@@ -16,8 +16,10 @@ export * from './loops';
 export * from './mcpServers';
 export * from './memory';
 export * from './models';
+export * from './modelProviders';
 export * from './notifications';
 export * from './outputs';
 export * from './skills';
 export * from './tools';
 export * from './triggers';
+export * from './uiPlugins';

package/lib/specs/mcpServers.js

@@ -70,7 +70,7 @@ export const EARTHDATA_MCP_SERVER_0_0_1 = {
     command: 'npx',
     args: ['-y', 'earthdata-mcp-server'],
     transport: 'stdio',
-    enabled: false,
+    enabled: true,
     isAvailable: false,
     tools: [],
     requiredEnvVars: ['EARTHDATA_USERNAME:0.0.1', 'EARTHDATA_PASSWORD:0.0.1'],
@@ -259,7 +259,7 @@ export const TAVILY_MCP_SERVER_0_0_1 = {
     command: 'npx',
     args: ['-y', 'tavily-mcp'],
     transport: 'stdio',
-    enabled: false,
+    enabled: true,
     isAvailable: false,
     tools: [],
     requiredEnvVars: ['TAVILY_API_KEY:0.0.1'],

package/lib/specs/memory.js

@@ -22,6 +22,7 @@ export const EPHEMERAL_MEMORY_0_0_1 = {
     persistence: 'none',
     scope: 'agent',
     backend: 'in-memory',
+    enabled: false,
     icon: 'zap',
     emoji: '⚡',
 };
@@ -33,6 +34,7 @@ export const MEM0_MEMORY_0_0_1 = {
     persistence: 'permanent',
     scope: 'user',
     backend: 'mem0',
+    enabled: true,
     icon: 'brain',
     emoji: '🧠',
 };
@@ -44,6 +46,7 @@ export const MEMU_MEMORY_0_0_1 = {
     persistence: 'permanent',
     scope: 'user',
     backend: 'memu',
+    enabled: false,
     icon: 'eye',
     emoji: '👁️',
 };
@@ -55,6 +58,7 @@ export const SIMPLEMEM_MEMORY_0_0_1 = {
     persistence: 'cross-session',
     scope: 'agent',
     backend: 'lancedb',
+    enabled: false,
     icon: 'archive',
     emoji: '🗜️',
 };

package/lib/specs/modelProviders.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Model Provider Catalog.
+ *
+ * Who serves a model: the vendor's own API, a cloud that hosts it, or the
+ * user's machine — with its site, documentation, terms, privacy policy and
+ * what it says about the data a request carries.
+ *
+ * This file is AUTO-GENERATED from YAML specifications.
+ * DO NOT EDIT MANUALLY - run 'make specs' to regenerate.
+ */
+import type { ModelProvider } from '../types/models';
+export declare const ALIBABA_0_0_1: ModelProvider;
+export declare const ANTHROPIC_0_0_1: ModelProvider;
+export declare const AZURE_OPENAI_0_0_1: ModelProvider;
+export declare const BEDROCK_0_0_1: ModelProvider;
+export declare const CLOUDFLARE_0_0_1: ModelProvider;
+export declare const OLLAMA_0_0_1: ModelProvider;
+export declare const OPENAI_0_0_1: ModelProvider;
+export declare const MODEL_PROVIDER_CATALOGUE: Record<string, ModelProvider>;
+/** The provider a model spec's `provider` names, or undefined. */
+export declare function getModelProvider(providerId: string): ModelProvider | undefined;
+export declare function listModelProviders(): ModelProvider[];

package/lib/specs/modelProviders.js

@@ -0,0 +1,102 @@
+/*
+ * Copyright (c) 2025-2026 Datalayer, Inc.
+ * Distributed under the terms of the Modified BSD License.
+ */
+export const ALIBABA_0_0_1 = {
+    id: 'alibaba',
+    version: '0.0.1',
+    name: 'Alibaba Cloud Model Studio',
+    description: "Alibaba Cloud's model service for the Qwen family, through an OpenAI-compatible endpoint, under Alibaba Cloud's international product terms.",
+    website: 'https://www.alibabacloud.com/en/product/modelstudio',
+    docsUrl: 'https://www.alibabacloud.com/help/en/model-studio/',
+    termsUrl: 'https://www.alibabacloud.com/help/en/legal/latest/alibaba-cloud-international-website-product-terms-of-service',
+    privacyUrl: 'https://www.alibabacloud.com/help/en/legal/latest/privacy-policy',
+    hosting: 'cloud',
+};
+export const ANTHROPIC_0_0_1 = {
+    id: 'anthropic',
+    version: '0.0.1',
+    name: 'Anthropic',
+    description: "Anthropic's own API for the Claude models — the vendor's endpoint, with the newest models first and the vendor's own usage policy.",
+    website: 'https://www.anthropic.com',
+    docsUrl: 'https://docs.claude.com/en/home',
+    termsUrl: 'https://www.anthropic.com/legal/commercial-terms',
+    privacyUrl: 'https://www.anthropic.com/legal/privacy',
+    dataUsageUrl: 'https://www.anthropic.com/legal/aup',
+    hosting: 'cloud',
+};
+export const AZURE_OPENAI_0_0_1 = {
+    id: 'azure-openai',
+    version: '0.0.1',
+    name: 'Azure OpenAI',
+    description: "OpenAI's models served by Microsoft Azure (Foundry Models sold by Azure) — an Azure resource, endpoint and key, under the Microsoft Product Terms and Azure's data-privacy commitments.",
+    website: 'https://azure.microsoft.com/en-us/products/ai-foundry/models/openai',
+    docsUrl: 'https://learn.microsoft.com/en-us/azure/ai-foundry/openai/overview',
+    termsUrl: 'https://www.microsoft.com/licensing/terms/productoffering/MicrosoftAzure/EAEAS',
+    privacyUrl: 'https://www.microsoft.com/en-us/privacy/privacystatement',
+    dataUsageUrl: 'https://learn.microsoft.com/en-us/legal/cognitive-services/openai/data-privacy',
+    hosting: 'cloud',
+};
+export const BEDROCK_0_0_1 = {
+    id: 'bedrock',
+    version: '0.0.1',
+    name: 'Amazon Bedrock',
+    description: "AWS's managed service for foundation models, among them Anthropic's Claude — called with AWS credentials, in an AWS region, under AWS's service terms and data protection.",
+    website: 'https://aws.amazon.com/bedrock/',
+    docsUrl: 'https://docs.aws.amazon.com/bedrock/latest/userguide/what-is-bedrock.html',
+    termsUrl: 'https://aws.amazon.com/service-terms/',
+    privacyUrl: 'https://aws.amazon.com/privacy/',
+    dataUsageUrl: 'https://docs.aws.amazon.com/bedrock/latest/userguide/data-protection.html',
+    hosting: 'cloud',
+};
+export const CLOUDFLARE_0_0_1 = {
+    id: 'cloudflare',
+    version: '0.0.1',
+    name: 'Cloudflare',
+    description: "Cloudflare Workers AI, the models Cloudflare hosts at its edge, and AI Gateway, which sits in front of them and of the third-party models it fronts (Typesafe's Jev) with logs, caching, rate limits and prepaid credits. A model's route (`wrk`, `gtw`) says which of the two it is reached through.",
+    website: 'https://www.cloudflare.com/developer-platform/products/workers-ai/',
+    docsUrl: 'https://developers.cloudflare.com/workers-ai/',
+    termsUrl: 'https://www.cloudflare.com/terms/',
+    privacyUrl: 'https://www.cloudflare.com/privacypolicy/',
+    dataUsageUrl: 'https://developers.cloudflare.com/workers-ai/platform/data-usage/',
+    hosting: 'cloud',
+};
+export const OLLAMA_0_0_1 = {
+    id: 'ollama',
+    version: '0.0.1',
+    name: 'Ollama',
+    description: "Open models run on the user's own machine through Ollama's local server — no API key, no data leaving the machine; the terms and privacy below are Ollama's for its site and registry.",
+    website: 'https://ollama.com/',
+    docsUrl: 'https://docs.ollama.com/',
+    termsUrl: 'https://ollama.com/terms',
+    privacyUrl: 'https://ollama.com/privacy',
+    hosting: 'local',
+};
+export const OPENAI_0_0_1 = {
+    id: 'openai',
+    version: '0.0.1',
+    name: 'OpenAI',
+    description: "OpenAI's platform API for the GPT and o-series models — the vendor's endpoint, under its business terms; API data is not used for training by default.",
+    website: 'https://openai.com',
+    docsUrl: 'https://platform.openai.com/docs/overview',
+    termsUrl: 'https://openai.com/policies/business-terms/',
+    privacyUrl: 'https://openai.com/policies/privacy-policy/',
+    dataUsageUrl: 'https://platform.openai.com/docs/guides/your-data',
+    hosting: 'cloud',
+};
+export const MODEL_PROVIDER_CATALOGUE = {
+    alibaba: ALIBABA_0_0_1,
+    anthropic: ANTHROPIC_0_0_1,
+    'azure-openai': AZURE_OPENAI_0_0_1,
+    bedrock: BEDROCK_0_0_1,
+    cloudflare: CLOUDFLARE_0_0_1,
+    ollama: OLLAMA_0_0_1,
+    openai: OPENAI_0_0_1,
+};
+/** The provider a model spec's `provider` names, or undefined. */
+export function getModelProvider(providerId) {
+    return MODEL_PROVIDER_CATALOGUE[providerId];
+}
+export function listModelProviders() {
+    return Object.values(MODEL_PROVIDER_CATALOGUE);
+}

package/lib/specs/models.d.ts

@@ -30,6 +30,14 @@ export declare const AIModels: {
     readonly BEDROCK_US_ANTHROPIC_CLAUDE_SONNET_4_5_20250929_V1_0: "bedrock:us.anthropic.claude-sonnet-4-5-20250929-v1:0";
     readonly BEDROCK_US_ANTHROPIC_CLAUDE_SONNET_4_6: "bedrock:us.anthropic.claude-sonnet-4-6";
     readonly BEDROCK_US_ANTHROPIC_CLAUDE_SONNET_4_20250514_V1_0: "bedrock:us.anthropic.claude-sonnet-4-20250514-v1:0";
+    readonly CLOUDFLARE_GTW_TYPESAFE_JEV: "cloudflare:gtw/typesafe/jev";
+    readonly CLOUDFLARE_WRK_GOOGLE_GEMMA_4_26B_A4B_IT: "cloudflare:wrk/google/gemma-4-26b-a4b-it";
+    readonly CLOUDFLARE_WRK_ZAI_ORG_GLM_5_2: "cloudflare:wrk/zai-org/glm-5.2";
+    readonly CLOUDFLARE_WRK_OPENAI_GPT_OSS_120B: "cloudflare:wrk/openai/gpt-oss-120b";
+    readonly CLOUDFLARE_WRK_MOONSHOTAI_KIMI_K2_6: "cloudflare:wrk/moonshotai/kimi-k2.6";
+    readonly CLOUDFLARE_WRK_META_LLAMA_3_3_70B_INSTRUCT_FP8_FAST: "cloudflare:wrk/meta/llama-3.3-70b-instruct-fp8-fast";
+    readonly CLOUDFLARE_WRK_QWEN_QWEN3_8_27B: "cloudflare:wrk/qwen/qwen3.8-27b";
+    readonly CLOUDFLARE_WRK_TYPESAFE_JEV: "cloudflare:wrk/typesafe/jev";
     readonly OLLAMA_GEMMA3_4B: "ollama:gemma3:4b";
     readonly OLLAMA_LLAMA3_1_8B: "ollama:llama3.1:8b";
     readonly OLLAMA_QWEN2_5_CODER_7B: "ollama:qwen2.5-coder:7b";
@@ -63,6 +71,14 @@ export declare const BEDROCK_US_ANTHROPIC_CLAUDE_OPUS_5_0_0_1: AIModel;
 export declare const BEDROCK_US_ANTHROPIC_CLAUDE_SONNET_4_5_20250929_V1_0_0_0_1: AIModel;
 export declare const BEDROCK_US_ANTHROPIC_CLAUDE_SONNET_4_6_0_0_1: AIModel;
 export declare const BEDROCK_US_ANTHROPIC_CLAUDE_SONNET_4_20250514_V1_0_0_0_1: AIModel;
+export declare const CLOUDFLARE_GTW_TYPESAFE_JEV_0_0_1: AIModel;
+export declare const CLOUDFLARE_WRK_GOOGLE_GEMMA_4_26B_A4B_IT_0_0_1: AIModel;
+export declare const CLOUDFLARE_WRK_ZAI_ORG_GLM_5_2_0_0_1: AIModel;
+export declare const CLOUDFLARE_WRK_OPENAI_GPT_OSS_120B_0_0_1: AIModel;
+export declare const CLOUDFLARE_WRK_MOONSHOTAI_KIMI_K2_6_0_0_1: AIModel;
+export declare const CLOUDFLARE_WRK_META_LLAMA_3_3_70B_INSTRUCT_FP8_FAST_0_0_1: AIModel;
+export declare const CLOUDFLARE_WRK_QWEN_QWEN3_8_27B_0_0_1: AIModel;
+export declare const CLOUDFLARE_WRK_TYPESAFE_JEV_0_0_1: AIModel;
 export declare const OLLAMA_GEMMA3_4B_0_0_1: AIModel;
 export declare const OLLAMA_LLAMA3_1_8B_0_0_1: AIModel;
 export declare const OLLAMA_QWEN2_5_CODER_7B_0_0_1: AIModel;
@@ -73,5 +89,20 @@ export declare const OPENAI_GPT_4O_MINI_0_0_1: AIModel;
 export declare const OPENAI_GPT_4O_0_0_1: AIModel;
 export declare const OPENAI_O3_MINI_0_0_1: AIModel;
 export declare const AI_MODEL_CATALOGUE: Record<string, AIModel>;
+/**
+ * The ids a model answered to before its id moved, to the id it has now.
+ * Kept apart from the catalogue, which lists each model once.
+ */
+export declare const AI_MODEL_ALIASES: Record<string, string>;
+/** A model by its id, or by an id it had before; undefined when the catalogue has neither. */
+export declare function getModel(modelId: string): AIModel | undefined;
+/**
+ * A model a chat can run on: not a typed-judgment model (Jev), which
+ * answers typed questions about a state and nothing else. A spec that
+ * states no capability is read as a chat model.
+ */
+export declare function isChatModel(model: AIModel): boolean;
+/** The models a person choosing a chat model is offered from. */
+export declare function listChatModels(): AIModel[];
 export declare const DEFAULT_MODEL: AIModelId;
 export declare const DEFAULT_MODEL_SPEC: AIModel;