@dxos/compute 0.8.4-main.fd6878d → 0.9.0

package/dist/types/src/Blueprint.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Blueprint.d.ts","sourceRoot":"","sources":["../../../src/Blueprint.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AACxC,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AAGxC,OAAO,EAAmB,QAAQ,EAAU,SAAS,EAAE,GAAG,EAAE,QAAQ,EAAE,IAAI,EAAE,GAAG,EAAE,MAAM,YAAY,CAAC;AACpG,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAGzC,OAAO,KAAK,SAAS,MAAM,aAAa,CAAC;AAGzC;;;;;;;GAOG;AAEH,eAAO,MAAM,SAAS;;;;;;;;;;;;;;;;;;;;;;;wBA6CrB,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,SAAS,GAAG,IAAI,CAAC,YAAY,CAAC,OAAO,SAAS,CAAC,CAAC;AAE5D,KAAK,SAAS,GAAG;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAAG,OAAO,CAAC,SAAS,CAAC,CAAC;AAEtF;;;GAGG;AACH,eAAO,MAAM,IAAI,oDAA4E,SAAS;;;;;;;;;;;;;;;;;;;;;;;wFAMlG,CAAC;AAEL;;GAEG;AACH,eAAO,MAAM,MAAM,cAAe,SAAS,KAAG,MAM7C,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,UAAU,cAAe,SAAS,KAAG,MAAM,GAAG,SAA2C,CAAC;AAEvG;;GAEG;AACH,eAAO,MAAM,eAAe,2BAGzB;IACD,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB,UAAU,CAAC,EAAE,SAAS,CAAC,UAAU,CAAC,GAAG,EAAE,CAAC;CACzC,wDAAkH,CAAC;AAEpH;;GAEG;AACH,MAAM,MAAM,UAAU,GAAG;IACvB,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,SAAS,CAAC;CACvB,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,WAAW,QAAS,MAAM,KAAG,GAAG,CAAC,GAA8D,CAAC;AAE7G;;;GAGG;AACH,eAAO,MAAM,OAAO,QAAS,MAAM,KAAG,MAAM,CAAC,MAAM,CAAC,SAAS,EAAE,aAAa,EAAE,QAAQ,CAAC,OAAO,CAQ1F,CAAC;AAEL;;;;;GAKG;AAEH,eAAO,MAAM,MAAM,QAAS,MAAM,KAAG,MAAM,CAAC,MAAM,CAAC,SAAS,EAAE,aAAa,EAAE,QAAQ,CAAC,OAAO,GAAG,QAAQ,CAAC,OAAO,CAO5G,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAEL,qBAAa,aAAc,SAAQ,kBAA4D;CAAG;AAMlG;;;GAGG;AACH,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;wBAsByC,CAAC;AAEvE,MAAM,MAAM,gBAAgB,GAAG,IAAI,CAAC,YAAY,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAmB1E;;;GAGG;AACH,eAAO,MAAM,UAAU,6BAAe,CAAC"}

package/dist/types/src/Credential.d.ts

@@ -0,0 +1,27 @@
+import * as Context from 'effect/Context';
+import * as Effect from 'effect/Effect';
+import * as Redacted from 'effect/Redacted';
+export type CredentialQuery = {
+    service?: string;
+};
+export type ServiceCredential = {
+    service: string;
+    apiKey?: string;
+};
+declare const CredentialsService_base: Context.TagClass<CredentialsService, "@dxos/functions/CredentialsService", {
+    /**
+     * Query all.
+     */
+    queryCredentials: (query: CredentialQuery) => Promise<ServiceCredential[]>;
+    /**
+     * Get a single credential.
+     * @throws {Error} If no credential is found.
+     */
+    getCredential: (query: CredentialQuery) => Promise<ServiceCredential>;
+}>;
+export declare class CredentialsService extends CredentialsService_base {
+    static getCredential: (query: CredentialQuery) => Effect.Effect<ServiceCredential, never, CredentialsService>;
+    static getApiKey: (query: CredentialQuery) => Effect.Effect<Redacted.Redacted<string>, never, CredentialsService>;
+}
+export {};
+//# sourceMappingURL=Credential.d.ts.map

package/dist/types/src/Credential.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Credential.d.ts","sourceRoot":"","sources":["../../../src/Credential.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,OAAO,MAAM,gBAAgB,CAAC;AAC1C,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AACxC,OAAO,KAAK,QAAQ,MAAM,iBAAiB,CAAC;AAE5C,MAAM,MAAM,eAAe,GAAG;IAC5B,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,CAAC;AAIF,MAAM,MAAM,iBAAiB,GAAG;IAC9B,OAAO,EAAE,MAAM,CAAC;IAGhB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,CAAC;;IAKE;;OAEG;sBACe,CAAC,KAAK,EAAE,eAAe,KAAK,OAAO,CAAC,iBAAiB,EAAE,CAAC;IAE1E;;;OAGG;mBACY,CAAC,KAAK,EAAE,eAAe,KAAK,OAAO,CAAC,iBAAiB,CAAC;;AAZzE,qBAAa,kBAAmB,SAAQ,uBAcrC;IACD,MAAM,CAAC,aAAa,UAAW,eAAe,KAAG,MAAM,CAAC,MAAM,CAAC,iBAAiB,EAAE,KAAK,EAAE,kBAAkB,CAAC,CAIvG;IAEL,MAAM,CAAC,SAAS,UAAW,eAAe,KAAG,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,kBAAkB,CAAC,CAO3G;CACN"}

package/dist/types/src/Header.d.ts

@@ -0,0 +1,9 @@
+import * as HttpClient from '@effect/platform/HttpClient';
+import * as Layer from 'effect/Layer';
+import * as Credential from './Credential';
+/**
+ * Wraps an `HttpClient` so outbound requests carry `X-BYOK: <apiKey>` whenever the active space
+ * has an `AccessToken` for `providerHost`. Lookup failures pass the request through unchanged.
+ */
+export declare const byokLayer: (providerHost: string) => Layer.Layer<HttpClient.HttpClient, never, HttpClient.HttpClient | Credential.CredentialsService>;
+//# sourceMappingURL=Header.d.ts.map

package/dist/types/src/Header.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Header.d.ts","sourceRoot":"","sources":["../../../src/Header.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,UAAU,MAAM,6BAA6B,CAAC;AAG1D,OAAO,KAAK,KAAK,MAAM,cAAc,CAAC;AAItC,OAAO,KAAK,UAAU,MAAM,cAAc,CAAC;AAE3C;;;GAGG;AACH,eAAO,MAAM,SAAS,iBACN,MAAM,KACnB,KAAK,CAAC,KAAK,CAAC,UAAU,CAAC,UAAU,EAAE,KAAK,EAAE,UAAU,CAAC,UAAU,GAAG,UAAU,CAAC,kBAAkB,CAgB/F,CAAC"}

package/dist/types/src/Header.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=Header.test.d.ts.map

package/dist/types/src/Header.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Header.test.d.ts","sourceRoot":"","sources":["../../../src/Header.test.ts"],"names":[],"mappings":""}

package/dist/types/src/LayerSpec.d.ts

@@ -0,0 +1,56 @@
+import * as Context from 'effect/Context';
+import * as Layer from 'effect/Layer';
+import * as Types from 'effect/Types';
+import { SpaceId, type URI } from '@dxos/keys';
+import type * as Process from './Process';
+export declare const TypeId: '~@dxos/functions/LayerSpec';
+export type TypeId = typeof TypeId;
+/**
+ * Opaque layer with introspectable tags.
+ */
+export interface LayerSpec {
+    readonly [TypeId]: TypeId;
+    readonly affinity: Affinity;
+    readonly requires: readonly Context.Tag<any, any>[];
+    readonly provides: readonly Context.Tag<any, any>[];
+    readonly make: (context: LayerContext) => Layer.Layer<unknown, never, unknown>;
+}
+/**
+ * Affinity defines the lifetime and scope of a service.
+ *
+ * - `application` - single service instance is available throughout the entire application.
+ * - `space` - service is instantiated per space.
+ * - `process` - separate service instance is created and destroyed for each process.
+ */
+export type Affinity = 'application' | 'space' | 'process';
+/**
+ * Provides context for service resolution.
+ */
+export interface LayerContext {
+    /**
+     * Under which space the process is running.
+     * Space affinity and up only.
+     */
+    readonly space?: SpaceId;
+    /**
+     * URI of the conversation feed the process is running in.
+     * Process affinity only.
+     */
+    readonly conversation?: URI.URI;
+    /**
+     * Under which process the process is running.
+     * Process affinity only.
+     */
+    readonly process?: Process.ID;
+}
+interface MakeOpts {
+    readonly affinity: Affinity;
+    readonly requires: readonly Context.Tag<any, any>[];
+    readonly provides: readonly Context.Tag<any, any>[];
+}
+/**
+ * Make a service.
+ */
+export declare const make: <const Opts extends Types.NoExcessProperties<MakeOpts, Opts>>(opts: Opts, make: (context: LayerContext) => Layer.Layer<Context.Tag.Identifier<Opts['provides'][number]>, never, Context.Tag.Identifier<Opts['requires'][number]>>) => LayerSpec;
+export {};
+//# sourceMappingURL=LayerSpec.d.ts.map

package/dist/types/src/LayerSpec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"LayerSpec.d.ts","sourceRoot":"","sources":["../../../src/LayerSpec.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,OAAO,MAAM,gBAAgB,CAAC;AAC1C,OAAO,KAAK,KAAK,MAAM,cAAc,CAAC;AACtC,OAAO,KAAK,KAAK,MAAM,cAAc,CAAC;AAEtC,OAAO,EAAE,OAAO,EAAE,KAAK,GAAG,EAAE,MAAM,YAAY,CAAC;AAE/C,OAAO,KAAK,KAAK,OAAO,MAAM,WAAW,CAAC;AAI1C,eAAO,MAAM,MAAM,EAAG,4BAAqC,CAAC;AAC5D,MAAM,MAAM,MAAM,GAAG,OAAO,MAAM,CAAC;AAEnC;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB,QAAQ,CAAC,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IAE1B,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC;IAC5B,QAAQ,CAAC,QAAQ,EAAE,SAAS,OAAO,CAAC,GAAG,CAAC,GAAG,EAAE,GAAG,CAAC,EAAE,CAAC;IACpD,QAAQ,CAAC,QAAQ,EAAE,SAAS,OAAO,CAAC,GAAG,CAAC,GAAG,EAAE,GAAG,CAAC,EAAE,CAAC;IAGpD,QAAQ,CAAC,IAAI,EAAE,CAAC,OAAO,EAAE,YAAY,KAAK,KAAK,CAAC,KAAK,CAAC,OAAO,EAAE,KAAK,EAAE,OAAO,CAAC,CAAC;CAChF;AAED;;;;;;GAMG;AACH,MAAM,MAAM,QAAQ,GAAG,aAAa,GAAG,OAAO,GAAG,SAAS,CAAC;AAE3D;;GAEG;AAEH,MAAM,WAAW,YAAY;IAC3B;;;OAGG;IACH,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC;IAEzB;;;OAGG;IACH,QAAQ,CAAC,YAAY,CAAC,EAAE,GAAG,CAAC,GAAG,CAAC;IAEhC;;;OAGG;IACH,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC,EAAE,CAAC;CAC/B;AAED,UAAU,QAAQ;IAChB,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC;IAC5B,QAAQ,CAAC,QAAQ,EAAE,SAAS,OAAO,CAAC,GAAG,CAAC,GAAG,EAAE,GAAG,CAAC,EAAE,CAAC;IACpD,QAAQ,CAAC,QAAQ,EAAE,SAAS,OAAO,CAAC,GAAG,CAAC,GAAG,EAAE,GAAG,CAAC,EAAE,CAAC;CACrD;AAED;;GAEG;AACH,eAAO,MAAM,IAAI,GAAI,KAAK,CAAC,IAAI,SAAS,KAAK,CAAC,kBAAkB,CAAC,QAAQ,EAAE,IAAI,CAAC,QACxE,IAAI,QACJ,CACJ,OAAO,EAAE,YAAY,KAClB,KAAK,CAAC,KAAK,CACd,OAAO,CAAC,GAAG,CAAC,UAAU,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,MAAM,CAAC,CAAC,EAChD,KAAK,EACL,OAAO,CAAC,GAAG,CAAC,UAAU,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,MAAM,CAAC,CAAC,CACjD,KACA,SAQF,CAAC"}

package/dist/types/src/McpServer.d.ts

@@ -0,0 +1,26 @@
+import * as Schema from 'effect/Schema';
+/**
+ * MCP server connection spec — the minimal fields needed to dial an MCP server.
+ *
+ * Used as a value type embedded in blueprints and passed to runtime session connect logic.
+ * The user-facing ECHO object (`@dxos/assistant-toolkit` `McpServer`) composes this struct
+ * and adds instance-level fields (`name`, `enabled`) and ECHO annotations.
+ */
+export declare const McpServer: Schema.Struct<{
+    name: Schema.optional<typeof Schema.String>;
+    url: Schema.SchemaClass<string, string, never>;
+    /**
+     * Transport protocol. Prefer `'http'` (Streamable HTTP) for new servers; `'sse'` is
+     * kept for compatibility with servers that haven't migrated and is deprecated per
+     * the MCP SDK. Clients support both during the migration period.
+     */
+    protocol: Schema.Union<[Schema.Literal<["http"]>, Schema.Literal<["sse"]>]>;
+    /**
+     * Optional API key sent with requests.
+     * Persisted in plaintext when stored on a space-replicated ECHO object — see the
+     * `@dxos/assistant-toolkit` `McpServer` type for security implications.
+     */
+    apiKey: Schema.optional<typeof Schema.String>;
+}>;
+export type McpServer = Schema.Schema.Type<typeof McpServer>;
+//# sourceMappingURL=McpServer.d.ts.map

package/dist/types/src/McpServer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"McpServer.d.ts","sourceRoot":"","sources":["../../../src/McpServer.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AAExC;;;;;;GAMG;AACH,eAAO,MAAM,SAAS;;;IASpB;;;;OAIG;;IAKH;;;;OAIG;;EAIH,CAAC;AAEH,MAAM,MAAM,SAAS,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,SAAS,CAAC,CAAC"}

package/dist/types/src/Operation.d.ts

@@ -0,0 +1,385 @@
+import * as Context from 'effect/Context';
+import * as Effect from 'effect/Effect';
+import * as Layer from 'effect/Layer';
+import * as Pipeable from 'effect/Pipeable';
+import * as Schema$ from 'effect/Schema';
+import type * as Types from 'effect/Types';
+import { DXN, Annotation, Migration, Obj, Type, type Key } from '@dxos/echo';
+import type { URI } from '@dxos/keys';
+import type { NoHandlerError } from './errors';
+import type { Operation } from './index';
+/**
+ * Schema type that accepts any Encoded form but requires no Context.
+ * This allows ECHO object schemas where Type !== Encoded due to [KindId] symbol.
+ */
+type Schema<T> = Schema$.Schema<T, any, never>;
+export declare const DefinitionTypeId: '~@dxos/operation/OperationDefinition';
+export type DefinitionTypeId = typeof DefinitionTypeId;
+/**
+ * Serializable definition of an Operation.
+ * Contains schema and metadata, but no runtime logic.
+ */
+export interface Definition<I, O, S = any> extends Pipeable.Pipeable, Definition.Variance<I, O, S> {
+    /**
+     * Input schema for the operation.
+     */
+    readonly input: Schema<I>;
+    /**
+     * Output schema for the operation.
+     */
+    readonly output: Schema<O>;
+    readonly meta: {
+        readonly key: DXN.DXN;
+        readonly name?: string;
+        readonly version?: string;
+        readonly description?: string;
+        /**
+         * Phosphor icon identifier in `ph--<name>--<variant>` format (e.g. `ph--file-text--regular`).
+         */
+        readonly icon?: string;
+        /**
+         * Deployment ID for remote invocation.
+         * Assigned by the EDGE function service when deployed.
+         */
+        readonly deployedId?: string;
+        /**
+         * Dictionary of annotations for the operation.
+         */
+        readonly annotations?: Annotation.Dictionary;
+        /**
+         * When true, this operation is not serialized into the hypergraph registry.
+         * Use for UI-only operations that should not be discoverable by the AI agent.
+         */
+        readonly skipRegistry?: boolean;
+    };
+    /**
+     * Execution mode for the operation.
+     * - 'sync': Operation completes synchronously (fast, UI-blocking acceptable).
+     * - 'async': Operation may take time (should not block UI).
+     */
+    readonly executionMode: 'sync' | 'async';
+    /**
+     * ECHO types the operation uses.
+     * Ensures types are available when the operation is executed remotely.
+     */
+    readonly types: readonly Type.AnyEntity[];
+    /**
+     * Effect services required by this operation.
+     * These services will be automatically provided to the handler at invocation time.
+     */
+    readonly services: readonly Context.Tag<any, any>[];
+}
+/**
+ * Namespace for OperationDefinition helper types.
+ */
+export declare namespace Definition {
+    interface Variance<I, O, S> {
+        [DefinitionTypeId]: {
+            readonly _Input: Types.Contravariant<I>;
+            readonly _Output: Types.Covariant<O>;
+            readonly _Services: Types.Covariant<S>;
+        };
+    }
+    /**
+     * Any operation definition, regardless of input/output types.
+     */
+    type Any = Definition<any, any, any>;
+    /**
+     * Extract the input type from an operation definition.
+     */
+    type Input<T extends Any> = T extends Variance<infer I, infer _O, infer _S> ? I : never;
+    /**
+     * Extract the output type from an operation definition.
+     */
+    type Output<T extends Any> = T extends Variance<infer _I, infer O, infer _S> ? O : never;
+    /**
+     * Extract the service identifier types from an operation's services array.
+     * Returns `never` if the operation has no services declared.
+     */
+    type Services<T extends Any> = T extends Variance<infer _I, infer _O, infer S> ? S : never;
+    type HandlerType<T extends Any> = T extends Variance<infer I, infer O, infer S> ? Handler<I, O, any, S> : never;
+}
+/**
+ * Runtime handler for an Operation.
+ */
+export type Handler<I, O, E = Error, R = never> = (input: I) => Effect.Effect<O, E, R>;
+export type WithHandler<T extends Definition.Any> = T & {
+    handler: Definition.HandlerType<T>;
+};
+/**
+ * Checks if a value is an operation definition.
+ */
+export declare const isOperationDefinition: (value: unknown) => value is Definition.Any;
+/**
+ * Checks if a value is an operation with a handler.
+ */
+export declare const isOperationWithHandler: (value: unknown) => value is WithHandler<Definition.Any>;
+/**
+ * Props for creating an Operation definition.
+ * Derived from OperationDefinition with executionMode made optional (defaults to 'async').
+ */
+export type Props<I, O> = Omit<Definition<I, O>, DefinitionTypeId | 'pipe' | 'executionMode' | 'types' | 'services'> & {
+    readonly executionMode?: 'sync' | 'async';
+    readonly types?: Definition<I, O>['types'];
+    readonly services?: Definition<I, O>['services'];
+};
+/**
+ * Creates a new Operation definition.
+ * Applies default executionMode of 'async' if not specified.
+ * The returned type preserves the literal types of props (including services).
+ */
+export declare const make: <const P extends Types.NoExcessProperties<Props<any, any>, P>>(props: P) => Definition<Schema$.Schema.Type<P['input']>, Schema$.Schema.Type<P['output']>, Context.Tag.Identifier<NonNullable<P['services']>[number]>>;
+/**
+ * Attaches a handler to an Operation definition.
+ * The handler may use any services declared in the operation, plus Operation.Service (always available).
+ * Dual API: can be called directly or used in a pipe.
+ *
+ * @example
+ * ```ts
+ * const MyOp = Operation.make({
+ *   input: Schema.Void,
+ *   output: Schema.Void,
+ *   meta: { key: 'my-op' },
+ *   services: [DatabaseService],
+ * });
+ *
+ * // Direct call - handler can use DatabaseService
+ * const op = Operation.withHandler(MyOp, (input) =>
+ *   Effect.gen(function* () {
+ *     const db = yield* DatabaseService;
+ *     return {};
+ *   }),
+ * );
+ *
+ * // Piped call
+ * const op = MyOp.pipe(Operation.withHandler((input) => Effect.succeed({})));
+ * ```
+ */
+export declare const withHandler: {
+    <Def extends Definition<any, any>, E = never>(handler: Handler<Definition.Input<Def>, Definition.Output<Def>, E, Definition.Services<Def> | Service>): (op: Def) => WithHandler<Def>;
+    <Def extends Definition<any, any>, E = never>(op: Def, handler: Handler<Definition.Input<Def>, Definition.Output<Def>, E, Definition.Services<Def> | Service>): WithHandler<Def>;
+};
+/**
+ * Helper to make the handler type opaque.
+ * Workaround for TypeScript's inability to infer the handler type from the operation definition:
+ * ```
+ * error TS2742: The inferred type of 'default' cannot be named without a reference.
+ * ```
+ *
+ * Most of the time the exact handler type is not needed.
+ *
+ * @example
+ * ```ts
+ * const MyOp = Operation.make({
+ *   input: Schema.Void,
+ *   output: Schema.Void,
+ *   meta: { key: 'my-op' },
+ *   services: [DatabaseService],
+ * });
+ *
+ * export default MyOp.pipe(
+ *   Operation.withHandler(
+ *     Effect.fn(function* (input) {
+ *       return { result: 'ok' };
+ *     }),
+ *   ),
+ *   Operation.opaqueHandler,
+ * );
+ * ```
+ */
+export declare const opaqueHandler: <T extends Operation.Definition.Any>(handler: Operation.WithHandler<T>) => Operation.WithHandler<Operation.Definition.Any>;
+/**
+ * Local invocation of an operation.
+ */
+export type Invoke = <I, O, E>(op: Definition<I, O>, input: I) => Effect.Effect<O, E>;
+/**
+ * Remote invocation of an operation.
+ */
+export type InvokeRemote = <I, O, E>(op: Definition<I, O>, input: I, options?: {
+    timeout?: number;
+}) => Effect.Effect<O, E>;
+/**
+ * Database record of an operation.
+ * The registry `key` and `version` live in the object meta — access via
+ * `Obj.getMeta(record).key` and `Obj.getMeta(record).version`.
+ */
+export declare const PersistentOperation: Type.Obj<{
+    readonly name: string;
+    readonly description?: string | undefined;
+    readonly updated?: string | undefined;
+    readonly source?: import("@dxos/echo/internal").Ref<Obj.Unknown> | undefined;
+    readonly inputSchema?: import("@dxos/echo/internal").JsonSchemaType | undefined;
+    readonly outputSchema?: import("@dxos/echo/internal").JsonSchemaType | undefined;
+    readonly services?: readonly string[] | undefined;
+    readonly binding?: string | undefined;
+    readonly icon?: string | undefined;
+}, Schema$.Struct.Fields>;
+export type PersistentOperation = Type.InstanceType<typeof PersistentOperation>;
+/**
+ * Get the registry key for a persistent operation record (from the object meta).
+ */
+export declare const getKey: (record: PersistentOperation) => string | undefined;
+/**
+ * Get the registry version for a persistent operation record (from the object meta).
+ */
+export declare const getVersion: (record: PersistentOperation) => string | undefined;
+/**
+ * Serialize an operation definition to a persistent operation record.
+ */
+export declare const serialize: (operation: Definition.Any) => PersistentOperation;
+/**
+ * Deserialize a persistent operation record to an operation definition.
+ */
+export declare const deserialize: (record: PersistentOperation) => Definition.Any;
+/**
+ * Update properties on the target operation record from the source operation record.
+ */
+export declare const setFrom: (target: PersistentOperation, source: PersistentOperation) => void;
+/**
+ * Translatable label — a plain string or an i18next-style `[key, options]` tuple.
+ * Defined locally to avoid a core dependency on UI translation packages; structurally compatible with
+ * the app-level `Label` type so values flow into UI toasts unchanged.
+ */
+export type Label = string | [string, {
+    ns: string | readonly string[];
+    count?: number;
+    defaultValue?: string;
+}];
+/**
+ * Per-phase user notification messages for an invocation.
+ * A phase is notified to the user iff its message is provided; messages are translatable {@link Label}s.
+ */
+export interface NotifyOptions {
+    /** Shown when the invocation starts. */
+    start?: Label;
+    /** Shown when the invocation succeeds. */
+    success?: Label;
+    /** Shown when the invocation fails. */
+    error?: Label;
+}
+/**
+ * Options for operation invocation.
+ */
+export interface InvokeOptions {
+    /**
+     * Space ID to provide database context for the handler.
+     */
+    spaceId?: Key.SpaceId;
+    /**
+     * Request user-facing notifications at the given invocation phases.
+     */
+    notify?: NotifyOptions;
+    /**
+     * URI of the conversation feed (queue) — today always an EID, but typed as
+     * `URI.URI` to accommodate future entity-kind extensions. Narrow with `EID.parse`
+     * at the point of use.
+     * Passed to the process environment so nested operations can resolve AiContext.Service and related services.
+     */
+    conversation?: URI.URI;
+    /**
+     * Optional process-runtime tracing metadata (consumed by `@dxos/functions-runtime` when wired).
+     */
+    tracing?: unknown;
+}
+/**
+ * Annotation that marks an operation as idempotent — safe to retry even if a previous execution
+ * was interrupted mid-handler. When absent the operation is treated as non-idempotent, and the
+ * process runtime will fail (rather than re-run) any handler that was interrupted.
+ */
+export declare const IdempotentAnnotation: Annotation.Annotation<boolean>;
+/**
+ * Returns true when the operation is explicitly annotated as idempotent.
+ */
+export declare const isIdempotent: (op: Definition.Any) => boolean;
+/**
+ * Operation service interface - provides unified access to operation invocation and scheduling.
+ * This service is automatically provided to operation handlers.
+ */
+export interface OperationService {
+    /**
+     * Invoke an operation as an Effect.
+     * Returns an Effect that resolves to the operation output.
+     */
+    invoke: <I, O>(op: Operation.Definition<I, O>, ...args: void extends I ? [input?: I, options?: InvokeOptions] : [input: I, options?: InvokeOptions]) => Effect.Effect<O, NoHandlerError>;
+    /**
+     * Schedule an operation to run as a followup.
+     * The followup is tracked and won't be cancelled when the parent operation completes.
+     * Returns an Effect that completes immediately after scheduling.
+     */
+    schedule: <I, O>(op: Operation.Definition<I, O>, ...args: void extends I ? [input?: I, options?: InvokeOptions] : [input: I, options?: InvokeOptions]) => Effect.Effect<void>;
+    /**
+     * Invoke an operation and return a Promise.
+     * Useful for async contexts where Effect is not available.
+     */
+    invokePromise: <I, O>(op: Operation.Definition<I, O>, ...args: void extends I ? [input?: I, options?: InvokeOptions] : [input: I, options?: InvokeOptions]) => Promise<{
+        data?: O;
+        error?: Error;
+    }>;
+}
+declare const Service_base: Context.TagClass<Service, "@dxos/operation/Service", OperationService>;
+/**
+ * Context tag for the Operation service.
+ * Operation handlers can yield this to invoke other operations or schedule followups.
+ *
+ * @example
+ * ```ts
+ * const handler = (input) => Effect.gen(function* () {
+ *   // Schedule a followup (fire and forget)
+ *   yield* Operation.schedule(AnalyticsOperation, { event: 'completed' });
+ *
+ *   // Invoke another operation
+ *   return yield* Operation.invoke(OtherOperation, { data: input.data });
+ * });
+ * ```
+ */
+export declare class Service extends Service_base {
+}
+/**
+ * Invoke an operation as an Effect.
+ * Yields the Operation.Service internally.
+ *
+ * @example
+ * ```ts
+ * yield* Operation.invoke(MyOperation, { data: 'test' });
+ * ```
+ */
+export declare const invoke: <I, O>(op: Operation.Definition<I, O>, ...args: void extends I ? [input?: I, options?: InvokeOptions] : [input: I, options?: InvokeOptions]) => Effect.Effect<O, NoHandlerError, Service>;
+/**
+ * Schedule an operation to run as a followup.
+ * Yields the Operation.Service internally.
+ *
+ * @example
+ * ```ts
+ * yield* Operation.schedule(AnalyticsOperation, { event: 'completed' });
+ * yield* Operation.schedule(VoidOperation); // input optional when void
+ * ```
+ */
+export declare const schedule: <I, O>(op: Operation.Definition<I, O>, ...args: void extends I ? [input?: I, options?: InvokeOptions] : [input: I, options?: InvokeOptions]) => Effect.Effect<void, never, Service>;
+/**
+ * Provides additional invocation options to all invocations.
+ */
+export declare const withInvocationOptions: (options: InvokeOptions) => Layer.Layer<Service, never, Service>;
+/**
+ * Persistent operation schema v0.1.0 — `key` and `version` are stored as data properties.
+ * @deprecated Use {@link PersistentOperation} (v0.2.0) instead; the `key` and `version` now live in the object meta.
+ */
+export declare const PersistentOperation_v0_1_0: Type.Obj<{
+    readonly key?: string | undefined;
+    readonly name: string;
+    readonly version: string;
+    readonly description?: string | undefined;
+    readonly updated?: string | undefined;
+    readonly source?: import("@dxos/echo/internal").Ref<Obj.Unknown> | undefined;
+    readonly inputSchema?: import("@dxos/echo/internal").JsonSchemaType | undefined;
+    readonly outputSchema?: import("@dxos/echo/internal").JsonSchemaType | undefined;
+    readonly services?: readonly string[] | undefined;
+    readonly binding?: string | undefined;
+}, Schema$.Struct.Fields>;
+export type PersistentOperation_v0_1_0 = Type.InstanceType<typeof PersistentOperation_v0_1_0>;
+/**
+ * Schema migrations exported by this module.
+ * Exported as an array for extensibility — append future versions here.
+ */
+export declare const migrations: Migration.ObjectMigration[];
+export {};
+//# sourceMappingURL=Operation.d.ts.map

package/dist/types/src/Operation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Operation.d.ts","sourceRoot":"","sources":["../../../src/Operation.ts"],"names":[],"mappings":"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"}

package/dist/types/src/OperationHandlerSet.d.ts

@@ -0,0 +1,69 @@
+import { type Atom, type Registry } from '@effect-atom/atom';
+import * as Context from 'effect/Context';
+import * as Effect from 'effect/Effect';
+import * as Layer from 'effect/Layer';
+import { NoHandlerError } from './errors';
+import type * as Operation from './Operation';
+export declare const TypeId: '~@dxos/operation/OperationHandlerSet';
+export type TypeId = typeof TypeId;
+export interface OperationHandlerSet {
+    [TypeId]: TypeId;
+    readonly handlers: Effect.Effect<Operation.WithHandler<Operation.Definition.Any>[]>;
+    getHandlers(): Promise<Operation.WithHandler<Operation.Definition.Any>[]>;
+}
+export declare const isOperationHandlerSet: (value: unknown) => value is OperationHandlerSet;
+export declare const empty: OperationHandlerSet;
+/**
+ * Creates a new operation handler set from a list of handlers.
+ *
+ * @example
+ * ```ts
+ * const set = OperationHandlerSet.make(
+ *   Operation.withHandler(Operation.make({ input: Schema.Void, output: Schema.Void }), (input) => Effect.succeed({})),
+ *   Operation.withHandler(Operation.make({ input: Schema.Void, output: Schema.Void }), (input) => Effect.succeed({})),
+ * );
+ * ```
+ */
+export declare const make: (...handlers: Operation.WithHandler<Operation.Definition.Any>[]) => OperationHandlerSet;
+export declare const async: (getHandlers: () => Promise<Operation.WithHandler<Operation.Definition.Any>[]>) => OperationHandlerSet;
+/**
+ * Builds a set backed by an atom of contributed sets. The merged result is
+ * cached and invalidated whenever the atom changes, so most accesses are
+ * cheap but newly registered handlers are picked up.
+ */
+export declare const reactive: (registry: Registry.Registry, atom: Atom.Atom<readonly OperationHandlerSet[]>) => OperationHandlerSet;
+/**
+ * Merges multiple operation handler sets into a single set.
+ *
+ */
+export declare const merge: (...sets: OperationHandlerSet[]) => OperationHandlerSet;
+/**
+ * Creates a new operation handler set from a list of lazy-loaded modules.
+ *
+ * @example
+ * ```ts
+ * const set = OperationHandlerSet.lazy(
+ *   () => import('./my-handler'),
+ *   () => import('./my-other-handler'),
+ * );
+ * ```
+ */
+export declare const lazy: (...modules: (() => Promise<{
+    default: Operation.WithHandler<Operation.Definition.Any>;
+}>)[]) => OperationHandlerSet;
+/**
+ * Gets a handler for an operation by definition.
+ */
+export declare const getHandler: <const Op extends Operation.Definition.Any>(set: OperationHandlerSet, definition: Op) => Effect.Effect<Operation.WithHandler<Op>, NoHandlerError>;
+/**
+ * Gets a handler for an operation by key.
+ * Accepts either a plain NSID (`org.dxos.function.database.contextAdd`) or a
+ * full DXN string (`dxn:org.dxos.function.database.contextAdd`).
+ */
+export declare const getHandlerByKey: (set: OperationHandlerSet, key: string) => Effect.Effect<Operation.WithHandler<Operation.Definition.Any>, NoHandlerError>;
+declare const OperationHandlerProvider_base: Context.TagClass<OperationHandlerProvider, "@dxos/operation/OperationHandlerProvider", OperationHandlerSet>;
+export declare class OperationHandlerProvider extends OperationHandlerProvider_base {
+}
+export declare const provide: (handlers: OperationHandlerSet) => Layer.Layer<OperationHandlerProvider, never, never>;
+export {};
+//# sourceMappingURL=OperationHandlerSet.d.ts.map

package/dist/types/src/OperationHandlerSet.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"OperationHandlerSet.d.ts","sourceRoot":"","sources":["../../../src/OperationHandlerSet.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,KAAK,IAAI,EAAE,KAAK,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAC7D,OAAO,KAAK,OAAO,MAAM,gBAAgB,CAAC;AAC1C,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AAExC,OAAO,KAAK,KAAK,MAAM,cAAc,CAAC;AAMtC,OAAO,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAC1C,OAAO,KAAK,KAAK,SAAS,MAAM,aAAa,CAAC;AAE9C,eAAO,MAAM,MAAM,EAAG,sCAA+C,CAAC;AACtE,MAAM,MAAM,MAAM,GAAG,OAAO,MAAM,CAAC;AAEnC,MAAM,WAAW,mBAAmB;IAClC,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IAEjB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,CAAC,SAAS,CAAC,WAAW,CAAC,SAAS,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAEpF,WAAW,IAAI,OAAO,CAAC,SAAS,CAAC,WAAW,CAAC,SAAS,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;CAC3E;AAED,eAAO,MAAM,qBAAqB,UAAW,OAAO,KAAG,KAAK,IAAI,mBAE/D,CAAC;AAEF,eAAO,MAAM,KAAK,EAAE,mBAInB,CAAC;AAEF;;;;;;;;;;GAUG;AACH,eAAO,MAAM,IAAI,gBAAiB,SAAS,CAAC,WAAW,CAAC,SAAS,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,KAAG,mBAErF,CAAC;AAEF,eAAO,MAAM,KAAK,gBACH,MAAM,OAAO,CAAC,SAAS,CAAC,WAAW,CAAC,SAAS,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC,KAC5E,mBAcF,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,QAAQ,aACT,QAAQ,CAAC,QAAQ,QACrB,IAAI,CAAC,IAAI,CAAC,SAAS,mBAAmB,EAAE,CAAC,KAC9C,mBA2BF,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,KAAK,YAAa,mBAAmB,EAAE,KAAG,mBAGtD,CAAC;AAEF;;;;;;;;;;GAUG;AACH,eAAO,MAAM,IAAI,eACH,CAAC,MAAM,OAAO,CAAC;IAAE,OAAO,EAAE,SAAS,CAAC,WAAW,CAAC,SAAS,CAAC,UAAU,CAAC,GAAG,CAAC,CAAA;CAAE,CAAC,CAAC,EAAE,KAC1F,mBAEF,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,UAAU,GAAI,KAAK,CAAC,EAAE,SAAS,SAAS,CAAC,UAAU,CAAC,GAAG,OAC7D,mBAAmB,cACZ,EAAE,KACb,MAAM,CAAC,MAAM,CAAC,SAAS,CAAC,WAAW,CAAC,EAAE,CAAC,EAAE,cAAc,CAQtD,CAAC;AAEL;;;;GAIG;AACH,eAAO,MAAM,eAAe,QACrB,mBAAmB,OACnB,MAAM,KACV,MAAM,CAAC,MAAM,CAAC,SAAS,CAAC,WAAW,CAAC,SAAS,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,cAAc,CAY5E,CAAC;;AAEL,qBAAa,wBAAyB,SAAQ,6BAG3C;CAAG;AAEN,eAAO,MAAM,OAAO,aAAc,mBAAmB,KAAG,KAAK,CAAC,KAAK,CAAC,wBAAwB,EAAE,KAAK,EAAE,KAAK,CACvD,CAAC"}

package/dist/types/src/OperationHandlerSet.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=OperationHandlerSet.test.d.ts.map

package/dist/types/src/OperationHandlerSet.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"OperationHandlerSet.test.d.ts","sourceRoot":"","sources":["../../../src/OperationHandlerSet.test.ts"],"names":[],"mappings":""}