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

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

@@ -1,198 +1,32 @@
 import {
-  AsyncFunctionPlugin,
-  ComputeGraphRegistry
-} from "../chunk-KGBGT4NT.mjs";
-
-// src/testing/test-builder.ts
-import { Client } from "@dxos/client";
-import { Resource } from "@dxos/context";
-import { invariant } from "@dxos/invariant";
-
-// src/testing/test-runtime.ts
-import * as Layer from "effect/Layer";
-import * as ManagedRuntime from "effect/ManagedRuntime";
-import { AiService } from "@dxos/ai";
-import { Database, Feed } from "@dxos/echo";
-import { CredentialsService, QueueService } from "@dxos/functions";
-import { FunctionInvocationServiceLayerTest } from "@dxos/functions-runtime/testing";
-var createMockedComputeRuntimeProvider = ({ functions } = {}) => {
-  return {
-    getRuntime: (_spaceId) => ManagedRuntime.make(FunctionInvocationServiceLayerTest({
-      functions
-    }).pipe(Layer.provide(AiService.notAvailable), Layer.provide(CredentialsService.configuredLayer([])), Layer.provide(Database.notAvailable), Layer.provide(QueueService.notAvailable), Layer.provide(Feed.notAvailable)))
-  };
-};
-
-// src/testing/test-builder.ts
-var __dxlog_file = "/__w/dxos/dxos/packages/core/compute/src/testing/test-builder.ts";
-var TestBuilder = class extends Resource {
-  _options;
-  _client;
-  _registry;
-  constructor(_options = {}) {
-    super(), this._options = _options;
-  }
-  get ctx() {
-    return this._ctx;
-  }
-  get client() {
-    invariant(this._client, void 0, {
-      F: __dxlog_file,
-      L: 29,
-      S: this,
-      A: [
-        "this._client",
-        ""
-      ]
-    });
-    return this._client;
-  }
-  get registry() {
-    invariant(this._registry, void 0, {
-      F: __dxlog_file,
-      L: 34,
-      S: this,
-      A: [
-        "this._registry",
-        ""
-      ]
-    });
-    return this._registry;
-  }
-  async _open() {
-    const client = new Client(this._options);
-    await client.initialize();
-    await client.halo.createIdentity();
-    this._client = client;
-    this._ctx.onDispose(async () => {
-      await client.destroy();
-      this._client = void 0;
-    });
-    const registry = new ComputeGraphRegistry({
-      ...this._options,
-      // Provide a default runtime provider for tests if not supplied.
-      computeRuntime: this._options.computeRuntime ?? createMockedComputeRuntimeProvider()
-    });
-    await registry.open();
-    this._registry = registry;
-    this._ctx.onDispose(async () => {
-      await registry.close();
-      this._registry = void 0;
-    });
-  }
-};
-
-// src/testing/test-plugin.ts
-import { getDeep } from "@dxos/util";
-import { FunctionArgumentType } from "@dxos/vendor-hyperformula";
-
-// src/util.ts
-var parseNumberString = (str) => {
-  return parseFloat(str.replace(/[^\d.]/g, ""));
-};
-
-// src/testing/test-plugin.ts
-var TestPlugin = class extends AsyncFunctionPlugin {
-  /**
-  * Simple local function returns input value.
-  */
-  test(ast, state) {
-    const handler = async (_value) => {
-      return _value;
-    };
-    return this.runAsyncFunction(ast, state, handler);
-  }
-  /**
-  * Simple local function returns random number.
-  */
-  random(ast, state) {
-    const handler = async () => {
-      return Math.random();
-    };
-    return this.runAsyncFunction(ast, state, handler);
-  }
-  /**
-  * Async HTTP function.
-  */
-  crypto(ast, state) {
-    const handler = async (_currency) => {
-      const currency = (_currency || "USD").toUpperCase();
-      const result = await fetch(`https://api.coindesk.com/v1/bpi/currentprice/${currency}.json`);
-      const data = await result.json();
-      const rate = getDeep(data, [
-        "bpi",
-        currency,
-        "rate"
-      ]);
-      if (!rate) {
-        return NaN;
-      }
-      return parseNumberString(rate);
-    };
-    return this.runAsyncFunction(ast, state, handler, {
-      ttl: 1e4
-    });
-  }
-};
-TestPlugin.implementedFunctions = {
-  TEST: {
-    method: "test",
-    parameters: [
-      {
-        argumentType: FunctionArgumentType.NUMBER,
-        optionalArg: false
-      }
-    ],
-    isVolatile: true
-  },
-  RANDOM: {
-    method: "random",
-    parameters: [],
-    isVolatile: true
-  },
-  CRYPTO: {
-    method: "crypto",
-    parameters: [
-      {
-        argumentType: FunctionArgumentType.STRING,
-        optionalArg: true
-      }
-    ],
-    isVolatile: true
-  }
-};
-var TestPluginTranslations = {
-  enGB: {
-    TEST: "Returns input value",
-    RANDOM: "Random number",
-    CRYPTO: "Crypto token value"
-  },
-  enUS: {
-    TEST: "Returns input value",
-    RANDOM: "Random number",
-    CRYPTO: "Crypto token value"
-  }
-};
-var testFunctionPlugins = [
-  {
-    plugin: TestPlugin,
-    translations: TestPluginTranslations
-  }
-];
+  lazy
+} from "../chunk-LF2ANNYW.mjs";
+import {
+  fib_default
+} from "../chunk-AKVCVI6N.mjs";
+import {
+  reply_default
+} from "../chunk-RCLYF66G.mjs";
+import {
+  sleep_default
+} from "../chunk-LRCABAWU.mjs";
+import {
+  Fibonacci,
+  Reply,
+  Sleep
+} from "../chunk-VSICPGGY.mjs";
+import "../chunk-SEBWOTOU.mjs";
+import "../chunk-J5LGTIGS.mjs";
 
-// src/testing/util.ts
-import { HyperFormula } from "@dxos/vendor-hyperformula";
-var getRegisteredFunctionNames = () => {
-  return HyperFormula.buildEmpty({
-    licenseKey: "gpl-v3"
-  }).getRegisteredFunctionNames();
-};
+// src/testing/index.ts
+var ExampleHandlers = lazy(() => import("../fib-ZSJYREBW.mjs"), () => import("../reply-YH3BVOUT.mjs"), () => import("../sleep-TSPIQ5EY.mjs"));
 export {
-  TestBuilder,
-  TestPlugin,
-  TestPluginTranslations,
-  createMockedComputeRuntimeProvider,
-  getRegisteredFunctionNames,
-  testFunctionPlugins
+  ExampleHandlers,
+  Fibonacci,
+  fib_default as FibonacciHandler,
+  Reply,
+  reply_default as ReplyHandler,
+  Sleep,
+  sleep_default as SleepHandler
 };
 //# sourceMappingURL=index.mjs.map

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,192 @@
+import * as Context from 'effect/Context';
+import * as Effect from 'effect/Effect';
+import * as Layer from 'effect/Layer';
+import * as Schema from 'effect/Schema';
+import { Database, Migration, Obj, Type } from '@dxos/echo';
+import { BaseError } from '@dxos/errors';
+import * as Operation from './Operation';
+/**
+ * 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.
+ *
+ * The registry `key` and `version` are stored in the object meta — access them via
+ * `Obj.getMeta(blueprint).key` and `Obj.getMeta(blueprint).version`.
+ */
+export declare const Blueprint: Type.Obj<{
+    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: "operation" | "value";
+            readonly default?: any;
+            readonly operation?: string | undefined;
+        }[] | undefined;
+    };
+    readonly tools: readonly (string & import("effect/Brand").Brand<"ToolId">)[];
+    readonly agentCanEnable?: boolean | undefined;
+    readonly mcpServers?: readonly {
+        readonly name?: string | undefined;
+        readonly url: string;
+        readonly protocol: "http" | "sse";
+        readonly apiKey?: string | undefined;
+    }[] | undefined;
+}, Schema.Struct.Fields>;
+/**
+ * TypeScript type for Blueprint.
+ */
+export interface Blueprint extends Schema.Schema.Type<typeof Blueprint> {
+}
+type MakeProps = {
+    key: string;
+    version?: string;
+    name: string;
+} & Partial<Blueprint>;
+/**
+ * Create a new Blueprint.
+ * The `key` (and optional `version`) are stored in the object meta.
+ */
+export declare const make: ({ key, version, tools, instructions, ...props }: MakeProps) => Obj.OfShape<import("@dxos/echo/Entity").OfKind<import("@dxos/echo/internal").EntityKind.Object> & {
+    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: "operation" | "value";
+            readonly default?: any;
+            readonly operation?: string | undefined;
+        }[] | undefined;
+    };
+    readonly tools: readonly (string & import("effect/Brand").Brand<"ToolId">)[];
+    readonly agentCanEnable?: boolean | undefined;
+    readonly mcpServers?: readonly {
+        readonly name?: string | undefined;
+        readonly url: string;
+        readonly protocol: "http" | "sse";
+        readonly apiKey?: string | undefined;
+    }[] | undefined;
+}>;
+/**
+ * Get the registry key for a blueprint.
+ */
+export declare const getKey: (blueprint: Blueprint) => string;
+/**
+ * Get the registry version for a blueprint, if any.
+ */
+export declare const getVersion: (blueprint: Blueprint) => string | 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 {
+    static notAvailable: Layer.Layer<RegistryService, never, never>;
+}
+/**
+ * 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 {
+}
+/**
+ * Blueprint schema v0.1.0 — `key` is stored as a data property.
+ * @deprecated Use {@link Blueprint} (v0.2.0) instead; the `key` and `version` now live in the object meta.
+ */
+export declare const Blueprint_v0_1_0: 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: "operation" | "value";
+            readonly default?: any;
+            readonly operation?: string | undefined;
+        }[] | undefined;
+    };
+    readonly tools: readonly (string & import("effect/Brand").Brand<"ToolId">)[];
+    readonly agentCanEnable?: boolean | undefined;
+    readonly mcpServers?: readonly {
+        readonly name?: string | undefined;
+        readonly url: string;
+        readonly protocol: "http" | "sse";
+        readonly apiKey?: string | undefined;
+    }[] | undefined;
+}, Schema.Struct.Fields>;
+export interface Blueprint_v0_1_0 extends Schema.Schema.Type<typeof Blueprint_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=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":"AAMA,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;AAGxC,OAAO,EAAc,QAAQ,EAAU,SAAS,EAAE,GAAG,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AAChF,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAIzC,OAAO,KAAK,SAAS,MAAM,aAAa,CAAC;AAGzC;;;;;;;GAOG;AAEH,eAAO,MAAM,SAAS;;;;;;;;;;;;;;;;;;;;;;;wBAmDrB,CAAC;AAEF;;GAEG;AACH,MAAM,WAAW,SAAU,SAAQ,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,SAAS,CAAC;CAAG;AAE1E,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;;;;;;;;;;;;;;;;;;;;;;;EAMlG,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,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,EAalC;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,CAkB/D;CACF;;AAED,qBAAa,eAAgB,SAAQ,oBAA4E;IAC/G,MAAM,CAAC,YAAY,6CAaO;CAC3B;AAED;;;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;AAMlG;;;GAGG;AACH,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;wBA2B5B,CAAC;AAEF,MAAM,WAAW,gBAAiB,SAAQ,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,gBAAgB,CAAC;CAAG;AAoBxF;;;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/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, DXN } 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;
+    /**
+     * DXN of the conversation feed the process is running in.
+     * Process affinity only.
+     */
+    readonly conversation?: DXN.String;
+    /**
+     * 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,GAAG,EAAE,MAAM,YAAY,CAAC;AAE1C,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,MAAM,CAAC;IAEnC;;;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,27 @@
+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 interface McpServer extends 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,WAAW,SAAU,SAAQ,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,SAAS,CAAC;CAAG"}