@dxos/compute 0.8.4-main.fd6878d → 0.9.0

package/LICENSE

@@ -1,8 +1,105 @@
-MIT License 
-Copyright (c) 2022 DXOS
+# Functional Source License, Version 1.1, ALv2 Future License
 
-Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
+## Abbreviation
 
-The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
+FSL-1.1-Apache-2.0
 
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+## Notice
+
+Copyright 2026 DXOS
+
+## Terms and Conditions
+
+### Licensor ("We")
+
+The party offering the Software under these Terms and Conditions.
+
+### The Software
+
+The "Software" is each version of the software that we make available under
+these Terms and Conditions, as indicated by our inclusion of these Terms and
+Conditions with the Software.
+
+### License Grant
+
+Subject to your compliance with this License Grant and the Patents,
+Redistribution and Trademark clauses below, we hereby grant you the right to
+use, copy, modify, create derivative works, publicly perform, publicly display
+and redistribute the Software for any Permitted Purpose identified below.
+
+### Permitted Purpose
+
+A Permitted Purpose is any purpose other than a Competing Use. A Competing Use
+means making the Software available to others in a commercial product or
+service that:
+
+1. substitutes for the Software;
+
+2. substitutes for any other product or service we offer using the Software
+   that exists as of the date we make the Software available; or
+
+3. offers the same or substantially similar functionality as the Software.
+
+Permitted Purposes specifically include using the Software:
+
+1. for your internal use and access;
+
+2. for non-commercial education;
+
+3. for non-commercial research; and
+
+4. in connection with professional services that you provide to a licensee
+   using the Software in accordance with these Terms and Conditions.
+
+### Patents
+
+To the extent your use for a Permitted Purpose would necessarily infringe our
+patents, the license grant above includes a license under our patents. If you
+make a claim against any party that the Software infringes or contributes to
+the infringement of any patent, then your patent license to the Software ends
+immediately.
+
+### Redistribution
+
+The Terms and Conditions apply to all copies, modifications and derivatives of
+the Software.
+
+If you redistribute any copies, modifications or derivatives of the Software,
+you must include a copy of or a link to these Terms and Conditions and not
+remove any copyright notices provided in or with the Software.
+
+### Disclaimer
+
+THE SOFTWARE IS PROVIDED "AS IS" AND WITHOUT WARRANTIES OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING WITHOUT LIMITATION WARRANTIES OF FITNESS FOR A PARTICULAR
+PURPOSE, MERCHANTABILITY, TITLE OR NON-INFRINGEMENT.
+
+IN NO EVENT WILL WE HAVE ANY LIABILITY TO YOU ARISING OUT OF OR RELATED TO THE
+SOFTWARE, INCLUDING INDIRECT, SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES,
+EVEN IF WE HAVE BEEN INFORMED OF THEIR POSSIBILITY IN ADVANCE.
+
+### Trademarks
+
+Except for displaying the License Details and identifying us as the origin of
+the Software, you have no right under these Terms and Conditions to use our
+trademarks, trade names, service marks or product names.
+
+## Grant of Future License
+
+We hereby irrevocably grant you an additional license to use the Software under
+the Apache License, Version 2.0 that is effective on the second anniversary of
+the date we make the Software available. On or after that date, you may use the
+Software under the Apache License, Version 2.0, in which case the following
+will apply:
+
+Licensed under the Apache License, Version 2.0 (the "License"); you may not use
+this file except in compliance with the License.
+
+You may obtain a copy of the License at
+
+http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing, software distributed
+under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR
+CONDITIONS OF ANY KIND, either express or implied. See the License for the
+specific language governing permissions and limitations under the License.

package/README.md

@@ -1,3 +1,38 @@
 # @dxos/compute
 
-Basic compute API.
+Umbrella package for AI-aware DXOS compute primitives.
+
+## Usage
+
+Importing from `@dxos/compute` is equivalent to importing from the underlying
+source packages. Namespaces preserve their nesting — there is no extra wrapping
+or unwrapping:
+
+```ts
+import { Blueprint, Operation, Routine, Process, Script, Trace, Trigger } from '@dxos/compute';
+
+Blueprint.make({ /* ... */ });
+Operation.lazy(() => /* ... */);
+Trace.write(Trace.OperationStart, { /* ... */ });
+```
+
+This single surface subsumes:
+
+| Re-exported from   | Includes                                                        |
+| ------------------ | --------------------------------------------------------------- |
+| `@dxos/operation`  | `Operation`, `OperationInvoker`, `OperationHandlerSet`, `OperationRegistry`, errors |
+| `@dxos/blueprints` | `Blueprint`, `Routine`, `Template`                              |
+| `@dxos/functions`  | `Process`, `Trigger`, `TriggerEvent`, `Script`, `Trace`, `ServiceResolver`, `StorageService`, `CredentialsService`, `ExampleHandlers`, services, errors, sdk |
+
+The HyperFormula-based compute graph that previously lived here moved to
+[`@dxos/compute-hyperformula`](../compute-hyperformula).
+
+## Roadmap
+
+- Stage 1 (current): re-exports — consumers depend only on `@dxos/compute`
+  while the source packages stay in place.
+- Stage 2: migrate source into `@dxos/compute` and remove
+  `@dxos/operation`, `@dxos/blueprints`, and `@dxos/functions`.
+- A companion `@dxos/compute-runtime-local` package will host the local
+  implementations of the services defined here (currently in
+  `@dxos/functions-runtime`).

package/dist/lib/neutral/StorageService.mjs

@@ -0,0 +1,22 @@
+import {
+  StorageService,
+  clear,
+  deleteKey,
+  get,
+  key,
+  list,
+  set,
+  withDefault
+} from "./chunk-XEVFBI6S.mjs";
+import "./chunk-J5LGTIGS.mjs";
+export {
+  StorageService,
+  clear,
+  deleteKey,
+  get,
+  key,
+  list,
+  set,
+  withDefault
+};
+//# sourceMappingURL=StorageService.mjs.map

package/dist/lib/neutral/chunk-2B2KSJT6.mjs

@@ -0,0 +1,17 @@
+import {
+  Sleep
+} from "./chunk-JAU4E4EK.mjs";
+import {
+  withHandler
+} from "./chunk-QZS4G6PE.mjs";
+
+// src/testing/sleep.ts
+import * as Effect from "effect/Effect";
+var sleep_default = Sleep.pipe(withHandler(Effect.fn(function* ({ duration = 1e5 }) {
+  yield* Effect.sleep(duration);
+})));
+
+export {
+  sleep_default
+};
+//# sourceMappingURL=chunk-2B2KSJT6.mjs.map

package/dist/lib/neutral/chunk-2B2KSJT6.mjs.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/testing/sleep.ts"],
+  "sourcesContent": ["//\n// Copyright 2025 DXOS.org\n//\n\nimport * as Effect from 'effect/Effect';\n\nimport * as Operation from '../Operation';\nimport { Sleep } from './definitions';\n\nexport default Sleep.pipe(\n  Operation.withHandler(\n    Effect.fn(function* ({ duration = 100_000 }) {\n      yield* Effect.sleep(duration);\n    }),\n  ),\n);\n"],
+  "mappings": ";;;;;;;;AAIA,YAAYA,YAAY;AAKxB,IAAA,gBAAeC,MAAMC,KACTC,YACDC,UAAG,WAAW,EAAEC,WAAW,IAAO,GAAE;AACzC,SAAcC,aAAMD,QAAAA;AACtB,CAAA,CAAA,CAAA;",
+  "names": ["Effect", "Sleep", "pipe", "withHandler", "fn", "duration", "sleep"]
+}

package/dist/lib/neutral/chunk-AFBNVFAY.mjs

@@ -0,0 +1,25 @@
+import {
+  Fibonacci
+} from "./chunk-JAU4E4EK.mjs";
+import {
+  withHandler
+} from "./chunk-QZS4G6PE.mjs";
+
+// src/testing/fib.ts
+import * as Effect from "effect/Effect";
+var fib_default = Fibonacci.pipe(withHandler(Effect.fn(function* ({ iterations = 1e5 }) {
+  let a = 0n;
+  let b = 1n;
+  for (let i = 0; i < iterations; i++) {
+    a += b;
+    b = a - b;
+  }
+  return {
+    result: a.toString()
+  };
+})));
+
+export {
+  fib_default
+};
+//# sourceMappingURL=chunk-AFBNVFAY.mjs.map

package/dist/lib/neutral/chunk-AFBNVFAY.mjs.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/testing/fib.ts"],
+  "sourcesContent": ["//\n// Copyright 2025 DXOS.org\n//\n\nimport * as Effect from 'effect/Effect';\n\nimport * as Operation from '../Operation';\nimport { Fibonacci } from './definitions';\n\nexport default Fibonacci.pipe(\n  Operation.withHandler(\n    Effect.fn(function* ({ iterations = 100_000 }) {\n      let a = 0n;\n      let b = 1n;\n      for (let i = 0; i < iterations; i++) {\n        a += b;\n        b = a - b;\n      }\n      return { result: a.toString() };\n    }),\n  ),\n);\n"],
+  "mappings": ";;;;;;;;AAIA,YAAYA,YAAY;AAKxB,IAAA,cAAeC,UAAUC,KACbC,YACDC,UAAG,WAAW,EAAEC,aAAa,IAAO,GAAE;AAC3C,MAAIC,IAAI;AACR,MAAIC,IAAI;AACR,WAASC,IAAI,GAAGA,IAAIH,YAAYG,KAAK;AACnCF,SAAKC;AACLA,QAAID,IAAIC;EACV;AACA,SAAO;IAAEE,QAAQH,EAAEI,SAAQ;EAAG;AAChC,CAAA,CAAA,CAAA;",
+  "names": ["Effect", "Fibonacci", "pipe", "withHandler", "fn", "iterations", "a", "b", "i", "result", "toString"]
+}

package/dist/lib/neutral/chunk-J5LGTIGS.mjs

@@ -0,0 +1,10 @@
+var __defProp = Object.defineProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+
+export {
+  __export
+};
+//# sourceMappingURL=chunk-J5LGTIGS.mjs.map

package/dist/lib/neutral/chunk-JAU4E4EK.mjs

@@ -0,0 +1,53 @@
+import {
+  make
+} from "./chunk-QZS4G6PE.mjs";
+
+// src/testing/definitions.ts
+import * as Schema from "effect/Schema";
+import { DXN } from "@dxos/keys";
+var Fibonacci = make({
+  meta: {
+    key: DXN.make("org.example.function.fib"),
+    name: "Fibonacci",
+    description: "Function that calculates a Fibonacci number"
+  },
+  input: Schema.Struct({
+    iterations: Schema.optional(Schema.Number).annotations({
+      description: "Number of iterations",
+      default: 1e5
+    })
+  }),
+  output: Schema.Struct({
+    result: Schema.String
+  })
+});
+var Reply = make({
+  meta: {
+    key: DXN.make("org.example.function.reply"),
+    name: "Reply",
+    description: "Function that echoes the input"
+  },
+  input: Schema.Any,
+  output: Schema.Any
+});
+var Sleep = make({
+  meta: {
+    key: DXN.make("org.example.function.sleep"),
+    name: "Sleep",
+    description: "Function that sleeps for a given amount of time"
+  },
+  input: Schema.Struct({
+    duration: Schema.optional(Schema.Number).annotations({
+      description: "Milliseconds to sleep",
+      default: 1e5
+    })
+  }),
+  output: Schema.Void
+});
+
+export {
+  Fibonacci,
+  Reply,
+  Sleep
+};
+//# sourceMappingURL=chunk-JAU4E4EK.mjs.map

package/dist/lib/neutral/chunk-JAU4E4EK.mjs.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/testing/definitions.ts"],
+  "sourcesContent": ["//\n// Copyright 2025 DXOS.org\n//\n\nimport * as Schema from 'effect/Schema';\n\nimport { DXN } from '@dxos/keys';\n\nimport * as Operation from '../Operation';\n\nexport const Fibonacci = Operation.make({\n  meta: {\n    key: DXN.make('org.example.function.fib'),\n    name: 'Fibonacci',\n    description: 'Function that calculates a Fibonacci number',\n  },\n  input: Schema.Struct({\n    iterations: Schema.optional(Schema.Number).annotations({\n      description: 'Number of iterations',\n      default: 100_000,\n    }),\n  }),\n  output: Schema.Struct({\n    result: Schema.String,\n  }),\n});\n\nexport const Reply = Operation.make({\n  meta: {\n    key: DXN.make('org.example.function.reply'),\n    name: 'Reply',\n    description: 'Function that echoes the input',\n  },\n  input: Schema.Any,\n  output: Schema.Any,\n});\n\nexport const Sleep = Operation.make({\n  meta: {\n    key: DXN.make('org.example.function.sleep'),\n    name: 'Sleep',\n    description: 'Function that sleeps for a given amount of time',\n  },\n  input: Schema.Struct({\n    duration: Schema.optional(Schema.Number).annotations({\n      description: 'Milliseconds to sleep',\n      default: 100_000,\n    }),\n  }),\n  output: Schema.Void,\n});\n"],
+  "mappings": ";;;;;AAIA,YAAYA,YAAY;AAExB,SAASC,WAAW;AAIb,IAAMC,YAAsBC,KAAK;EACtCC,MAAM;IACJC,KAAKC,IAAIH,KAAK,0BAAA;IACdI,MAAM;IACNC,aAAa;EACf;EACAC,OAAcC,cAAO;IACnBC,YAAmBC,gBAAgBC,aAAM,EAAEC,YAAY;MACrDN,aAAa;MACbO,SAAS;IACX,CAAA;EACF,CAAA;EACAC,QAAeN,cAAO;IACpBO,QAAeC;EACjB,CAAA;AACF,CAAA;AAEO,IAAMC,QAAkBhB,KAAK;EAClCC,MAAM;IACJC,KAAKC,IAAIH,KAAK,4BAAA;IACdI,MAAM;IACNC,aAAa;EACf;EACAC,OAAcW;EACdJ,QAAeI;AACjB,CAAA;AAEO,IAAMC,QAAkBlB,KAAK;EAClCC,MAAM;IACJC,KAAKC,IAAIH,KAAK,4BAAA;IACdI,MAAM;IACNC,aAAa;EACf;EACAC,OAAcC,cAAO;IACnBY,UAAiBV,gBAAgBC,aAAM,EAAEC,YAAY;MACnDN,aAAa;MACbO,SAAS;IACX,CAAA;EACF,CAAA;EACAC,QAAeO;AACjB,CAAA;",
+  "names": ["Schema", "DXN", "Fibonacci", "make", "meta", "key", "DXN", "name", "description", "input", "Struct", "iterations", "optional", "Number", "annotations", "default", "output", "result", "String", "Reply", "Any", "Sleep", "duration", "Void"]
+}

package/dist/lib/neutral/chunk-MEPE4HHX.mjs

@@ -0,0 +1,21 @@
+import {
+  Reply
+} from "./chunk-JAU4E4EK.mjs";
+import {
+  withHandler
+} from "./chunk-QZS4G6PE.mjs";
+
+// src/testing/reply.ts
+import * as Console from "effect/Console";
+import * as Effect from "effect/Effect";
+var reply_default = Reply.pipe(withHandler(Effect.fn(function* (input) {
+  yield* Console.log("reply", {
+    input
+  });
+  return input;
+})));
+
+export {
+  reply_default
+};
+//# sourceMappingURL=chunk-MEPE4HHX.mjs.map

package/dist/lib/neutral/chunk-MEPE4HHX.mjs.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/testing/reply.ts"],
+  "sourcesContent": ["//\n// Copyright 2025 DXOS.org\n//\n\nimport * as Console from 'effect/Console';\nimport * as Effect from 'effect/Effect';\n\nimport * as Operation from '../Operation';\nimport { Reply } from './definitions';\n\nexport default Reply.pipe(\n  Operation.withHandler(\n    Effect.fn(function* (input) {\n      yield* Console.log('reply', { input });\n      return input;\n    }),\n  ),\n);\n"],
+  "mappings": ";;;;;;;;AAIA,YAAYA,aAAa;AACzB,YAAYC,YAAY;AAKxB,IAAA,gBAAeC,MAAMC,KACTC,YACDC,UAAG,WAAWC,OAAK;AACxB,SAAeC,YAAI,SAAS;IAAED;EAAM,CAAA;AACpC,SAAOA;AACT,CAAA,CAAA,CAAA;",
+  "names": ["Console", "Effect", "Reply", "pipe", "withHandler", "fn", "input", "log"]
+}

package/dist/lib/neutral/chunk-QZS4G6PE.mjs

@@ -0,0 +1,240 @@
+import {
+  __export
+} from "./chunk-J5LGTIGS.mjs";
+
+// src/Operation.ts
+var Operation_exports = {};
+__export(Operation_exports, {
+  DefinitionTypeId: () => DefinitionTypeId,
+  IdempotentAnnotation: () => IdempotentAnnotation,
+  PersistentOperation: () => PersistentOperation,
+  PersistentOperation_v0_1_0: () => PersistentOperation_v0_1_0,
+  Service: () => Service,
+  deserialize: () => deserialize,
+  getKey: () => getKey,
+  getVersion: () => getVersion,
+  invoke: () => invoke,
+  isIdempotent: () => isIdempotent,
+  isOperationDefinition: () => isOperationDefinition,
+  isOperationWithHandler: () => isOperationWithHandler,
+  make: () => make,
+  migrations: () => migrations,
+  opaqueHandler: () => opaqueHandler,
+  schedule: () => schedule,
+  serialize: () => serialize,
+  setFrom: () => setFrom,
+  withHandler: () => withHandler,
+  withInvocationOptions: () => withInvocationOptions
+});
+import * as Context from "effect/Context";
+import * as Effect from "effect/Effect";
+import * as Layer from "effect/Layer";
+import * as Option from "effect/Option";
+import * as Pipeable from "effect/Pipeable";
+import * as Schema$ from "effect/Schema";
+import { DXN, Annotation, JsonSchema, Migration, Obj, Ref, Type } from "@dxos/echo";
+var DefinitionTypeId = "~@dxos/operation/OperationDefinition";
+var isOperationDefinition = (value) => {
+  return typeof value === "object" && value !== null && DefinitionTypeId in value;
+};
+var isOperationWithHandler = (value) => {
+  return isOperationDefinition(value) && "handler" in value;
+};
+var make = (props) => {
+  return {
+    [DefinitionTypeId]: {},
+    ...props,
+    executionMode: props.executionMode ?? "async",
+    types: props.types ?? [],
+    services: props.services ?? [],
+    pipe() {
+      return Pipeable.pipeArguments(this, arguments);
+    }
+  };
+};
+var withHandler = (opOrHandler, handler) => {
+  if (handler === void 0) {
+    const handlerFn = opOrHandler;
+    return (op2) => ({
+      ...op2,
+      handler: handlerFn
+    });
+  }
+  const op = opOrHandler;
+  return {
+    ...op,
+    handler
+  };
+};
+var opaqueHandler = (handler) => handler;
+var PersistentOperation = Schema$.Struct({
+  name: Schema$.NonEmptyString,
+  description: Schema$.optional(Schema$.String),
+  /**
+  * ISO date string of the last deployment.
+  */
+  updated: Schema$.optional(Schema$.String),
+  // Reference to a source script if it exists within ECHO.
+  // TODO(burdon): Don't ref ScriptType directly (core).
+  source: Schema$.optional(Ref.Ref(Obj.Unknown)),
+  inputSchema: Schema$.optional(JsonSchema.JsonSchema),
+  outputSchema: Schema$.optional(JsonSchema.JsonSchema),
+  /**
+  * List of required services.
+  * Match the Context.Tag keys of the FunctionServices variants.
+  */
+  services: Schema$.optional(Schema$.Array(Schema$.String)),
+  // Local binding to a function name.
+  // TODO(dmaretskyi): Add this field to Operation.Definition.
+  binding: Schema$.optional(Schema$.String),
+  /**
+  * Phosphor icon identifier in `ph--<name>--<variant>` format (e.g. `ph--file-text--regular`).
+  */
+  icon: Schema$.optional(Schema$.String)
+}).pipe(
+  Annotation.LabelAnnotation.set([
+    "name"
+  ]),
+  Annotation.IconAnnotation.set({
+    icon: "ph--function--regular",
+    hue: "blue"
+  }),
+  Annotation.HiddenAnnotation.set(true),
+  // TODO(dmaretskyi): Keep typename as 'org.dxos.type.function' (not 'operation') to maintain
+  //  backward compatibility with existing data and avoid requiring data migration.
+  Type.makeObject(DXN.make("org.dxos.type.function", "0.2.0"))
+);
+var FUNCTION_META_KEY = "org.dxos.service.function";
+var getKey = (record) => Obj.getMeta(record).key;
+var getVersion = (record) => Obj.getMeta(record).version;
+var serialize = (operation) => {
+  return Obj.make(PersistentOperation, {
+    [Obj.Meta]: {
+      key: operation.meta.key,
+      version: operation.meta.version ?? "0.0.0",
+      keys: operation.meta.deployedId ? [
+        {
+          source: FUNCTION_META_KEY,
+          id: operation.meta.deployedId
+        }
+      ] : [],
+      annotations: operation.meta.annotations
+    },
+    name: operation.meta.name ?? "",
+    description: operation.meta.description,
+    icon: operation.meta.icon,
+    updated: void 0,
+    source: void 0,
+    inputSchema: JsonSchema.toJsonSchema(operation.input),
+    outputSchema: JsonSchema.toJsonSchema(operation.output),
+    services: operation.services.map((service) => service.key)
+  });
+};
+var deserialize = (record) => {
+  const meta = Obj.getMeta(record);
+  const deployedId = meta.keys.find((key) => key.source === FUNCTION_META_KEY)?.id;
+  return make({
+    input: record.inputSchema ? JsonSchema.toEffectSchema(record.inputSchema) : Schema$.Unknown,
+    output: record.outputSchema ? JsonSchema.toEffectSchema(record.outputSchema) : Schema$.Unknown,
+    services: record.services?.map((service) => Context.GenericTag(service)) ?? [],
+    executionMode: "async",
+    types: [],
+    meta: {
+      key: DXN.tryMake(meta.key ?? record.name) ?? DXN.make(meta.key ?? record.name),
+      name: record.name,
+      version: meta.version ?? "0.0.0",
+      description: record.description,
+      icon: record.icon,
+      deployedId,
+      annotations: meta.annotations ?? {}
+    }
+  });
+};
+var setFrom = (target, source) => {
+  Obj.update(target, (target2) => {
+    target2.name = source.name ?? target2.name;
+    target2.description = source.description;
+    target2.icon = source.icon;
+    target2.updated = source.updated;
+    target2.inputSchema = source.inputSchema ? JSON.parse(JSON.stringify(source.inputSchema)) : void 0;
+    target2.outputSchema = source.outputSchema ? JSON.parse(JSON.stringify(source.outputSchema)) : void 0;
+    const sourceMeta = Obj.getMeta(source);
+    const targetMeta = Obj.getMeta(target2);
+    targetMeta.key = sourceMeta.key ?? targetMeta.key;
+    targetMeta.version = sourceMeta.version;
+    if (sourceMeta.keys.length > 0) {
+      targetMeta.keys = JSON.parse(JSON.stringify(sourceMeta.keys));
+    }
+    targetMeta.annotations = sourceMeta.annotations ?? targetMeta.annotations;
+  });
+};
+var IdempotentAnnotation = Annotation.make({
+  id: "org.dxos.operation.idempotent",
+  schema: Schema$.Boolean
+});
+var isIdempotent = (op) => op.meta.annotations ? Option.getOrElse(Annotation.getDictionary(op.meta.annotations, IdempotentAnnotation), () => false) : false;
+var Service = class extends Context.Tag("@dxos/operation/Service")() {
+};
+var invoke = (op, ...args) => Effect.flatMap(Service, (ops) => ops.invoke(op, ...args)).pipe(Effect.withSpan("Operation.invoke"));
+var schedule = (op, ...args) => Effect.flatMap(Service, (ops) => ops.schedule(op, ...args)).pipe(Effect.withSpan("Operation.schedule"));
+var withInvocationOptions = (options) => Layer.effect(Service, Effect.gen(function* () {
+  const service = yield* Service;
+  return Service.of({
+    invoke: (op, input, invocationOptions) => service.invoke(op, input, {
+      ...options,
+      ...invocationOptions
+    }),
+    invokePromise: (op, input, invocationOptions) => service.invokePromise(op, input, {
+      ...options,
+      ...invocationOptions
+    }),
+    schedule: (op, input, invocationOptions) => service.schedule(op, input, {
+      ...options,
+      ...invocationOptions
+    })
+  });
+}));
+var PersistentOperation_v0_1_0 = Schema$.Struct({
+  key: Schema$.optional(Schema$.String),
+  name: Schema$.NonEmptyString,
+  version: Schema$.String,
+  description: Schema$.optional(Schema$.String),
+  updated: Schema$.optional(Schema$.String),
+  source: Schema$.optional(Ref.Ref(Obj.Unknown)),
+  inputSchema: Schema$.optional(JsonSchema.JsonSchema),
+  outputSchema: Schema$.optional(JsonSchema.JsonSchema),
+  services: Schema$.optional(Schema$.Array(Schema$.String)),
+  binding: Schema$.optional(Schema$.String)
+}).pipe(Type.makeObject(DXN.make("org.dxos.type.function", "0.1.0")));
+var _migration = Migration.define({
+  from: PersistentOperation_v0_1_0,
+  to: PersistentOperation,
+  transform: async (from) => ({
+    [Obj.Meta]: {
+      key: from.key,
+      version: from.version
+    },
+    name: from.name,
+    description: from.description,
+    updated: from.updated,
+    source: from.source,
+    inputSchema: from.inputSchema,
+    outputSchema: from.outputSchema,
+    services: from.services,
+    binding: from.binding
+  })
+});
+var migrations = [
+  _migration
+];
+
+export {
+  make,
+  withHandler,
+  PersistentOperation,
+  deserialize,
+  isIdempotent,
+  invoke,
+  Operation_exports
+};
+//# sourceMappingURL=chunk-QZS4G6PE.mjs.map

package/dist/lib/neutral/chunk-QZS4G6PE.mjs.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/Operation.ts"],
+  "sourcesContent": ["//\n// Copyright 2025 DXOS.org\n//\n\n// @import-as-namespace\n\nimport * as Context from 'effect/Context';\nimport * as Effect from 'effect/Effect';\nimport * as Layer from 'effect/Layer';\nimport * as Option from 'effect/Option';\nimport * as Pipeable from 'effect/Pipeable';\nimport * as Schema$ from 'effect/Schema';\nimport type * as Types from 'effect/Types';\n\nimport { DXN, Annotation, JsonSchema, Migration, Obj, Ref, Type, type Key } from '@dxos/echo';\nimport type { URI } from '@dxos/keys';\n\nimport type { NoHandlerError } from './errors';\nimport type { Operation } from './index';\n\n/**\n * Schema type that accepts any Encoded form but requires no Context.\n * This allows ECHO object schemas where Type !== Encoded due to [KindId] symbol.\n */\ntype Schema<T> = Schema$.Schema<T, any, never>;\n\nexport const DefinitionTypeId = '~@dxos/operation/OperationDefinition' as const;\nexport type DefinitionTypeId = typeof DefinitionTypeId;\n\n/**\n * Serializable definition of an Operation.\n * Contains schema and metadata, but no runtime logic.\n */\nexport interface Definition<I, O, S = any> extends Pipeable.Pipeable, Definition.Variance<I, O, S> {\n  /**\n   * Input schema for the operation.\n   */\n  readonly input: Schema<I>;\n  /**\n   * Output schema for the operation.\n   */\n  readonly output: Schema<O>;\n\n  readonly meta: {\n    readonly key: DXN.DXN;\n    readonly name?: string;\n    readonly version?: string;\n    readonly description?: string;\n    /**\n     * Phosphor icon identifier in `ph--<name>--<variant>` format (e.g. `ph--file-text--regular`).\n     */\n    readonly icon?: string;\n    /**\n     * Deployment ID for remote invocation.\n     * Assigned by the EDGE function service when deployed.\n     */\n    readonly deployedId?: string;\n\n    /**\n     * Dictionary of annotations for the operation.\n     */\n    // TODO(dmaretskyi): Make required, but this complicates `make` to fill in defaults.\n    readonly annotations?: Annotation.Dictionary;\n\n    /**\n     * When true, this operation is not serialized into the hypergraph registry.\n     * Use for UI-only operations that should not be discoverable by the AI agent.\n     */\n    readonly skipRegistry?: boolean;\n  };\n\n  /**\n   * Execution mode for the operation.\n   * - 'sync': Operation completes synchronously (fast, UI-blocking acceptable).\n   * - 'async': Operation may take time (should not block UI).\n   */\n  readonly executionMode: 'sync' | 'async';\n\n  /**\n   * ECHO types the operation uses.\n   * Ensures types are available when the operation is executed remotely.\n   */\n  readonly types: readonly Type.AnyEntity[];\n\n  /**\n   * Effect services required by this operation.\n   * These services will be automatically provided to the handler at invocation time.\n   */\n  readonly services: readonly Context.Tag<any, any>[];\n}\n\n/**\n * Namespace for OperationDefinition helper types.\n */\nexport declare namespace Definition {\n  export interface Variance<I, O, S> {\n    [DefinitionTypeId]: {\n      readonly _Input: Types.Contravariant<I>;\n      readonly _Output: Types.Covariant<O>;\n      readonly _Services: Types.Covariant<S>;\n    };\n  }\n\n  /**\n   * Any operation definition, regardless of input/output types.\n   */\n  export type Any = Definition<any, any, any>;\n\n  /**\n   * Extract the input type from an operation definition.\n   */\n  export type Input<T extends Any> = T extends Variance<infer I, infer _O, infer _S> ? I : never;\n\n  /**\n   * Extract the output type from an operation definition.\n   */\n  export type Output<T extends Any> = T extends Variance<infer _I, infer O, infer _S> ? O : never;\n\n  /**\n   * Extract the service identifier types from an operation's services array.\n   * Returns `never` if the operation has no services declared.\n   */\n  export type Services<T extends Any> = T extends Variance<infer _I, infer _O, infer S> ? S : never;\n\n  export type HandlerType<T extends Any> =\n    T extends Variance<infer I, infer O, infer S> ? Handler<I, O, any, S> : never;\n}\n\n/**\n * Runtime handler for an Operation.\n */\nexport type Handler<I, O, E = Error, R = never> = (input: I) => Effect.Effect<O, E, R>;\n\nexport type WithHandler<T extends Definition.Any> = T & {\n  handler: Definition.HandlerType<T>;\n};\n\n/**\n * Checks if a value is an operation definition.\n */\nexport const isOperationDefinition = (value: unknown): value is Definition.Any => {\n  return typeof value === 'object' && value !== null && DefinitionTypeId in value;\n};\n\n/**\n * Checks if a value is an operation with a handler.\n */\nexport const isOperationWithHandler = (value: unknown): value is WithHandler<Definition.Any> => {\n  return isOperationDefinition(value) && 'handler' in value;\n};\n\n/**\n * Props for creating an Operation definition.\n * Derived from OperationDefinition with executionMode made optional (defaults to 'async').\n */\nexport type Props<I, O> = Omit<Definition<I, O>, DefinitionTypeId | 'pipe' | 'executionMode' | 'types' | 'services'> & {\n  readonly executionMode?: 'sync' | 'async';\n  readonly types?: Definition<I, O>['types'];\n  readonly services?: Definition<I, O>['services'];\n};\n\n/**\n * Creates a new Operation definition.\n * Applies default executionMode of 'async' if not specified.\n * The returned type preserves the literal types of props (including services).\n */\nexport const make = <const P extends Types.NoExcessProperties<Props<any, any>, P>>(\n  props: P,\n): Definition<\n  Schema$.Schema.Type<P['input']>,\n  Schema$.Schema.Type<P['output']>,\n  Context.Tag.Identifier<NonNullable<P['services']>[number]>\n> => {\n  return {\n    [DefinitionTypeId]: {},\n    ...props,\n    executionMode: props.executionMode ?? 'async',\n    types: props.types ?? [],\n    services: props.services ?? [],\n    pipe() {\n      // eslint-disable-next-line prefer-rest-params\n      return Pipeable.pipeArguments(this, arguments);\n    },\n  } as any;\n};\n\n/**\n * Attaches a handler to an Operation definition.\n * The handler may use any services declared in the operation, plus Operation.Service (always available).\n * Dual API: can be called directly or used in a pipe.\n *\n * @example\n * ```ts\n * const MyOp = Operation.make({\n *   input: Schema.Void,\n *   output: Schema.Void,\n *   meta: { key: 'my-op' },\n *   services: [DatabaseService],\n * });\n *\n * // Direct call - handler can use DatabaseService\n * const op = Operation.withHandler(MyOp, (input) =>\n *   Effect.gen(function* () {\n *     const db = yield* DatabaseService;\n *     return {};\n *   }),\n * );\n *\n * // Piped call\n * const op = MyOp.pipe(Operation.withHandler((input) => Effect.succeed({})));\n * ```\n */\nexport const withHandler: {\n  <Def extends Definition<any, any>, E = never>(\n    handler: Handler<Definition.Input<Def>, Definition.Output<Def>, E, Definition.Services<Def> | Service>,\n  ): (op: Def) => WithHandler<Def>;\n  <Def extends Definition<any, any>, E = never>(\n    op: Def,\n    handler: Handler<Definition.Input<Def>, Definition.Output<Def>, E, Definition.Services<Def> | Service>,\n  ): WithHandler<Def>;\n} = <Def extends Definition<any, any>, E = never>(\n  opOrHandler: Def | Handler<Definition.Input<Def>, Definition.Output<Def>, E, Definition.Services<Def> | Service>,\n  handler?: Handler<Definition.Input<Def>, Definition.Output<Def>, E, Definition.Services<Def> | Service>,\n): WithHandler<Def> => {\n  // If called with just handler (piped usage).\n  if (handler === undefined) {\n    const handlerFn = opOrHandler as Handler<\n      Definition.Input<Def>,\n      Definition.Output<Def>,\n      E,\n      Definition.Services<Def> | Service\n    >;\n    return ((op: Def) => ({\n      ...op,\n      handler: handlerFn,\n    })) as any;\n  }\n\n  // If called with both op and handler (direct usage).\n  const op = opOrHandler as Def;\n  return {\n    ...op,\n    handler,\n  } as any;\n};\n\n/**\n * Helper to make the handler type opaque.\n * Workaround for TypeScript's inability to infer the handler type from the operation definition:\n * ```\n * error TS2742: The inferred type of 'default' cannot be named without a reference.\n * ```\n *\n * Most of the time the exact handler type is not needed.\n *\n * @example\n * ```ts\n * const MyOp = Operation.make({\n *   input: Schema.Void,\n *   output: Schema.Void,\n *   meta: { key: 'my-op' },\n *   services: [DatabaseService],\n * });\n *\n * export default MyOp.pipe(\n *   Operation.withHandler(\n *     Effect.fn(function* (input) {\n *       return { result: 'ok' };\n *     }),\n *   ),\n *   Operation.opaqueHandler,\n * );\n * ```\n */\nexport const opaqueHandler = <T extends Operation.Definition.Any>(\n  handler: Operation.WithHandler<T>,\n): Operation.WithHandler<Operation.Definition.Any> => handler;\n\n//\n// Invocation Interfaces\n//\n\n/**\n * Local invocation of an operation.\n */\nexport type Invoke = <I, O, E>(op: Definition<I, O>, input: I) => Effect.Effect<O, E>;\n\n/**\n * Remote invocation of an operation.\n */\nexport type InvokeRemote = <I, O, E>(\n  op: Definition<I, O>,\n  input: I,\n  options?: { timeout?: number },\n) => Effect.Effect<O, E>;\n\n/**\n * Database record of an operation.\n * The registry `key` and `version` live in the object meta — access via\n * `Obj.getMeta(record).key` and `Obj.getMeta(record).version`.\n */\nexport const PersistentOperation = Schema$.Struct({\n  name: Schema$.NonEmptyString,\n\n  description: Schema$.optional(Schema$.String),\n\n  /**\n   * ISO date string of the last deployment.\n   */\n  updated: Schema$.optional(Schema$.String),\n\n  // Reference to a source script if it exists within ECHO.\n  // TODO(burdon): Don't ref ScriptType directly (core).\n  source: Schema$.optional(Ref.Ref(Obj.Unknown)),\n\n  inputSchema: Schema$.optional(JsonSchema.JsonSchema),\n  outputSchema: Schema$.optional(JsonSchema.JsonSchema),\n\n  /**\n   * List of required services.\n   * Match the Context.Tag keys of the FunctionServices variants.\n   */\n  services: Schema$.optional(Schema$.Array(Schema$.String)),\n\n  // Local binding to a function name.\n  // TODO(dmaretskyi): Add this field to Operation.Definition.\n  binding: Schema$.optional(Schema$.String),\n\n  /**\n   * Phosphor icon identifier in `ph--<name>--<variant>` format (e.g. `ph--file-text--regular`).\n   */\n  icon: Schema$.optional(Schema$.String),\n}).pipe(\n  Annotation.LabelAnnotation.set(['name']),\n  Annotation.IconAnnotation.set({ icon: 'ph--function--regular', hue: 'blue' }),\n  Annotation.HiddenAnnotation.set(true),\n  // TODO(dmaretskyi): Keep typename as 'org.dxos.type.function' (not 'operation') to maintain\n  //  backward compatibility with existing data and avoid requiring data migration.\n  Type.makeObject(DXN.make('org.dxos.type.function', '0.2.0')),\n);\nexport type PersistentOperation = Type.InstanceType<typeof PersistentOperation>;\n\nconst FUNCTION_META_KEY = 'org.dxos.service.function';\n\n/**\n * Get the registry key for a persistent operation record (from the object meta).\n */\nexport const getKey = (record: PersistentOperation): string | undefined => Obj.getMeta(record).key;\n\n/**\n * Get the registry version for a persistent operation record (from the object meta).\n */\nexport const getVersion = (record: PersistentOperation): string | undefined => Obj.getMeta(record).version;\n\n/**\n * Serialize an operation definition to a persistent operation record.\n */\nexport const serialize = (operation: Definition.Any): PersistentOperation => {\n  return Obj.make(PersistentOperation, {\n    [Obj.Meta]: {\n      key: operation.meta.key,\n      version: operation.meta.version ?? '0.0.0',\n      keys: operation.meta.deployedId ? [{ source: FUNCTION_META_KEY, id: operation.meta.deployedId }] : [],\n      annotations: operation.meta.annotations,\n    },\n    name: operation.meta.name ?? '',\n    description: operation.meta.description,\n    icon: operation.meta.icon,\n    updated: undefined,\n    source: undefined,\n    inputSchema: JsonSchema.toJsonSchema(operation.input),\n    outputSchema: JsonSchema.toJsonSchema(operation.output),\n    services: operation.services.map((service) => service.key),\n  });\n};\n\n/**\n * Deserialize a persistent operation record to an operation definition.\n */\nexport const deserialize = (record: PersistentOperation): Definition.Any => {\n  const meta = Obj.getMeta(record);\n  // Extract deployed function ID from ECHO meta keys (matches FUNCTIONS_META_KEY in @dxos/functions).\n  const deployedId = meta.keys.find((key) => key.source === FUNCTION_META_KEY)?.id;\n  return make({\n    input: record.inputSchema ? JsonSchema.toEffectSchema(record.inputSchema) : Schema$.Unknown,\n    output: record.outputSchema ? JsonSchema.toEffectSchema(record.outputSchema) : Schema$.Unknown,\n    services: record.services?.map((service) => Context.GenericTag(service)) ?? [],\n    executionMode: 'async',\n    types: [],\n    meta: {\n      key: DXN.tryMake(meta.key ?? record.name) ?? DXN.make(meta.key ?? record.name),\n      name: record.name,\n      version: meta.version ?? '0.0.0',\n      description: record.description,\n      icon: record.icon,\n      deployedId,\n      annotations: meta.annotations ?? {},\n    },\n  });\n};\n\n/**\n * Update properties on the target operation record from the source operation record.\n */\nexport const setFrom = (target: PersistentOperation, source: PersistentOperation) => {\n  Obj.update(target, (target) => {\n    target.name = source.name ?? target.name;\n    target.description = source.description;\n    target.icon = source.icon;\n    target.updated = source.updated;\n    // TODO(dmaretskyi): A workaround for an ECHO bug.\n    target.inputSchema = source.inputSchema ? JSON.parse(JSON.stringify(source.inputSchema)) : undefined;\n    target.outputSchema = source.outputSchema ? JSON.parse(JSON.stringify(source.outputSchema)) : undefined;\n    const sourceMeta = Obj.getMeta(source);\n    const targetMeta = Obj.getMeta(target);\n    targetMeta.key = sourceMeta.key ?? targetMeta.key;\n    targetMeta.version = sourceMeta.version;\n    // Only overwrite foreign keys when the source actually carries them; otherwise we'd wipe\n    // bindings (e.g. the deployedId set by `deserialize`) on records produced by `serialize`.\n    if (sourceMeta.keys.length > 0) {\n      targetMeta.keys = JSON.parse(JSON.stringify(sourceMeta.keys));\n    }\n    targetMeta.annotations = sourceMeta.annotations ?? targetMeta.annotations;\n  });\n};\n\n/**\n * Translatable label — a plain string or an i18next-style `[key, options]` tuple.\n * Defined locally to avoid a core dependency on UI translation packages; structurally compatible with\n * the app-level `Label` type so values flow into UI toasts unchanged.\n */\nexport type Label = string | [string, { ns: string | readonly string[]; count?: number; defaultValue?: string }];\n\n/**\n * Per-phase user notification messages for an invocation.\n * A phase is notified to the user iff its message is provided; messages are translatable {@link Label}s.\n */\nexport interface NotifyOptions {\n  /** Shown when the invocation starts. */\n  start?: Label;\n  /** Shown when the invocation succeeds. */\n  success?: Label;\n  /** Shown when the invocation fails. */\n  error?: Label;\n}\n\n/**\n * Options for operation invocation.\n */\nexport interface InvokeOptions {\n  /**\n   * Space ID to provide database context for the handler.\n   */\n  spaceId?: Key.SpaceId;\n  /**\n   * Request user-facing notifications at the given invocation phases.\n   */\n  notify?: NotifyOptions;\n  /**\n   * URI of the conversation feed (queue) — today always an EID, but typed as\n   * `URI.URI` to accommodate future entity-kind extensions. Narrow with `EID.parse`\n   * at the point of use.\n   * Passed to the process environment so nested operations can resolve AiContext.Service and related services.\n   */\n  conversation?: URI.URI;\n  /**\n   * Optional process-runtime tracing metadata (consumed by `@dxos/functions-runtime` when wired).\n   */\n  tracing?: unknown;\n}\n\n/**\n * Annotation that marks an operation as idempotent — safe to retry even if a previous execution\n * was interrupted mid-handler. When absent the operation is treated as non-idempotent, and the\n * process runtime will fail (rather than re-run) any handler that was interrupted.\n */\nexport const IdempotentAnnotation = Annotation.make({\n  id: 'org.dxos.operation.idempotent',\n  schema: Schema$.Boolean,\n});\n\n/**\n * Returns true when the operation is explicitly annotated as idempotent.\n */\nexport const isIdempotent = (op: Definition.Any): boolean =>\n  op.meta.annotations\n    ? Option.getOrElse(Annotation.getDictionary(op.meta.annotations, IdempotentAnnotation), () => false)\n    : false;\n\n/**\n * Operation service interface - provides unified access to operation invocation and scheduling.\n * This service is automatically provided to operation handlers.\n */\nexport interface OperationService {\n  /**\n   * Invoke an operation as an Effect.\n   * Returns an Effect that resolves to the operation output.\n   */\n  invoke: <I, O>(\n    op: Operation.Definition<I, O>,\n    ...args: void extends I ? [input?: I, options?: InvokeOptions] : [input: I, options?: InvokeOptions]\n  ) => Effect.Effect<O, NoHandlerError>;\n\n  /**\n   * Schedule an operation to run as a followup.\n   * The followup is tracked and won't be cancelled when the parent operation completes.\n   * Returns an Effect that completes immediately after scheduling.\n   */\n  schedule: <I, O>(\n    op: Operation.Definition<I, O>,\n    ...args: void extends I ? [input?: I, options?: InvokeOptions] : [input: I, options?: InvokeOptions]\n  ) => Effect.Effect<void>;\n\n  /**\n   * Invoke an operation and return a Promise.\n   * Useful for async contexts where Effect is not available.\n   */\n  invokePromise: <I, O>(\n    op: Operation.Definition<I, O>,\n    ...args: void extends I ? [input?: I, options?: InvokeOptions] : [input: I, options?: InvokeOptions]\n  ) => Promise<{ data?: O; error?: Error }>;\n}\n\n/**\n * Context tag for the Operation service.\n * Operation handlers can yield this to invoke other operations or schedule followups.\n *\n * @example\n * ```ts\n * const handler = (input) => Effect.gen(function* () {\n *   // Schedule a followup (fire and forget)\n *   yield* Operation.schedule(AnalyticsOperation, { event: 'completed' });\n *\n *   // Invoke another operation\n *   return yield* Operation.invoke(OtherOperation, { data: input.data });\n * });\n * ```\n */\n// TODO(dmaretskyi): Rename Operation.Invoker\nexport class Service extends Context.Tag('@dxos/operation/Service')<Service, OperationService>() {}\n\n//\n// Namespace functions - ergonomic access to Operation.Service methods.\n//\n\n/**\n * Invoke an operation as an Effect.\n * Yields the Operation.Service internally.\n *\n * @example\n * ```ts\n * yield* Operation.invoke(MyOperation, { data: 'test' });\n * ```\n */\nexport const invoke = <I, O>(\n  op: Operation.Definition<I, O>,\n  ...args: void extends I ? [input?: I, options?: InvokeOptions] : [input: I, options?: InvokeOptions]\n): Effect.Effect<O, NoHandlerError, Service> =>\n  Effect.flatMap(Service, (ops) => ops.invoke(op, ...(args as [I, InvokeOptions?]))).pipe(\n    Effect.withSpan('Operation.invoke'),\n  );\n\n/**\n * Schedule an operation to run as a followup.\n * Yields the Operation.Service internally.\n *\n * @example\n * ```ts\n * yield* Operation.schedule(AnalyticsOperation, { event: 'completed' });\n * yield* Operation.schedule(VoidOperation); // input optional when void\n * ```\n */\nexport const schedule = <I, O>(\n  op: Operation.Definition<I, O>,\n  ...args: void extends I ? [input?: I, options?: InvokeOptions] : [input: I, options?: InvokeOptions]\n): Effect.Effect<void, never, Service> =>\n  Effect.flatMap(Service, (ops) => ops.schedule(op, ...(args as [I, InvokeOptions?]))).pipe(\n    Effect.withSpan('Operation.schedule'),\n  );\n\n/**\n * Provides additional invocation options to all invocations.\n */\nexport const withInvocationOptions = (options: InvokeOptions): Layer.Layer<Service, never, Service> =>\n  Layer.effect(\n    Service,\n    Effect.gen(function* () {\n      const service = yield* Service;\n      return Service.of({\n        invoke: ((op: Operation.Definition.Any, input: any, invocationOptions: InvokeOptions) =>\n          service.invoke(op, input, { ...options, ...invocationOptions })) as any,\n        invokePromise: ((op: Operation.Definition.Any, input: any, invocationOptions: InvokeOptions) =>\n          service.invokePromise(op, input, { ...options, ...invocationOptions })) as any,\n        schedule: ((op: Operation.Definition.Any, input: any, invocationOptions: InvokeOptions) =>\n          service.schedule(op, input, { ...options, ...invocationOptions })) as any,\n      });\n    }),\n  );\n\n//\n// Legacy schemas and migrations.\n//\n\n/**\n * Persistent operation schema v0.1.0 — `key` and `version` are stored as data properties.\n * @deprecated Use {@link PersistentOperation} (v0.2.0) instead; the `key` and `version` now live in the object meta.\n */\nexport const PersistentOperation_v0_1_0 = Schema$.Struct({\n  key: Schema$.optional(Schema$.String),\n  name: Schema$.NonEmptyString,\n  version: Schema$.String,\n  description: Schema$.optional(Schema$.String),\n  updated: Schema$.optional(Schema$.String),\n  source: Schema$.optional(Ref.Ref(Obj.Unknown)),\n  inputSchema: Schema$.optional(JsonSchema.JsonSchema),\n  outputSchema: Schema$.optional(JsonSchema.JsonSchema),\n  services: Schema$.optional(Schema$.Array(Schema$.String)),\n  binding: Schema$.optional(Schema$.String),\n}).pipe(Type.makeObject(DXN.make('org.dxos.type.function', '0.1.0')));\nexport type PersistentOperation_v0_1_0 = Type.InstanceType<typeof PersistentOperation_v0_1_0>;\n\n/**\n * Migration from {@link PersistentOperation_v0_1_0} (v0.1.0) to {@link PersistentOperation} (v0.2.0).\n * Moves `key` and `version` from the data section into the object meta.\n */\nconst _migration = Migration.define({\n  from: PersistentOperation_v0_1_0,\n  to: PersistentOperation,\n  transform: async (from) => ({\n    [Obj.Meta]: { key: from.key, version: from.version },\n    name: from.name,\n    description: from.description,\n    updated: from.updated,\n    source: from.source as any,\n    inputSchema: from.inputSchema,\n    outputSchema: from.outputSchema,\n    services: from.services,\n    binding: from.binding,\n  }),\n});\n\n/**\n * Schema migrations exported by this module.\n * Exported as an array for extensibility — append future versions here.\n */\nexport const migrations = [_migration];\n"],
+  "mappings": "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",
+  "names": ["Context", "Effect", "Layer", "Option", "Pipeable", "Schema$", "DXN", "Annotation", "JsonSchema", "Migration", "Obj", "Ref", "Type", "DefinitionTypeId", "isOperationDefinition", "value", "isOperationWithHandler", "make", "props", "executionMode", "types", "services", "pipe", "pipeArguments", "arguments", "withHandler", "opOrHandler", "handler", "undefined", "handlerFn", "op", "opaqueHandler", "PersistentOperation", "Struct", "name", "NonEmptyString", "description", "optional", "String", "updated", "source", "Unknown", "inputSchema", "outputSchema", "Array", "binding", "icon", "LabelAnnotation", "set", "IconAnnotation", "hue", "HiddenAnnotation", "makeObject", "FUNCTION_META_KEY", "getKey", "record", "getMeta", "key", "getVersion", "version", "serialize", "operation", "Meta", "meta", "keys", "deployedId", "id", "annotations", "toJsonSchema", "input", "output", "map", "service", "deserialize", "find", "toEffectSchema", "GenericTag", "tryMake", "setFrom", "target", "update", "JSON", "parse", "stringify", "sourceMeta", "targetMeta", "length", "IdempotentAnnotation", "schema", "Boolean", "isIdempotent", "getOrElse", "getDictionary", "Service", "Tag", "invoke", "args", "flatMap", "ops", "withSpan", "schedule", "withInvocationOptions", "options", "effect", "gen", "of", "invocationOptions", "invokePromise", "PersistentOperation_v0_1_0", "_migration", "define", "from", "to", "transform", "migrations"]
+}