@dxos/blueprints 0.8.4-main.1da679c

package/LICENSE

@@ -0,0 +1,8 @@
+MIT License 
+Copyright (c) 2022 DXOS
+
+Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

package/README.md

@@ -0,0 +1,3 @@
+# @dxos/blueprints
+
+Low-level definitions for Blueprints, Templates, and related utilities.

package/dist/lib/browser/index.mjs

@@ -0,0 +1,235 @@
+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,
+  Registry: () => Registry,
+  make: () => make2,
+  toolDefinitions: () => toolDefinitions
+});
+
+// src/blueprint/blueprint.ts
+import { Schema as Schema2 } from "effect";
+import { ToolId } from "@dxos/ai";
+import { Obj, Type as Type2 } from "@dxos/echo";
+import { LabelAnnotation } from "@dxos/echo-schema";
+
+// src/template/index.ts
+var template_exports = {};
+__export(template_exports, {
+  Input: () => Input,
+  InputKind: () => InputKind,
+  Template: () => Template,
+  make: () => make,
+  process: () => process
+});
+
+// src/template/prompt.ts
+import handlebars from "handlebars";
+import { invariant } from "@dxos/invariant";
+var __dxlog_file = "/__w/dxos/dxos/packages/core/blueprints/src/template/prompt.ts";
+var process = (source, variables = {}) => {
+  invariant(source, void 0, {
+    F: __dxlog_file,
+    L: 13,
+    S: void 0,
+    A: [
+      "source",
+      ""
+    ]
+  });
+  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");
+};
+
+// src/template/template.ts
+import { Schema } from "effect";
+import { Ref, Type } from "@dxos/echo";
+import { DataType } from "@dxos/schema";
+var InputKind = Schema.Literal("value", "pass-through", "retriever", "function", "query", "resolver", "context", "schema");
+var Input = Schema.mutable(Schema.Struct({
+  name: Schema.String,
+  kind: Schema.optional(InputKind),
+  default: Schema.optional(Schema.Any)
+}));
+var Template = Schema.Struct({
+  source: Type.Ref(DataType.Text).annotations({
+    description: "Handlebars template source"
+  }),
+  inputs: Schema.optional(Schema.mutable(Schema.Array(Input)))
+}).pipe(Schema.mutable);
+var make = ({ source, inputs = [], id }) => ({
+  source: Ref.make(DataType.makeText(source, id)),
+  inputs
+});
+
+// src/blueprint/blueprint.ts
+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"
+  })
+}).pipe(
+  Type2.Obj({
+    // TODO(burdon): Is this a DXN? Need to create a Format type for these IDs.
+    typename: "dxos.org/type/Blueprint",
+    version: "0.1.0"
+  }),
+  // TODO(burdon): Move to Type.Obj def?
+  LabelAnnotation.set([
+    "name"
+  ])
+);
+var make2 = ({ tools = [], ...props }) => Obj.make(Blueprint, {
+  tools,
+  ...props
+});
+var toolDefinitions = ({ tools = [], functions = [] }) => [
+  ...functions.map((fn) => ToolId.make(fn.name)),
+  ...tools.map((tool) => ToolId.make(tool))
+];
+
+// src/blueprint/registry.ts
+import { log } from "@dxos/log";
+function _define_property(obj, key, value) {
+  if (key in obj) {
+    Object.defineProperty(obj, key, {
+      value,
+      enumerable: true,
+      configurable: true,
+      writable: true
+    });
+  } else {
+    obj[key] = value;
+  }
+  return obj;
+}
+var __dxlog_file2 = "/__w/dxos/dxos/packages/core/blueprints/src/blueprint/registry.ts";
+var Registry = class {
+  getByKey(key) {
+    return this._blueprints.find((blueprint) => blueprint.key === key);
+  }
+  query() {
+    return this._blueprints;
+  }
+  constructor(blueprints) {
+    _define_property(this, "_blueprints", []);
+    const seen = /* @__PURE__ */ new Set();
+    blueprints.forEach((blueprint) => {
+      if (seen.has(blueprint.key)) {
+        log.warn("duplicate blueprint", {
+          key: blueprint.key
+        }, {
+          F: __dxlog_file2,
+          L: 19,
+          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));
+  }
+};
+
+// src/prompt/index.ts
+var prompt_exports = {};
+__export(prompt_exports, {
+  Prompt: () => Prompt,
+  make: () => make3
+});
+
+// src/prompt/prompt.ts
+import { Schema as Schema3 } from "effect";
+import { Obj as Obj2, Type as Type3 } from "@dxos/echo";
+import { JsonSchemaType, toJsonSchema } from "@dxos/echo-schema";
+var Prompt_ = Schema3.Struct({
+  /**
+  * Name of the prompt.
+  */
+  name: 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: JsonSchemaType,
+  /**
+  * Output schema of the prompt.
+  */
+  output: JsonSchemaType,
+  /**
+  * Natural language instructions for the prompt.
+  * These should provide concrete course of action for the AI to follow.
+  */
+  instructions: Schema3.String,
+  /**
+  * Blueprints that the prompt may utilize.
+  */
+  blueprints: Schema3.Array(Type3.Ref(Blueprint)),
+  /**
+  * Additional context that the prompt may utilize.
+  */
+  context: Schema3.Array(Schema3.Any)
+}).pipe(Type3.Obj({
+  typename: "dxos.org/type/Prompt",
+  version: "0.1.0"
+}));
+var Prompt = Prompt_;
+var make3 = (opts) => Obj2.make(Prompt, {
+  name: opts.name,
+  description: opts.description,
+  input: toJsonSchema(opts.input),
+  output: toJsonSchema(opts.output),
+  instructions: opts.instructions,
+  blueprints: opts.blueprints ?? [],
+  context: opts.context ?? []
+});
+export {
+  blueprint_exports as Blueprint,
+  prompt_exports as Prompt,
+  template_exports as Template
+};
+//# sourceMappingURL=index.mjs.map

package/dist/lib/browser/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 { Schema } from 'effect';\n\nimport { ToolId } from '@dxos/ai';\nimport { Obj, Type } from '@dxos/echo';\nimport { LabelAnnotation } from '@dxos/echo-schema';\nimport { type FunctionDefinition } from '@dxos/functions';\n\nimport { Template } from '../template';\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.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}).pipe(\n  Type.Obj({\n    // TODO(burdon): Is this a DXN? Need to create a Format type for these IDs.\n    typename: 'dxos.org/type/Blueprint',\n    version: '0.1.0',\n  }),\n\n  // TODO(burdon): Move to Type.Obj def?\n  LabelAnnotation.set(['name']),\n);\n\n/**\n * TypeScript type for Blueprint.\n */\nexport interface Blueprint extends Schema.Schema.Type<typeof Blueprint> {}\n\n/**\n * Create a new Blueprint.\n */\nexport const make = ({ tools = [], ...props }: Pick<Blueprint, 'key' | 'name' | 'instructions'> & Partial<Blueprint>) =>\n  Obj.make(Blueprint, { tools, ...props });\n\n/**\n * Util to create tool definitions for a blueprint.\n */\nexport const toolDefinitions = ({\n  tools = [],\n  functions = [],\n}: {\n  tools?: string[];\n  functions?: FunctionDefinition[];\n}) => [...functions.map((fn) => ToolId.make(fn.name)), ...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 handlebars from 'handlebars';\n\nimport { invariant } from '@dxos/invariant';\n\n/**\n * Process Handlebars template.\n */\nexport const process = <Options extends {}>(source: string, variables: Partial<Options> = {}): string => {\n  invariant(source);\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", "//\n// Copyright 2024 DXOS.org\n//\n\nimport { Schema } from 'effect';\n\nimport { Ref, Type } from '@dxos/echo';\nimport { type ObjectId } from '@dxos/keys';\nimport { DataType } 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.mutable(\n  Schema.Struct({\n    name: Schema.String,\n    kind: Schema.optional(InputKind),\n    default: Schema.optional(Schema.Any),\n  }),\n);\n\nexport type Input = Schema.Schema.Type<typeof Input>;\n\n/**\n * Template type.\n */\nexport const Template = Schema.Struct({\n  source: Type.Ref(DataType.Text).annotations({ description: 'Handlebars template source' }),\n  inputs: Schema.optional(Schema.mutable(Schema.Array(Input))),\n}).pipe(Schema.mutable);\n\nexport interface Template extends Schema.Schema.Type<typeof Template> {}\n\nexport const make = ({ source, inputs = [], id }: { source: string; inputs?: Input[]; id?: ObjectId }): Template => ({\n  source: Ref.make(DataType.makeText(source, id)),\n  inputs,\n});\n", "//\n// Copyright 2025 DXOS.org\n//\n\nimport { log } from '@dxos/log';\n\nimport { type 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  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", "//\n// Copyright 2025 DXOS.org\n//\n\nexport * from './prompt';\n", "//\n// Copyright 2025 DXOS.org\n//\n\nimport { Schema } from 'effect';\n\nimport { Obj, type Ref, Type } from '@dxos/echo';\nimport { JsonSchemaType, toJsonSchema } from '@dxos/echo-schema';\n\nimport { Blueprint } from '../blueprint';\n\n/**\n * Executable instructions.\n * Declare input and output schema.\n * May utilize blueprints.\n * May reference additional context.\n */\nconst Prompt_ = Schema.Struct({\n  /**\n   * Name of the prompt.\n   */\n  name: 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: JsonSchemaType,\n\n  /**\n   * Output schema of the prompt.\n   */\n  output: JsonSchemaType,\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: Schema.String,\n\n  /**\n   * Blueprints that the prompt may utilize.\n   */\n  blueprints: Schema.Array(Type.Ref(Blueprint)),\n\n  /**\n   * Additional context that the prompt may utilize.\n   */\n  context: Schema.Array(Schema.Any),\n}).pipe(\n  Type.Obj({\n    typename: 'dxos.org/type/Prompt',\n    version: '0.1.0',\n  }),\n);\nexport interface Prompt extends Schema.Schema.Type<typeof Prompt_> {}\nexport interface Prompt_Encoded extends Schema.Schema.Encoded<typeof Prompt_> {}\nexport const Prompt: Schema.Schema<Prompt, Prompt_Encoded> = Prompt_;\n\nexport const make = (opts: {\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: opts.name,\n    description: opts.description,\n    input: toJsonSchema(opts.input),\n    output: toJsonSchema(opts.output),\n    instructions: opts.instructions,\n    blueprints: opts.blueprints ?? [],\n    context: opts.context ?? [],\n  });\n"],
+  "mappings": "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",
+  "names": ["make", "Schema", "ToolId", "Obj", "Type", "LabelAnnotation", "handlebars", "invariant", "process", "source", "variables", "section", "registerHelper", "String", "template", "compile", "trim", "output", "replace", "Schema", "Ref", "Type", "DataType", "InputKind", "Schema", "Literal", "Input", "mutable", "Struct", "name", "String", "kind", "optional", "default", "Any", "Template", "source", "Type", "Ref", "DataType", "Text", "annotations", "description", "inputs", "Array", "pipe", "make", "id", "makeText", "Blueprint", "Schema", "Struct", "key", "String", "annotations", "description", "name", "optional", "instructions", "Template", "tools", "Array", "ToolId", "pipe", "Type", "Obj", "typename", "version", "LabelAnnotation", "set", "make", "props", "toolDefinitions", "functions", "map", "fn", "tool", "log", "Registry", "getByKey", "key", "_blueprints", "find", "blueprint", "query", "blueprints", "seen", "Set", "forEach", "has", "warn", "add", "push", "sort", "name", "a", "b", "localeCompare", "make", "Schema", "Obj", "Type", "JsonSchemaType", "toJsonSchema", "Prompt_", "Schema", "Struct", "name", "String", "description", "optional", "input", "JsonSchemaType", "output", "instructions", "blueprints", "Array", "Type", "Ref", "Blueprint", "context", "Any", "pipe", "Obj", "typename", "version", "Prompt", "make", "opts", "toJsonSchema"]
+}

package/dist/lib/browser/meta.json

@@ -0,0 +1 @@
+{"inputs":{"src/template/prompt.ts":{"bytes":2238,"imports":[{"path":"handlebars","kind":"import-statement","external":true},{"path":"@dxos/invariant","kind":"import-statement","external":true}],"format":"esm"},"src/template/template.ts":{"bytes":4373,"imports":[{"path":"effect","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":8075,"imports":[{"path":"effect","kind":"import-statement","external":true},{"path":"@dxos/ai","kind":"import-statement","external":true},{"path":"@dxos/echo","kind":"import-statement","external":true},{"path":"@dxos/echo-schema","kind":"import-statement","external":true},{"path":"src/template/index.ts","kind":"import-statement","original":"../template"}],"format":"esm"},"src/blueprint/registry.ts":{"bytes":3784,"imports":[{"path":"@dxos/log","kind":"import-statement","external":true}],"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":6070,"imports":[{"path":"effect","kind":"import-statement","external":true},{"path":"@dxos/echo","kind":"import-statement","external":true},{"path":"@dxos/echo-schema","kind":"import-statement","external":true},{"path":"src/blueprint/index.ts","kind":"import-statement","original":"../blueprint"}],"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/browser/index.mjs.map":{"imports":[],"exports":[],"inputs":{},"bytes":12564},"dist/lib/browser/index.mjs":{"imports":[{"path":"effect","kind":"import-statement","external":true},{"path":"@dxos/ai","kind":"import-statement","external":true},{"path":"@dxos/echo","kind":"import-statement","external":true},{"path":"@dxos/echo-schema","kind":"import-statement","external":true},{"path":"handlebars","kind":"import-statement","external":true},{"path":"@dxos/invariant","kind":"import-statement","external":true},{"path":"effect","kind":"import-statement","external":true},{"path":"@dxos/echo","kind":"import-statement","external":true},{"path":"@dxos/schema","kind":"import-statement","external":true},{"path":"@dxos/log","kind":"import-statement","external":true},{"path":"effect","kind":"import-statement","external":true},{"path":"@dxos/echo","kind":"import-statement","external":true},{"path":"@dxos/echo-schema","kind":"import-statement","external":true}],"exports":["Blueprint","Prompt","Template"],"entryPoint":"src/index.ts","inputs":{"src/blueprint/index.ts":{"bytesInOutput":182},"src/blueprint/blueprint.ts":{"bytesInOutput":1892},"src/template/index.ts":{"bytesInOutput":185},"src/template/prompt.ts":{"bytesInOutput":569},"src/template/template.ts":{"bytesInOutput":714},"src/blueprint/registry.ts":{"bytesInOutput":1109},"src/index.ts":{"bytesInOutput":0},"src/prompt/index.ts":{"bytesInOutput":100},"src/prompt/prompt.ts":{"bytesInOutput":1325}},"bytes":6633}}}

package/dist/lib/node-esm/index.mjs

@@ -0,0 +1,236 @@
+import { createRequire } from 'node:module';const require = createRequire(import.meta.url);
+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,
+  Registry: () => Registry,
+  make: () => make2,
+  toolDefinitions: () => toolDefinitions
+});
+
+// src/blueprint/blueprint.ts
+import { Schema as Schema2 } from "effect";
+import { ToolId } from "@dxos/ai";
+import { Obj, Type as Type2 } from "@dxos/echo";
+import { LabelAnnotation } from "@dxos/echo-schema";
+
+// src/template/index.ts
+var template_exports = {};
+__export(template_exports, {
+  Input: () => Input,
+  InputKind: () => InputKind,
+  Template: () => Template,
+  make: () => make,
+  process: () => process
+});
+
+// src/template/prompt.ts
+import handlebars from "handlebars";
+import { invariant } from "@dxos/invariant";
+var __dxlog_file = "/__w/dxos/dxos/packages/core/blueprints/src/template/prompt.ts";
+var process = (source, variables = {}) => {
+  invariant(source, void 0, {
+    F: __dxlog_file,
+    L: 13,
+    S: void 0,
+    A: [
+      "source",
+      ""
+    ]
+  });
+  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");
+};
+
+// src/template/template.ts
+import { Schema } from "effect";
+import { Ref, Type } from "@dxos/echo";
+import { DataType } from "@dxos/schema";
+var InputKind = Schema.Literal("value", "pass-through", "retriever", "function", "query", "resolver", "context", "schema");
+var Input = Schema.mutable(Schema.Struct({
+  name: Schema.String,
+  kind: Schema.optional(InputKind),
+  default: Schema.optional(Schema.Any)
+}));
+var Template = Schema.Struct({
+  source: Type.Ref(DataType.Text).annotations({
+    description: "Handlebars template source"
+  }),
+  inputs: Schema.optional(Schema.mutable(Schema.Array(Input)))
+}).pipe(Schema.mutable);
+var make = ({ source, inputs = [], id }) => ({
+  source: Ref.make(DataType.makeText(source, id)),
+  inputs
+});
+
+// src/blueprint/blueprint.ts
+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"
+  })
+}).pipe(
+  Type2.Obj({
+    // TODO(burdon): Is this a DXN? Need to create a Format type for these IDs.
+    typename: "dxos.org/type/Blueprint",
+    version: "0.1.0"
+  }),
+  // TODO(burdon): Move to Type.Obj def?
+  LabelAnnotation.set([
+    "name"
+  ])
+);
+var make2 = ({ tools = [], ...props }) => Obj.make(Blueprint, {
+  tools,
+  ...props
+});
+var toolDefinitions = ({ tools = [], functions = [] }) => [
+  ...functions.map((fn) => ToolId.make(fn.name)),
+  ...tools.map((tool) => ToolId.make(tool))
+];
+
+// src/blueprint/registry.ts
+import { log } from "@dxos/log";
+function _define_property(obj, key, value) {
+  if (key in obj) {
+    Object.defineProperty(obj, key, {
+      value,
+      enumerable: true,
+      configurable: true,
+      writable: true
+    });
+  } else {
+    obj[key] = value;
+  }
+  return obj;
+}
+var __dxlog_file2 = "/__w/dxos/dxos/packages/core/blueprints/src/blueprint/registry.ts";
+var Registry = class {
+  getByKey(key) {
+    return this._blueprints.find((blueprint) => blueprint.key === key);
+  }
+  query() {
+    return this._blueprints;
+  }
+  constructor(blueprints) {
+    _define_property(this, "_blueprints", []);
+    const seen = /* @__PURE__ */ new Set();
+    blueprints.forEach((blueprint) => {
+      if (seen.has(blueprint.key)) {
+        log.warn("duplicate blueprint", {
+          key: blueprint.key
+        }, {
+          F: __dxlog_file2,
+          L: 19,
+          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));
+  }
+};
+
+// src/prompt/index.ts
+var prompt_exports = {};
+__export(prompt_exports, {
+  Prompt: () => Prompt,
+  make: () => make3
+});
+
+// src/prompt/prompt.ts
+import { Schema as Schema3 } from "effect";
+import { Obj as Obj2, Type as Type3 } from "@dxos/echo";
+import { JsonSchemaType, toJsonSchema } from "@dxos/echo-schema";
+var Prompt_ = Schema3.Struct({
+  /**
+  * Name of the prompt.
+  */
+  name: 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: JsonSchemaType,
+  /**
+  * Output schema of the prompt.
+  */
+  output: JsonSchemaType,
+  /**
+  * Natural language instructions for the prompt.
+  * These should provide concrete course of action for the AI to follow.
+  */
+  instructions: Schema3.String,
+  /**
+  * Blueprints that the prompt may utilize.
+  */
+  blueprints: Schema3.Array(Type3.Ref(Blueprint)),
+  /**
+  * Additional context that the prompt may utilize.
+  */
+  context: Schema3.Array(Schema3.Any)
+}).pipe(Type3.Obj({
+  typename: "dxos.org/type/Prompt",
+  version: "0.1.0"
+}));
+var Prompt = Prompt_;
+var make3 = (opts) => Obj2.make(Prompt, {
+  name: opts.name,
+  description: opts.description,
+  input: toJsonSchema(opts.input),
+  output: toJsonSchema(opts.output),
+  instructions: opts.instructions,
+  blueprints: opts.blueprints ?? [],
+  context: opts.context ?? []
+});
+export {
+  blueprint_exports as Blueprint,
+  prompt_exports as Prompt,
+  template_exports as Template
+};
+//# sourceMappingURL=index.mjs.map

package/dist/lib/node-esm/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 { Schema } from 'effect';\n\nimport { ToolId } from '@dxos/ai';\nimport { Obj, Type } from '@dxos/echo';\nimport { LabelAnnotation } from '@dxos/echo-schema';\nimport { type FunctionDefinition } from '@dxos/functions';\n\nimport { Template } from '../template';\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.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}).pipe(\n  Type.Obj({\n    // TODO(burdon): Is this a DXN? Need to create a Format type for these IDs.\n    typename: 'dxos.org/type/Blueprint',\n    version: '0.1.0',\n  }),\n\n  // TODO(burdon): Move to Type.Obj def?\n  LabelAnnotation.set(['name']),\n);\n\n/**\n * TypeScript type for Blueprint.\n */\nexport interface Blueprint extends Schema.Schema.Type<typeof Blueprint> {}\n\n/**\n * Create a new Blueprint.\n */\nexport const make = ({ tools = [], ...props }: Pick<Blueprint, 'key' | 'name' | 'instructions'> & Partial<Blueprint>) =>\n  Obj.make(Blueprint, { tools, ...props });\n\n/**\n * Util to create tool definitions for a blueprint.\n */\nexport const toolDefinitions = ({\n  tools = [],\n  functions = [],\n}: {\n  tools?: string[];\n  functions?: FunctionDefinition[];\n}) => [...functions.map((fn) => ToolId.make(fn.name)), ...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 handlebars from 'handlebars';\n\nimport { invariant } from '@dxos/invariant';\n\n/**\n * Process Handlebars template.\n */\nexport const process = <Options extends {}>(source: string, variables: Partial<Options> = {}): string => {\n  invariant(source);\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", "//\n// Copyright 2024 DXOS.org\n//\n\nimport { Schema } from 'effect';\n\nimport { Ref, Type } from '@dxos/echo';\nimport { type ObjectId } from '@dxos/keys';\nimport { DataType } 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.mutable(\n  Schema.Struct({\n    name: Schema.String,\n    kind: Schema.optional(InputKind),\n    default: Schema.optional(Schema.Any),\n  }),\n);\n\nexport type Input = Schema.Schema.Type<typeof Input>;\n\n/**\n * Template type.\n */\nexport const Template = Schema.Struct({\n  source: Type.Ref(DataType.Text).annotations({ description: 'Handlebars template source' }),\n  inputs: Schema.optional(Schema.mutable(Schema.Array(Input))),\n}).pipe(Schema.mutable);\n\nexport interface Template extends Schema.Schema.Type<typeof Template> {}\n\nexport const make = ({ source, inputs = [], id }: { source: string; inputs?: Input[]; id?: ObjectId }): Template => ({\n  source: Ref.make(DataType.makeText(source, id)),\n  inputs,\n});\n", "//\n// Copyright 2025 DXOS.org\n//\n\nimport { log } from '@dxos/log';\n\nimport { type 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  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", "//\n// Copyright 2025 DXOS.org\n//\n\nexport * from './prompt';\n", "//\n// Copyright 2025 DXOS.org\n//\n\nimport { Schema } from 'effect';\n\nimport { Obj, type Ref, Type } from '@dxos/echo';\nimport { JsonSchemaType, toJsonSchema } from '@dxos/echo-schema';\n\nimport { Blueprint } from '../blueprint';\n\n/**\n * Executable instructions.\n * Declare input and output schema.\n * May utilize blueprints.\n * May reference additional context.\n */\nconst Prompt_ = Schema.Struct({\n  /**\n   * Name of the prompt.\n   */\n  name: 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: JsonSchemaType,\n\n  /**\n   * Output schema of the prompt.\n   */\n  output: JsonSchemaType,\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: Schema.String,\n\n  /**\n   * Blueprints that the prompt may utilize.\n   */\n  blueprints: Schema.Array(Type.Ref(Blueprint)),\n\n  /**\n   * Additional context that the prompt may utilize.\n   */\n  context: Schema.Array(Schema.Any),\n}).pipe(\n  Type.Obj({\n    typename: 'dxos.org/type/Prompt',\n    version: '0.1.0',\n  }),\n);\nexport interface Prompt extends Schema.Schema.Type<typeof Prompt_> {}\nexport interface Prompt_Encoded extends Schema.Schema.Encoded<typeof Prompt_> {}\nexport const Prompt: Schema.Schema<Prompt, Prompt_Encoded> = Prompt_;\n\nexport const make = (opts: {\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: opts.name,\n    description: opts.description,\n    input: toJsonSchema(opts.input),\n    output: toJsonSchema(opts.output),\n    instructions: opts.instructions,\n    blueprints: opts.blueprints ?? [],\n    context: opts.context ?? [],\n  });\n"],
+  "mappings": "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",
+  "names": ["make", "Schema", "ToolId", "Obj", "Type", "LabelAnnotation", "handlebars", "invariant", "process", "source", "variables", "section", "registerHelper", "String", "template", "compile", "trim", "output", "replace", "Schema", "Ref", "Type", "DataType", "InputKind", "Schema", "Literal", "Input", "mutable", "Struct", "name", "String", "kind", "optional", "default", "Any", "Template", "source", "Type", "Ref", "DataType", "Text", "annotations", "description", "inputs", "Array", "pipe", "make", "id", "makeText", "Blueprint", "Schema", "Struct", "key", "String", "annotations", "description", "name", "optional", "instructions", "Template", "tools", "Array", "ToolId", "pipe", "Type", "Obj", "typename", "version", "LabelAnnotation", "set", "make", "props", "toolDefinitions", "functions", "map", "fn", "tool", "log", "Registry", "getByKey", "key", "_blueprints", "find", "blueprint", "query", "blueprints", "seen", "Set", "forEach", "has", "warn", "add", "push", "sort", "name", "a", "b", "localeCompare", "make", "Schema", "Obj", "Type", "JsonSchemaType", "toJsonSchema", "Prompt_", "Schema", "Struct", "name", "String", "description", "optional", "input", "JsonSchemaType", "output", "instructions", "blueprints", "Array", "Type", "Ref", "Blueprint", "context", "Any", "pipe", "Obj", "typename", "version", "Prompt", "make", "opts", "toJsonSchema"]
+}

package/dist/lib/node-esm/meta.json

@@ -0,0 +1 @@
+{"inputs":{"src/template/prompt.ts":{"bytes":2238,"imports":[{"path":"handlebars","kind":"import-statement","external":true},{"path":"@dxos/invariant","kind":"import-statement","external":true}],"format":"esm"},"src/template/template.ts":{"bytes":4373,"imports":[{"path":"effect","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":8075,"imports":[{"path":"effect","kind":"import-statement","external":true},{"path":"@dxos/ai","kind":"import-statement","external":true},{"path":"@dxos/echo","kind":"import-statement","external":true},{"path":"@dxos/echo-schema","kind":"import-statement","external":true},{"path":"src/template/index.ts","kind":"import-statement","original":"../template"}],"format":"esm"},"src/blueprint/registry.ts":{"bytes":3784,"imports":[{"path":"@dxos/log","kind":"import-statement","external":true}],"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":6070,"imports":[{"path":"effect","kind":"import-statement","external":true},{"path":"@dxos/echo","kind":"import-statement","external":true},{"path":"@dxos/echo-schema","kind":"import-statement","external":true},{"path":"src/blueprint/index.ts","kind":"import-statement","original":"../blueprint"}],"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/node-esm/index.mjs.map":{"imports":[],"exports":[],"inputs":{},"bytes":12565},"dist/lib/node-esm/index.mjs":{"imports":[{"path":"effect","kind":"import-statement","external":true},{"path":"@dxos/ai","kind":"import-statement","external":true},{"path":"@dxos/echo","kind":"import-statement","external":true},{"path":"@dxos/echo-schema","kind":"import-statement","external":true},{"path":"handlebars","kind":"import-statement","external":true},{"path":"@dxos/invariant","kind":"import-statement","external":true},{"path":"effect","kind":"import-statement","external":true},{"path":"@dxos/echo","kind":"import-statement","external":true},{"path":"@dxos/schema","kind":"import-statement","external":true},{"path":"@dxos/log","kind":"import-statement","external":true},{"path":"effect","kind":"import-statement","external":true},{"path":"@dxos/echo","kind":"import-statement","external":true},{"path":"@dxos/echo-schema","kind":"import-statement","external":true}],"exports":["Blueprint","Prompt","Template"],"entryPoint":"src/index.ts","inputs":{"src/blueprint/index.ts":{"bytesInOutput":182},"src/blueprint/blueprint.ts":{"bytesInOutput":1892},"src/template/index.ts":{"bytesInOutput":185},"src/template/prompt.ts":{"bytesInOutput":569},"src/template/template.ts":{"bytesInOutput":714},"src/blueprint/registry.ts":{"bytesInOutput":1109},"src/index.ts":{"bytesInOutput":0},"src/prompt/index.ts":{"bytesInOutput":100},"src/prompt/prompt.ts":{"bytesInOutput":1325}},"bytes":6725}}}

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

@@ -0,0 +1,73 @@
+import { Schema } from 'effect';
+import { Type } from '@dxos/echo';
+import { type FunctionDefinition } from '@dxos/functions';
+/**
+ * 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-schema").Ref<Type.OfKind<import("@dxos/echo-schema").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">>;
+}>>;
+/**
+ * TypeScript type for Blueprint.
+ */
+export interface Blueprint extends Schema.Schema.Type<typeof Blueprint> {
+}
+/**
+ * Create a new Blueprint.
+ */
+export declare const make: ({ tools, ...props }: Pick<Blueprint, "key" | "name" | "instructions"> & Partial<Blueprint>) => import("@dxos/live-object").Live<Type.OfKind<import("@dxos/echo-schema").EntityKind.Object> & {
+    key: string;
+    name: string;
+    description?: string | undefined;
+    instructions: {
+        source: import("@dxos/echo-schema").Ref<Type.OfKind<import("@dxos/echo-schema").EntityKind.Object> & {
+            content: string;
+        }>;
+        inputs?: {
+            name: string;
+            kind?: "function" | "value" | "pass-through" | "retriever" | "query" | "resolver" | "context" | "schema" | undefined;
+            default?: any;
+        }[] | undefined;
+    };
+    tools: (string & import("effect/Brand").Brand<"ToolId">)[];
+}>;
+/**
+ * Util to create tool definitions for a blueprint.
+ */
+export declare const toolDefinitions: ({ tools, functions, }: {
+    tools?: string[];
+    functions?: FunctionDefinition[];
+}) => (string & import("effect/Brand").Brand<"ToolId">)[];
+//# sourceMappingURL=blueprint.d.ts.map