@dxos/compute 0.8.4-main.fcfe5033a5 → 0.8.4-staging.60fe92afc8

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

@@ -1,219 +1,32 @@
 import {
-  AsyncFunctionPlugin,
-  ComputeGraphRegistry
-} from "../chunk-JRV42MW3.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 Effect from "effect/Effect";
-import * as Layer from "effect/Layer";
-import * as ManagedRuntime from "effect/ManagedRuntime";
-import { Operation } from "@dxos/operation";
-var createMockedComputeRuntimeProvider = ({ functions } = {}) => {
-  return {
-    getRuntime: (_spaceId) => ManagedRuntime.make(functions ? Layer.effect(Operation.Service, Effect.gen(function* () {
-      const handlers = yield* functions.handlers;
-      return {
-        invoke: (op, ...args) => {
-          const handler = handlers.find((h) => h.meta.key === op.meta.key);
-          if (!handler) {
-            return Effect.die(`No handler found for operation: ${op.meta.key}`);
-          }
-          const result = handler.handler(args[0]);
-          if (Effect.isEffect(result)) {
-            return result;
-          }
-          return Effect.promise(() => Promise.resolve(result));
-        },
-        schedule: () => Effect.void,
-        invokePromise: async () => ({
-          error: new Error("Not implemented in test runtime")
-        })
-      };
-    })) : Layer.succeed(Operation.Service, {
-      invoke: () => Effect.die("Operation.Service not available in test."),
-      schedule: () => Effect.die("Operation.Service not available in test."),
-      invokePromise: async () => ({
-        error: new Error("Not available")
-      })
-    }))
-  };
-};
-
-// 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: 28,
-      S: this,
-      A: [
-        "this._client",
-        ""
-      ]
-    });
-    return this._client;
-  }
-  get registry() {
-    invariant(this._registry, void 0, {
-      F: __dxlog_file,
-      L: 33,
-      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-Z3Y7FQGN.mjs";
+import {
+  fib_default
+} from "../chunk-AFBNVFAY.mjs";
+import {
+  reply_default
+} from "../chunk-MEPE4HHX.mjs";
+import {
+  sleep_default
+} from "../chunk-2B2KSJT6.mjs";
+import {
+  Fibonacci,
+  Reply,
+  Sleep
+} from "../chunk-JAU4E4EK.mjs";
+import "../chunk-QZS4G6PE.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-HBDUGQW7.mjs"), () => import("../reply-RJIAJ6FV.mjs"), () => import("../sleep-3T2CZ7RE.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';\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 Effect from 'effect/Effect';\nimport * as Layer from 'effect/Layer';\nimport * as ManagedRuntime from 'effect/ManagedRuntime';\n\nimport { type SpaceId } from '@dxos/client/echo';\nimport { Operation, OperationHandlerSet } from '@dxos/operation';\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?: OperationHandlerSet.OperationHandlerSet } = {}): FunctionsRuntimeProvider => {\n  return {\n    getRuntime: (_spaceId: SpaceId) =>\n      ManagedRuntime.make(\n        functions\n          ? Layer.effect(\n              Operation.Service,\n              Effect.gen(function* () {\n                const handlers = yield* functions.handlers;\n                return {\n                  invoke: (op: any, ...args: any[]) => {\n                    const handler = handlers.find((h: any) => h.meta.key === op.meta.key);\n                    if (!handler) {\n                      return Effect.die(`No handler found for operation: ${op.meta.key}`);\n                    }\n                    const result = handler.handler(args[0]);\n                    if (Effect.isEffect(result)) {\n                      return result as Effect.Effect<unknown>;\n                    }\n                    return Effect.promise(() => Promise.resolve(result));\n                  },\n                  schedule: () => Effect.void,\n                  invokePromise: async () => ({ error: new Error('Not implemented in test runtime') }),\n                } as Operation.OperationService;\n              }),\n            )\n          : Layer.succeed(Operation.Service, {\n              invoke: () => Effect.die('Operation.Service not available in test.'),\n              schedule: () => Effect.die('Operation.Service not available in test.'),\n              invokePromise: async () => ({ error: new Error('Not available') }),\n            } as any),\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", "Effect", "Layer", "ManagedRuntime", "Operation", "createMockedComputeRuntimeProvider", "functions", "getRuntime", "_spaceId", "make", "effect", "Operation", "Service", "gen", "handlers", "invoke", "op", "args", "handler", "find", "h", "meta", "key", "die", "result", "isEffect", "promise", "Promise", "resolve", "schedule", "void", "invokePromise", "error", "Error", "succeed", "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,182 @@
+import * as Effect from 'effect/Effect';
+import * as Schema from 'effect/Schema';
+import { Database, Migration, Obj, Registry, Type, URI } 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<{
+            readonly name?: string | undefined;
+            readonly content: string;
+        } & import("@dxos/echo/Entity").OfKind<import("@dxos/echo/internal").EntityKind.Object> & Obj.Unknown>;
+        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 type Blueprint = Type.InstanceType<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<{
+    readonly name: string;
+    readonly description?: string | undefined;
+    readonly instructions: {
+        readonly source: import("@dxos/echo/internal").Ref<{
+            readonly name?: string | undefined;
+            readonly content: string;
+        } & import("@dxos/echo/Entity").OfKind<import("@dxos/echo/internal").EntityKind.Object> & Obj.Unknown>;
+        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;
+} & import("@dxos/echo/Entity").OfKind<import("@dxos/echo/internal").EntityKind.Object>>;
+/**
+ * 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;
+};
+/**
+ * Returns the canonical URI used to reference this blueprint in the registry.
+ * Valid DXN keys produce `dxn:<key>`; other keys use the raw key as a URI.
+ * Use this URI with `Ref.fromURI` to bind a blueprint without cloning it to the DB.
+ *
+ * TODO(wittjosiah): Should use Obj.getURI instead once it supports options to prefer meta key over EID.
+ */
+export declare const registryURI: (key: string) => URI.URI;
+/**
+ * Resolves a blueprint from the registry by its meta key.
+ * Does not check the local database for the blueprint.
+ */
+export declare const resolve: (key: string) => Effect.Effect<Blueprint, NotFoundError, Registry.Service>;
+/**
+ * Upserts a blueprint into the database.
+ * If the blueprint already exists in the database, the local (possibly forked) copy is returned as-is.
+ * Otherwise, a fresh copy is cloned from the registry and added.
+ * @deprecated Since we're using a registry we no longer need to store blueprints in the database.
+ */
+export declare const upsert: (key: string) => Effect.Effect<Blueprint, NotFoundError, Registry.Service | 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<{
+            readonly name?: string | undefined;
+            readonly content: string;
+        } & import("@dxos/echo/Entity").OfKind<import("@dxos/echo/internal").EntityKind.Object> & Obj.Unknown>;
+        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 type Blueprint_v0_1_0 = Type.InstanceType<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,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"}