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

package/src/blueprints/planning/operations/update-tasks.ts

@@ -14,9 +14,10 @@ import { trim } from '@dxos/util';
 import { Plan, Agent } from '../../../types';
 import INSTRUCTIONS from './update-tasks.md?raw';
 
-// Omit `delegated` (and `chat`) from the LLM-facing schema: delegation is set only by the
-// delegation tool, never by ordinary planning, and keeping it out leaves the tool schema unchanged.
-const SimpleTask = Plan.Task.omit('chat', 'delegated');
+// Omit `chat`, `delegated`, and `agentPid` from the LLM-facing schema: these are set by the
+// delegation tool / runtime, never by ordinary planning, and keeping them out leaves the tool
+// schema unchanged.
+const SimpleTask = Plan.Task.omit('chat', 'delegated', 'agentPid');
 
 export const UpdateTasks = Operation.make({
   meta: {

package/src/functions/agent/definitions.ts

@@ -29,7 +29,7 @@ export const AgentPrompt = Operation.make({
     chat: Schema.optional(Ref.Ref(Chat.Chat)),
 
     /**
-     * @default ai.claude.model.claude-opus-4-6
+     * @default ai.claude.model.claude-opus-4-8
      */
     model: Schema.optional(ModelName),
 

package/src/functions/agent/prompt.conversations.json

@@ -1 +1 @@
-{"conversations":[{"parameters":{"model":"ai.claude.model.claude-opus-4-6","stream":true,"tools":[{"name":"completeJob","inputSchema":{"type":"object","required":[],"properties":{"success":{"$id":"/schemas/any","title":"any"},"failure":{"type":"object","required":["message"],"properties":{"message":{"type":"string","description":"Short message describing the error."},"description":{"type":"string","description":"Optional longer message describing in detail what went wrong"}},"additionalProperties":false}},"additionalProperties":false}}]},"prompt":{"content":[{"role":"system","content":"You are an agent running in the non-interactive mode.\nThe user is unable to see what you are doing, and cannot answer any questions.\nDo not ask questions.\nComplete the task before you, and at the end call [completeJob] with the output.\nIf you are unable to complete the task, call [completeJob] with the failure reason.\nIf no output is required, call [completeJob] with an empty object: {}\nDo not stop until you call [completeJob].","options":{}},{"role":"user","content":"Reply with a single word: ack.\n<input>{}</input>","options":{"anthropic":{"cacheControl":{"ttl":"5m","type":"ephemeral"}}}}]},"response":[{"type":"response-metadata","id":"msg_01JstbpndWJDAhVwAppVJz2H","modelId":"claude-opus-4-6","timestamp":"1970-01-01T00:00:00.000Z","metadata":{}},{"type":"reasoning-start","id":"0","metadata":{}},{"type":"reasoning-delta","id":"0","delta":"The user wants me to reply with a single word: \"ack\".","metadata":{}},{"type":"reasoning-delta","id":"0","delta":"","metadata":{"anthropic":{"type":"thinking","signature":"EvsBCmMIDhgCKkDoETBa+lesagv7ixB9LGrYHpBYfS/DCnRnegAetRGGWDl0kkFyqVQI7oDc+ZWbyk9tB+4ePqoqNXQXwE3240/HMg9jbGF1ZGUtb3B1cy00LTY4AEIIdGhpbmtpbmcSDFVIZlew/AFp1rmNoxoMPw+kyp+9hoNL5WyHIjDdm7hZK7hOH93slrwJoeXIuYMlv70L5mOQbDviNfFQyGfbuluo3tzWampRVGtohCgqRtiIkY7cWA700K9SVqH4mMfq1sjQ7yYuCRMv2lT7PrbCp3IRJmncUU6avNwBVX6E/hMO7ml/pORVNgsnB8Tn6FrYKqMFENAYAQ=="}}},{"type":"reasoning-end","id":"0","metadata":{}},{"type":"tool-params-start","id":"toolu_01KDviPNKjzY2nh9cGmo4oKm","name":"completeJob","providerExecuted":false,"metadata":{}},{"type":"tool-params-delta","id":"toolu_01KDviPNKjzY2nh9cGmo4oKm","delta":"","metadata":{}},{"type":"tool-params-delta","id":"toolu_01KDviPNKjzY2nh9cGmo4oKm","delta":"{\"success\"","metadata":{}},{"type":"tool-params-delta","id":"toolu_01KDviPNKjzY2nh9cGmo4oKm","delta":": ","metadata":{}},{"type":"tool-params-delta","id":"toolu_01KDviPNKjzY2nh9cGmo4oKm","delta":"\"ack\"}","metadata":{}},{"type":"tool-params-end","id":"toolu_01KDviPNKjzY2nh9cGmo4oKm","metadata":{}},{"type":"finish","reason":"tool-calls","usage":{"inputTokens":757,"outputTokens":85,"totalTokens":842},"metadata":{"anthropic":{"usage":{"cache_creation":{"ephemeral_1h_input_tokens":0,"ephemeral_5m_input_tokens":0},"cache_creation_input_tokens":0,"cache_read_input_tokens":0,"input_tokens":757,"output_tokens":60,"server_tool_use":null,"service_tier":"standard"}}}}]},{"parameters":{"model":"ai.claude.model.claude-opus-4-6","stream":true,"tools":[{"name":"completeJob","inputSchema":{"type":"object","required":[],"properties":{"success":{"$id":"/schemas/any","title":"any"},"failure":{"type":"object","required":["message"],"properties":{"message":{"type":"string","description":"Short message describing the error."},"description":{"type":"string","description":"Optional longer message describing in detail what went wrong"}},"additionalProperties":false}},"additionalProperties":false}}]},"prompt":{"content":[{"role":"system","content":"You are an agent running in the non-interactive mode.\nThe user is unable to see what you are doing, and cannot answer any questions.\nDo not ask questions.\nComplete the task before you, and at the end call [completeJob] with the output.\nIf you are unable to complete the task, call [completeJob] with the failure reason.\nIf no output is required, call [completeJob] with an empty object: {}\nDo not stop until you call [completeJob].","options":{}},{"role":"user","content":"Reply with a single word: ack.\n<input>{}</input>","options":{}},{"role":"assistant","content":[{"type":"reasoning","text":"The user wants me to reply with a single word: \"ack\".","options":{}},{"type":"tool-call","id":"toolu_01KDviPNKjzY2nh9cGmo4oKm","name":"completeJob","params":{"success":"ack"},"providerExecuted":false,"options":{}}],"options":{}},{"role":"tool","content":[{"type":"tool-result","id":"toolu_01KDviPNKjzY2nh9cGmo4oKm","name":"completeJob","isFailure":false,"result":{},"providerExecuted":false,"options":{}}],"options":{"anthropic":{"cacheControl":{"ttl":"5m","type":"ephemeral"}}}}]},"response":[{"type":"response-metadata","id":"msg_01Pz14sZtxk8PRuR9CKbe7Fy","modelId":"claude-opus-4-6","timestamp":"1970-01-01T00:00:00.000Z","metadata":{}},{"type":"finish","reason":"stop","usage":{"inputTokens":824,"outputTokens":2,"totalTokens":826},"metadata":{"anthropic":{"usage":{"cache_creation":{"ephemeral_1h_input_tokens":0,"ephemeral_5m_input_tokens":0},"cache_creation_input_tokens":0,"cache_read_input_tokens":0,"input_tokens":824,"output_tokens":2,"server_tool_use":null,"service_tier":"standard"}}}}]}]}
+{"conversations":[{"parameters":{"model":"ai.claude.model.claude-opus-4-6","stream":true,"tools":[{"name":"completeJob","inputSchema":{"type":"object","required":[],"properties":{"success":{"$id":"/schemas/any","title":"any"},"failure":{"type":"object","required":["message"],"properties":{"message":{"type":"string","description":"Short message describing the error."},"description":{"type":"string","description":"Optional longer message describing in detail what went wrong"}},"additionalProperties":false}},"additionalProperties":false}}]},"prompt":{"content":[{"role":"system","content":"You are an agent running in the non-interactive mode.\nThe user is unable to see what you are doing, and cannot answer any questions.\nDo not ask questions.\nComplete the task before you, and at the end call [completeJob] with the output.\nIf you are unable to complete the task, call [completeJob] with the failure reason.\nIf no output is required, call [completeJob] with an empty object: {}\nDo not stop until you call [completeJob].","options":{}},{"role":"user","content":"Reply with a single word: ack.\n<input>{}</input>","options":{"anthropic":{"cacheControl":{"ttl":"5m","type":"ephemeral"}}}}]},"response":[{"type":"response-metadata","id":"msg_011XBspJo8qpA74ASw5uEdDn","modelId":"claude-opus-4-6","timestamp":"1970-01-01T00:00:00.000Z","metadata":{}},{"type":"reasoning-start","id":"0","metadata":{}},{"type":"reasoning-delta","id":"0","delta":"The user wants me to reply with a single word \"ack\" and complete the job.","metadata":{}},{"type":"reasoning-delta","id":"0","delta":"","metadata":{"anthropic":{"type":"thinking","signature":"Eo8CCmMIDhgCKkDmvWuElJmvgQqKv/OM8h45Qm9vFiau8OtHTiKeFGzABfFt5k5Oc9XiWXg1jeCrSXFmAcI3XEaKXp6jF8PCj/O0Mg9jbGF1ZGUtb3B1cy00LTY4AEIIdGhpbmtpbmcSDJLLuLKNtiWzw7pLSxoMVS5+G0m2Rt90uT/BIjDHn93ko70QlooeTV4Dfqhzvh3iIOfFQSt2vGX3dLIl4vErRKSzNfAGaI0f3Se9POgqWmqghiUovsd6FCGPEP+fypxFkW0ljAzvkRZElLL1koC0efkHJXq7+BLOE5LqBCe+kl/Sd22oz6dpOJis0l06/ffWB/VmRLbouqvk9I8W3+bqLYd/MJanUuthpBgB"}}},{"type":"reasoning-end","id":"0","metadata":{}},{"type":"tool-params-start","id":"toolu_018phiRmk3xRDvMqXkqaVTo2","name":"completeJob","providerExecuted":false,"metadata":{}},{"type":"tool-params-delta","id":"toolu_018phiRmk3xRDvMqXkqaVTo2","delta":"","metadata":{}},{"type":"tool-params-delta","id":"toolu_018phiRmk3xRDvMqXkqaVTo2","delta":"{\"success\"","metadata":{}},{"type":"tool-params-delta","id":"toolu_018phiRmk3xRDvMqXkqaVTo2","delta":": \"ack\"}","metadata":{}},{"type":"tool-params-end","id":"toolu_018phiRmk3xRDvMqXkqaVTo2","metadata":{}},{"type":"finish","reason":"tool-calls","usage":{"inputTokens":757,"outputTokens":89,"totalTokens":846},"metadata":{"anthropic":{"usage":{"cache_creation":{"ephemeral_1h_input_tokens":0,"ephemeral_5m_input_tokens":0},"cache_creation_input_tokens":0,"cache_read_input_tokens":0,"input_tokens":757,"output_tokens":43,"server_tool_use":null,"service_tier":"standard"}}}}]},{"parameters":{"model":"ai.claude.model.claude-opus-4-6","stream":true,"tools":[{"name":"completeJob","inputSchema":{"type":"object","required":[],"properties":{"success":{"$id":"/schemas/any","title":"any"},"failure":{"type":"object","required":["message"],"properties":{"message":{"type":"string","description":"Short message describing the error."},"description":{"type":"string","description":"Optional longer message describing in detail what went wrong"}},"additionalProperties":false}},"additionalProperties":false}}]},"prompt":{"content":[{"role":"system","content":"You are an agent running in the non-interactive mode.\nThe user is unable to see what you are doing, and cannot answer any questions.\nDo not ask questions.\nComplete the task before you, and at the end call [completeJob] with the output.\nIf you are unable to complete the task, call [completeJob] with the failure reason.\nIf no output is required, call [completeJob] with an empty object: {}\nDo not stop until you call [completeJob].","options":{}},{"role":"user","content":"Reply with a single word: ack.\n<input>{}</input>","options":{}},{"role":"assistant","content":[{"type":"reasoning","text":"The user wants me to reply with a single word \"ack\" and complete the job.","options":{}},{"type":"tool-call","id":"toolu_018phiRmk3xRDvMqXkqaVTo2","name":"completeJob","params":{"success":"ack"},"providerExecuted":false,"options":{}}],"options":{}},{"role":"tool","content":[{"type":"tool-result","id":"toolu_018phiRmk3xRDvMqXkqaVTo2","name":"completeJob","isFailure":false,"result":{},"providerExecuted":false,"options":{}}],"options":{"anthropic":{"cacheControl":{"ttl":"5m","type":"ephemeral"}}}}]},"response":[{"type":"response-metadata","id":"msg_0167q8hG371zH6naFSmJTKnL","modelId":"claude-opus-4-6","timestamp":"1970-01-01T00:00:00.000Z","metadata":{}},{"type":"finish","reason":"stop","usage":{"inputTokens":824,"outputTokens":2,"totalTokens":826},"metadata":{"anthropic":{"usage":{"cache_creation":{"ephemeral_1h_input_tokens":0,"ephemeral_5m_input_tokens":0},"cache_creation_input_tokens":0,"cache_read_input_tokens":0,"input_tokens":824,"output_tokens":2,"server_tool_use":null,"service_tier":"standard"}}}}]},{"parameters":{"model":"ai.claude.model.claude-opus-4-8","stream":true,"tools":[{"name":"completeJob","inputSchema":{"type":"object","required":[],"properties":{"success":{"$id":"/schemas/any","title":"any"},"failure":{"type":"object","required":["message"],"properties":{"message":{"type":"string","description":"Short message describing the error."},"description":{"type":"string","description":"Optional longer message describing in detail what went wrong"}},"additionalProperties":false}},"additionalProperties":false}}]},"prompt":{"content":[{"role":"system","content":"You are an agent running in the non-interactive mode.\nThe user is unable to see what you are doing, and cannot answer any questions.\nDo not ask questions.\nComplete the task before you, and at the end call [completeJob] with the output.\nIf you are unable to complete the task, call [completeJob] with the failure reason.\nIf no output is required, call [completeJob] with an empty object: {}\nDo not stop until you call [completeJob].","options":{}},{"role":"user","content":"Reply with a single word: ack.\n<input>{}</input>","options":{"anthropic":{"cacheControl":{"ttl":"5m","type":"ephemeral"}}}}]},"response":[{"type":"response-metadata","id":"msg_015BQWUzrZFZMyJcjKfHsF5F","modelId":"claude-opus-4-8","timestamp":"1970-01-01T00:00:00.000Z","metadata":{}},{"type":"text-start","id":"0","metadata":{}},{"type":"text-delta","id":"0","delta":"ack","metadata":{}},{"type":"text-end","id":"0","metadata":{}},{"type":"tool-params-start","id":"toolu_0133KXrwo8bGDYrsoVKDsY1S","name":"completeJob","providerExecuted":false,"metadata":{}},{"type":"tool-params-delta","id":"toolu_0133KXrwo8bGDYrsoVKDsY1S","delta":"","metadata":{}},{"type":"tool-params-delta","id":"toolu_0133KXrwo8bGDYrsoVKDsY1S","delta":"{\"succ","metadata":{}},{"type":"tool-params-delta","id":"toolu_0133KXrwo8bGDYrsoVKDsY1S","delta":"ess\": \"ack\"}","metadata":{}},{"type":"tool-params-end","id":"toolu_0133KXrwo8bGDYrsoVKDsY1S","metadata":{}},{"type":"finish","reason":"tool-calls","usage":{"inputTokens":624,"outputTokens":52,"totalTokens":676},"metadata":{"anthropic":{"usage":{"cache_creation":{"ephemeral_1h_input_tokens":0,"ephemeral_5m_input_tokens":0},"cache_creation_input_tokens":0,"cache_read_input_tokens":0,"input_tokens":624,"output_tokens":4,"server_tool_use":null,"service_tier":"standard"}}}}]},{"parameters":{"model":"ai.claude.model.claude-opus-4-8","stream":true,"tools":[{"name":"completeJob","inputSchema":{"type":"object","required":[],"properties":{"success":{"$id":"/schemas/any","title":"any"},"failure":{"type":"object","required":["message"],"properties":{"message":{"type":"string","description":"Short message describing the error."},"description":{"type":"string","description":"Optional longer message describing in detail what went wrong"}},"additionalProperties":false}},"additionalProperties":false}}]},"prompt":{"content":[{"role":"system","content":"You are an agent running in the non-interactive mode.\nThe user is unable to see what you are doing, and cannot answer any questions.\nDo not ask questions.\nComplete the task before you, and at the end call [completeJob] with the output.\nIf you are unable to complete the task, call [completeJob] with the failure reason.\nIf no output is required, call [completeJob] with an empty object: {}\nDo not stop until you call [completeJob].","options":{}},{"role":"user","content":"Reply with a single word: ack.\n<input>{}</input>","options":{}},{"role":"assistant","content":[{"type":"text","text":"ack","options":{}},{"type":"tool-call","id":"toolu_0133KXrwo8bGDYrsoVKDsY1S","name":"completeJob","params":{"success":"ack"},"providerExecuted":false,"options":{}}],"options":{}},{"role":"tool","content":[{"type":"tool-result","id":"toolu_0133KXrwo8bGDYrsoVKDsY1S","name":"completeJob","isFailure":false,"result":{},"providerExecuted":false,"options":{}}],"options":{"anthropic":{"cacheControl":{"ttl":"5m","type":"ephemeral"}}}}]},"response":[{"type":"response-metadata","id":"msg_01CriLe6LPTyJWJQvVN3WvMq","modelId":"claude-opus-4-8","timestamp":"1970-01-01T00:00:00.000Z","metadata":{}},{"type":"text-start","id":"0","metadata":{}},{"type":"text-delta","id":"0","delta":"ack","metadata":{}},{"type":"text-end","id":"0","metadata":{}},{"type":"finish","reason":"stop","usage":{"inputTokens":683,"outputTokens":4,"totalTokens":687},"metadata":{"anthropic":{"usage":{"cache_creation":{"ephemeral_1h_input_tokens":0,"ephemeral_5m_input_tokens":0},"cache_creation_input_tokens":0,"cache_read_input_tokens":0,"input_tokens":683,"output_tokens":4,"server_tool_use":null,"service_tier":"standard"}}}}]}]}

package/src/functions/agent/prompt.ts

@@ -28,7 +28,7 @@ import { PromptError } from '../../errors';
 import * as Chat from '../../types/Chat';
 import { AgentPrompt } from './definitions';
 
-const DEFAULT_MODEL: ModelName = 'ai.claude.model.claude-opus-4-6';
+const DEFAULT_MODEL: ModelName = 'ai.claude.model.claude-opus-4-8';
 
 export default AgentPrompt.pipe(
   Operation.withHandler(

package/src/supervisor/delegation-strategy.ts

@@ -128,7 +128,14 @@ export const makeDelegationStrategy = (): DelegationStrategy => ({
           spawn: Effect.gen(function* () {
             const invoker = yield* ProcessManager.ProcessOperationInvoker.Service;
             const fiber = yield* invoker.invokeFiber(AgentPrompt, { prompt: Ref.make(routine), input: {} });
-            return fiber.pid;
+            const pid = fiber.pid;
+            Obj.update(plan, (plan) => {
+              const taskRecord = plan.tasks.find((taskRecord) => taskRecord.id === task.id);
+              if (taskRecord) {
+                taskRecord.agentPid = pid;
+              }
+            });
+            return pid;
           }),
         });
       }

package/src/supervisor/index.ts

@@ -3,3 +3,4 @@
 //
 
 export * from './delegation-strategy';
+export * from './plan-completion-guard';

package/src/supervisor/plan-completion-guard.ts

@@ -0,0 +1,50 @@
+//
+// Copyright 2026 DXOS.org
+//
+
+import * as Effect from 'effect/Effect';
+
+import { Database, Feed, Filter } from '@dxos/echo';
+import { type CompletionGuard } from '@dxos/functions-runtime';
+
+import { Agent, Plan } from '../types';
+
+const findAgentForFeed = (feed: Feed.Feed): Effect.Effect<Agent.Agent | undefined, never, Database.Service> =>
+  Effect.gen(function* () {
+    const agents = yield* Database.query(Filter.type(Agent.Agent)).run;
+    for (const agent of agents) {
+      if (!agent.chat) {
+        continue;
+      }
+      const matches = yield* Effect.gen(function* () {
+        const chat = yield* Database.load(agent.chat!);
+        const chatFeed = yield* Database.load(chat.feed);
+        return chatFeed.id === feed.id;
+      }).pipe(Effect.orElseSucceed(() => false));
+      if (matches) {
+        return agent;
+      }
+    }
+    return undefined;
+  });
+
+const hasIncompleteTasks = (plan: Plan.Plan): boolean =>
+  plan.tasks.some((task) => task.status === 'todo' || task.status === 'in-progress');
+
+/**
+ * Returns a markdown plan summary when the conversation's agent still has open plan tasks.
+ */
+export const makePlanCompletionGuard = (): CompletionGuard => ({
+  getIncompletePlanSummary: (feed) =>
+    Effect.gen(function* () {
+      const agent = yield* findAgentForFeed(feed);
+      if (!agent?.plan) {
+        return undefined;
+      }
+      const plan = yield* Database.load(agent.plan).pipe(Effect.orElseSucceed(() => undefined));
+      if (!plan || !hasIncompleteTasks(plan)) {
+        return undefined;
+      }
+      return Plan.formatPlan(plan);
+    }),
+});

package/src/testing/plugins.tsx

@@ -7,6 +7,7 @@ import React from 'react';
 
 import { Capabilities, Capability } from '@dxos/app-framework';
 import { Surface } from '@dxos/app-framework/ui';
+import { AppSurface } from '@dxos/app-toolkit/ui';
 import { DXN, Format, type Obj, Type } from '@dxos/echo';
 import { Card } from '@dxos/react-ui';
 import { Syntax } from '@dxos/react-ui-syntax-highlighter';
@@ -30,32 +31,12 @@ declare global {
   }
 }
 
-// TODO(dmaretskyi): Removed images from conductor GPT implementation.
-const isImage = (data: any): data is any => false;
-
 export const capabilities: Capability.Any[] = [
-  Capability.contributes(
-    Capabilities.ReactSurface,
-    Surface.create({
-      id: 'pluginImage',
-      role: 'card--content',
-      filter: (data: any): data is any => isImage(data.value),
-      component: ({ data }) => (
-        <Card.Body>
-          <img
-            className='grow object-cover'
-            src={`data:image/jpeg;base64,${data.value.source.data}`}
-            alt={data.value.prompt ?? `Generated image [id=${data.value.id}]`}
-          />
-        </Card.Body>
-      ),
-    }),
-  ),
   Capability.contributes(
     Capabilities.ReactSurface,
     Surface.create({
       id: 'pluginDefault',
-      role: 'card--content',
+      filter: Surface.makeFilter(AppSurface.CardContent),
       position: 'last',
       component: ({ data }) => (
         <Card.Body>

package/src/types/Chat.ts

@@ -15,7 +15,7 @@ import { FormInputAnnotation, LabelAnnotation } from '@dxos/echo/Annotation';
 export const 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({ icon: 'ph--sparkle--regular', hue: 'sky' }),

package/src/types/Plan.ts

@@ -6,6 +6,7 @@
 
 import * as Schema from 'effect/Schema';
 
+import { Process } from '@dxos/compute';
 import { DXN, Annotation, Obj, Ref, Type } from '@dxos/echo';
 
 import * as Chat from './Chat';
@@ -32,6 +33,13 @@ export const 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.
    */
@@ -46,6 +54,12 @@ export const Task = Schema.Struct({
 });
 
 export type Task = Schema.Schema.Type<typeof Task>;
+
+/**
+ * Short tag label for a delegated sub-agent process id (e.g. `agent-a1b2`).
+ */
+export const formatAgentPidTag = (pid: Process.ID): string => `agent-${String(pid).replaceAll('-', '').slice(0, 4)}`;
+
 /**
  * Hierarchical collection of tasks for humans and agents to track progress.
  */

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

@@ -1,7 +0,0 @@
-{
-  "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-U5FCQXA2.mjs

@@ -1,69 +0,0 @@
-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

@@ -1,7 +0,0 @@
-{
-  "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"]
-}

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

@@ -1,7 +0,0 @@
-{
-  "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 { 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   * 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 * 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", "DXN", "Annotation", "Obj", "Ref", "Type", "TaskId", "String", "pipe", "brand", "Task", "Struct", "id", "title", "annotations", "description", "status", "Literal", "delegated", "optional", "Boolean", "parent", "chat", "Ref", "Chat", "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", "slice", "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-Z3KITY4U.mjs.map

@@ -1,7 +0,0 @@
-{
-  "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  view: 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,MAAaL,cAAOC,KAAYC,eAAQ;AAC1C,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", "view", "IconAnnotation", "icon", "hue", "makeObject", "make", "props", "LegacyCompanionTo", "id", "ID", "makeRelation", "dxn", "source", "target", "Unknown", "CompanionTo"]
-}

package/src/blueprints/blueprint-manager/blueprint.conversations.json

@@ -1 +0,0 @@
-{"conversations":[{"parameters":{"model":"ai.claude.model.claude-opus-4-6","stream":true,"tools":[{"name":"query-blueprints","description":"Queries available blueprints.","inputSchema":{"$id":"/schemas/%7B%7D","anyOf":[{"type":"object"},{"type":"array"}]}},{"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.","inputSchema":{"type":"object","required":["keys"],"properties":{"keys":{"type":"array","items":{"type":"string"},"description":"The keys of the blueprints to enable.","examples":[["org.dxos.blueprint.memory","org.dxos.blueprint.database"]]}},"additionalProperties":false}},{"name":"refresh-blueprints","description":"Updates the blueprints saved to the database with the latest version from the registry. Sometimes blueprints in the database can become outdated. Use this function to pull in the latest versions.","inputSchema":{"$id":"/schemas/%7B%7D","anyOf":[{"type":"object"},{"type":"array"}]}}]},"prompt":{"content":[{"role":"system","content":"You can call blueprint manager tools. When asked to refresh or sync blueprints from the registry,\ncall the refresh blueprints tool once and then stop.\n\n## Blueprints Definitions\n\n<blueprint>\n  You can query available blueprints and enable them in the current conversation.\n  Use [query-blueprints] to refresh the list of available blueprints.\n  Use [refresh-blueprints] to update blueprint objects stored in the database from the built-in registry when they have drifted.\n  Use [enable-blueprints] to enable blueprints by their keys. Always call [query-blueprints] first.\n  Only blueprints with agentCanEnable=true can be enabled by the agent.\n  \n  <available_blueprints>\n  -  \"Database\" -- Query and manipulate objects in the ECHO database. [agent-can-enable]\n  -  \"Discord\" -- Discord integration.\n  -  \"Memory\" -- Persistent memory storage and retrieval. [agent-can-enable]\n  </available_blueprints>\n  \n  NOTE: You must enable the blueprint to use it, only then the tools from that blueprint will appear.\n</blueprint>","options":{}},{"role":"user","content":"Refresh blueprints from the registry so database copies match the built-in definitions.","options":{"anthropic":{"cacheControl":{"ttl":"5m","type":"ephemeral"}}}}]},"response":[{"type":"response-metadata","id":"msg_01EnWRrZtYvker1hoFaUftiX","modelId":"claude-opus-4-6","timestamp":"1970-01-01T00:00:00.000Z","metadata":{}},{"type":"reasoning-start","id":"0","metadata":{}},{"type":"reasoning-delta","id":"0","delta":"The user wants to refresh blueprints from the registry. I should call the refresh-blueprints tool.","metadata":{}},{"type":"reasoning-delta","id":"0","delta":"","metadata":{"anthropic":{"type":"thinking","signature":"EqgCCmMIDhgCKkBdz2UkSiBc+mB42bn4XBMulDdlfY744r6A3/CtRIj5ka8kLuAbmGbpsDHh15YA4AXwrTKjmGFVws1/iQVVcX0NMg9jbGF1ZGUtb3B1cy00LTY4AEIIdGhpbmtpbmcSDC1IWXx2nxKJlumiFBoMODifRWw+vJr3M9oxIjCNeGHzgul3HZTZVS1Y1fq36Z6+uk9jVJtfR1kiZDmfUabkraoD+PzSoABC7+HQSl4qc4hegrTArcyY5OVZiDXjw5cbBhF72gChkZu+A5b/wqIxjxdVTqj5Mk3W9dVK7gF5K9ATIOu8KeHLwz9wFEZgmK9vBQhhWrX+X0SaZ7Tds2fllZyPf+1u7EbqQUDP0fp8mjeXRSKJLeTBGTw/d5Ul0Y3/DIgYAQ=="}}},{"type":"reasoning-end","id":"0","metadata":{}},{"type":"text-start","id":"1","metadata":{}},{"type":"text-delta","id":"1","delta":"I","metadata":{}},{"type":"text-delta","id":"1","delta":"'ll refresh the blueprints from the registry now.","metadata":{}},{"type":"text-end","id":"1","metadata":{}},{"type":"tool-params-start","id":"toolu_0191HNbgqXmmaNXfW6keirtd","name":"refresh-blueprints","providerExecuted":false,"metadata":{}},{"type":"tool-params-delta","id":"toolu_0191HNbgqXmmaNXfW6keirtd","delta":"","metadata":{}},{"type":"tool-params-end","id":"toolu_0191HNbgqXmmaNXfW6keirtd","metadata":{}},{"type":"finish","reason":"tool-calls","usage":{"inputTokens":1086,"outputTokens":90,"totalTokens":1176},"metadata":{"anthropic":{"usage":{"cache_creation":{"ephemeral_1h_input_tokens":0,"ephemeral_5m_input_tokens":0},"cache_creation_input_tokens":0,"cache_read_input_tokens":0,"input_tokens":1086,"output_tokens":40,"server_tool_use":null,"service_tier":"standard"}}}}]},{"parameters":{"model":"ai.claude.model.claude-opus-4-6","stream":true,"tools":[{"name":"query-blueprints","description":"Queries available blueprints.","inputSchema":{"$id":"/schemas/%7B%7D","anyOf":[{"type":"object"},{"type":"array"}]}},{"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.","inputSchema":{"type":"object","required":["keys"],"properties":{"keys":{"type":"array","items":{"type":"string"},"description":"The keys of the blueprints to enable.","examples":[["org.dxos.blueprint.memory","org.dxos.blueprint.database"]]}},"additionalProperties":false}},{"name":"refresh-blueprints","description":"Updates the blueprints saved to the database with the latest version from the registry. Sometimes blueprints in the database can become outdated. Use this function to pull in the latest versions.","inputSchema":{"$id":"/schemas/%7B%7D","anyOf":[{"type":"object"},{"type":"array"}]}}]},"prompt":{"content":[{"role":"system","content":"You can call blueprint manager tools. When asked to refresh or sync blueprints from the registry,\ncall the refresh blueprints tool once and then stop.\n\n## Blueprints Definitions\n\n<blueprint>\n  You can query available blueprints and enable them in the current conversation.\n  Use [query-blueprints] to refresh the list of available blueprints.\n  Use [refresh-blueprints] to update blueprint objects stored in the database from the built-in registry when they have drifted.\n  Use [enable-blueprints] to enable blueprints by their keys. Always call [query-blueprints] first.\n  Only blueprints with agentCanEnable=true can be enabled by the agent.\n  \n  <available_blueprints>\n  -  \"Database\" -- Query and manipulate objects in the ECHO database. [agent-can-enable]\n  -  \"Discord\" -- Discord integration.\n  -  \"Memory\" -- Persistent memory storage and retrieval. [agent-can-enable]\n  </available_blueprints>\n  \n  NOTE: You must enable the blueprint to use it, only then the tools from that blueprint will appear.\n</blueprint>","options":{}},{"role":"user","content":"Refresh blueprints from the registry so database copies match the built-in definitions.","options":{}},{"role":"assistant","content":[{"type":"reasoning","text":"The user wants to refresh blueprints from the registry. I should call the refresh-blueprints tool.","options":{}},{"type":"text","text":"I'll refresh the blueprints from the registry now.","options":{}},{"type":"tool-call","id":"toolu_0191HNbgqXmmaNXfW6keirtd","name":"refresh-blueprints","params":{},"providerExecuted":false,"options":{}}],"options":{}},{"role":"tool","content":[{"type":"tool-result","id":"toolu_0191HNbgqXmmaNXfW6keirtd","name":"refresh-blueprints","isFailure":false,"result":{},"providerExecuted":false,"options":{}}],"options":{"anthropic":{"cacheControl":{"ttl":"5m","type":"ephemeral"}}}}]},"response":[{"type":"response-metadata","id":"msg_01UYmSHxnE5L1YWqDDnmQtpE","modelId":"claude-opus-4-6","timestamp":"1970-01-01T00:00:00.000Z","metadata":{}},{"type":"text-start","id":"0","metadata":{}},{"type":"text-delta","id":"0","delta":"The blueprints stored","metadata":{}},{"type":"text-delta","id":"0","delta":" in the database have been updated to match the latest built-in definitions from the registry. Everything should","metadata":{}},{"type":"text-delta","id":"0","delta":" now be in sync.","metadata":{}},{"type":"text-end","id":"0","metadata":{}},{"type":"finish","reason":"stop","usage":{"inputTokens":1149,"outputTokens":33,"totalTokens":1182},"metadata":{"anthropic":{"usage":{"cache_creation":{"ephemeral_1h_input_tokens":0,"ephemeral_5m_input_tokens":0},"cache_creation_input_tokens":0,"cache_read_input_tokens":0,"input_tokens":1149,"output_tokens":5,"server_tool_use":null,"service_tier":"standard"}}}}]}]}