@almadar/std 16.227.0 → 16.228.0

package/dist/registry.js

@@ -382,6 +382,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")' },
@@ -404,6 +405,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" },
@@ -426,6 +428,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" },
@@ -482,6 +485,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)" },
@@ -508,6 +512,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" }
   },
@@ -518,6 +523,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" },
@@ -533,6 +539,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"]',
@@ -545,6 +552,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" },
@@ -565,6 +573,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 }
@@ -579,6 +588,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" },
@@ -626,6 +636,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" },
@@ -657,6 +668,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" },
@@ -677,6 +689,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" },
@@ -717,6 +730,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",
@@ -724,6 +809,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")' },
@@ -757,6 +843,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, ...)" },
@@ -894,6 +981,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",
@@ -3082,6 +3191,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" },
@@ -3096,6 +3206,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" },
@@ -3110,6 +3221,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" },
@@ -3124,6 +3236,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" },
@@ -3138,6 +3251,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" },
@@ -3152,6 +3266,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" },
@@ -3168,6 +3283,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"]]'
@@ -3179,6 +3295,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"]]'
@@ -3190,6 +3307,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"]]'
@@ -3344,6 +3462,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" },
@@ -3902,6 +4021,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" },
@@ -3917,6 +4037,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" },
@@ -4014,6 +4135,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" },
@@ -4044,6 +4166,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" },
@@ -4120,6 +4243,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" },
@@ -4135,6 +4259,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" },
@@ -4200,6 +4325,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" },
@@ -4229,6 +4355,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" },
@@ -4671,6 +4798,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]'
@@ -4763,6 +4891,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]]'
@@ -4891,6 +5020,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")' },
@@ -4905,6 +5035,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")' },
@@ -4919,6 +5050,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" },
@@ -4933,6 +5065,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/*")' },
@@ -4947,6 +5080,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)' }
@@ -4960,6 +5094,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"' }
@@ -4973,6 +5108,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" }
@@ -4986,6 +5122,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" },
@@ -5004,6 +5141,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: [
       {
@@ -5044,6 +5182,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",
@@ -5058,6 +5197,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" }
@@ -5075,6 +5215,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",
@@ -5096,6 +5237,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: [
       {
@@ -5844,6 +5986,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" },
@@ -5858,6 +6001,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" },
@@ -5872,6 +6016,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" }
@@ -5896,6 +6041,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")' },
@@ -5910,6 +6056,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 }
@@ -5938,6 +6085,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" },
@@ -5963,6 +6111,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" },
@@ -6010,6 +6159,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"}]}]'
@@ -6032,6 +6182,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"]]'
@@ -6043,6 +6194,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"]'
@@ -6069,6 +6221,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" },
@@ -6094,6 +6247,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" },
@@ -6119,6 +6273,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" },
@@ -6144,6 +6299,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" },
@@ -6187,6 +6343,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" },
@@ -6219,6 +6376,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" },
@@ -6233,6 +6391,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" },
@@ -6251,6 +6410,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"]'
@@ -6262,6 +6422,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"]'
@@ -6273,6 +6434,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")' },
@@ -6288,6 +6450,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" },
@@ -6303,6 +6466,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" },
@@ -6318,6 +6482,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" },
@@ -6336,6 +6501,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, ...)" },
@@ -6352,6 +6518,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" },
@@ -6366,6 +6533,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)" },
@@ -6507,6 +6675,12 @@ function isStdEffectOperator(operator) {
   const meta = STD_OPERATORS[operator];
   return meta?.hasSideEffects ?? false;
 }
+function getOperatorRunsOn(operator) {
+  return STD_OPERATORS[operator]?.runsOn;
+}
+function getOperatorsRunningOn(site) {
+  return Object.keys(STD_OPERATORS).filter((name) => STD_OPERATORS[name].runsOn === site).sort();
+}
 function getOperatorMetaExtended(operator, coreOperators) {
   if (isStdOperator(operator)) {
     return STD_OPERATORS[operator];
@@ -6556,4 +6730,4 @@ function getStdLibStats() {
   };
 }
 
-export { OPERATOR_NAMES, STD_OPERATORS, STD_OPERATORS_BY_MODULE, assertOperatorArity, getAllStdOperators, getLambdaOperators, getModuleOperators, getOperatorMetaExtended, getStdEffectOperators, getStdLibStats, getStdOperatorMeta, getStdOperatorsByModule, getStdPureOperators, isEffectOperatorExtended, isKnownOperatorExtended, isKnownStdOperator, isStdEffectOperator, isStdGuardOperator, validateOperatorArityExtended, validateStdOperatorArity };
+export { OPERATOR_NAMES, STD_OPERATORS, STD_OPERATORS_BY_MODULE, assertOperatorArity, getAllStdOperators, getLambdaOperators, getModuleOperators, getOperatorMetaExtended, getOperatorRunsOn, getOperatorsRunningOn, getStdEffectOperators, getStdLibStats, getStdOperatorMeta, getStdOperatorsByModule, getStdPureOperators, isEffectOperatorExtended, isKnownOperatorExtended, isKnownStdOperator, isStdEffectOperator, isStdGuardOperator, validateOperatorArityExtended, validateStdOperatorArity };