@almadar/std 3.2.3 → 3.3.5

package/dist/modules/index.js

@@ -2243,7 +2243,7 @@ function getAsyncOperators() {
 var NN_OPERATORS = {
   "nn/sequential": {
     module: "nn",
-    category: "std-nn",
+    category: "ml-arch",
     minArity: 1,
     maxArity: null,
     description: "Create a sequential neural network from layers",
@@ -2256,7 +2256,7 @@ var NN_OPERATORS = {
   },
   "nn/linear": {
     module: "nn",
-    category: "std-nn",
+    category: "ml-arch",
     minArity: 2,
     maxArity: 2,
     description: "Fully connected linear layer (output = input * weights + bias)",
@@ -2270,7 +2270,7 @@ var NN_OPERATORS = {
   },
   "nn/relu": {
     module: "nn",
-    category: "std-nn",
+    category: "ml-arch",
     minArity: 0,
     maxArity: 0,
     description: "ReLU activation function: max(0, x)",
@@ -2281,7 +2281,7 @@ var NN_OPERATORS = {
   },
   "nn/tanh": {
     module: "nn",
-    category: "std-nn",
+    category: "ml-arch",
     minArity: 0,
     maxArity: 0,
     description: "Tanh activation function: (e^x - e^-x) / (e^x + e^-x)",
@@ -2292,7 +2292,7 @@ var NN_OPERATORS = {
   },
   "nn/sigmoid": {
     module: "nn",
-    category: "std-nn",
+    category: "ml-arch",
     minArity: 0,
     maxArity: 0,
     description: "Sigmoid activation function: 1 / (1 + e^-x)",
@@ -2303,7 +2303,7 @@ var NN_OPERATORS = {
   },
   "nn/softmax": {
     module: "nn",
-    category: "std-nn",
+    category: "ml-arch",
     minArity: 0,
     maxArity: 1,
     description: "Softmax activation function (normalizes to probability distribution)",
@@ -2316,7 +2316,7 @@ var NN_OPERATORS = {
   },
   "nn/dropout": {
     module: "nn",
-    category: "std-nn",
+    category: "ml-arch",
     minArity: 0,
     maxArity: 1,
     description: "Dropout layer for regularization (randomly zeros elements during training)",
@@ -2329,7 +2329,7 @@ var NN_OPERATORS = {
   },
   "nn/batchnorm": {
     module: "nn",
-    category: "std-nn",
+    category: "ml-arch",
     minArity: 1,
     maxArity: 1,
     description: "Batch normalization layer",
@@ -2342,7 +2342,7 @@ var NN_OPERATORS = {
   },
   "nn/layernorm": {
     module: "nn",
-    category: "std-nn",
+    category: "ml-arch",
     minArity: 1,
     maxArity: 1,
     description: "Layer normalization",
@@ -2355,7 +2355,7 @@ var NN_OPERATORS = {
   },
   "nn/forward": {
     module: "nn",
-    category: "std-nn",
+    category: "ml-effect",
     minArity: 2,
     maxArity: 2,
     description: "Execute forward pass through network",
@@ -2369,7 +2369,7 @@ var NN_OPERATORS = {
   },
   "nn/getWeights": {
     module: "nn",
-    category: "std-nn",
+    category: "ml-arch",
     minArity: 1,
     maxArity: 1,
     description: "Get network weights as a flat tensor",
@@ -2382,7 +2382,7 @@ var NN_OPERATORS = {
   },
   "nn/setWeights": {
     module: "nn",
-    category: "std-nn",
+    category: "ml-arch",
     minArity: 2,
     maxArity: 2,
     description: "Set network weights from a flat tensor",
@@ -2396,7 +2396,7 @@ var NN_OPERATORS = {
   },
   "nn/paramCount": {
     module: "nn",
-    category: "std-nn",
+    category: "ml-arch",
     minArity: 1,
     maxArity: 1,
     description: "Get total number of trainable parameters",
@@ -2409,7 +2409,7 @@ var NN_OPERATORS = {
   },
   "nn/clone": {
     module: "nn",
-    category: "std-nn",
+    category: "ml-arch",
     minArity: 1,
     maxArity: 1,
     description: "Create a deep copy of the network with same weights",
@@ -2432,7 +2432,7 @@ var TENSOR_OPERATORS = {
   // ============================================================================
   "tensor/from": {
     module: "tensor",
-    category: "std-tensor",
+    category: "ml-tensor",
     minArity: 1,
     maxArity: 1,
     description: "Create tensor from array",
@@ -2445,7 +2445,7 @@ var TENSOR_OPERATORS = {
   },
   "tensor/zeros": {
     module: "tensor",
-    category: "std-tensor",
+    category: "ml-tensor",
     minArity: 1,
     maxArity: 1,
     description: "Create tensor filled with zeros",
@@ -2458,7 +2458,7 @@ var TENSOR_OPERATORS = {
   },
   "tensor/ones": {
     module: "tensor",
-    category: "std-tensor",
+    category: "ml-tensor",
     minArity: 1,
     maxArity: 1,
     description: "Create tensor filled with ones",
@@ -2471,7 +2471,7 @@ var TENSOR_OPERATORS = {
   },
   "tensor/rand": {
     module: "tensor",
-    category: "std-tensor",
+    category: "ml-tensor",
     minArity: 1,
     maxArity: 1,
     description: "Create tensor with random values in [0, 1)",
@@ -2484,7 +2484,7 @@ var TENSOR_OPERATORS = {
   },
   "tensor/randn": {
     module: "tensor",
-    category: "std-tensor",
+    category: "ml-tensor",
     minArity: 1,
     maxArity: 1,
     description: "Create tensor with random values from standard normal distribution",
@@ -2500,7 +2500,7 @@ var TENSOR_OPERATORS = {
   // ============================================================================
   "tensor/shape": {
     module: "tensor",
-    category: "std-tensor",
+    category: "ml-tensor",
     minArity: 1,
     maxArity: 1,
     description: "Get tensor shape as array",
@@ -2513,7 +2513,7 @@ var TENSOR_OPERATORS = {
   },
   "tensor/get": {
     module: "tensor",
-    category: "std-tensor",
+    category: "ml-tensor",
     minArity: 2,
     maxArity: 2,
     description: "Get element at index",
@@ -2527,7 +2527,7 @@ var TENSOR_OPERATORS = {
   },
   "tensor/slice": {
     module: "tensor",
-    category: "std-tensor",
+    category: "ml-tensor",
     minArity: 3,
     maxArity: 3,
     description: "Get slice of tensor",
@@ -2542,7 +2542,7 @@ var TENSOR_OPERATORS = {
   },
   "tensor/reshape": {
     module: "tensor",
-    category: "std-tensor",
+    category: "ml-tensor",
     minArity: 2,
     maxArity: 2,
     description: "Reshape tensor to new shape (total elements must match)",
@@ -2556,7 +2556,7 @@ var TENSOR_OPERATORS = {
   },
   "tensor/flatten": {
     module: "tensor",
-    category: "std-tensor",
+    category: "ml-tensor",
     minArity: 1,
     maxArity: 1,
     description: "Flatten tensor to 1D",
@@ -2572,7 +2572,7 @@ var TENSOR_OPERATORS = {
   // ============================================================================
   "tensor/add": {
     module: "tensor",
-    category: "std-tensor",
+    category: "ml-tensor",
     minArity: 2,
     maxArity: 2,
     description: "Element-wise addition",
@@ -2586,7 +2586,7 @@ var TENSOR_OPERATORS = {
   },
   "tensor/sub": {
     module: "tensor",
-    category: "std-tensor",
+    category: "ml-tensor",
     minArity: 2,
     maxArity: 2,
     description: "Element-wise subtraction",
@@ -2600,7 +2600,7 @@ var TENSOR_OPERATORS = {
   },
   "tensor/mul": {
     module: "tensor",
-    category: "std-tensor",
+    category: "ml-tensor",
     minArity: 2,
     maxArity: 2,
     description: "Element-wise multiplication",
@@ -2614,7 +2614,7 @@ var TENSOR_OPERATORS = {
   },
   "tensor/div": {
     module: "tensor",
-    category: "std-tensor",
+    category: "ml-tensor",
     minArity: 2,
     maxArity: 2,
     description: "Element-wise division",
@@ -2628,7 +2628,7 @@ var TENSOR_OPERATORS = {
   },
   "tensor/matmul": {
     module: "tensor",
-    category: "std-tensor",
+    category: "ml-tensor",
     minArity: 2,
     maxArity: 2,
     description: "Matrix multiplication",
@@ -2642,7 +2642,7 @@ var TENSOR_OPERATORS = {
   },
   "tensor/dot": {
     module: "tensor",
-    category: "std-tensor",
+    category: "ml-tensor",
     minArity: 2,
     maxArity: 2,
     description: "Dot product of two 1D tensors",
@@ -2659,7 +2659,7 @@ var TENSOR_OPERATORS = {
   // ============================================================================
   "tensor/sum": {
     module: "tensor",
-    category: "std-tensor",
+    category: "ml-tensor",
     minArity: 1,
     maxArity: 2,
     description: "Sum of tensor elements",
@@ -2673,7 +2673,7 @@ var TENSOR_OPERATORS = {
   },
   "tensor/mean": {
     module: "tensor",
-    category: "std-tensor",
+    category: "ml-tensor",
     minArity: 1,
     maxArity: 2,
     description: "Mean of tensor elements",
@@ -2687,7 +2687,7 @@ var TENSOR_OPERATORS = {
   },
   "tensor/max": {
     module: "tensor",
-    category: "std-tensor",
+    category: "ml-tensor",
     minArity: 1,
     maxArity: 2,
     description: "Maximum value in tensor",
@@ -2701,7 +2701,7 @@ var TENSOR_OPERATORS = {
   },
   "tensor/min": {
     module: "tensor",
-    category: "std-tensor",
+    category: "ml-tensor",
     minArity: 1,
     maxArity: 2,
     description: "Minimum value in tensor",
@@ -2715,7 +2715,7 @@ var TENSOR_OPERATORS = {
   },
   "tensor/argmax": {
     module: "tensor",
-    category: "std-tensor",
+    category: "ml-tensor",
     minArity: 1,
     maxArity: 2,
     description: "Index of maximum value",
@@ -2729,7 +2729,7 @@ var TENSOR_OPERATORS = {
   },
   "tensor/norm": {
     module: "tensor",
-    category: "std-tensor",
+    category: "ml-tensor",
     minArity: 1,
     maxArity: 2,
     description: "L2 norm of tensor",
@@ -2746,7 +2746,7 @@ var TENSOR_OPERATORS = {
   // ============================================================================
   "tensor/allInRange": {
     module: "tensor",
-    category: "std-tensor",
+    category: "ml-tensor",
     minArity: 2,
     maxArity: 2,
     description: "Check if all elements are within range [min, max]",
@@ -2760,7 +2760,7 @@ var TENSOR_OPERATORS = {
   },
   "tensor/outOfRangeIndices": {
     module: "tensor",
-    category: "std-tensor",
+    category: "ml-tensor",
     minArity: 2,
     maxArity: 2,
     description: "Get indices of elements outside range",
@@ -2774,7 +2774,7 @@ var TENSOR_OPERATORS = {
   },
   "tensor/clamp": {
     module: "tensor",
-    category: "std-tensor",
+    category: "ml-tensor",
     minArity: 3,
     maxArity: 3,
     description: "Clamp all elements to range [min, max]",
@@ -2789,7 +2789,7 @@ var TENSOR_OPERATORS = {
   },
   "tensor/clampPerDim": {
     module: "tensor",
-    category: "std-tensor",
+    category: "ml-tensor",
     minArity: 2,
     maxArity: 2,
     description: "Clamp each dimension to its specified range",
@@ -2803,7 +2803,7 @@ var TENSOR_OPERATORS = {
   },
   "tensor/outOfRangeDims": {
     module: "tensor",
-    category: "std-tensor",
+    category: "ml-tensor",
     minArity: 2,
     maxArity: 2,
     description: "Get dimensions that exceed their specified ranges",
@@ -2820,7 +2820,7 @@ var TENSOR_OPERATORS = {
   // ============================================================================
   "tensor/toArray": {
     module: "tensor",
-    category: "std-tensor",
+    category: "ml-tensor",
     minArity: 1,
     maxArity: 1,
     description: "Convert tensor to nested array",
@@ -2833,7 +2833,7 @@ var TENSOR_OPERATORS = {
   },
   "tensor/toList": {
     module: "tensor",
-    category: "std-tensor",
+    category: "ml-tensor",
     minArity: 1,
     maxArity: 1,
     description: "Convert 1D tensor to flat array",
@@ -2856,7 +2856,7 @@ var TRAIN_OPERATORS = {
   // ============================================================================
   "train/loop": {
     module: "train",
-    category: "std-train",
+    category: "ml-effect",
     minArity: 3,
     maxArity: 3,
     description: "Execute training loop with constraints",
@@ -2871,7 +2871,7 @@ var TRAIN_OPERATORS = {
   },
   "train/step": {
     module: "train",
-    category: "std-train",
+    category: "ml-effect",
     minArity: 4,
     maxArity: 4,
     description: "Execute single training step (forward, loss, backward, update)",
@@ -2890,7 +2890,7 @@ var TRAIN_OPERATORS = {
   // ============================================================================
   "train/validate": {
     module: "train",
-    category: "std-train",
+    category: "ml-effect",
     minArity: 2,
     maxArity: 2,
     description: "Validate model on test cases, returns pass/fail metrics",
@@ -2904,7 +2904,7 @@ var TRAIN_OPERATORS = {
   },
   "train/checkRegression": {
     module: "train",
-    category: "std-train",
+    category: "ml-effect",
     minArity: 3,
     maxArity: 3,
     description: "Check if new model regresses on required invariants",
@@ -2922,7 +2922,7 @@ var TRAIN_OPERATORS = {
   // ============================================================================
   "train/checkConstraints": {
     module: "train",
-    category: "std-train",
+    category: "ml-effect",
     minArity: 2,
     maxArity: 2,
     description: "Check if network weights satisfy all constraints",
@@ -2936,7 +2936,7 @@ var TRAIN_OPERATORS = {
   },
   "train/checkWeightMagnitude": {
     module: "train",
-    category: "std-train",
+    category: "ml-effect",
     minArity: 2,
     maxArity: 2,
     description: "Check if all weights are within magnitude limit",
@@ -2950,7 +2950,7 @@ var TRAIN_OPERATORS = {
   },
   "train/checkForbiddenOutputs": {
     module: "train",
-    category: "std-train",
+    category: "ml-effect",
     minArity: 3,
     maxArity: 3,
     description: "Check if model produces outputs in forbidden regions",
@@ -2968,7 +2968,7 @@ var TRAIN_OPERATORS = {
   // ============================================================================
   "train/clipGradients": {
     module: "train",
-    category: "std-train",
+    category: "ml-effect",
     minArity: 2,
     maxArity: 2,
     description: "Clip gradients to max norm (modifies in place)",
@@ -2982,7 +2982,7 @@ var TRAIN_OPERATORS = {
   },
   "train/getGradientNorm": {
     module: "train",
-    category: "std-train",
+    category: "ml-effect",
     minArity: 1,
     maxArity: 1,
     description: "Get current gradient norm",
@@ -2998,7 +2998,7 @@ var TRAIN_OPERATORS = {
   // ============================================================================
   "train/clipWeights": {
     module: "train",
-    category: "std-train",
+    category: "ml-effect",
     minArity: 2,
     maxArity: 2,
     description: "Clip weights to max magnitude (modifies in place)",
@@ -3012,7 +3012,7 @@ var TRAIN_OPERATORS = {
   },
   "train/getMaxWeightMagnitude": {
     module: "train",
-    category: "std-train",
+    category: "ml-effect",
     minArity: 1,
     maxArity: 1,
     description: "Get maximum weight magnitude in network",
@@ -3028,7 +3028,7 @@ var TRAIN_OPERATORS = {
   // ============================================================================
   "train/mse": {
     module: "train",
-    category: "std-train",
+    category: "ml-effect",
     minArity: 2,
     maxArity: 2,
     description: "Mean squared error loss",
@@ -3042,7 +3042,7 @@ var TRAIN_OPERATORS = {
   },
   "train/crossEntropy": {
     module: "train",
-    category: "std-train",
+    category: "ml-effect",
     minArity: 2,
     maxArity: 2,
     description: "Cross-entropy loss for classification",
@@ -3056,7 +3056,7 @@ var TRAIN_OPERATORS = {
   },
   "train/huber": {
     module: "train",
-    category: "std-train",
+    category: "ml-effect",
     minArity: 2,
     maxArity: 3,
     description: "Huber loss (smooth L1, robust to outliers)",
@@ -3074,7 +3074,7 @@ var TRAIN_OPERATORS = {
   // ============================================================================
   "train/sgd": {
     module: "train",
-    category: "std-train",
+    category: "ml-effect",
     minArity: 2,
     maxArity: 3,
     description: "Stochastic gradient descent optimizer step",
@@ -3089,7 +3089,7 @@ var TRAIN_OPERATORS = {
   },
   "train/adam": {
     module: "train",
-    category: "std-train",
+    category: "ml-effect",
     minArity: 2,
     maxArity: 4,
     description: "Adam optimizer step",
@@ -3108,7 +3108,7 @@ var TRAIN_OPERATORS = {
   // ============================================================================
   "train/sampleBatch": {
     module: "train",
-    category: "std-train",
+    category: "ml-effect",
     minArity: 2,
     maxArity: 2,
     description: "Sample random batch from experience buffer",
@@ -3122,7 +3122,7 @@ var TRAIN_OPERATORS = {
   },
   "train/computeReturns": {
     module: "train",
-    category: "std-train",
+    category: "ml-effect",
     minArity: 2,
     maxArity: 2,
     description: "Compute discounted returns from rewards",
@@ -3136,7 +3136,7 @@ var TRAIN_OPERATORS = {
   },
   "train/computeAdvantages": {
     module: "train",
-    category: "std-train",
+    category: "ml-effect",
     minArity: 3,
     maxArity: 3,
     description: "Compute GAE advantages for policy gradient",
@@ -3154,6 +3154,423 @@ function getTrainOperators() {
   return Object.keys(TRAIN_OPERATORS);
 }
 
+// modules/graph.ts
+var GRAPH_OPERATORS = {
+  // ============================================================================
+  // Construction
+  // ============================================================================
+  "graph/from-entities": {
+    module: "graph",
+    category: "ml-graph",
+    minArity: 1,
+    maxArity: 1,
+    description: "Build PyG graph from entity collections",
+    hasSideEffects: false,
+    returnType: "graph",
+    params: [
+      { name: "config", type: "object", description: "Graph construction config (nodes, edges, node-features, edge-features, directed)" }
+    ],
+    example: '["graph/from-entities", { "nodes": "User", "edges": "Follows" }]'
+  },
+  "graph/from-adjacency": {
+    module: "graph",
+    category: "ml-graph",
+    minArity: 2,
+    maxArity: 2,
+    description: "Build graph from adjacency matrix and features",
+    hasSideEffects: false,
+    returnType: "graph",
+    params: [
+      { name: "adjacency", type: "tensor", description: "Adjacency matrix" },
+      { name: "features", type: "tensor", description: "Node feature matrix" }
+    ],
+    example: '["graph/from-adjacency", "@entity.adj", "@entity.features"]'
+  },
+  "graph/from-edge-list": {
+    module: "graph",
+    category: "ml-graph",
+    minArity: 2,
+    maxArity: 2,
+    description: "Build graph from edge list and features",
+    hasSideEffects: false,
+    returnType: "graph",
+    params: [
+      { name: "edges", type: "tensor", description: "Edge index tensor [2, num_edges]" },
+      { name: "features", type: "tensor", description: "Node feature matrix" }
+    ],
+    example: '["graph/from-edge-list", "@entity.edges", "@entity.features"]'
+  },
+  // ============================================================================
+  // Transforms
+  // ============================================================================
+  "graph/add-self-loops": {
+    module: "graph",
+    category: "ml-graph",
+    minArity: 1,
+    maxArity: 1,
+    description: "Add self-loop edges to graph",
+    hasSideEffects: false,
+    returnType: "graph",
+    params: [
+      { name: "graph", type: "graph", description: "Input graph" }
+    ],
+    example: '["graph/add-self-loops", "@entity.graph"]'
+  },
+  "graph/to-undirected": {
+    module: "graph",
+    category: "ml-graph",
+    minArity: 1,
+    maxArity: 1,
+    description: "Convert directed graph to undirected",
+    hasSideEffects: false,
+    returnType: "graph",
+    params: [
+      { name: "graph", type: "graph", description: "Input graph" }
+    ],
+    example: '["graph/to-undirected", "@entity.graph"]'
+  },
+  "graph/subgraph": {
+    module: "graph",
+    category: "ml-graph",
+    minArity: 2,
+    maxArity: 2,
+    description: "Extract subgraph by node mask",
+    hasSideEffects: false,
+    returnType: "graph",
+    params: [
+      { name: "graph", type: "graph", description: "Input graph" },
+      { name: "mask", type: "tensor", description: "Boolean node mask" }
+    ],
+    example: '["graph/subgraph", "@entity.graph", "@entity.mask"]'
+  },
+  "graph/k-hop": {
+    module: "graph",
+    category: "ml-graph",
+    minArity: 3,
+    maxArity: 3,
+    description: "K-hop neighborhood subgraph",
+    hasSideEffects: false,
+    returnType: "graph",
+    params: [
+      { name: "graph", type: "graph", description: "Input graph" },
+      { name: "node", type: "number", description: "Center node index" },
+      { name: "k", type: "number", description: "Number of hops" }
+    ],
+    example: '["graph/k-hop", "@entity.graph", 0, 2]'
+  },
+  // ============================================================================
+  // Accessors
+  // ============================================================================
+  "graph/node-features": {
+    module: "graph",
+    category: "ml-graph",
+    minArity: 1,
+    maxArity: 1,
+    description: "Get node feature matrix",
+    hasSideEffects: false,
+    returnType: "tensor",
+    params: [
+      { name: "graph", type: "graph", description: "Input graph" }
+    ],
+    example: '["graph/node-features", "@entity.graph"]'
+  },
+  "graph/edge-index": {
+    module: "graph",
+    category: "ml-graph",
+    minArity: 1,
+    maxArity: 1,
+    description: "Get edge index tensor",
+    hasSideEffects: false,
+    returnType: "tensor",
+    params: [
+      { name: "graph", type: "graph", description: "Input graph" }
+    ],
+    example: '["graph/edge-index", "@entity.graph"]'
+  },
+  "graph/edge-features": {
+    module: "graph",
+    category: "ml-graph",
+    minArity: 1,
+    maxArity: 1,
+    description: "Get edge feature matrix",
+    hasSideEffects: false,
+    returnType: "tensor",
+    params: [
+      { name: "graph", type: "graph", description: "Input graph" }
+    ],
+    example: '["graph/edge-features", "@entity.graph"]'
+  },
+  "graph/num-nodes": {
+    module: "graph",
+    category: "ml-graph",
+    minArity: 1,
+    maxArity: 1,
+    description: "Get node count",
+    hasSideEffects: false,
+    returnType: "number",
+    params: [
+      { name: "graph", type: "graph", description: "Input graph" }
+    ],
+    example: '["graph/num-nodes", "@entity.graph"]'
+  },
+  "graph/num-edges": {
+    module: "graph",
+    category: "ml-graph",
+    minArity: 1,
+    maxArity: 1,
+    description: "Get edge count",
+    hasSideEffects: false,
+    returnType: "number",
+    params: [
+      { name: "graph", type: "graph", description: "Input graph" }
+    ],
+    example: '["graph/num-edges", "@entity.graph"]'
+  },
+  "graph/degree": {
+    module: "graph",
+    category: "ml-graph",
+    minArity: 1,
+    maxArity: 1,
+    description: "Get node degree tensor",
+    hasSideEffects: false,
+    returnType: "tensor",
+    params: [
+      { name: "graph", type: "graph", description: "Input graph" }
+    ],
+    example: '["graph/degree", "@entity.graph"]'
+  },
+  // ============================================================================
+  // Batching
+  // ============================================================================
+  "graph/batch": {
+    module: "graph",
+    category: "ml-graph",
+    minArity: 1,
+    maxArity: 1,
+    description: "Batch multiple graphs into one",
+    hasSideEffects: false,
+    returnType: "graph",
+    params: [
+      { name: "graphs", type: "array", description: "List of graphs" }
+    ],
+    example: '["graph/batch", "@entity.graphs"]'
+  }
+};
+function getGraphOperators() {
+  return Object.keys(GRAPH_OPERATORS);
+}
+
+// modules/contract.ts
+var CONTRACT_OPERATORS = {
+  // ============================================================================
+  // Validation
+  // ============================================================================
+  "contract/validate-input": {
+    module: "contract",
+    category: "ml-contract",
+    minArity: 2,
+    maxArity: 2,
+    description: "Validate tensor against input contract",
+    hasSideEffects: false,
+    returnType: "boolean",
+    params: [
+      { name: "tensor", type: "tensor", description: "Input tensor" },
+      { name: "contract", type: "object", description: "Input contract spec" }
+    ],
+    example: '["contract/validate-input", "@payload.input", "@entity.inputContract"]'
+  },
+  "contract/validate-output": {
+    module: "contract",
+    category: "ml-contract",
+    minArity: 2,
+    maxArity: 2,
+    description: "Validate tensor against output contract",
+    hasSideEffects: false,
+    returnType: "boolean",
+    params: [
+      { name: "tensor", type: "tensor", description: "Output tensor" },
+      { name: "contract", type: "object", description: "Output contract spec" }
+    ],
+    example: '["contract/validate-output", "@entity.output", "@entity.outputContract"]'
+  },
+  "contract/clamp-output": {
+    module: "contract",
+    category: "ml-contract",
+    minArity: 2,
+    maxArity: 2,
+    description: "Clamp output tensor to contract ranges",
+    hasSideEffects: false,
+    returnType: "tensor",
+    params: [
+      { name: "tensor", type: "tensor", description: "Output tensor" },
+      { name: "contract", type: "object", description: "Output contract spec" }
+    ],
+    example: '["contract/clamp-output", "@entity.output", "@entity.outputContract"]'
+  },
+  "contract/violations": {
+    module: "contract",
+    category: "ml-contract",
+    minArity: 2,
+    maxArity: 2,
+    description: "List contract violations",
+    hasSideEffects: false,
+    returnType: "array",
+    params: [
+      { name: "tensor", type: "tensor", description: "Tensor to check" },
+      { name: "contract", type: "object", description: "Contract spec" }
+    ],
+    example: '["contract/violations", "@entity.output", "@entity.outputContract"]'
+  },
+  // ============================================================================
+  // Conversion
+  // ============================================================================
+  "contract/entity-to-tensor": {
+    module: "contract",
+    category: "ml-contract",
+    minArity: 2,
+    maxArity: 2,
+    description: "Convert entity fields to tensor via contract",
+    hasSideEffects: false,
+    returnType: "tensor",
+    params: [
+      { 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"]'
+  },
+  "contract/tensor-to-payload": {
+    module: "contract",
+    category: "ml-contract",
+    minArity: 2,
+    maxArity: 2,
+    description: "Convert output tensor to event payload via contract",
+    hasSideEffects: false,
+    returnType: "object",
+    params: [
+      { 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"]'
+  }
+};
+function getContractOperators() {
+  return Object.keys(CONTRACT_OPERATORS);
+}
+
+// modules/data.ts
+var DATA_OPERATORS = {
+  // ============================================================================
+  // Dataset Creation
+  // ============================================================================
+  "data/dataset": {
+    module: "data",
+    category: "ml-data",
+    minArity: 2,
+    maxArity: 2,
+    description: "Create dataset from entity collection and contracts",
+    hasSideEffects: false,
+    returnType: "object",
+    params: [
+      { name: "entities", type: "array", description: "Entity collection" },
+      { name: "contracts", type: "object", description: "Input/output contract pair" }
+    ],
+    example: '["data/dataset", "@entity.trainingData", "@entity.contracts"]'
+  },
+  "data/dataloader": {
+    module: "data",
+    category: "ml-data",
+    minArity: 2,
+    maxArity: 2,
+    description: "Create batched dataloader from dataset",
+    hasSideEffects: false,
+    returnType: "object",
+    params: [
+      { 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 }]'
+  },
+  "data/split": {
+    module: "data",
+    category: "ml-data",
+    minArity: 2,
+    maxArity: 2,
+    description: "Train/val/test split",
+    hasSideEffects: false,
+    returnType: "array",
+    params: [
+      { name: "dataset", type: "object", description: "Dataset" },
+      { name: "ratios", type: "array", description: "Split ratios e.g. [0.8, 0.1, 0.1]" }
+    ],
+    example: '["data/split", "@entity.dataset", [0.8, 0.1, 0.1]]'
+  },
+  // ============================================================================
+  // Preprocessing
+  // ============================================================================
+  "data/normalize": {
+    module: "data",
+    category: "ml-data",
+    minArity: 2,
+    maxArity: 2,
+    description: "Normalize features (mean/std or min/max)",
+    hasSideEffects: false,
+    returnType: "tensor",
+    params: [
+      { 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" }]'
+  },
+  "data/augment": {
+    module: "data",
+    category: "ml-data",
+    minArity: 2,
+    maxArity: 2,
+    description: "Apply data augmentation",
+    hasSideEffects: false,
+    returnType: "object",
+    params: [
+      { name: "dataset", type: "object", description: "Dataset" },
+      { name: "config", type: "object", description: "Augmentation config" }
+    ],
+    example: '["data/augment", "@entity.dataset", { "flip": true, "rotate": 15 }]'
+  },
+  // ============================================================================
+  // Tokenization & Padding
+  // ============================================================================
+  "data/tokenize": {
+    module: "data",
+    category: "ml-data",
+    minArity: 2,
+    maxArity: 2,
+    description: "Tokenize text fields",
+    hasSideEffects: false,
+    returnType: "tensor",
+    params: [
+      { 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 }]'
+  },
+  "data/pad": {
+    module: "data",
+    category: "ml-data",
+    minArity: 2,
+    maxArity: 2,
+    description: "Pad sequences to uniform length",
+    hasSideEffects: false,
+    returnType: "tensor",
+    params: [
+      { 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 }]'
+  }
+};
+function getDataOperators() {
+  return Object.keys(DATA_OPERATORS);
+}
+
 // modules/prob.ts
 var PROB_OPERATORS = {
   // ========================================
@@ -3380,6 +3797,119 @@ function getProbOperators() {
   return PROB_OPERATORS;
 }
 
-export { ARRAY_OPERATORS, ASYNC_OPERATORS, FORMAT_OPERATORS, MATH_OPERATORS, NN_OPERATORS, OBJECT_OPERATORS, PROB_OPERATORS, STR_OPERATORS, TENSOR_OPERATORS, TIME_OPERATORS, TRAIN_OPERATORS, VALIDATE_OPERATORS, getArrayOperators, getAsyncOperators, getFormatOperators, getLambdaArrayOperators, getMathOperators, getNnOperators, getObjectOperators, getProbOperators, getStrOperators, getTensorOperators, getTimeOperators, getTrainOperators, getValidateOperators };
+// modules/os.ts
+var OS_OPERATORS = {
+  "os/watch-files": {
+    module: "os",
+    category: "std-os",
+    minArity: 1,
+    maxArity: 2,
+    description: "Register file system watcher. Emits OS_FILE_MODIFIED, OS_FILE_CREATED, OS_FILE_DELETED events with { path, name, dir, timestamp } payload.",
+    hasSideEffects: true,
+    returnType: "void",
+    params: [
+      { name: "glob", type: "string", description: 'Glob pattern to watch (e.g., "**/*.orb")' },
+      { name: "options", type: "object", description: "Optional config: { recursive, ignoreInitial, debounceMs }", optional: true }
+    ],
+    example: '["os/watch-files", "**/*.orb"]'
+  },
+  "os/watch-process": {
+    module: "os",
+    category: "std-os",
+    minArity: 1,
+    maxArity: 2,
+    description: "Register process monitor. Emits OS_PROCESS_EXITED, OS_PROCESS_STARTED events with { pid, name, exitCode, signal, args, duration } payload.",
+    hasSideEffects: true,
+    returnType: "void",
+    params: [
+      { name: "name", type: "string", description: 'Process name to monitor (e.g., "orbital")' },
+      { name: "subcommand", type: "string", description: 'Optional subcommand filter (e.g., "validate")', optional: true }
+    ],
+    example: '["os/watch-process", "orbital", "validate"]'
+  },
+  "os/watch-port": {
+    module: "os",
+    category: "std-os",
+    minArity: 1,
+    maxArity: 2,
+    description: "Register port monitor. Emits OS_PORT_OPENED, OS_PORT_CLOSED events with { port, protocol, pid, address } payload.",
+    hasSideEffects: true,
+    returnType: "void",
+    params: [
+      { name: "port", type: "number", description: "Port number to monitor" },
+      { name: "protocol", type: "string", description: 'Protocol: "tcp" or "udp" (default: "tcp")', optional: true }
+    ],
+    example: '["os/watch-port", 3000]'
+  },
+  "os/watch-http": {
+    module: "os",
+    category: "std-os",
+    minArity: 1,
+    maxArity: 2,
+    description: "Register HTTP response interceptor. Emits OS_HTTP_RESPONSE events with { url, method, status, headers, body, duration } payload.",
+    hasSideEffects: true,
+    returnType: "void",
+    params: [
+      { name: "urlPattern", type: "string", description: 'URL pattern to intercept (e.g., "https://api.example.com/*")' },
+      { name: "method", type: "string", description: 'HTTP method filter (e.g., "POST")', optional: true }
+    ],
+    example: '["os/watch-http", "https://api.example.com/*", "POST"]'
+  },
+  "os/watch-cron": {
+    module: "os",
+    category: "std-os",
+    minArity: 1,
+    maxArity: 1,
+    description: "Register cron schedule. Emits OS_CRON_FIRE events with { expression, timestamp } payload.",
+    hasSideEffects: true,
+    returnType: "void",
+    params: [
+      { name: "expression", type: "string", description: 'Cron expression (e.g., "*/5 * * * *" for every 5 minutes)' }
+    ],
+    example: '["os/watch-cron", "0 */6 * * *"]'
+  },
+  "os/watch-signal": {
+    module: "os",
+    category: "std-os",
+    minArity: 1,
+    maxArity: 1,
+    description: "Register OS signal handler. Emits OS_SIGNAL_USR1, OS_SIGNAL_HUP, etc. with { pid, timestamp } payload.",
+    hasSideEffects: true,
+    returnType: "void",
+    params: [
+      { name: "signal", type: "string", description: 'Signal name: "SIGUSR1", "SIGUSR2", "SIGHUP", "SIGTERM"' }
+    ],
+    example: '["os/watch-signal", "SIGUSR1"]'
+  },
+  "os/watch-env": {
+    module: "os",
+    category: "std-os",
+    minArity: 1,
+    maxArity: 1,
+    description: "Register environment variable watcher. Emits OS_ENV_CHANGED events with { variable, oldValue, newValue } payload.",
+    hasSideEffects: true,
+    returnType: "void",
+    params: [
+      { name: "variable", type: "string", description: "Environment variable name to watch" }
+    ],
+    example: '["os/watch-env", "NODE_ENV"]'
+  },
+  "os/debounce": {
+    module: "os",
+    category: "std-os",
+    minArity: 2,
+    maxArity: 2,
+    description: "Configure debounce interval for an OS event type. Prevents trigger storms during rapid changes.",
+    hasSideEffects: true,
+    returnType: "void",
+    params: [
+      { name: "ms", type: "number", description: "Debounce interval in milliseconds" },
+      { name: "eventType", type: "string", description: 'OS event type to debounce (e.g., "OS_FILE_MODIFIED")' }
+    ],
+    example: '["os/debounce", 500, "OS_FILE_MODIFIED"]'
+  }
+};
+
+export { ARRAY_OPERATORS, ASYNC_OPERATORS, CONTRACT_OPERATORS, DATA_OPERATORS, FORMAT_OPERATORS, GRAPH_OPERATORS, MATH_OPERATORS, NN_OPERATORS, OBJECT_OPERATORS, OS_OPERATORS, PROB_OPERATORS, STR_OPERATORS, TENSOR_OPERATORS, TIME_OPERATORS, TRAIN_OPERATORS, VALIDATE_OPERATORS, getArrayOperators, getAsyncOperators, getContractOperators, getDataOperators, getFormatOperators, getGraphOperators, getLambdaArrayOperators, getMathOperators, getNnOperators, getObjectOperators, getProbOperators, getStrOperators, getTensorOperators, getTimeOperators, getTrainOperators, getValidateOperators };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map