@datalayer/agent-runtimes 1.0.2 → 1.0.4

package/lib/specs/memory.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Memory Catalog
+ *
+ * Predefined memory backend configurations.
+ *
+ * This file is AUTO-GENERATED from YAML specifications.
+ * DO NOT EDIT MANUALLY - run 'make specs' to regenerate.
+ */
+import type { MemorySpec } from '../types';
+export declare const Memories: {
+    readonly EPHEMERAL: "ephemeral";
+    readonly MEM0: "mem0";
+    readonly MEMPALACE: "mempalace";
+    readonly MEMU: "memu";
+    readonly SIMPLEMEM: "simplemem";
+};
+export type MemoryId = (typeof Memories)[keyof typeof Memories];
+export declare const EPHEMERAL_MEMORY_0_0_1: MemorySpec;
+export declare const MEM0_MEMORY_0_0_1: MemorySpec;
+export declare const MEMPALACE_MEMORY_0_0_1: MemorySpec;
+export declare const MEMU_MEMORY_0_0_1: MemorySpec;
+export declare const SIMPLEMEM_MEMORY_0_0_1: MemorySpec;
+export declare const MEMORY_CATALOGUE: Record<string, MemorySpec>;
+export declare const DEFAULT_MEMORY: MemoryId;
+/**
+ * Get a memory specification by ID.
+ */
+export declare function getMemory(memoryId: string): MemorySpec | undefined;
+/**
+ * Get the default memory backend.
+ */
+export declare function getDefaultMemory(): MemorySpec | undefined;
+/**
+ * List all available memory backends.
+ */
+export declare function listMemories(): MemorySpec[];

package/lib/specs/memory.js

@@ -0,0 +1,112 @@
+/*
+ * Copyright (c) 2025-2026 Datalayer, Inc.
+ * Distributed under the terms of the Modified BSD License.
+ */
+// ============================================================================
+// Memories Enum
+// ============================================================================
+export const Memories = {
+    EPHEMERAL: 'ephemeral',
+    MEM0: 'mem0',
+    MEMPALACE: 'mempalace',
+    MEMU: 'memu',
+    SIMPLEMEM: 'simplemem',
+};
+// ============================================================================
+// Memory Definitions
+// ============================================================================
+export const EPHEMERAL_MEMORY_0_0_1 = {
+    id: 'ephemeral',
+    version: '0.0.1',
+    name: 'Ephemeral Memory',
+    description: 'Simple in-process memory that lives and dies with the agent. Stores facts, preferences, and context in a local dictionary during the agent session. When the agent terminates, all memory is lost. Best suited for short-lived tasks, stateless assistants, and development/testing.',
+    persistence: 'none',
+    scope: 'agent',
+    backend: 'in-memory',
+    icon: 'zap',
+    emoji: '⚡',
+};
+export const MEM0_MEMORY_0_0_1 = {
+    id: 'mem0',
+    version: '0.0.1',
+    name: 'Mem0 Memory',
+    description: 'Universal memory layer powered by Mem0 (mem-zero). Enhances AI agents with an intelligent, persistent memory that remembers user preferences, adapts to individual needs, and continuously learns over time. Supports multi-level memory (User, Session, Agent state) with semantic search, automatic fact extraction, and conflict resolution. 26% more accurate than OpenAI Memory on the LOCOMO benchmark with 90% fewer tokens.',
+    persistence: 'permanent',
+    scope: 'user',
+    backend: 'mem0',
+    icon: 'brain',
+    emoji: '🧠',
+};
+export const MEMPALACE_MEMORY_0_0_1 = {
+    id: 'mempalace',
+    version: '0.0.1',
+    name: 'MemPalace Memory',
+    description: 'Highest-scoring AI memory system ever benchmarked (96.6% LongMemEval R@5 raw, 100% with Haiku rerank). Inspired by the ancient Greek method of loci, MemPalace organizes memories into a navigable palace: wings (people/projects), halls (memory types), rooms (specific topics), closets (compressed summaries), and drawers (verbatim originals). Includes AAAK lossless compression (30x token reduction), a temporal knowledge graph, specialist agents with diaries, and contradiction detection. Entirely local — no cloud, no API keys, no subscription. Works with any LLM.',
+    persistence: 'permanent',
+    scope: 'user',
+    backend: 'chromadb',
+    icon: 'castle',
+    emoji: '🏰',
+};
+export const MEMU_MEMORY_0_0_1 = {
+    id: 'memu',
+    version: '0.0.1',
+    name: 'memU Proactive Memory',
+    description: 'Proactive memory framework built for 24/7 always-on agents. Continuously captures and understands user intent, enabling agents that can anticipate needs and act proactively. Organizes memory as a hierarchical file system (categories → items → resources) with auto-categorization, cross-references, and pattern detection. Reduces LLM token cost by caching insights and avoiding redundant calls. 92% average accuracy on the LoCoMo benchmark.',
+    persistence: 'permanent',
+    scope: 'user',
+    backend: 'memu',
+    icon: 'eye',
+    emoji: '👁️',
+};
+export const SIMPLEMEM_MEMORY_0_0_1 = {
+    id: 'simplemem',
+    version: '0.0.1',
+    name: 'SimpleMem Lifelong Memory',
+    description: 'Efficient lifelong memory framework based on semantic lossless compression. Maximizes information density and token utilization through a three-stage pipeline: Semantic Structured Compression, Online Semantic Synthesis, and Intent-Aware Retrieval Planning. Achieves 43.24% F1 score on LoCoMo (26.4% above Mem0) with 30x fewer tokens than full-context methods. Supports cross-session memory with 64% improvement over Claude-Mem.',
+    persistence: 'cross-session',
+    scope: 'agent',
+    backend: 'lancedb',
+    icon: 'archive',
+    emoji: '🗜️',
+};
+// ============================================================================
+// Memory Catalog
+// ============================================================================
+export const MEMORY_CATALOGUE = {
+    'ephemeral': EPHEMERAL_MEMORY_0_0_1,
+    'mem0': MEM0_MEMORY_0_0_1,
+    'mempalace': MEMPALACE_MEMORY_0_0_1,
+    'memu': MEMU_MEMORY_0_0_1,
+    'simplemem': SIMPLEMEM_MEMORY_0_0_1,
+};
+export const DEFAULT_MEMORY = Memories.EPHEMERAL;
+function resolveMemoryId(memoryId) {
+    if (memoryId in MEMORY_CATALOGUE)
+        return memoryId;
+    const idx = memoryId.lastIndexOf(':');
+    if (idx > 0) {
+        const base = memoryId.slice(0, idx);
+        if (base in MEMORY_CATALOGUE)
+            return base;
+    }
+    return memoryId;
+}
+/**
+ * Get a memory specification by ID.
+ */
+export function getMemory(memoryId) {
+    return MEMORY_CATALOGUE[resolveMemoryId(memoryId)];
+}
+/**
+ * Get the default memory backend.
+ */
+export function getDefaultMemory() {
+    return MEMORY_CATALOGUE[DEFAULT_MEMORY];
+}
+/**
+ * List all available memory backends.
+ */
+export function listMemories() {
+    return Object.values(MEMORY_CATALOGUE);
+}

package/lib/specs/models.d.ts

@@ -6,20 +6,7 @@
  * This file is AUTO-GENERATED from YAML specifications.
  * DO NOT EDIT MANUALLY - run 'make specs' to regenerate.
  */
-export interface AIModel {
-    /** Unique model identifier (e.g., 'anthropic:claude-sonnet-4-5-20250514') */
-    id: string;
-    /** Display name for the model */
-    name: string;
-    /** Model description */
-    description: string;
-    /** Provider name (anthropic, openai, bedrock, azure-openai) */
-    provider: string;
-    /** Whether this is the default model */
-    default: boolean;
-    /** Required environment variable names */
-    requiredEnvVars: string[];
-}
+import type { AIModel } from '../types';
 export declare const AIModels: {
     readonly ANTHROPIC_CLAUDE_3_5_HAIKU_20241022: "anthropic:claude-3-5-haiku-20241022";
     readonly ANTHROPIC_CLAUDE_OPUS_4_20250514: "anthropic:claude-opus-4-20250514";
@@ -43,26 +30,26 @@ export declare const AIModels: {
     readonly OPENAI_O3_MINI: "openai:o3-mini";
 };
 export type AIModelId = (typeof AIModels)[keyof typeof AIModels];
-export declare const ANTHROPIC_CLAUDE_3_5_HAIKU_20241022: AIModel;
-export declare const ANTHROPIC_CLAUDE_OPUS_4_20250514: AIModel;
-export declare const ANTHROPIC_CLAUDE_SONNET_4_5_20250514: AIModel;
-export declare const ANTHROPIC_CLAUDE_SONNET_4_20250514: AIModel;
-export declare const AZURE_OPENAI_GPT_4_1_MINI: AIModel;
-export declare const AZURE_OPENAI_GPT_4_1_NANO: AIModel;
-export declare const AZURE_OPENAI_GPT_4_1: AIModel;
-export declare const AZURE_OPENAI_GPT_4O_MINI: AIModel;
-export declare const AZURE_OPENAI_GPT_4O: AIModel;
-export declare const BEDROCK_US_ANTHROPIC_CLAUDE_3_5_HAIKU_20241022_V1_0: AIModel;
-export declare const BEDROCK_US_ANTHROPIC_CLAUDE_OPUS_4_6_V1: AIModel;
-export declare const BEDROCK_US_ANTHROPIC_CLAUDE_OPUS_4_20250514_V1_0: AIModel;
-export declare const BEDROCK_US_ANTHROPIC_CLAUDE_SONNET_4_5_20250929_V1_0: AIModel;
-export declare const BEDROCK_US_ANTHROPIC_CLAUDE_SONNET_4_20250514_V1_0: AIModel;
-export declare const OPENAI_GPT_4_1_MINI: AIModel;
-export declare const OPENAI_GPT_4_1_NANO: AIModel;
-export declare const OPENAI_GPT_4_1: AIModel;
-export declare const OPENAI_GPT_4O_MINI: AIModel;
-export declare const OPENAI_GPT_4O: AIModel;
-export declare const OPENAI_O3_MINI: AIModel;
+export declare const ANTHROPIC_CLAUDE_3_5_HAIKU_20241022_0_0_1: AIModel;
+export declare const ANTHROPIC_CLAUDE_OPUS_4_20250514_0_0_1: AIModel;
+export declare const ANTHROPIC_CLAUDE_SONNET_4_5_20250514_0_0_1: AIModel;
+export declare const ANTHROPIC_CLAUDE_SONNET_4_20250514_0_0_1: AIModel;
+export declare const AZURE_OPENAI_GPT_4_1_MINI_0_0_1: AIModel;
+export declare const AZURE_OPENAI_GPT_4_1_NANO_0_0_1: AIModel;
+export declare const AZURE_OPENAI_GPT_4_1_0_0_1: AIModel;
+export declare const AZURE_OPENAI_GPT_4O_MINI_0_0_1: AIModel;
+export declare const AZURE_OPENAI_GPT_4O_0_0_1: AIModel;
+export declare const BEDROCK_US_ANTHROPIC_CLAUDE_3_5_HAIKU_20241022_V1_0_0_0_1: AIModel;
+export declare const BEDROCK_US_ANTHROPIC_CLAUDE_OPUS_4_6_V1_0_0_1: AIModel;
+export declare const BEDROCK_US_ANTHROPIC_CLAUDE_OPUS_4_20250514_V1_0_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_20250514_V1_0_0_0_1: AIModel;
+export declare const OPENAI_GPT_4_1_MINI_0_0_1: AIModel;
+export declare const OPENAI_GPT_4_1_NANO_0_0_1: AIModel;
+export declare const OPENAI_GPT_4_1_0_0_1: AIModel;
+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>;
 export declare const DEFAULT_MODEL: AIModelId;
 export declare const DEFAULT_MODEL_SPEC: AIModel;

package/lib/specs/models.js

@@ -30,180 +30,180 @@ export const AIModels = {
 // ============================================================================
 // AI Model Definitions
 // ============================================================================
-export const ANTHROPIC_CLAUDE_3_5_HAIKU_20241022 = {
+export const ANTHROPIC_CLAUDE_3_5_HAIKU_20241022_0_0_1 = {
     id: 'anthropic:claude-3-5-haiku-20241022',
+    version: '0.0.1',
     name: 'Anthropic Claude Haiku 3.5',
     description: 'Claude Haiku 3.5 by Anthropic - fast and efficient',
     provider: 'anthropic',
     default: false,
     requiredEnvVars: ['ANTHROPIC_API_KEY'],
 };
-export const ANTHROPIC_CLAUDE_OPUS_4_20250514 = {
+export const ANTHROPIC_CLAUDE_OPUS_4_20250514_0_0_1 = {
     id: 'anthropic:claude-opus-4-20250514',
+    version: '0.0.1',
     name: 'Anthropic Claude Opus 4',
     description: 'Claude Opus 4 by Anthropic - highest capability model',
     provider: 'anthropic',
     default: false,
     requiredEnvVars: ['ANTHROPIC_API_KEY'],
 };
-export const ANTHROPIC_CLAUDE_SONNET_4_5_20250514 = {
+export const ANTHROPIC_CLAUDE_SONNET_4_5_20250514_0_0_1 = {
     id: 'anthropic:claude-sonnet-4-5-20250514',
+    version: '0.0.1',
     name: 'Anthropic Claude Sonnet 4.5',
     description: 'Claude Sonnet 4.5 by Anthropic - balanced performance and speed',
     provider: 'anthropic',
     default: false,
     requiredEnvVars: ['ANTHROPIC_API_KEY'],
 };
-export const ANTHROPIC_CLAUDE_SONNET_4_20250514 = {
+export const ANTHROPIC_CLAUDE_SONNET_4_20250514_0_0_1 = {
     id: 'anthropic:claude-sonnet-4-20250514',
+    version: '0.0.1',
     name: 'Anthropic Claude Sonnet 4',
     description: 'Claude Sonnet 4 by Anthropic - strong reasoning and coding',
     provider: 'anthropic',
     default: false,
     requiredEnvVars: ['ANTHROPIC_API_KEY'],
 };
-export const AZURE_OPENAI_GPT_4_1_MINI = {
+export const AZURE_OPENAI_GPT_4_1_MINI_0_0_1 = {
     id: 'azure-openai:gpt-4.1-mini',
+    version: '0.0.1',
     name: 'Azure OpenAI GPT-4.1 Mini',
     description: 'GPT-4.1 Mini via Azure OpenAI - compact version',
     provider: 'azure-openai',
     default: false,
     requiredEnvVars: ['AZURE_OPENAI_API_KEY', 'AZURE_OPENAI_ENDPOINT'],
 };
-export const AZURE_OPENAI_GPT_4_1_NANO = {
+export const AZURE_OPENAI_GPT_4_1_NANO_0_0_1 = {
     id: 'azure-openai:gpt-4.1-nano',
+    version: '0.0.1',
     name: 'Azure OpenAI GPT-4.1 Nano',
     description: 'GPT-4.1 Nano via Azure OpenAI - smallest and fastest',
     provider: 'azure-openai',
     default: false,
     requiredEnvVars: ['AZURE_OPENAI_API_KEY', 'AZURE_OPENAI_ENDPOINT'],
 };
-export const AZURE_OPENAI_GPT_4_1 = {
+export const AZURE_OPENAI_GPT_4_1_0_0_1 = {
     id: 'azure-openai:gpt-4.1',
+    version: '0.0.1',
     name: 'Azure OpenAI GPT-4.1',
     description: 'GPT-4.1 via Azure OpenAI - strong general purpose',
     provider: 'azure-openai',
     default: false,
     requiredEnvVars: ['AZURE_OPENAI_API_KEY', 'AZURE_OPENAI_ENDPOINT'],
 };
-export const AZURE_OPENAI_GPT_4O_MINI = {
+export const AZURE_OPENAI_GPT_4O_MINI_0_0_1 = {
     id: 'azure-openai:gpt-4o-mini',
+    version: '0.0.1',
     name: 'Azure OpenAI GPT-4o Mini',
     description: 'GPT-4o Mini via Azure OpenAI - compact enterprise deployment',
     provider: 'azure-openai',
     default: false,
     requiredEnvVars: ['AZURE_OPENAI_API_KEY', 'AZURE_OPENAI_ENDPOINT'],
 };
-export const AZURE_OPENAI_GPT_4O = {
+export const AZURE_OPENAI_GPT_4O_0_0_1 = {
     id: 'azure-openai:gpt-4o',
+    version: '0.0.1',
     name: 'Azure OpenAI GPT-4o',
     description: 'GPT-4o via Azure OpenAI - enterprise deployment',
     provider: 'azure-openai',
     default: false,
     requiredEnvVars: ['AZURE_OPENAI_API_KEY', 'AZURE_OPENAI_ENDPOINT'],
 };
-export const BEDROCK_US_ANTHROPIC_CLAUDE_3_5_HAIKU_20241022_V1_0 = {
+export const BEDROCK_US_ANTHROPIC_CLAUDE_3_5_HAIKU_20241022_V1_0_0_0_1 = {
     id: 'bedrock:us.anthropic.claude-3-5-haiku-20241022-v1:0',
+    version: '0.0.1',
     name: 'Bedrock Claude Haiku 3.5',
     description: 'Claude Haiku 3.5 via AWS Bedrock - fast and efficient',
     provider: 'bedrock',
     default: false,
-    requiredEnvVars: [
-        'AWS_ACCESS_KEY_ID',
-        'AWS_SECRET_ACCESS_KEY',
-        'AWS_DEFAULT_REGION',
-    ],
+    requiredEnvVars: ['AWS_ACCESS_KEY_ID', 'AWS_SECRET_ACCESS_KEY', 'AWS_DEFAULT_REGION'],
 };
-export const BEDROCK_US_ANTHROPIC_CLAUDE_OPUS_4_6_V1 = {
+export const BEDROCK_US_ANTHROPIC_CLAUDE_OPUS_4_6_V1_0_0_1 = {
     id: 'bedrock:us.anthropic.claude-opus-4-6-v1',
+    version: '0.0.1',
     name: 'Bedrock Claude Opus 4.6',
     description: 'Claude Opus 4.6 via AWS Bedrock',
     provider: 'bedrock',
     default: false,
-    requiredEnvVars: [
-        'AWS_ACCESS_KEY_ID',
-        'AWS_SECRET_ACCESS_KEY',
-        'AWS_DEFAULT_REGION',
-    ],
+    requiredEnvVars: ['AWS_ACCESS_KEY_ID', 'AWS_SECRET_ACCESS_KEY', 'AWS_DEFAULT_REGION'],
 };
-export const BEDROCK_US_ANTHROPIC_CLAUDE_OPUS_4_20250514_V1_0 = {
+export const BEDROCK_US_ANTHROPIC_CLAUDE_OPUS_4_20250514_V1_0_0_0_1 = {
     id: 'bedrock:us.anthropic.claude-opus-4-20250514-v1:0',
+    version: '0.0.1',
     name: 'Bedrock Claude Opus 4',
     description: 'Claude Opus 4 via AWS Bedrock - highest capability',
     provider: 'bedrock',
     default: false,
-    requiredEnvVars: [
-        'AWS_ACCESS_KEY_ID',
-        'AWS_SECRET_ACCESS_KEY',
-        'AWS_DEFAULT_REGION',
-    ],
+    requiredEnvVars: ['AWS_ACCESS_KEY_ID', 'AWS_SECRET_ACCESS_KEY', 'AWS_DEFAULT_REGION'],
 };
-export const BEDROCK_US_ANTHROPIC_CLAUDE_SONNET_4_5_20250929_V1_0 = {
+export const BEDROCK_US_ANTHROPIC_CLAUDE_SONNET_4_5_20250929_V1_0_0_0_1 = {
     id: 'bedrock:us.anthropic.claude-sonnet-4-5-20250929-v1:0',
+    version: '0.0.1',
     name: 'Bedrock Claude Sonnet 4.5',
     description: 'Claude Sonnet 4.5 via AWS Bedrock - balanced performance',
     provider: 'bedrock',
     default: true,
-    requiredEnvVars: [
-        'AWS_ACCESS_KEY_ID',
-        'AWS_SECRET_ACCESS_KEY',
-        'AWS_DEFAULT_REGION',
-    ],
+    requiredEnvVars: ['AWS_ACCESS_KEY_ID', 'AWS_SECRET_ACCESS_KEY', 'AWS_DEFAULT_REGION'],
 };
-export const BEDROCK_US_ANTHROPIC_CLAUDE_SONNET_4_20250514_V1_0 = {
+export const BEDROCK_US_ANTHROPIC_CLAUDE_SONNET_4_20250514_V1_0_0_0_1 = {
     id: 'bedrock:us.anthropic.claude-sonnet-4-20250514-v1:0',
+    version: '0.0.1',
     name: 'Bedrock Claude Sonnet 4',
     description: 'Claude Sonnet 4 via AWS Bedrock - strong reasoning',
     provider: 'bedrock',
     default: false,
-    requiredEnvVars: [
-        'AWS_ACCESS_KEY_ID',
-        'AWS_SECRET_ACCESS_KEY',
-        'AWS_DEFAULT_REGION',
-    ],
+    requiredEnvVars: ['AWS_ACCESS_KEY_ID', 'AWS_SECRET_ACCESS_KEY', 'AWS_DEFAULT_REGION'],
 };
-export const OPENAI_GPT_4_1_MINI = {
+export const OPENAI_GPT_4_1_MINI_0_0_1 = {
     id: 'openai:gpt-4.1-mini',
+    version: '0.0.1',
     name: 'OpenAI GPT-4.1 Mini',
     description: 'GPT-4.1 Mini by OpenAI - compact version of GPT-4.1',
     provider: 'openai',
     default: false,
     requiredEnvVars: ['OPENAI_API_KEY'],
 };
-export const OPENAI_GPT_4_1_NANO = {
+export const OPENAI_GPT_4_1_NANO_0_0_1 = {
     id: 'openai:gpt-4.1-nano',
+    version: '0.0.1',
     name: 'OpenAI GPT-4.1 Nano',
     description: 'GPT-4.1 Nano by OpenAI - smallest and fastest',
     provider: 'openai',
     default: false,
     requiredEnvVars: ['OPENAI_API_KEY'],
 };
-export const OPENAI_GPT_4_1 = {
+export const OPENAI_GPT_4_1_0_0_1 = {
     id: 'openai:gpt-4.1',
+    version: '0.0.1',
     name: 'OpenAI GPT-4.1',
     description: 'GPT-4.1 by OpenAI - strong general purpose model',
     provider: 'openai',
     default: false,
     requiredEnvVars: ['OPENAI_API_KEY'],
 };
-export const OPENAI_GPT_4O_MINI = {
+export const OPENAI_GPT_4O_MINI_0_0_1 = {
     id: 'openai:gpt-4o-mini',
+    version: '0.0.1',
     name: 'OpenAI GPT-4o Mini',
     description: 'GPT-4o Mini by OpenAI - compact and cost-effective',
     provider: 'openai',
     default: false,
     requiredEnvVars: ['OPENAI_API_KEY'],
 };
-export const OPENAI_GPT_4O = {
+export const OPENAI_GPT_4O_0_0_1 = {
     id: 'openai:gpt-4o',
+    version: '0.0.1',
     name: 'OpenAI GPT-4o',
     description: 'GPT-4o by OpenAI - fast multimodal model',
     provider: 'openai',
     default: false,
     requiredEnvVars: ['OPENAI_API_KEY'],
 };
-export const OPENAI_O3_MINI = {
+export const OPENAI_O3_MINI_0_0_1 = {
     id: 'openai:o3-mini',
+    version: '0.0.1',
     name: 'OpenAI o3 Mini',
     description: 'o3 Mini by OpenAI - reasoning-focused compact model',
     provider: 'openai',
@@ -214,26 +214,26 @@ export const OPENAI_O3_MINI = {
 // AI Model Catalog
 // ============================================================================
 export const AI_MODEL_CATALOGUE = {
-    'anthropic:claude-3-5-haiku-20241022': ANTHROPIC_CLAUDE_3_5_HAIKU_20241022,
-    'anthropic:claude-opus-4-20250514': ANTHROPIC_CLAUDE_OPUS_4_20250514,
-    'anthropic:claude-sonnet-4-5-20250514': ANTHROPIC_CLAUDE_SONNET_4_5_20250514,
-    'anthropic:claude-sonnet-4-20250514': ANTHROPIC_CLAUDE_SONNET_4_20250514,
-    'azure-openai:gpt-4.1-mini': AZURE_OPENAI_GPT_4_1_MINI,
-    'azure-openai:gpt-4.1-nano': AZURE_OPENAI_GPT_4_1_NANO,
-    'azure-openai:gpt-4.1': AZURE_OPENAI_GPT_4_1,
-    'azure-openai:gpt-4o-mini': AZURE_OPENAI_GPT_4O_MINI,
-    'azure-openai:gpt-4o': AZURE_OPENAI_GPT_4O,
-    'bedrock:us.anthropic.claude-3-5-haiku-20241022-v1:0': BEDROCK_US_ANTHROPIC_CLAUDE_3_5_HAIKU_20241022_V1_0,
-    'bedrock:us.anthropic.claude-opus-4-6-v1': BEDROCK_US_ANTHROPIC_CLAUDE_OPUS_4_6_V1,
-    'bedrock:us.anthropic.claude-opus-4-20250514-v1:0': BEDROCK_US_ANTHROPIC_CLAUDE_OPUS_4_20250514_V1_0,
-    'bedrock:us.anthropic.claude-sonnet-4-5-20250929-v1:0': BEDROCK_US_ANTHROPIC_CLAUDE_SONNET_4_5_20250929_V1_0,
-    'bedrock:us.anthropic.claude-sonnet-4-20250514-v1:0': BEDROCK_US_ANTHROPIC_CLAUDE_SONNET_4_20250514_V1_0,
-    'openai:gpt-4.1-mini': OPENAI_GPT_4_1_MINI,
-    'openai:gpt-4.1-nano': OPENAI_GPT_4_1_NANO,
-    'openai:gpt-4.1': OPENAI_GPT_4_1,
-    'openai:gpt-4o-mini': OPENAI_GPT_4O_MINI,
-    'openai:gpt-4o': OPENAI_GPT_4O,
-    'openai:o3-mini': OPENAI_O3_MINI,
+    'anthropic:claude-3-5-haiku-20241022': ANTHROPIC_CLAUDE_3_5_HAIKU_20241022_0_0_1,
+    'anthropic:claude-opus-4-20250514': ANTHROPIC_CLAUDE_OPUS_4_20250514_0_0_1,
+    'anthropic:claude-sonnet-4-5-20250514': ANTHROPIC_CLAUDE_SONNET_4_5_20250514_0_0_1,
+    'anthropic:claude-sonnet-4-20250514': ANTHROPIC_CLAUDE_SONNET_4_20250514_0_0_1,
+    'azure-openai:gpt-4.1-mini': AZURE_OPENAI_GPT_4_1_MINI_0_0_1,
+    'azure-openai:gpt-4.1-nano': AZURE_OPENAI_GPT_4_1_NANO_0_0_1,
+    'azure-openai:gpt-4.1': AZURE_OPENAI_GPT_4_1_0_0_1,
+    'azure-openai:gpt-4o-mini': AZURE_OPENAI_GPT_4O_MINI_0_0_1,
+    'azure-openai:gpt-4o': AZURE_OPENAI_GPT_4O_0_0_1,
+    'bedrock:us.anthropic.claude-3-5-haiku-20241022-v1:0': BEDROCK_US_ANTHROPIC_CLAUDE_3_5_HAIKU_20241022_V1_0_0_0_1,
+    'bedrock:us.anthropic.claude-opus-4-6-v1': BEDROCK_US_ANTHROPIC_CLAUDE_OPUS_4_6_V1_0_0_1,
+    'bedrock:us.anthropic.claude-opus-4-20250514-v1:0': BEDROCK_US_ANTHROPIC_CLAUDE_OPUS_4_20250514_V1_0_0_0_1,
+    'bedrock:us.anthropic.claude-sonnet-4-5-20250929-v1:0': BEDROCK_US_ANTHROPIC_CLAUDE_SONNET_4_5_20250929_V1_0_0_0_1,
+    'bedrock:us.anthropic.claude-sonnet-4-20250514-v1:0': BEDROCK_US_ANTHROPIC_CLAUDE_SONNET_4_20250514_V1_0_0_0_1,
+    'openai:gpt-4.1-mini': OPENAI_GPT_4_1_MINI_0_0_1,
+    'openai:gpt-4.1-nano': OPENAI_GPT_4_1_NANO_0_0_1,
+    'openai:gpt-4.1': OPENAI_GPT_4_1_0_0_1,
+    'openai:gpt-4o-mini': OPENAI_GPT_4O_MINI_0_0_1,
+    'openai:gpt-4o': OPENAI_GPT_4O_0_0_1,
+    'openai:o3-mini': OPENAI_O3_MINI_0_0_1,
 };
 export const DEFAULT_MODEL = AIModels.BEDROCK_US_ANTHROPIC_CLAUDE_SONNET_4_5_20250929_V1_0;
-export const DEFAULT_MODEL_SPEC = BEDROCK_US_ANTHROPIC_CLAUDE_SONNET_4_5_20250929_V1_0;
+export const DEFAULT_MODEL_SPEC = BEDROCK_US_ANTHROPIC_CLAUDE_SONNET_4_5_20250929_V1_0_0_0_1;

package/lib/specs/notifications.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Notification Channel Catalog
+ *
+ * Predefined notification channel configurations.
+ *
+ * This file is AUTO-GENERATED from YAML specifications.
+ * DO NOT EDIT MANUALLY - run 'make specs' to regenerate.
+ */
+import type { NotificationChannelSpec } from '../types';
+export declare const API_PUSH_NOTIFICATION_SPEC_0_0_1: NotificationChannelSpec;
+export declare const EMAIL_NOTIFICATION_SPEC_0_0_1: NotificationChannelSpec;
+export declare const SLACK_NOTIFICATION_SPEC_0_0_1: NotificationChannelSpec;
+export declare const TEAMS_NOTIFICATION_SPEC_0_0_1: NotificationChannelSpec;
+export declare const WEBHOOK_NOTIFICATION_SPEC_0_0_1: NotificationChannelSpec;
+export declare const NOTIFICATION_CATALOG: Record<string, NotificationChannelSpec>;
+export declare function getNotificationSpecs(): NotificationChannelSpec[];
+export declare function getNotificationSpec(channelId: string): NotificationChannelSpec | undefined;

package/lib/specs/notifications.js

@@ -0,0 +1,103 @@
+/*
+ * Copyright (c) 2025-2026 Datalayer, Inc.
+ * Distributed under the terms of the Modified BSD License.
+ */
+// ============================================================================
+// Notification Channel Definitions
+// ============================================================================
+export const API_PUSH_NOTIFICATION_SPEC_0_0_1 = {
+    id: 'api-push',
+    version: '0.0.1',
+    name: 'API Push',
+    description: 'Push results to an external API endpoint via HTTP POST. Useful for integrating with downstream services, data warehouses, or event-driven architectures.',
+    icon: 'upload',
+    available: false,
+    coming_soon: true,
+    fields: [
+        { name: 'url', label: 'Endpoint URL', type: 'string', required: true, placeholder: 'https://api.example.com/agent-results' },
+        { name: 'secret', label: 'Signing Secret', type: 'string', required: false, placeholder: 'Optional HMAC secret for payload signing' },
+        { name: 'include_output', label: 'Include Output', type: 'boolean', required: false, default: true },
+    ],
+};
+export const EMAIL_NOTIFICATION_SPEC_0_0_1 = {
+    id: 'email',
+    version: '0.0.1',
+    name: 'Email',
+    description: 'Send notifications via email when agent events occur. Supports completion alerts, failure reports, and summary digests.',
+    icon: 'mail',
+    available: true,
+    coming_soon: false,
+    fields: [
+        { name: 'recipients', label: 'Recipients', type: 'string', required: true, placeholder: 'ops@company.com, team-lead@company.com' },
+        { name: 'subject_template', label: 'Subject Template', type: 'string', required: false, placeholder: '[Agent] {{agent_name}} — {{event_type}}' },
+        { name: 'include_output', label: 'Include Output', type: 'boolean', required: false, default: true },
+    ],
+};
+export const SLACK_NOTIFICATION_SPEC_0_0_1 = {
+    id: 'slack',
+    version: '0.0.1',
+    name: 'Slack',
+    description: 'Post notifications to a Slack channel or direct message when agent events occur. Supports rich message formatting with blocks.',
+    icon: 'bell',
+    available: true,
+    coming_soon: false,
+    fields: [
+        { name: 'channel', label: 'Channel', type: 'string', required: true, placeholder: '#sales-analytics' },
+        { name: 'mention_on_failure', label: 'Mention on Failure', type: 'string', required: false, placeholder: '@oncall-team' },
+        { name: 'include_output', label: 'Include Output', type: 'boolean', required: false, default: false },
+    ],
+};
+export const TEAMS_NOTIFICATION_SPEC_0_0_1 = {
+    id: 'teams',
+    version: '0.0.1',
+    name: 'Teams',
+    description: 'Post notifications to a Microsoft Teams channel via incoming webhook connector when agent events occur.',
+    icon: 'bell',
+    available: false,
+    coming_soon: true,
+    fields: [
+        { name: 'webhook_url', label: 'Webhook URL', type: 'string', required: true, placeholder: 'https://outlook.office.com/webhook/...' },
+        { name: 'include_output', label: 'Include Output', type: 'boolean', required: false, default: false },
+    ],
+};
+export const WEBHOOK_NOTIFICATION_SPEC_0_0_1 = {
+    id: 'webhook',
+    version: '0.0.1',
+    name: 'Webhook',
+    description: 'Send notifications to a custom HTTP endpoint via POST request. Payload includes event type, agent metadata, and optional output.',
+    icon: 'bell',
+    available: false,
+    coming_soon: true,
+    fields: [
+        { name: 'url', label: 'Webhook URL', type: 'string', required: true, placeholder: 'https://api.example.com/agent-events' },
+        { name: 'secret', label: 'Signing Secret', type: 'string', required: false, placeholder: 'Optional HMAC secret for payload signing' },
+        { name: 'include_output', label: 'Include Output', type: 'boolean', required: false, default: true },
+    ],
+};
+// ============================================================================
+// Notification Channel Catalog
+// ============================================================================
+export const NOTIFICATION_CATALOG = {
+    'api-push': API_PUSH_NOTIFICATION_SPEC_0_0_1,
+    'email': EMAIL_NOTIFICATION_SPEC_0_0_1,
+    'slack': SLACK_NOTIFICATION_SPEC_0_0_1,
+    'teams': TEAMS_NOTIFICATION_SPEC_0_0_1,
+    'webhook': WEBHOOK_NOTIFICATION_SPEC_0_0_1,
+};
+export function getNotificationSpecs() {
+    return Object.values(NOTIFICATION_CATALOG);
+}
+function resolveNotificationId(channelId) {
+    if (channelId in NOTIFICATION_CATALOG)
+        return channelId;
+    const idx = channelId.lastIndexOf(':');
+    if (idx > 0) {
+        const base = channelId.slice(0, idx);
+        if (base in NOTIFICATION_CATALOG)
+            return base;
+    }
+    return channelId;
+}
+export function getNotificationSpec(channelId) {
+    return NOTIFICATION_CATALOG[resolveNotificationId(channelId)];
+}

package/lib/specs/outputs.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Output Catalog
+ *
+ * Predefined output format configurations.
+ *
+ * This file is AUTO-GENERATED from YAML specifications.
+ * DO NOT EDIT MANUALLY - run 'make specs' to regenerate.
+ */
+import type { OutputSpec } from '../types';
+export declare const CSV_OUTPUT_SPEC_0_0_1: OutputSpec;
+export declare const DASHBOARD_OUTPUT_SPEC_0_0_1: OutputSpec;
+export declare const DOCUMENT_OUTPUT_SPEC_0_0_1: OutputSpec;
+export declare const EMAIL_OUTPUT_SPEC_0_0_1: OutputSpec;
+export declare const JSON_OUTPUT_SPEC_0_0_1: OutputSpec;
+export declare const NOTEBOOK_OUTPUT_SPEC_0_0_1: OutputSpec;
+export declare const SPREADSHEET_OUTPUT_SPEC_0_0_1: OutputSpec;
+export declare const OUTPUT_CATALOG: Record<string, OutputSpec>;
+export declare function getOutputSpecs(): OutputSpec[];
+export declare function getOutputSpec(outputId: string): OutputSpec | undefined;