@almadar/std 3.2.2 → 3.3.4

package/dist/registry.js

@@ -11,7 +11,11 @@ var STD_MODULES = [
   "nn",
   "tensor",
   "train",
-  "prob"
+  "prob",
+  "os",
+  "graph",
+  "contract",
+  "data"
 ];
 function getModuleFromOperator(operator) {
   const parts = operator.split("/");
@@ -2241,7 +2245,7 @@ var ASYNC_OPERATORS = {
 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",
@@ -2254,7 +2258,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)",
@@ -2268,7 +2272,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)",
@@ -2279,7 +2283,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)",
@@ -2290,7 +2294,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)",
@@ -2301,7 +2305,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)",
@@ -2314,7 +2318,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)",
@@ -2327,7 +2331,7 @@ var NN_OPERATORS = {
   },
   "nn/batchnorm": {
     module: "nn",
-    category: "std-nn",
+    category: "ml-arch",
     minArity: 1,
     maxArity: 1,
     description: "Batch normalization layer",
@@ -2340,7 +2344,7 @@ var NN_OPERATORS = {
   },
   "nn/layernorm": {
     module: "nn",
-    category: "std-nn",
+    category: "ml-arch",
     minArity: 1,
     maxArity: 1,
     description: "Layer normalization",
@@ -2353,7 +2357,7 @@ var NN_OPERATORS = {
   },
   "nn/forward": {
     module: "nn",
-    category: "std-nn",
+    category: "ml-effect",
     minArity: 2,
     maxArity: 2,
     description: "Execute forward pass through network",
@@ -2367,7 +2371,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",
@@ -2380,7 +2384,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",
@@ -2394,7 +2398,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",
@@ -2407,7 +2411,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",
@@ -2427,7 +2431,7 @@ var TENSOR_OPERATORS = {
   // ============================================================================
   "tensor/from": {
     module: "tensor",
-    category: "std-tensor",
+    category: "ml-tensor",
     minArity: 1,
     maxArity: 1,
     description: "Create tensor from array",
@@ -2440,7 +2444,7 @@ var TENSOR_OPERATORS = {
   },
   "tensor/zeros": {
     module: "tensor",
-    category: "std-tensor",
+    category: "ml-tensor",
     minArity: 1,
     maxArity: 1,
     description: "Create tensor filled with zeros",
@@ -2453,7 +2457,7 @@ var TENSOR_OPERATORS = {
   },
   "tensor/ones": {
     module: "tensor",
-    category: "std-tensor",
+    category: "ml-tensor",
     minArity: 1,
     maxArity: 1,
     description: "Create tensor filled with ones",
@@ -2466,7 +2470,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)",
@@ -2479,7 +2483,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",
@@ -2495,7 +2499,7 @@ var TENSOR_OPERATORS = {
   // ============================================================================
   "tensor/shape": {
     module: "tensor",
-    category: "std-tensor",
+    category: "ml-tensor",
     minArity: 1,
     maxArity: 1,
     description: "Get tensor shape as array",
@@ -2508,7 +2512,7 @@ var TENSOR_OPERATORS = {
   },
   "tensor/get": {
     module: "tensor",
-    category: "std-tensor",
+    category: "ml-tensor",
     minArity: 2,
     maxArity: 2,
     description: "Get element at index",
@@ -2522,7 +2526,7 @@ var TENSOR_OPERATORS = {
   },
   "tensor/slice": {
     module: "tensor",
-    category: "std-tensor",
+    category: "ml-tensor",
     minArity: 3,
     maxArity: 3,
     description: "Get slice of tensor",
@@ -2537,7 +2541,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)",
@@ -2551,7 +2555,7 @@ var TENSOR_OPERATORS = {
   },
   "tensor/flatten": {
     module: "tensor",
-    category: "std-tensor",
+    category: "ml-tensor",
     minArity: 1,
     maxArity: 1,
     description: "Flatten tensor to 1D",
@@ -2567,7 +2571,7 @@ var TENSOR_OPERATORS = {
   // ============================================================================
   "tensor/add": {
     module: "tensor",
-    category: "std-tensor",
+    category: "ml-tensor",
     minArity: 2,
     maxArity: 2,
     description: "Element-wise addition",
@@ -2581,7 +2585,7 @@ var TENSOR_OPERATORS = {
   },
   "tensor/sub": {
     module: "tensor",
-    category: "std-tensor",
+    category: "ml-tensor",
     minArity: 2,
     maxArity: 2,
     description: "Element-wise subtraction",
@@ -2595,7 +2599,7 @@ var TENSOR_OPERATORS = {
   },
   "tensor/mul": {
     module: "tensor",
-    category: "std-tensor",
+    category: "ml-tensor",
     minArity: 2,
     maxArity: 2,
     description: "Element-wise multiplication",
@@ -2609,7 +2613,7 @@ var TENSOR_OPERATORS = {
   },
   "tensor/div": {
     module: "tensor",
-    category: "std-tensor",
+    category: "ml-tensor",
     minArity: 2,
     maxArity: 2,
     description: "Element-wise division",
@@ -2623,7 +2627,7 @@ var TENSOR_OPERATORS = {
   },
   "tensor/matmul": {
     module: "tensor",
-    category: "std-tensor",
+    category: "ml-tensor",
     minArity: 2,
     maxArity: 2,
     description: "Matrix multiplication",
@@ -2637,7 +2641,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",
@@ -2654,7 +2658,7 @@ var TENSOR_OPERATORS = {
   // ============================================================================
   "tensor/sum": {
     module: "tensor",
-    category: "std-tensor",
+    category: "ml-tensor",
     minArity: 1,
     maxArity: 2,
     description: "Sum of tensor elements",
@@ -2668,7 +2672,7 @@ var TENSOR_OPERATORS = {
   },
   "tensor/mean": {
     module: "tensor",
-    category: "std-tensor",
+    category: "ml-tensor",
     minArity: 1,
     maxArity: 2,
     description: "Mean of tensor elements",
@@ -2682,7 +2686,7 @@ var TENSOR_OPERATORS = {
   },
   "tensor/max": {
     module: "tensor",
-    category: "std-tensor",
+    category: "ml-tensor",
     minArity: 1,
     maxArity: 2,
     description: "Maximum value in tensor",
@@ -2696,7 +2700,7 @@ var TENSOR_OPERATORS = {
   },
   "tensor/min": {
     module: "tensor",
-    category: "std-tensor",
+    category: "ml-tensor",
     minArity: 1,
     maxArity: 2,
     description: "Minimum value in tensor",
@@ -2710,7 +2714,7 @@ var TENSOR_OPERATORS = {
   },
   "tensor/argmax": {
     module: "tensor",
-    category: "std-tensor",
+    category: "ml-tensor",
     minArity: 1,
     maxArity: 2,
     description: "Index of maximum value",
@@ -2724,7 +2728,7 @@ var TENSOR_OPERATORS = {
   },
   "tensor/norm": {
     module: "tensor",
-    category: "std-tensor",
+    category: "ml-tensor",
     minArity: 1,
     maxArity: 2,
     description: "L2 norm of tensor",
@@ -2741,7 +2745,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]",
@@ -2755,7 +2759,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",
@@ -2769,7 +2773,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]",
@@ -2784,7 +2788,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",
@@ -2798,7 +2802,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",
@@ -2815,7 +2819,7 @@ var TENSOR_OPERATORS = {
   // ============================================================================
   "tensor/toArray": {
     module: "tensor",
-    category: "std-tensor",
+    category: "ml-tensor",
     minArity: 1,
     maxArity: 1,
     description: "Convert tensor to nested array",
@@ -2828,7 +2832,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",
@@ -2848,7 +2852,7 @@ var TRAIN_OPERATORS = {
   // ============================================================================
   "train/loop": {
     module: "train",
-    category: "std-train",
+    category: "ml-effect",
     minArity: 3,
     maxArity: 3,
     description: "Execute training loop with constraints",
@@ -2863,7 +2867,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)",
@@ -2882,7 +2886,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",
@@ -2896,7 +2900,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",
@@ -2914,7 +2918,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",
@@ -2928,7 +2932,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",
@@ -2942,7 +2946,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",
@@ -2960,7 +2964,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)",
@@ -2974,7 +2978,7 @@ var TRAIN_OPERATORS = {
   },
   "train/getGradientNorm": {
     module: "train",
-    category: "std-train",
+    category: "ml-effect",
     minArity: 1,
     maxArity: 1,
     description: "Get current gradient norm",
@@ -2990,7 +2994,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)",
@@ -3004,7 +3008,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",
@@ -3020,7 +3024,7 @@ var TRAIN_OPERATORS = {
   // ============================================================================
   "train/mse": {
     module: "train",
-    category: "std-train",
+    category: "ml-effect",
     minArity: 2,
     maxArity: 2,
     description: "Mean squared error loss",
@@ -3034,7 +3038,7 @@ var TRAIN_OPERATORS = {
   },
   "train/crossEntropy": {
     module: "train",
-    category: "std-train",
+    category: "ml-effect",
     minArity: 2,
     maxArity: 2,
     description: "Cross-entropy loss for classification",
@@ -3048,7 +3052,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)",
@@ -3066,7 +3070,7 @@ var TRAIN_OPERATORS = {
   // ============================================================================
   "train/sgd": {
     module: "train",
-    category: "std-train",
+    category: "ml-effect",
     minArity: 2,
     maxArity: 3,
     description: "Stochastic gradient descent optimizer step",
@@ -3081,7 +3085,7 @@ var TRAIN_OPERATORS = {
   },
   "train/adam": {
     module: "train",
-    category: "std-train",
+    category: "ml-effect",
     minArity: 2,
     maxArity: 4,
     description: "Adam optimizer step",
@@ -3100,7 +3104,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",
@@ -3114,7 +3118,7 @@ var TRAIN_OPERATORS = {
   },
   "train/computeReturns": {
     module: "train",
-    category: "std-train",
+    category: "ml-effect",
     minArity: 2,
     maxArity: 2,
     description: "Compute discounted returns from rewards",
@@ -3128,7 +3132,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",
@@ -3366,6 +3370,119 @@ var PROB_OPERATORS = {
   }
 };
 
+// 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"]'
+  }
+};
+
 // registry.ts
 var STD_OPERATORS = {
   ...MATH_OPERATORS,
@@ -3379,7 +3496,8 @@ var STD_OPERATORS = {
   ...NN_OPERATORS,
   ...TENSOR_OPERATORS,
   ...TRAIN_OPERATORS,
-  ...PROB_OPERATORS
+  ...PROB_OPERATORS,
+  ...OS_OPERATORS
 };
 var STD_OPERATORS_BY_MODULE = {
   math: MATH_OPERATORS,
@@ -3393,7 +3511,8 @@ var STD_OPERATORS_BY_MODULE = {
   nn: NN_OPERATORS,
   tensor: TENSOR_OPERATORS,
   train: TRAIN_OPERATORS,
-  prob: PROB_OPERATORS
+  prob: PROB_OPERATORS,
+  os: OS_OPERATORS
 };
 function getStdOperatorMeta(operator) {
   return STD_OPERATORS[operator];