@almadar/std 16.213.0 → 16.215.0

package/dist/knob-embeddings.hash.json

@@ -1,5 +1,5 @@
 {
-  "version": "16.213.0",
+  "version": "16.215.0",
   "model": "baai/bge-base-en-v1.5",
   "dimensions": 768,
   "registryHash": "9c5d453eb281388f19cf3d43aedb582a803764eb08093b10ca4c190eb1c8ae7e",

package/dist/modules/array.js

@@ -186,7 +186,7 @@ var ARRAY_OPERATORS = {
       { name: "key", type: "string", description: "Field to sort by (for objects)", optional: true },
       { name: "dir", type: "string", description: '"asc" or "desc"', optional: true, defaultValue: "asc" }
     ],
-    example: '["array/sort", "@items", "price", "desc"]'
+    example: '["array/sort", [{"price": 3}, {"price": 9}, {"price": 5}], "price", "desc"]'
   },
   "array/shuffle": {
     module: "array",
@@ -278,7 +278,7 @@ var ARRAY_OPERATORS = {
       { name: "arr", type: "array", description: "The array" },
       { name: "pred", type: "lambda", description: "Predicate function" }
     ],
-    example: '["array/find", "@items", ["fn", "x", ["=", "@x.status", "active"]]]'
+    example: '["array/find", [{"status": "active"}, {"status": "archived"}], ["fn", "x", ["=", "@x.status", "active"]]]'
   },
   "array/findIndex": {
     module: "array",
@@ -294,7 +294,7 @@ var ARRAY_OPERATORS = {
       { name: "arr", type: "array", description: "The array" },
       { name: "pred", type: "lambda", description: "Predicate function" }
     ],
-    example: '["array/findIndex", "@items", ["fn", "x", ["=", "@x.status", "active"]]]'
+    example: '["array/findIndex", [{"status": "active"}, {"status": "archived"}], ["fn", "x", ["=", "@x.status", "active"]]]'
   },
   "array/filter": {
     module: "array",
@@ -311,7 +311,7 @@ var ARRAY_OPERATORS = {
       { name: "arr", type: "array", description: "The array" },
       { name: "pred", type: "lambda", description: "Predicate function" }
     ],
-    example: '["array/filter", "@items", ["fn", "x", [">", "@x.price", 100]]]'
+    example: '["array/filter", [{"price": 50}, {"price": 150}], ["fn", "x", [">", "@x.price", 100]]]'
   },
   "array/reject": {
     module: "array",
@@ -328,7 +328,7 @@ var ARRAY_OPERATORS = {
       { name: "arr", type: "array", description: "The array" },
       { name: "pred", type: "lambda", description: "Predicate function" }
     ],
-    example: '["array/reject", "@items", ["fn", "x", ["=", "@x.status", "deleted"]]]'
+    example: '["array/reject", [{"status": "active"}, {"status": "deleted"}], ["fn", "x", ["=", "@x.status", "deleted"]]]'
   },
   "array/map": {
     module: "array",
@@ -345,7 +345,7 @@ var ARRAY_OPERATORS = {
       { name: "arr", type: "array", description: "The array" },
       { name: "fn", type: "lambda", description: "Transform function" }
     ],
-    example: '["array/map", "@items", ["fn", "x", ["*", "@x.price", 1.1]]]'
+    example: '["array/map", [{"price": 100}, {"price": 200}], ["fn", "x", ["*", "@x.price", 1.1]]]'
   },
   "array/reduce": {
     module: "array",
@@ -363,7 +363,7 @@ var ARRAY_OPERATORS = {
       { name: "init", type: "any", description: "Initial accumulator value" },
       { name: "fn", type: "lambda", description: "Reducer function (acc, item) => newAcc" }
     ],
-    example: '["array/reduce", "@items", 0, ["fn", ["acc", "x"], ["+", "@acc", "@x.price"]]]'
+    example: '["array/reduce", [{"price": 10}, {"price": 25}], 0, ["fn", ["acc", "x"], ["+", "@acc", "@x.price"]]]'
   },
   "array/every": {
     module: "array",
@@ -379,7 +379,7 @@ var ARRAY_OPERATORS = {
       { name: "arr", type: "array", description: "The array" },
       { name: "pred", type: "lambda", description: "Predicate function" }
     ],
-    example: '["array/every", "@items", ["fn", "x", [">", "@x.price", 0]]]'
+    example: '["array/every", [{"price": 5}, {"price": 10}], ["fn", "x", [">", "@x.price", 0]]]'
   },
   "array/some": {
     module: "array",
@@ -395,7 +395,7 @@ var ARRAY_OPERATORS = {
       { name: "arr", type: "array", description: "The array" },
       { name: "pred", type: "lambda", description: "Predicate function" }
     ],
-    example: '["array/some", "@items", ["fn", "x", ["=", "@x.status", "active"]]]'
+    example: '["array/some", [{"status": "archived"}, {"status": "active"}], ["fn", "x", ["=", "@x.status", "active"]]]'
   },
   "array/count": {
     module: "array",
@@ -411,7 +411,7 @@ var ARRAY_OPERATORS = {
       { name: "arr", type: "array", description: "The array" },
       { name: "pred", type: "lambda", description: "Predicate function", optional: true }
     ],
-    example: '["array/count", "@tasks", ["fn", "t", ["=", "@t.status", "done"]]]'
+    example: '["array/count", [{"status": "done"}, {"status": "todo"}], ["fn", "t", ["=", "@t.status", "done"]]]'
   },
   "array/sum": {
     module: "array",
@@ -425,7 +425,7 @@ var ARRAY_OPERATORS = {
       { name: "arr", type: "array", description: "The array" },
       { name: "key", type: "string", description: "Field to sum", optional: true }
     ],
-    example: '["array/sum", "@cart.items", "price"]'
+    example: '["array/sum", [{"price": 10}, {"price": 25}], "price"]'
   },
   "array/avg": {
     module: "array",
@@ -439,7 +439,7 @@ var ARRAY_OPERATORS = {
       { name: "arr", type: "array", description: "The array" },
       { name: "key", type: "string", description: "Field to average", optional: true }
     ],
-    example: '["array/avg", "@ratings", "score"]'
+    example: '["array/avg", [{"score": 80}, {"score": 90}], "score"]'
   },
   "array/min": {
     module: "array",
@@ -453,7 +453,7 @@ var ARRAY_OPERATORS = {
       { name: "arr", type: "array", description: "The array" },
       { name: "key", type: "string", description: "Field to compare", optional: true }
     ],
-    example: '["array/min", "@products", "price"]'
+    example: '["array/min", [{"price": 3}, {"price": 9}], "price"]'
   },
   "array/max": {
     module: "array",
@@ -467,7 +467,7 @@ var ARRAY_OPERATORS = {
       { name: "arr", type: "array", description: "The array" },
       { name: "key", type: "string", description: "Field to compare", optional: true }
     ],
-    example: '["array/max", "@products", "price"]'
+    example: '["array/max", [{"price": 3}, {"price": 9}], "price"]'
   },
   "array/groupBy": {
     module: "array",
@@ -481,7 +481,7 @@ var ARRAY_OPERATORS = {
       { name: "arr", type: "array", description: "The array" },
       { name: "key", type: "string", description: "Field to group by" }
     ],
-    example: '["array/groupBy", "@orders", "status"]'
+    example: '["array/groupBy", [{"status": "new"}, {"status": "done"}], "status"]'
   },
   "array/partition": {
     module: "array",
@@ -497,7 +497,7 @@ var ARRAY_OPERATORS = {
       { name: "arr", type: "array", description: "The array" },
       { name: "pred", type: "lambda", description: "Predicate function" }
     ],
-    example: '["array/partition", "@items", ["fn", "x", [">", "@x.price", 50]]]'
+    example: '["array/partition", [{"price": 30}, {"price": 80}], ["fn", "x", [">", "@x.price", 50]]]'
   },
   "array/take": {
     module: "array",
@@ -511,7 +511,7 @@ var ARRAY_OPERATORS = {
       { name: "arr", type: "array", description: "The array" },
       { name: "n", type: "number", description: "Number of elements" }
     ],
-    example: '["array/take", "@items", 5]'
+    example: '["array/take", [1, 2, 3, 4, 5, 6, 7], 5]'
   },
   "array/drop": {
     module: "array",
@@ -525,7 +525,7 @@ var ARRAY_OPERATORS = {
       { name: "arr", type: "array", description: "The array" },
       { name: "n", type: "number", description: "Number of elements to skip" }
     ],
-    example: '["array/drop", "@items", 5]'
+    example: '["array/drop", [1, 2, 3, 4, 5, 6, 7], 5]'
   },
   "array/takeLast": {
     module: "array",
@@ -539,7 +539,7 @@ var ARRAY_OPERATORS = {
       { name: "arr", type: "array", description: "The array" },
       { name: "n", type: "number", description: "Number of elements" }
     ],
-    example: '["array/takeLast", "@items", 3]'
+    example: '["array/takeLast", [1, 2, 3, 4, 5], 3]'
   },
   "array/dropLast": {
     module: "array",
@@ -553,7 +553,7 @@ var ARRAY_OPERATORS = {
       { name: "arr", type: "array", description: "The array" },
       { name: "n", type: "number", description: "Number of elements to skip" }
     ],
-    example: '["array/dropLast", "@items", 2]'
+    example: '["array/dropLast", [1, 2, 3, 4, 5], 2]'
   },
   "array/cosine": {
     module: "array",
@@ -567,7 +567,7 @@ var ARRAY_OPERATORS = {
       { name: "a", type: { kind: "array", of: "number" }, description: "First vector" },
       { name: "b", type: { kind: "array", of: "number" }, description: "Second vector" }
     ],
-    example: '["array/cosine", "@entity.answerEmbedding", "@entity.referenceEmbedding"]'
+    example: '["array/cosine", [1, 0], [0, 1]]'
   },
   "array/nearest": {
     module: "array",
@@ -581,7 +581,7 @@ var ARRAY_OPERATORS = {
       { name: "query", type: { kind: "array", of: "number" }, description: "Query vector" },
       { name: "candidates", type: { kind: "array", of: { kind: "array", of: "number" } }, description: "Candidate vectors to search" }
     ],
-    example: '["array/nearest", "@entity.queryEmbedding", "@entity.candidateEmbeddings"]'
+    example: '["array/nearest", [1, 0], [[1, 0], [0, 1]]]'
   }
 };
 function getArrayOperators() {

package/dist/modules/behavior.js

@@ -35,7 +35,7 @@ var BEHAVIOR_OPERATORS = {
       { name: "orbitalName", type: "string", description: "Canonical orbital name to instantiate" },
       { name: "overrides", type: { kind: "object", fields: { linkedEntity: "string", method: "string" }, open: true }, description: "Override surface: linkedEntity, events, config, fields", optional: true }
     ],
-    example: '["behavior/instantiate", "std-ecommerce", "ProductOrbital", { linkedEntity: "Product" }]'
+    example: '["behavior/instantiate", "std-ecommerce", "ProductOrbital", { "linkedEntity": "Product" }]'
   },
   "behavior/call": {
     module: "behavior",
@@ -65,7 +65,7 @@ var BEHAVIOR_OPERATORS = {
       { name: "palette", type: { kind: "object", fields: { topics: { kind: "array", of: "string" }, hints: { kind: "array", of: "string" } } }, description: "Topic-tree palette + primitive hints" },
       { name: "deltaPrompt", type: "string", description: "Per-orbital instruction prompt" }
     ],
-    example: '["lolo/emit-body", "PlayerOrbital", { topics: ["game/2d"] }, "player ship with movement"]'
+    example: '["lolo/emit-body", "PlayerOrbital", { "topics": ["game/2d"] }, "player ship with movement"]'
   },
   "validate/validate": {
     module: "behavior",

package/dist/modules/browser.js

@@ -69,7 +69,7 @@ var BROWSER_OPERATORS = {
       kind: "custom",
       produces: "string"
     },
-    example: '["browser/clipboard-write", "@entity.inviteUrl", { "emit": { "success": "COPIED", "failure": "COPY_DENIED" } }]'
+    example: '["browser/clipboard-write", "https://example.com/invite/abc", { "emit": { "success": "COPIED", "failure": "COPY_DENIED" } }]'
   },
   "browser/push-subscribe": {
     module: "browser",

package/dist/modules/contract.js

@@ -15,7 +15,7 @@ var CONTRACT_OPERATORS = {
       { name: "tensor", type: "tensor", description: "Input tensor" },
       { name: "contract", type: "object", description: "Input contract spec" }
     ],
-    example: '["contract/validate-input", "@payload.input", "@entity.inputContract"]'
+    example: '["contract/validate-input", [0.5, 0.7], {"ranges": {"0": {"min": 0, "max": 1}, "1": {"min": 0, "max": 1}}}]'
   },
   "contract/validate-output": {
     module: "contract",
@@ -29,7 +29,7 @@ var CONTRACT_OPERATORS = {
       { name: "tensor", type: "tensor", description: "Output tensor" },
       { name: "contract", type: "object", description: "Output contract spec" }
     ],
-    example: '["contract/validate-output", "@entity.output", "@entity.outputContract"]'
+    example: '["contract/validate-output", [0.5, 0.7], {"ranges": {"0": {"min": 0, "max": 1}, "1": {"min": 0, "max": 1}}}]'
   },
   "contract/clamp-output": {
     module: "contract",
@@ -43,7 +43,7 @@ var CONTRACT_OPERATORS = {
       { name: "tensor", type: "tensor", description: "Output tensor" },
       { name: "contract", type: "object", description: "Output contract spec" }
     ],
-    example: '["contract/clamp-output", "@entity.output", "@entity.outputContract"]'
+    example: '["contract/clamp-output", [0.5, 1.7], {"ranges": {"0": {"min": 0, "max": 1}, "1": {"min": 0, "max": 1}}}]'
   },
   "contract/violations": {
     module: "contract",
@@ -57,7 +57,7 @@ var CONTRACT_OPERATORS = {
       { name: "tensor", type: "tensor", description: "Tensor to check" },
       { name: "contract", type: "object", description: "Contract spec" }
     ],
-    example: '["contract/violations", "@entity.output", "@entity.outputContract"]'
+    example: '["contract/violations", [0.5, 1.7], {"ranges": {"0": {"min": 0, "max": 1}, "1": {"min": 0, "max": 1}}}]'
   },
   // ============================================================================
   // Conversion
@@ -74,7 +74,7 @@ var CONTRACT_OPERATORS = {
       { name: "entity", type: "object", description: "Entity data" },
       { name: "contract", type: "object", description: "Input contract mapping fields to dims" }
     ],
-    example: '["contract/entity-to-tensor", "@entity", "@entity.inputContract"]'
+    example: '["contract/entity-to-tensor", {"price": 10, "qty": 2}, {"fields": ["price", "qty"]}]'
   },
   "contract/tensor-to-payload": {
     module: "contract",
@@ -88,7 +88,7 @@ var CONTRACT_OPERATORS = {
       { name: "tensor", type: "tensor", description: "Output tensor" },
       { name: "contract", type: "object", description: "Output contract mapping dims to fields" }
     ],
-    example: '["contract/tensor-to-payload", "@entity.output", "@entity.outputContract"]'
+    example: '["contract/tensor-to-payload", [0.5, 0.7], {"fields": ["price", "qty"]}]'
   }
 };
 function getContractOperators() {

package/dist/modules/core.js

@@ -117,7 +117,7 @@ var CORE_OPERATORS = {
       { name: "a", type: ANY, description: "Left operand" },
       { name: "b", type: ANY, description: "Right operand" }
     ],
-    example: '["=", "@entity.status", "active"]'
+    example: '["=", "active", "active"]'
   },
   "==": {
     module: "core",
@@ -131,7 +131,7 @@ var CORE_OPERATORS = {
       { name: "a", type: ANY, description: "Left operand" },
       { name: "b", type: ANY, description: "Right operand" }
     ],
-    example: '["==", "@entity.status", "active"]'
+    example: '["==", "active", "active"]'
   },
   "!=": {
     module: "core",
@@ -145,7 +145,7 @@ var CORE_OPERATORS = {
       { name: "a", type: ANY, description: "Left operand" },
       { name: "b", type: ANY, description: "Right operand" }
     ],
-    example: '["!=", "@entity.id", null]'
+    example: '["!=", 1, null]'
   },
   "<": {
     module: "core",
@@ -159,7 +159,7 @@ var CORE_OPERATORS = {
       { name: "a", type: NUMBER, description: "Left operand" },
       { name: "b", type: NUMBER, description: "Right operand" }
     ],
-    example: '["<", "@entity.health", 10]'
+    example: '["<", 5, 10]'
   },
   ">": {
     module: "core",
@@ -173,7 +173,7 @@ var CORE_OPERATORS = {
       { name: "a", type: NUMBER, description: "Left operand" },
       { name: "b", type: NUMBER, description: "Right operand" }
     ],
-    example: '[">", "@entity.score", 0]'
+    example: '[">", 10, 0]'
   },
   "<=": {
     module: "core",
@@ -187,7 +187,7 @@ var CORE_OPERATORS = {
       { name: "a", type: NUMBER, description: "Left operand" },
       { name: "b", type: NUMBER, description: "Right operand" }
     ],
-    example: '["<=", "@entity.count", 100]'
+    example: '["<=", 100, 100]'
   },
   ">=": {
     module: "core",
@@ -201,7 +201,7 @@ var CORE_OPERATORS = {
       { name: "a", type: NUMBER, description: "Left operand" },
       { name: "b", type: NUMBER, description: "Right operand" }
     ],
-    example: '[">=", "@entity.age", 18]'
+    example: '[">=", 18, 18]'
   },
   // --- logic ------------------------------------------------------------------
   and: {
@@ -214,7 +214,7 @@ var CORE_OPERATORS = {
     returnType: "boolean",
     returnSemantics: "last-truthy-of-args",
     params: [{ name: "...conds", type: BOOLEAN, description: "Boolean expressions to AND" }],
-    example: '["and", ["=", "@entity.active", true], [">", "@entity.score", 0]]'
+    example: '["and", ["=", "active", "active"], [">", 5, 0]]'
   },
   or: {
     module: "core",
@@ -226,7 +226,7 @@ var CORE_OPERATORS = {
     returnType: "boolean",
     returnSemantics: "first-truthy-of-args",
     params: [{ name: "...conds", type: BOOLEAN, description: "Boolean expressions to OR" }],
-    example: '["or", ["=", "@entity.role", "admin"], ["=", "@entity.role", "owner"]]'
+    example: '["or", ["=", "admin", "user"], ["=", "admin", "owner"]]'
   },
   not: {
     module: "core",
@@ -237,7 +237,7 @@ var CORE_OPERATORS = {
     hasSideEffects: false,
     returnType: "boolean",
     params: [{ name: "cond", type: BOOLEAN, description: "Boolean to negate" }],
-    example: '["not", "@entity.disabled"]'
+    example: '["not", false]'
   },
   if: {
     module: "core",
@@ -253,7 +253,7 @@ var CORE_OPERATORS = {
       { name: "then", type: ANY, description: "Value or effect if true" },
       { name: "else", type: ANY, description: "Value or effect if false" }
     ],
-    example: '["if", [">", "@entity.health", 0], "alive", "dead"]'
+    example: '["if", [">", 5, 0], "alive", "dead"]'
   },
   // --- control ----------------------------------------------------------------
   let: {
@@ -361,7 +361,7 @@ var CORE_OPERATORS = {
       { name: "event", type: EVENT_KEY, description: "Event key" },
       { name: "payload", type: ENTITY_REF, description: "Optional payload", optional: true }
     ],
-    example: '["emit", "PLAYER_DIED", { "playerId": "@entity.id" }]',
+    example: '["emit", "PLAYER_DIED", { "playerId": "p1" }]',
     effect: {
       kind: "emit",
       produces: {
@@ -396,7 +396,7 @@ var CORE_OPERATORS = {
         optional: true
       }
     ],
-    example: '["persist", "create", "Task", { "title": "@payload.title" }, { "emit": { "success": "TASK_CREATED" } }]',
+    example: '["persist", "create", "Task", { "title": "Buy milk" }, { "emit": { "success": "TASK_CREATED" } }]',
     effect: {
       kind: "persist",
       // Action-discriminated union. The compiler narrows at the call site
@@ -450,7 +450,7 @@ var CORE_OPERATORS = {
         optional: true
       }
     ],
-    example: '["navigate", "/tasks/:id", { "id": "@entity.id" }]',
+    example: '["navigate", "/tasks/:id", { "id": "t1" }]',
     effect: { kind: "navigate" }
   },
   "navigate-back": {
@@ -507,7 +507,7 @@ var CORE_OPERATORS = {
         optional: true
       }
     ],
-    example: '["spawn", "Bullet", { "x": "@entity.x", "y": "@entity.y" }]',
+    example: '["spawn", "Bullet", { "x": 10, "y": 20 }]',
     effect: { kind: "spawn" }
   },
   despawn: {
@@ -552,18 +552,22 @@ var CORE_OPERATORS = {
         optional: true
       }
     ],
-    example: '["fetch", "Task", { "id": "@payload.taskId", "emit": { "success": "TASK_LOADED" } }]',
+    example: '["fetch", "Task", { "id": "t1", "emit": { "success": "TASK_LOADED" } }]',
     effect: {
       kind: "fetch",
-      // Call-site-discriminated union: options.id present -> single entity;
-      // otherwise -> array of entity. The compiler narrows at the call site
-      // when checking emit.success against the declared event payload.
       produces: {
-        kind: "union",
-        of: [
-          { kind: "entity" },
-          { kind: "array", of: { kind: "entity" } }
-        ]
+        kind: "object",
+        fields: {
+          data: {
+            kind: "union",
+            of: [
+              { kind: "entity" },
+              { kind: "array", of: { kind: "entity" } }
+            ]
+          },
+          totalCount: "number"
+        },
+        open: false
       }
     }
   },
@@ -615,7 +619,7 @@ var CORE_OPERATORS = {
         optional: true
       }
     ],
-    example: '["send-server", "CHAT_MESSAGE", { "text": "@input.text" }]',
+    example: '["send-server", "CHAT_MESSAGE", { "text": "hello" }]',
     effect: { kind: "send-server" }
   },
   ref: {
@@ -647,14 +651,21 @@ var CORE_OPERATORS = {
     example: '["ref", "Task"]',
     effect: {
       kind: "ref",
-      // Same call-site shape as fetch. Kept for the V2 transition period;
+      // Same wrapper fetch emits. Kept for the V2 transition period;
       // scheduled for deprecation in a later phase (see Almadar_Entity_V2_Plan.md).
       produces: {
-        kind: "union",
-        of: [
-          { kind: "entity" },
-          { kind: "array", of: { kind: "entity" } }
-        ]
+        kind: "object",
+        fields: {
+          data: {
+            kind: "union",
+            of: [
+              { kind: "entity" },
+              { kind: "array", of: { kind: "entity" } }
+            ]
+          },
+          totalCount: "number"
+        },
+        open: false
       }
     }
   },
@@ -682,7 +693,7 @@ var CORE_OPERATORS = {
         optional: true
       }
     ],
-    example: '["call-service", "llm", "generate", { "userPrompt": "@entity.inputText" }, { "emit": { "success": "LlmCompleted", "failure": "LlmFailed" } }]',
+    example: '["call-service", "llm", "generate", { "userPrompt": "Hello" }, { "emit": { "success": "LlmCompleted", "failure": "LlmFailed" } }]',
     effect: {
       kind: "call-service",
       // TODO(entity-v2): narrow to the declared service return type once

package/dist/modules/data.js

@@ -15,7 +15,7 @@ var DATA_OPERATORS = {
       { name: "entities", type: "array", description: "Entity collection" },
       { name: "contracts", type: "object", description: "Input/output contract pair" }
     ],
-    example: '["data/dataset", "@entity.trainingData", "@entity.contracts"]'
+    example: '["data/dataset", [{"x": 1, "y": 2}], {"input": {"fields": ["x"]}, "output": {"fields": ["y"]}}]'
   },
   "data/dataloader": {
     module: "data",
@@ -29,7 +29,7 @@ var DATA_OPERATORS = {
       { name: "dataset", type: "object", description: "Dataset" },
       { name: "config", type: "object", description: "Config with batch_size, shuffle, etc." }
     ],
-    example: '["data/dataloader", "@entity.dataset", { "batch-size": 32, "shuffle": true }]'
+    example: '["data/dataloader", ["data/dataset", [[1, 2], [3, 4], [5, 6]], {}], { "batch-size": 2, "shuffle": true }]'
   },
   "data/split": {
     module: "data",
@@ -43,7 +43,7 @@ var DATA_OPERATORS = {
       { name: "dataset", type: "object", description: "Dataset" },
       { name: "config", type: "object", description: "Split config, e.g. { trainRatio: 0.8 }" }
     ],
-    example: '["data/split", "@entity.dataset", { "trainRatio": 0.8 }]'
+    example: '["data/split", ["data/dataset", [1, 2, 3, 4, 5], {}], { "trainRatio": 0.8 }]'
   },
   // ============================================================================
   // Preprocessing
@@ -60,7 +60,7 @@ var DATA_OPERATORS = {
       { name: "tensor", type: "tensor", description: "Feature tensor" },
       { name: "config", type: "object", description: "Normalization config (method, per_dim, etc.)" }
     ],
-    example: '["data/normalize", "@entity.features", { "method": "standard" }]'
+    example: '["data/normalize", [[1, 2], [3, 4]], { "method": "standard" }]'
   },
   "data/augment": {
     module: "data",
@@ -74,7 +74,7 @@ var DATA_OPERATORS = {
       { name: "dataset", type: "object", description: "Dataset" },
       { name: "config", type: "object", description: "Augmentation config" }
     ],
-    example: '["data/augment", "@entity.dataset", { "flip": true, "rotate": 15 }]'
+    example: '["data/augment", [[1.0, 2.0], [3.0, 4.0]], { "flip": true, "rotate": 15 }]'
   },
   // ============================================================================
   // Tokenization & Padding
@@ -91,7 +91,7 @@ var DATA_OPERATORS = {
       { name: "text", type: "string", description: "Text to tokenize" },
       { name: "config", type: "object", description: "Tokenizer config (method, vocab_size, max_length)" }
     ],
-    example: '["data/tokenize", "@entity.text", { "method": "bpe", "max-length": 512 }]'
+    example: '["data/tokenize", "hello world", { "method": "bpe", "max-length": 512 }]'
   },
   "data/pad": {
     module: "data",
@@ -105,7 +105,7 @@ var DATA_OPERATORS = {
       { name: "sequences", type: "array", description: "List of token sequences" },
       { name: "config", type: "object", description: "Padding config (max_length, pad_value)" }
     ],
-    example: '["data/pad", "@entity.sequences", { "max-length": 512, "pad-value": 0 }]'
+    example: '["data/pad", [[1, 2, 3], [4, 5]], { "max-length": 4, "pad-value": 0 }]'
   }
 };
 function getDataOperators() {