@almadar/std 3.10.0 → 3.11.0

package/dist/modules/agent.d.ts

@@ -0,0 +1,21 @@
+import { a as StdOperatorMeta } from '../types-BjP5nVQd.js';
+
+/**
+ * Agent Module - AI Agent Intelligence Operations
+ *
+ * Provides operators for agent memory management, LLM access,
+ * tool invocation, context window management, and session control.
+ *
+ * @packageDocumentation
+ */
+
+/**
+ * Agent module operators.
+ */
+declare const AGENT_OPERATORS: Record<string, StdOperatorMeta>;
+/**
+ * Get all agent operator names.
+ */
+declare function getAgentOperators(): string[];
+
+export { AGENT_OPERATORS, getAgentOperators };

package/dist/modules/agent.js

@@ -0,0 +1,322 @@
+// modules/agent.ts
+var AGENT_OPERATORS = {
+  // ==========================================================================
+  // Memory (Pure)
+  // ==========================================================================
+  "agent/recall": {
+    module: "agent",
+    category: "std-agent",
+    minArity: 1,
+    maxArity: 2,
+    description: "Search memories by semantic query. Returns matching AgentMemoryRecord array.",
+    hasSideEffects: false,
+    returnType: "array",
+    params: [
+      { name: "query", type: "string", description: "Semantic search query" },
+      { name: "limit", type: "number", description: "Max results to return", optional: true }
+    ],
+    example: '["agent/recall", "user prefers dark mode"] => [{id, content, strength, ...}]'
+  },
+  "agent/memories": {
+    module: "agent",
+    category: "std-agent",
+    minArity: 0,
+    maxArity: 1,
+    description: "List all memories, optionally filtered by category.",
+    hasSideEffects: false,
+    returnType: "array",
+    params: [
+      { name: "category", type: "string", description: "Memory category filter", optional: true }
+    ],
+    example: '["agent/memories", "preference"] => [{id, content, category, ...}]'
+  },
+  "agent/memory-strength": {
+    module: "agent",
+    category: "std-agent",
+    minArity: 1,
+    maxArity: 1,
+    description: "Get the strength value (0-1) of a specific memory.",
+    hasSideEffects: false,
+    returnType: "number",
+    params: [
+      { name: "id", type: "string", description: "Memory record ID" }
+    ],
+    example: '["agent/memory-strength", "mem_abc123"] => 0.85'
+  },
+  "agent/is-pinned": {
+    module: "agent",
+    category: "std-agent",
+    minArity: 1,
+    maxArity: 1,
+    description: "Check if a memory is pinned (immune to decay).",
+    hasSideEffects: false,
+    returnType: "boolean",
+    params: [
+      { name: "id", type: "string", description: "Memory record ID" }
+    ],
+    example: '["agent/is-pinned", "mem_abc123"] => true'
+  },
+  // ==========================================================================
+  // LLM (Pure)
+  // ==========================================================================
+  "agent/provider": {
+    module: "agent",
+    category: "std-agent",
+    minArity: 0,
+    maxArity: 0,
+    description: "Get the name of the current LLM provider.",
+    hasSideEffects: false,
+    returnType: "string",
+    params: [],
+    example: '["agent/provider"] => "deepseek"'
+  },
+  "agent/model": {
+    module: "agent",
+    category: "std-agent",
+    minArity: 0,
+    maxArity: 0,
+    description: "Get the name of the current LLM model.",
+    hasSideEffects: false,
+    returnType: "string",
+    params: [],
+    example: '["agent/model"] => "deepseek-chat"'
+  },
+  // ==========================================================================
+  // Tools (Pure)
+  // ==========================================================================
+  "agent/tools": {
+    module: "agent",
+    category: "std-agent",
+    minArity: 0,
+    maxArity: 0,
+    description: "Get the list of available tool names.",
+    hasSideEffects: false,
+    returnType: "array",
+    params: [],
+    example: '["agent/tools"] => ["execute", "validate-schema", "generate-schema"]'
+  },
+  // ==========================================================================
+  // Context (Pure)
+  // ==========================================================================
+  "agent/token-count": {
+    module: "agent",
+    category: "std-agent",
+    minArity: 0,
+    maxArity: 0,
+    description: "Get the current token count in the context window.",
+    hasSideEffects: false,
+    returnType: "number",
+    params: [],
+    example: '["agent/token-count"] => 12450'
+  },
+  "agent/context-usage": {
+    module: "agent",
+    category: "std-agent",
+    minArity: 0,
+    maxArity: 0,
+    description: "Get context window usage as a ratio (0-1).",
+    hasSideEffects: false,
+    returnType: "number",
+    params: [],
+    example: '["agent/context-usage"] => 0.62'
+  },
+  // ==========================================================================
+  // Session (Pure)
+  // ==========================================================================
+  "agent/session-id": {
+    module: "agent",
+    category: "std-agent",
+    minArity: 0,
+    maxArity: 0,
+    description: "Get the current session identifier.",
+    hasSideEffects: false,
+    returnType: "string",
+    params: [],
+    example: '["agent/session-id"] => "sess_a3f2k"'
+  },
+  // ==========================================================================
+  // Memory (Effects)
+  // ==========================================================================
+  "agent/memorize": {
+    module: "agent",
+    category: "std-agent",
+    minArity: 2,
+    maxArity: 3,
+    description: "Store a new memory. Returns the new memory ID.",
+    hasSideEffects: true,
+    returnType: "string",
+    params: [
+      { name: "content", type: "string", description: "Memory content to store" },
+      { name: "category", type: "string", description: "Category: preference, correction, pattern-affinity, entity-template, error-resolution" },
+      { name: "scope", type: "string", description: "Scope: global or project", optional: true, defaultValue: "global" }
+    ],
+    example: '["agent/memorize", "user prefers PascalCase", "preference"]'
+  },
+  "agent/forget": {
+    module: "agent",
+    category: "std-agent",
+    minArity: 1,
+    maxArity: 1,
+    description: "Remove a memory by ID.",
+    hasSideEffects: true,
+    returnType: "void",
+    params: [
+      { name: "id", type: "string", description: "Memory record ID to remove" }
+    ],
+    example: '["agent/forget", "mem_abc123"]'
+  },
+  "agent/pin": {
+    module: "agent",
+    category: "std-agent",
+    minArity: 1,
+    maxArity: 1,
+    description: "Pin a memory to prevent decay.",
+    hasSideEffects: true,
+    returnType: "void",
+    params: [
+      { name: "id", type: "string", description: "Memory record ID to pin" }
+    ],
+    example: '["agent/pin", "mem_abc123"]'
+  },
+  "agent/reinforce": {
+    module: "agent",
+    category: "std-agent",
+    minArity: 1,
+    maxArity: 1,
+    description: "Increase a memory's strength (reinforcement learning signal).",
+    hasSideEffects: true,
+    returnType: "void",
+    params: [
+      { name: "id", type: "string", description: "Memory record ID to reinforce" }
+    ],
+    example: '["agent/reinforce", "mem_abc123"]'
+  },
+  "agent/decay": {
+    module: "agent",
+    category: "std-agent",
+    minArity: 0,
+    maxArity: 0,
+    description: "Apply strength decay to all unpinned memories. Returns count of forgotten memories.",
+    hasSideEffects: true,
+    returnType: "number",
+    params: [],
+    example: '["agent/decay"] => 15'
+  },
+  // ==========================================================================
+  // LLM (Effects)
+  // ==========================================================================
+  "agent/generate": {
+    module: "agent",
+    category: "std-agent",
+    minArity: 1,
+    maxArity: 2,
+    description: "Generate text from the LLM. Returns generated string.",
+    hasSideEffects: true,
+    returnType: "string",
+    params: [
+      { name: "prompt", type: "string", description: "Prompt text to send to LLM" },
+      { name: "options", type: "object", description: "Options: { provider?, model?, maxTokens? }", optional: true }
+    ],
+    example: '["agent/generate", "Summarize the user request"]'
+  },
+  "agent/switch-provider": {
+    module: "agent",
+    category: "std-agent",
+    minArity: 1,
+    maxArity: 2,
+    description: "Switch the active LLM provider and optionally the model.",
+    hasSideEffects: true,
+    returnType: "void",
+    params: [
+      { name: "provider", type: "string", description: 'Provider name (e.g., "deepseek", "openai", "anthropic")' },
+      { name: "model", type: "string", description: "Model name override", optional: true }
+    ],
+    example: '["agent/switch-provider", "openai", "gpt-4o"]'
+  },
+  // ==========================================================================
+  // Tools (Effects)
+  // ==========================================================================
+  "agent/invoke": {
+    module: "agent",
+    category: "std-agent",
+    minArity: 2,
+    maxArity: 2,
+    description: "Invoke a tool by name with arguments. Returns tool result.",
+    hasSideEffects: true,
+    returnType: "any",
+    params: [
+      { name: "toolName", type: "string", description: "Name of the tool to invoke" },
+      { name: "args", type: "object", description: "Arguments to pass to the tool" }
+    ],
+    example: '["agent/invoke", "validate-schema", {"schema": "@entity"}]'
+  },
+  // ==========================================================================
+  // Context (Effects)
+  // ==========================================================================
+  "agent/compact": {
+    module: "agent",
+    category: "std-agent",
+    minArity: 0,
+    maxArity: 1,
+    description: "Compact the context window. Returns { before, after, strategy, summary? }.",
+    hasSideEffects: true,
+    returnType: "object",
+    params: [
+      { name: "strategy", type: "string", description: "Strategy: hybrid, summarize, truncate, extract", optional: true, defaultValue: "hybrid" }
+    ],
+    example: '["agent/compact", "summarize"] => {before: 50000, after: 12000, ...}'
+  },
+  // ==========================================================================
+  // Session (Effects)
+  // ==========================================================================
+  "agent/fork": {
+    module: "agent",
+    category: "std-agent",
+    minArity: 0,
+    maxArity: 1,
+    description: "Fork the current session. Returns new session ID.",
+    hasSideEffects: true,
+    returnType: "string",
+    params: [
+      { name: "label", type: "string", description: "Optional label for the fork point", optional: true }
+    ],
+    example: '["agent/fork", "before-refactor"] => "sess_fork_x7k2m"'
+  },
+  "agent/label": {
+    module: "agent",
+    category: "std-agent",
+    minArity: 1,
+    maxArity: 1,
+    description: "Label the current session checkpoint for later reference.",
+    hasSideEffects: true,
+    returnType: "void",
+    params: [
+      { name: "text", type: "string", description: "Label text for the checkpoint" }
+    ],
+    example: '["agent/label", "schema-v2-complete"]'
+  },
+  // ==========================================================================
+  // Search (Effects)
+  // ==========================================================================
+  "agent/search-code": {
+    module: "agent",
+    category: "std-agent",
+    minArity: 1,
+    maxArity: 2,
+    description: "Search code repositories. Returns array of { repo, path, url }.",
+    hasSideEffects: true,
+    returnType: "array",
+    params: [
+      { name: "query", type: "string", description: "Code search query" },
+      { name: "language", type: "string", description: "Programming language filter", optional: true }
+    ],
+    example: '["agent/search-code", "orbital schema validation", "typescript"]'
+  }
+};
+function getAgentOperators() {
+  return Object.keys(AGENT_OPERATORS);
+}
+
+export { AGENT_OPERATORS, getAgentOperators };
+//# sourceMappingURL=agent.js.map
+//# sourceMappingURL=agent.js.map

package/dist/modules/agent.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../modules/agent.ts"],"names":[],"mappings":"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","file":"agent.js","sourcesContent":["/**\n * Agent Module - AI Agent Intelligence Operations\n *\n * Provides operators for agent memory management, LLM access,\n * tool invocation, context window management, and session control.\n *\n * @packageDocumentation\n */\n\nimport type { StdOperatorMeta } from '../types.js';\n\n/**\n * Agent module operators.\n */\nexport const AGENT_OPERATORS: Record<string, StdOperatorMeta> = {\n  // ==========================================================================\n  // Memory (Pure)\n  // ==========================================================================\n  'agent/recall': {\n    module: 'agent',\n    category: 'std-agent',\n    minArity: 1,\n    maxArity: 2,\n    description: 'Search memories by semantic query. Returns matching AgentMemoryRecord array.',\n    hasSideEffects: false,\n    returnType: 'array',\n    params: [\n      { name: 'query', type: 'string', description: 'Semantic search query' },\n      { name: 'limit', type: 'number', description: 'Max results to return', optional: true },\n    ],\n    example: '[\"agent/recall\", \"user prefers dark mode\"] => [{id, content, strength, ...}]',\n  },\n  'agent/memories': {\n    module: 'agent',\n    category: 'std-agent',\n    minArity: 0,\n    maxArity: 1,\n    description: 'List all memories, optionally filtered by category.',\n    hasSideEffects: false,\n    returnType: 'array',\n    params: [\n      { name: 'category', type: 'string', description: 'Memory category filter', optional: true },\n    ],\n    example: '[\"agent/memories\", \"preference\"] => [{id, content, category, ...}]',\n  },\n  'agent/memory-strength': {\n    module: 'agent',\n    category: 'std-agent',\n    minArity: 1,\n    maxArity: 1,\n    description: 'Get the strength value (0-1) of a specific memory.',\n    hasSideEffects: false,\n    returnType: 'number',\n    params: [\n      { name: 'id', type: 'string', description: 'Memory record ID' },\n    ],\n    example: '[\"agent/memory-strength\", \"mem_abc123\"] => 0.85',\n  },\n  'agent/is-pinned': {\n    module: 'agent',\n    category: 'std-agent',\n    minArity: 1,\n    maxArity: 1,\n    description: 'Check if a memory is pinned (immune to decay).',\n    hasSideEffects: false,\n    returnType: 'boolean',\n    params: [\n      { name: 'id', type: 'string', description: 'Memory record ID' },\n    ],\n    example: '[\"agent/is-pinned\", \"mem_abc123\"] => true',\n  },\n\n  // ==========================================================================\n  // LLM (Pure)\n  // ==========================================================================\n  'agent/provider': {\n    module: 'agent',\n    category: 'std-agent',\n    minArity: 0,\n    maxArity: 0,\n    description: 'Get the name of the current LLM provider.',\n    hasSideEffects: false,\n    returnType: 'string',\n    params: [],\n    example: '[\"agent/provider\"] => \"deepseek\"',\n  },\n  'agent/model': {\n    module: 'agent',\n    category: 'std-agent',\n    minArity: 0,\n    maxArity: 0,\n    description: 'Get the name of the current LLM model.',\n    hasSideEffects: false,\n    returnType: 'string',\n    params: [],\n    example: '[\"agent/model\"] => \"deepseek-chat\"',\n  },\n\n  // ==========================================================================\n  // Tools (Pure)\n  // ==========================================================================\n  'agent/tools': {\n    module: 'agent',\n    category: 'std-agent',\n    minArity: 0,\n    maxArity: 0,\n    description: 'Get the list of available tool names.',\n    hasSideEffects: false,\n    returnType: 'array',\n    params: [],\n    example: '[\"agent/tools\"] => [\"execute\", \"validate-schema\", \"generate-schema\"]',\n  },\n\n  // ==========================================================================\n  // Context (Pure)\n  // ==========================================================================\n  'agent/token-count': {\n    module: 'agent',\n    category: 'std-agent',\n    minArity: 0,\n    maxArity: 0,\n    description: 'Get the current token count in the context window.',\n    hasSideEffects: false,\n    returnType: 'number',\n    params: [],\n    example: '[\"agent/token-count\"] => 12450',\n  },\n  'agent/context-usage': {\n    module: 'agent',\n    category: 'std-agent',\n    minArity: 0,\n    maxArity: 0,\n    description: 'Get context window usage as a ratio (0-1).',\n    hasSideEffects: false,\n    returnType: 'number',\n    params: [],\n    example: '[\"agent/context-usage\"] => 0.62',\n  },\n\n  // ==========================================================================\n  // Session (Pure)\n  // ==========================================================================\n  'agent/session-id': {\n    module: 'agent',\n    category: 'std-agent',\n    minArity: 0,\n    maxArity: 0,\n    description: 'Get the current session identifier.',\n    hasSideEffects: false,\n    returnType: 'string',\n    params: [],\n    example: '[\"agent/session-id\"] => \"sess_a3f2k\"',\n  },\n\n  // ==========================================================================\n  // Memory (Effects)\n  // ==========================================================================\n  'agent/memorize': {\n    module: 'agent',\n    category: 'std-agent',\n    minArity: 2,\n    maxArity: 3,\n    description: 'Store a new memory. Returns the new memory ID.',\n    hasSideEffects: true,\n    returnType: 'string',\n    params: [\n      { name: 'content', type: 'string', description: 'Memory content to store' },\n      { name: 'category', type: 'string', description: 'Category: preference, correction, pattern-affinity, entity-template, error-resolution' },\n      { name: 'scope', type: 'string', description: 'Scope: global or project', optional: true, defaultValue: 'global' },\n    ],\n    example: '[\"agent/memorize\", \"user prefers PascalCase\", \"preference\"]',\n  },\n  'agent/forget': {\n    module: 'agent',\n    category: 'std-agent',\n    minArity: 1,\n    maxArity: 1,\n    description: 'Remove a memory by ID.',\n    hasSideEffects: true,\n    returnType: 'void',\n    params: [\n      { name: 'id', type: 'string', description: 'Memory record ID to remove' },\n    ],\n    example: '[\"agent/forget\", \"mem_abc123\"]',\n  },\n  'agent/pin': {\n    module: 'agent',\n    category: 'std-agent',\n    minArity: 1,\n    maxArity: 1,\n    description: 'Pin a memory to prevent decay.',\n    hasSideEffects: true,\n    returnType: 'void',\n    params: [\n      { name: 'id', type: 'string', description: 'Memory record ID to pin' },\n    ],\n    example: '[\"agent/pin\", \"mem_abc123\"]',\n  },\n  'agent/reinforce': {\n    module: 'agent',\n    category: 'std-agent',\n    minArity: 1,\n    maxArity: 1,\n    description: 'Increase a memory\\'s strength (reinforcement learning signal).',\n    hasSideEffects: true,\n    returnType: 'void',\n    params: [\n      { name: 'id', type: 'string', description: 'Memory record ID to reinforce' },\n    ],\n    example: '[\"agent/reinforce\", \"mem_abc123\"]',\n  },\n  'agent/decay': {\n    module: 'agent',\n    category: 'std-agent',\n    minArity: 0,\n    maxArity: 0,\n    description: 'Apply strength decay to all unpinned memories. Returns count of forgotten memories.',\n    hasSideEffects: true,\n    returnType: 'number',\n    params: [],\n    example: '[\"agent/decay\"] => 15',\n  },\n\n  // ==========================================================================\n  // LLM (Effects)\n  // ==========================================================================\n  'agent/generate': {\n    module: 'agent',\n    category: 'std-agent',\n    minArity: 1,\n    maxArity: 2,\n    description: 'Generate text from the LLM. Returns generated string.',\n    hasSideEffects: true,\n    returnType: 'string',\n    params: [\n      { name: 'prompt', type: 'string', description: 'Prompt text to send to LLM' },\n      { name: 'options', type: 'object', description: 'Options: { provider?, model?, maxTokens? }', optional: true },\n    ],\n    example: '[\"agent/generate\", \"Summarize the user request\"]',\n  },\n  'agent/switch-provider': {\n    module: 'agent',\n    category: 'std-agent',\n    minArity: 1,\n    maxArity: 2,\n    description: 'Switch the active LLM provider and optionally the model.',\n    hasSideEffects: true,\n    returnType: 'void',\n    params: [\n      { name: 'provider', type: 'string', description: 'Provider name (e.g., \"deepseek\", \"openai\", \"anthropic\")' },\n      { name: 'model', type: 'string', description: 'Model name override', optional: true },\n    ],\n    example: '[\"agent/switch-provider\", \"openai\", \"gpt-4o\"]',\n  },\n\n  // ==========================================================================\n  // Tools (Effects)\n  // ==========================================================================\n  'agent/invoke': {\n    module: 'agent',\n    category: 'std-agent',\n    minArity: 2,\n    maxArity: 2,\n    description: 'Invoke a tool by name with arguments. Returns tool result.',\n    hasSideEffects: true,\n    returnType: 'any',\n    params: [\n      { name: 'toolName', type: 'string', description: 'Name of the tool to invoke' },\n      { name: 'args', type: 'object', description: 'Arguments to pass to the tool' },\n    ],\n    example: '[\"agent/invoke\", \"validate-schema\", {\"schema\": \"@entity\"}]',\n  },\n\n  // ==========================================================================\n  // Context (Effects)\n  // ==========================================================================\n  'agent/compact': {\n    module: 'agent',\n    category: 'std-agent',\n    minArity: 0,\n    maxArity: 1,\n    description: 'Compact the context window. Returns { before, after, strategy, summary? }.',\n    hasSideEffects: true,\n    returnType: 'object',\n    params: [\n      { name: 'strategy', type: 'string', description: 'Strategy: hybrid, summarize, truncate, extract', optional: true, defaultValue: 'hybrid' },\n    ],\n    example: '[\"agent/compact\", \"summarize\"] => {before: 50000, after: 12000, ...}',\n  },\n\n  // ==========================================================================\n  // Session (Effects)\n  // ==========================================================================\n  'agent/fork': {\n    module: 'agent',\n    category: 'std-agent',\n    minArity: 0,\n    maxArity: 1,\n    description: 'Fork the current session. Returns new session ID.',\n    hasSideEffects: true,\n    returnType: 'string',\n    params: [\n      { name: 'label', type: 'string', description: 'Optional label for the fork point', optional: true },\n    ],\n    example: '[\"agent/fork\", \"before-refactor\"] => \"sess_fork_x7k2m\"',\n  },\n  'agent/label': {\n    module: 'agent',\n    category: 'std-agent',\n    minArity: 1,\n    maxArity: 1,\n    description: 'Label the current session checkpoint for later reference.',\n    hasSideEffects: true,\n    returnType: 'void',\n    params: [\n      { name: 'text', type: 'string', description: 'Label text for the checkpoint' },\n    ],\n    example: '[\"agent/label\", \"schema-v2-complete\"]',\n  },\n\n  // ==========================================================================\n  // Search (Effects)\n  // ==========================================================================\n  'agent/search-code': {\n    module: 'agent',\n    category: 'std-agent',\n    minArity: 1,\n    maxArity: 2,\n    description: 'Search code repositories. Returns array of { repo, path, url }.',\n    hasSideEffects: true,\n    returnType: 'array',\n    params: [\n      { name: 'query', type: 'string', description: 'Code search query' },\n      { name: 'language', type: 'string', description: 'Programming language filter', optional: true },\n    ],\n    example: '[\"agent/search-code\", \"orbital schema validation\", \"typescript\"]',\n  },\n};\n\n/**\n * Get all agent operator names.\n */\nexport function getAgentOperators(): string[] {\n  return Object.keys(AGENT_OPERATORS);\n}\n"]}

package/dist/modules/array.d.ts

@@ -1,4 +1,4 @@
-import { a as StdOperatorMeta } from '../types-DOeGXRCm.js';
+import { a as StdOperatorMeta } from '../types-BjP5nVQd.js';
 
 /**
  * Array Module - Collection Operations

package/dist/modules/async.d.ts

@@ -1,4 +1,4 @@
-import { a as StdOperatorMeta } from '../types-DOeGXRCm.js';
+import { a as StdOperatorMeta } from '../types-BjP5nVQd.js';
 
 /**
  * Async Module - Asynchronous Operations

package/dist/modules/contract.d.ts

@@ -1,4 +1,4 @@
-import { a as StdOperatorMeta } from '../types-DOeGXRCm.js';
+import { a as StdOperatorMeta } from '../types-BjP5nVQd.js';
 
 /**
  * Contract Module - ML Contract Validation Operations

package/dist/modules/data.d.ts

@@ -1,4 +1,4 @@
-import { a as StdOperatorMeta } from '../types-DOeGXRCm.js';
+import { a as StdOperatorMeta } from '../types-BjP5nVQd.js';
 
 /**
  * Data Module - ML Data Preprocessing Operations

package/dist/modules/format.d.ts

@@ -1,4 +1,4 @@
-import { a as StdOperatorMeta } from '../types-DOeGXRCm.js';
+import { a as StdOperatorMeta } from '../types-BjP5nVQd.js';
 
 /**
  * Format Module - Display Formatting

package/dist/modules/graph.d.ts

@@ -1,4 +1,4 @@
-import { a as StdOperatorMeta } from '../types-DOeGXRCm.js';
+import { a as StdOperatorMeta } from '../types-BjP5nVQd.js';
 
 /**
  * Graph Module - Graph Neural Network Operations

package/dist/modules/index.d.ts

@@ -14,4 +14,5 @@ export { CONTRACT_OPERATORS, getContractOperators } from './contract.js';
 export { DATA_OPERATORS, getDataOperators } from './data.js';
 export { PROB_OPERATORS, getProbOperators } from './prob.js';
 export { OS_OPERATORS } from './os.js';
-import '../types-DOeGXRCm.js';
+export { AGENT_OPERATORS, getAgentOperators } from './agent.js';
+import '../types-BjP5nVQd.js';