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

package/src/blueprints/{project-wizard/functions → agent-wizard/operations}/sync-triggers.ts

@@ -5,9 +5,8 @@
 import * as Effect from 'effect/Effect';
 import * as Option from 'effect/Option';
 
-import { Trigger } from '@dxos/compute';
-import { Operation } from '@dxos/compute';
-import { Database, Feed, Filter, Obj, Ref } from '@dxos/echo';
+import { Trigger, Operation } from '@dxos/compute';
+import { Database, Feed, Filter, Obj, Ref, Type } from '@dxos/echo';
 import { FeedAnnotation } from '@dxos/schema';
 
 import { Agent } from '../../../types';
@@ -23,7 +22,7 @@ export default SyncTriggers.pipe(
 );
 
 /**
- * Foreign key {@link AGENT_TRIGGER_EXTENSION_KEY} => <agent id : ObjectId>.
+ * Foreign key {@link AGENT_TRIGGER_EXTENSION_KEY} => <agent id : EntityId>.
  */
 const AGENT_TRIGGER_EXTENSION_KEY = 'org.dxos.extension.AgentTrigger';
 
@@ -34,11 +33,11 @@ const AGENT_TRIGGER_TARGET_EXTENSION_KEY = 'org.dxos.extension.AgentTriggerTarge
 
 /** Checks if an object's schema has the FeedAnnotation. */
 const hasFeedAnnotation = (obj: Obj.Unknown): boolean => {
-  const schema = Obj.getSchema(obj);
-  if (!schema) {
+  const type = Obj.getType(obj);
+  if (!type) {
     return false;
   }
-  const annotation = FeedAnnotation.get(schema);
+  const annotation = FeedAnnotation.get(Type.getSchema(type));
   return Option.isSome(annotation) && annotation.value === true;
 };
 
@@ -47,9 +46,9 @@ const hasFeedAnnotation = (obj: Obj.Unknown): boolean => {
  */
 const syncAgentTriggers = (agent: Agent.Agent): Effect.Effect<void, never, Database.Service> =>
   Effect.gen(function* () {
-    const triggers = yield* Database.runQuery(
+    const triggers = yield* Database.query(
       Filter.foreignKeys(Trigger.Trigger, [{ source: AGENT_TRIGGER_EXTENSION_KEY, id: agent.id }]),
-    );
+    ).run;
 
     // Remove all existing triggers — they will be recreated with the current config.
     // This ensures operation, concurrency, and enabled stay in sync when agent fields change.
@@ -60,10 +59,13 @@ const syncAgentTriggers = (agent: Agent.Agent): Effect.Effect<void, never, Datab
     const triggersEnabled = agent.enabled ?? true;
 
     // Lazy import to avoid circular dependency issues.
-    const { Qualifier, AgentWorker } = yield* Effect.promise(() => import('../../project'));
+    const { Qualifier, AgentWorker } = yield* Effect.promise(() => import('../../agent/operations/definitions'));
 
     for (const subscription of agent.subscriptions) {
-      const targetOption = yield* Database.loadOption(subscription);
+      const targetOption = yield* Database.load(subscription).pipe(
+        Effect.map(Option.some),
+        Effect.catchTag('EntityNotFoundError', () => Effect.succeed(Option.none())),
+      );
       if (Option.isNone(targetOption)) {
         continue;
       }
@@ -74,15 +76,17 @@ const syncAgentTriggers = (agent: Agent.Agent): Effect.Effect<void, never, Datab
         feedObj = target;
       } else if (hasFeedAnnotation(target)) {
         const feedRef = (target as Obj.Unknown & { feed?: Ref.Ref<Feed.Feed> }).feed;
-        feedObj = feedRef ? Option.getOrUndefined(yield* Database.loadOption(feedRef)) : undefined;
+        feedObj = feedRef
+          ? Option.getOrUndefined(
+              yield* Database.load(feedRef).pipe(
+                Effect.map(Option.some),
+                Effect.catchTag('EntityNotFoundError', () => Effect.succeed(Option.none())),
+              ),
+            )
+          : undefined;
       }
 
-      const queueDxn = Option.fromNullable(feedObj).pipe(
-        Option.filter(Obj.instanceOf(Feed.Feed)),
-        Option.map(Feed.getQueueDxn),
-        Option.getOrUndefined,
-      );
-      if (!queueDxn) {
+      if (!feedObj || !Obj.instanceOf(Feed.Feed, feedObj) || !Feed.getQueueUri(feedObj)) {
         continue;
       }
 
@@ -94,11 +98,11 @@ const syncAgentTriggers = (agent: Agent.Agent): Effect.Effect<void, never, Datab
           [Obj.Meta]: {
             keys: [
               { source: AGENT_TRIGGER_EXTENSION_KEY, id: agent.id },
-              { source: AGENT_TRIGGER_TARGET_EXTENSION_KEY, id: subscription.dxn.toString() },
+              { source: AGENT_TRIGGER_TARGET_EXTENSION_KEY, id: subscription.uri },
             ],
           },
           enabled: triggersEnabled,
-          spec: Trigger.specQueue(queueDxn.toString()),
+          spec: Trigger.specFeed(feedObj),
           function: Ref.make(Operation.serialize(filterEvents ? Qualifier : AgentWorker)),
           input: {
             agent: Ref.make(agent),
@@ -109,28 +113,34 @@ const syncAgentTriggers = (agent: Agent.Agent): Effect.Effect<void, never, Datab
       );
     }
 
-    if ((agent.filterEvents ?? true) && agent.queue) {
-      yield* Database.add(
-        Trigger.make({
-          [Obj.Parent]: agent,
-          [Obj.Meta]: {
-            keys: [
-              { source: AGENT_TRIGGER_EXTENSION_KEY, id: agent.id },
-              {
-                source: AGENT_TRIGGER_TARGET_EXTENSION_KEY,
-                id: Obj.getDXN(agent)?.toString() ?? '',
-              },
-            ],
-          },
-          function: Ref.make(Operation.serialize(AgentWorker)),
-          enabled: triggersEnabled,
-          spec: Trigger.specQueue(agent.queue.dxn.toString()),
-          input: {
-            agent: Ref.make(agent),
-            event: '{{event}}',
-          },
-        }),
+    if ((agent.filterEvents ?? true) && agent.feed) {
+      const agentFeedOption = yield* Database.load(agent.feed).pipe(
+        Effect.map(Option.some),
+        Effect.catchTag('EntityNotFoundError', () => Effect.succeed(Option.none())),
       );
+      if (Option.isSome(agentFeedOption) && Feed.getQueueUri(agentFeedOption.value)) {
+        yield* Database.add(
+          Trigger.make({
+            [Obj.Parent]: agent,
+            [Obj.Meta]: {
+              keys: [
+                { source: AGENT_TRIGGER_EXTENSION_KEY, id: agent.id },
+                {
+                  source: AGENT_TRIGGER_TARGET_EXTENSION_KEY,
+                  id: Obj.getURI(agent) ?? '',
+                },
+              ],
+            },
+            function: Ref.make(Operation.serialize(AgentWorker)),
+            enabled: triggersEnabled,
+            spec: Trigger.specFeed(agentFeedOption.value),
+            input: {
+              agent: Ref.make(agent),
+              event: '{{event}}',
+            },
+          }),
+        );
+      }
     }
 
     // Timer trigger bypasses the qualifier and invokes the agent worker directly on a schedule.

package/src/blueprints/automation/blueprint.ts

@@ -2,10 +2,8 @@
 // Copyright 2026 DXOS.org
 //
 
-import { Blueprint } from '@dxos/compute';
-import { Trigger } from '@dxos/compute';
-import { Operation } from '@dxos/compute';
-import { Ref } from '@dxos/echo';
+import { Blueprint, Trigger, Operation } from '@dxos/compute';
+import { Ref, Type } from '@dxos/echo';
 import { Text } from '@dxos/schema';
 import { trim } from '@dxos/util';
 
@@ -21,7 +19,7 @@ const instructions = trim`
   Triggers are configured by the properties of the Trigger object.
   - enabled: Must be true for trigger to run.
   - spec: Events that the trigger matches.
-  - function: Ref to a ${Operation.PersistentOperation.typename} object that will be invoked. Query the functions present in the space first, and reference them in the trigger.
+  - function: Ref to a ${Type.getTypename(Operation.PersistentOperation)} object that will be invoked. Query the functions present in the space first, and reference them in the trigger.
   - input: The spec of the input data that will be passed to the function.
 
   ## Input patterns
@@ -34,21 +32,21 @@ const instructions = trim`
   {
     item: '{{event.item}}',
     instructions: 'Summarize and perform entity-extraction'
-    mailbox: { '/': 'dxn:echo:AAA:ZZZ' }
+    mailbox: { '/': 'echo://AAA/ZZZ' }
   }
 
   ## Trigger kinds
 
   - Timer: Triggered by a cron schedule.
   - Queue: Subscribes and processes items begginging to end.
-            Note: queues are the same as feeds. The queue DXN should be of form: dxn:queue:data:<space-id>:<queue-id>.
+            Note: queues are the same as feeds. The queue EID should be of form: echo://<space-id>/<queue-id>.
   - Subscription: Subscribes and processes database items based on a query.
 
   Avoid: email and webhook triggers.
 
   ## Editing triggers
 
-  Triggers are represented as objects of type ${Trigger.Trigger.typename}.
+  Triggers are represented as objects of type ${Type.getTypename(Trigger.Trigger)}.
   You need access to the Database blueprint to manipulate triggers.
   Read trigger schema before manipulating triggers.
   Having a Trigger object in the database is enough to setup an automation. 
@@ -58,7 +56,7 @@ const instructions = trim`
   Timer:
 
   {
-    "function": { "/": "dxn:echo:AAA:ZZZ" },
+    "function": { "/": "echo://AAA/ZZZ" },
     "enabled": true,
     "spec": {
       "kind": "timer",
@@ -69,22 +67,22 @@ const instructions = trim`
   Queue:
 
   {
-    "function": { "/": "dxn:echo:AAA:ZZZ" },
+    "function": { "/": "echo://AAA/ZZZ" },
     "enabled": true,
     "spec": {
       "kind": "queue",
-      "queue": "dxn:queue:data:XXX:YYY"
+      "queue": "echo://XXX/YYY"
     }
   }
 
   Subscription:
 
   {
-    "function": { "/": "dxn:echo:AAA:ZZZ" },
+    "function": { "/": "echo://AAA/ZZZ" },
     "enabled": true,
     "spec": {
       "kind": "subscription",
-      "query": { "ast": { "type": "select", "filter": { "type": "object", "typename": "dxn:type:org.dxos.type.person" } } }
+      "query": { "ast": { "type": "select", "filter": { "type": "object", "typename": "dxn:org.dxos.type.person" } } }
     }
   }
 `;
@@ -95,7 +93,7 @@ const make = () =>
     name: 'Triggers',
     description: 'Trigger management and automation.',
     instructions: {
-      source: Ref.make(Text.make(instructions)),
+      source: Ref.make(Text.make({ content: instructions })),
     },
   });
 

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

@@ -1 +1 @@
-{"conversations":[{"parameters":{"model":"@anthropic/claude-opus-4-6","stream":true,"tools":[{"name":"query-blueprints","description":"Queries available blueprints.","inputSchema":{"type":"object","properties":{},"required":[],"additionalProperties":false}},{"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":{"type":"object","properties":{},"required":[],"additionalProperties":false}}]},"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  - org.dxos.blueprint.database \"Database\" -- Query and manipulate objects in the ECHO database. [agent-can-enable]\n  - org.dxos.blueprint.discord \"Discord\" -- Discord integration.\n  - org.dxos.blueprint.memory \"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_01TBTMGS3U1dSyujvADu5sV7","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","metadata":{}},{"type":"reasoning-delta","id":"0","delta":" from the registry.","metadata":{}},{"type":"reasoning-delta","id":"0","delta":"","metadata":{"anthropic":{"type":"thinking","signature":"EvIBClkIDBgCKkB80YOcko364VSaulfRzM8X76fyNXMnETkUUFoQcYpg3o7JCxnTb9ja4DC5rFEIzSicbmTYjXBq1JLzZZkSAcy9Mg9jbGF1ZGUtb3B1cy00LTY4ABIMfcn16jEiZ4g9FNh8GgwaXU83DG0p7kZNgmoiMHkhZF/0sINKrWl2dk944tPJZcL7iozZSBbyoSljWkuwPm2wyoCoyEnQq8Fh/oTVKipHb5R/moX69znTniGyL9IWD/+E1gsQlBRU0HASMJDBrG0q1xUUV//caZbNPboZrFdCXnjSb7DZJMZRwLeqrS4mIIJlPs/SkKUYAQ=="}}},{"type":"reasoning-end","id":"0","metadata":{}},{"type":"text-start","id":"1","metadata":{}},{"type":"text-delta","id":"1","delta":"I'll refresh the blueprints from the registry now to ensure the database copies are up to date.","metadata":{}},{"type":"text-end","id":"1","metadata":{}},{"type":"tool-params-start","id":"toolu_015Euwfup8HAM1CjYav9Tubf","name":"refresh-blueprints","providerExecuted":false,"metadata":{}},{"type":"tool-params-delta","id":"toolu_015Euwfup8HAM1CjYav9Tubf","delta":"","metadata":{}},{"type":"tool-params-end","id":"toolu_015Euwfup8HAM1CjYav9Tubf","metadata":{}},{"type":"finish","reason":"tool-calls","usage":{"inputTokens":1144,"outputTokens":80,"totalTokens":1224},"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":1144,"output_tokens":8,"server_tool_use":null,"service_tier":"standard"}}}}]},{"parameters":{"model":"@anthropic/claude-opus-4-6","stream":true,"tools":[{"name":"query-blueprints","description":"Queries available blueprints.","inputSchema":{"type":"object","properties":{},"required":[],"additionalProperties":false}},{"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":{"type":"object","properties":{},"required":[],"additionalProperties":false}}]},"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  - org.dxos.blueprint.database \"Database\" -- Query and manipulate objects in the ECHO database. [agent-can-enable]\n  - org.dxos.blueprint.discord \"Discord\" -- Discord integration.\n  - org.dxos.blueprint.memory \"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.","options":{}},{"type":"text","text":"I'll refresh the blueprints from the registry now to ensure the database copies are up to date.","options":{}},{"type":"tool-call","id":"toolu_015Euwfup8HAM1CjYav9Tubf","name":"refresh-blueprints","params":{},"providerExecuted":false,"options":{}}],"options":{}},{"role":"tool","content":[{"type":"tool-result","id":"toolu_015Euwfup8HAM1CjYav9Tubf","name":"refresh-blueprints","isFailure":false,"result":{},"providerExecuted":false,"options":{}}],"options":{"anthropic":{"cacheControl":{"ttl":"5m","type":"ephemeral"}}}}]},"response":[{"type":"response-metadata","id":"msg_01SR6yhAEXWUYe4x4rQj1C7s","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 registry definitions. Everything should now be in sync.","metadata":{}},{"type":"text-end","id":"0","metadata":{}},{"type":"finish","reason":"stop","usage":{"inputTokens":1187,"outputTokens":31,"totalTokens":1218},"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":1187,"output_tokens":5,"server_tool_use":null,"service_tier":"standard"}}}}]}]}
+{"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"}}}}]}]}

package/src/blueprints/blueprint-manager/blueprint.test.ts

@@ -6,21 +6,18 @@ import { describe, expect, it } from '@effect/vitest';
 import * as Effect from 'effect/Effect';
 import * as Layer from 'effect/Layer';
 
-import { MemoizedAiService } from '@dxos/ai/testing';
-import { AiContextService, AiSessionService } from '@dxos/assistant';
-import { Blueprint } from '@dxos/compute';
-import { Operation } from '@dxos/compute';
-import { Database, DXN, Obj, Ref } from '@dxos/echo';
+import { AiContext, AiSession } from '@dxos/assistant';
+import { Blueprint, Operation } from '@dxos/compute';
+import { Obj } from '@dxos/echo';
 import { TestHelpers } from '@dxos/effect/testing';
 import { AssistantTestLayer } from '@dxos/functions-runtime/testing';
-import { ObjectId } from '@dxos/keys';
-import { trim } from '@dxos/util';
+import { EntityId } from '@dxos/keys';
 
 import { DatabaseBlueprint, DiscordBlueprint, MemoryBlueprint } from '../index';
-import BlueprintManagerDefinition from './blueprint';
-import { BlueprintManagerHandlers, EnableBlueprints, QueryBlueprints } from './functions';
+import { BlueprintManagerHandlers } from './operations';
+import { EnableBlueprints, QueryBlueprints } from './operations/definitions';
 
-ObjectId.dangerouslyDisableRandomness();
+EntityId.dangerouslyDisableRandomness();
 
 const TestLayer = AssistantTestLayer({
   aiServicePreset: 'edge-remote',
@@ -30,14 +27,14 @@ const TestLayer = AssistantTestLayer({
   tracing: 'pretty',
 });
 
-const provideTestLayers = Effect.provide(AiSessionService.layerNewFeed().pipe(Layer.provideMerge(TestLayer)));
+const provideTestLayers = Effect.provide(AiSession.Service.layerNewFeed().pipe(Layer.provideMerge(TestLayer)));
 
 /**
  * Gets the conversation DXN for passing to Operation.invoke options.
  */
-const getConversationDxn = Effect.gen(function* () {
-  const session = yield* AiSessionService;
-  return Obj.getDXN(session.feed).toString() as DXN.String;
+const getConversationDXN = Effect.gen(function* () {
+  const session = yield* AiSession.Service;
+  return Obj.getURI(session.feed);
 });
 
 describe('Blueprint Manager', () => {
@@ -45,10 +42,10 @@ describe('Blueprint Manager', () => {
     'query-blueprints: returns all registered blueprints',
     Effect.fnUntraced(
       function* (_) {
-        const conversation = yield* getConversationDxn;
+        const conversation = yield* getConversationDXN;
         const result = yield* Operation.invoke(QueryBlueprints, {}, { conversation });
         expect(result).toHaveLength(3);
-        const keys = result.map((blueprint: Blueprint.Blueprint) => blueprint.key);
+        const keys = result.map((blueprint: Blueprint.Blueprint) => Obj.getMeta(blueprint).key);
         expect(keys).toContain('org.dxos.blueprint.database');
         expect(keys).toContain('org.dxos.blueprint.memory');
         expect(keys).toContain('org.dxos.blueprint.discord');
@@ -63,19 +60,21 @@ describe('Blueprint Manager', () => {
     'enable-blueprints: enables blueprints with agentCanEnable=true',
     Effect.fnUntraced(
       function* (_) {
-        const conversation = yield* getConversationDxn;
+        const conversation = yield* getConversationDXN;
         const { enabled, rejected } = yield* Operation.invoke(
           EnableBlueprints,
           { keys: ['org.dxos.blueprint.database'] },
           { conversation },
         );
         expect(enabled).toHaveLength(1);
-        expect(enabled[0].key).toBe('org.dxos.blueprint.database');
+        expect(Obj.getMeta(enabled[0]).key).toBe('org.dxos.blueprint.database');
         expect(rejected).toHaveLength(0);
 
-        const { binder } = yield* AiContextService;
+        const { binder } = yield* AiContext.Service;
         const bound = binder.getBlueprints();
-        expect(bound.some((bp: Blueprint.Blueprint) => bp.key === 'org.dxos.blueprint.database')).toBe(true);
+        expect(bound.some((bp: Blueprint.Blueprint) => Obj.getMeta(bp).key === 'org.dxos.blueprint.database')).toBe(
+          true,
+        );
       },
       provideTestLayers,
       TestHelpers.provideTestContext,
@@ -87,7 +86,7 @@ describe('Blueprint Manager', () => {
     'enable-blueprints: rejects blueprints without agentCanEnable',
     Effect.fnUntraced(
       function* (_) {
-        const conversation = yield* getConversationDxn;
+        const conversation = yield* getConversationDXN;
         const { enabled, rejected } = yield* Operation.invoke(
           EnableBlueprints,
           { keys: ['org.dxos.blueprint.discord'] },
@@ -97,9 +96,11 @@ describe('Blueprint Manager', () => {
         expect(rejected).toHaveLength(1);
         expect(rejected[0].key).toBe('org.dxos.blueprint.discord');
 
-        const { binder } = yield* AiContextService;
+        const { binder } = yield* AiContext.Service;
         const bound = binder.getBlueprints();
-        expect(bound.some((bp: Blueprint.Blueprint) => bp.key === 'org.dxos.blueprint.discord')).toBe(false);
+        expect(bound.some((bp: Blueprint.Blueprint) => Obj.getMeta(bp).key === 'org.dxos.blueprint.discord')).toBe(
+          false,
+        );
       },
       provideTestLayers,
       TestHelpers.provideTestContext,
@@ -111,7 +112,7 @@ describe('Blueprint Manager', () => {
     'enable-blueprints: mixed keys enables only allowed ones',
     Effect.fnUntraced(
       function* (_) {
-        const conversation = yield* getConversationDxn;
+        const conversation = yield* getConversationDXN;
         const { enabled, rejected } = yield* Operation.invoke(
           EnableBlueprints,
           {
@@ -120,7 +121,7 @@ describe('Blueprint Manager', () => {
           { conversation },
         );
         expect(enabled).toHaveLength(2);
-        const enabledKeys = enabled.map((bp: Blueprint.Blueprint) => bp.key);
+        const enabledKeys = enabled.map((bp: Blueprint.Blueprint) => Obj.getMeta(bp).key);
         expect(enabledKeys).toContain('org.dxos.blueprint.database');
         expect(enabledKeys).toContain('org.dxos.blueprint.memory');
         expect(rejected).toHaveLength(1);
@@ -136,7 +137,7 @@ describe('Blueprint Manager', () => {
     'enable-blueprints: unknown keys are rejected with reason',
     Effect.fnUntraced(
       function* (_) {
-        const conversation = yield* getConversationDxn;
+        const conversation = yield* getConversationDXN;
         const { enabled, rejected } = yield* Operation.invoke(
           EnableBlueprints,
           { keys: ['org.dxos.blueprint.nonexistent'] },
@@ -152,48 +153,4 @@ describe('Blueprint Manager', () => {
     ),
     { timeout: 30_000 },
   );
-
-  it.scoped(
-    'refresh-blueprints: agent syncs a mutated database blueprint from the registry',
-    Effect.fnUntraced(
-      function* (_) {
-        const registry = yield* Blueprint.RegistryService;
-        const canonical = registry.getByKey('org.dxos.blueprint.database');
-        expect(canonical).toBeDefined();
-
-        const stored = yield* Blueprint.upsert('org.dxos.blueprint.database');
-        const originalName = stored.name;
-        Obj.update(stored, (stored) => {
-          stored.name = '___TEST_MUTATED_BLUEPRINT_NAME___';
-        });
-        yield* Database.flush();
-        expect(stored.name).toBe('___TEST_MUTATED_BLUEPRINT_NAME___');
-
-        const session = yield* AiSessionService;
-        yield* Effect.promise(() => session.context.open());
-        yield* Effect.promise(() =>
-          session.context.bind({
-            blueprints: [Ref.make(BlueprintManagerDefinition.make())],
-          }),
-        );
-
-        yield* session
-          .createRequest({
-            system: trim`
-            You can call blueprint manager tools. When asked to refresh or sync blueprints from the registry,
-            call the refresh blueprints tool once and then stop.
-          `,
-            prompt: trim`
-            Refresh blueprints from the registry so database copies match the built-in definitions.
-          `,
-          })
-          .pipe(Effect.provide(session.makeToolExecutionServices()));
-
-        expect(stored.name).toBe(originalName);
-      },
-      provideTestLayers,
-      TestHelpers.provideTestContext,
-    ),
-    MemoizedAiService.isGenerationEnabled() ? 240_000 : 60_000,
-  );
 });

package/src/blueprints/blueprint-manager/blueprint.ts

@@ -3,11 +3,12 @@
 //
 
 import { Blueprint, Template } from '@dxos/compute';
+import { DXN } from '@dxos/keys';
 import { trim } from '@dxos/util';
 
-import { EnableBlueprints, QueryBlueprints, UpdateBlueprints } from './functions';
+import { EnableBlueprints, QueryBlueprints } from './operations/definitions';
 
-const BLUEPRINT_KEY = 'org.dxos.blueprint.blueprint-manager';
+const BLUEPRINT_KEY = 'org.dxos.blueprint.blueprintManager';
 
 const make = () =>
   Blueprint.make({
@@ -18,7 +19,6 @@ const make = () =>
       source: trim`
         You can query available blueprints and enable them in the current conversation.
         Use [query-blueprints] to refresh the list of available blueprints.
-        Use [refresh-blueprints] to update blueprint objects stored in the database from the built-in registry when they have drifted.
         Use [enable-blueprints] to enable blueprints by their keys. Always call [query-blueprints] first.
         Only blueprints with agentCanEnable=true can be enabled by the agent.
 
@@ -33,12 +33,12 @@ const make = () =>
       inputs: [
         {
           name: 'blueprints',
-          kind: 'function',
-          function: QueryBlueprints.meta.key,
+          kind: 'operation',
+          operation: DXN.getName(QueryBlueprints.meta.key),
         },
       ],
     }),
-    tools: Blueprint.toolDefinitions({ operations: [QueryBlueprints, EnableBlueprints, UpdateBlueprints] }),
+    tools: Blueprint.toolDefinitions({ operations: [QueryBlueprints, EnableBlueprints] }),
   });
 
 const blueprint: Blueprint.Definition = {

package/src/blueprints/blueprint-manager/index.ts

@@ -3,4 +3,4 @@
 //
 
 export { default as BlueprintManagerBlueprint } from './blueprint';
-export { QueryBlueprints, EnableBlueprints, BlueprintManagerHandlers } from './functions';
+export { BlueprintManagerHandlers, BlueprintManagerOperations } from './operations';

package/src/blueprints/blueprint-manager/operations/definitions.ts

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

package/src/blueprints/blueprint-manager/{functions → operations}/enable-blueprints.ts

@@ -3,10 +3,10 @@
 //
 
 import * as Effect from 'effect/Effect';
+import * as Either from 'effect/Either';
 
-import { AiContextService } from '@dxos/assistant';
-import { Blueprint } from '@dxos/compute';
-import { Operation } from '@dxos/compute';
+import { AiContext } from '@dxos/assistant';
+import { Blueprint, Operation } from '@dxos/compute';
 import { Ref } from '@dxos/echo';
 
 import { EnableBlueprints } from './definitions';
@@ -14,17 +14,19 @@ import { EnableBlueprints } from './definitions';
 export default EnableBlueprints.pipe(
   Operation.withHandler(
     Effect.fnUntraced(function* ({ keys }) {
-      const registry = yield* Blueprint.RegistryService;
       const enabled: Blueprint.Blueprint[] = [];
       const rejected: { key: string; reason: string }[] = [];
 
       for (const key of keys) {
-        const blueprint = registry.getByKey(key);
-        if (!blueprint) {
-          rejected.push({ key, reason: 'Blueprint not found in registry.' });
+        const result = yield* Blueprint.resolve(key).pipe(
+          Effect.mapError(() => ({ key, reason: 'Blueprint not found in registry.' })),
+          Effect.either,
+        );
+        if (Either.isLeft(result)) {
+          rejected.push(result.left);
           continue;
         }
-        if (!blueprint.agentCanEnable) {
+        if (!result.right.agentCanEnable) {
           rejected.push({ key, reason: 'Blueprint does not allow agent auto-enable (agentCanEnable is not set).' });
           continue;
         }
@@ -33,7 +35,7 @@ export default EnableBlueprints.pipe(
       }
 
       if (enabled.length > 0) {
-        yield* AiContextService.bindContext({
+        yield* AiContext.Service.bindContext({
           blueprints: enabled.map(Ref.make),
         });
       }

package/src/blueprints/blueprint-manager/{functions → operations}/index.ts

@@ -4,10 +4,9 @@
 
 import { OperationHandlerSet } from '@dxos/compute';
 
-export * from './definitions';
+export * as BlueprintManagerOperations from './definitions';
 
 export const BlueprintManagerHandlers = OperationHandlerSet.lazy(
   () => import('./query-blueprints'),
   () => import('./enable-blueprints'),
-  () => import('./update-blueprints'),
 );