@dxos/assistant-toolkit 0.8.4-main.fcc0d83b33 → 0.8.4-staging.60fe92afc8

package/dist/lib/neutral/chunk-KC2LPECT.mjs

@@ -0,0 +1,76 @@
+import {
+  Agent_exports,
+  Plan_exports
+} from "./chunk-URUJQGI6.mjs";
+import {
+  __export
+} from "./chunk-J5LGTIGS.mjs";
+
+// src/blueprints/planning/operations/update-tasks.ts
+var update_tasks_exports = {};
+__export(update_tasks_exports, {
+  UpdateTasks: () => UpdateTasks,
+  default: () => update_tasks_default2
+});
+import * as Effect from "effect/Effect";
+import * as Schema from "effect/Schema";
+import { AiContext } from "@dxos/assistant";
+import { Operation } from "@dxos/compute";
+import { Database, Obj } from "@dxos/echo";
+import { DXN } from "@dxos/keys";
+import { trim } from "@dxos/util";
+
+// raw-loader:/__w/dxos/dxos/packages/core/compute/assistant-toolkit/src/blueprints/planning/operations/update-tasks.md?raw
+var update_tasks_default = '## PLANNING TOOL\n\nThis tool maintains an organized task list.\nUse this to track progress, break down objectives, and ensure thoroughness.\nIf you are asked to create a plan use this tool instead of creating a new document.\nAfter creating initial tasks, update them silently without announcing changes to the user.\nImportant: Do not show or summarize the contents of the task list unless the user asks for this.\n\n### CORE USAGE PRINCIPLES\n\nCreate and manage tasks for: multi-step objectives requiring 3+ distinct actions, complex projects needing careful sequencing,\nuser requests for task organization, multiple deliverables provided together, new instructions (capture as tasks immediately with new IDs),\ncompleted work (mark `done` and add follow-ups), and active work (mark as `in-progress`, limit one at a time).\n\nSkip task management for: single straightforward actions, simple requests achievable in 1-2 steps,\ninformational queries, quick lookups or clarifications, and avoid creating verification tasks unless requested.\n\n### TOOL SPECIFICATION\n\n`update-tasks` requires an array of task objects. Each task object contains:\n\n- id (string, required): unique identifier like "task_1" or "research_sources"\n- title (string, optional): update to clarify or refine task description\n- status (string, optional): `todo` | `in-progress` | `done`\n\nTask status meanings: \'todo\' means not yet started, `in-progress` means currently being worked on, `done` means completed successfully.\n\n### OPERATIONAL GUIDELINES\n\nUpdate tasks in realtime as work progresses. Mark tasks `done` immediately upon completion.\nMaintain only ONE task with `in-progress` status at a time. Complete current tasks before starting new ones.\nUse specific, actionable task titles. Break complex work into manageable logical pieces.\nBatch task updates with other actions when possible for efficiency.\n\n### USAGE EXAMPLES\n\n<example type="research_project">\n<user_message>I need to research sustainable packaging options and write a report comparing costs and environmental impact.</user_message>\n<assistant_action>\nCreates tasks:\n1. {id: "research_materials", title: "Research sustainable packaging materials", status: "in-progress"}\n2. {id: "compare_costs", title: "Compile cost comparison data", status: "todo"}\n3. {id: "assess_impact", title: "Evaluate environmental impact metrics", status: "todo"}\n4. {id: "draft_report", title: "Write comparative analysis report", status: "todo"}\n\nBegins research work immediately in same response.\n</assistant_action>\n<reasoning>Multi-phase project requiring systematic tracking across research, analysis, and writing stages.</reasoning>\n</example>\n\n<example type="event_planning">\n<user_message>Help me plan a team retreat - venue, agenda, catering, and send invitations.</user_message>\n<assistant_action>\nCreates tasks:\n1. {id: "venue_options", title: "Research and recommend venues", status: "in-progress"}\n2. {id: "draft_agenda", title: "Create retreat agenda", status: "todo"}\n3. {id: "arrange_catering", title: "Coordinate catering options", status: "todo"}\n4. {id: "send_invites", title: "Draft and send invitations", status: "todo"}\n</assistant_action>\n<reasoning>Multiple distinct deliverables with dependencies requiring organized tracking.</reasoning>\n</example>\n\n<example type="document_analysis">\n<user_message>Review this 30-page contract for key terms, risks, and negotiation points.</user_message>\n<assistant_action>\nCreates tasks:\n1. {id: "extract_key_terms", title: "Identify key contractual terms", status: "in-progress"}\n2. {id: "flag_risks", title: "Flag potential risks and liabilities", status: "todo"}\n3. {id: "negotiation_points", title: "Compile negotiation recommendations", status: "todo"}\n4. {id: "summary_doc", title: "Prepare executive summary", status: "todo"}\n</assistant_action>\n<reasoning>Substantial analysis work requiring methodical breakdown and systematic review.</reasoning>\n</example>\n\n<example type="multiple_deliverables">\n<user_message>I need: 1) competitor analysis for three companies, 2) SWOT analysis, 3) market positioning recommendations.</user_message>\n<assistant_action>\nCreates tasks:\n1. {id: "competitor_research", title: "Research three competitor companies", status: "in-progress"}\n2. {id: "swot_analysis", title: "Develop SWOT analysis", status: "todo"}\n3. {id: "positioning_recs", title: "Create market positioning recommendations", status: "todo"}\n</assistant_action>\n<reasoning>User provided numbered list of distinct deliverables requiring separate effort.</reasoning>\n</example>\n\n<example type="skip_simple_question">\n<user_message>What\'s the difference between renewable and sustainable energy?</user_message>\n<assistant_action>Provides explanation directly without creating tasks.</assistant_action>\n<reasoning>Informational request with no actionable work to complete or track.</reasoning>\n</example>\n\n<example type="skip_quick_lookup">\n<user_message>Find the population of Tokyo.</user_message>\n<assistant_action>Searches and provides answer without task tracking.</assistant_action>\n<reasoning>Single straightforward lookup completable immediately.</reasoning>\n</example>\n\n<example type="skip_trivial_task">\n<user_message>Summarize this 2-paragraph email.</user_message>\n<assistant_action>Provides summary directly without creating tasks.</assistant_action>\n<reasoning>Single simple action requiring no breakdown or progress tracking.</reasoning>\n</example>\n\n<example type="skip_single_action">\n<user_message>Check if my flight is on time.</user_message>\n<assistant_action>Performs lookup and reports status without task management.</assistant_action>\n<reasoning>One-step action with immediate completion, no organizational benefit from tasks.</reasoning>\n</example>\n\n### BEST PRACTICES\n\nFor task creation: use descriptive unique IDs reflecting the work, start first task as `in-progress`, batch initial creation with beginning work.\nFor progress tracking: update status immediately upon completion, keep only one `in-progress` task unless parallel work is natural, add follow-up tasks as they emerge. For task breakdown: aim for reasonably-scoped tasks, group related small actions into logical units, split tasks requiring different approaches.\n\nWhen uncertain whether to use task management, err on the side of creating tasks.\nProactive organization demonstrates thoroughness and ensures comprehensive work completion.\n';
+
+// src/blueprints/planning/operations/update-tasks.ts
+var SimpleTask = Plan_exports.Task.omit("chat", "delegated");
+var UpdateTasks = Operation.make({
+  meta: {
+    key: DXN.make("org.dxos.function.planning.updateTasks"),
+    name: "Update tasks",
+    description: update_tasks_default,
+    icon: "ph--check-square-offset--regular"
+  },
+  input: Schema.Struct({
+    tasks: Schema.Array(SimpleTask)
+  }),
+  output: Schema.Any,
+  services: [
+    AiContext.Service,
+    Database.Service
+  ]
+});
+var update_tasks_default2 = UpdateTasks.pipe(Operation.withHandler(Effect.fn(function* ({ tasks: newTasks }) {
+  const agent = yield* Agent_exports.getFromChatContext;
+  const plan = yield* Database.load(agent.plan);
+  Obj.update(plan, (plan2) => {
+    for (const task of newTasks) {
+      const existingTask = plan2.tasks.find((t) => t.id === task.id);
+      if (existingTask) {
+        existingTask.title = task.title;
+        existingTask.status = task.status;
+      } else {
+        plan2.tasks.push({
+          id: task.id,
+          title: task.title,
+          status: task.status
+        });
+      }
+    }
+  });
+  return trim`
+        You must update the task status to 'in-progress' when you start and 'done' when complete.
+        Current plan updated:
+        <plan>
+          ${Plan_exports.formatPlan(plan)}
+        </plan>
+      `;
+})));
+
+export {
+  UpdateTasks,
+  update_tasks_default2 as update_tasks_default,
+  update_tasks_exports
+};
+//# sourceMappingURL=chunk-KC2LPECT.mjs.map

package/dist/lib/neutral/chunk-KC2LPECT.mjs.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/blueprints/planning/operations/update-tasks.ts", "raw-loader:/__w/dxos/dxos/packages/core/compute/assistant-toolkit/src/blueprints/planning/operations/update-tasks.md?raw"],
+  "sourcesContent": ["//\n// Copyright 2026 DXOS.org\n//\n\nimport * as Effect from 'effect/Effect';\nimport * as Schema from 'effect/Schema';\n\nimport { AiContext } from '@dxos/assistant';\nimport { Operation } from '@dxos/compute';\nimport { Database, Obj } from '@dxos/echo';\nimport { DXN } from '@dxos/keys';\nimport { trim } from '@dxos/util';\n\nimport { Plan, Agent } from '../../../types';\nimport INSTRUCTIONS from './update-tasks.md?raw';\n\n// Omit `delegated` (and `chat`) from the LLM-facing schema: delegation is set only by the\n// delegation tool, never by ordinary planning, and keeping it out leaves the tool schema unchanged.\nconst SimpleTask = Plan.Task.omit('chat', 'delegated');\n\nexport const UpdateTasks = Operation.make({\n  meta: {\n    key: DXN.make('org.dxos.function.planning.updateTasks'),\n    name: 'Update tasks',\n    description: INSTRUCTIONS,\n    icon: 'ph--check-square-offset--regular',\n  },\n  input: Schema.Struct({\n    tasks: Schema.Array(SimpleTask),\n  }),\n  output: Schema.Any,\n  services: [AiContext.Service, Database.Service],\n});\n\n/**\n * Updates the planning document (Agent.plan) with the given tasks.\n */\nexport default UpdateTasks.pipe(\n  Operation.withHandler(\n    Effect.fn(function* ({ tasks: newTasks }) {\n      const agent = yield* Agent.getFromChatContext;\n      // TODO(burdon): How to specify requirements/preconditions before calling?\n      // TODO(burdon): How to report non-technical error?\n      const plan = yield* Database.load(agent.plan);\n\n      Obj.update(plan, (plan) => {\n        for (const task of newTasks) {\n          const existingTask = plan.tasks.find((t) => t.id === task.id);\n          if (existingTask) {\n            existingTask.title = task.title;\n            existingTask.status = task.status;\n          } else {\n            plan.tasks.push({\n              id: task.id,\n              title: task.title,\n              status: task.status,\n            });\n          }\n        }\n      });\n\n      return trim`\n        You must update the task status to 'in-progress' when you start and 'done' when complete.\n        Current plan updated:\n        <plan>\n          ${Plan.formatPlan(plan)}\n        </plan>\n      `;\n    }) as any,\n  ),\n);\n", "## PLANNING TOOL\n\nThis tool maintains an organized task list.\nUse this to track progress, break down objectives, and ensure thoroughness.\nIf you are asked to create a plan use this tool instead of creating a new document.\nAfter creating initial tasks, update them silently without announcing changes to the user.\nImportant: Do not show or summarize the contents of the task list unless the user asks for this.\n\n### CORE USAGE PRINCIPLES\n\nCreate and manage tasks for: multi-step objectives requiring 3+ distinct actions, complex projects needing careful sequencing,\nuser requests for task organization, multiple deliverables provided together, new instructions (capture as tasks immediately with new IDs),\ncompleted work (mark `done` and add follow-ups), and active work (mark as `in-progress`, limit one at a time).\n\nSkip task management for: single straightforward actions, simple requests achievable in 1-2 steps,\ninformational queries, quick lookups or clarifications, and avoid creating verification tasks unless requested.\n\n### TOOL SPECIFICATION\n\n`update-tasks` requires an array of task objects. Each task object contains:\n\n- id (string, required): unique identifier like \"task_1\" or \"research_sources\"\n- title (string, optional): update to clarify or refine task description\n- status (string, optional): `todo` | `in-progress` | `done`\n\nTask status meanings: 'todo' means not yet started, `in-progress` means currently being worked on, `done` means completed successfully.\n\n### OPERATIONAL GUIDELINES\n\nUpdate tasks in realtime as work progresses. Mark tasks `done` immediately upon completion.\nMaintain only ONE task with `in-progress` status at a time. Complete current tasks before starting new ones.\nUse specific, actionable task titles. Break complex work into manageable logical pieces.\nBatch task updates with other actions when possible for efficiency.\n\n### USAGE EXAMPLES\n\n<example type=\"research_project\">\n<user_message>I need to research sustainable packaging options and write a report comparing costs and environmental impact.</user_message>\n<assistant_action>\nCreates tasks:\n1. {id: \"research_materials\", title: \"Research sustainable packaging materials\", status: \"in-progress\"}\n2. {id: \"compare_costs\", title: \"Compile cost comparison data\", status: \"todo\"}\n3. {id: \"assess_impact\", title: \"Evaluate environmental impact metrics\", status: \"todo\"}\n4. {id: \"draft_report\", title: \"Write comparative analysis report\", status: \"todo\"}\n\nBegins research work immediately in same response.\n</assistant_action>\n<reasoning>Multi-phase project requiring systematic tracking across research, analysis, and writing stages.</reasoning>\n</example>\n\n<example type=\"event_planning\">\n<user_message>Help me plan a team retreat - venue, agenda, catering, and send invitations.</user_message>\n<assistant_action>\nCreates tasks:\n1. {id: \"venue_options\", title: \"Research and recommend venues\", status: \"in-progress\"}\n2. {id: \"draft_agenda\", title: \"Create retreat agenda\", status: \"todo\"}\n3. {id: \"arrange_catering\", title: \"Coordinate catering options\", status: \"todo\"}\n4. {id: \"send_invites\", title: \"Draft and send invitations\", status: \"todo\"}\n</assistant_action>\n<reasoning>Multiple distinct deliverables with dependencies requiring organized tracking.</reasoning>\n</example>\n\n<example type=\"document_analysis\">\n<user_message>Review this 30-page contract for key terms, risks, and negotiation points.</user_message>\n<assistant_action>\nCreates tasks:\n1. {id: \"extract_key_terms\", title: \"Identify key contractual terms\", status: \"in-progress\"}\n2. {id: \"flag_risks\", title: \"Flag potential risks and liabilities\", status: \"todo\"}\n3. {id: \"negotiation_points\", title: \"Compile negotiation recommendations\", status: \"todo\"}\n4. {id: \"summary_doc\", title: \"Prepare executive summary\", status: \"todo\"}\n</assistant_action>\n<reasoning>Substantial analysis work requiring methodical breakdown and systematic review.</reasoning>\n</example>\n\n<example type=\"multiple_deliverables\">\n<user_message>I need: 1) competitor analysis for three companies, 2) SWOT analysis, 3) market positioning recommendations.</user_message>\n<assistant_action>\nCreates tasks:\n1. {id: \"competitor_research\", title: \"Research three competitor companies\", status: \"in-progress\"}\n2. {id: \"swot_analysis\", title: \"Develop SWOT analysis\", status: \"todo\"}\n3. {id: \"positioning_recs\", title: \"Create market positioning recommendations\", status: \"todo\"}\n</assistant_action>\n<reasoning>User provided numbered list of distinct deliverables requiring separate effort.</reasoning>\n</example>\n\n<example type=\"skip_simple_question\">\n<user_message>What's the difference between renewable and sustainable energy?</user_message>\n<assistant_action>Provides explanation directly without creating tasks.</assistant_action>\n<reasoning>Informational request with no actionable work to complete or track.</reasoning>\n</example>\n\n<example type=\"skip_quick_lookup\">\n<user_message>Find the population of Tokyo.</user_message>\n<assistant_action>Searches and provides answer without task tracking.</assistant_action>\n<reasoning>Single straightforward lookup completable immediately.</reasoning>\n</example>\n\n<example type=\"skip_trivial_task\">\n<user_message>Summarize this 2-paragraph email.</user_message>\n<assistant_action>Provides summary directly without creating tasks.</assistant_action>\n<reasoning>Single simple action requiring no breakdown or progress tracking.</reasoning>\n</example>\n\n<example type=\"skip_single_action\">\n<user_message>Check if my flight is on time.</user_message>\n<assistant_action>Performs lookup and reports status without task management.</assistant_action>\n<reasoning>One-step action with immediate completion, no organizational benefit from tasks.</reasoning>\n</example>\n\n### BEST PRACTICES\n\nFor task creation: use descriptive unique IDs reflecting the work, start first task as `in-progress`, batch initial creation with beginning work.\nFor progress tracking: update status immediately upon completion, keep only one `in-progress` task unless parallel work is natural, add follow-up tasks as they emerge. For task breakdown: aim for reasonably-scoped tasks, group related small actions into logical units, split tasks requiring different approaches.\n\nWhen uncertain whether to use task management, err on the side of creating tasks.\nProactive organization demonstrates thoroughness and ensures comprehensive work completion.\n"],
+  "mappings": ";;;;;;;;;AAAA;;;iBAAAA;;AAIA,YAAYC,YAAY;AACxB,YAAYC,YAAY;AAExB,SAASC,iBAAiB;AAC1B,SAASC,iBAAiB;AAC1B,SAASC,UAAUC,WAAW;AAC9B,SAASC,WAAW;AACpB,SAASC,YAAY;;;ACXrB;;;ADkBA,IAAMC,aAAaC,aAAKC,KAAKC,KAAK,QAAQ,WAAA;AAEnC,IAAMC,cAAcC,UAAUC,KAAK;EACxCC,MAAM;IACJC,KAAKC,IAAIH,KAAK,wCAAA;IACdI,MAAM;IACNC,aAAaC;IACbC,MAAM;EACR;EACAC,OAAcC,cAAO;IACnBC,OAAcC,aAAMjB,UAAAA;EACtB,CAAA;EACAkB,QAAeC;EACfC,UAAU;IAACC,UAAUC;IAASC,SAASD;;AACzC,CAAA;AAKA,IAAAE,wBAAepB,YAAYqB,KACzBpB,UAAUqB,YACDC,UAAG,WAAW,EAAEX,OAAOY,SAAQ,GAAE;AACtC,QAAMC,QAAQ,OAAOC,cAAMC;AAG3B,QAAMC,OAAO,OAAOT,SAASU,KAAKJ,MAAMG,IAAI;AAE5CE,MAAIC,OAAOH,MAAM,CAACA,UAAAA;AAChB,eAAWI,QAAQR,UAAU;AAC3B,YAAMS,eAAeL,MAAKhB,MAAMsB,KAAK,CAACC,MAAMA,EAAEC,OAAOJ,KAAKI,EAAE;AAC5D,UAAIH,cAAc;AAChBA,qBAAaI,QAAQL,KAAKK;AAC1BJ,qBAAaK,SAASN,KAAKM;MAC7B,OAAO;AACLV,QAAAA,MAAKhB,MAAM2B,KAAK;UACdH,IAAIJ,KAAKI;UACTC,OAAOL,KAAKK;UACZC,QAAQN,KAAKM;QACf,CAAA;MACF;IACF;EACF,CAAA;AAEA,SAAOE;;;;YAID3C,aAAK4C,WAAWb,IAAAA,CAAAA;;;AAGxB,CAAA,CAAA,CAAA;",
+  "names": ["update_tasks_default", "Effect", "Schema", "AiContext", "Operation", "Database", "Obj", "DXN", "trim", "SimpleTask", "Plan", "Task", "omit", "UpdateTasks", "Operation", "make", "meta", "key", "DXN", "name", "description", "INSTRUCTIONS", "icon", "input", "Struct", "tasks", "Array", "output", "Any", "services", "AiContext", "Service", "Database", "update_tasks_default", "pipe", "withHandler", "fn", "newTasks", "agent", "Agent", "getFromChatContext", "plan", "load", "Obj", "update", "task", "existingTask", "find", "t", "id", "title", "status", "push", "trim", "formatPlan"]
+}

package/dist/lib/neutral/chunk-NSAUN2IX.mjs

@@ -0,0 +1,66 @@
+import {
+  __export
+} from "./chunk-J5LGTIGS.mjs";
+
+// src/blueprints/blueprint-manager/operations/definitions.ts
+var definitions_exports = {};
+__export(definitions_exports, {
+  EnableBlueprints: () => EnableBlueprints,
+  QueryBlueprints: () => QueryBlueprints
+});
+import * as Schema from "effect/Schema";
+import { AiContext } from "@dxos/assistant";
+import { Blueprint, Operation } from "@dxos/compute";
+import { Database, Registry, Type } from "@dxos/echo";
+import { DXN } from "@dxos/keys";
+var QueryBlueprints = Operation.make({
+  meta: {
+    key: DXN.make("org.dxos.function.blueprintManager.queryBlueprints"),
+    name: "Query blueprints",
+    description: "Queries available blueprints.",
+    icon: "ph--blueprint--regular"
+  },
+  input: Schema.Struct({}),
+  output: Schema.Array(Type.getSchema(Blueprint.Blueprint)),
+  services: [
+    Registry.Service
+  ]
+});
+var EnableBlueprints = Operation.make({
+  meta: {
+    key: DXN.make("org.dxos.function.blueprintManager.enableBlueprints"),
+    name: "Enable blueprints",
+    description: "Enables blueprints in the current conversation by their keys. Only blueprints with agentCanEnable=true can be enabled. Always call [query-blueprints] first to discover available blueprint keys.",
+    icon: "ph--plugs-connected--regular"
+  },
+  input: Schema.Struct({
+    keys: Schema.Array(Schema.String).annotations({
+      description: "The keys of the blueprints to enable.",
+      examples: [
+        [
+          "org.dxos.blueprint.memory",
+          "org.dxos.blueprint.database"
+        ]
+      ]
+    })
+  }),
+  output: Schema.Struct({
+    enabled: Schema.Array(Type.getSchema(Blueprint.Blueprint)),
+    rejected: Schema.Array(Schema.Struct({
+      key: Schema.String,
+      reason: Schema.String
+    }))
+  }),
+  services: [
+    Registry.Service,
+    Database.Service,
+    AiContext.Service
+  ]
+});
+
+export {
+  QueryBlueprints,
+  EnableBlueprints,
+  definitions_exports
+};
+//# sourceMappingURL=chunk-NSAUN2IX.mjs.map

package/dist/lib/neutral/chunk-NSAUN2IX.mjs.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/blueprints/blueprint-manager/operations/definitions.ts"],
+  "sourcesContent": ["//\n// Copyright 2026 DXOS.org\n//\n\nimport * as Schema from 'effect/Schema';\n\nimport { AiContext } from '@dxos/assistant';\nimport { Blueprint, Operation } from '@dxos/compute';\nimport { Database, Registry, Type } from '@dxos/echo';\nimport { DXN } from '@dxos/keys';\n\nexport const QueryBlueprints = Operation.make({\n  meta: {\n    key: DXN.make('org.dxos.function.blueprintManager.queryBlueprints'),\n    name: 'Query blueprints',\n    description: 'Queries available blueprints.',\n    icon: 'ph--blueprint--regular',\n  },\n  input: Schema.Struct({}),\n  output: Schema.Array(Type.getSchema(Blueprint.Blueprint)),\n  services: [Registry.Service],\n});\n\nexport const EnableBlueprints = Operation.make({\n  meta: {\n    key: DXN.make('org.dxos.function.blueprintManager.enableBlueprints'),\n    name: 'Enable blueprints',\n    description:\n      'Enables blueprints in the current conversation by their keys. Only blueprints with agentCanEnable=true can be enabled. Always call [query-blueprints] first to discover available blueprint keys.',\n    icon: 'ph--plugs-connected--regular',\n  },\n  input: Schema.Struct({\n    keys: Schema.Array(Schema.String).annotations({\n      description: 'The keys of the blueprints to enable.',\n      examples: [['org.dxos.blueprint.memory', 'org.dxos.blueprint.database']],\n    }),\n  }),\n  output: Schema.Struct({\n    enabled: Schema.Array(Type.getSchema(Blueprint.Blueprint)),\n    rejected: Schema.Array(\n      Schema.Struct({\n        key: Schema.String,\n        reason: Schema.String,\n      }),\n    ),\n  }),\n  services: [Registry.Service, Database.Service, AiContext.Service],\n});\n"],
+  "mappings": ";;;;;AAAA;;;;;AAIA,YAAYA,YAAY;AAExB,SAASC,iBAAiB;AAC1B,SAASC,WAAWC,iBAAiB;AACrC,SAASC,UAAUC,UAAUC,YAAY;AACzC,SAASC,WAAW;AAEb,IAAMC,kBAAkBL,UAAUM,KAAK;EAC5CC,MAAM;IACJC,KAAKJ,IAAIE,KAAK,oDAAA;IACdG,MAAM;IACNC,aAAa;IACbC,MAAM;EACR;EACAC,OAAcC,cAAO,CAAC,CAAA;EACtBC,QAAeC,aAAMZ,KAAKa,UAAUjB,UAAUA,SAAS,CAAA;EACvDkB,UAAU;IAACf,SAASgB;;AACtB,CAAA;AAEO,IAAMC,mBAAmBnB,UAAUM,KAAK;EAC7CC,MAAM;IACJC,KAAKJ,IAAIE,KAAK,qDAAA;IACdG,MAAM;IACNC,aACE;IACFC,MAAM;EACR;EACAC,OAAcC,cAAO;IACnBO,MAAaL,aAAaM,aAAM,EAAEC,YAAY;MAC5CZ,aAAa;MACba,UAAU;QAAC;UAAC;UAA6B;;;IAC3C,CAAA;EACF,CAAA;EACAT,QAAeD,cAAO;IACpBW,SAAgBT,aAAMZ,KAAKa,UAAUjB,UAAUA,SAAS,CAAA;IACxD0B,UAAiBV,aACRF,cAAO;MACZL,KAAYa;MACZK,QAAeL;IACjB,CAAA,CAAA;EAEJ,CAAA;EACAJ,UAAU;IAACf,SAASgB;IAASjB,SAASiB;IAASpB,UAAUoB;;AAC3D,CAAA;",
+  "names": ["Schema", "AiContext", "Blueprint", "Operation", "Database", "Registry", "Type", "DXN", "QueryBlueprints", "make", "meta", "key", "name", "description", "icon", "input", "Struct", "output", "Array", "getSchema", "services", "Service", "EnableBlueprints", "keys", "String", "annotations", "examples", "enabled", "rejected", "reason"]
+}

package/dist/lib/neutral/{chunk-GSG4JGIY.mjs → chunk-RNIUE4LK.mjs}

@@ -1,19 +1,30 @@
 import {
   Agent_exports
-} from "./chunk-SVI25Z2Y.mjs";
+} from "./chunk-URUJQGI6.mjs";
+import {
+  __export
+} from "./chunk-J5LGTIGS.mjs";
 
-// src/blueprints/project/functions/definitions.ts
+// src/blueprints/agent/operations/definitions.ts
+var definitions_exports = {};
+__export(definitions_exports, {
+  AddArtifact: () => AddArtifact,
+  AgentWorker: () => AgentWorker,
+  GetContext: () => GetContext,
+  Qualifier: () => Qualifier
+});
 import * as Schema from "effect/Schema";
 import { AiService, OpaqueToolkit } from "@dxos/ai";
-import { AiContextService } from "@dxos/assistant";
-import { QueueService, Trace, TriggerEvent } from "@dxos/compute";
-import { Operation, OperationRegistry } from "@dxos/compute";
-import { Database, Feed, Obj, Ref } from "@dxos/echo";
+import { AiContext } from "@dxos/assistant";
+import { Trace, TriggerEvent, Operation } from "@dxos/compute";
+import { Database, Feed, Ref, Registry } from "@dxos/echo";
+import { DXN } from "@dxos/keys";
 var AgentWorker = Operation.make({
   meta: {
-    key: "org.dxos.function.agent.worker",
+    key: DXN.make("org.dxos.function.agent.worker"),
     name: "Agent Worker",
-    description: "Agentic worker that drives the agent autonomously."
+    description: "Agentic worker that drives the agent autonomously.",
+    icon: "ph--brain--regular"
   },
   input: Schema.Struct({
     agent: Schema.suspend(() => Ref.Ref(Agent_exports.Agent)),
@@ -24,18 +35,18 @@ var AgentWorker = Operation.make({
   services: [
     AiService.AiService,
     Database.Service,
-    QueueService,
     Feed.FeedService,
-    OperationRegistry.Service,
+    Registry.Service,
     Trace.TraceService,
     OpaqueToolkit.OpaqueToolkitProvider
   ]
 });
 var Qualifier = Operation.make({
   meta: {
-    key: "org.dxos.function.agent.qualifier",
+    key: DXN.make("org.dxos.function.agent.qualifier"),
     name: "Agent Qualifier",
-    description: "Qualifier that determines if the event is relevant to the agent. Puts the data into the input queue of the agent."
+    description: "Qualifier that determines if the event is relevant to the agent. Puts the data into the input queue of the agent.",
+    icon: "ph--funnel--regular"
   },
   input: Schema.Struct({
     agent: Schema.suspend(() => Ref.Ref(Agent_exports.Agent)),
@@ -44,14 +55,16 @@ var Qualifier = Operation.make({
   output: Schema.Void,
   services: [
     AiService.AiService,
-    Database.Service
+    Database.Service,
+    Feed.FeedService
   ]
 });
 var GetContext = Operation.make({
   meta: {
-    key: "org.dxos.function.agent.get-context",
+    key: DXN.make("org.dxos.function.agent.getContext"),
     name: "Get Agent Context",
-    description: "Get the context of an agent."
+    description: "Get the context of an agent.",
+    icon: "ph--info--regular"
   },
   input: Schema.Struct({}),
   output: Schema.Struct({
@@ -66,27 +79,28 @@ var GetContext = Operation.make({
     }))
   }),
   services: [
-    AiContextService,
+    AiContext.Service,
     Database.Service
   ]
 });
 var AddArtifact = Operation.make({
   meta: {
-    key: "org.dxos.function.agent.add-artifact",
+    key: DXN.make("org.dxos.function.agent.addArtifact"),
     name: "Add artifact",
-    description: "Adds a new artifact."
+    description: "Adds a new artifact.",
+    icon: "ph--plus--regular"
   },
   input: Schema.Struct({
     name: Schema.String.annotations({
       description: "The name of the artifact to add."
     }),
-    artifact: Ref.Ref(Obj.Unknown).annotations({
-      description: "The artifact to add. Do NOT guess or try to generate the ID."
+    artifact: Schema.String.annotations({
+      description: "The id of the artifact to add, exactly as returned by the tool that created it. Do NOT guess or generate the id."
     })
   }),
   output: Schema.Void,
   services: [
-    AiContextService,
+    AiContext.Service,
     Database.Service
   ]
 });
@@ -95,6 +109,7 @@ export {
   AgentWorker,
   Qualifier,
   GetContext,
-  AddArtifact
+  AddArtifact,
+  definitions_exports
 };
-//# sourceMappingURL=chunk-GSG4JGIY.mjs.map
+//# sourceMappingURL=chunk-RNIUE4LK.mjs.map

package/dist/lib/neutral/chunk-RNIUE4LK.mjs.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/blueprints/agent/operations/definitions.ts"],
+  "sourcesContent": ["//\n// Copyright 2026 DXOS.org\n//\n\nimport * as Schema from 'effect/Schema';\n\nimport { AiService, OpaqueToolkit } from '@dxos/ai';\nimport { AiContext } from '@dxos/assistant';\nimport { Trace, TriggerEvent, Operation } from '@dxos/compute';\nimport { Database, Feed, Ref, Registry } from '@dxos/echo';\nimport { DXN } from '@dxos/keys';\n\nimport { Agent } from '../../../types';\n\nexport const AgentWorker = Operation.make({\n  meta: {\n    key: DXN.make('org.dxos.function.agent.worker'),\n    name: 'Agent Worker',\n    description: 'Agentic worker that drives the agent autonomously.',\n    icon: 'ph--brain--regular',\n  },\n  input: Schema.Struct({\n    agent: Schema.suspend(() => Ref.Ref(Agent.Agent)),\n    prompt: Schema.optional(Schema.String),\n    event: Schema.optional(TriggerEvent.TriggerEvent),\n  }),\n  output: Schema.Void,\n  services: [\n    AiService.AiService,\n    Database.Service,\n    Feed.FeedService,\n    Registry.Service,\n    Trace.TraceService,\n    OpaqueToolkit.OpaqueToolkitProvider,\n  ],\n});\n\nexport const Qualifier = Operation.make({\n  meta: {\n    key: DXN.make('org.dxos.function.agent.qualifier'),\n    name: 'Agent Qualifier',\n    description:\n      'Qualifier that determines if the event is relevant to the agent. Puts the data into the input queue of the agent.',\n    icon: 'ph--funnel--regular',\n  },\n  input: Schema.Struct({\n    agent: Schema.suspend(() => Ref.Ref(Agent.Agent)),\n    event: TriggerEvent.TriggerEvent,\n  }),\n  output: Schema.Void,\n  services: [AiService.AiService, Database.Service, Feed.FeedService],\n});\n\nexport const GetContext = Operation.make({\n  meta: {\n    key: DXN.make('org.dxos.function.agent.getContext'),\n    name: 'Get Agent Context',\n    description: 'Get the context of an agent.',\n    icon: 'ph--info--regular',\n  },\n  input: Schema.Struct({}),\n  output: Schema.Struct({\n    id: Schema.String,\n    name: Schema.String,\n    instructions: Schema.String,\n    plan: Schema.String,\n    artifacts: Schema.Array(\n      Schema.Struct({\n        name: Schema.String,\n        type: Schema.optional(Schema.String),\n        dxn: Schema.optional(Schema.String),\n      }),\n    ),\n  }),\n  services: [AiContext.Service, Database.Service],\n});\n\nexport const AddArtifact = Operation.make({\n  meta: {\n    key: DXN.make('org.dxos.function.agent.addArtifact'),\n    name: 'Add artifact',\n    description: 'Adds a new artifact.',\n    icon: 'ph--plus--regular',\n  },\n  input: Schema.Struct({\n    name: Schema.String.annotations({\n      description: 'The name of the artifact to add.',\n    }),\n    artifact: Schema.String.annotations({\n      description:\n        'The id of the artifact to add, exactly as returned by the tool that created it. Do NOT guess or generate the id.',\n    }),\n  }),\n  output: Schema.Void,\n  services: [AiContext.Service, Database.Service],\n});\n"],
+  "mappings": ";;;;;;;;AAAA;;;;;;;AAIA,YAAYA,YAAY;AAExB,SAASC,WAAWC,qBAAqB;AACzC,SAASC,iBAAiB;AAC1B,SAASC,OAAOC,cAAcC,iBAAiB;AAC/C,SAASC,UAAUC,MAAMC,KAAKC,gBAAgB;AAC9C,SAASC,WAAW;AAIb,IAAMC,cAAcC,UAAUC,KAAK;EACxCC,MAAM;IACJC,KAAKC,IAAIH,KAAK,gCAAA;IACdI,MAAM;IACNC,aAAa;IACbC,MAAM;EACR;EACAC,OAAcC,cAAO;IACnBC,OAAcC,eAAQ,MAAMC,IAAIA,IAAIC,cAAMA,KAAK,CAAA;IAC/CC,QAAeC,gBAAgBC,aAAM;IACrCC,OAAcF,gBAASG,aAAaA,YAAY;EAClD,CAAA;EACAC,QAAeC;EACfC,UAAU;IACRC,UAAUA;IACVC,SAASC;IACTC,KAAKC;IACLC,SAASH;IACTI,MAAMC;IACNC,cAAcC;;AAElB,CAAA;AAEO,IAAMC,YAAYhC,UAAUC,KAAK;EACtCC,MAAM;IACJC,KAAKC,IAAIH,KAAK,mCAAA;IACdI,MAAM;IACNC,aACE;IACFC,MAAM;EACR;EACAC,OAAcC,cAAO;IACnBC,OAAcC,eAAQ,MAAMC,IAAIA,IAAIC,cAAMA,KAAK,CAAA;IAC/CI,OAAOC,aAAaA;EACtB,CAAA;EACAC,QAAeC;EACfC,UAAU;IAACC,UAAUA;IAAWC,SAASC;IAASC,KAAKC;;AACzD,CAAA;AAEO,IAAMO,aAAajC,UAAUC,KAAK;EACvCC,MAAM;IACJC,KAAKC,IAAIH,KAAK,oCAAA;IACdI,MAAM;IACNC,aAAa;IACbC,MAAM;EACR;EACAC,OAAcC,cAAO,CAAC,CAAA;EACtBU,QAAeV,cAAO;IACpByB,IAAWlB;IACXX,MAAaW;IACbmB,cAAqBnB;IACrBoB,MAAapB;IACbqB,WAAkBC,aACT7B,cAAO;MACZJ,MAAaW;MACbuB,MAAaxB,gBAAgBC,aAAM;MACnCwB,KAAYzB,gBAAgBC,aAAM;IACpC,CAAA,CAAA;EAEJ,CAAA;EACAK,UAAU;IAACoB,UAAUjB;IAASD,SAASC;;AACzC,CAAA;AAEO,IAAMkB,cAAc1C,UAAUC,KAAK;EACxCC,MAAM;IACJC,KAAKC,IAAIH,KAAK,qCAAA;IACdI,MAAM;IACNC,aAAa;IACbC,MAAM;EACR;EACAC,OAAcC,cAAO;IACnBJ,MAAaW,cAAO2B,YAAY;MAC9BrC,aAAa;IACf,CAAA;IACAsC,UAAiB5B,cAAO2B,YAAY;MAClCrC,aACE;IACJ,CAAA;EACF,CAAA;EACAa,QAAeC;EACfC,UAAU;IAACoB,UAAUjB;IAASD,SAASC;;AACzC,CAAA;",
+  "names": ["Schema", "AiService", "OpaqueToolkit", "AiContext", "Trace", "TriggerEvent", "Operation", "Database", "Feed", "Ref", "Registry", "DXN", "AgentWorker", "Operation", "make", "meta", "key", "DXN", "name", "description", "icon", "input", "Struct", "agent", "suspend", "Ref", "Agent", "prompt", "optional", "String", "event", "TriggerEvent", "output", "Void", "services", "AiService", "Database", "Service", "Feed", "FeedService", "Registry", "Trace", "TraceService", "OpaqueToolkit", "OpaqueToolkitProvider", "Qualifier", "GetContext", "id", "instructions", "plan", "artifacts", "Array", "type", "dxn", "AiContext", "AddArtifact", "annotations", "artifact"]
+}

package/dist/lib/neutral/{chunk-KGU725LW.mjs → chunk-SYUTQPSB.mjs}

@@ -8,22 +8,19 @@ __export(Memory_exports, {
   Memory: () => Memory
 });
 import * as Schema from "effect/Schema";
-import { Annotation, Type } from "@dxos/echo";
+import { DXN, Annotation, Type } from "@dxos/echo";
 var Memory = Schema.Struct({
   title: Schema.String,
   content: Schema.String
-}).pipe(Type.object({
-  typename: "org.dxos.type.memory",
-  version: "0.1.0"
-}), Annotation.LabelAnnotation.set([
+}).pipe(Annotation.LabelAnnotation.set([
   "title"
 ]), Annotation.IconAnnotation.set({
   icon: "ph--brain--regular",
   hue: "pink"
-}));
+}), Annotation.HiddenAnnotation.set(true), Type.makeObject(DXN.make("org.dxos.type.memory", "0.1.0")));
 
 export {
   Memory,
   Memory_exports
 };
-//# sourceMappingURL=chunk-KGU725LW.mjs.map
+//# sourceMappingURL=chunk-SYUTQPSB.mjs.map

package/dist/lib/neutral/chunk-SYUTQPSB.mjs.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/types/Memory.ts"],
+  "sourcesContent": ["//\n// Copyright 2026 DXOS.org\n//\n\nimport * as Schema from 'effect/Schema';\n\nimport { DXN, Annotation, Type } from '@dxos/echo';\n\n/**\n * Unit of knowledge generated by an agent.\n */\nexport const Memory = Schema.Struct({\n  title: Schema.String,\n  content: Schema.String,\n}).pipe(\n  Annotation.LabelAnnotation.set(['title']),\n  Annotation.IconAnnotation.set({ icon: 'ph--brain--regular', hue: 'pink' }),\n  Annotation.HiddenAnnotation.set(true),\n  Type.makeObject(DXN.make('org.dxos.type.memory', '0.1.0')),\n);\n\nexport type Memory = Type.InstanceType<typeof Memory>;\n"],
+  "mappings": ";;;;;AAAA;;;;AAIA,YAAYA,YAAY;AAExB,SAASC,KAAKC,YAAYC,YAAY;AAK/B,IAAMC,SAAgBC,cAAO;EAClCC,OAAcC;EACdC,SAAgBD;AAClB,CAAA,EAAGE,KACDP,WAAWQ,gBAAgBC,IAAI;EAAC;CAAQ,GACxCT,WAAWU,eAAeD,IAAI;EAAEE,MAAM;EAAsBC,KAAK;AAAO,CAAA,GACxEZ,WAAWa,iBAAiBJ,IAAI,IAAA,GAChCR,KAAKa,WAAWf,IAAIgB,KAAK,wBAAwB,OAAA,CAAA,CAAA;",
+  "names": ["Schema", "DXN", "Annotation", "Type", "Memory", "Struct", "title", "String", "content", "pipe", "LabelAnnotation", "set", "IconAnnotation", "icon", "hue", "HiddenAnnotation", "makeObject", "make"]
+}

package/dist/lib/neutral/chunk-U5FCQXA2.mjs

@@ -0,0 +1,69 @@
+import {
+  Agent_exports,
+  Plan_exports
+} from "./chunk-URUJQGI6.mjs";
+import {
+  __export
+} from "./chunk-J5LGTIGS.mjs";
+
+// src/blueprints/delegation/operations/delegate-task.ts
+var delegate_task_exports = {};
+__export(delegate_task_exports, {
+  DelegateTask: () => DelegateTask,
+  default: () => delegate_task_default
+});
+import * as Effect from "effect/Effect";
+import * as Schema from "effect/Schema";
+import { AiContext } from "@dxos/assistant";
+import { Operation } from "@dxos/compute";
+import { Database, Obj } from "@dxos/echo";
+import { DXN } from "@dxos/keys";
+import { trim } from "@dxos/util";
+var DelegateTask = Operation.make({
+  meta: {
+    key: DXN.make("org.dxos.function.delegation.delegateTask"),
+    name: "Delegate task",
+    description: trim`
+      Delegate a unit of work to a sub-agent. 
+      Records the work as an in-progress task on the plan and returns the updated plan. 
+      Use this to hand off work that can proceed in the background while you continue the conversation.
+    `,
+    icon: "ph--share-network--regular"
+  },
+  input: Schema.Struct({
+    title: Schema.String.annotations({
+      description: "Short title describing the work to delegate to a sub-agent."
+    })
+  }),
+  output: Schema.Any,
+  services: [
+    AiContext.Service,
+    Database.Service
+  ]
+});
+var delegate_task_default = DelegateTask.pipe(Operation.withHandler(Effect.fn(function* ({ title }) {
+  const agent = yield* Agent_exports.getFromChatContext;
+  const plan = yield* Database.load(agent.plan);
+  Obj.update(plan, (plan2) => {
+    Plan_exports.addTasks(plan2, [
+      {
+        title,
+        status: "in-progress",
+        delegated: true
+      }
+    ]);
+  });
+  return trim`
+        Delegated work as an in-progress task. Current plan:
+        <plan>
+          ${Plan_exports.formatPlan(plan)}
+        </plan>
+      `;
+})));
+
+export {
+  DelegateTask,
+  delegate_task_default,
+  delegate_task_exports
+};
+//# sourceMappingURL=chunk-U5FCQXA2.mjs.map

package/dist/lib/neutral/chunk-U5FCQXA2.mjs.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/blueprints/delegation/operations/delegate-task.ts"],
+  "sourcesContent": ["//\n// Copyright 2026 DXOS.org\n//\n\nimport * as Effect from 'effect/Effect';\nimport * as Schema from 'effect/Schema';\n\nimport { AiContext } from '@dxos/assistant';\nimport { Operation } from '@dxos/compute';\nimport { Database, Obj } from '@dxos/echo';\nimport { DXN } from '@dxos/keys';\nimport { trim } from '@dxos/util';\n\nimport { Agent, Plan } from '../../../types';\n\nexport const DelegateTask = Operation.make({\n  meta: {\n    key: DXN.make('org.dxos.function.delegation.delegateTask'),\n    name: 'Delegate task',\n    description: trim`\n      Delegate a unit of work to a sub-agent. \n      Records the work as an in-progress task on the plan and returns the updated plan. \n      Use this to hand off work that can proceed in the background while you continue the conversation.\n    `,\n    icon: 'ph--share-network--regular',\n  },\n  input: Schema.Struct({\n    title: Schema.String.annotations({\n      description: 'Short title describing the work to delegate to a sub-agent.',\n    }),\n  }),\n  output: Schema.Any,\n  services: [AiContext.Service, Database.Service],\n});\n\n/**\n * Records delegated work as an in-progress task on the current agent's plan.\n */\nexport default DelegateTask.pipe(\n  Operation.withHandler(\n    Effect.fn(function* ({ title }) {\n      const agent = yield* Agent.getFromChatContext;\n      const plan = yield* Database.load(agent.plan);\n      Obj.update(plan, (plan) => {\n        // Mark as delegated so the supervisor's reconcile loop picks it up (and ordinary\n        // `update-tasks` tasks are NOT spawned as sub-agents).\n        Plan.addTasks(plan, [{ title, status: 'in-progress', delegated: true }]);\n      });\n      return trim`\n        Delegated work as an in-progress task. Current plan:\n        <plan>\n          ${Plan.formatPlan(plan)}\n        </plan>\n      `;\n    }),\n  ),\n);\n"],
+  "mappings": ";;;;;;;;;AAAA;;;;;AAIA,YAAYA,YAAY;AACxB,YAAYC,YAAY;AAExB,SAASC,iBAAiB;AAC1B,SAASC,iBAAiB;AAC1B,SAASC,UAAUC,WAAW;AAC9B,SAASC,WAAW;AACpB,SAASC,YAAY;AAId,IAAMC,eAAeC,UAAUC,KAAK;EACzCC,MAAM;IACJC,KAAKC,IAAIH,KAAK,2CAAA;IACdI,MAAM;IACNC,aAAaC;;;;;IAKbC,MAAM;EACR;EACAC,OAAcC,cAAO;IACnBC,OAAcC,cAAOC,YAAY;MAC/BP,aAAa;IACf,CAAA;EACF,CAAA;EACAQ,QAAeC;EACfC,UAAU;IAACC,UAAUC;IAASC,SAASD;;AACzC,CAAA;AAKA,IAAA,wBAAenB,aAAaqB,KAC1BpB,UAAUqB,YACDC,UAAG,WAAW,EAAEX,MAAK,GAAE;AAC5B,QAAMY,QAAQ,OAAOC,cAAMC;AAC3B,QAAMC,OAAO,OAAOP,SAASQ,KAAKJ,MAAMG,IAAI;AAC5CE,MAAIC,OAAOH,MAAM,CAACA,UAAAA;AAGhBI,iBAAKC,SAASL,OAAM;MAAC;QAAEf;QAAOqB,QAAQ;QAAeC,WAAW;MAAK;KAAE;EACzE,CAAA;AACA,SAAO1B;;;YAGDuB,aAAKI,WAAWR,IAAAA,CAAAA;;;AAGxB,CAAA,CAAA,CAAA;",
+  "names": ["Effect", "Schema", "AiContext", "Operation", "Database", "Obj", "DXN", "trim", "DelegateTask", "Operation", "make", "meta", "key", "DXN", "name", "description", "trim", "icon", "input", "Struct", "title", "String", "annotations", "output", "Any", "services", "AiContext", "Service", "Database", "pipe", "withHandler", "fn", "agent", "Agent", "getFromChatContext", "plan", "load", "Obj", "update", "Plan", "addTasks", "status", "delegated", "formatPlan"]
+}