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

package/dist/types/src/functions/agent/definitions.d.ts

@@ -1,61 +1,53 @@
 import { AiService, OpaqueToolkit } from '@dxos/ai';
-import { Trace } from '@dxos/compute';
-import { Operation, OperationRegistry } from '@dxos/compute';
-import { Database, Feed } from '@dxos/echo';
+import { Trace, Operation } from '@dxos/compute';
+import { Database, Feed, Registry } from '@dxos/echo';
 export declare const AgentPrompt: Operation.Definition<{
-    readonly prompt: import("@dxos/echo/internal").Ref<import("@dxos/echo/Entity").OfKind<import("@dxos/echo/internal").EntityKind.Object> & {
+    readonly prompt: import("@dxos/echo/internal").Ref<{
         readonly name?: string | undefined;
         readonly description?: string | undefined;
         readonly input: import("@dxos/echo/internal").JsonSchemaType;
         readonly output: import("@dxos/echo/internal").JsonSchemaType;
-        readonly instructions: {
-            readonly source: import("@dxos/echo/internal").Ref<import("@dxos/echo/Entity").OfKind<import("@dxos/echo/internal").EntityKind.Object> & {
-                readonly name?: string | undefined;
-                readonly content: string;
-            }>;
-            readonly inputs?: readonly {
-                readonly name: string;
-                readonly kind?: "context" | "function" | "pass-through" | "query" | "resolver" | "retriever" | "schema" | "value" | undefined;
-                readonly default?: any;
-                readonly function?: string | undefined;
-            }[] | undefined;
-        };
-        readonly blueprints: readonly import("@dxos/echo/internal").Ref<import("@dxos/echo/Entity").OfKind<import("@dxos/echo/internal").EntityKind.Object> & {
-            readonly key: string;
+        readonly instructions: import("@dxos/echo/internal").Ref<{
+            readonly name?: string | undefined;
+            readonly content: string;
+        } & import("@dxos/echo/Entity").OfKind<import("@dxos/echo/internal").EntityKind.Object> & import("@dxos/echo/Obj").Unknown>;
+        readonly blueprints: readonly import("@dxos/echo/internal").Ref<{
             readonly name: string;
             readonly description?: string | undefined;
             readonly instructions: {
-                readonly source: import("@dxos/echo/internal").Ref<import("@dxos/echo/Entity").OfKind<import("@dxos/echo/internal").EntityKind.Object> & {
+                readonly source: import("@dxos/echo/internal").Ref<{
                     readonly name?: string | undefined;
                     readonly content: string;
-                }>;
+                } & import("@dxos/echo/Entity").OfKind<import("@dxos/echo/internal").EntityKind.Object> & import("@dxos/echo/Obj").Unknown>;
                 readonly inputs?: readonly {
                     readonly name: string;
-                    readonly kind?: "context" | "function" | "pass-through" | "query" | "resolver" | "retriever" | "schema" | "value" | undefined;
+                    readonly kind: "operation" | "value";
                     readonly default?: any;
-                    readonly function?: string | undefined;
+                    readonly operation?: string | undefined;
                 }[] | undefined;
             };
             readonly tools: readonly (string & import("effect/Brand").Brand<"ToolId">)[];
             readonly agentCanEnable?: boolean | undefined;
             readonly mcpServers?: readonly {
+                readonly name?: string | undefined;
                 readonly url: string;
                 readonly protocol: "http" | "sse";
+                readonly apiKey?: string | undefined;
             }[] | undefined;
-        }>[];
+        } & import("@dxos/echo/Entity").OfKind<import("@dxos/echo/internal").EntityKind.Object> & import("@dxos/echo/Obj").Unknown>[];
         readonly context: readonly any[];
-    }>;
-    readonly chat?: import("@dxos/echo/internal").Ref<import("@dxos/echo/Entity").OfKind<import("@dxos/echo/internal").EntityKind.Object> & {
+    } & import("@dxos/echo/Entity").OfKind<import("@dxos/echo/internal").EntityKind.Object> & import("@dxos/echo/Obj").Unknown>;
+    readonly chat?: import("@dxos/echo/internal").Ref<{
         readonly name?: string | undefined;
-        readonly feed: import("@dxos/echo/internal").Ref<import("@dxos/echo/Entity").OfKind<import("@dxos/echo/internal").EntityKind.Object> & {
+        readonly feed: import("@dxos/echo/internal").Ref<{
             readonly name?: string | undefined;
             readonly kind?: string | undefined;
             readonly namespace?: "data" | "trace" | undefined;
-        }>;
+        } & import("@dxos/echo/Entity").OfKind<import("@dxos/echo/internal").EntityKind.Object> & import("@dxos/echo/Obj").Unknown>;
         readonly view?: string | undefined;
-    }> | undefined;
-    readonly model?: "@anthropic/claude-3-5-haiku-20241022" | "@anthropic/claude-3-5-haiku-latest" | "@anthropic/claude-3-5-sonnet-20241022" | "@anthropic/claude-haiku-4-5" | "@anthropic/claude-opus-4-0" | "@anthropic/claude-opus-4-5" | "@anthropic/claude-opus-4-6" | "@anthropic/claude-sonnet-4-0" | "@anthropic/claude-sonnet-4-5" | "@cf/deepseek-ai/deepseek-r1-distill-qwen-32b" | "@google/gemma-3-27b" | "@hf/nousresearch/hermes-2-pro-mistral-7b" | "@meta/llama-3.1-8b-instruct" | "@meta/llama-3.2-3b-instruct" | "@ollama/llama-3-1-nemotron-70b-instruct" | "@ollama/llama-3-1-nemotron-mini-4b-instruct" | "@ollama/llama-3-2-3b" | "@openai/gpt-4o" | "@openai/gpt-4o-mini" | "@openai/o1" | "@openai/o3" | "@openai/o3-mini" | "deepseek-r1:latest" | "gemma4:latest" | "gpt-oss:20b" | "llama3.2:1b" | "llama3:70b" | "ministral-3-14b-reasoning" | "openai/gpt-oss-20b" | "qwen2.5:14b" | undefined;
+    } & import("@dxos/echo/Entity").OfKind<import("@dxos/echo/internal").EntityKind.Object> & import("@dxos/echo/Obj").Unknown> | undefined;
+    readonly model?: "ai.claude.model.claude-3-5-haiku-20241022" | "ai.claude.model.claude-3-5-haiku-latest" | "ai.claude.model.claude-3-5-sonnet-20241022" | "ai.claude.model.claude-haiku-4-5" | "ai.claude.model.claude-opus-4-0" | "ai.claude.model.claude-opus-4-5" | "ai.claude.model.claude-opus-4-6" | "ai.claude.model.claude-opus-4-8" | "ai.claude.model.claude-sonnet-4-0" | "ai.claude.model.claude-sonnet-4-5" | "ai.claude.model.claude-sonnet-4-6" | "ai.google.model.gemma-3-27b" | "ai.meta.model.llama-3.1-8b-instruct" | "ai.meta.model.llama-3.2-3b-instruct" | "ai.mistral.model.ministral-3-14b-reasoning" | "ai.ollama.model.deepseek-r1:latest" | "ai.ollama.model.gemma4:latest" | "ai.ollama.model.gpt-oss:20b" | "ai.ollama.model.llama3.2:1b" | "ai.ollama.model.llama3:70b" | "ai.ollama.model.qwen2.5:14b" | "ai.openai.model.gpt-4o" | "ai.openai.model.gpt-4o-mini" | "ai.openai.model.gpt-oss-20b" | "ai.openai.model.o1" | "ai.openai.model.o3" | "ai.openai.model.o3-mini" | undefined;
     readonly input: any;
     readonly systemInstructions?: string | undefined;
-}, any, AiService.AiService | Feed.FeedService | OpaqueToolkit.OpaqueToolkitProvider | Database.Service | OperationRegistry.Service | Trace.TraceService>;
+}, any, AiService.AiService | Feed.FeedService | OpaqueToolkit.OpaqueToolkitProvider | Registry.Service | Database.Service | Trace.TraceService>;
 //# sourceMappingURL=definitions.d.ts.map

package/dist/types/src/functions/agent/definitions.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"definitions.d.ts","sourceRoot":"","sources":["../../../../../src/functions/agent/definitions.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,SAAS,EAAE,aAAa,EAAa,MAAM,UAAU,CAAC;AAE/D,OAAO,EAAE,KAAK,EAAE,MAAM,eAAe,CAAC;AACtC,OAAO,EAAE,SAAS,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAC7D,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAO,MAAM,YAAY,CAAC;AAIjD,eAAO,MAAM,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;yJAsCtB,CAAC"}
+{"version":3,"file":"definitions.d.ts","sourceRoot":"","sources":["../../../../../src/functions/agent/definitions.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,SAAS,EAAE,aAAa,EAAa,MAAM,UAAU,CAAC;AAC/D,OAAO,EAAW,KAAK,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAC1D,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAO,QAAQ,EAAE,MAAM,YAAY,CAAC;AAO3D,eAAO,MAAM,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;gJA0CtB,CAAC"}

package/dist/types/src/functions/agent/prompt.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"prompt.d.ts","sourceRoot":"","sources":["../../../../../src/functions/agent/prompt.ts"],"names":[],"mappings":"AAuBA,OAAO,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC"}
+{"version":3,"file":"prompt.d.ts","sourceRoot":"","sources":["../../../../../src/functions/agent/prompt.ts"],"names":[],"mappings":"AAmBA,OAAO,EAAmB,SAAS,EAAE,MAAM,eAAe,CAAC"}

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

@@ -1,6 +1,7 @@
 export * from './blueprints';
 export * from './crud';
 export * from './functions';
+export * from './supervisor';
 export * from './sync';
 export * from './toolkits';
 export * from './types';

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/index.ts"],"names":[],"mappings":"AAIA,cAAc,cAAc,CAAC;AAC7B,cAAc,QAAQ,CAAC;AACvB,cAAc,aAAa,CAAC;AAC5B,cAAc,QAAQ,CAAC;AACvB,cAAc,YAAY,CAAC;AAC3B,cAAc,SAAS,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/index.ts"],"names":[],"mappings":"AAIA,cAAc,cAAc,CAAC;AAC7B,cAAc,QAAQ,CAAC;AACvB,cAAc,aAAa,CAAC;AAC5B,cAAc,cAAc,CAAC;AAC7B,cAAc,QAAQ,CAAC;AACvB,cAAc,YAAY,CAAC;AAC3B,cAAc,SAAS,CAAC"}

package/dist/types/src/supervisor/delegation-strategy.d.ts

@@ -0,0 +1,9 @@
+import { type DelegationStrategy } from '@dxos/functions-runtime';
+/**
+ * Supervisor behaviour for the conversational agent: after each turn, every in-progress plan task
+ * not already delegated is run by a sub-agent (a synthesized minimal `Routine` executed via
+ * `AgentPrompt`); on completion the task status is updated and a templated message is posted back to
+ * the conversation.
+ */
+export declare const makeDelegationStrategy: () => DelegationStrategy;
+//# sourceMappingURL=delegation-strategy.d.ts.map

package/dist/types/src/supervisor/delegation-strategy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"delegation-strategy.d.ts","sourceRoot":"","sources":["../../../../src/supervisor/delegation-strategy.ts"],"names":[],"mappings":"AAaA,OAAO,EAAmB,KAAK,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAuDnF;;;;;GAKG;AACH,eAAO,MAAM,sBAAsB,QAAO,kBAiHxC,CAAC"}

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

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

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

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

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

@@ -1,6 +1,5 @@
 import * as Effect from 'effect/Effect';
-import { Obj } from '@dxos/echo';
-import { Database } from '@dxos/echo';
+import { Database, Obj } from '@dxos/echo';
 /**
  * Syncs objects to the database.
  * If there's an object with a matching foreign key in the database, it will be updated.

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

@@ -1 +1 @@
-{"version":3,"file":"sync.d.ts","sourceRoot":"","sources":["../../../../src/sync/sync.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AAExC,OAAO,EAAU,GAAG,EAAc,MAAM,YAAY,CAAC;AACrD,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAItC;;;;;;;GAOG;AACH,eAAO,MAAM,WAAW,EAAE,CACxB,IAAI,EAAE,GAAG,CAAC,OAAO,EAAE,EACnB,IAAI,EAAE;IAAE,YAAY,EAAE,MAAM,CAAA;CAAE,KAC3B,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,OAAO,EAAE,EAAE,KAAK,EAAE,QAAQ,CAAC,OAAO,CA8CvD,CAAC"}
+{"version":3,"file":"sync.d.ts","sourceRoot":"","sources":["../../../../src/sync/sync.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AAExC,OAAO,EAAE,QAAQ,EAAU,GAAG,EAAc,MAAM,YAAY,CAAC;AAK/D;;;;;;;GAOG;AACH,eAAO,MAAM,WAAW,EAAE,CACxB,IAAI,EAAE,GAAG,CAAC,OAAO,EAAE,EACnB,IAAI,EAAE;IAAE,YAAY,EAAE,MAAM,CAAA;CAAE,KAC3B,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,OAAO,EAAE,EAAE,KAAK,EAAE,QAAQ,CAAC,OAAO,CA+CvD,CAAC"}

package/dist/types/src/testing/plugins.d.ts

@@ -4,7 +4,7 @@ import { type Obj, Type } from '@dxos/echo';
 export declare const MapSchema: Type.Obj<{
     readonly coordinates: readonly [number, number, (number | undefined)?];
 }, Schema.Struct.Fields>;
-export type MapSchema = Schema.Schema.Type<typeof MapSchema>;
+export type MapSchema = Type.InstanceType<typeof MapSchema>;
 export type ArtifactsContext = {
     items: Obj.Unknown[];
     getArtifacts: () => Obj.Unknown[];

package/dist/types/src/testing/plugins.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"plugins.d.ts","sourceRoot":"","sources":["../../../../src/testing/plugins.tsx"],"names":[],"mappings":"AAIA,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AAGxC,OAAO,EAAgB,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAE/D,OAAO,EAAU,KAAK,GAAG,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AAIpD,eAAO,MAAM,SAAS;;wBAOrB,CAAC;AAEF,MAAM,MAAM,SAAS,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,SAAS,CAAC,CAAC;AAG7D,MAAM,MAAM,gBAAgB,GAAG;IAC7B,KAAK,EAAE,GAAG,CAAC,OAAO,EAAE,CAAC;IACrB,YAAY,EAAE,MAAM,GAAG,CAAC,OAAO,EAAE,CAAC;IAClC,WAAW,EAAE,CAAC,QAAQ,EAAE,GAAG,CAAC,OAAO,KAAK,IAAI,CAAC;CAC9C,CAAC;AAEF,OAAO,CAAC,MAAM,CAAC,CAAC;IACd,UAAU,qBAAqB;QAC7B,SAAS,CAAC,EAAE,gBAAgB,CAAC;KAC9B;CACF;AAKD,eAAO,MAAM,YAAY,EAAE,UAAU,CAAC,GAAG,EAsCxC,CAAC"}
+{"version":3,"file":"plugins.d.ts","sourceRoot":"","sources":["../../../../src/testing/plugins.tsx"],"names":[],"mappings":"AAIA,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AAGxC,OAAO,EAAgB,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAE/D,OAAO,EAAe,KAAK,GAAG,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AAIzD,eAAO,MAAM,SAAS;;wBAE6C,CAAC;AAEpE,MAAM,MAAM,SAAS,GAAG,IAAI,CAAC,YAAY,CAAC,OAAO,SAAS,CAAC,CAAC;AAG5D,MAAM,MAAM,gBAAgB,GAAG;IAC7B,KAAK,EAAE,GAAG,CAAC,OAAO,EAAE,CAAC;IACrB,YAAY,EAAE,MAAM,GAAG,CAAC,OAAO,EAAE,CAAC;IAClC,WAAW,EAAE,CAAC,QAAQ,EAAE,GAAG,CAAC,OAAO,KAAK,IAAI,CAAC;CAC9C,CAAC;AAEF,OAAO,CAAC,MAAM,CAAC,CAAC;IACd,UAAU,qBAAqB;QAC7B,SAAS,CAAC,EAAE,gBAAgB,CAAC;KAC9B;CACF;AAKD,eAAO,MAAM,YAAY,EAAE,UAAU,CAAC,GAAG,EAsCxC,CAAC"}

package/dist/types/src/toolkits/WebToolkit.d.ts

@@ -20,7 +20,7 @@ export declare const WebToolkit: Toolkit.Toolkit<{
                 nullable: true;
             }>;
         }>;
-        readonly parameters: Schema.Struct<{}>;
+        readonly parameters: Tool.EmptyParams;
         readonly success: Schema.Array$<typeof import("@effect/ai-anthropic/Generated").RequestWebSearchResultBlock>;
         readonly failure: typeof import("@effect/ai-anthropic/Generated").ResponseWebSearchToolResultError;
         readonly failureMode: "error";

package/dist/types/src/toolkits/WebToolkit.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"WebToolkit.d.ts","sourceRoot":"","sources":["../../../../src/toolkits/WebToolkit.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,IAAI,MAAM,iBAAiB,CAAC;AACxC,OAAO,KAAK,OAAO,MAAM,oBAAoB,CAAC;AAE9C,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AAGxC,eAAO,MAAM,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EActB,CAAC;AAEF,eAAO,MAAM,KAAK,sEAKhB,CAAC"}
+{"version":3,"file":"WebToolkit.d.ts","sourceRoot":"","sources":["../../../../src/toolkits/WebToolkit.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,IAAI,MAAM,iBAAiB,CAAC;AACxC,OAAO,KAAK,OAAO,MAAM,oBAAoB,CAAC;AAE9C,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AAKxC,eAAO,MAAM,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EActB,CAAC;AAEF,eAAO,MAAM,KAAK,sEAchB,CAAC"}

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

@@ -1,58 +1,65 @@
 import * as Effect from 'effect/Effect';
 import * as Schema from 'effect/Schema';
-import { AiContextService } from '@dxos/assistant';
+import { AiContext } from '@dxos/assistant';
 import { type Blueprint } from '@dxos/compute';
-import { QueueService } from '@dxos/compute';
 import { Database, Feed, Obj, Ref, Type } from '@dxos/echo';
-import { Queue } from '@dxos/echo-db';
-import { type ObjectNotFoundError } from '@dxos/echo/Err';
+import { type EntityNotFoundError } from '@dxos/echo/Err';
 /**
  * Agent schema definition.
  */
 export declare const Agent: Type.Obj<{
     readonly name?: string | undefined;
     readonly enabled?: boolean | undefined;
-    readonly instructions: import("@dxos/echo/internal").Ref<import("@dxos/echo/Entity").OfKind<import("@dxos/echo/internal").EntityKind.Object> & {
+    readonly instructions: import("@dxos/echo/internal").Ref<{
         readonly name?: string | undefined;
         readonly content: string;
-    }>;
-    readonly chat?: import("@dxos/echo/internal").Ref<import("@dxos/echo/Entity").OfKind<import("@dxos/echo/internal").EntityKind.Object> & {
+    } & import("@dxos/echo/Entity").OfKind<import("@dxos/echo/internal").EntityKind.Object> & Obj.Unknown>;
+    readonly chat?: import("@dxos/echo/internal").Ref<{
         readonly name?: string | undefined;
-        readonly feed: import("@dxos/echo/internal").Ref<import("@dxos/echo/Entity").OfKind<import("@dxos/echo/internal").EntityKind.Object> & {
+        readonly feed: import("@dxos/echo/internal").Ref<{
             readonly name?: string | undefined;
             readonly kind?: string | undefined;
             readonly namespace?: "data" | "trace" | undefined;
-        }>;
+        } & import("@dxos/echo/Entity").OfKind<import("@dxos/echo/internal").EntityKind.Object> & Obj.Unknown>;
         readonly view?: string | undefined;
-    }> | undefined;
-    readonly plan: import("@dxos/echo/internal").Ref<import("@dxos/echo/Entity").OfKind<import("@dxos/echo/internal").EntityKind.Object> & {
+    } & import("@dxos/echo/Entity").OfKind<import("@dxos/echo/internal").EntityKind.Object> & Obj.Unknown> | undefined;
+    readonly plan: import("@dxos/echo/internal").Ref<{
         readonly tasks: readonly {
             readonly id: string & import("effect/Brand").Brand<"@dxos/assistant-toolkit/TaskId">;
             readonly title: string;
-            readonly status: "done" | "in-progress" | "todo";
+            readonly status: "done" | "failed" | "in-progress" | "todo";
+            readonly delegated?: boolean | undefined;
             readonly parent?: (string & import("effect/Brand").Brand<"@dxos/assistant-toolkit/TaskId">) | undefined;
-            readonly chat?: import("@dxos/echo/internal").Ref<import("@dxos/echo/Entity").OfKind<import("@dxos/echo/internal").EntityKind.Object> & {
+            readonly chat?: import("@dxos/echo/internal").Ref<{
                 readonly name?: string | undefined;
-                readonly feed: import("@dxos/echo/internal").Ref<import("@dxos/echo/Entity").OfKind<import("@dxos/echo/internal").EntityKind.Object> & {
+                readonly feed: import("@dxos/echo/internal").Ref<{
                     readonly name?: string | undefined;
                     readonly kind?: string | undefined;
                     readonly namespace?: "data" | "trace" | undefined;
-                }>;
+                } & import("@dxos/echo/Entity").OfKind<import("@dxos/echo/internal").EntityKind.Object> & Obj.Unknown>;
                 readonly view?: string | undefined;
-            }> | undefined;
+            } & import("@dxos/echo/Entity").OfKind<import("@dxos/echo/internal").EntityKind.Object> & Obj.Unknown> | undefined;
         }[];
-    }>;
+    } & import("@dxos/echo/Entity").OfKind<import("@dxos/echo/internal").EntityKind.Object> & Obj.Unknown>;
     readonly artifacts: readonly {
         readonly name: string;
-        readonly data: import("@dxos/echo/internal").Ref<import("@dxos/echo/Entity").OfKind<import("@dxos/echo/internal").EntityKind.Object> & Obj.Unknown>;
+        readonly data: import("@dxos/echo/internal").Ref<Obj.Unknown>;
     }[];
-    readonly queue?: import("@dxos/echo/internal").Ref<Queue<import("@dxos/echo/Entity").Unknown>> | undefined;
-    readonly subscriptions: readonly import("@dxos/echo/internal").Ref<import("@dxos/echo/Entity").OfKind<import("@dxos/echo/internal").EntityKind.Object> & Obj.Unknown>[];
-    readonly filterEvents?: boolean | undefined;
+    readonly subscriptions: readonly import("@dxos/echo/internal").Ref<Obj.Unknown>[];
     readonly cron?: string | undefined;
+    readonly feed?: import("@dxos/echo/internal").Ref<{
+        readonly name?: string | undefined;
+        readonly kind?: string | undefined;
+        readonly namespace?: "data" | "trace" | undefined;
+    } & import("@dxos/echo/Entity").OfKind<import("@dxos/echo/internal").EntityKind.Object> & Obj.Unknown> | undefined;
+    readonly filterEvents?: boolean | undefined;
 }, Schema.Struct.Fields>;
-export interface Agent extends Schema.Schema.Type<typeof Agent> {
-}
+export type Agent = Type.InstanceType<typeof Agent>;
+export type MakeProps = Omit<Obj.MakeProps<typeof Agent>, 'instructions' | 'plan' | 'artifacts' | 'subscriptions' | 'chat'> & Partial<Pick<Obj.MakeProps<typeof Agent>, 'artifacts' | 'subscriptions'>> & {
+    instructions: string;
+    blueprints?: Ref.Ref<Blueprint.Blueprint>[];
+    contextObjects?: Ref.Ref<Obj.Any>[];
+};
 /**
  * Creates a fully initialized Agent with chat, queue, and context bindings.
  *
@@ -60,11 +67,7 @@ export interface Agent extends Schema.Schema.Type<typeof Agent> {
  * @param blueprint - The blueprint to use for the agent context.
  * @returns An Effect that yields the initialized Agent.
  */
-export declare const makeInitialized: (props: Omit<Obj.MakeProps<typeof Agent>, 'instructions' | 'plan' | 'artifacts' | 'subscriptions' | 'chat'> & Partial<Pick<Obj.MakeProps<typeof Agent>, 'artifacts' | 'subscriptions'>> & {
-    instructions: string;
-    blueprints?: Ref.Ref<Blueprint.Blueprint>[];
-    contextObjects?: Ref.Ref<Obj.Any>[];
-}, blueprint: Blueprint.Blueprint) => Effect.Effect<Agent, never, QueueService | Feed.FeedService | Database.Service>;
+export declare const makeInitialized: (props: MakeProps, blueprint: Blueprint.Blueprint) => Effect.Effect<Agent, never, Feed.FeedService | Database.Service>;
 /**
  * Resets the agent chat history by rebuilding the chat context.
  * Preserves the existing blueprints and objects from the current chat context.
@@ -72,6 +75,20 @@ export declare const makeInitialized: (props: Omit<Obj.MakeProps<typeof Agent>,
  * @param agent - The agent whose chat history should be reset. Must have an existing chat.
  * @returns An Effect that resets the chat history.
  */
-export declare const resetChatHistory: (agent: Agent) => Effect.Effect<void, ObjectNotFoundError, Feed.FeedService | Database.Service>;
-export declare const getFromChatContext: Effect.Effect<Agent, Error, AiContextService>;
+export declare const resetChatHistory: (agent: Agent) => Effect.Effect<void, EntityNotFoundError, Feed.FeedService | Database.Service>;
+export declare const getFromChatContext: Effect.Effect<Agent, Error, AiContext.Service>;
+/**
+ * Adds an object to the agent's artifacts (context), resolving it by id within the agent's space.
+ *
+ * Accepts whatever reference a tool returned — a bare entity id (e.g. `01J…`) or a full ECHO URI
+ * (`echo:/…`, `echo://…`). LLMs frequently strip a returned URI down to the bare id, which is not
+ * a resolvable URI on its own; resolving by entity id within the space tolerates both forms.
+ *
+ * Returns the fully-qualified {@link Ref.Ref} that was stored (also usable for an inline message
+ * reference block).
+ */
+export declare const addArtifact: (agent: Agent, { name, id }: {
+    name: string;
+    id: string;
+}) => Effect.Effect<Ref.Ref<Obj.Unknown>, Error, Database.Service>;
 //# sourceMappingURL=Agent.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"Agent.d.ts","sourceRoot":"","sources":["../../../../src/types/Agent.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AAExC,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AAExC,OAAO,EAAmB,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AACpE,OAAO,EAAE,KAAK,SAAS,EAAE,MAAM,eAAe,CAAC;AAC/C,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAC7C,OAAO,EAAc,QAAQ,EAAE,IAAI,EAAU,GAAG,EAAE,GAAG,EAAY,IAAI,EAAE,MAAM,YAAY,CAAC;AAC1F,OAAO,EAAE,KAAK,EAAE,MAAM,eAAe,CAAC;AACtC,OAAO,EAAE,KAAK,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AAS1D;;GAEG;AACH,eAAO,MAAM,KAAK;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;wBAkFjB,CAAC;AAEF,MAAM,WAAW,KAAM,SAAQ,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,KAAK,CAAC;CAAG;AAElE;;;;;;GAMG;AACH,eAAO,MAAM,eAAe,UACnB,IAAI,CAAC,GAAG,CAAC,SAAS,CAAC,OAAO,KAAK,CAAC,EAAE,cAAc,GAAG,MAAM,GAAG,WAAW,GAAG,eAAe,GAAG,MAAM,CAAC,GACxG,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,SAAS,CAAC,OAAO,KAAK,CAAC,EAAE,WAAW,GAAG,eAAe,CAAC,CAAC,GAAG;IAC1E,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,GAAG,CAAC,GAAG,CAAC,SAAS,CAAC,SAAS,CAAC,EAAE,CAAC;IAC5C,cAAc,CAAC,EAAE,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;CACrC,aACQ,SAAS,CAAC,SAAS,KAC7B,MAAM,CAAC,MAAM,CAAC,KAAK,EAAE,KAAK,EAAE,YAAY,GAAG,IAAI,CAAC,WAAW,GAAG,QAAQ,CAAC,OAAO,CA6C7E,CAAC;AAEL;;;;;;GAMG;AACH,eAAO,MAAM,gBAAgB,UACpB,KAAK,KACX,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,mBAAmB,EAAE,IAAI,CAAC,WAAW,GAAG,QAAQ,CAAC,OAAO,CA4CvD,CAAC;AAEzB,eAAO,MAAM,kBAAkB,EAAE,MAAM,CAAC,MAAM,CAAC,KAAK,EAAE,KAAK,EAAE,gBAAgB,CAQ3E,CAAC"}
+{"version":3,"file":"Agent.d.ts","sourceRoot":"","sources":["../../../../src/types/Agent.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AAExC,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AAExC,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,OAAO,EAAE,KAAK,SAAS,EAAE,MAAM,eAAe,CAAC;AAC/C,OAAO,EAAmB,QAAQ,EAAE,IAAI,EAAU,GAAG,EAAE,GAAG,EAAY,IAAI,EAAE,MAAM,YAAY,CAAC;AAE/F,OAAO,EAAE,KAAK,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AAS1D;;GAEG;AACH,eAAO,MAAM,KAAK;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;wBA6EjB,CAAC;AAEF,MAAM,MAAM,KAAK,GAAG,IAAI,CAAC,YAAY,CAAC,OAAO,KAAK,CAAC,CAAC;AAEpD,MAAM,MAAM,SAAS,GAAG,IAAI,CAC1B,GAAG,CAAC,SAAS,CAAC,OAAO,KAAK,CAAC,EAC3B,cAAc,GAAG,MAAM,GAAG,WAAW,GAAG,eAAe,GAAG,MAAM,CACjE,GACC,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,SAAS,CAAC,OAAO,KAAK,CAAC,EAAE,WAAW,GAAG,eAAe,CAAC,CAAC,GAAG;IAC1E,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,GAAG,CAAC,GAAG,CAAC,SAAS,CAAC,SAAS,CAAC,EAAE,CAAC;IAC5C,cAAc,CAAC,EAAE,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;CACrC,CAAC;AAEJ;;;;;;GAMG;AACH,eAAO,MAAM,eAAe,UACnB,SAAS,aAEL,SAAS,CAAC,SAAS,KAC7B,MAAM,CAAC,MAAM,CAAC,KAAK,EAAE,KAAK,EAAE,IAAI,CAAC,WAAW,GAAG,QAAQ,CAAC,OAAO,CA8C9D,CAAC;AAEL;;;;;;GAMG;AACH,eAAO,MAAM,gBAAgB,UACpB,KAAK,KACX,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,mBAAmB,EAAE,IAAI,CAAC,WAAW,GAAG,QAAQ,CAAC,OAAO,CA4CvD,CAAC;AAEzB,eAAO,MAAM,kBAAkB,EAAE,MAAM,CAAC,MAAM,CAAC,KAAK,EAAE,KAAK,EAAE,SAAS,CAAC,OAAO,CAQ5E,CAAC;AAEH;;;;;;;;;GASG;AACH,eAAO,MAAM,WAAW,UACf,KAAK,gBACE;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,MAAM,CAAA;CAAE,KACzC,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,KAAK,EAAE,QAAQ,CAAC,OAAO,CAmB1D,CAAC"}

package/dist/types/src/types/Agent.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=Agent.test.d.ts.map

package/dist/types/src/types/Agent.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Agent.test.d.ts","sourceRoot":"","sources":["../../../../src/types/Agent.test.ts"],"names":[],"mappings":""}

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

@@ -5,52 +5,49 @@ import { Obj, Type } from '@dxos/echo';
  */
 export declare const Chat: Type.Obj<{
     readonly name?: string | undefined;
-    readonly feed: import("@dxos/echo/internal").Ref<import("@dxos/echo/Entity").OfKind<import("@dxos/echo/internal").EntityKind.Object> & {
+    readonly feed: import("@dxos/echo/internal").Ref<{
         readonly name?: string | undefined;
         readonly kind?: string | undefined;
         readonly namespace?: "data" | "trace" | undefined;
-    }>;
+    } & import("@dxos/echo/Entity").OfKind<import("@dxos/echo/internal").EntityKind.Object> & Obj.Unknown>;
     readonly view?: string | undefined;
 }, Schema.Struct.Fields>;
-export interface Chat extends Schema.Schema.Type<typeof Chat> {
-}
-export declare const make: (props: Obj.MakeProps<typeof Chat>) => Obj.OfShape<import("@dxos/echo/Entity").OfKind<import("@dxos/echo/internal").EntityKind.Object> & {
+export type Chat = Type.InstanceType<typeof Chat>;
+export declare const make: (props: Obj.MakeProps<typeof Chat>) => Obj.OfShape<{
     readonly name?: string | undefined;
-    readonly feed: import("@dxos/echo/internal").Ref<import("@dxos/echo/Entity").OfKind<import("@dxos/echo/internal").EntityKind.Object> & {
+    readonly feed: import("@dxos/echo/internal").Ref<{
         readonly name?: string | undefined;
         readonly kind?: string | undefined;
         readonly namespace?: "data" | "trace" | undefined;
-    }>;
+    } & import("@dxos/echo/Entity").OfKind<import("@dxos/echo/internal").EntityKind.Object> & Obj.Unknown>;
     readonly view?: string | undefined;
-}>;
+} & import("@dxos/echo/Entity").OfKind<import("@dxos/echo/internal").EntityKind.Object>>;
 /** @deprecated Use CompanionTo instead. */
 export declare const LegacyCompanionTo: Type.Relation<{
     readonly id: string;
-}, import("@dxos/echo/Entity").OfKind<import("@dxos/echo/internal").EntityKind.Object> & {
+}, {
     readonly name?: string | undefined;
-    readonly feed: import("@dxos/echo/internal").Ref<import("@dxos/echo/Entity").OfKind<import("@dxos/echo/internal").EntityKind.Object> & {
+    readonly feed: import("@dxos/echo/internal").Ref<{
         readonly name?: string | undefined;
         readonly kind?: string | undefined;
         readonly namespace?: "data" | "trace" | undefined;
-    }>;
+    } & import("@dxos/echo/Entity").OfKind<import("@dxos/echo/internal").EntityKind.Object> & Obj.Unknown>;
     readonly view?: string | undefined;
-}, import("@dxos/echo/Entity").OfKind<import("@dxos/echo/internal").EntityKind.Object> & Obj.Unknown, Schema.Struct.Fields>;
-export interface LegacyCompanionTo extends Schema.Schema.Type<typeof LegacyCompanionTo> {
-}
+} & import("@dxos/echo/Entity").OfKind<import("@dxos/echo/internal").EntityKind.Object>, Obj.Unknown & import("@dxos/echo/Entity").OfKind<import("@dxos/echo/internal").EntityKind.Object>, Schema.Struct.Fields>;
+export type LegacyCompanionTo = Type.InstanceType<typeof LegacyCompanionTo>;
 /**
  * Relation between a Chat and companion objects (e.g., artifacts).
  */
 export declare const CompanionTo: Type.Relation<{
     readonly id: string;
-}, import("@dxos/echo/Entity").OfKind<import("@dxos/echo/internal").EntityKind.Object> & {
+}, {
     readonly name?: string | undefined;
-    readonly feed: import("@dxos/echo/internal").Ref<import("@dxos/echo/Entity").OfKind<import("@dxos/echo/internal").EntityKind.Object> & {
+    readonly feed: import("@dxos/echo/internal").Ref<{
         readonly name?: string | undefined;
         readonly kind?: string | undefined;
         readonly namespace?: "data" | "trace" | undefined;
-    }>;
+    } & import("@dxos/echo/Entity").OfKind<import("@dxos/echo/internal").EntityKind.Object> & Obj.Unknown>;
     readonly view?: string | undefined;
-}, import("@dxos/echo/Entity").OfKind<import("@dxos/echo/internal").EntityKind.Object> & Obj.Unknown, Schema.Struct.Fields>;
-export interface CompanionTo extends Schema.Schema.Type<typeof CompanionTo> {
-}
+} & import("@dxos/echo/Entity").OfKind<import("@dxos/echo/internal").EntityKind.Object>, Obj.Unknown & import("@dxos/echo/Entity").OfKind<import("@dxos/echo/internal").EntityKind.Object>, Schema.Struct.Fields>;
+export type CompanionTo = Type.InstanceType<typeof CompanionTo>;
 //# sourceMappingURL=Chat.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"Chat.d.ts","sourceRoot":"","sources":["../../../../src/types/Chat.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AAExC,OAAO,EAAoB,GAAG,EAAO,IAAI,EAAE,MAAM,YAAY,CAAC;AAG9D;;GAEG;AACH,eAAO,MAAM,IAAI;;;;;;;;wBAchB,CAAC;AAEF,MAAM,WAAW,IAAK,SAAQ,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,IAAI,CAAC;CAAG;AAEhE,eAAO,MAAM,IAAI,UAAW,GAAG,CAAC,SAAS,CAAC,OAAO,IAAI,CAAC;;;;;;;;EAA0B,CAAC;AAEjF,2CAA2C;AAC3C,eAAO,MAAM,iBAAiB;;;;;;;;;;2HAS7B,CAAC;AAEF,MAAM,WAAW,iBAAkB,SAAQ,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,iBAAiB,CAAC;CAAG;AAE1F;;GAEG;AACH,eAAO,MAAM,WAAW;;;;;;;;;;2HASvB,CAAC;AAEF,MAAM,WAAW,WAAY,SAAQ,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,WAAW,CAAC;CAAG"}
+{"version":3,"file":"Chat.d.ts","sourceRoot":"","sources":["../../../../src/types/Chat.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AAExC,OAAO,EAAyB,GAAG,EAAO,IAAI,EAAE,MAAM,YAAY,CAAC;AAGnE;;GAEG;AACH,eAAO,MAAM,IAAI;;;;;;;;wBAQhB,CAAC;AAEF,MAAM,MAAM,IAAI,GAAG,IAAI,CAAC,YAAY,CAAC,OAAO,IAAI,CAAC,CAAC;AAClD,eAAO,MAAM,IAAI,UAAW,GAAG,CAAC,SAAS,CAAC,OAAO,IAAI,CAAC;;;;;;;;wFAA0B,CAAC;AAEjF,2CAA2C;AAC3C,eAAO,MAAM,iBAAiB;;;;;;;;;;iNAQ7B,CAAC;AAEF,MAAM,MAAM,iBAAiB,GAAG,IAAI,CAAC,YAAY,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAC5E;;GAEG;AACH,eAAO,MAAM,WAAW;;;;;;;;;;iNAQvB,CAAC;AAEF,MAAM,MAAM,WAAW,GAAG,IAAI,CAAC,YAAY,CAAC,OAAO,WAAW,CAAC,CAAC"}

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

@@ -3,16 +3,18 @@ import { Type } from '@dxos/echo';
 /**
  * MCP server configuration stored as a space-level ECHO object.
  *
+ * Composes the canonical connection spec from `@dxos/compute` (`url`, `protocol`, `apiKey`)
+ * and adds instance-level fields (`name`, `enabled`) plus ECHO annotations.
+ *
  * NOTE: `apiKey` is stored in plaintext and replicated to all peers with access to the space.
  * A future iteration should move secrets to per-device credential storage or use envelope encryption.
  */
 export declare const McpServer: Type.Obj<{
-    readonly name: string;
+    readonly name?: string | undefined;
     readonly url: string;
     readonly protocol: "http" | "sse";
     readonly apiKey?: string | undefined;
     readonly enabled?: boolean | undefined;
 }, Schema.Struct.Fields>;
-export interface McpServer extends Schema.Schema.Type<typeof McpServer> {
-}
+export type McpServer = Type.InstanceType<typeof McpServer>;
 //# sourceMappingURL=McpServer.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"McpServer.d.ts","sourceRoot":"","sources":["../../../../src/types/McpServer.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AAExC,OAAO,EAAc,IAAI,EAAE,MAAM,YAAY,CAAC;AAG9C;;;;;GAKG;AACH,eAAO,MAAM,SAAS;;;;;;wBAiBrB,CAAC;AAEF,MAAM,WAAW,SAAU,SAAQ,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,SAAS,CAAC;CAAG"}
+{"version":3,"file":"McpServer.d.ts","sourceRoot":"","sources":["../../../../src/types/McpServer.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AAGxC,OAAO,EAAmB,IAAI,EAAE,MAAM,YAAY,CAAC;AAGnD;;;;;;;;GAQG;AACH,eAAO,MAAM,SAAS;;;;;;wBAOrB,CAAC;AAEF,MAAM,MAAM,SAAS,GAAG,IAAI,CAAC,YAAY,CAAC,OAAO,SAAS,CAAC,CAAC"}

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

@@ -7,6 +7,5 @@ export declare const Memory: Type.Obj<{
     readonly title: string;
     readonly content: string;
 }, Schema.Struct.Fields>;
-export interface Memory extends Schema.Schema.Type<typeof Memory> {
-}
+export type Memory = Type.InstanceType<typeof Memory>;
 //# sourceMappingURL=Memory.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"Memory.d.ts","sourceRoot":"","sources":["../../../../src/types/Memory.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AAExC,OAAO,EAAc,IAAI,EAAE,MAAM,YAAY,CAAC;AAE9C;;GAEG;AACH,eAAO,MAAM,MAAM;;;wBAUlB,CAAC;AAEF,MAAM,WAAW,MAAO,SAAQ,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,MAAM,CAAC;CAAG"}
+{"version":3,"file":"Memory.d.ts","sourceRoot":"","sources":["../../../../src/types/Memory.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AAExC,OAAO,EAAmB,IAAI,EAAE,MAAM,YAAY,CAAC;AAEnD;;GAEG;AACH,eAAO,MAAM,MAAM;;;wBAQlB,CAAC;AAEF,MAAM,MAAM,MAAM,GAAG,IAAI,CAAC,YAAY,CAAC,OAAO,MAAM,CAAC,CAAC"}

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

@@ -8,7 +8,13 @@ export declare const Task: Schema.Struct<{
      */
     id: Schema.brand<typeof Schema.String, "@dxos/assistant-toolkit/TaskId">;
     title: Schema.SchemaClass<string, string, never>;
-    status: Schema.Literal<["todo", "in-progress", "done"]>;
+    status: Schema.Literal<["todo", "in-progress", "done", "failed"]>;
+    /**
+     * Whether this task was handed to a sub-agent via the delegation tool. Only delegated tasks are
+     * picked up by the supervisor's reconcile loop, so a task created via ordinary planning
+     * (`update-tasks`) is not double-spawned as a sub-agent.
+     */
+    delegated: Schema.optional<typeof Schema.Boolean>;
     /**
      * Parent task ID.
      */
@@ -16,18 +22,17 @@ export declare const Task: Schema.Struct<{
     /**
      * Chat object that this task is associated with.
      */
-    chat: Schema.optional<Ref.RefSchema<import("@dxos/echo/Entity").OfKind<import("@dxos/echo/internal").EntityKind.Object> & {
+    chat: Schema.optional<Ref.RefSchema<{
         readonly name?: string | undefined;
-        readonly feed: import("@dxos/echo/internal").Ref<import("@dxos/echo/Entity").OfKind<import("@dxos/echo/internal").EntityKind.Object> & {
+        readonly feed: import("@dxos/echo/internal").Ref<{
             readonly name?: string | undefined;
             readonly kind?: string | undefined;
             readonly namespace?: "data" | "trace" | undefined;
-        }>;
+        } & import("@dxos/echo/Entity").OfKind<import("@dxos/echo/internal").EntityKind.Object> & Obj.Unknown>;
         readonly view?: string | undefined;
-    }>>;
+    } & import("@dxos/echo/Entity").OfKind<import("@dxos/echo/internal").EntityKind.Object> & Obj.Unknown>>;
 }>;
-export interface Task extends Schema.Schema.Type<typeof Task> {
-}
+export type Task = Schema.Schema.Type<typeof Task>;
 /**
  * Hierarchical collection of tasks for humans and agents to track progress.
  */
@@ -35,50 +40,48 @@ export declare const Plan: Type.Obj<{
     readonly tasks: readonly {
         readonly id: string & import("effect/Brand").Brand<"@dxos/assistant-toolkit/TaskId">;
         readonly title: string;
-        readonly status: "done" | "in-progress" | "todo";
+        readonly status: "done" | "failed" | "in-progress" | "todo";
+        readonly delegated?: boolean | undefined;
         readonly parent?: (string & import("effect/Brand").Brand<"@dxos/assistant-toolkit/TaskId">) | undefined;
-        readonly chat?: import("@dxos/echo/internal").Ref<import("@dxos/echo/Entity").OfKind<import("@dxos/echo/internal").EntityKind.Object> & {
+        readonly chat?: import("@dxos/echo/internal").Ref<{
             readonly name?: string | undefined;
-            readonly feed: import("@dxos/echo/internal").Ref<import("@dxos/echo/Entity").OfKind<import("@dxos/echo/internal").EntityKind.Object> & {
+            readonly feed: import("@dxos/echo/internal").Ref<{
                 readonly name?: string | undefined;
                 readonly kind?: string | undefined;
                 readonly namespace?: "data" | "trace" | undefined;
-            }>;
+            } & import("@dxos/echo/Entity").OfKind<import("@dxos/echo/internal").EntityKind.Object> & Obj.Unknown>;
             readonly view?: string | undefined;
-        }> | undefined;
+        } & import("@dxos/echo/Entity").OfKind<import("@dxos/echo/internal").EntityKind.Object> & Obj.Unknown> | undefined;
     }[];
 }, Schema.Struct.Fields>;
-export interface Plan extends Schema.Schema.Type<typeof Plan> {
-}
+export type Plan = Type.InstanceType<typeof Plan>;
 export declare const generateTaskId: (plan: Plan) => TaskId;
 /**
  * Add new tasks to a plan, generating IDs for new tasks.
  * Use inside an `Obj.update` callback.
  */
-export declare const addTasks: (plan: Obj.Mutable<Plan>, tasks: (Pick<Task, 'title'> & Partial<Pick<Task, 'status' | 'parent' | 'chat'>>)[]) => {
+export declare const addTasks: (plan: Obj.Mutable<Plan>, tasks: (Pick<Task, 'title'> & Partial<Pick<Task, 'status' | 'parent' | 'chat' | 'delegated'>>)[]) => {
     "~@dxos/echo/Kind": import("@dxos/echo/internal").EntityKind.Object;
-    id: import("@dxos/keys").ObjectId;
+    id: import("@dxos/keys").EntityId;
     tasks: {
         id: string & import("effect/Brand").Brand<"@dxos/assistant-toolkit/TaskId">;
         title: string;
-        status: "done" | "in-progress" | "todo";
+        status: "done" | "failed" | "in-progress" | "todo";
+        delegated?: boolean | undefined;
         parent?: (string & import("effect/Brand").Brand<"@dxos/assistant-toolkit/TaskId">) | undefined;
-        chat?: import("@dxos/echo/internal").Ref<import("@dxos/echo/Entity").OfKind<import("@dxos/echo/internal").EntityKind.Object> & {
+        chat?: import("@dxos/echo/internal").Ref<{
             readonly name?: string | undefined;
-            readonly feed: import("@dxos/echo/internal").Ref<import("@dxos/echo/Entity").OfKind<import("@dxos/echo/internal").EntityKind.Object> & {
+            readonly feed: import("@dxos/echo/internal").Ref<{
                 readonly name?: string | undefined;
                 readonly kind?: string | undefined;
                 readonly namespace?: "data" | "trace" | undefined;
-            }>;
+            } & import("@dxos/echo/Entity").OfKind<import("@dxos/echo/internal").EntityKind.Object> & Obj.Unknown>;
             readonly view?: string | undefined;
-        }> | undefined;
+        } & import("@dxos/echo/Entity").OfKind<import("@dxos/echo/internal").EntityKind.Object> & Obj.Unknown> | undefined;
     }[];
 };
 interface MakePlanProps {
-    tasks: {
-        title: string;
-        status?: 'todo' | 'in-progress' | 'done';
-    }[];
+    tasks: (Pick<Task, 'title'> & Partial<Pick<Task, 'status'>>)[];
 }
 export declare const makePlan: (props: MakePlanProps) => Plan;
 /**

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

@@ -1 +1 @@
-{"version":3,"file":"Plan.d.ts","sourceRoot":"","sources":["../../../../src/types/Plan.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AAExC,OAAO,EAAc,GAAG,EAAE,GAAG,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AAIxD,eAAO,MAAM,MAAM,sEAAqE,CAAC;AACzF,MAAM,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,MAAM,CAAC,CAAC;AAEvD,eAAO,MAAM,IAAI;IACf;;OAEG;;;;IASH;;OAEG;;IAKH;;OAEG;;;;;;;;;;EAEH,CAAC;AACH,MAAM,WAAW,IAAK,SAAQ,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,IAAI,CAAC;CAAG;AAEhE;;GAEG;AACH,eAAO,MAAM,IAAI;;;;;;;;;;;;;;;;wBAQhB,CAAC;AACF,MAAM,WAAW,IAAK,SAAQ,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,IAAI,CAAC;CAAG;AAEhE,eAAO,MAAM,cAAc,SAAU,IAAI,KAAG,MAe3C,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,QAAQ,SACb,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,SAChB,CAAC,IAAI,CAAC,IAAI,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,IAAI,EAAE,QAAQ,GAAG,QAAQ,GAAG,MAAM,CAAC,CAAC,CAAC,EAAE;;;;;;;;;;;;;;;;;;CAOnF,CAAC;AAEF,UAAU,aAAa;IACrB,KAAK,EAAE;QACL,KAAK,EAAE,MAAM,CAAC;QACd,MAAM,CAAC,EAAE,MAAM,GAAG,aAAa,GAAG,MAAM,CAAC;KAC1C,EAAE,CAAC;CACL;AAED,eAAO,MAAM,QAAQ,UAAW,aAAa,KAAG,IAM/C,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,UAAU,SAAU,IAAI,KAAG,MAIvC,CAAC"}
+{"version":3,"file":"Plan.d.ts","sourceRoot":"","sources":["../../../../src/types/Plan.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AAExC,OAAO,EAAmB,GAAG,EAAE,GAAG,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AAI7D,eAAO,MAAM,MAAM,sEAAqE,CAAC;AACzF,MAAM,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,MAAM,CAAC,CAAC;AAEvD,eAAO,MAAM,IAAI;IACf;;OAEG;;;;IASH;;;;OAIG;;IAGH;;OAEG;;IAKH;;OAEG;;;;;;;;;;EAEH,CAAC;AAEH,MAAM,MAAM,IAAI,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,IAAI,CAAC,CAAC;AACnD;;GAEG;AACH,eAAO,MAAM,IAAI;;;;;;;;;;;;;;;;;wBAEuF,CAAC;AACzG,MAAM,MAAM,IAAI,GAAG,IAAI,CAAC,YAAY,CAAC,OAAO,IAAI,CAAC,CAAC;AAClD,eAAO,MAAM,cAAc,SAAU,IAAI,KAAG,MAe3C,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,QAAQ,SACb,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,SAChB,CAAC,IAAI,CAAC,IAAI,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,IAAI,EAAE,QAAQ,GAAG,QAAQ,GAAG,MAAM,GAAG,WAAW,CAAC,CAAC,CAAC,EAAE;;;;;;;;;;;;;;;;;;;CAOjG,CAAC;AAEF,UAAU,aAAa;IACrB,KAAK,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC;CAChE;AAED,eAAO,MAAM,QAAQ,UAAW,aAAa,KAAG,IAM/C,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,UAAU,SAAU,IAAI,KAAG,MAIvC,CAAC"}