@almadar/std 16.226.0 → 16.228.0

package/dist/modules/index.js

@@ -334,6 +334,7 @@ var CORE_OPERATORS = {
     maxArity: 2,
     description: "Set a binding to a value",
     hasSideEffects: true,
+    runsOn: "any",
     returnType: "void",
     params: [
       { name: "binding", type: BINDING, description: 'Target binding (e.g. "@entity.field")' },
@@ -356,6 +357,7 @@ var CORE_OPERATORS = {
     maxArity: 2,
     description: "Emit an event onto the bus",
     hasSideEffects: true,
+    runsOn: "any",
     returnType: "void",
     params: [
       { name: "event", type: EVENT_KEY, description: "Event key" },
@@ -378,6 +380,7 @@ var CORE_OPERATORS = {
     maxArity: 4,
     description: "Create, update, delete, clear, or batch entity records. Optional trailing { emit: { success, failure } } options object attaches closed-circuit emit routing.",
     hasSideEffects: true,
+    runsOn: "server",
     returnType: "void",
     params: [
       { name: "action", type: PERSIST_ACTION, description: "Persist action" },
@@ -434,6 +437,7 @@ var CORE_OPERATORS = {
     maxArity: 3,
     description: "Navigate to a route: (navigate path payload? options?) \u2014 options carries { crumb } labelling the navigation-stack entry for the target page",
     hasSideEffects: true,
+    runsOn: "client",
     returnType: "void",
     params: [
       { name: "path", type: STRING, description: "Route path (supports :param placeholders)" },
@@ -460,6 +464,7 @@ var CORE_OPERATORS = {
     maxArity: 0,
     description: "Pop the orbital-scoped navigation stack and return to the previous entry",
     hasSideEffects: true,
+    runsOn: "client",
     returnType: "void",
     effect: { kind: "navigate-back" }
   },
@@ -470,6 +475,7 @@ var CORE_OPERATORS = {
     maxArity: 2,
     description: "Show a notification (in-app, email, push, sms)",
     hasSideEffects: true,
+    runsOn: "any",
     returnType: "void",
     params: [
       { name: "channel", type: NOTIFY_CHANNEL, description: "Delivery channel" },
@@ -485,6 +491,7 @@ var CORE_OPERATORS = {
     maxArity: 1,
     description: "Emit a structured info log line (compiled + runtime)",
     hasSideEffects: true,
+    runsOn: "any",
     returnType: "void",
     params: [{ name: "message", type: STRING, description: "Log message" }],
     example: '["log", "Context below compact threshold"]',
@@ -497,6 +504,7 @@ var CORE_OPERATORS = {
     maxArity: 2,
     description: "Spawn a new entity instance (games)",
     hasSideEffects: true,
+    runsOn: "any",
     returnType: "void",
     params: [
       { name: "entity", type: { kind: "entity" }, description: "Entity name to spawn" },
@@ -517,6 +525,7 @@ var CORE_OPERATORS = {
     maxArity: 1,
     description: "Despawn an entity instance (games)",
     hasSideEffects: true,
+    runsOn: "any",
     returnType: "void",
     params: [
       { name: "entityId", type: STRING, description: "Target entity id (defaults to @entity.id)", optional: true }
@@ -531,6 +540,7 @@ var CORE_OPERATORS = {
     maxArity: 2,
     description: "Fetch an entity (by id) or a collection (by filter) from persistence",
     hasSideEffects: true,
+    runsOn: "server",
     returnType: "void",
     params: [
       { name: "entity", type: { kind: "entity" }, description: "Target entity name" },
@@ -578,6 +588,7 @@ var CORE_OPERATORS = {
     maxArity: 2,
     description: "Stream an LLM or HTTP response, emitting on_message per chunk, success on completion, failure on error",
     hasSideEffects: true,
+    runsOn: "server",
     returnType: "void",
     params: [
       { name: "entity", type: { kind: "entity" }, description: "Target entity name" },
@@ -609,6 +620,7 @@ var CORE_OPERATORS = {
     maxArity: 2,
     description: "Send an orbital event to the server over WebSocket (client-side; chat/real-time trigger)",
     hasSideEffects: true,
+    runsOn: "client",
     returnType: "void",
     params: [
       { name: "event", type: EVENT_KEY, description: "Target orbital event name on the server" },
@@ -629,6 +641,7 @@ var CORE_OPERATORS = {
     maxArity: 2,
     description: "Reactive entity reference (deprecated, use fetch with listens in V2)",
     hasSideEffects: true,
+    runsOn: "any",
     returnType: "void",
     params: [
       { name: "entity", type: { kind: "entity" }, description: "Target entity name" },
@@ -669,6 +682,78 @@ var CORE_OPERATORS = {
       }
     }
   },
+  deref: {
+    module: "core",
+    category: "effect",
+    minArity: 1,
+    maxArity: 2,
+    description: "Snapshot read of a binding or entity, without subscribing to changes",
+    hasSideEffects: true,
+    runsOn: "any",
+    returnType: "any",
+    params: [
+      { name: "target", type: STRING, description: "A binding (`@entity.health`) or entity name" },
+      {
+        name: "options",
+        type: {
+          kind: "object",
+          fields: { id: STRING, filter: ANY, include: { kind: "array", of: STRING } },
+          open: true
+        },
+        description: "Selector: id | filter | include",
+        optional: true
+      }
+    ],
+    example: '["deref", "@entity.health"]'
+  },
+  "swap!": {
+    module: "core",
+    category: "effect",
+    minArity: 2,
+    maxArity: 2,
+    description: "Atomic compare-and-swap of an entity field on the server",
+    hasSideEffects: true,
+    runsOn: "server",
+    returnType: "void",
+    params: [
+      { name: "target", type: BINDING, description: "The field to swap (`@entity.counter`)" },
+      { name: "update", type: SEXPR, description: "The new value, computed from the current one" }
+    ],
+    example: "(swap! @entity.counter (+ @entity.counter 1))"
+  },
+  watch: {
+    module: "core",
+    category: "effect",
+    minArity: 2,
+    maxArity: 3,
+    description: "Emit an event whenever a watched binding changes",
+    hasSideEffects: true,
+    runsOn: "any",
+    returnType: "void",
+    params: [
+      { name: "target", type: BINDING, description: "The binding to watch" },
+      { name: "event", type: EVENT_KEY, description: "Event emitted on each change" },
+      {
+        name: "options",
+        type: { kind: "object", fields: { debounce: "number", emit: { kind: "object", fields: {}, open: true } }, open: false },
+        description: "debounce (ms) | emit",
+        optional: true
+      }
+    ],
+    example: '["watch", "@entity.status", "STATUS_UPDATED", { "debounce": 100 }]'
+  },
+  atomic: {
+    module: "core",
+    category: "effect",
+    minArity: 1,
+    maxArity: null,
+    description: "Run effects as one server transaction: all succeed or all roll back",
+    hasSideEffects: true,
+    runsOn: "server",
+    returnType: "void",
+    params: [{ name: "effects", type: SEXPR, description: "The effects to group" }],
+    example: "(atomic (set @entity.x 10) (set @entity.y 20))"
+  },
   "call-service": {
     module: "core",
     category: "effect",
@@ -676,6 +761,7 @@ var CORE_OPERATORS = {
     maxArity: 4,
     description: "Invoke an external service action. Optional trailing { emit: { success, failure } } options object attaches closed-circuit emit routing (V2 frame contract).",
     hasSideEffects: true,
+    runsOn: "server",
     returnType: "void",
     params: [
       { name: "service", type: STRING, description: 'Service name (e.g. "llm", "stripe")' },
@@ -709,6 +795,7 @@ var CORE_OPERATORS = {
     maxArity: 3,
     description: "Render a pattern into a UI slot",
     hasSideEffects: true,
+    runsOn: "client",
     returnType: "void",
     params: [
       { name: "slot", type: UI_SLOT, description: "Target UI slot (main, sidebar, modal, hud, ...)" },
@@ -849,6 +936,28 @@ var MATH_OPERATORS = {
     params: [{ name: "n", type: "number", description: "The number" }],
     example: '["math/sqrt", 16] // => 4'
   },
+  "math/log10": {
+    module: "math",
+    category: "std-math",
+    minArity: 1,
+    maxArity: 1,
+    description: "Base-10 logarithm",
+    hasSideEffects: false,
+    returnType: "number",
+    params: [{ name: "n", type: "number", description: "The number" }],
+    example: '["math/log10", 100] // => 2'
+  },
+  "math/ln": {
+    module: "math",
+    category: "std-math",
+    minArity: 1,
+    maxArity: 1,
+    description: "Natural logarithm (base e)",
+    hasSideEffects: false,
+    returnType: "number",
+    params: [{ name: "n", type: "number", description: "The number" }],
+    example: '["math/ln", 2.718281828] // => 1'
+  },
   "math/mod": {
     module: "math",
     category: "std-math",
@@ -3064,6 +3173,7 @@ var ASYNC_OPERATORS = {
     maxArity: 2,
     description: "Wait for specified milliseconds, optionally execute an effect after",
     hasSideEffects: true,
+    runsOn: "any",
     returnType: "any",
     params: [
       { name: "ms", type: "number", description: "Milliseconds to wait" },
@@ -3078,6 +3188,7 @@ var ASYNC_OPERATORS = {
     maxArity: 2,
     description: "Execute an effect periodically at a fixed interval",
     hasSideEffects: true,
+    runsOn: "any",
     returnType: "string",
     params: [
       { name: "ms", type: "number", description: "Interval in milliseconds" },
@@ -3092,6 +3203,7 @@ var ASYNC_OPERATORS = {
     maxArity: 2,
     description: "Add timeout to an effect",
     hasSideEffects: true,
+    runsOn: "any",
     returnType: "any",
     params: [
       { name: "effect", type: "expression", description: "Effect to execute" },
@@ -3106,6 +3218,7 @@ var ASYNC_OPERATORS = {
     maxArity: 2,
     description: "Debounce an event (wait for pause in events)",
     hasSideEffects: true,
+    runsOn: "any",
     returnType: "void",
     params: [
       { name: "event", type: "string", description: "Event name to emit" },
@@ -3120,6 +3233,7 @@ var ASYNC_OPERATORS = {
     maxArity: 2,
     description: "Throttle an event (emit at most once per interval)",
     hasSideEffects: true,
+    runsOn: "any",
     returnType: "void",
     params: [
       { name: "event", type: "string", description: "Event name to emit" },
@@ -3134,6 +3248,7 @@ var ASYNC_OPERATORS = {
     maxArity: 2,
     description: "Retry an effect with configurable backoff",
     hasSideEffects: true,
+    runsOn: "any",
     returnType: "any",
     params: [
       { name: "effect", type: "expression", description: "Effect to retry" },
@@ -3150,6 +3265,7 @@ var ASYNC_OPERATORS = {
     maxArity: null,
     description: "Execute effects in parallel, return first to complete",
     hasSideEffects: true,
+    runsOn: "any",
     returnType: "any",
     params: [{ name: "...effects", type: "expression[]", description: "Effects to race" }],
     example: '["async/race", ["call", "api1"], ["call", "api2"]]'
@@ -3161,6 +3277,7 @@ var ASYNC_OPERATORS = {
     maxArity: null,
     description: "Execute effects in parallel, wait for all to complete",
     hasSideEffects: true,
+    runsOn: "any",
     returnType: "array",
     params: [{ name: "...effects", type: "expression[]", description: "Effects to execute" }],
     example: '["async/all", ["call", "api1"], ["call", "api2"]]'
@@ -3172,6 +3289,7 @@ var ASYNC_OPERATORS = {
     maxArity: null,
     description: "Execute effects in sequence (one after another)",
     hasSideEffects: true,
+    runsOn: "any",
     returnType: "array",
     params: [{ name: "...effects", type: "expression[]", description: "Effects to execute in order" }],
     example: '["async/sequence", ["call", "validate"], ["call", "save"]]'
@@ -3329,6 +3447,7 @@ var NN_OPERATORS = {
     maxArity: 2,
     description: "Set network weights from a flat tensor",
     hasSideEffects: true,
+    runsOn: "any",
     returnType: "nn/module",
     params: [
       { name: "module", type: "nn/module", description: "The neural network module" },
@@ -3893,6 +4012,7 @@ var TRAIN_OPERATORS = {
     maxArity: 3,
     description: "Execute training loop with constraints",
     hasSideEffects: true,
+    runsOn: "any",
     returnType: "train/result",
     params: [
       { name: "module", type: "nn/module", description: "The neural network to train" },
@@ -3908,6 +4028,7 @@ var TRAIN_OPERATORS = {
     maxArity: 4,
     description: "Execute single training step (forward, loss, backward, update)",
     hasSideEffects: true,
+    runsOn: "any",
     returnType: "train/stepResult",
     params: [
       { name: "module", type: "nn/module", description: "The neural network" },
@@ -4005,6 +4126,7 @@ var TRAIN_OPERATORS = {
     maxArity: 2,
     description: "Clip gradients to max norm (modifies in place)",
     hasSideEffects: true,
+    runsOn: "any",
     returnType: "number",
     params: [
       { name: "module", type: "nn/module", description: "The neural network" },
@@ -4035,6 +4157,7 @@ var TRAIN_OPERATORS = {
     maxArity: 2,
     description: "Clip weights to max magnitude (modifies in place)",
     hasSideEffects: true,
+    runsOn: "any",
     returnType: "void",
     params: [
       { name: "module", type: "nn/module", description: "The neural network" },
@@ -4111,6 +4234,7 @@ var TRAIN_OPERATORS = {
     maxArity: 3,
     description: "Stochastic gradient descent optimizer step",
     hasSideEffects: true,
+    runsOn: "any",
     returnType: "void",
     params: [
       { name: "module", type: "nn/module", description: "The neural network" },
@@ -4126,6 +4250,7 @@ var TRAIN_OPERATORS = {
     maxArity: 4,
     description: "Adam optimizer step",
     hasSideEffects: true,
+    runsOn: "any",
     returnType: "void",
     params: [
       { name: "module", type: "nn/module", description: "The neural network" },
@@ -4191,6 +4316,7 @@ var TRAIN_OPERATORS = {
     maxArity: 3,
     description: "Train a model over a dataset (ML effect)",
     hasSideEffects: true,
+    runsOn: "any",
     returnType: "object",
     params: [
       { name: "model", type: "nn/module", description: "The neural network module" },
@@ -4220,6 +4346,7 @@ var TRAIN_OPERATORS = {
     maxArity: 2,
     description: "Save a model checkpoint (ML effect)",
     hasSideEffects: true,
+    runsOn: "any",
     returnType: "void",
     params: [
       { name: "model", type: "nn/module", description: "The neural network module" },
@@ -4674,6 +4801,7 @@ var PROB_OPERATORS = {
     maxArity: 1,
     description: "Set seeded PRNG for deterministic probabilistic sampling",
     hasSideEffects: true,
+    runsOn: "any",
     returnType: "void",
     params: [{ name: "n", type: "number", description: "Seed value (integer)" }],
     example: '["prob/seed", 42]'
@@ -4766,6 +4894,7 @@ var PROB_OPERATORS = {
     maxArity: 1,
     description: "Mark current sample as rejected if predicate is false",
     hasSideEffects: true,
+    runsOn: "any",
     returnType: "void",
     params: [{ name: "predicate", type: "boolean", description: "Condition that must hold" }],
     example: '["prob/condition", [">", 5, 0]]'
@@ -4897,6 +5026,7 @@ var OS_OPERATORS = {
     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,
+    runsOn: "server",
     returnType: "void",
     params: [
       { name: "glob", type: "string", description: 'Glob pattern to watch (e.g., "**/*.orb")' },
@@ -4911,6 +5041,7 @@ var OS_OPERATORS = {
     maxArity: 2,
     description: "Register process monitor. Emits OS_PROCESS_EXITED, OS_PROCESS_STARTED events with { pid, name, exitCode, signal, args, duration } payload.",
     hasSideEffects: true,
+    runsOn: "server",
     returnType: "void",
     params: [
       { name: "name", type: "string", description: 'Process name to monitor (e.g., "orbital")' },
@@ -4925,6 +5056,7 @@ var OS_OPERATORS = {
     maxArity: 2,
     description: "Register port monitor. Emits OS_PORT_OPENED, OS_PORT_CLOSED events with { port, protocol, pid, address } payload.",
     hasSideEffects: true,
+    runsOn: "server",
     returnType: "void",
     params: [
       { name: "port", type: "number", description: "Port number to monitor" },
@@ -4939,6 +5071,7 @@ var OS_OPERATORS = {
     maxArity: 2,
     description: "Register HTTP response interceptor. Emits OS_HTTP_RESPONSE events with { url, method, status, headers, body, duration } payload.",
     hasSideEffects: true,
+    runsOn: "server",
     returnType: "void",
     params: [
       { name: "urlPattern", type: "string", description: 'URL pattern to intercept (e.g., "https://api.example.com/*")' },
@@ -4953,6 +5086,7 @@ var OS_OPERATORS = {
     maxArity: 1,
     description: "Register cron schedule. Emits OS_CRON_FIRE events with { expression, timestamp } payload.",
     hasSideEffects: true,
+    runsOn: "server",
     returnType: "void",
     params: [
       { name: "expression", type: "string", description: 'Cron expression (e.g., "*/5 * * * *" for every 5 minutes)' }
@@ -4966,6 +5100,7 @@ var OS_OPERATORS = {
     maxArity: 1,
     description: "Register OS signal handler. Emits OS_SIGNAL_USR1, OS_SIGNAL_HUP, etc. with { pid, timestamp } payload.",
     hasSideEffects: true,
+    runsOn: "server",
     returnType: "void",
     params: [
       { name: "signal", type: "string", description: 'Signal name: "SIGUSR1", "SIGUSR2", "SIGHUP", "SIGTERM"' }
@@ -4979,6 +5114,7 @@ var OS_OPERATORS = {
     maxArity: 1,
     description: "Register environment variable watcher. Emits OS_ENV_CHANGED events with { variable, oldValue, newValue } payload.",
     hasSideEffects: true,
+    runsOn: "server",
     returnType: "void",
     params: [
       { name: "variable", type: "string", description: "Environment variable name to watch" }
@@ -4992,6 +5128,7 @@ var OS_OPERATORS = {
     maxArity: 2,
     description: "Configure debounce interval for an OS event type. Prevents trigger storms during rapid changes.",
     hasSideEffects: true,
+    runsOn: "server",
     returnType: "void",
     params: [
       { name: "ms", type: "number", description: "Debounce interval in milliseconds" },
@@ -5010,6 +5147,7 @@ var BROWSER_OPERATORS = {
     maxArity: 1,
     description: "Open the OS file picker (window.showOpenFilePicker / host dialog). Resolves with the selected file metadata list, or emits failure when the user cancels or the capability is denied. Async; use the trailing { emit } envelope for success/failure events.",
     hasSideEffects: true,
+    runsOn: "client",
     returnType: "array",
     params: [
       {
@@ -5050,6 +5188,7 @@ var BROWSER_OPERATORS = {
     maxArity: 0,
     description: "Read text from the system clipboard (navigator.clipboard.readText / host clipboard). Requires a user gesture and clipboard permission. Resolves with the clipboard text via the trailing { emit } envelope.",
     hasSideEffects: true,
+    runsOn: "client",
     returnType: "string",
     effect: {
       kind: "custom",
@@ -5064,6 +5203,7 @@ var BROWSER_OPERATORS = {
     maxArity: 1,
     description: "Write text to the system clipboard (navigator.clipboard.writeText / host clipboard). Requires a user gesture. Emits success/failure via the trailing { emit } envelope.",
     hasSideEffects: true,
+    runsOn: "client",
     returnType: "void",
     params: [
       { name: "text", type: "string", description: "Text to write to the clipboard" }
@@ -5081,6 +5221,7 @@ var BROWSER_OPERATORS = {
     maxArity: 0,
     description: "Subscribe this browser to Web Push notifications: registers the shared push service worker, fetches the VAPID public key from the host (/api/push/vapid-public-key \u2014 no key material in the schema), and calls PushManager.subscribe. Requires notification permission (user gesture). Resolves with the flat subscription credentials { endpoint, p256dh, auth } via the trailing { emit } envelope \u2014 persist them on an owner-scoped entity row and pass them back to the push.send service as subscription: { endpoint, keys: { p256dh, auth } }. Emits failure when the Push API is unavailable, permission is denied, or the host has no VAPID key configured.",
     hasSideEffects: true,
+    runsOn: "client",
     returnType: "object",
     effect: {
       kind: "custom",
@@ -5102,6 +5243,7 @@ var BROWSER_OPERATORS = {
     maxArity: 1,
     description: "Read the current device position (navigator.geolocation.getCurrentPosition / host geolocation). Requires location permission. Resolves with { latitude, longitude, accuracy } via the trailing { emit } envelope.",
     hasSideEffects: true,
+    runsOn: "client",
     returnType: "object",
     params: [
       {
@@ -5874,6 +6016,7 @@ var LLM_OPERATORS = {
     maxArity: 2,
     description: "Generate text from an LLM. Returns the generated string.",
     hasSideEffects: true,
+    runsOn: "any",
     returnType: "string",
     params: [
       { name: "prompt", type: "string", description: "Prompt text to send to the LLM" },
@@ -5888,6 +6031,7 @@ var LLM_OPERATORS = {
     maxArity: 2,
     description: "Call the LLM with tool definitions. Returns the assistant response with optional tool calls and token usage.",
     hasSideEffects: true,
+    runsOn: "any",
     returnType: "LlmCallToolsResult",
     params: [
       { name: "messages", type: { kind: "array", of: "LlmMessage" }, description: "Conversation messages" },
@@ -5902,6 +6046,7 @@ var LLM_OPERATORS = {
     maxArity: 1,
     description: "Generate embeddings for an array of texts. Returns a 2D array of floats.",
     hasSideEffects: true,
+    runsOn: "any",
     returnType: "array",
     params: [
       { name: "texts", type: { kind: "array", of: "string" }, description: "Texts to embed" }
@@ -5926,6 +6071,7 @@ var LLM_OPERATORS = {
     maxArity: 2,
     description: "Switch the active LLM provider and optionally the model.",
     hasSideEffects: true,
+    runsOn: "any",
     returnType: "void",
     params: [
       { name: "provider", type: "string", description: 'Provider name (e.g. "deepseek", "openai")' },
@@ -5940,6 +6086,7 @@ var LLM_OPERATORS = {
     maxArity: 1,
     description: "Compact the context window. Returns before/after token counts.",
     hasSideEffects: true,
+    runsOn: "any",
     returnType: "object",
     params: [
       { name: "strategy", type: { kind: "union", of: [{ kind: "literal", value: "hybrid" }, { kind: "literal", value: "summarize" }, { kind: "literal", value: "truncate" }, { kind: "literal", value: "extract" }] }, description: "Compaction strategy", optional: true }
@@ -5971,6 +6118,7 @@ var WORKSPACE_OPERATORS = {
     maxArity: 2,
     description: "Write an orbital definition to the workspace.",
     hasSideEffects: true,
+    runsOn: "any",
     returnType: "void",
     params: [
       { name: "name", type: "string", description: "Orbital name" },
@@ -5996,6 +6144,7 @@ var WORKSPACE_OPERATORS = {
     maxArity: 2,
     description: "Write a file to the workspace.",
     hasSideEffects: true,
+    runsOn: "any",
     returnType: "void",
     params: [
       { name: "path", type: "string", description: "File path relative to workspace root" },
@@ -6043,6 +6192,7 @@ var WORKSPACE_OPERATORS = {
     maxArity: 1,
     description: "Write the composed schema.orb to the workspace.",
     hasSideEffects: true,
+    runsOn: "any",
     returnType: "void",
     params: [{ name: "schema", type: { kind: "entityRef" }, description: "Composed schema" }],
     example: '["workspace/write-schema", {"orbitals": [{"name": "ProductOrbital"}]}]'
@@ -6065,6 +6215,7 @@ var WORKSPACE_OPERATORS = {
     maxArity: 1,
     description: "Write the plan snapshot to the workspace.",
     hasSideEffects: true,
+    runsOn: "any",
     returnType: "void",
     params: [{ name: "snapshot", type: { kind: "object", fields: { id: "string", status: "string" } }, description: "Plan snapshot" }],
     example: '["workspace/write-plan", ["create entity", "add list page"]]'
@@ -6076,6 +6227,7 @@ var WORKSPACE_OPERATORS = {
     maxArity: 1,
     description: "Archive (remove from active set) an orbital from the workspace.",
     hasSideEffects: true,
+    runsOn: "any",
     returnType: "void",
     params: [{ name: "name", type: "string", description: "Orbital name to archive" }],
     example: '["workspace/archive-orbital", "OldFeatureOrbital"]'
@@ -6105,6 +6257,7 @@ var SESSION_OPERATORS = {
     maxArity: 2,
     description: "Write the per-orbital spec.json to the session store.",
     hasSideEffects: true,
+    runsOn: "any",
     returnType: "void",
     params: [
       { name: "orbitalName", type: "string", description: "Orbital name" },
@@ -6130,6 +6283,7 @@ var SESSION_OPERATORS = {
     maxArity: 2,
     description: "Write per-orbital memory to the session store.",
     hasSideEffects: true,
+    runsOn: "any",
     returnType: "void",
     params: [
       { name: "orbitalName", type: "string", description: "Orbital name" },
@@ -6155,6 +6309,7 @@ var SESSION_OPERATORS = {
     maxArity: 2,
     description: "Append an entry to the per-orbital conversation history.",
     hasSideEffects: true,
+    runsOn: "any",
     returnType: "void",
     params: [
       { name: "orbitalName", type: "string", description: "Orbital name" },
@@ -6180,6 +6335,7 @@ var SESSION_OPERATORS = {
     maxArity: 2,
     description: "Write validation errors for an orbital.",
     hasSideEffects: true,
+    runsOn: "any",
     returnType: "void",
     params: [
       { name: "orbitalName", type: "string", description: "Orbital name" },
@@ -6226,6 +6382,7 @@ var MEMORY_OPERATORS = {
     maxArity: 3,
     description: "Store a new memory. Returns the new memory ID.",
     hasSideEffects: true,
+    runsOn: "any",
     returnType: "string",
     params: [
       { name: "content", type: "string", description: "Memory content to store" },
@@ -6261,6 +6418,7 @@ var TRACE_OPERATORS = {
     maxArity: 2,
     description: "Emit a structured trace event for observability (115 call sites in rabit today).",
     hasSideEffects: true,
+    runsOn: "any",
     returnType: "void",
     params: [
       { name: "event", type: "string", description: "Event type name" },
@@ -6275,6 +6433,7 @@ var TRACE_OPERATORS = {
     maxArity: 2,
     description: "Log a message at the given level.",
     hasSideEffects: true,
+    runsOn: "any",
     returnType: "void",
     params: [
       { name: "level", type: { kind: "union", of: [{ kind: "literal", value: "info" }, { kind: "literal", value: "warn" }, { kind: "literal", value: "error" }, { kind: "literal", value: "debug" }] }, description: "Log level" },
@@ -6296,6 +6455,7 @@ var BEHAVIOR_OPERATORS = {
     maxArity: 0,
     description: "Compose all orbitals in the workspace into a single schema. Backed by composeBehaviors.",
     hasSideEffects: true,
+    runsOn: "any",
     returnType: "ComposeAllResult",
     params: [],
     example: '["compose/compose-all"]'
@@ -6307,6 +6467,7 @@ var BEHAVIOR_OPERATORS = {
     maxArity: 1,
     description: "Compose child orbitals under a parent for recursive builds.",
     hasSideEffects: true,
+    runsOn: "any",
     returnType: "ComposeChildrenResult",
     params: [{ name: "parentName", type: "string", description: "Parent orbital name" }],
     example: '["compose/compose-children", "GameScreenOrbital"]'
@@ -6318,6 +6479,7 @@ var BEHAVIOR_OPERATORS = {
     maxArity: 3,
     description: "Instantiate a behavior from the registry at runtime (meta-programming). Equivalent to compile-time `uses` but dynamic \u2014 the behavior name is a runtime value. Applies the same override surface (linkedEntity, events, config, fields).",
     hasSideEffects: true,
+    runsOn: "any",
     returnType: "BuilderResult",
     params: [
       { name: "behavior", type: "string", description: 'Behavior/organism name (e.g. "std-ecommerce")' },
@@ -6333,6 +6495,7 @@ var BEHAVIOR_OPERATORS = {
     maxArity: 3,
     description: "Call a behavior service action. Returns the ServiceCallResult union \u2014 resolves to the specific member when the (behavior, action) pair is a literal.",
     hasSideEffects: true,
+    runsOn: "any",
     returnType: "ServiceCallResult",
     params: [
       { name: "behavior", type: "string", description: "Service/behavior name" },
@@ -6348,6 +6511,7 @@ var BEHAVIOR_OPERATORS = {
     maxArity: 3,
     description: "Emit a .lolo orbital body from the LLM (free-lolo path). Returns the emitted lolo source.",
     hasSideEffects: true,
+    runsOn: "any",
     returnType: "LoloEmitResult",
     params: [
       { name: "name", type: "string", description: "Orbital name" },
@@ -6363,6 +6527,7 @@ var BEHAVIOR_OPERATORS = {
     maxArity: 2,
     description: "Validate an orbital or the composed schema using orb validate.",
     hasSideEffects: true,
+    runsOn: "any",
     returnType: "ValidateResult",
     params: [
       { name: "target", type: { kind: "union", of: [{ kind: "literal", value: "orbital" }, { kind: "literal", value: "composed" }] }, description: "Validation target" },
@@ -6384,6 +6549,7 @@ var INTEGRATION_OPERATORS = {
     maxArity: 4,
     description: "HTTP request with caller-declared response schema. Validates the response against the schema before returning.",
     hasSideEffects: true,
+    runsOn: "any",
     returnType: "object",
     params: [
       { name: "method", type: "string", description: "HTTP method (GET, POST, ...)" },
@@ -6400,6 +6566,7 @@ var INTEGRATION_OPERATORS = {
     maxArity: 2,
     description: "Get a GitHub repository. Typed wrapper for the GitHub API.",
     hasSideEffects: true,
+    runsOn: "any",
     returnType: "object",
     params: [
       { name: "owner", type: "string", description: "Repository owner" },
@@ -6414,6 +6581,7 @@ var INTEGRATION_OPERATORS = {
     maxArity: 3,
     description: "Create a GitHub issue. Typed wrapper for the GitHub API.",
     hasSideEffects: true,
+    runsOn: "any",
     returnType: "object",
     params: [
       { name: "repo", type: "string", description: "Full repo name (owner/repo)" },

package/dist/modules/integration.d.ts

@@ -1,4 +1,4 @@
-import { S as StdOperatorMeta } from '../types-DpbKBJu8.js';
+import { S as StdOperatorMeta } from '../types-DwAW4Nni.js';
 
 /**
  * Integration Module - External integration operators (HTTP, GitHub, etc.)