@dxos/blueprints 0.8.4-main.72ec0f3 → 0.8.4-main.74a063c4e0

package/dist/lib/neutral/index.mjs

@@ -0,0 +1,340 @@
+var __defProp = Object.defineProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+
+// src/blueprint/index.ts
+var blueprint_exports = {};
+__export(blueprint_exports, {
+  Blueprint: () => Blueprint,
+  McpServer: () => McpServer,
+  NotFoundError: () => NotFoundError,
+  Registry: () => Registry,
+  RegistryService: () => RegistryService,
+  make: () => make2,
+  resolve: () => resolve,
+  toolDefinitions: () => toolDefinitions,
+  upsert: () => upsert
+});
+
+// src/blueprint/blueprint.ts
+import * as Schema2 from "effect/Schema";
+import { ToolId } from "@dxos/ai";
+import { Annotation, Obj, Type } from "@dxos/echo";
+
+// src/template/index.ts
+var template_exports = {};
+__export(template_exports, {
+  Input: () => Input,
+  InputKind: () => InputKind,
+  Template: () => Template,
+  make: () => make,
+  process: () => process,
+  processTemplate: () => processTemplate
+});
+
+// src/template/prompt.ts
+import * as Effect from "effect/Effect";
+import * as Record from "effect/Record";
+import handlebars from "handlebars";
+import { Database } from "@dxos/echo";
+import { FunctionInvocationService } from "@dxos/functions";
+import { invariant } from "@dxos/invariant";
+import { log } from "@dxos/log";
+var __dxlog_file = "/__w/dxos/dxos/packages/core/blueprints/src/template/prompt.ts";
+var process = (source, variables = {}) => {
+  invariant(typeof source === "string", void 0, {
+    F: __dxlog_file,
+    L: 21,
+    S: void 0,
+    A: [
+      "typeof source === 'string'",
+      ""
+    ]
+  });
+  let section = 0;
+  handlebars.registerHelper("section", () => String(++section));
+  const template = handlebars.compile(source.trim());
+  const output = template(variables);
+  return output.trim().replace(/(\n\s*){3,}/g, "\n\n");
+};
+var processTemplate = (template) => Effect.gen(function* () {
+  const functionInvoker = yield* FunctionInvocationService;
+  const variables = yield* Effect.forEach(template.inputs ?? [], (input) => Effect.gen(function* () {
+    if (input.kind === "function") {
+      const fn = yield* functionInvoker.resolveFunction(input.function);
+      const result = yield* functionInvoker.invokeFunction(fn, {});
+      return [
+        input.name,
+        result
+      ];
+    } else {
+      return yield* Effect.dieMessage(`Unsupported input kind: ${input.kind}`);
+    }
+  })).pipe(Effect.map(Record.fromEntries));
+  log("processTemplate", {
+    variables
+  }, {
+    F: __dxlog_file,
+    L: 48,
+    S: this,
+    C: (f, a) => f(...a)
+  });
+  return process((yield* Database.load(template.source)).content, variables);
+});
+
+// src/template/template.ts
+import * as Schema from "effect/Schema";
+import { Ref } from "@dxos/echo";
+import { Text } from "@dxos/schema";
+var InputKind = Schema.Literal("value", "pass-through", "retriever", "function", "query", "resolver", "context", "schema");
+var Input = Schema.Struct({
+  name: Schema.String,
+  kind: Schema.optional(InputKind),
+  default: Schema.optional(Schema.Any),
+  /**
+  * Function to call if the kind is 'function'.
+  */
+  function: Schema.optional(Schema.String)
+});
+var Template = Schema.Struct({
+  source: Ref.Ref(Text.Text).annotations({
+    description: "Handlebars template source"
+  }),
+  inputs: Schema.optional(Schema.Array(Input))
+});
+var make = ({ id, source, inputs = [] } = {}) => ({
+  source: Ref.make(Text.make({
+    id,
+    content: source
+  })),
+  inputs
+});
+
+// src/blueprint/blueprint.ts
+var McpServer = Schema2.Struct({
+  /**
+  * URL of the MCP server.
+  */
+  url: Schema2.String.annotations({
+    description: "URL of the MCP server"
+  }),
+  protocol: Schema2.Union(Schema2.Literal("sse"), Schema2.Literal("http")).annotations({
+    description: "Protocol of the MCP server"
+  })
+});
+var Blueprint = Schema2.Struct({
+  /**
+  * Global registry ID.
+  * NOTE: The `key` property refers to the original registry entry.
+  */
+  // TODO(burdon): Create Format type for DXN-like ids, such as this and schema type.
+  key: Schema2.String.annotations({
+    description: "Unique registration key for the blueprint"
+  }),
+  /**
+  * Human-readable name of the blueprint.
+  */
+  name: Schema2.String.annotations({
+    description: "Human-readable name of the blueprint"
+  }),
+  /**
+  * Description of the blueprint's purpose and functionality.
+  */
+  description: Schema2.optional(Schema2.String).annotations({
+    description: "Description of the blueprint's purpose and functionality"
+  }),
+  /**
+  * Instructions that guide the AI assistant's behavior and responses.
+  * These are system prompts or guidelines that the AI should follow.
+  */
+  instructions: Template.annotations({
+    description: "Instructions that guide the AI assistant's behavior and responses"
+  }),
+  /**
+  * Array of tools that the AI assistant can use when this blueprint is active.
+  */
+  tools: Schema2.Array(ToolId).annotations({
+    description: "Array of tools that the AI assistant can use when this blueprint is active"
+  }),
+  /**
+  * Whether an agent is allowed to auto-enable this blueprint in a conversation.
+  */
+  agentCanEnable: Schema2.optional(Schema2.Boolean).annotations({
+    description: "Whether an agent is allowed to auto-enable this blueprint in a conversation."
+  }),
+  /**
+  * Array of MCP servers that the AI assistant can use when this blueprint is active.
+  */
+  mcpServers: Schema2.optional(Schema2.Array(McpServer))
+}).pipe(Type.object({
+  // TODO(burdon): Is this a DXN? Need to create a Format type for these IDs.
+  typename: "org.dxos.type.blueprint",
+  version: "0.1.0"
+}), Annotation.LabelAnnotation.set([
+  "name"
+]), Annotation.IconAnnotation.set({
+  icon: "ph--blueprint--regular",
+  hue: "sky"
+}));
+var make2 = ({ tools = [], instructions = make(), ...props }) => Obj.make(Blueprint, {
+  tools,
+  instructions,
+  ...props
+});
+var toolDefinitions = ({ tools = [], operations = [] }) => [
+  ...operations.map((op) => ToolId.make(op.meta.key)),
+  ...tools.map((tool) => ToolId.make(tool))
+];
+
+// src/blueprint/registry.ts
+import * as Context from "effect/Context";
+import * as Effect2 from "effect/Effect";
+import { Database as Database2, Filter, Obj as Obj2 } from "@dxos/echo";
+import { BaseError } from "@dxos/errors";
+import { log as log2 } from "@dxos/log";
+var __dxlog_file2 = "/__w/dxos/dxos/packages/core/blueprints/src/blueprint/registry.ts";
+var Registry = class {
+  _blueprints = [];
+  constructor(blueprints) {
+    const seen = /* @__PURE__ */ new Set();
+    blueprints.forEach((blueprint) => {
+      if (seen.has(blueprint.key)) {
+        log2.warn("duplicate blueprint", {
+          key: blueprint.key
+        }, {
+          F: __dxlog_file2,
+          L: 24,
+          S: this,
+          C: (f, a) => f(...a)
+        });
+      } else {
+        seen.add(blueprint.key);
+        this._blueprints.push(blueprint);
+      }
+    });
+    this._blueprints.sort(({ name: a }, { name: b }) => a.localeCompare(b));
+  }
+  get blueprints() {
+    return this._blueprints;
+  }
+  getByKey(key) {
+    return this._blueprints.find((blueprint) => blueprint.key === key);
+  }
+  query() {
+    return this._blueprints;
+  }
+  updateBlueprints() {
+    return Effect2.gen(this, function* () {
+      const blueprints = yield* Database2.runQuery(Filter.type(Blueprint));
+      for (const blueprint of blueprints) {
+        const registryBlueprint = this.getByKey(blueprint.key);
+        if (!registryBlueprint) {
+          continue;
+        }
+        const source = Obj2.clone(registryBlueprint, {
+          deep: true
+        });
+        Obj2.change(blueprint, (mutable) => {
+          void Obj2.updateFrom(mutable, source);
+        });
+      }
+    }).pipe(Effect2.orDie);
+  }
+};
+var RegistryService = class extends Context.Tag("@dxos/blueprints/RegistryService")() {
+};
+var resolve = (key) => Effect2.gen(function* () {
+  const registry = yield* RegistryService;
+  const blueprint = registry.getByKey(key);
+  if (!blueprint) {
+    return yield* Effect2.fail(new NotFoundError({
+      context: {
+        key
+      }
+    }));
+  }
+  return blueprint;
+});
+var upsert = (key) => Effect2.gen(function* () {
+  const local = yield* Database2.runQuery(Filter.type(Blueprint, {
+    key
+  }));
+  if (local.length > 0) {
+    return local[0];
+  }
+  return yield* Database2.add(Obj2.clone(yield* resolve(key), {
+    deep: true
+  }));
+});
+var NotFoundError = class extends BaseError.extend("BlueprintNotFound", "Blueprint not found") {
+};
+
+// src/prompt/index.ts
+var prompt_exports = {};
+__export(prompt_exports, {
+  Prompt: () => Prompt,
+  make: () => make3
+});
+
+// src/prompt/prompt.ts
+import * as Schema3 from "effect/Schema";
+import { Annotation as Annotation2, JsonSchema, Obj as Obj3, Ref as Ref2, Type as Type2 } from "@dxos/echo";
+var Prompt = Schema3.Struct({
+  /**
+  * Name of the prompt.
+  */
+  name: Schema3.optional(Schema3.String),
+  /**
+  * Description of the prompt's purpose and functionality.
+  * Allows AI agents to execute prompts automatically as tools.
+  */
+  description: Schema3.optional(Schema3.String),
+  /**
+  * Input schema of the prompt.
+  */
+  input: JsonSchema.JsonSchema.pipe(Annotation2.FormInputAnnotation.set(false)),
+  /**
+  * Output schema of the prompt.
+  */
+  output: JsonSchema.JsonSchema.pipe(Annotation2.FormInputAnnotation.set(false)),
+  /**
+  * Natural language instructions for the prompt.
+  * These should provide concrete course of action for the AI to follow.
+  */
+  instructions: Template.pipe(Annotation2.FormInputAnnotation.set(false)),
+  /**
+  * Blueprints that the prompt may utilize.
+  */
+  blueprints: Schema3.Array(Ref2.Ref(Blueprint)),
+  /**
+  * Additional context that the prompt may utilize.
+  */
+  context: Schema3.Array(Schema3.Any).pipe(Annotation2.FormInputAnnotation.set(false))
+}).pipe(Type2.object({
+  typename: "org.dxos.type.prompt",
+  version: "0.1.0"
+}), Annotation2.LabelAnnotation.set([
+  "name"
+]), Annotation2.IconAnnotation.set({
+  icon: "ph--scroll--regular",
+  hue: "sky"
+}));
+var make3 = (params) => Obj3.make(Prompt, {
+  name: params.name,
+  description: params.description,
+  input: JsonSchema.toJsonSchema(params.input ?? Schema3.Void),
+  output: JsonSchema.toJsonSchema(params.output ?? Schema3.Void),
+  instructions: make({
+    source: params.instructions
+  }),
+  blueprints: params.blueprints ?? [],
+  context: params.context ?? []
+});
+export {
+  blueprint_exports as Blueprint,
+  prompt_exports as Prompt,
+  template_exports as Template
+};
+//# sourceMappingURL=index.mjs.map

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

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/blueprint/index.ts", "../../../src/blueprint/blueprint.ts", "../../../src/template/index.ts", "../../../src/template/prompt.ts", "../../../src/template/template.ts", "../../../src/blueprint/registry.ts", "../../../src/prompt/index.ts", "../../../src/prompt/prompt.ts"],
+  "sourcesContent": ["//\n// Copyright 2025 DXOS.org\n//\n\nexport * from './blueprint';\nexport * from './registry';\n", "//\n// Copyright 2025 DXOS.org\n//\n\nimport * as Schema from 'effect/Schema';\n\nimport { ToolId } from '@dxos/ai';\nimport { Annotation, Obj, Type } from '@dxos/echo';\nimport { type Operation } from '@dxos/operation';\n\nimport * as Template from '../template';\n\n/**\n * MCP server definition.\n */\nexport const McpServer = Schema.Struct({\n  /**\n   * URL of the MCP server.\n   */\n  url: Schema.String.annotations({\n    description: 'URL of the MCP server',\n  }),\n\n  protocol: Schema.Union(Schema.Literal('sse'), Schema.Literal('http')).annotations({\n    description: 'Protocol of the MCP server',\n  }),\n});\nexport interface McpServer extends Schema.Schema.Type<typeof McpServer> {}\n\n/**\n * Blueprint schema defines the structure for AI assistant blueprints.\n * Blueprints contain instructions, tools, and artifacts that guide the AI's behavior.\n * Blueprints may use tools to create and read artifacts, which are managed by the assistant.\n */\nexport const Blueprint = Schema.Struct({\n  /**\n   * Global registry ID.\n   * NOTE: The `key` property refers to the original registry entry.\n   */\n  // TODO(burdon): Create Format type for DXN-like ids, such as this and schema type.\n  key: Schema.String.annotations({\n    description: 'Unique registration key for the blueprint',\n  }),\n\n  /**\n   * Human-readable name of the blueprint.\n   */\n  name: Schema.String.annotations({\n    description: 'Human-readable name of the blueprint',\n  }),\n\n  /**\n   * Description of the blueprint's purpose and functionality.\n   */\n  description: Schema.optional(Schema.String).annotations({\n    description: \"Description of the blueprint's purpose and functionality\",\n  }),\n\n  /**\n   * Instructions that guide the AI assistant's behavior and responses.\n   * These are system prompts or guidelines that the AI should follow.\n   */\n  instructions: Template.Template.annotations({\n    description: \"Instructions that guide the AI assistant's behavior and responses\",\n  }),\n\n  /**\n   * Array of tools that the AI assistant can use when this blueprint is active.\n   */\n  tools: Schema.Array(ToolId).annotations({\n    description: 'Array of tools that the AI assistant can use when this blueprint is active',\n  }),\n\n  /**\n   * Whether an agent is allowed to auto-enable this blueprint in a conversation.\n   */\n  agentCanEnable: Schema.optional(Schema.Boolean).annotations({\n    description: 'Whether an agent is allowed to auto-enable this blueprint in a conversation.',\n  }),\n\n  /**\n   * Array of MCP servers that the AI assistant can use when this blueprint is active.\n   */\n  mcpServers: Schema.optional(Schema.Array(McpServer)),\n}).pipe(\n  Type.object({\n    // TODO(burdon): Is this a DXN? Need to create a Format type for these IDs.\n    typename: 'org.dxos.type.blueprint',\n    version: '0.1.0',\n  }),\n  Annotation.LabelAnnotation.set(['name']),\n  Annotation.IconAnnotation.set({\n    icon: 'ph--blueprint--regular',\n    hue: 'sky',\n  }),\n);\n\n/**\n * TypeScript type for Blueprint.\n */\nexport interface Blueprint extends Schema.Schema.Type<typeof Blueprint> {}\n\ntype MakeProps = Pick<Blueprint, 'key' | 'name'> & Partial<Blueprint>;\n\n/**\n * Create a new Blueprint.\n */\nexport const make = ({ tools = [], instructions = Template.make(), ...props }: MakeProps) =>\n  Obj.make(Blueprint, {\n    tools,\n    instructions,\n    ...props,\n  });\n\n/**\n * Util to create tool definitions for a blueprint.\n */\nexport const toolDefinitions = ({\n  tools = [],\n  operations = [],\n}: {\n  tools?: string[];\n  operations?: Operation.Definition.Any[];\n}) => [...operations.map((op) => ToolId.make(op.meta.key)), ...tools.map((tool) => ToolId.make(tool))];\n", "//\n// Copyright 2025 DXOS.org\n//\n\nexport * from './prompt';\nexport * from './template';\n", "//\n// Copyright 2024 DXOS.org\n//\n\nimport * as Effect from 'effect/Effect';\nimport * as Record from 'effect/Record';\nimport handlebars from 'handlebars';\n\nimport { Database } from '@dxos/echo';\nimport type { ObjectNotFoundError } from '@dxos/echo/Err';\nimport { FunctionInvocationService, type FunctionNotFoundError, type TracingService } from '@dxos/functions';\nimport { invariant } from '@dxos/invariant';\nimport { log } from '@dxos/log';\n\nimport type { Template } from '../index';\n\n/**\n * Process Handlebars template.\n */\nexport const process = <Options extends {}>(source: string, variables: Partial<Options> = {}): string => {\n  invariant(typeof source === 'string');\n  let section = 0;\n  handlebars.registerHelper('section', () => String(++section));\n  const template = handlebars.compile(source.trim());\n  const output = template(variables);\n  return output.trim().replace(/(\\n\\s*){3,}/g, '\\n\\n');\n};\n\nexport const processTemplate = (\n  template: Template.Template,\n): Effect.Effect<string, ObjectNotFoundError | FunctionNotFoundError, FunctionInvocationService | TracingService> =>\n  Effect.gen(function* () {\n    const functionInvoker = yield* FunctionInvocationService;\n\n    const variables = yield* Effect.forEach(template.inputs ?? [], (input) =>\n      Effect.gen(function* () {\n        if (input.kind === 'function') {\n          // TODO(dmaretskyi): create FunctionInvoker.invokeByKey function.\n          const fn = yield* functionInvoker.resolveFunction(input.function!);\n          const result = yield* functionInvoker.invokeFunction(fn, {});\n          return [input.name, result] as const;\n        } else {\n          return yield* Effect.dieMessage(`Unsupported input kind: ${input.kind}`);\n        }\n      }),\n    ).pipe(Effect.map(Record.fromEntries));\n\n    log('processTemplate', { variables });\n    return process((yield* Database.load(template.source)).content, variables);\n  });\n", "//\n// Copyright 2024 DXOS.org\n//\n\nimport * as Schema from 'effect/Schema';\n\nimport { Ref } from '@dxos/echo';\nimport { Text } from '@dxos/schema';\n\n/**\n * Template input kind determines how template variables are resolved.\n */\nexport const InputKind = Schema.Literal(\n  'value', // Literal value.\n  'pass-through',\n  'retriever',\n  'function',\n  'query',\n  'resolver',\n  'context',\n  'schema',\n);\n\nexport type InputKind = Schema.Schema.Type<typeof InputKind>;\n\n/**\n * Template input variable.\n * E.g., {{foo}}\n */\nexport const Input = Schema.Struct({\n  name: Schema.String,\n  kind: Schema.optional(InputKind),\n  default: Schema.optional(Schema.Any),\n\n  /**\n   * Function to call if the kind is 'function'.\n   */\n  function: Schema.optional(Schema.String),\n});\n\nexport type Input = Schema.Schema.Type<typeof Input>;\n\n/**\n * Template type.\n */\nexport const Template = Schema.Struct({\n  source: Ref.Ref(Text.Text).annotations({ description: 'Handlebars template source' }),\n  inputs: Schema.optional(Schema.Array(Input)),\n});\n\nexport interface Template extends Schema.Schema.Type<typeof Template> {}\n\nexport const make = ({\n  id,\n  source,\n  inputs = [],\n}: { id?: string; source?: string; inputs?: Input[] } = {}): Template => ({\n  source: Ref.make(Text.make({ id, content: source })),\n  inputs,\n});\n", "//\n// Copyright 2025 DXOS.org\n//\n\nimport * as Context from 'effect/Context';\nimport * as Effect from 'effect/Effect';\n\nimport { Database, Filter, Obj } from '@dxos/echo';\nimport { BaseError } from '@dxos/errors';\nimport { log } from '@dxos/log';\n\nimport { Blueprint } from './blueprint';\n\n/**\n * Blueprint registry.\n */\nexport class Registry {\n  private readonly _blueprints: Blueprint[] = [];\n\n  constructor(blueprints: Blueprint[]) {\n    const seen = new Set<string>();\n    blueprints.forEach((blueprint) => {\n      if (seen.has(blueprint.key)) {\n        log.warn('duplicate blueprint', { key: blueprint.key });\n      } else {\n        seen.add(blueprint.key);\n        this._blueprints.push(blueprint);\n      }\n    });\n\n    this._blueprints.sort(({ name: a }, { name: b }) => a.localeCompare(b));\n  }\n\n  get blueprints(): Blueprint[] {\n    return this._blueprints;\n  }\n\n  getByKey(key: string): Blueprint | undefined {\n    return this._blueprints.find((blueprint) => blueprint.key === key);\n  }\n\n  query(): Blueprint[] {\n    return this._blueprints;\n  }\n\n  updateBlueprints(): Effect.Effect<void, never, Database.Service> {\n    return Effect.gen(this, function* () {\n      const blueprints = yield* Database.runQuery(Filter.type(Blueprint));\n      for (const blueprint of blueprints) {\n        const registryBlueprint = this.getByKey(blueprint.key);\n        if (!registryBlueprint) {\n          continue;\n        }\n        const source = Obj.clone(registryBlueprint, { deep: true });\n        Obj.change(blueprint, (mutable) => {\n          void Obj.updateFrom(mutable, source);\n        });\n      }\n    }).pipe(Effect.orDie);\n  }\n}\n\nexport class RegistryService extends Context.Tag('@dxos/blueprints/RegistryService')<RegistryService, Registry>() {}\n\n/**\n * Resolves a blueprint from the registry.\n * Does not check the local database for the blueprint.\n */\nexport const resolve = (key: string): Effect.Effect<Blueprint, NotFoundError, RegistryService> =>\n  Effect.gen(function* () {\n    const registry = yield* RegistryService;\n    const blueprint = registry.getByKey(key);\n    if (!blueprint) {\n      return yield* Effect.fail(new NotFoundError({ context: { key } }));\n    }\n    return blueprint;\n  });\n\n/**\n * Upserts a blueprint into the database.\n * If the blueprint already exists in the database, local blueprint is returned.\n * Otherwise, it will be added.\n */\nexport const upsert = (key: string): Effect.Effect<Blueprint, NotFoundError, RegistryService | Database.Service> =>\n  Effect.gen(function* () {\n    const local = yield* Database.runQuery(Filter.type(Blueprint, { key }));\n    if (local.length > 0) {\n      return local[0];\n    }\n    return yield* Database.add(Obj.clone(yield* resolve(key), { deep: true }));\n  });\n\nexport class NotFoundError extends BaseError.extend('BlueprintNotFound', 'Blueprint not found') {}\n", "//\n// Copyright 2025 DXOS.org\n//\n\nexport * from './prompt';\n", "//\n// Copyright 2025 DXOS.org\n//\n\nimport * as Schema from 'effect/Schema';\n\nimport { Annotation, JsonSchema, Obj, Ref, Type } from '@dxos/echo';\n\nimport { Blueprint } from '../blueprint';\nimport * as Template from '../template';\n\n/**\n * Executable instructions, which may use Blueprints.\n * May reference additional context.\n */\nexport const Prompt = Schema.Struct({\n  /**\n   * Name of the prompt.\n   */\n  name: Schema.optional(Schema.String),\n\n  /**\n   * Description of the prompt's purpose and functionality.\n   * Allows AI agents to execute prompts automatically as tools.\n   */\n  description: Schema.optional(Schema.String),\n\n  /**\n   * Input schema of the prompt.\n   */\n  input: JsonSchema.JsonSchema.pipe(Annotation.FormInputAnnotation.set(false)),\n\n  /**\n   * Output schema of the prompt.\n   */\n  output: JsonSchema.JsonSchema.pipe(Annotation.FormInputAnnotation.set(false)),\n\n  /**\n   * Natural language instructions for the prompt.\n   * These should provide concrete course of action for the AI to follow.\n   */\n  instructions: Template.Template.pipe(Annotation.FormInputAnnotation.set(false)),\n\n  /**\n   * Blueprints that the prompt may utilize.\n   */\n  blueprints: Schema.Array(Ref.Ref(Blueprint)),\n\n  /**\n   * Additional context that the prompt may utilize.\n   */\n  context: Schema.Array(Schema.Any).pipe(Annotation.FormInputAnnotation.set(false)),\n}).pipe(\n  Type.object({\n    typename: 'org.dxos.type.prompt',\n    version: '0.1.0',\n  }),\n  Annotation.LabelAnnotation.set(['name']),\n  Annotation.IconAnnotation.set({\n    icon: 'ph--scroll--regular',\n    hue: 'sky',\n  }),\n);\n\nexport interface Prompt extends Schema.Schema.Type<typeof Prompt> {}\n\nexport const make = (params: {\n  name?: string;\n  description?: string;\n  input?: Schema.Schema.AnyNoContext;\n  output?: Schema.Schema.AnyNoContext;\n  instructions?: string;\n  blueprints?: Ref.Ref<Blueprint>[];\n  context?: any[];\n}): Prompt =>\n  Obj.make(Prompt, {\n    name: params.name,\n    description: params.description,\n    input: JsonSchema.toJsonSchema(params.input ?? Schema.Void),\n    output: JsonSchema.toJsonSchema(params.output ?? Schema.Void),\n    instructions: Template.make({ source: params.instructions }),\n    blueprints: params.blueprints ?? [],\n    context: params.context ?? [],\n  });\n"],
+  "mappings": "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",
+  "names": ["make", "Schema", "ToolId", "Annotation", "Obj", "Type", "Effect", "Record", "handlebars", "Database", "FunctionInvocationService", "invariant", "log", "process", "source", "variables", "section", "registerHelper", "String", "template", "compile", "trim", "output", "replace", "processTemplate", "gen", "functionInvoker", "forEach", "inputs", "input", "kind", "fn", "resolveFunction", "function", "result", "invokeFunction", "name", "dieMessage", "pipe", "map", "fromEntries", "load", "content", "Schema", "Ref", "Text", "InputKind", "Literal", "Input", "Struct", "name", "String", "kind", "optional", "default", "Any", "function", "Template", "source", "Ref", "Text", "annotations", "description", "inputs", "Array", "make", "id", "content", "McpServer", "Struct", "url", "String", "annotations", "description", "protocol", "Union", "Literal", "Blueprint", "key", "name", "optional", "instructions", "Template", "tools", "Array", "ToolId", "agentCanEnable", "Boolean", "mcpServers", "pipe", "Type", "object", "typename", "version", "Annotation", "LabelAnnotation", "set", "IconAnnotation", "icon", "hue", "make", "props", "Obj", "toolDefinitions", "operations", "map", "op", "meta", "tool", "Context", "Effect", "Database", "Filter", "Obj", "BaseError", "log", "Registry", "_blueprints", "blueprints", "seen", "Set", "forEach", "blueprint", "has", "key", "log", "warn", "add", "push", "sort", "name", "a", "b", "localeCompare", "getByKey", "find", "query", "updateBlueprints", "gen", "Database", "runQuery", "Filter", "type", "Blueprint", "registryBlueprint", "source", "Obj", "clone", "deep", "change", "mutable", "updateFrom", "pipe", "orDie", "RegistryService", "Tag", "resolve", "registry", "fail", "NotFoundError", "context", "upsert", "local", "length", "BaseError", "extend", "make", "Schema", "Annotation", "JsonSchema", "Obj", "Ref", "Type", "Prompt", "Struct", "name", "optional", "String", "description", "input", "JsonSchema", "pipe", "Annotation", "FormInputAnnotation", "set", "output", "instructions", "Template", "blueprints", "Array", "Ref", "Blueprint", "context", "Any", "Type", "object", "typename", "version", "LabelAnnotation", "IconAnnotation", "icon", "hue", "make", "params", "Obj", "toJsonSchema", "Void", "source"]
+}

package/dist/lib/neutral/meta.json

@@ -0,0 +1 @@
+{"inputs":{"src/template/prompt.ts":{"bytes":6910,"imports":[{"path":"effect/Effect","kind":"import-statement","external":true},{"path":"effect/Record","kind":"import-statement","external":true},{"path":"handlebars","kind":"import-statement","external":true},{"path":"@dxos/echo","kind":"import-statement","external":true},{"path":"@dxos/functions","kind":"import-statement","external":true},{"path":"@dxos/invariant","kind":"import-statement","external":true},{"path":"@dxos/log","kind":"import-statement","external":true}],"format":"esm"},"src/template/template.ts":{"bytes":4444,"imports":[{"path":"effect/Schema","kind":"import-statement","external":true},{"path":"@dxos/echo","kind":"import-statement","external":true},{"path":"@dxos/schema","kind":"import-statement","external":true}],"format":"esm"},"src/template/index.ts":{"bytes":546,"imports":[{"path":"src/template/prompt.ts","kind":"import-statement","original":"./prompt"},{"path":"src/template/template.ts","kind":"import-statement","original":"./template"}],"format":"esm"},"src/blueprint/blueprint.ts":{"bytes":11107,"imports":[{"path":"effect/Schema","kind":"import-statement","external":true},{"path":"@dxos/ai","kind":"import-statement","external":true},{"path":"@dxos/echo","kind":"import-statement","external":true},{"path":"src/template/index.ts","kind":"import-statement","original":"../template"}],"format":"esm"},"src/blueprint/registry.ts":{"bytes":10466,"imports":[{"path":"effect/Context","kind":"import-statement","external":true},{"path":"effect/Effect","kind":"import-statement","external":true},{"path":"@dxos/echo","kind":"import-statement","external":true},{"path":"@dxos/errors","kind":"import-statement","external":true},{"path":"@dxos/log","kind":"import-statement","external":true},{"path":"src/blueprint/blueprint.ts","kind":"import-statement","original":"./blueprint"}],"format":"esm"},"src/blueprint/index.ts":{"bytes":554,"imports":[{"path":"src/blueprint/blueprint.ts","kind":"import-statement","original":"./blueprint"},{"path":"src/blueprint/registry.ts","kind":"import-statement","original":"./registry"}],"format":"esm"},"src/prompt/prompt.ts":{"bytes":7592,"imports":[{"path":"effect/Schema","kind":"import-statement","external":true},{"path":"@dxos/echo","kind":"import-statement","external":true},{"path":"src/blueprint/index.ts","kind":"import-statement","original":"../blueprint"},{"path":"src/template/index.ts","kind":"import-statement","original":"../template"}],"format":"esm"},"src/prompt/index.ts":{"bytes":456,"imports":[{"path":"src/prompt/prompt.ts","kind":"import-statement","original":"./prompt"}],"format":"esm"},"src/index.ts":{"bytes":813,"imports":[{"path":"src/blueprint/index.ts","kind":"import-statement","original":"./blueprint"},{"path":"src/template/index.ts","kind":"import-statement","original":"./template"},{"path":"src/prompt/index.ts","kind":"import-statement","original":"./prompt"}],"format":"esm"}},"outputs":{"dist/lib/neutral/index.mjs.map":{"imports":[],"exports":[],"inputs":{},"bytes":20508},"dist/lib/neutral/index.mjs":{"imports":[{"path":"effect/Schema","kind":"import-statement","external":true},{"path":"@dxos/ai","kind":"import-statement","external":true},{"path":"@dxos/echo","kind":"import-statement","external":true},{"path":"effect/Effect","kind":"import-statement","external":true},{"path":"effect/Record","kind":"import-statement","external":true},{"path":"handlebars","kind":"import-statement","external":true},{"path":"@dxos/echo","kind":"import-statement","external":true},{"path":"@dxos/functions","kind":"import-statement","external":true},{"path":"@dxos/invariant","kind":"import-statement","external":true},{"path":"@dxos/log","kind":"import-statement","external":true},{"path":"effect/Schema","kind":"import-statement","external":true},{"path":"@dxos/echo","kind":"import-statement","external":true},{"path":"@dxos/schema","kind":"import-statement","external":true},{"path":"effect/Context","kind":"import-statement","external":true},{"path":"effect/Effect","kind":"import-statement","external":true},{"path":"@dxos/echo","kind":"import-statement","external":true},{"path":"@dxos/errors","kind":"import-statement","external":true},{"path":"@dxos/log","kind":"import-statement","external":true},{"path":"effect/Schema","kind":"import-statement","external":true},{"path":"@dxos/echo","kind":"import-statement","external":true}],"exports":["Blueprint","Prompt","Template"],"entryPoint":"src/index.ts","inputs":{"src/blueprint/index.ts":{"bytesInOutput":342},"src/blueprint/blueprint.ts":{"bytesInOutput":2635},"src/template/index.ts":{"bytesInOutput":227},"src/template/prompt.ts":{"bytesInOutput":1634},"src/template/template.ts":{"bytesInOutput":777},"src/blueprint/registry.ts":{"bytesInOutput":2392},"src/index.ts":{"bytesInOutput":0},"src/prompt/index.ts":{"bytesInOutput":100},"src/prompt/prompt.ts":{"bytesInOutput":1732}},"bytes":10396}}}

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

@@ -1,73 +1,84 @@
 import * as Schema from 'effect/Schema';
-import { Type } from '@dxos/echo';
-import { type FunctionDefinition } from '@dxos/functions';
+import { Obj, Type } from '@dxos/echo';
+import { type Operation } from '@dxos/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<Schema.Struct<{
-    /**
-     * Global registry ID.
-     * NOTE: The `key` property refers to the original registry entry.
-     */
-    key: Schema.SchemaClass<string, string, never>;
-    /**
-     * Human-readable name of the blueprint.
-     */
-    name: Schema.SchemaClass<string, string, never>;
-    /**
-     * Description of the blueprint's purpose and functionality.
-     */
-    description: Schema.optional<typeof Schema.String>;
-    /**
-     * Instructions that guide the AI assistant's behavior and responses.
-     * These are system prompts or guidelines that the AI should follow.
-     */
-    instructions: Schema.mutable<Schema.Struct<{
-        source: Schema.SchemaClass<import("@dxos/echo/internal").Ref<Type.OfKind<import("@dxos/echo/internal").EntityKind.Object> & {
-            content: string;
-        }>, import("@dxos/echo-protocol").EncodedReference, never>;
-        inputs: Schema.optional<Schema.mutable<Schema.Array$<Schema.mutable<Schema.Struct<{
-            name: typeof Schema.String;
-            kind: Schema.optional<Schema.Literal<["value", "pass-through", "retriever", "function", "query", "resolver", "context", "schema"]>>;
-            default: Schema.optional<typeof Schema.Any>;
-        }>>>>>;
-    }>>;
-    /**
-     * Array of tools that the AI assistant can use when this blueprint is active.
-     */
-    tools: Schema.Array$<Schema.brand<typeof Schema.String, "ToolId">>;
-}>>;
+export declare const Blueprint: Type.Obj<{
+    readonly name: string;
+    readonly description?: string | undefined;
+    readonly key: string;
+    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 function?: string | undefined;
+            readonly name: string;
+            readonly kind?: "function" | "value" | "pass-through" | "retriever" | "query" | "resolver" | "context" | "schema" | undefined;
+            readonly default?: any;
+        }[] | undefined;
+    };
+    readonly tools: readonly (string & import("effect/Brand").Brand<"ToolId">)[];
+    readonly agentCanEnable?: boolean | undefined;
+    readonly mcpServers?: readonly {
+        readonly url: string;
+        readonly protocol: "sse" | "http";
+    }[] | 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 }: Pick<Blueprint, "key" | "name"> & Partial<Blueprint>) => import("@dxos/live-object").Live<Type.OfKind<import("@dxos/echo/internal").EntityKind.Object> & {
-    key: string;
-    name: string;
-    description?: string | undefined;
-    instructions: {
-        source: import("@dxos/echo/internal").Ref<Type.OfKind<import("@dxos/echo/internal").EntityKind.Object> & {
-            content: string;
+export declare const make: ({ 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 key: string;
+    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;
         }>;
-        inputs?: {
-            name: string;
-            kind?: "function" | "value" | "pass-through" | "retriever" | "query" | "resolver" | "context" | "schema" | undefined;
-            default?: any;
+        readonly inputs?: readonly {
+            readonly function?: string | undefined;
+            readonly name: string;
+            readonly kind?: "function" | "value" | "pass-through" | "retriever" | "query" | "resolver" | "context" | "schema" | undefined;
+            readonly default?: any;
         }[] | undefined;
     };
-    tools: (string & import("effect/Brand").Brand<"ToolId">)[];
+    readonly tools: readonly (string & import("effect/Brand").Brand<"ToolId">)[];
+    readonly agentCanEnable?: boolean | undefined;
+    readonly mcpServers?: readonly {
+        readonly url: string;
+        readonly protocol: "sse" | "http";
+    }[] | undefined;
 }>;
 /**
  * Util to create tool definitions for a blueprint.
  */
-export declare const toolDefinitions: ({ tools, functions, }: {
+export declare const toolDefinitions: ({ tools, operations, }: {
     tools?: string[];
-    functions?: FunctionDefinition[];
+    operations?: Operation.Definition.Any[];
 }) => (string & import("effect/Brand").Brand<"ToolId">)[];
+export {};
 //# sourceMappingURL=blueprint.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"blueprint.d.ts","sourceRoot":"","sources":["../../../../src/blueprint/blueprint.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AAGxC,OAAO,EAAO,IAAI,EAAE,MAAM,YAAY,CAAC;AAEvC,OAAO,EAAE,KAAK,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AAI1D;;;;GAIG;AACH,eAAO,MAAM,SAAS;IACpB;;;OAGG;;IAMH;;OAEG;;IAKH;;OAEG;;IAKH;;;OAGG;;;;;;;;;;;IAKH;;OAEG;;GAaJ,CAAC;AAEF;;GAEG;AACH,MAAM,WAAW,SAAU,SAAQ,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,SAAS,CAAC;CAAG;AAE1E;;GAEG;AACH,eAAO,MAAM,IAAI,GAAI,mCAIlB,IAAI,CAAC,SAAS,EAAE,KAAK,GAAG,MAAM,CAAC,GAAG,OAAO,CAAC,SAAS,CAAC;;;;;;;;;;;;;;;EAA2D,CAAC;AAEnH;;GAEG;AACH,eAAO,MAAM,eAAe,GAAI,uBAG7B;IACD,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB,SAAS,CAAC,EAAE,kBAAkB,EAAE,CAAC;CAClC,wDAA+F,CAAC"}
+{"version":3,"file":"blueprint.d.ts","sourceRoot":"","sources":["../../../../src/blueprint/blueprint.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AAGxC,OAAO,EAAc,GAAG,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AACnD,OAAO,EAAE,KAAK,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAIjD;;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,GAAI,mCAA0D,SAAS;;;;;;;;;;;;;;;;;;;;;;EAKpF,CAAC;AAEL;;GAEG;AACH,eAAO,MAAM,eAAe,GAAI,wBAG7B;IACD,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB,UAAU,CAAC,EAAE,SAAS,CAAC,UAAU,CAAC,GAAG,EAAE,CAAC;CACzC,wDAAqG,CAAC"}

package/dist/types/src/blueprint/registry.d.ts

@@ -1,11 +1,61 @@
-import { type Blueprint } from './blueprint';
+import * as Context from 'effect/Context';
+import * as Effect from 'effect/Effect';
+import { Database } from '@dxos/echo';
+import { BaseError } from '@dxos/errors';
+import { Blueprint } from './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): {
+        name: "BlueprintNotFound";
+        context: Record<string, unknown>;
+        readonly message: string;
+        readonly _tag: "BlueprintNotFound";
+        stack?: string;
+        cause?: unknown;
+    };
+    name: "BlueprintNotFound";
+    is(error: unknown): error is BaseError;
+    wrap(options?: Omit<import("@dxos/errors").BaseErrorOptions, "cause"> & {
+        ifTypeDiffers?: boolean;
+    }): (error: unknown) => {
+        name: "BlueprintNotFound";
+        context: Record<string, unknown>;
+        readonly message: string;
+        readonly _tag: "BlueprintNotFound";
+        stack?: string;
+        cause?: unknown;
+    };
+    extend<Name extends string = string>(name: Name, message?: string): any;
+    isError(error: unknown): error is Error;
+    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=registry.d.ts.map

package/dist/types/src/blueprint/registry.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../../../src/blueprint/registry.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,KAAK,SAAS,EAAE,MAAM,aAAa,CAAC;AAE7C;;GAEG;AACH,qBAAa,QAAQ;IACnB,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAmB;gBAEnC,UAAU,EAAE,SAAS,EAAE;IAcnC,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,GAAG,SAAS;IAI5C,KAAK,IAAI,SAAS,EAAE;CAGrB"}
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../../../src/blueprint/registry.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,OAAO,MAAM,gBAAgB,CAAC;AAC1C,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AAExC,OAAO,EAAE,QAAQ,EAAe,MAAM,YAAY,CAAC;AACnD,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAGzC,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAExC;;GAEG;AACH,qBAAa,QAAQ;IACnB,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAmB;gBAEnC,UAAU,EAAE,SAAS,EAAE;IAcnC,IAAI,UAAU,IAAI,SAAS,EAAE,CAE5B;IAED,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,GAAG,SAAS;IAI5C,KAAK,IAAI,SAAS,EAAE;IAIpB,gBAAgB,IAAI,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,KAAK,EAAE,QAAQ,CAAC,OAAO,CAAC;CAejE;;AAED,qBAAa,eAAgB,SAAQ,oBAA4E;CAAG;AAEpH;;;GAGG;AACH,eAAO,MAAM,OAAO,GAAI,KAAK,MAAM,KAAG,MAAM,CAAC,MAAM,CAAC,SAAS,EAAE,aAAa,EAAE,eAAe,CAQzF,CAAC;AAEL;;;;GAIG;AACH,eAAO,MAAM,MAAM,GAAI,KAAK,MAAM,KAAG,MAAM,CAAC,MAAM,CAAC,SAAS,EAAE,aAAa,EAAE,eAAe,GAAG,QAAQ,CAAC,OAAO,CAO3G,CAAC;;;;;;;;;;;;;qBA7C8D,CAAC;;;;;;;;;;;;;;;AA+CpE,qBAAa,aAAc,SAAQ,kBAA4D;CAAG"}