@dxos/compute 0.8.4-main.c85a9c8dae → 0.8.4-main.cb12b3f963

package/dist/lib/neutral/testing/index.mjs.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
-  "sources": ["../../../../src/testing/test-builder.ts", "../../../../src/testing/test-runtime.ts", "../../../../src/testing/test-plugin.ts", "../../../../src/util.ts", "../../../../src/testing/util.ts"],
-  "sourcesContent": ["//\n// Copyright 2024 DXOS.org\n//\n\nimport { Client, type ClientOptions } from '@dxos/client';\nimport { type Context, Resource } from '@dxos/context';\nimport { invariant } from '@dxos/invariant';\n\nimport { type ComputeGraphOptions, ComputeGraphRegistry } from '../compute-graph-registry';\n\nimport { createMockedComputeRuntimeProvider } from './test-runtime';\n\nexport type TestBuilderOptions = ClientOptions & Partial<ComputeGraphOptions>;\n\n// TODO(burdon): Reconcile with @dxos/client/testing.\nexport class TestBuilder extends Resource {\n  private _client?: Client;\n  private _registry?: ComputeGraphRegistry;\n\n  constructor(private readonly _options: TestBuilderOptions = {}) {\n    super();\n  }\n\n  get ctx(): Context {\n    return this._ctx;\n  }\n\n  get client(): Client {\n    invariant(this._client);\n    return this._client;\n  }\n\n  get registry(): ComputeGraphRegistry {\n    invariant(this._registry);\n    return this._registry;\n  }\n\n  override async _open(): Promise<void> {\n    const client = new Client(this._options);\n    await client.initialize();\n    await client.halo.createIdentity();\n    this._client = client;\n    this._ctx.onDispose(async () => {\n      await client.destroy();\n      this._client = undefined;\n    });\n\n    const registry = new ComputeGraphRegistry({\n      ...this._options,\n      // Provide a default runtime provider for tests if not supplied.\n      computeRuntime: this._options.computeRuntime ?? createMockedComputeRuntimeProvider(),\n    });\n    await registry.open();\n    this._registry = registry;\n    this._ctx.onDispose(async () => {\n      await registry.close();\n      this._registry = undefined;\n    });\n  }\n}\n", "//\n// Copyright 2025 DXOS.org\n//\n\nimport * as Layer from 'effect/Layer';\nimport * as ManagedRuntime from 'effect/ManagedRuntime';\n\nimport { AiService } from '@dxos/ai';\nimport { type SpaceId } from '@dxos/client/echo';\nimport { Database, Feed } from '@dxos/echo';\nimport { CredentialsService, type FunctionDefinition, QueueService } from '@dxos/functions';\nimport { FunctionInvocationServiceLayerTest } from '@dxos/functions-runtime/testing';\n\nimport { type FunctionsRuntimeProvider } from '../compute-graph-registry';\n\n/**\n * Minimal compute runtime provider for tests and Storybook.\n * Will cause errors if used for actual runtime.\n */\nexport const createMockedComputeRuntimeProvider = ({\n  functions,\n}: { functions?: FunctionDefinition.Any[] } = {}): FunctionsRuntimeProvider => {\n  return {\n    getRuntime: (_spaceId: SpaceId) =>\n      ManagedRuntime.make(\n        FunctionInvocationServiceLayerTest({ functions }).pipe(\n          Layer.provide(AiService.notAvailable),\n          Layer.provide(CredentialsService.configuredLayer([])),\n          Layer.provide(Database.notAvailable),\n          Layer.provide(QueueService.notAvailable),\n          Layer.provide(Feed.notAvailable),\n        ),\n      ),\n  };\n};\n", "//\n// Copyright 2024 DXOS.org\n//\n\nimport { getDeep } from '@dxos/util';\nimport { type InterpreterState, type ProcedureAst } from '@dxos/vendor-hyperformula';\nimport { FunctionArgumentType } from '@dxos/vendor-hyperformula';\n\nimport { type ComputeGraphPlugin } from '../compute-graph-registry';\nimport { type AsyncFunction, AsyncFunctionPlugin } from '../functions';\nimport { parseNumberString } from '../util';\n\n/**\n * Testing functions run locally (not run via EDGE).\n * https://hyperformula.handsontable.com/guide/custom-functions.html#add-a-simple-custom-function\n */\nexport class TestPlugin extends AsyncFunctionPlugin {\n  /**\n   * Simple local function returns input value.\n   */\n  test(ast: ProcedureAst, state: InterpreterState) {\n    const handler: AsyncFunction = async (_value) => {\n      return _value;\n    };\n\n    return this.runAsyncFunction(ast, state, handler);\n  }\n\n  /**\n   * Simple local function returns random number.\n   */\n  random(ast: ProcedureAst, state: InterpreterState) {\n    const handler: AsyncFunction = async () => {\n      return Math.random();\n    };\n\n    return this.runAsyncFunction(ast, state, handler);\n  }\n\n  /**\n   * Async HTTP function.\n   */\n  crypto(ast: ProcedureAst, state: InterpreterState) {\n    const handler: AsyncFunction = async (_currency) => {\n      const currency = (_currency || 'USD').toUpperCase();\n      const result = await fetch(`https://api.coindesk.com/v1/bpi/currentprice/${currency}.json`);\n      const data = await result.json();\n      const rate = getDeep<string>(data, ['bpi', currency, 'rate']);\n      if (!rate) {\n        return NaN;\n      }\n\n      return parseNumberString(rate);\n    };\n\n    return this.runAsyncFunction(ast, state, handler, { ttl: 10_000 });\n  }\n}\n\nTestPlugin.implementedFunctions = {\n  TEST: {\n    method: 'test',\n    parameters: [{ argumentType: FunctionArgumentType.NUMBER, optionalArg: false }],\n    isVolatile: true,\n  },\n\n  RANDOM: {\n    method: 'random',\n    parameters: [],\n    isVolatile: true,\n  },\n\n  CRYPTO: {\n    method: 'crypto',\n    parameters: [{ argumentType: FunctionArgumentType.STRING, optionalArg: true }],\n    isVolatile: true,\n  },\n};\n\nexport const TestPluginTranslations = {\n  enGB: {\n    TEST: 'Returns input value',\n    RANDOM: 'Random number',\n    CRYPTO: 'Crypto token value',\n  },\n  enUS: {\n    TEST: 'Returns input value',\n    RANDOM: 'Random number',\n    CRYPTO: 'Crypto token value',\n  },\n};\n\nexport const testFunctionPlugins: ComputeGraphPlugin[] = [\n  {\n    plugin: TestPlugin,\n    translations: TestPluginTranslations,\n  },\n];\n", "//\n// Copyright 2024 DXOS.org\n//\n\n// TODO(burdon): Factor out.\nexport const parseNumberString = (str: string): number => {\n  return parseFloat(str.replace(/[^\\d.]/g, ''));\n};\n", "//\n// Copyright 2024 DXOS.org\n//\n\nimport { HyperFormula } from '@dxos/vendor-hyperformula';\n\nexport const getRegisteredFunctionNames = () => {\n  return HyperFormula.buildEmpty({ licenseKey: 'gpl-v3' }).getRegisteredFunctionNames();\n};\n"],
-  "mappings": "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",
-  "names": ["Client", "Resource", "invariant", "Layer", "ManagedRuntime", "AiService", "Database", "Feed", "CredentialsService", "QueueService", "FunctionInvocationServiceLayerTest", "createMockedComputeRuntimeProvider", "functions", "getRuntime", "_spaceId", "make", "FunctionInvocationServiceLayerTest", "pipe", "provide", "AiService", "notAvailable", "CredentialsService", "configuredLayer", "Database", "QueueService", "Feed", "TestBuilder", "Resource", "_client", "_registry", "_options", "ctx", "_ctx", "client", "invariant", "registry", "_open", "Client", "initialize", "halo", "createIdentity", "onDispose", "destroy", "undefined", "ComputeGraphRegistry", "computeRuntime", "createMockedComputeRuntimeProvider", "open", "close", "getDeep", "FunctionArgumentType", "parseNumberString", "str", "parseFloat", "replace", "TestPlugin", "AsyncFunctionPlugin", "test", "ast", "state", "handler", "_value", "runAsyncFunction", "random", "Math", "crypto", "_currency", "currency", "toUpperCase", "result", "fetch", "data", "json", "rate", "getDeep", "NaN", "parseNumberString", "ttl", "implementedFunctions", "TEST", "method", "parameters", "argumentType", "FunctionArgumentType", "NUMBER", "optionalArg", "isVolatile", "RANDOM", "CRYPTO", "STRING", "TestPluginTranslations", "enGB", "enUS", "testFunctionPlugins", "plugin", "translations", "HyperFormula", "getRegisteredFunctionNames", "HyperFormula", "buildEmpty", "licenseKey"]
+  "sources": ["../../../../src/testing/index.ts"],
+  "sourcesContent": ["//\n// Copyright 2025 DXOS.org\n//\n\nimport * as OperationHandlerSet from '../OperationHandlerSet';\n\nexport { Fibonacci, Reply, Sleep } from './definitions';\nexport { default as FibonacciHandler } from './fib';\nexport { default as ReplyHandler } from './reply';\nexport { default as SleepHandler } from './sleep';\n\nexport const ExampleHandlers = OperationHandlerSet.lazy(\n  () => import('./fib'),\n  () => import('./reply'),\n  () => import('./sleep'),\n);\n"],
+  "mappings": ";;;;;;;;;;;;;;;;;;;;;AAWO,IAAMA,kBAAsCC,KACjD,MAAM,OAAO,qBAAA,GACb,MAAM,OAAO,uBAAA,GACb,MAAM,OAAO,uBAAA,CAAA;",
+  "names": ["ExampleHandlers", "lazy"]
 }

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

@@ -0,0 +1,148 @@
+import * as Context from 'effect/Context';
+import * as Effect from 'effect/Effect';
+import * as Schema from 'effect/Schema';
+import { Database, Obj, Type } from '@dxos/echo';
+import { BaseError } from '@dxos/errors';
+import * as Operation from './Operation';
+/**
+ * MCP server definition.
+ */
+export declare const McpServer: Schema.Struct<{
+    /**
+     * URL of the MCP server.
+     */
+    url: Schema.SchemaClass<string, string, never>;
+    protocol: Schema.Union<[Schema.Literal<["sse"]>, Schema.Literal<["http"]>]>;
+}>;
+export interface McpServer extends Schema.Schema.Type<typeof McpServer> {
+}
+/**
+ * Blueprint schema defines the structure for AI assistant blueprints.
+ * Blueprints contain instructions, tools, and artifacts that guide the AI's behavior.
+ * Blueprints may use tools to create and read artifacts, which are managed by the assistant.
+ */
+export declare const Blueprint: Type.Obj<{
+    readonly key: string;
+    readonly name: string;
+    readonly description?: string | undefined;
+    readonly instructions: {
+        readonly source: import("@dxos/echo/internal").Ref<import("@dxos/echo/Entity").OfKind<import("@dxos/echo/internal").EntityKind.Object> & {
+            readonly name?: string | undefined;
+            readonly content: string;
+        }>;
+        readonly inputs?: readonly {
+            readonly name: string;
+            readonly kind?: "context" | "function" | "pass-through" | "query" | "resolver" | "retriever" | "schema" | "value" | undefined;
+            readonly default?: any;
+            readonly function?: string | undefined;
+        }[] | undefined;
+    };
+    readonly tools: readonly (string & import("effect/Brand").Brand<"ToolId">)[];
+    readonly agentCanEnable?: boolean | undefined;
+    readonly mcpServers?: readonly {
+        readonly url: string;
+        readonly protocol: "http" | "sse";
+    }[] | undefined;
+}, Schema.Struct.Fields>;
+/**
+ * TypeScript type for Blueprint.
+ */
+export interface Blueprint extends Schema.Schema.Type<typeof Blueprint> {
+}
+type MakeProps = Pick<Blueprint, 'key' | 'name'> & Partial<Blueprint>;
+/**
+ * Create a new Blueprint.
+ */
+export declare const make: ({ tools, instructions, ...props }: MakeProps) => Obj.OfShape<import("@dxos/echo/Entity").OfKind<import("@dxos/echo/internal").EntityKind.Object> & {
+    readonly key: string;
+    readonly name: string;
+    readonly description?: string | undefined;
+    readonly instructions: {
+        readonly source: import("@dxos/echo/internal").Ref<import("@dxos/echo/Entity").OfKind<import("@dxos/echo/internal").EntityKind.Object> & {
+            readonly name?: string | undefined;
+            readonly content: string;
+        }>;
+        readonly inputs?: readonly {
+            readonly name: string;
+            readonly kind?: "context" | "function" | "pass-through" | "query" | "resolver" | "retriever" | "schema" | "value" | undefined;
+            readonly default?: any;
+            readonly function?: string | undefined;
+        }[] | undefined;
+    };
+    readonly tools: readonly (string & import("effect/Brand").Brand<"ToolId">)[];
+    readonly agentCanEnable?: boolean | undefined;
+    readonly mcpServers?: readonly {
+        readonly url: string;
+        readonly protocol: "http" | "sse";
+    }[] | undefined;
+}>;
+/**
+ * Util to create tool definitions for a blueprint.
+ */
+export declare const toolDefinitions: ({ tools, operations, }: {
+    tools?: string[];
+    operations?: Operation.Definition.Any[];
+}) => (string & import("effect/Brand").Brand<"ToolId">)[];
+/**
+ * Factory for the blueprints.
+ */
+export type Definition = {
+    key: string;
+    make: () => Blueprint;
+};
+/**
+ * Blueprint registry.
+ */
+export declare class Registry {
+    private readonly _blueprints;
+    constructor(blueprints: Blueprint[]);
+    get blueprints(): Blueprint[];
+    getByKey(key: string): Blueprint | undefined;
+    query(): Blueprint[];
+    updateBlueprints(): Effect.Effect<void, never, Database.Service>;
+}
+declare const RegistryService_base: Context.TagClass<RegistryService, "@dxos/blueprints/RegistryService", Registry>;
+export declare class RegistryService extends RegistryService_base {
+}
+/**
+ * Resolves a blueprint from the registry.
+ * Does not check the local database for the blueprint.
+ */
+export declare const resolve: (key: string) => Effect.Effect<Blueprint, NotFoundError, RegistryService>;
+/**
+ * Upserts a blueprint into the database.
+ * If the blueprint already exists in the database, local blueprint is returned.
+ * Otherwise, it will be added.
+ */
+export declare const upsert: (key: string) => Effect.Effect<Blueprint, NotFoundError, RegistryService | Database.Service>;
+declare const NotFoundError_base: {
+    new (options?: import("@dxos/errors").BaseErrorOptions): {
+        cause?: unknown;
+        stack?: string;
+        name: "BlueprintNotFound";
+        context: Record<string, unknown>;
+        readonly message: string;
+        readonly _tag: "BlueprintNotFound";
+    };
+    isError(error: unknown): error is Error;
+    name: "BlueprintNotFound";
+    is(error: unknown): error is BaseError;
+    wrap(options?: Omit<import("@dxos/errors").BaseErrorOptions, 'cause'> & {
+        ifTypeDiffers?: boolean;
+    }): (error: unknown) => {
+        cause?: unknown;
+        stack?: string;
+        name: "BlueprintNotFound";
+        context: Record<string, unknown>;
+        readonly message: string;
+        readonly _tag: "BlueprintNotFound";
+    };
+    extend<Name extends string = string>(name: Name, message?: string): any;
+    captureStackTrace(targetObject: object, constructorOpt?: Function): void;
+    prepareStackTrace?: ((err: Error, stackTraces: NodeJS.CallSite[]) => any) | undefined;
+    stackTraceLimit: number;
+};
+export declare class NotFoundError extends NotFoundError_base {
+}
+export {};
+//# sourceMappingURL=Blueprint.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"Blueprint.d.ts","sourceRoot":"","sources":["../../../src/Blueprint.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,OAAO,MAAM,gBAAgB,CAAC;AAC1C,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AACxC,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AAGxC,OAAO,EAAc,QAAQ,EAAU,GAAG,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AACrE,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAGzC,OAAO,KAAK,SAAS,MAAM,aAAa,CAAC;AAGzC;;GAEG;AACH,eAAO,MAAM,SAAS;IACpB;;OAEG;;;EAQH,CAAC;AACH,MAAM,WAAW,SAAU,SAAQ,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,SAAS,CAAC;CAAG;AAE1E;;;;GAIG;AACH,eAAO,MAAM,SAAS;;;;;;;;;;;;;;;;;;;;;;wBA6DrB,CAAC;AAEF;;GAEG;AACH,MAAM,WAAW,SAAU,SAAQ,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,SAAS,CAAC;CAAG;AAE1E,KAAK,SAAS,GAAG,IAAI,CAAC,SAAS,EAAE,KAAK,GAAG,MAAM,CAAC,GAAG,OAAO,CAAC,SAAS,CAAC,CAAC;AAEtE;;GAEG;AACH,eAAO,MAAM,IAAI,sCAA8D,SAAS;;;;;;;;;;;;;;;;;;;;;;EAKpF,CAAC;AAEL;;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,wDAAqG,CAAC;AAEvG;;GAEG;AACH,MAAM,MAAM,UAAU,GAAG;IACvB,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,SAAS,CAAC;CACvB,CAAC;AAMF;;GAEG;AACH,qBAAa,QAAQ;IACnB,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAmB;IAE/C,YAAY,UAAU,EAAE,SAAS,EAAE,EAYlC;IAED,IAAI,UAAU,IAAI,SAAS,EAAE,CAE5B;IAED,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,GAAG,SAAS,CAE3C;IAED,KAAK,IAAI,SAAS,EAAE,CAEnB;IAED,gBAAgB,IAAI,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,KAAK,EAAE,QAAQ,CAAC,OAAO,CAAC,CAc/D;CACF;;AAED,qBAAa,eAAgB,SAAQ,oBAA4E;CAAG;AAEpH;;;GAGG;AACH,eAAO,MAAM,OAAO,QAAS,MAAM,KAAG,MAAM,CAAC,MAAM,CAAC,SAAS,EAAE,aAAa,EAAE,eAAe,CAQzF,CAAC;AAEL;;;;GAIG;AACH,eAAO,MAAM,MAAM,QAAS,MAAM,KAAG,MAAM,CAAC,MAAM,CAAC,SAAS,EAAE,aAAa,EAAE,eAAe,GAAG,QAAQ,CAAC,OAAO,CAO3G,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAEL,qBAAa,aAAc,SAAQ,kBAA4D;CAAG"}

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":"AAIA,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/Operation.d.ts

@@ -0,0 +1,303 @@
+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 { Obj, Type, type DXN, type Key } from '@dxos/echo';
+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: string;
+        readonly name?: string;
+        readonly version?: string;
+        readonly description?: string;
+        /**
+         * Deployment ID for remote invocation.
+         * Assigned by the EDGE function service when deployed.
+         */
+        readonly deployedId?: string;
+    };
+    /**
+     * 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>;
+/**a
+ * 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.
+ */
+export declare const PersistentOperation: 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<import("@dxos/echo/Entity").OfKind<import("@dxos/echo/internal").EntityKind.Object> & 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 interface PersistentOperation extends Schema$.Schema.Type<typeof PersistentOperation> {
+}
+/**
+ * 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;
+/**
+ * Options for operation invocation.
+ */
+export interface InvokeOptions {
+    /**
+     * Space ID to provide database context for the handler.
+     */
+    spaceId?: Key.SpaceId;
+    /**
+     * DXN string of the conversation feed (queue).
+     * Passed to the process environment so nested operations can resolve AiContextService and related services.
+     */
+    conversation?: DXN.String;
+    /**
+     * Optional process-runtime tracing metadata (consumed by `@dxos/functions-runtime` when wired).
+     */
+    tracing?: unknown;
+}
+/**
+ * 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] : [input: I]) => 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] : [input: I]) => Effect.Effect<void, never, Service>;
+/**
+ * Provides additional invocation options to all invocations.
+ */
+export declare const withInvocationOptions: (options: InvokeOptions) => Layer.Layer<Service, never, Service>;
+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,60 @@
+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;
+/**
+ * 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.
+ */
+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":"AAIA,OAAO,KAAK,OAAO,MAAM,gBAAgB,CAAC;AAC1C,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AACxC,OAAO,KAAK,KAAK,MAAM,cAAc,CAAC;AAItC,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;;;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;;GAEG;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,CAQ5E,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/OperationRegistry.d.ts

@@ -0,0 +1,23 @@
+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 { Database } from '@dxos/echo';
+import * as Operation from './Operation';
+import * as OperationHandlerSet from './OperationHandlerSet';
+export interface OperationRegistry {
+    /**
+     * Resolve an operation by key.
+     */
+    resolve(key: string): Effect.Effect<Option.Option<Operation.Definition.Any>>;
+}
+declare const Service_base: Context.TagClass<Service, "@dxos/operation/OperationRegistry", OperationRegistry>;
+export declare class Service extends Service_base {
+}
+/**
+ * Resolve an operation by key.
+ */
+export declare const resolve: (key: string) => Effect.Effect<Option.Option<Operation.Definition.Any>, never, Service>;
+export declare const layer: Layer.Layer<Service, never, Database.Service | OperationHandlerSet.OperationHandlerProvider>;
+export {};
+//# sourceMappingURL=OperationRegistry.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"OperationRegistry.d.ts","sourceRoot":"","sources":["../../../src/OperationRegistry.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,OAAO,MAAM,gBAAgB,CAAC;AAC1C,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AACxC,OAAO,KAAK,KAAK,MAAM,cAAc,CAAC;AACtC,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AAExC,OAAO,EAAE,QAAQ,EAAS,MAAM,YAAY,CAAC;AAE7C,OAAO,KAAK,SAAS,MAAM,aAAa,CAAC;AACzC,OAAO,KAAK,mBAAmB,MAAM,uBAAuB,CAAC;AAE7D,MAAM,WAAW,iBAAiB;IAChC;;OAEG;IACH,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,SAAS,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC;CAC9E;;AAED,qBAAa,OAAQ,SAAQ,YAA8E;CAAG;AAE9G;;GAEG;AACH,eAAO,MAAM,OAAO,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,SAAS,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,KAAK,EAAE,OAAO,CACvC,CAAC;AAEtE,eAAO,MAAM,KAAK,EAAE,KAAK,CAAC,KAAK,CAAC,OAAO,EAAE,KAAK,EAAE,QAAQ,CAAC,OAAO,GAAG,mBAAmB,CAAC,wBAAwB,CAkB5G,CAAC"}