@datalayer/agent-runtimes 1.3.53 → 1.3.55

package/lib/specs/index.d.ts

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

package/lib/specs/index.js

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

package/lib/specs/strategies.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Strategy Catalog
+ *
+ * Predefined agent reasoning strategies (control loops).
+ *
+ * This file is AUTO-GENERATED from YAML specifications.
+ * DO NOT EDIT MANUALLY - run 'make specs' to regenerate.
+ */
+import type { StrategySpec } from '../types';
+export declare const Strategies: {
+    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 StrategyId = (typeof Strategies)[keyof typeof Strategies];
+export declare const DATA_ANALYSIS_STRATEGY_0_0_1: StrategySpec;
+export declare const HUMAN_IN_THE_LOOP_STRATEGY_0_0_1: StrategySpec;
+export declare const OODA_STRATEGY_0_0_1: StrategySpec;
+export declare const PLAN_EXECUTE_CRITIC_STRATEGY_0_0_1: StrategySpec;
+export declare const STRATEGY_CATALOGUE: Record<string, StrategySpec>;
+export declare const DEFAULT_STRATEGY: StrategyId;
+/**
+ * Get a strategy specification by ID.
+ */
+export declare function getStrategy(strategyId: string): StrategySpec | undefined;
+/**
+ * Get the default strategy.
+ */
+export declare function getDefaultStrategy(): StrategySpec | undefined;
+/**
+ * List all available strategies.
+ */
+export declare function listStrategies(): StrategySpec[];

package/lib/specs/{loops.js → strategies.js}

@@ -3,18 +3,18 @@
  * Distributed under the terms of the Modified BSD License.
  */
 // ============================================================================
-// Loops Enum
+// Strategies Enum
 // ============================================================================
-export const Loops = {
+export const Strategies = {
     DATA_ANALYSIS: 'data-analysis',
     HUMAN_IN_THE_LOOP: 'human-in-the-loop',
     OODA: 'ooda',
     PLAN_EXECUTE_CRITIC: 'plan-execute-critic',
 };
 // ============================================================================
-// Loop Definitions
+// Strategy Definitions
 // ============================================================================
-export const DATA_ANALYSIS_LOOP_0_0_1 = {
+export const DATA_ANALYSIS_STRATEGY_0_0_1 = {
     id: 'data-analysis',
     version: '0.0.1',
     name: 'Data Analysis Loop',
@@ -47,7 +47,7 @@ export const DATA_ANALYSIS_LOOP_0_0_1 = {
     icon: 'graph',
     emoji: '📊',
 };
-export const HUMAN_IN_THE_LOOP_LOOP_0_0_1 = {
+export const HUMAN_IN_THE_LOOP_STRATEGY_0_0_1 = {
     id: 'human-in-the-loop',
     version: '0.0.1',
     name: 'Human-in-the-Loop',
@@ -83,7 +83,7 @@ export const HUMAN_IN_THE_LOOP_LOOP_0_0_1 = {
     icon: 'person',
     emoji: '🙋',
 };
-export const OODA_LOOP_0_0_1 = {
+export const OODA_STRATEGY_0_0_1 = {
     id: 'ooda',
     version: '0.0.1',
     name: 'OODA Loop',
@@ -112,7 +112,7 @@ export const OODA_LOOP_0_0_1 = {
     icon: 'sync',
     emoji: '🔄',
 };
-export const PLAN_EXECUTE_CRITIC_LOOP_0_0_1 = {
+export const PLAN_EXECUTE_CRITIC_STRATEGY_0_0_1 = {
     id: 'plan-execute-critic',
     version: '0.0.1',
     name: 'Plan / Execute / Critic Loop',
@@ -148,41 +148,41 @@ export const PLAN_EXECUTE_CRITIC_LOOP_0_0_1 = {
     emoji: '✅',
 };
 // ============================================================================
-// Loop Catalog
+// Strategy 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 STRATEGY_CATALOGUE = {
+    'data-analysis': DATA_ANALYSIS_STRATEGY_0_0_1,
+    'human-in-the-loop': HUMAN_IN_THE_LOOP_STRATEGY_0_0_1,
+    ooda: OODA_STRATEGY_0_0_1,
+    'plan-execute-critic': PLAN_EXECUTE_CRITIC_STRATEGY_0_0_1,
 };
-export const DEFAULT_LOOP = Loops.DATA_ANALYSIS;
-function resolveLoopId(loopId) {
-    if (loopId in LOOP_CATALOGUE)
-        return loopId;
-    const idx = loopId.lastIndexOf(':');
+export const DEFAULT_STRATEGY = Strategies.DATA_ANALYSIS;
+function resolveStrategyId(strategyId) {
+    if (strategyId in STRATEGY_CATALOGUE)
+        return strategyId;
+    const idx = strategyId.lastIndexOf(':');
     if (idx > 0) {
-        const base = loopId.slice(0, idx);
-        if (base in LOOP_CATALOGUE)
+        const base = strategyId.slice(0, idx);
+        if (base in STRATEGY_CATALOGUE)
             return base;
     }
-    return loopId;
+    return strategyId;
 }
 /**
- * Get a loop specification by ID.
+ * Get a strategy specification by ID.
  */
-export function getLoop(loopId) {
-    return LOOP_CATALOGUE[resolveLoopId(loopId)];
+export function getStrategy(strategyId) {
+    return STRATEGY_CATALOGUE[resolveStrategyId(strategyId)];
 }
 /**
- * Get the default loop.
+ * Get the default strategy.
  */
-export function getDefaultLoop() {
-    return LOOP_CATALOGUE[DEFAULT_LOOP];
+export function getDefaultStrategy() {
+    return STRATEGY_CATALOGUE[DEFAULT_STRATEGY];
 }
 /**
- * List all available loops.
+ * List all available strategies.
  */
-export function listLoops() {
-    return Object.values(LOOP_CATALOGUE);
+export function listStrategies() {
+    return Object.values(STRATEGY_CATALOGUE);
 }

package/lib/types/index.d.ts

@@ -20,7 +20,7 @@ export * from './execution';
 export * from './uiPlugins';
 export * from './guardrails';
 export * from './inference';
-export * from './loops';
+export * from './strategies';
 export * from './mcp';
 export * from './memory';
 export * from './messages';

package/lib/types/index.js

@@ -24,7 +24,7 @@ export * from './execution';
 export * from './uiPlugins';
 export * from './guardrails';
 export * from './inference';
-export * from './loops';
+export * from './strategies';
 export * from './mcp';
 export * from './memory';
 export * from './messages';

package/lib/types/{loops.d.ts → strategies.d.ts}

@@ -1,10 +1,10 @@
 /**
- * How the human participates in (or around) an agent execution loop.
+ * How the human participates in (or around) an agent reasoning strategy.
  */
-export interface LoopHuman {
+export interface StrategyHuman {
     /** Human interaction pattern: none, initiate, approve, feedback, or tool */
     mode: string;
-    /** Whether the loop pauses for human approval before sensitive actions */
+    /** Whether the strategy pauses for human approval before sensitive actions */
     approvalRequired: boolean;
     /** Actions that require explicit human approval */
     approvalFor: string[];
@@ -12,48 +12,48 @@ export interface LoopHuman {
     description: string;
 }
 /**
- * When and how an agent execution loop stops iterating.
+ * When and how an agent reasoning strategy stops iterating.
  */
-export interface LoopTermination {
-    /** Maximum iterations before the loop is stopped */
+export interface StrategyTermination {
+    /** Maximum iterations before the strategy is stopped */
     maxIterations: number;
     /** Conditions that mark the goal as reached */
     successCriteria: string[];
-    /** Conditions that mark the loop as failed */
+    /** Conditions that mark the strategy as failed */
     failureCriteria: string[];
     /** What to do when blocked: ask-human, retry, or abort */
     onBlocked: string;
 }
 /**
- * Specification for an agent execution loop.
+ * Specification for an agent reasoning strategy (a control loop).
  *
  * A framework-agnostic description of how an agent progresses from one
  * decision to the next: the control cycle (observe/think/act/evaluate), the
  * objective, constraints, where state lives, human participation, and the
  * termination policy.
  */
-export interface LoopSpec {
-    /** Unique loop identifier (e.g., 'data-analysis') */
+export interface StrategySpec {
+    /** Unique strategy identifier (e.g., 'data-analysis') */
     id: string;
     /** Version */
     version: string;
-    /** Display name for the loop */
+    /** Display name for the strategy */
     name: string;
-    /** Loop description */
+    /** Strategy description */
     description: string;
-    /** Default goal/objective the loop works toward */
+    /** Default goal/objective the strategy works toward */
     objective: string;
-    /** Loop strategy family */
+    /** Strategy family */
     strategy: string;
     /** Ordered phase names that make up one iteration */
     phases: string[];
     /** Boundaries the agent must respect */
     constraints: string[];
     /** Termination policy */
-    termination?: LoopTermination;
+    termination?: StrategyTermination;
     /** Human-in-the-loop participation settings */
-    human?: LoopHuman;
-    /** Where loop state lives between iterations */
+    human?: StrategyHuman;
+    /** Where strategy state lives between iterations */
     stateBackends: string[];
     /** Categorization tags */
     tags: string[];

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@datalayer/agent-runtimes",
-    "version": "1.3.53",
+    "version": "1.3.55",
     "type": "module",
     "workspaces": [
         ".",
@@ -147,7 +147,7 @@
         "@datalayer/agent-teams": "^1.0.0",
         "@datalayer/core": "^1.2.14",
         "@datalayer/decks": "^1.0.4",
-        "@datalayer/icons-react": "^1.0.14",
+        "@datalayer/icons-react": "^1.0.16",
         "@datalayer/jupyter-lexical": "^2.0.18",
         "@datalayer/jupyter-react": "^2.0.18",
         "@datalayer/jupyter-server-nbmodel": "^0.2.8",

package/scripts/codegen/generate_agents.py

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