@datalayer/agent-runtimes 1.0.10 → 1.0.18

package/lib/specs/index.d.ts

@@ -8,6 +8,7 @@ export * from './teams';
 export * from './envvars';
 export * from './evals';
 export * from './guardrails';
+export * from './loops';
 export * from './mcpServers';
 export * from './memory';
 export * from './models';

package/lib/specs/index.js

@@ -12,6 +12,7 @@ export * from './teams';
 export * from './envvars';
 export * from './evals';
 export * from './guardrails';
+export * from './loops';
 export * from './mcpServers';
 export * from './memory';
 export * from './models';

package/lib/specs/loops.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Loop Catalog
+ *
+ * Predefined agent execution-loop specifications.
+ *
+ * This file is AUTO-GENERATED from YAML specifications.
+ * DO NOT EDIT MANUALLY - run 'make specs' to regenerate.
+ */
+import type { LoopSpec } from '../types';
+export declare const Loops: {
+    readonly DATA_ANALYSIS: "data-analysis";
+    readonly HUMAN_IN_THE_LOOP: "human-in-the-loop";
+    readonly OODA: "ooda";
+    readonly PLAN_EXECUTE_CRITIC: "plan-execute-critic";
+};
+export type LoopId = (typeof Loops)[keyof typeof Loops];
+export declare const DATA_ANALYSIS_LOOP_0_0_1: LoopSpec;
+export declare const HUMAN_IN_THE_LOOP_LOOP_0_0_1: LoopSpec;
+export declare const OODA_LOOP_0_0_1: LoopSpec;
+export declare const PLAN_EXECUTE_CRITIC_LOOP_0_0_1: LoopSpec;
+export declare const LOOP_CATALOGUE: Record<string, LoopSpec>;
+export declare const DEFAULT_LOOP: LoopId;
+/**
+ * Get a loop specification by ID.
+ */
+export declare function getLoop(loopId: string): LoopSpec | undefined;
+/**
+ * Get the default loop.
+ */
+export declare function getDefaultLoop(): LoopSpec | undefined;
+/**
+ * List all available loops.
+ */
+export declare function listLoops(): LoopSpec[];

package/lib/specs/loops.js

@@ -0,0 +1,188 @@
+/*
+ * Copyright (c) 2025-2026 Datalayer, Inc.
+ * Distributed under the terms of the Modified BSD License.
+ */
+// ============================================================================
+// Loops Enum
+// ============================================================================
+export const Loops = {
+    DATA_ANALYSIS: 'data-analysis',
+    HUMAN_IN_THE_LOOP: 'human-in-the-loop',
+    OODA: 'ooda',
+    PLAN_EXECUTE_CRITIC: 'plan-execute-critic',
+};
+// ============================================================================
+// Loop Definitions
+// ============================================================================
+export const DATA_ANALYSIS_LOOP_0_0_1 = {
+    id: 'data-analysis',
+    version: '0.0.1',
+    name: 'Data Analysis Loop',
+    description: 'A generic iterative loop for data analysis. Each iteration the agent observes the current runtime state, decides the next step, executes code in the notebook, and evaluates the result against the objective. Intermediate state (dataframes, charts, tables) is stored outside the model so each LLM call stays small, focused, and inexpensive.',
+    objective: 'Analyze the provided dataset, identify the most important trends and metrics, produce clear visualizations, and summarize actionable findings.',
+    strategy: 'observe-think-act-evaluate',
+    phases: ['observe', 'think', 'act', 'evaluate'],
+    constraints: [
+        'Never modify source data files',
+        'Prefer reproducible, incremental code cells',
+        'Read only the summary of intermediate results, not full datasets',
+    ],
+    termination: {
+        maxIterations: 15,
+        successCriteria: [
+            'The objective is met and a final summary has been produced',
+            'Key metrics and visualizations are available in the notebook',
+        ],
+        failureCriteria: ['The dataset cannot be loaded after repeated attempts'],
+        onBlocked: 'ask-human',
+    },
+    human: {
+        mode: 'initiate',
+        approvalRequired: false,
+        approvalFor: [],
+        description: 'The human provides the goal and constraints, then observes. The agent runs the loop autonomously and reports the final result.',
+    },
+    stateBackends: ['notebook', 'runtime', 'filesystem'],
+    tags: ['data-analysis', 'analytics', 'generic', 'iterative'],
+    icon: 'graph',
+    emoji: '📊',
+};
+export const HUMAN_IN_THE_LOOP_LOOP_0_0_1 = {
+    id: 'human-in-the-loop',
+    version: '0.0.1',
+    name: 'Human-in-the-Loop',
+    description: 'A control loop that runs autonomously but stops for explicit human approval before any sensitive or irreversible action. The human sits outside the loop, defining the goal and constraints, and steps in only when the agent needs a decision it is not permitted to make on its own.',
+    objective: 'Complete the task autonomously while requesting human approval before any sensitive or irreversible action.',
+    strategy: 'observe-think-act-evaluate',
+    phases: ['observe', 'think', 'act', 'evaluate'],
+    constraints: [
+        'Never perform an approval-gated action without explicit human sign-off',
+        'Surface a clear summary of the pending action when requesting approval',
+    ],
+    termination: {
+        maxIterations: 12,
+        successCriteria: ['The task is complete and all approvals were obtained'],
+        failureCriteria: [
+            'The human rejects a required action and no alternative exists',
+        ],
+        onBlocked: 'ask-human',
+    },
+    human: {
+        mode: 'approve',
+        approvalRequired: true,
+        approvalFor: [
+            'delete-data',
+            'send-email',
+            'spend-money',
+            'deploy-production',
+        ],
+        description: "The loop pauses and waits for human approval before executing any action listed in approval_for, then resumes with the human's decision.",
+    },
+    stateBackends: ['notebook', 'runtime', 'filesystem'],
+    tags: ['human-in-the-loop', 'approval', 'safety', 'generic'],
+    icon: 'person',
+    emoji: '🙋',
+};
+export const OODA_LOOP_0_0_1 = {
+    id: 'ooda',
+    version: '0.0.1',
+    name: 'OODA Loop',
+    description: 'A generic Observe → Orient → Decide → Act control loop. The agent observes the current state, orients by interpreting it in the context of the goal, decides on the next action, and acts. The loop is well suited to decision-oriented and monitoring tasks over a changing environment.',
+    objective: 'Continuously assess the environment and take the best next action toward the goal until it is reached or a stop condition is met.',
+    strategy: 'ooda',
+    phases: ['observe', 'orient', 'decide', 'act'],
+    constraints: [
+        'Re-observe fresh state at the start of every iteration',
+        'Keep each decision small and reversible when possible',
+    ],
+    termination: {
+        maxIterations: 20,
+        successCriteria: ['The goal condition is satisfied'],
+        failureCriteria: ['A hard stop condition or budget limit is reached'],
+        onBlocked: 'retry',
+    },
+    human: {
+        mode: 'none',
+        approvalRequired: false,
+        approvalFor: [],
+        description: 'Fully autonomous loop with no human interaction during execution.',
+    },
+    stateBackends: ['runtime', 'filesystem', 'sql'],
+    tags: ['ooda', 'decision-loop', 'generic', 'monitoring'],
+    icon: 'sync',
+    emoji: '🔄',
+};
+export const PLAN_EXECUTE_CRITIC_LOOP_0_0_1 = {
+    id: 'plan-execute-critic',
+    version: '0.0.1',
+    name: 'Plan / Execute / Critic Loop',
+    description: 'A control loop with three roles. The planner decomposes the goal into the next concrete step, the executor performs it in the runtime, and the critic evaluates the outcome for gaps or errors. The loop repeats until the critic is satisfied or the iteration budget is exhausted, driving higher-quality, self-corrected results.',
+    objective: 'Produce a high-quality analysis or report that has been reviewed and corrected for logical errors before it is finalized.',
+    strategy: 'plan-execute-critic',
+    phases: ['plan', 'execute', 'critic'],
+    constraints: [
+        'The critic must not rewrite results, only identify issues to fix',
+        'Each step must build on validated intermediate results',
+        'Stop refining once the critic reports no material issues',
+    ],
+    termination: {
+        maxIterations: 8,
+        successCriteria: [
+            'The critic reports no material issues with the latest result',
+            'A final, corrected output has been published',
+        ],
+        failureCriteria: [
+            'The critic reports the goal is not achievable with available data',
+        ],
+        onBlocked: 'ask-human',
+    },
+    human: {
+        mode: 'feedback',
+        approvalRequired: false,
+        approvalFor: [],
+        description: 'The human can inject feedback between iterations to steer the planner and critic without restarting the loop from scratch.',
+    },
+    stateBackends: ['notebook', 'runtime', 'filesystem'],
+    tags: ['analysis', 'data-quality', 'self-correction', 'multi-role'],
+    icon: 'checklist',
+    emoji: '✅',
+};
+// ============================================================================
+// Loop Catalog
+// ============================================================================
+export const LOOP_CATALOGUE = {
+    'data-analysis': DATA_ANALYSIS_LOOP_0_0_1,
+    'human-in-the-loop': HUMAN_IN_THE_LOOP_LOOP_0_0_1,
+    ooda: OODA_LOOP_0_0_1,
+    'plan-execute-critic': PLAN_EXECUTE_CRITIC_LOOP_0_0_1,
+};
+export const DEFAULT_LOOP = Loops.DATA_ANALYSIS;
+function resolveLoopId(loopId) {
+    if (loopId in LOOP_CATALOGUE)
+        return loopId;
+    const idx = loopId.lastIndexOf(':');
+    if (idx > 0) {
+        const base = loopId.slice(0, idx);
+        if (base in LOOP_CATALOGUE)
+            return base;
+    }
+    return loopId;
+}
+/**
+ * Get a loop specification by ID.
+ */
+export function getLoop(loopId) {
+    return LOOP_CATALOGUE[resolveLoopId(loopId)];
+}
+/**
+ * Get the default loop.
+ */
+export function getDefaultLoop() {
+    return LOOP_CATALOGUE[DEFAULT_LOOP];
+}
+/**
+ * List all available loops.
+ */
+export function listLoops() {
+    return Object.values(LOOP_CATALOGUE);
+}

package/lib/specs/mcpServers.d.ts

@@ -16,6 +16,7 @@ export declare const GITHUB_MCP_SERVER_0_0_1: MCPServer;
 export declare const GOOGLE_WORKSPACE_MCP_SERVER_0_0_1: MCPServer;
 export declare const HUGGINGFACE_MCP_SERVER_0_0_1: MCPServer;
 export declare const KAGGLE_MCP_SERVER_0_0_1: MCPServer;
+export declare const ODOO_MCP_SERVER_0_0_1: MCPServer;
 export declare const SALESFORCE_MCP_SERVER_0_0_1: MCPServer;
 export declare const SLACK_MCP_SERVER_0_0_1: MCPServer;
 export declare const TAVILY_MCP_SERVER_0_0_1: MCPServer;

package/lib/specs/mcpServers.js

@@ -171,6 +171,22 @@ export const KAGGLE_MCP_SERVER_0_0_1 = {
     tools: [],
     requiredEnvVars: ['KAGGLE_TOKEN:0.0.1'],
 };
+export const ODOO_MCP_SERVER_0_0_1 = {
+    id: 'odoo',
+    version: '0.0.1',
+    name: 'Odoo',
+    description: 'Odoo ERP operations (search, invoices, journals, reconciliations)',
+    icon: 'server',
+    emoji: '📚',
+    url: '',
+    command: 'uvx',
+    args: ['mcp-server-odoo'],
+    transport: 'stdio',
+    enabled: true,
+    isAvailable: false,
+    tools: [],
+    requiredEnvVars: [],
+};
 export const SALESFORCE_MCP_SERVER_0_0_1 = {
     id: 'salesforce',
     version: '0.0.1',
@@ -239,6 +255,7 @@ export const MCP_SERVER_LIBRARY = {
     'google-workspace': GOOGLE_WORKSPACE_MCP_SERVER_0_0_1,
     huggingface: HUGGINGFACE_MCP_SERVER_0_0_1,
     kaggle: KAGGLE_MCP_SERVER_0_0_1,
+    odoo: ODOO_MCP_SERVER_0_0_1,
     salesforce: SALESFORCE_MCP_SERVER_0_0_1,
     slack: SLACK_MCP_SERVER_0_0_1,
     tavily: TAVILY_MCP_SERVER_0_0_1,

package/lib/specs/models.d.ts

@@ -17,7 +17,9 @@ export declare const AIModels: {
     readonly AZURE_OPENAI_GPT_4_1: "azure-openai:gpt-4.1";
     readonly AZURE_OPENAI_GPT_4O_MINI: "azure-openai:gpt-4o-mini";
     readonly AZURE_OPENAI_GPT_4O: "azure-openai:gpt-4o";
+    readonly BEDROCK_US_ANTHROPIC_CLAUDE_FABLE_5: "bedrock:us.anthropic.claude-fable-5";
     readonly BEDROCK_US_ANTHROPIC_CLAUDE_OPUS_4_6_V1: "bedrock:us.anthropic.claude-opus-4-6-v1";
+    readonly BEDROCK_US_ANTHROPIC_CLAUDE_OPUS_4_8: "bedrock:us.anthropic.claude-opus-4-8";
     readonly BEDROCK_US_ANTHROPIC_CLAUDE_OPUS_4_20250514_V1_0: "bedrock:us.anthropic.claude-opus-4-20250514-v1:0";
     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_20250514_V1_0: "bedrock:us.anthropic.claude-sonnet-4-20250514-v1:0";
@@ -38,7 +40,9 @@ 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_FABLE_5_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_8_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;

package/lib/specs/models.js

@@ -15,7 +15,9 @@ export const AIModels = {
     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_FABLE_5: 'bedrock:us.anthropic.claude-fable-5',
     BEDROCK_US_ANTHROPIC_CLAUDE_OPUS_4_6_V1: 'bedrock:us.anthropic.claude-opus-4-6-v1',
+    BEDROCK_US_ANTHROPIC_CLAUDE_OPUS_4_8: 'bedrock:us.anthropic.claude-opus-4-8',
     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',
@@ -110,6 +112,19 @@ export const AZURE_OPENAI_GPT_4O_0_0_1 = {
     default: false,
     requiredEnvVars: ['AZURE_OPENAI_API_KEY', 'AZURE_OPENAI_ENDPOINT'],
 };
+export const BEDROCK_US_ANTHROPIC_CLAUDE_FABLE_5_0_0_1 = {
+    id: 'bedrock:us.anthropic.claude-fable-5',
+    version: '0.0.1',
+    name: 'Bedrock Claude Fable 5',
+    description: 'Claude Fable 5 via AWS Bedrock',
+    provider: 'bedrock',
+    default: false,
+    requiredEnvVars: [
+        'AWS_ACCESS_KEY_ID',
+        'AWS_SECRET_ACCESS_KEY',
+        'AWS_DEFAULT_REGION',
+    ],
+};
 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',
@@ -123,6 +138,19 @@ export const BEDROCK_US_ANTHROPIC_CLAUDE_OPUS_4_6_V1_0_0_1 = {
         'AWS_DEFAULT_REGION',
     ],
 };
+export const BEDROCK_US_ANTHROPIC_CLAUDE_OPUS_4_8_0_0_1 = {
+    id: 'bedrock:us.anthropic.claude-opus-4-8',
+    version: '0.0.1',
+    name: 'Bedrock Claude Opus 4.8',
+    description: 'Claude Opus 4.8 via AWS Bedrock',
+    provider: 'bedrock',
+    default: false,
+    requiredEnvVars: [
+        'AWS_ACCESS_KEY_ID',
+        'AWS_SECRET_ACCESS_KEY',
+        'AWS_DEFAULT_REGION',
+    ],
+};
 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',
@@ -229,7 +257,9 @@ export const AI_MODEL_CATALOGUE = {
     '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-fable-5': BEDROCK_US_ANTHROPIC_CLAUDE_FABLE_5_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-8': BEDROCK_US_ANTHROPIC_CLAUDE_OPUS_4_8_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,

package/lib/specs/skills.d.ts

@@ -7,6 +7,7 @@
  * DO NOT EDIT MANUALLY - run 'make specs' to regenerate.
  */
 import type { SkillSpec } from '../types';
+export declare const ACCOUNTING_SKILL_SPEC_0_0_1: SkillSpec;
 export declare const CRAWL_SKILL_SPEC_0_0_1: SkillSpec;
 export declare const EVENTS_SKILL_SPEC_0_0_1: SkillSpec;
 export declare const GITHUB_SKILL_SPEC_0_0_1: SkillSpec;

package/lib/specs/skills.js

@@ -5,6 +5,23 @@
 // ============================================================================
 // Skill Definitions
 // ============================================================================
+export const ACCOUNTING_SKILL_SPEC_0_0_1 = {
+    id: 'accounting',
+    version: '0.0.1',
+    name: 'Accounting Skill',
+    description: 'Accounting analysis workflows for reconciliation, close, variance, and audit-ready summaries',
+    module: 'agent_skills.skills.accounting',
+    package: undefined,
+    method: undefined,
+    path: undefined,
+    requiredEnvVars: [],
+    optionalEnvVars: [],
+    dependencies: ['pandas>=2.0.0'],
+    tags: ['accounting', 'finance', 'reconciliation', 'close'],
+    icon: 'book',
+    emoji: '🧮',
+    enabled: true,
+};
 export const CRAWL_SKILL_SPEC_0_0_1 = {
     id: 'crawl',
     version: '0.0.1',
@@ -111,6 +128,7 @@ export const TEXT_SUMMARIZER_SKILL_SPEC_0_0_1 = {
 // Skill Catalog
 // ============================================================================
 export const SKILLS_CATALOG = {
+    accounting: ACCOUNTING_SKILL_SPEC_0_0_1,
     crawl: CRAWL_SKILL_SPEC_0_0_1,
     events: EVENTS_SKILL_SPEC_0_0_1,
     github: GITHUB_SKILL_SPEC_0_0_1,

package/lib/specs/tools.d.ts

@@ -7,9 +7,24 @@
  * DO NOT EDIT MANUALLY - run 'make specs' to regenerate.
  */
 import type { ToolSpec } from '../types';
+export declare const CREATE_PLAN_TOOL_SPEC_0_0_1: ToolSpec;
+export declare const CURRENT_TIME_TOOL_SPEC_0_0_1: ToolSpec;
+export declare const DISPLAY_RECIPE_TOOL_SPEC_0_0_1: ToolSpec;
+export declare const EXAMPLE_CREATE_PLAN_TOOL_SPEC_0_0_1: ToolSpec;
+export declare const EXAMPLE_CURRENT_TIME_TOOL_SPEC_0_0_1: ToolSpec;
+export declare const EXAMPLE_DISPLAY_RECIPE_TOOL_SPEC_0_0_1: ToolSpec;
+export declare const EXAMPLE_GENERATE_HAIKU_TOOL_SPEC_0_0_1: ToolSpec;
+export declare const EXAMPLE_GENERATE_TASK_STEPS_TOOL_SPEC_0_0_1: ToolSpec;
+export declare const EXAMPLE_GET_WEATHER_TOOL_SPEC_0_0_1: ToolSpec;
+export declare const EXAMPLE_RENDER_A2UI_SURFACE_TOOL_SPEC_0_0_1: ToolSpec;
+export declare const EXAMPLE_UPDATE_PLAN_STEP_TOOL_SPEC_0_0_1: ToolSpec;
+export declare const GENERATE_HAIKU_TOOL_SPEC_0_0_1: ToolSpec;
+export declare const GENERATE_TASK_STEPS_TOOL_SPEC_0_0_1: ToolSpec;
+export declare const GET_WEATHER_TOOL_SPEC_0_0_1: ToolSpec;
 export declare const RUNTIME_ECHO_TOOL_SPEC_0_0_1: ToolSpec;
 export declare const RUNTIME_SEND_MAIL_TOOL_SPEC_0_0_1: ToolSpec;
 export declare const RUNTIME_SENSITIVE_ECHO_TOOL_SPEC_0_0_1: ToolSpec;
+export declare const UPDATE_PLAN_STEP_TOOL_SPEC_0_0_1: ToolSpec;
 export declare const TOOL_CATALOG: Record<string, ToolSpec>;
 export declare function getToolSpecs(): ToolSpec[];
 export declare function getToolSpec(toolId: string): ToolSpec | undefined;