@dxos/blueprints 0.8.4-main.f5c0578 → 0.8.4-main.fcc0d83b33

package/dist/lib/neutral/index.mjs

@@ -0,0 +1,322 @@
+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 { FunctionNotFoundError } from "@dxos/functions";
+import { invariant } from "@dxos/invariant";
+import { log } from "@dxos/log";
+import { Operation, OperationRegistry } from "@dxos/operation";
+var __dxlog_file = "/__w/dxos/dxos/packages/core/blueprints/src/template/prompt.ts";
+var process = (source, variables = {}) => {
+  invariant(typeof source === "string", void 0, { "~LogMeta": "~LogMeta", F: __dxlog_file, L: 15, 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 variables = yield* Effect.forEach(template.inputs ?? [], (input) => Effect.gen(function* () {
+    if (input.kind === "function") {
+      const fn = yield* OperationRegistry.resolve(input.function).pipe(Effect.flatten, Effect.catchTag("NoSuchElementException", () => Effect.fail(new FunctionNotFoundError(input.function))));
+      const result = yield* Operation.invoke(fn, {}).pipe(Effect.orDie);
+      return [
+        input.name,
+        result
+      ];
+    } else {
+      return yield* Effect.dieMessage(`Unsupported input kind: ${input.kind}`);
+    }
+  })).pipe(Effect.map(Record.fromEntries));
+  log("processTemplate", {
+    variables
+  }, { "~LogMeta": "~LogMeta", F: __dxlog_file, L: 35, S: this });
+  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
+        }, { "~LogMeta": "~LogMeta", F: __dxlog_file2, L: 18, S: this });
+      } 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.update(blueprint, (blueprint2) => {
+          void Obj2.updateFrom(blueprint2, 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/routine/index.ts
+var routine_exports = {};
+__export(routine_exports, {
+  Routine: () => Routine,
+  make: () => make3
+});
+
+// src/routine/routine.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 Routine = Schema3.Struct({
+  /**
+  * Name of the routine.
+  */
+  name: Schema3.optional(Schema3.String),
+  /**
+  * Description of the routine's purpose and functionality.
+  * Allows AI agents to execute routines automatically as tools.
+  */
+  description: Schema3.optional(Schema3.String),
+  /**
+  * Input schema of the routine.
+  */
+  input: JsonSchema.JsonSchema.pipe(Annotation2.FormInputAnnotation.set(false)),
+  /**
+  * Output schema of the routine.
+  */
+  output: JsonSchema.JsonSchema.pipe(Annotation2.FormInputAnnotation.set(false)),
+  /**
+  * Natural language instructions for the routine.
+  * These should provide concrete course of action for the AI to follow.
+  */
+  instructions: Template.pipe(Annotation2.FormInputAnnotation.set(false)),
+  /**
+  * Blueprints that the routine may utilize.
+  */
+  blueprints: Schema3.Array(Ref2.Ref(Blueprint)),
+  /**
+  * Additional context that the routine may utilize.
+  */
+  context: Schema3.Array(Schema3.Any).pipe(Annotation2.FormInputAnnotation.set(false))
+}).pipe(Type2.object({
+  typename: "org.dxos.type.routine",
+  version: "0.1.0"
+}), Annotation2.LabelAnnotation.set([
+  "name"
+]), Annotation2.IconAnnotation.set({
+  icon: "ph--scroll--regular",
+  hue: "sky"
+}));
+var make3 = (params) => Obj3.make(Routine, {
+  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,
+  routine_exports as Routine,
+  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/routine/index.ts", "../../../src/routine/routine.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/**\n * Factory for the blueprints.\n */\nexport type Definition = {\n  key: string;\n  make: () => Blueprint;\n};\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 { FunctionNotFoundError } from '@dxos/functions';\nimport { invariant } from '@dxos/invariant';\nimport { log } from '@dxos/log';\nimport { Operation, OperationRegistry } from '@dxos/operation';\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, OperationRegistry.Service | Operation.Service> =>\n  Effect.gen(function* () {\n    const variables = yield* Effect.forEach(template.inputs ?? [], (input) =>\n      Effect.gen(function* () {\n        if (input.kind === 'function') {\n          const fn = yield* OperationRegistry.resolve(input.function!).pipe(\n            Effect.flatten,\n            Effect.catchTag('NoSuchElementException', () => Effect.fail(new FunctionNotFoundError(input.function!))),\n          );\n          const result = yield* Operation.invoke(fn, {} as any).pipe(Effect.orDie);\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.update(blueprint, (blueprint) => {\n          void Obj.updateFrom(blueprint, 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 './routine';\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 Routine = Schema.Struct({\n  /**\n   * Name of the routine.\n   */\n  name: Schema.optional(Schema.String),\n\n  /**\n   * Description of the routine's purpose and functionality.\n   * Allows AI agents to execute routines automatically as tools.\n   */\n  description: Schema.optional(Schema.String),\n\n  /**\n   * Input schema of the routine.\n   */\n  input: JsonSchema.JsonSchema.pipe(Annotation.FormInputAnnotation.set(false)),\n\n  /**\n   * Output schema of the routine.\n   */\n  output: JsonSchema.JsonSchema.pipe(Annotation.FormInputAnnotation.set(false)),\n\n  /**\n   * Natural language instructions for the routine.\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 routine may utilize.\n   */\n  blueprints: Schema.Array(Ref.Ref(Blueprint)),\n\n  /**\n   * Additional context that the routine may utilize.\n   */\n  context: Schema.Array(Schema.Any).pipe(Annotation.FormInputAnnotation.set(false)),\n}).pipe(\n  Type.object({\n    typename: 'org.dxos.type.routine',\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 Routine extends Schema.Schema.Type<typeof Routine> {}\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}): Routine =>\n  Obj.make(Routine, {\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", "FunctionNotFoundError", "invariant", "log", "Operation", "OperationRegistry", "section", "registerHelper", "String", "template", "output", "variables", "trim", "processTemplate", "fn", "resolve", "input", "function", "result", "fromEntries", "Schema", "Ref", "Text", "InputKind", "Literal", "Input", "Struct", "name", "String", "kind", "optional", "default", "Any", "function", "Template", "source", "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", "__dxlog_file", "blueprints", "seen", "has", "blueprint", "log", "key", "getByKey", "query", "updateBlueprints", "registryBlueprint", "Obj", "update", "Effect", "registry", "fail", "NotFoundError", "context", "Database", "local", "make", "Schema", "Annotation", "JsonSchema", "Obj", "Ref", "Type", "Routine", "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":7094,"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},{"path":"@dxos/operation","kind":"import-statement","external":true}],"format":"esm"},"src/template/template.ts":{"bytes":4357,"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":458,"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":11174,"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":10351,"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":465,"imports":[{"path":"src/blueprint/blueprint.ts","kind":"import-statement","original":"./blueprint"},{"path":"src/blueprint/registry.ts","kind":"import-statement","original":"./registry"}],"format":"esm"},"src/routine/routine.ts":{"bytes":7544,"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/routine/index.ts":{"bytes":375,"imports":[{"path":"src/routine/routine.ts","kind":"import-statement","original":"./routine"}],"format":"esm"},"src/index.ts":{"bytes":820,"imports":[{"path":"src/blueprint/index.ts","kind":"import-statement","original":"./blueprint"},{"path":"src/template/index.ts","kind":"import-statement","original":"./template"},{"path":"src/routine/index.ts","kind":"import-statement","original":"./routine"}],"format":"esm"}},"outputs":{"dist/lib/neutral/index.mjs.map":{"imports":[],"exports":[],"inputs":{},"bytes":20102},"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":"@dxos/operation","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","Routine","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":1731},"src/template/template.ts":{"bytesInOutput":777},"src/blueprint/registry.ts":{"bytesInOutput":2352},"src/index.ts":{"bytesInOutput":0},"src/routine/index.ts":{"bytesInOutput":104},"src/routine/routine.ts":{"bytesInOutput":1743}},"bytes":10473}}}

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

@@ -1,65 +1,91 @@
-import { Schema } from 'effect';
-import { Type } from '@dxos/echo';
+import * as Schema from 'effect/Schema';
+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-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">>;
-}>>;
+export declare const Blueprint: Type.Obj<{
+    readonly key: string;
+    readonly name: string;
+    readonly description?: string | undefined;
+    readonly instructions: {
+        readonly source: import("@dxos/echo/internal").Ref<import("@dxos/echo/Entity").OfKind<import("@dxos/echo/internal").EntityKind.Object> & {
+            readonly name?: string | undefined;
+            readonly content: string;
+        }>;
+        readonly inputs?: readonly {
+            readonly name: string;
+            readonly kind?: "context" | "function" | "pass-through" | "query" | "resolver" | "retriever" | "schema" | "value" | undefined;
+            readonly default?: any;
+            readonly function?: string | undefined;
+        }[] | undefined;
+    };
+    readonly tools: readonly (string & import("effect/Brand").Brand<"ToolId">)[];
+    readonly agentCanEnable?: boolean | undefined;
+    readonly mcpServers?: readonly {
+        readonly url: string;
+        readonly protocol: "http" | "sse";
+    }[] | undefined;
+}, Schema.Struct.Fields>;
 /**
  * TypeScript type for Blueprint.
  */
 export interface Blueprint extends Schema.Schema.Type<typeof Blueprint> {
 }
+type MakeProps = Pick<Blueprint, 'key' | 'name'> & Partial<Blueprint>;
 /**
  * Create a new Blueprint.
  */
-export declare const make: ({ tools, ...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;
+export declare const make: ({ tools, instructions, ...props }: MakeProps) => Obj.OfShape<import("@dxos/echo/Entity").OfKind<import("@dxos/echo/internal").EntityKind.Object> & {
+    readonly key: string;
+    readonly name: string;
+    readonly description?: string | undefined;
+    readonly instructions: {
+        readonly source: import("@dxos/echo/internal").Ref<import("@dxos/echo/Entity").OfKind<import("@dxos/echo/internal").EntityKind.Object> & {
+            readonly name?: string | undefined;
+            readonly content: string;
         }>;
-        inputs?: {
-            name: string;
-            kind?: "function" | "value" | "pass-through" | "retriever" | "query" | "resolver" | "context" | "schema" | undefined;
-            default?: any;
+        readonly inputs?: readonly {
+            readonly name: string;
+            readonly kind?: "context" | "function" | "pass-through" | "query" | "resolver" | "retriever" | "schema" | "value" | undefined;
+            readonly default?: any;
+            readonly function?: string | undefined;
         }[] | undefined;
     };
-    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: "http" | "sse";
+    }[] | undefined;
 }>;
+/**
+ * Util to create tool definitions for a blueprint.
+ */
+export declare const toolDefinitions: ({ tools, operations, }: {
+    tools?: string[];
+    operations?: Operation.Definition.Any[];
+}) => (string & import("effect/Brand").Brand<"ToolId">)[];
+/**
+ * Factory for the blueprints.
+ */
+export type Definition = {
+    key: string;
+    make: () => Blueprint;
+};
+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,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAGhC,OAAO,EAAO,IAAI,EAAE,MAAM,YAAY,CAAC;AAKvC;;;;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,qBAA0B,IAAI,CAAC,SAAS,EAAE,KAAK,GAAG,MAAM,GAAG,cAAc,CAAC,GAAG,OAAO,CAAC,SAAS,CAAC;;;;;;;;;;;;;;;EAC1E,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,sCAA8D,SAAS;;;;;;;;;;;;;;;;;;;;;;EAKpF,CAAC;AAEL;;GAEG;AACH,eAAO,MAAM,eAAe,2BAGzB;IACD,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB,UAAU,CAAC,EAAE,SAAS,CAAC,UAAU,CAAC,GAAG,EAAE,CAAC;CACzC,wDAAqG,CAAC;AAEvG;;GAEG;AACH,MAAM,MAAM,UAAU,GAAG;IACvB,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,SAAS,CAAC;CACvB,CAAC"}

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): {
+        cause?: unknown;
+        stack?: string;
+        name: "BlueprintNotFound";
+        context: Record<string, unknown>;
+        readonly message: string;
+        readonly _tag: "BlueprintNotFound";
+    };
+    isError(error: unknown): error is Error;
+    name: "BlueprintNotFound";
+    is(error: unknown): error is BaseError;
+    wrap(options?: Omit<import("@dxos/errors").BaseErrorOptions, 'cause'> & {
+        ifTypeDiffers?: boolean;
+    }): (error: unknown) => {
+        cause?: unknown;
+        stack?: string;
+        name: "BlueprintNotFound";
+        context: Record<string, unknown>;
+        readonly message: string;
+        readonly _tag: "BlueprintNotFound";
+    };
+    extend<Name extends string = string>(name: Name, message?: string): any;
+    captureStackTrace(targetObject: object, constructorOpt?: Function): void;
+    prepareStackTrace?: ((err: Error, stackTraces: NodeJS.CallSite[]) => any) | undefined;
+    stackTraceLimit: number;
+};
+export declare class NotFoundError extends NotFoundError_base {
+}
+export {};
 //# sourceMappingURL=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;IAE/C,YAAY,UAAU,EAAE,SAAS,EAAE,EAYlC;IAED,IAAI,UAAU,IAAI,SAAS,EAAE,CAE5B;IAED,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,GAAG,SAAS,CAE3C;IAED,KAAK,IAAI,SAAS,EAAE,CAEnB;IAED,gBAAgB,IAAI,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,KAAK,EAAE,QAAQ,CAAC,OAAO,CAAC,CAc/D;CACF;;AAED,qBAAa,eAAgB,SAAQ,oBAA4E;CAAG;AAEpH;;;GAGG;AACH,eAAO,MAAM,OAAO,QAAS,MAAM,KAAG,MAAM,CAAC,MAAM,CAAC,SAAS,EAAE,aAAa,EAAE,eAAe,CAQzF,CAAC;AAEL;;;;GAIG;AACH,eAAO,MAAM,MAAM,QAAS,MAAM,KAAG,MAAM,CAAC,MAAM,CAAC,SAAS,EAAE,aAAa,EAAE,eAAe,GAAG,QAAQ,CAAC,OAAO,CAO3G,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAEL,qBAAa,aAAc,SAAQ,kBAA4D;CAAG"}

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

@@ -1,3 +1,5 @@
 export * as Blueprint from './blueprint';
+export type { Definition } from './blueprint/blueprint';
 export * as Template from './template';
+export * as Routine from './routine';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/index.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,SAAS,MAAM,aAAa,CAAC;AACzC,OAAO,KAAK,QAAQ,MAAM,YAAY,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/index.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,SAAS,MAAM,aAAa,CAAC;AACzC,YAAY,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,KAAK,QAAQ,MAAM,YAAY,CAAC;AACvC,OAAO,KAAK,OAAO,MAAM,WAAW,CAAC"}

package/dist/types/src/routine/index.d.ts

@@ -0,0 +1,2 @@
+export * from './routine';
+//# sourceMappingURL=index.d.ts.map

package/dist/types/src/routine/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/routine/index.ts"],"names":[],"mappings":"AAIA,cAAc,WAAW,CAAC"}