@dxos/assistant-toolkit 0.9.0 → 0.9.1-main.c7dcc2e112

package/dist/lib/neutral/{add-artifact-54DVWE53.mjs → add-artifact-QEQP6T7Z.mjs}

@@ -1,10 +1,10 @@
 import {
   AddArtifact
-} from "./chunk-RNIUE4LK.mjs";
+} from "./chunk-CUT6GB2W.mjs";
 import {
   Agent_exports
-} from "./chunk-URUJQGI6.mjs";
-import "./chunk-Z3KITY4U.mjs";
+} from "./chunk-5HANNHZZ.mjs";
+import "./chunk-JZHXJBSM.mjs";
 import "./chunk-SYUTQPSB.mjs";
 import "./chunk-J5LGTIGS.mjs";
 
@@ -21,4 +21,4 @@ var add_artifact_default = AddArtifact.pipe(Operation.withHandler(Effect.fnUntra
 export {
   add_artifact_default as default
 };
-//# sourceMappingURL=add-artifact-54DVWE53.mjs.map
+//# sourceMappingURL=add-artifact-QEQP6T7Z.mjs.map

package/dist/lib/neutral/{agent-LCBDWP74.mjs → agent-BU6PB7J6.mjs}

@@ -1,10 +1,10 @@
 import {
   AgentWorker
-} from "./chunk-RNIUE4LK.mjs";
+} from "./chunk-CUT6GB2W.mjs";
 import {
   Agent_exports
-} from "./chunk-URUJQGI6.mjs";
-import "./chunk-Z3KITY4U.mjs";
+} from "./chunk-5HANNHZZ.mjs";
+import "./chunk-JZHXJBSM.mjs";
 import "./chunk-SYUTQPSB.mjs";
 import "./chunk-J5LGTIGS.mjs";
 
@@ -62,4 +62,4 @@ var agent_default = AgentWorker.pipe(Operation.withHandler(Effect.fnUntraced(fun
 export {
   agent_default as default
 };
-//# sourceMappingURL=agent-LCBDWP74.mjs.map
+//# sourceMappingURL=agent-BU6PB7J6.mjs.map

package/dist/lib/neutral/{agent-rules-3TBAIVTS.mjs → agent-rules-L3AHRSR4.mjs}

@@ -1,8 +1,8 @@
 import {
   AgentRules
-} from "./chunk-3YH7MWSD.mjs";
-import "./chunk-URUJQGI6.mjs";
-import "./chunk-Z3KITY4U.mjs";
+} from "./chunk-KZDQGI3S.mjs";
+import "./chunk-5HANNHZZ.mjs";
+import "./chunk-JZHXJBSM.mjs";
 import "./chunk-SYUTQPSB.mjs";
 import "./chunk-J5LGTIGS.mjs";
 
@@ -75,4 +75,4 @@ var agent_rules_default = AgentRules.pipe(Operation.withHandler(Effect.fnUntrace
 export {
   agent_rules_default as default
 };
-//# sourceMappingURL=agent-rules-3TBAIVTS.mjs.map
+//# sourceMappingURL=agent-rules-L3AHRSR4.mjs.map

package/dist/lib/neutral/{chunk-URUJQGI6.mjs → chunk-5HANNHZZ.mjs}

@@ -2,7 +2,7 @@ import {
   Chat,
   CompanionTo,
   make
-} from "./chunk-Z3KITY4U.mjs";
+} from "./chunk-JZHXJBSM.mjs";
 import {
   __export
 } from "./chunk-J5LGTIGS.mjs";
@@ -14,11 +14,13 @@ __export(Plan_exports, {
   Task: () => Task,
   TaskId: () => TaskId,
   addTasks: () => addTasks,
+  formatAgentPidTag: () => formatAgentPidTag,
   formatPlan: () => formatPlan,
   generateTaskId: () => generateTaskId,
   makePlan: () => makePlan
 });
 import * as Schema from "effect/Schema";
+import { Process } from "@dxos/compute";
 import { DXN, Annotation, Obj, Ref, Type } from "@dxos/echo";
 var TaskId = Schema.String.pipe(Schema.brand("@dxos/assistant-toolkit/TaskId"));
 var Task = Schema.Struct({
@@ -37,6 +39,12 @@ var Task = Schema.Struct({
   */
   delegated: Schema.optional(Schema.Boolean),
   /**
+  * Sub-agent process id; set when the supervisor spawns a delegated task.
+  */
+  agentPid: Schema.optional(Process.ID).annotations({
+    description: "Sub-agent process id for delegated tasks."
+  }),
+  /**
   * Parent task ID.
   */
   parent: Schema.optional(TaskId).annotations({
@@ -47,6 +55,7 @@ var Task = Schema.Struct({
   */
   chat: Schema.optional(Ref.Ref(Chat))
 });
+var formatAgentPidTag = (pid) => `agent-${String(pid).replaceAll("-", "").slice(0, 4)}`;
 var Plan = Schema.Struct({
   tasks: Schema.Array(Task)
 }).pipe(Annotation.HiddenAnnotation.set(true), Type.makeObject(DXN.make("org.dxos.type.plan", "0.1.0")));
@@ -304,4 +313,4 @@ export {
   Agent_exports,
   McpServer_exports
 };
-//# sourceMappingURL=chunk-URUJQGI6.mjs.map
+//# sourceMappingURL=chunk-5HANNHZZ.mjs.map

package/dist/lib/neutral/chunk-5HANNHZZ.mjs.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/types/Plan.ts", "../../../src/types/Agent.ts", "../../../src/types/McpServer.ts"],
+  "sourcesContent": ["//\n// Copyright 2026 DXOS.org\n//\n\n// @import-as-namespace\n\nimport * as Schema from 'effect/Schema';\n\nimport { Process } from '@dxos/compute';\nimport { DXN, Annotation, Obj, Ref, Type } from '@dxos/echo';\n\nimport * as Chat from './Chat';\n\nexport const TaskId = Schema.String.pipe(Schema.brand('@dxos/assistant-toolkit/TaskId'));\nexport type TaskId = Schema.Schema.Type<typeof TaskId>;\n\nexport const Task = Schema.Struct({\n  /**\n   * Short task ID unique within the plan.\n   */\n  id: TaskId,\n\n  title: Schema.String.annotations({\n    description: 'Task title and description.',\n  }),\n\n  status: Schema.Literal('todo', 'in-progress', 'done', 'failed'),\n\n  /**\n   * Whether this task was handed to a sub-agent via the delegation tool. Only delegated tasks are\n   * picked up by the supervisor's reconcile loop, so a task created via ordinary planning\n   * (`update-tasks`) is not double-spawned as a sub-agent.\n   */\n  delegated: Schema.optional(Schema.Boolean),\n\n  /**\n   * Sub-agent process id; set when the supervisor spawns a delegated task.\n   */\n  agentPid: Schema.optional(Process.ID).annotations({\n    description: 'Sub-agent process id for delegated tasks.',\n  }),\n\n  /**\n   * Parent task ID.\n   */\n  parent: Schema.optional(TaskId).annotations({\n    description: 'Parent task ID.',\n  }),\n\n  /**\n   * Chat object that this task is associated with.\n   */\n  chat: Schema.optional(Ref.Ref(Chat.Chat)),\n});\n\nexport type Task = Schema.Schema.Type<typeof Task>;\n\n/**\n * Short tag label for a delegated sub-agent process id (e.g. `agent-a1b2`).\n */\nexport const formatAgentPidTag = (pid: Process.ID): string => `agent-${String(pid).replaceAll('-', '').slice(0, 4)}`;\n\n/**\n * Hierarchical collection of tasks for humans and agents to track progress.\n */\nexport const Plan = Schema.Struct({\n  tasks: Schema.Array(Task),\n}).pipe(Annotation.HiddenAnnotation.set(true), Type.makeObject(DXN.make('org.dxos.type.plan', '0.1.0')));\nexport type Plan = Type.InstanceType<typeof Plan>;\nexport const generateTaskId = (plan: Plan): TaskId => {\n  const existingIds = plan.tasks\n    .map((task) => {\n      const [num, letter] = task.id.split('-');\n      return parseInt(num);\n    })\n    .filter((_) => !isNaN(_));\n  let newId;\n  if (existingIds.length === 0) {\n    newId = 1;\n  } else {\n    newId = Math.max(...existingIds) + 1;\n  }\n  // Add random suffix to avoid collisions.\n  return TaskId.make(`${newId}-${crypto.randomUUID().slice(0, 2)}`);\n};\n\n/**\n * Add new tasks to a plan, generating IDs for new tasks.\n * Use inside an `Obj.update` callback.\n */\nexport const addTasks = (\n  plan: Obj.Mutable<Plan>,\n  tasks: (Pick<Task, 'title'> & Partial<Pick<Task, 'status' | 'parent' | 'chat' | 'delegated'>>)[],\n) => {\n  for (const task of tasks) {\n    const taskId = generateTaskId(plan);\n    plan.tasks.push({ id: taskId, ...task, status: task.status ?? 'todo' });\n  }\n  return plan;\n};\n\ninterface MakePlanProps {\n  tasks: (Pick<Task, 'title'> & Partial<Pick<Task, 'status'>>)[];\n}\n\nexport const makePlan = (props: MakePlanProps): Plan => {\n  const plan = Obj.make(Plan, { tasks: [] });\n  Obj.update(plan, (plan) => {\n    addTasks(plan, props.tasks);\n  });\n  return plan;\n};\n\n/**\n * Formats plan to markdown format.\n */\nexport const formatPlan = (plan: Plan): string => {\n  return plan.tasks\n    .map((task) => `- **${task.status?.toLocaleUpperCase()}**: ${task.title ?? 'No title'} <!-- id=${task.id} -->`)\n    .join('\\n');\n};\n", "//\n// Copyright 2026 DXOS.org\n//\n\n// @import-as-namespace\n\nimport * as Effect from 'effect/Effect';\nimport * as Function from 'effect/Function';\nimport * as Schema from 'effect/Schema';\n\nimport { AiContext } from '@dxos/assistant';\nimport { type Blueprint } from '@dxos/compute';\nimport { DXN, Annotation, Database, Feed, Format, Obj, Ref, Relation, Type } from '@dxos/echo';\nimport { FormInputAnnotation } from '@dxos/echo/Annotation';\nimport { type EntityNotFoundError } from '@dxos/echo/Err';\nimport { EffectEx } from '@dxos/effect';\nimport { invariant } from '@dxos/invariant';\nimport { EID, type EntityId } from '@dxos/keys';\nimport { Text } from '@dxos/schema';\n\nimport * as Chat from './Chat';\nimport * as Plan from './Plan';\n\n/**\n * Agent schema definition.\n */\nexport const Agent = Schema.Struct({\n  name: Schema.optional(Schema.String),\n\n  /**\n   * When false, agent triggers are disabled after sync-triggers runs.\n   */\n  enabled: Schema.optional(Schema.Boolean).annotations({\n    title: 'Enabled',\n    description: 'Master switch for agent automation; propagated to all triggers on sync.',\n  }),\n\n  /**\n   * Instructions for the agent.\n   */\n  instructions: Ref.Ref(Text.Text).pipe(\n    Format.FormatAnnotation.set(Format.TypeFormat.Markdown),\n    Schema.annotations({ title: 'Instructions' }),\n  ),\n\n  /**\n   * Primary chat for the agent.\n   */\n  // TODO(dmaretskyi): Multiple chats; RB: branching hierarchy.\n  chat: Schema.optional(Ref.Ref(Chat.Chat).pipe(FormInputAnnotation.set(false))),\n\n  // TODO(burdon): Is this used? Should it be an artifact?\n  // Format.FormatAnnotation.set(Format.TypeFormat.Markdown)\n  plan: Ref.Ref(Plan.Plan).pipe(FormInputAnnotation.set(false)),\n\n  // TODO(burdon): Currently Memory.Memory objects are global to the space; make them artifacts?\n  artifacts: Schema.Array(\n    Schema.Struct({\n      // TODO(dmaretskyi): Consider gettings names from the artifact itself using Obj.getLabel.\n      name: Schema.String,\n      // TODO(burdon): Rename object.\n      data: Ref.Ref(Obj.Unknown),\n    }),\n  ).pipe(FormInputAnnotation.set(false)),\n\n  /**\n   * References to objects with a canonical queue property.\n   * Schema must have the QueueAnnotation.\n   */\n  // Change to trigger.\n  // TODO(dmaretskyi): Turn into an array of objects when form-data\n  subscriptions: Schema.Array(Ref.Ref(Obj.Unknown)).pipe(FormInputAnnotation.set(false)),\n\n  /**\n   * Cron expression for a timer trigger that invokes the agent worker on a schedule.\n   * The timer trigger bypasses the qualifier and goes straight to the agent worker.\n   */\n  // Change to trigger.\n  cron: Schema.optional(Schema.String).annotations({\n    title: 'Cron',\n    description: 'Cron expression for a timer trigger that invokes the agent on a schedule.',\n  }),\n\n  /**\n   * Input feed for subscriptions.\n   * @deprecated Subscriptions will write directly to the agent.\n   */\n  feed: Schema.optional(Ref.Ref(Feed.Feed).pipe(FormInputAnnotation.set(false))),\n\n  /**\n   * Allow the agent to filter events.\n   * Related events will be added to the input queue of the agent.\n   * It is recommended to enable this.\n   * @deprecated\n   */\n  filterEvents: Schema.optional(Schema.Boolean).annotations({\n    title: 'Filter events',\n    description: 'Allow the agent to filter events.',\n  }),\n}).pipe(\n  Annotation.LabelAnnotation.set(['name']),\n  Annotation.IconAnnotation.set({ icon: 'ph--drone--regular', hue: 'sky' }),\n  Type.makeObject(DXN.make('org.dxos.type.agent', '0.1.0')),\n);\n\nexport type Agent = Type.InstanceType<typeof Agent>;\n\nexport type MakeProps = Omit<\n  Obj.MakeProps<typeof Agent>,\n  'instructions' | 'plan' | 'artifacts' | 'subscriptions' | 'chat'\n> &\n  Partial<Pick<Obj.MakeProps<typeof Agent>, 'artifacts' | 'subscriptions'>> & {\n    instructions: string;\n    blueprints?: Ref.Ref<Blueprint.Blueprint>[];\n    contextObjects?: Ref.Ref<Obj.Any>[];\n  };\n\n/**\n * Creates a fully initialized Agent with chat, queue, and context bindings.\n *\n * @param props - Agent properties including spec, plan, blueprints, and context objects.\n * @param blueprint - The blueprint to use for the agent context.\n * @returns An Effect that yields the initialized Agent.\n */\nexport const makeInitialized = (\n  props: MakeProps,\n  // TODO(burdon): Reconcile with props.blueprints.\n  blueprint: Blueprint.Blueprint,\n): Effect.Effect<Agent, never, Feed.FeedService | Database.Service> =>\n  Effect.gen(function* () {\n    const agent = yield* Database.add(\n      Obj.make(Agent, {\n        ...props,\n        instructions: Ref.make(Text.make({ content: props.instructions })),\n        plan: Ref.make(Plan.makePlan({ tasks: [] })),\n        artifacts: props.artifacts ?? [],\n        subscriptions: props.subscriptions ?? [],\n        filterEvents: props.filterEvents ?? true,\n        enabled: props.enabled ?? true,\n      }),\n    );\n    const feed = yield* Database.add(Feed.make());\n    const runtime = yield* Effect.runtime<Feed.FeedService>();\n    const contextBinder = new AiContext.Binder({ feed, runtime });\n    // TODO(dmaretskyi): Blueprint registry.\n    const agentBlueprint = yield* Database.add(Obj.clone(blueprint, { deep: true }));\n    yield* Effect.promise(() =>\n      contextBinder.bind({\n        blueprints: [Ref.make(agentBlueprint), ...(props.blueprints ?? [])],\n        objects: [Ref.make(agent), ...(props.contextObjects ?? [])],\n      }),\n    );\n\n    const chat = yield* Database.add(\n      Chat.make({\n        [Obj.Parent]: agent,\n        feed: Ref.make(feed),\n      }),\n    );\n    Obj.setParent(feed, chat);\n    yield* Database.add(\n      Relation.make(Chat.CompanionTo, {\n        [Relation.Source]: chat,\n        [Relation.Target]: agent,\n      }),\n    );\n\n    const inputFeed = yield* Database.add(Feed.make());\n    Obj.update(agent, (agent) => {\n      agent.chat = Ref.make(chat);\n      agent.feed = Ref.make(inputFeed);\n    });\n\n    return agent;\n  });\n\n/**\n * Resets the agent chat history by rebuilding the chat context.\n * Preserves the existing blueprints and objects from the current chat context.\n *\n * @param agent - The agent whose chat history should be reset. Must have an existing chat.\n * @returns An Effect that resets the chat history.\n */\nexport const resetChatHistory = (\n  agent: Agent,\n): Effect.Effect<void, EntityNotFoundError, Feed.FeedService | Database.Service> =>\n  Effect.gen(function* () {\n    invariant(agent.chat, 'Agent must have an existing chat to reset.');\n\n    const existingFeed = yield* agent.chat.pipe(Database.load).pipe(\n      Effect.map((_) => _.feed),\n      Effect.flatMap(Database.load),\n    );\n    const runtime = yield* Effect.runtime<Feed.FeedService>();\n    const existingContextBinder = yield* EffectEx.acquireReleaseResource(\n      () =>\n        new AiContext.Binder({\n          feed: existingFeed,\n          runtime,\n        }),\n    );\n    const blueprints = existingContextBinder.getBlueprints().map((blueprint) => Ref.make(blueprint));\n    const objects = existingContextBinder.getObjects().map((object) => Ref.make(object));\n\n    const feed = yield* Database.add(Feed.make());\n    const contextBinder = new AiContext.Binder({ feed, runtime });\n    yield* Effect.promise(() =>\n      contextBinder.bind({\n        blueprints,\n        objects,\n      }),\n    );\n\n    const chat = yield* Database.add(\n      Chat.make({\n        feed: Ref.make(feed),\n      }),\n    );\n    Obj.setParent(feed, chat);\n    Obj.update(agent, (agent) => {\n      agent.chat = Ref.make(chat);\n    });\n\n    yield* Database.add(\n      Relation.make(Chat.CompanionTo, {\n        [Relation.Source]: chat,\n        [Relation.Target]: agent,\n      }),\n    );\n  }).pipe(Effect.scoped);\n\nexport const getFromChatContext: Effect.Effect<Agent, Error, AiContext.Service> = Effect.gen(function* () {\n  const agents = yield* Function.pipe(AiContext.Service.findObjects(Agent));\n  if (agents.length !== 1) {\n    return yield* Effect.fail(new Error(`There should be exactly one agent in context. Got: ${agents.length}`));\n  }\n\n  const agent = agents[0];\n  return agent;\n});\n\n/**\n * Adds an object to the agent's artifacts (context), resolving it by id within the agent's space.\n *\n * Accepts whatever reference a tool returned — a bare entity id (e.g. `01J…`) or a full ECHO URI\n * (`echo:/…`, `echo://…`). LLMs frequently strip a returned URI down to the bare id, which is not\n * a resolvable URI on its own; resolving by entity id within the space tolerates both forms.\n *\n * Returns the fully-qualified {@link Ref.Ref} that was stored (also usable for an inline message\n * reference block).\n */\nexport const addArtifact = (\n  agent: Agent,\n  { name, id }: { name: string; id: string },\n): Effect.Effect<Ref.Ref<Obj.Unknown>, Error, Database.Service> =>\n  Effect.gen(function* () {\n    // Untyped, LLM-provided reference: normalize to the entity id, falling back to the raw value\n    // (a bare id is already an entity id) — a genuine external-data boundary.\n    const parsed = EID.tryParse(id);\n    const entityId = ((parsed ? EID.getEntityId(parsed) : undefined) ?? id) as EntityId;\n\n    // Store a FULLY-QUALIFIED ref (`echo://<space>/<id>`), not a local `echo:/<id>` one: the artifact\n    // is created by a separate tool/process invocation, and a space-less local ref does not resolve\n    // when the agent is later read from a different db view (e.g. the UI). It is not resolved here —\n    // it resolves lazily when read, by which point the artifact is persisted.\n    const { db } = yield* Database.Service;\n    const ref = db.makeRef<Obj.Unknown>(EID.make({ spaceId: db.spaceId, entityId }));\n\n    Obj.update(agent, (agent) => {\n      agent.artifacts.push({ name, data: ref });\n    });\n    yield* Database.flush();\n    return ref;\n  });\n", "//\n// Copyright 2026 DXOS.org\n//\n\n// @import-as-namespace\n\nimport * as Schema from 'effect/Schema';\n\nimport { McpServer as McpServerSpec } from '@dxos/compute';\nimport { DXN, Annotation, Type } from '@dxos/echo';\nimport { LabelAnnotation } from '@dxos/echo/Annotation';\n\n/**\n * MCP server configuration stored as a space-level ECHO object.\n *\n * Composes the canonical connection spec from `@dxos/compute` (`url`, `protocol`, `apiKey`)\n * and adds instance-level fields (`name`, `enabled`) plus ECHO annotations.\n *\n * NOTE: `apiKey` is stored in plaintext and replicated to all peers with access to the space.\n * A future iteration should move secrets to per-device credential storage or use envelope encryption.\n */\nexport const McpServer = Schema.Struct({\n  ...McpServerSpec.McpServer.fields,\n  enabled: Schema.optional(Schema.Boolean),\n}).pipe(\n  LabelAnnotation.set(['name']),\n  Annotation.IconAnnotation.set({ icon: 'ph--plugs-connected--regular', hue: 'sky' }),\n  Type.makeObject(DXN.make('org.dxos.type.assistant.mcpServer', '0.1.0')),\n);\n\nexport type McpServer = Type.InstanceType<typeof McpServer>;\n"],
+  "mappings": "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",
+  "names": ["Schema", "Process", "DXN", "Annotation", "Obj", "Ref", "Type", "TaskId", "String", "pipe", "brand", "Task", "Struct", "id", "title", "annotations", "description", "status", "Literal", "delegated", "optional", "Boolean", "agentPid", "Process", "ID", "parent", "chat", "Ref", "Chat", "formatAgentPidTag", "pid", "replaceAll", "slice", "Plan", "tasks", "Array", "Annotation", "HiddenAnnotation", "set", "Type", "makeObject", "DXN", "make", "generateTaskId", "plan", "existingIds", "map", "task", "num", "letter", "split", "parseInt", "filter", "_", "isNaN", "newId", "length", "Math", "max", "crypto", "randomUUID", "addTasks", "taskId", "push", "makePlan", "props", "Obj", "update", "formatPlan", "toLocaleUpperCase", "join", "Effect", "Function", "Schema", "AiContext", "DXN", "Annotation", "Database", "Feed", "Format", "Obj", "Ref", "Relation", "Type", "FormInputAnnotation", "EffectEx", "invariant", "EID", "Text", "Ref", "artifacts", "Array", "Schema", "String", "data", "Obj", "description", "Annotation", "LabelAnnotation", "IconAnnotation", "icon", "hue", "Type", "makeObject", "agent", "Database", "props", "instructions", "Text", "make", "plan", "Plan", "subscriptions", "filterEvents", "enabled", "add", "contextBinder", "AiContext", "Binder", "feed", "runtime", "Effect", "agentBlueprint", "objects", "chat", "setParent", "Source", "Relation", "Target", "inputFeed", "existingFeed", "pipe", "existingContextBinder", "EffectEx", "acquireReleaseResource", "blueprints", "scoped", "agents", "Error", "spaceId", "db", "entityId", "update", "name", "ref", "Schema", "McpServer", "McpServerSpec", "DXN", "Annotation", "Type", "LabelAnnotation", "Struct", "fields", "enabled", "optional", "Boolean", "pipe", "set", "IconAnnotation", "icon", "hue", "makeObject", "make"]
+}

package/dist/lib/neutral/{chunk-KC2LPECT.mjs → chunk-ABOAU3NN.mjs}

@@ -1,7 +1,7 @@
 import {
   Agent_exports,
   Plan_exports
-} from "./chunk-URUJQGI6.mjs";
+} from "./chunk-5HANNHZZ.mjs";
 import {
   __export
 } from "./chunk-J5LGTIGS.mjs";
@@ -20,11 +20,11 @@ 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
+// raw-loader:/__w/dxos/dxos/packages/core/compute/assistant-toolkit/src/blueprints/planning/operations/update-tasks.md
 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 SimpleTask = Plan_exports.Task.omit("chat", "delegated", "agentPid");
 var UpdateTasks = Operation.make({
   meta: {
     key: DXN.make("org.dxos.function.planning.updateTasks"),
@@ -73,4 +73,4 @@ export {
   update_tasks_default2 as update_tasks_default,
   update_tasks_exports
 };
-//# sourceMappingURL=chunk-KC2LPECT.mjs.map
+//# sourceMappingURL=chunk-ABOAU3NN.mjs.map

package/dist/lib/neutral/chunk-ABOAU3NN.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"],
+  "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 `chat`, `delegated`, and `agentPid` from the LLM-facing schema: these are set by the\n// delegation tool / runtime, never by ordinary planning, and keeping them out leaves the tool\n// schema unchanged.\nconst SimpleTask = Plan.Task.omit('chat', 'delegated', 'agentPid');\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;;;ADmBA,IAAMC,aAAaC,aAAKC,KAAKC,KAAK,QAAQ,aAAa,UAAA;AAEhD,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-RNIUE4LK.mjs → chunk-CUT6GB2W.mjs}

@@ -1,6 +1,6 @@
 import {
   Agent_exports
-} from "./chunk-URUJQGI6.mjs";
+} from "./chunk-5HANNHZZ.mjs";
 import {
   __export
 } from "./chunk-J5LGTIGS.mjs";
@@ -112,4 +112,4 @@ export {
   AddArtifact,
   definitions_exports
 };
-//# sourceMappingURL=chunk-RNIUE4LK.mjs.map
+//# sourceMappingURL=chunk-CUT6GB2W.mjs.map

package/dist/lib/neutral/{chunk-Z3KITY4U.mjs → chunk-JZHXJBSM.mjs}

@@ -16,7 +16,7 @@ import { FormInputAnnotation, LabelAnnotation } from "@dxos/echo/Annotation";
 var Chat = Schema.Struct({
   name: Schema.String.pipe(Schema.optional),
   feed: Ref.Ref(Feed.Feed).pipe(FormInputAnnotation.set(false)),
-  view: Schema.String.pipe(Schema.optional)
+  viewType: Schema.String.pipe(Schema.optional)
 }).pipe(LabelAnnotation.set([
   "name"
 ]), Annotation.IconAnnotation.set({
@@ -45,4 +45,4 @@ export {
   CompanionTo,
   Chat_exports
 };
-//# sourceMappingURL=chunk-Z3KITY4U.mjs.map
+//# sourceMappingURL=chunk-JZHXJBSM.mjs.map

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

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/types/Chat.ts"],
+  "sourcesContent": ["//\n// Copyright 2024 DXOS.org\n//\n\n// @import-as-namespace\n\nimport * as Schema from 'effect/Schema';\n\nimport { DXN, Annotation, Feed, Obj, Ref, Type } from '@dxos/echo';\nimport { FormInputAnnotation, LabelAnnotation } from '@dxos/echo/Annotation';\n\n/**\n * AI chat.\n */\nexport const Chat = Schema.Struct({\n  name: Schema.String.pipe(Schema.optional),\n  feed: Ref.Ref(Feed.Feed).pipe(FormInputAnnotation.set(false)),\n  viewType: Schema.String.pipe(Schema.optional),\n}).pipe(\n  LabelAnnotation.set(['name']),\n  Annotation.IconAnnotation.set({ icon: 'ph--sparkle--regular', hue: 'sky' }),\n  Type.makeObject(DXN.make('org.dxos.type.assistant.chat', '0.1.0')),\n);\n\nexport type Chat = Type.InstanceType<typeof Chat>;\nexport const make = (props: Obj.MakeProps<typeof Chat>) => Obj.make(Chat, props);\n\n/** @deprecated Use CompanionTo instead. */\nexport const LegacyCompanionTo = Schema.Struct({\n  id: Obj.ID,\n}).pipe(\n  Type.makeRelation({\n    dxn: DXN.make('org.dxos.relation.assistant.companionTo', '0.1.0'),\n    source: Chat,\n    target: Obj.Unknown,\n  }),\n);\n\nexport type LegacyCompanionTo = Type.InstanceType<typeof LegacyCompanionTo>;\n/**\n * Relation between a Chat and companion objects (e.g., artifacts).\n */\nexport const CompanionTo = Schema.Struct({\n  id: Obj.ID,\n}).pipe(\n  Type.makeRelation({\n    dxn: DXN.make('org.dxos.relation.assistant.companionTo', '0.1.0'),\n    source: Chat,\n    target: Obj.Unknown,\n  }),\n);\n\nexport type CompanionTo = Type.InstanceType<typeof CompanionTo>;\n"],
+  "mappings": ";;;;;AAAA;;;;;;;AAMA,YAAYA,YAAY;AAExB,SAASC,KAAKC,YAAYC,MAAMC,KAAKC,KAAKC,YAAY;AACtD,SAASC,qBAAqBC,uBAAuB;AAK9C,IAAMC,OAAcC,cAAO;EAChCC,MAAaC,cAAOC,KAAYC,eAAQ;EACxCC,MAAMV,IAAIA,IAAIF,KAAKA,IAAI,EAAEU,KAAKN,oBAAoBS,IAAI,KAAA,CAAA;EACtDC,UAAiBL,cAAOC,KAAYC,eAAQ;AAC9C,CAAA,EAAGD,KACDL,gBAAgBQ,IAAI;EAAC;CAAO,GAC5Bd,WAAWgB,eAAeF,IAAI;EAAEG,MAAM;EAAwBC,KAAK;AAAM,CAAA,GACzEd,KAAKe,WAAWpB,IAAIqB,KAAK,gCAAgC,OAAA,CAAA,CAAA;AAIpD,IAAMA,OAAO,CAACC,UAAsCnB,IAAIkB,KAAKb,MAAMc,KAAAA;AAGnE,IAAMC,oBAA2Bd,cAAO;EAC7Ce,IAAIrB,IAAIsB;AACV,CAAA,EAAGb,KACDP,KAAKqB,aAAa;EAChBC,KAAK3B,IAAIqB,KAAK,2CAA2C,OAAA;EACzDO,QAAQpB;EACRqB,QAAQ1B,IAAI2B;AACd,CAAA,CAAA;AAOK,IAAMC,cAAqBtB,cAAO;EACvCe,IAAIrB,IAAIsB;AACV,CAAA,EAAGb,KACDP,KAAKqB,aAAa;EAChBC,KAAK3B,IAAIqB,KAAK,2CAA2C,OAAA;EACzDO,QAAQpB;EACRqB,QAAQ1B,IAAI2B;AACd,CAAA,CAAA;",
+  "names": ["Schema", "DXN", "Annotation", "Feed", "Obj", "Ref", "Type", "FormInputAnnotation", "LabelAnnotation", "Chat", "Struct", "name", "String", "pipe", "optional", "feed", "set", "viewType", "IconAnnotation", "icon", "hue", "makeObject", "make", "props", "LegacyCompanionTo", "id", "ID", "makeRelation", "dxn", "source", "target", "Unknown", "CompanionTo"]
+}

package/dist/lib/neutral/{chunk-3YH7MWSD.mjs → chunk-KZDQGI3S.mjs}

@@ -1,6 +1,6 @@
 import {
   Agent_exports
-} from "./chunk-URUJQGI6.mjs";
+} from "./chunk-5HANNHZZ.mjs";
 import {
   __export
 } from "./chunk-J5LGTIGS.mjs";
@@ -84,4 +84,4 @@ export {
   SyncTriggers,
   definitions_exports
 };
-//# sourceMappingURL=chunk-3YH7MWSD.mjs.map
+//# sourceMappingURL=chunk-KZDQGI3S.mjs.map

package/dist/lib/neutral/{chunk-JRUTUKPS.mjs → chunk-OK3P6URP.mjs}

@@ -1,6 +1,6 @@
 import {
   AddArtifact
-} from "./chunk-RNIUE4LK.mjs";
+} from "./chunk-CUT6GB2W.mjs";
 
 // src/blueprints/agent/blueprint.ts
 import { Blueprint, Template } from "@dxos/compute";
@@ -59,10 +59,10 @@ var blueprint_default = blueprint;
 
 // src/blueprints/agent/operations/index.ts
 import { OperationHandlerSet } from "@dxos/compute";
-var AgentBlueprintHandlers = OperationHandlerSet.lazy(() => import("./add-artifact-54DVWE53.mjs"), () => import("./agent-LCBDWP74.mjs"), () => import("./get-context-X4FCUMLK.mjs"), () => import("./qualifier-QAW6LSYF.mjs"));
+var AgentBlueprintHandlers = OperationHandlerSet.lazy(() => import("./add-artifact-QEQP6T7Z.mjs"), () => import("./agent-BU6PB7J6.mjs"), () => import("./get-context-6SZ7HOV4.mjs"), () => import("./qualifier-DHPHY3YH.mjs"));
 
 export {
   blueprint_default,
   AgentBlueprintHandlers
 };
-//# sourceMappingURL=chunk-JRUTUKPS.mjs.map
+//# sourceMappingURL=chunk-OK3P6URP.mjs.map

package/dist/lib/neutral/{chunk-BOB6M2YM.mjs → chunk-WTUY5UCA.mjs}

@@ -1,6 +1,6 @@
 import {
   Chat
-} from "./chunk-Z3KITY4U.mjs";
+} from "./chunk-JZHXJBSM.mjs";
 
 // src/functions/agent/definitions.ts
 import * as Schema from "effect/Schema";
@@ -23,7 +23,7 @@ var AgentPrompt = Operation.make({
     */
     chat: Schema.optional(Ref.Ref(Chat)),
     /**
-    * @default ai.claude.model.claude-opus-4-6
+    * @default ai.claude.model.claude-opus-4-8
     */
     model: Schema.optional(ModelName),
     /**
@@ -59,4 +59,4 @@ var AgentPrompt = Operation.make({
 export {
   AgentPrompt
 };
-//# sourceMappingURL=chunk-BOB6M2YM.mjs.map
+//# sourceMappingURL=chunk-WTUY5UCA.mjs.map

package/dist/lib/neutral/{chunk-BOB6M2YM.mjs.map → chunk-WTUY5UCA.mjs.map}

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../src/functions/agent/definitions.ts"],
-  "sourcesContent": ["//\n// Copyright 2025 DXOS.org\n//\n\nimport * as Schema from 'effect/Schema';\n\nimport { AiService, OpaqueToolkit, ModelName } from '@dxos/ai';\nimport { Routine, Trace, Operation } from '@dxos/compute';\nimport { Database, Feed, Ref, Registry } from '@dxos/echo';\nimport { DXN } from '@dxos/keys';\nimport { Text } from '@dxos/schema';\n\nimport * as Chat from '../../types/Chat';\n\n// TODO(dmaretskyi): Rename to RunRoutine.\nexport const AgentPrompt = Operation.make({\n  meta: {\n    key: DXN.make('org.dxos.function.prompt'),\n    name: 'Run Routine',\n    description: 'Agentic worker that executes a provided prompt using blueprints and tools.',\n    icon: 'ph--brain--regular',\n  },\n  input: Schema.Struct({\n    prompt: Ref.Ref(Routine.Routine),\n\n    /**\n     * When set, runs in this chat (history, queue, and bound context). Routine blueprints and context objects are merged into the conversation for this request.\n     */\n    chat: Schema.optional(Ref.Ref(Chat.Chat)),\n\n    /**\n     * @default ai.claude.model.claude-opus-4-6\n     */\n    model: Schema.optional(ModelName),\n\n    /**\n     * Input object or data.\n     * References get auto-resolved.\n     */\n    input: Schema.Any.pipe(Schema.annotations({ title: 'Input' })),\n\n    systemInstructions: Schema.optional(Schema.String).annotations({\n      description: 'Additional system instructions to add to the system prompt.',\n    }),\n  }),\n  output: Schema.Any,\n  // ECHO types that the handler loads via Database.load(). Declaring them here ensures the\n  // runtime registers their schema before remote invocation (e.g. via the EDGE function service).\n  types: [Routine.Routine, Text.Text, Feed.Feed, Chat.Chat],\n  services: [\n    AiService.AiService,\n    Database.Service,\n    Feed.FeedService,\n    OpaqueToolkit.OpaqueToolkitProvider,\n    Registry.Service,\n    Trace.TraceService,\n  ],\n});\n"],
+  "sourcesContent": ["//\n// Copyright 2025 DXOS.org\n//\n\nimport * as Schema from 'effect/Schema';\n\nimport { AiService, OpaqueToolkit, ModelName } from '@dxos/ai';\nimport { Routine, Trace, Operation } from '@dxos/compute';\nimport { Database, Feed, Ref, Registry } from '@dxos/echo';\nimport { DXN } from '@dxos/keys';\nimport { Text } from '@dxos/schema';\n\nimport * as Chat from '../../types/Chat';\n\n// TODO(dmaretskyi): Rename to RunRoutine.\nexport const AgentPrompt = Operation.make({\n  meta: {\n    key: DXN.make('org.dxos.function.prompt'),\n    name: 'Run Routine',\n    description: 'Agentic worker that executes a provided prompt using blueprints and tools.',\n    icon: 'ph--brain--regular',\n  },\n  input: Schema.Struct({\n    prompt: Ref.Ref(Routine.Routine),\n\n    /**\n     * When set, runs in this chat (history, queue, and bound context). Routine blueprints and context objects are merged into the conversation for this request.\n     */\n    chat: Schema.optional(Ref.Ref(Chat.Chat)),\n\n    /**\n     * @default ai.claude.model.claude-opus-4-8\n     */\n    model: Schema.optional(ModelName),\n\n    /**\n     * Input object or data.\n     * References get auto-resolved.\n     */\n    input: Schema.Any.pipe(Schema.annotations({ title: 'Input' })),\n\n    systemInstructions: Schema.optional(Schema.String).annotations({\n      description: 'Additional system instructions to add to the system prompt.',\n    }),\n  }),\n  output: Schema.Any,\n  // ECHO types that the handler loads via Database.load(). Declaring them here ensures the\n  // runtime registers their schema before remote invocation (e.g. via the EDGE function service).\n  types: [Routine.Routine, Text.Text, Feed.Feed, Chat.Chat],\n  services: [\n    AiService.AiService,\n    Database.Service,\n    Feed.FeedService,\n    OpaqueToolkit.OpaqueToolkitProvider,\n    Registry.Service,\n    Trace.TraceService,\n  ],\n});\n"],
   "mappings": ";;;;;AAIA,YAAYA,YAAY;AAExB,SAASC,WAAWC,eAAeC,iBAAiB;AACpD,SAASC,SAASC,OAAOC,iBAAiB;AAC1C,SAASC,UAAUC,MAAMC,KAAKC,gBAAgB;AAC9C,SAASC,WAAW;AACpB,SAASC,YAAY;AAKd,IAAMC,cAAcC,UAAUC,KAAK;EACxCC,MAAM;IACJC,KAAKC,IAAIH,KAAK,0BAAA;IACdI,MAAM;IACNC,aAAa;IACbC,MAAM;EACR;EACAC,OAAcC,cAAO;IACnBC,QAAQC,IAAIA,IAAIC,QAAQA,OAAO;;;;IAK/BC,MAAaC,gBAASH,IAAIA,IAASI,IAAI,CAAA;;;;IAKvCC,OAAcF,gBAASG,SAAAA;;;;;IAMvBT,OAAcU,WAAIC,KAAYC,mBAAY;MAAEC,OAAO;IAAQ,CAAA,CAAA;IAE3DC,oBAA2BR,gBAAgBS,aAAM,EAAEH,YAAY;MAC7Dd,aAAa;IACf,CAAA;EACF,CAAA;EACAkB,QAAeN;;;EAGfO,OAAO;IAACb,QAAQA;IAASc,KAAKA;IAAMC,KAAKA;IAAWZ;;EACpDa,UAAU;IACRC,UAAUA;IACVC,SAASC;IACTJ,KAAKK;IACLC,cAAcC;IACdC,SAASJ;IACTK,MAAMC;;AAEV,CAAA;",
   "names": ["Schema", "AiService", "OpaqueToolkit", "ModelName", "Routine", "Trace", "Operation", "Database", "Feed", "Ref", "Registry", "DXN", "Text", "AgentPrompt", "Operation", "make", "meta", "key", "DXN", "name", "description", "icon", "input", "Struct", "prompt", "Ref", "Routine", "chat", "optional", "Chat", "model", "ModelName", "Any", "pipe", "annotations", "title", "systemInstructions", "String", "output", "types", "Text", "Feed", "services", "AiService", "Database", "Service", "FeedService", "OpaqueToolkit", "OpaqueToolkitProvider", "Registry", "Trace", "TraceService"]
 }

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

@@ -0,0 +1,97 @@
+import {
+  Agent_exports,
+  Plan_exports
+} from "./chunk-5HANNHZZ.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.
+      Provide either \`id\` (an existing plan task from update-tasks) or \`title\` (to create a new task).
+      Marks the task in-progress and delegated so the supervisor spawns a background sub-agent.
+    `,
+    icon: "ph--share-network--regular"
+  },
+  input: Schema.Struct({
+    id: Schema.optional(Plan_exports.TaskId).annotations({
+      description: "Id of an existing plan task to delegate (from update-tasks)."
+    }),
+    title: Schema.optional(Schema.String).annotations({
+      description: "Title for a new task to create and delegate. Omit when delegating by id."
+    })
+  }),
+  output: Schema.Any,
+  services: [
+    AiContext.Service,
+    Database.Service
+  ]
+});
+var delegate_task_default = DelegateTask.pipe(Operation.withHandler(Effect.fn(function* ({ id, title }) {
+  const hasId = id !== void 0;
+  const hasTitle = title !== void 0 && title.length > 0;
+  if (hasId === hasTitle) {
+    return yield* Effect.fail(new Error("Provide exactly one of `id` (existing plan task) or `title` (new task to create)."));
+  }
+  const agent = yield* Agent_exports.getFromChatContext;
+  const plan = yield* Database.load(agent.plan);
+  if (hasId) {
+    const existing = plan.tasks.find((task) => task.id === id);
+    if (!existing) {
+      return yield* Effect.fail(new Error(`Plan task not found: ${id}`));
+    }
+    if (existing.status === "done" || existing.status === "failed") {
+      return yield* Effect.fail(new Error(`Plan task "${id}" is already ${existing.status} and cannot be delegated.`));
+    }
+    Obj.update(plan, (plan2) => {
+      const task = plan2.tasks.find((task2) => task2.id === id);
+      if (task) {
+        task.delegated = true;
+        task.status = "in-progress";
+      }
+    });
+  } else {
+    if (title === void 0) {
+      return yield* Effect.fail(new Error("Provide exactly one of `id` (existing plan task) or `title` (new task to create)."));
+    }
+    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-ZA5WZL4H.mjs.map

package/dist/lib/neutral/chunk-ZA5WZL4H.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      Provide either \\`id\\` (an existing plan task from update-tasks) or \\`title\\` (to create a new task).\n      Marks the task in-progress and delegated so the supervisor spawns a background sub-agent.\n    `,\n    icon: 'ph--share-network--regular',\n  },\n  input: Schema.Struct({\n    id: Schema.optional(Plan.TaskId).annotations({\n      description: 'Id of an existing plan task to delegate (from update-tasks).',\n    }),\n    title: Schema.optional(Schema.String).annotations({\n      description: 'Title for a new task to create and delegate. Omit when delegating by id.',\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* ({ id, title }) {\n      const hasId = id !== undefined;\n      const hasTitle = title !== undefined && title.length > 0;\n      if (hasId === hasTitle) {\n        return yield* Effect.fail(\n          new Error('Provide exactly one of `id` (existing plan task) or `title` (new task to create).'),\n        );\n      }\n\n      const agent = yield* Agent.getFromChatContext;\n      const plan = yield* Database.load(agent.plan);\n\n      if (hasId) {\n        const existing = plan.tasks.find((task) => task.id === id);\n        if (!existing) {\n          return yield* Effect.fail(new Error(`Plan task not found: ${id}`));\n        }\n        if (existing.status === 'done' || existing.status === 'failed') {\n          return yield* Effect.fail(\n            new Error(`Plan task \"${id}\" is already ${existing.status} and cannot be delegated.`),\n          );\n        }\n\n        Obj.update(plan, (plan) => {\n          const task = plan.tasks.find((task) => task.id === id);\n          if (task) {\n            task.delegated = true;\n            task.status = 'in-progress';\n          }\n        });\n      } else {\n        if (title === undefined) {\n          return yield* Effect.fail(\n            new Error('Provide exactly one of `id` (existing plan task) or `title` (new task to create).'),\n          );\n        }\n        Obj.update(plan, (plan) => {\n          Plan.addTasks(plan, [{ title, status: 'in-progress', delegated: true }]);\n        });\n      }\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,IAAWC,gBAASC,aAAKC,MAAM,EAAEC,YAAY;MAC3CT,aAAa;IACf,CAAA;IACAU,OAAcJ,gBAAgBK,aAAM,EAAEF,YAAY;MAChDT,aAAa;IACf,CAAA;EACF,CAAA;EACAY,QAAeC;EACfC,UAAU;IAACC,UAAUC;IAASC,SAASD;;AACzC,CAAA;AAKA,IAAA,wBAAevB,aAAayB,KAC1BxB,UAAUyB,YACDC,UAAG,WAAW,EAAEf,IAAIK,MAAK,GAAE;AAChC,QAAMW,QAAQhB,OAAOiB;AACrB,QAAMC,WAAWb,UAAUY,UAAaZ,MAAMc,SAAS;AACvD,MAAIH,UAAUE,UAAU;AACtB,WAAO,OAAcE,YACnB,IAAIC,MAAM,mFAAA,CAAA;EAEd;AAEA,QAAMC,QAAQ,OAAOC,cAAMC;AAC3B,QAAMC,OAAO,OAAOb,SAASc,KAAKJ,MAAMG,IAAI;AAE5C,MAAIT,OAAO;AACT,UAAMW,WAAWF,KAAKG,MAAMC,KAAK,CAACC,SAASA,KAAK9B,OAAOA,EAAAA;AACvD,QAAI,CAAC2B,UAAU;AACb,aAAO,OAAcP,YAAK,IAAIC,MAAM,wBAAwBrB,EAAAA,EAAI,CAAA;IAClE;AACA,QAAI2B,SAASI,WAAW,UAAUJ,SAASI,WAAW,UAAU;AAC9D,aAAO,OAAcX,YACnB,IAAIC,MAAM,cAAcrB,EAAAA,gBAAkB2B,SAASI,MAAM,2BAA2B,CAAA;IAExF;AAEAC,QAAIC,OAAOR,MAAM,CAACA,UAAAA;AAChB,YAAMK,OAAOL,MAAKG,MAAMC,KAAK,CAACC,UAASA,MAAK9B,OAAOA,EAAAA;AACnD,UAAI8B,MAAM;AACRA,aAAKI,YAAY;AACjBJ,aAAKC,SAAS;MAChB;IACF,CAAA;EACF,OAAO;AACL,QAAI1B,UAAUY,QAAW;AACvB,aAAO,OAAcG,YACnB,IAAIC,MAAM,mFAAA,CAAA;IAEd;AACAW,QAAIC,OAAOR,MAAM,CAACA,UAAAA;AAChBvB,mBAAKiC,SAASV,OAAM;QAAC;UAAEpB;UAAO0B,QAAQ;UAAeG,WAAW;QAAK;OAAE;IACzE,CAAA;EACF;AAEA,SAAOtC;;;YAGDM,aAAKkC,WAAWX,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", "id", "optional", "Plan", "TaskId", "annotations", "title", "String", "output", "Any", "services", "AiContext", "Service", "Database", "pipe", "withHandler", "fn", "hasId", "undefined", "hasTitle", "length", "fail", "Error", "agent", "Agent", "getFromChatContext", "plan", "load", "existing", "tasks", "find", "task", "status", "Obj", "update", "delegated", "addTasks", "formatPlan"]
+}

package/dist/lib/neutral/{create-agent-KUTBEXLJ.mjs → create-agent-7PBQFYHF.mjs}

@@ -1,15 +1,15 @@
 import {
   blueprint_default
-} from "./chunk-JRUTUKPS.mjs";
+} from "./chunk-OK3P6URP.mjs";
 import {
   CreateAgent,
   SyncTriggers
-} from "./chunk-3YH7MWSD.mjs";
-import "./chunk-RNIUE4LK.mjs";
+} from "./chunk-KZDQGI3S.mjs";
+import "./chunk-CUT6GB2W.mjs";
 import {
   Agent_exports
-} from "./chunk-URUJQGI6.mjs";
-import "./chunk-Z3KITY4U.mjs";
+} from "./chunk-5HANNHZZ.mjs";
+import "./chunk-JZHXJBSM.mjs";
 import "./chunk-SYUTQPSB.mjs";
 import "./chunk-J5LGTIGS.mjs";
 
@@ -32,4 +32,4 @@ var create_agent_default = CreateAgent.pipe(Operation.withHandler(Effect.fnUntra
 export {
   create_agent_default as default
 };
-//# sourceMappingURL=create-agent-KUTBEXLJ.mjs.map
+//# sourceMappingURL=create-agent-7PBQFYHF.mjs.map

package/dist/lib/neutral/{definitions-6HU2P7R7.mjs → definitions-BHRGH45G.mjs}

@@ -3,9 +3,9 @@ import {
   AgentWorker,
   GetContext,
   Qualifier
-} from "./chunk-RNIUE4LK.mjs";
-import "./chunk-URUJQGI6.mjs";
-import "./chunk-Z3KITY4U.mjs";
+} from "./chunk-CUT6GB2W.mjs";
+import "./chunk-5HANNHZZ.mjs";
+import "./chunk-JZHXJBSM.mjs";
 import "./chunk-SYUTQPSB.mjs";
 import "./chunk-J5LGTIGS.mjs";
 export {
@@ -14,4 +14,4 @@ export {
   GetContext,
   Qualifier
 };
-//# sourceMappingURL=definitions-6HU2P7R7.mjs.map
+//# sourceMappingURL=definitions-BHRGH45G.mjs.map

package/dist/lib/neutral/{delegate-task-E7WLHT6S.mjs → delegate-task-IQJSRLN3.mjs}

@@ -1,13 +1,13 @@
 import {
   DelegateTask,
   delegate_task_default
-} from "./chunk-U5FCQXA2.mjs";
-import "./chunk-URUJQGI6.mjs";
-import "./chunk-Z3KITY4U.mjs";
+} from "./chunk-ZA5WZL4H.mjs";
+import "./chunk-5HANNHZZ.mjs";
+import "./chunk-JZHXJBSM.mjs";
 import "./chunk-SYUTQPSB.mjs";
 import "./chunk-J5LGTIGS.mjs";
 export {
   DelegateTask,
   delegate_task_default as default
 };
-//# sourceMappingURL=delegate-task-E7WLHT6S.mjs.map
+//# sourceMappingURL=delegate-task-IQJSRLN3.mjs.map

package/dist/lib/neutral/{get-context-X4FCUMLK.mjs → get-context-6SZ7HOV4.mjs}

@@ -1,11 +1,11 @@
 import {
   GetContext
-} from "./chunk-RNIUE4LK.mjs";
+} from "./chunk-CUT6GB2W.mjs";
 import {
   Agent_exports,
   Plan_exports
-} from "./chunk-URUJQGI6.mjs";
-import "./chunk-Z3KITY4U.mjs";
+} from "./chunk-5HANNHZZ.mjs";
+import "./chunk-JZHXJBSM.mjs";
 import "./chunk-SYUTQPSB.mjs";
 import "./chunk-J5LGTIGS.mjs";
 
@@ -46,4 +46,4 @@ var get_context_default = GetContext.pipe(Operation.withHandler(Effect.fnUntrace
 export {
   get_context_default as default
 };
-//# sourceMappingURL=get-context-X4FCUMLK.mjs.map
+//# sourceMappingURL=get-context-6SZ7HOV4.mjs.map