@dxos/assistant-toolkit 0.8.4-main.9be5663bfe → 0.8.4-main.abd8ff62ef

package/src/blueprints/project/blueprint.test.ts

@@ -7,19 +7,20 @@ import * as Effect from 'effect/Effect';
 import * as Exit from 'effect/Exit';
 
 import { MemoizedAiService } from '@dxos/ai/testing';
-import { AiConversation } from '@dxos/assistant';
-import { AssistantTestLayerWithTriggers } from '@dxos/assistant/testing';
-import { Blueprint } from '@dxos/blueprints';
+import { AiSession } from '@dxos/assistant';
 import { SpaceProperties } from '@dxos/client-protocol';
-import { Database, Feed, Obj, Ref } from '@dxos/echo';
+import { Blueprint, Trigger, Operation, OperationHandlerSet } from '@dxos/compute';
+import { Database, Feed, Filter, Obj, Query, Ref } from '@dxos/echo';
 import { Collection } from '@dxos/echo';
 import { acquireReleaseResource } from '@dxos/effect';
 import { TestHelpers } from '@dxos/effect/testing';
-import { QueueService, Trigger } from '@dxos/functions';
+import { QueueService } from '@dxos/functions';
 import { TriggerDispatcher } from '@dxos/functions-runtime';
+import { AssistantTestLayerWithTriggers } from '@dxos/functions-runtime/testing';
 import { invariant } from '@dxos/invariant';
 import { ObjectId } from '@dxos/keys';
-import { Operation, OperationHandlerSet } from '@dxos/operation';
+import { MarkdownBlueprint } from '@dxos/plugin-markdown/blueprints';
+import { MarkdownOperationHandlerSet } from '@dxos/plugin-markdown/operations';
 import { WithProperties } from '@dxos/plugin-markdown/testing';
 import { Markdown } from '@dxos/plugin-markdown/types';
 import { Text } from '@dxos/schema';
@@ -27,8 +28,8 @@ import { Message } from '@dxos/types';
 import { trim } from '@dxos/util';
 
 import { Chat, Plan, Agent } from '../../types';
-import { MarkdownBlueprint, MarkdownHandlers } from '../markdown';
 import { PlanningBlueprint, PlanningHandlers } from '../planning';
+import { AgentWizardHandlers, SyncTriggers } from '../project-wizard';
 import AgentBlueprintDef from './blueprint';
 import { AgentWorker, AgentBlueprintHandlers } from './functions';
 
@@ -36,7 +37,12 @@ ObjectId.dangerouslyDisableRandomness();
 
 const TestLayer = AssistantTestLayerWithTriggers({
   aiServicePreset: 'edge-remote',
-  operationHandlers: OperationHandlerSet.merge(AgentBlueprintHandlers, MarkdownHandlers, PlanningHandlers),
+  operationHandlers: OperationHandlerSet.merge(
+    AgentBlueprintHandlers,
+    AgentWizardHandlers,
+    MarkdownOperationHandlerSet,
+    PlanningHandlers,
+  ),
   types: [
     Agent.Agent,
     Plan.Plan,
@@ -69,7 +75,7 @@ describe('Agent', () => {
         const agent = yield* Agent.makeInitialized(
           {
             name: 'Test Project',
-            spec: 'A test project for adding artifacts.',
+            instructions: 'A test project for adding artifacts.',
             blueprints: [Ref.make(MarkdownBlueprint.make())],
           },
           blueprint,
@@ -89,14 +95,16 @@ describe('Agent', () => {
         const chatFeed = agent.chat?.target?.feed?.target;
         invariant(chatFeed, 'Agent chat feed not found.');
         const runtime = yield* Effect.runtime<Feed.FeedService>();
-        const conversation = yield* acquireReleaseResource(() => new AiConversation({ feed: chatFeed, runtime }));
-        yield* Effect.promise(() => conversation.context.open());
+        const session = yield* acquireReleaseResource(() => new AiSession({ feed: chatFeed, runtime }));
+        yield* Effect.promise(() => session.context.open());
 
         const documentDxn = Obj.getDXN(document);
-        yield* conversation.createRequest({
-          system: SYSTEM,
-          prompt: `Please add the document ${documentDxn} as an artifact named "My Test Document" to this agent.`,
-        });
+        yield* session
+          .createRequest({
+            system: SYSTEM,
+            prompt: `Please add the document ${documentDxn} as an artifact named "My Test Document" to this agent.`,
+          })
+          .pipe(Effect.provide(session.makeToolExecutionServices()));
 
         expect(agent.artifacts).toHaveLength(1);
         expect(agent.artifacts[0].name).toBe('My Test Document');
@@ -116,7 +124,7 @@ describe('Agent', () => {
         const agent = yield* Agent.makeInitialized(
           {
             name: 'Shopping list',
-            spec: 'Keep a shopping list of items to buy.',
+            instructions: 'Keep a shopping list of items to buy.',
             blueprints: [Ref.make(MarkdownBlueprint.make())],
           },
           blueprint,
@@ -125,13 +133,15 @@ describe('Agent', () => {
         invariant(chatFeed, 'Agent chat feed not found.');
         yield* Database.flush();
         const runtime = yield* Effect.runtime<Feed.FeedService>();
-        const conversation = yield* acquireReleaseResource(() => new AiConversation({ feed: chatFeed, runtime }));
-        yield* Effect.promise(() => conversation.context.open());
+        const session = yield* acquireReleaseResource(() => new AiSession({ feed: chatFeed, runtime }));
+        yield* Effect.promise(() => session.context.open());
 
-        yield* conversation.createRequest({
-          system: SYSTEM,
-          prompt: `List ingredients for a scrambled eggs on a toast breakfast.`,
-        });
+        yield* session
+          .createRequest({
+            system: SYSTEM,
+            prompt: `List ingredients for a scrambled eggs on a toast breakfast.`,
+          })
+          .pipe(Effect.provide(session.makeToolExecutionServices()));
 
         console.log(yield* Effect.promise(() => dumpAgent(agent)));
       },
@@ -148,7 +158,7 @@ describe('Agent', () => {
         const agent = yield* Agent.makeInitialized(
           {
             name: 'Expense tracking',
-            spec: trim`
+            instructions: trim`
               Keep a list of expenses in a markdown document (create artifact "Expenses").
               Process incoming emails, add the relevant ones to the list.
 
@@ -168,10 +178,7 @@ describe('Agent', () => {
         yield* Database.add(
           Trigger.make({
             enabled: true,
-            spec: {
-              kind: 'queue',
-              queue: inboxQueue.dxn.toString(),
-            },
+            spec: Trigger.specQueue(inboxQueue.dxn.toString()),
             function: Ref.make(Operation.serialize(AgentWorker)),
             input: {
               agent: Ref.make(agent),
@@ -198,6 +205,48 @@ describe('Agent', () => {
     MemoizedAiService.isGenerationEnabled() ? 240_000 : 30_000,
   );
 
+  it.scoped(
+    'cron field creates a timer trigger that invokes the agent worker',
+    Effect.fnUntraced(
+      function* ({ expect }) {
+        const cron = '*/5 * * * *';
+        const agent = yield* Agent.makeInitialized(
+          {
+            name: 'Scheduled agent',
+            instructions: 'A scheduled agent that runs on a timer.',
+            blueprints: [Ref.make(MarkdownBlueprint.make())],
+            cron,
+          },
+          blueprint,
+        );
+        yield* Database.flush();
+
+        yield* Operation.invoke(SyncTriggers, { agent: Ref.make(agent) });
+
+        const triggers = yield* Database.runQuery(
+          Query.select(Filter.type(Trigger.Trigger)).debugLabel('assistant-toolkit.blueprint.test.timer'),
+        );
+        const timerTriggers = triggers.filter(
+          (trigger) => trigger.spec?.kind === 'timer' && trigger.spec.cron === cron,
+        );
+        expect(timerTriggers).toHaveLength(1);
+
+        const timerTrigger = timerTriggers[0];
+        invariant(timerTrigger.spec?.kind === 'timer');
+        expect(timerTrigger.spec.cron).toBe(cron);
+        expect(timerTrigger.enabled).toBe(true);
+
+        // Timer trigger bypasses the qualifier and points to the agent worker.
+        invariant(timerTrigger.function);
+        const operation = yield* Database.load(timerTrigger.function);
+        invariant(Obj.instanceOf(Operation.PersistentOperation, operation));
+        expect(operation.key).toBe(AgentWorker.meta.key);
+      },
+      Effect.provide(TestLayer),
+      TestHelpers.provideTestContext,
+    ),
+  );
+
   it.scoped(
     'planning',
     Effect.fnUntraced(
@@ -205,7 +254,7 @@ describe('Agent', () => {
         const agent = yield* Agent.makeInitialized(
           {
             name: 'Egg making',
-            spec: trim`
+            instructions: trim`
               I'm testing how planning (task management) works.
               Create tasks to make scrambled eggs.
 
@@ -237,13 +286,15 @@ describe('Agent', () => {
         invariant(chatFeed, 'Agent chat feed not found.');
         yield* Database.flush();
         const runtime = yield* Effect.runtime<Feed.FeedService>();
-        const conversation = yield* acquireReleaseResource(() => new AiConversation({ feed: chatFeed, runtime }));
-        yield* Effect.promise(() => conversation.context.open());
+        const session = yield* acquireReleaseResource(() => new AiSession({ feed: chatFeed, runtime }));
+        yield* Effect.promise(() => session.context.open());
 
-        yield* conversation.createRequest({
-          system: SYSTEM,
-          prompt: `Go`,
-        });
+        yield* session
+          .createRequest({
+            system: SYSTEM,
+            prompt: `Go`,
+          })
+          .pipe(Effect.provide(session.makeToolExecutionServices()));
 
         console.log(yield* Effect.promise(() => dumpAgent(agent)));
       },
@@ -253,13 +304,53 @@ describe('Agent', () => {
     ),
     MemoizedAiService.isGenerationEnabled() ? 240_000 : 30_000,
   );
+
+  it.scoped(
+    'sync-triggers sets trigger enabled from agent.enabled',
+    Effect.fnUntraced(
+      function* ({ expect }) {
+        const agent = yield* Agent.makeInitialized(
+          {
+            name: 'Toggle agent',
+            instructions: 'Test enabled propagation.',
+            blueprints: [Ref.make(MarkdownBlueprint.make())],
+            enabled: false,
+            cron: '0 9 * * *',
+          },
+          blueprint,
+        );
+        yield* Database.flush();
+
+        yield* Operation.invoke(SyncTriggers, { agent: Ref.make(agent) });
+
+        const triggers = yield* Database.runQuery(
+          Query.select(Filter.type(Trigger.Trigger)).debugLabel('assistant-toolkit.blueprint.test.toggle-enabled'),
+        );
+        expect(triggers.every((trigger) => trigger.enabled === false)).toBe(true);
+
+        Obj.update(agent, (agent) => {
+          agent.enabled = true;
+        });
+        yield* Database.flush();
+        yield* Operation.invoke(SyncTriggers, { agent: Ref.make(agent) });
+
+        const triggersAfter = yield* Database.runQuery(
+          Query.select(Filter.type(Trigger.Trigger)).debugLabel('assistant-toolkit.blueprint.test.after'),
+        );
+        expect(triggersAfter).toHaveLength(triggers.length);
+        expect(triggersAfter.every((trigger) => trigger.enabled === true)).toBe(true);
+      },
+      Effect.provide(TestLayer),
+      TestHelpers.provideTestContext,
+    ),
+  );
 });
 
 const dumpAgent = async (agent: Agent.Agent) => {
   let text = '';
   text += `============== Agent: ${agent.name} ==============\n\n`;
-  text += `============== Spec ==============\n\n`;
-  text += `${await agent.spec.load().then((_) => _.content)}\n`;
+  text += `============== Instructions ==============\n\n`;
+  text += `${await agent.instructions.load().then((_) => _.content)}\n`;
   text += `============== Plan ==============\n\n`;
   text += `${await agent.plan?.load().then((_) => Plan.formatPlan(_))}\n`;
   text += `============== Artifacts ==============\n\n`;

package/src/blueprints/project/blueprint.ts

@@ -2,8 +2,7 @@
 // Copyright 2026 DXOS.org
 //
 
-import { type AppCapabilities } from '@dxos/app-toolkit';
-import { Blueprint, Template } from '@dxos/blueprints';
+import { Blueprint, Template } from '@dxos/compute';
 import { trim } from '@dxos/util';
 
 import { AddArtifact } from './functions';
@@ -20,7 +19,7 @@ const make = () =>
     name: 'Agent blueprint',
     instructions: Template.make({
       source: trim`
-        You work on an agent. Each agent has a spec - the goal of the agent.
+        You work on an agent. Each agent has instructions - the goal of the agent.
         The agent plan shows the current progress of the agent.
         Agent has a number of associated artifacts you can read/write.
         You can edit them if necessary.
@@ -29,9 +28,9 @@ const make = () =>
 
         {{#with agent}}
         <agent id="{{id}}" name="{{name}}">
-          <spec>
-            {{spec}}
-          </spec>
+          <instructions>
+            {{instructions}}
+          </instructions>
           <plan>
             {{plan}}
           </plan>
@@ -57,7 +56,7 @@ const make = () =>
     tools: Blueprint.toolDefinitions({ operations: [AddArtifact] }),
   });
 
-const blueprint: AppCapabilities.BlueprintDefinition = {
+const blueprint: Blueprint.Definition = {
   key: BLUEPRINT_KEY,
   make,
 };

package/src/blueprints/project/functions/add-artifact.ts

@@ -4,8 +4,8 @@
 
 import * as Effect from 'effect/Effect';
 
+import { Operation } from '@dxos/compute';
 import { Database, Obj } from '@dxos/echo';
-import { Operation } from '@dxos/operation';
 
 import { Agent } from '../../../types';
 import { AddArtifact } from './definitions';
@@ -19,7 +19,7 @@ export default AddArtifact.pipe(
 
       const agent = yield* Agent.getFromChatContext;
 
-      Obj.change(agent, (agent) => {
+      Obj.update(agent, (agent) => {
         agent.artifacts.push({
           name,
           data: artifact,

package/src/blueprints/project/functions/agent.ts

@@ -6,56 +6,35 @@ import * as Effect from 'effect/Effect';
 import * as Layer from 'effect/Layer';
 
 import { AiService } from '@dxos/ai';
-import { AiConversation, ToolExecutionServices } from '@dxos/assistant';
-import { Database, DXN, Feed, Obj } from '@dxos/echo';
+import { AiSession, ToolExecutionServices } from '@dxos/assistant';
+import { Operation } from '@dxos/compute';
+import { Database, Feed, Obj } from '@dxos/echo';
 import { acquireReleaseResource } from '@dxos/effect';
-import { FunctionInvocationService, FunctionNotFoundError } from '@dxos/functions';
 import { invariant } from '@dxos/invariant';
-import { Operation, OperationRegistry } from '@dxos/operation';
+import { ContentBlock } from '@dxos/types';
 
 import { Agent } from '../../../types';
 import { AgentWorker } from './definitions';
 
-/**
- * Creates a FunctionInvocationService that propagates the conversation DXN to child operations.
- * This ensures nested operations (e.g., get-context) can resolve AiContextService.
- */
-const functionInvocationServiceWithConversation = (
-  conversationDxn: DXN,
-): Layer.Layer<FunctionInvocationService, never, OperationRegistry.Service | Operation.Service> =>
-  Layer.effect(
-    FunctionInvocationService,
-    Effect.gen(function* () {
-      const operationRegistry = yield* OperationRegistry.Service;
-      const operationInvoker = yield* Operation.Service;
-      return FunctionInvocationService.of({
-        invokeFunction: <I, O>(operationDef: Operation.Definition<I, O, any>, input: I) =>
-          operationInvoker.invoke(operationDef, input, { conversation: conversationDxn.toString() }).pipe(Effect.orDie),
-        resolveFunction: (key: string) =>
-          operationRegistry.resolve(key).pipe(
-            Effect.flatten,
-            Effect.catchTag('NoSuchElementException', () => Effect.fail(new FunctionNotFoundError(key))),
-          ),
-      });
-    }),
-  );
-
 export default AgentWorker.pipe(
   Operation.withHandler(
     Effect.fnUntraced(function* ({ agent: agentRef, prompt, event }) {
-      const agent = yield* Database.load(agentRef);
+      const agent = yield* Database.load(agentRef).pipe(
+        Effect.catchTag('ObjectNotFoundError', () => Effect.die(new Error('Unable to load agent object.'))),
+      );
       invariant(Obj.instanceOf(Agent.Agent, agent));
       invariant(agent.chat, 'Agent has no chat.');
 
       const chatFeed = yield* agent.chat.pipe(
         Database.load,
         Effect.flatMap((chat) => Database.load(chat.feed)),
+        Effect.catchTag('ObjectNotFoundError', () => Effect.die(new Error('Unable to load agent chat feed object.'))),
       );
       invariant(chatFeed, 'Agent chat feed not found.');
       const runtime = yield* Effect.runtime<Feed.FeedService>();
-      const conversation = yield* acquireReleaseResource(() => new AiConversation({ feed: chatFeed, runtime }));
+      const session = yield* acquireReleaseResource(() => new AiSession({ feed: chatFeed, runtime }));
 
-      const agentsInContext = conversation.context.getObjects().filter(Obj.instanceOf(Agent.Agent));
+      const agentsInContext = session.context.getObjects().filter(Obj.instanceOf(Agent.Agent));
       if (agentsInContext.length !== 1) {
         throw new Error('There should be exactly one agent in context. Got: ' + agentsInContext.length);
       }
@@ -64,23 +43,22 @@ export default AgentWorker.pipe(
         throw new Error('Either prompt or event must be provided.');
       }
 
-      let input = '';
+      let input: ContentBlock.Any[] = [];
       if (prompt) {
-        input += `${prompt}\n\n`;
+        input.push({ _tag: 'text', text: prompt, disposition: 'synthetic' });
       }
       if (event) {
-        input += `<event>\n${JSON.stringify(event, null, 2)}\n</event>\n\n`;
+        input.push({ _tag: 'text', text: JSON.stringify(event), disposition: 'synthetic' });
       }
 
-      const feedDxn = Obj.getDXN(chatFeed);
-      yield* conversation
+      yield* session
         .createRequest({
           prompt: input,
         })
         .pipe(
           Effect.provide(
             Layer.mergeAll(AiService.model('@anthropic/claude-opus-4-6'), ToolExecutionServices).pipe(
-              Layer.provideMerge(functionInvocationServiceWithConversation(feedDxn)),
+              Layer.provideMerge(Operation.withInvocationOptions({ conversation: Obj.getDXN(chatFeed).toString() })),
             ),
           ),
           Effect.retry({ times: 2 }),

package/src/blueprints/project/functions/definitions.ts

@@ -4,12 +4,11 @@
 
 import * as Schema from 'effect/Schema';
 
-import { AiService, GenericToolkit } from '@dxos/ai';
+import { AiService, OpaqueToolkit } from '@dxos/ai';
 import { AiContextService } from '@dxos/assistant';
+import { Trace, TriggerEvent, Operation, OperationRegistry } from '@dxos/compute';
 import { Database, Feed, Obj, Ref } from '@dxos/echo';
-import { QueueService, TracingService, TriggerEvent } from '@dxos/functions';
-import { Trace } from '@dxos/functions';
-import { Operation, OperationRegistry } from '@dxos/operation';
+import { QueueService } from '@dxos/functions';
 
 import { Agent } from '../../../types';
 
@@ -31,10 +30,8 @@ export const AgentWorker = Operation.make({
     QueueService,
     Feed.FeedService,
     OperationRegistry.Service,
-    // @deprecated TracingService kept for backward compat with tool handlers.
-    TracingService,
     Trace.TraceService,
-    GenericToolkit.GenericToolkitProvider,
+    OpaqueToolkit.OpaqueToolkitProvider,
   ],
 });
 
@@ -63,7 +60,7 @@ export const GetContext = Operation.make({
   output: Schema.Struct({
     id: Schema.String,
     name: Schema.String,
-    spec: Schema.String,
+    instructions: Schema.String,
     plan: Schema.String,
     artifacts: Schema.Array(
       Schema.Struct({

package/src/blueprints/project/functions/get-context.ts

@@ -4,8 +4,8 @@
 
 import * as Effect from 'effect/Effect';
 
+import { Operation } from '@dxos/compute';
 import { Database, Obj } from '@dxos/echo';
-import { Operation } from '@dxos/operation';
 
 import { Plan, Agent } from '../../../types';
 import { GetContext } from './definitions';
@@ -18,9 +18,9 @@ export default GetContext.pipe(
       return {
         id: agent.id,
         name: agent.name,
-        spec: yield* agent.spec.pipe(Database.load).pipe(
+        instructions: yield* agent.instructions.pipe(Database.load).pipe(
           Effect.map((_) => _.content),
-          Effect.catchTag('ObjectNotFoundError', () => Effect.succeed('No spec found.')),
+          Effect.catchTag('ObjectNotFoundError', () => Effect.succeed('No instructions found.')),
         ),
         plan: yield* (
           agent.plan?.pipe(Database.load).pipe(

package/src/blueprints/project/functions/index.ts

@@ -2,7 +2,7 @@
 // Copyright 2026 DXOS.org
 //
 
-import { OperationHandlerSet } from '@dxos/operation';
+import { OperationHandlerSet } from '@dxos/compute';
 
 export * from './definitions';
 

package/src/blueprints/project/functions/qualifier.ts

@@ -8,9 +8,9 @@ import * as Effect from 'effect/Effect';
 import * as Schema from 'effect/Schema';
 
 import { AiService } from '@dxos/ai';
+import { Operation } from '@dxos/compute';
 import { Database, Obj, Ref } from '@dxos/echo';
 import { invariant } from '@dxos/invariant';
-import { Operation } from '@dxos/operation';
 import { trim } from '@dxos/util';
 
 import { Plan, Agent } from '../../../types';
@@ -30,7 +30,7 @@ export default Qualifier.pipe(
         }
 
         const plan = yield* Database.load(agent.plan);
-        const spec = yield* Database.load(agent.spec);
+        const instructions = yield* Database.load(agent.instructions);
 
         const { value } = yield* Effect.scoped(
           LanguageModel.generateObject({
@@ -45,9 +45,9 @@ export default Qualifier.pipe(
                   If you are not sure, return true.
                   The qualified events will be forwarded to the larger agent that will process them.
                   <agent id="${id}" name="${name}">
-                    <spec>
-                    ${spec.content}
-                    </spec>
+                    <instructions>
+                    ${instructions.content}
+                    </instructions>
                     <plan>
                       ${Plan.formatPlan(plan)}
                     </plan>

package/src/blueprints/project-wizard/blueprint.ts

@@ -2,8 +2,7 @@
 // Copyright 2026 DXOS.org
 //
 
-import { type AppCapabilities } from '@dxos/app-toolkit';
-import { Blueprint, Template } from '@dxos/blueprints';
+import { Blueprint, Template } from '@dxos/compute';
 import { trim } from '@dxos/util';
 
 import { AgentRules, CreateAgent, SyncTriggers } from './functions';
@@ -18,21 +17,26 @@ const make = () =>
   Blueprint.make({
     key: BLUEPRINT_KEY,
     name: 'Agent Wizard',
-    description: 'Help the user create a new agent.',
+    description: 'Help the user create a new agent (subscriptions, optional cron timer, sync-triggers after edits).',
     agentCanEnable: true,
     instructions: Template.make({
       source: trim`
         You are a wizard that helps the user create a new agent.
 
         Agents are goal oriented and autonomously driven.
-        Each agent has a spec - the goal of the agent.
-        The spec also typically describes what actions to perform in reaction to events (emails).
+        Each agent has instructions - the goal of the agent.
+        The instructions also typically describe what actions to perform in reaction to events (emails).
         The agent has a number of associated artifacts to work with.
         Agents can subscribe to emails.
 
+        Agents have a \`cron\` field: when set, the agent runs on a timer on that schedule (standard cron syntax).
+        Use \`cron\` when the user wants the agent to run periodically (e.g. "every morning", "once a day", "every 5 minutes").
+        Examples: \`0 9 * * *\` for daily at 09:00, or \`*/5 * * * *\` for every 5 minutes.
+        Timer triggers bypass the qualifier and invoke the agent worker directly on the schedule.
+
         The agent itself is an ECHO object and can be edited like any other object using the database blueprint.
-        You can edit the agent's spec, name, and other properties directly.
-        If you edit the agent's subscriptions array, you MUST call the sync-triggers function afterward to synchronize the triggers.
+        You can edit the agent's instructions, name, and other properties directly.
+        If you edit the agent's \`enabled\` field, \`filterEvents\` field, subscriptions array, or \`cron\` field, you MUST call the sync-triggers function afterward to synchronize the triggers (\`enabled\` is applied to all triggers).
 
         IMPORTANT: Before attempting to create an agent call the [agent-rules] tool to get the rules for creating an agent.
       `,
@@ -40,7 +44,7 @@ const make = () =>
     tools: Blueprint.toolDefinitions({ operations: [AgentRules, CreateAgent, SyncTriggers] }),
   });
 
-const blueprint: AppCapabilities.BlueprintDefinition = {
+const blueprint: Blueprint.Definition = {
   key: BLUEPRINT_KEY,
   make,
 };

package/src/blueprints/project-wizard/functions/create-project.ts

@@ -4,9 +4,8 @@
 
 import * as Effect from 'effect/Effect';
 
-import { Blueprint } from '@dxos/blueprints';
+import { Blueprint, Operation } from '@dxos/compute';
 import { Obj, Ref } from '@dxos/echo';
-import { Operation } from '@dxos/operation';
 
 import { Agent } from '../../../types';
 import { AgentBlueprint } from '../../project';
@@ -14,11 +13,11 @@ import { CreateAgent, SyncTriggers } from './definitions';
 
 export default CreateAgent.pipe(
   Operation.withHandler(
-    Effect.fnUntraced(function* ({ name, spec, blueprints, subscriptions }) {
+    Effect.fnUntraced(function* ({ name, instructions, blueprints, subscriptions }) {
       const agent = yield* Agent.makeInitialized(
         {
           name,
-          spec,
+          instructions,
           blueprints: yield* Effect.forEach(blueprints, (key) =>
             Blueprint.upsert(key).pipe(Effect.map(Ref.make), Effect.orDie),
           ),

package/src/blueprints/project-wizard/functions/definitions.ts

@@ -4,10 +4,9 @@
 
 import * as Schema from 'effect/Schema';
 
-import { Blueprint } from '@dxos/blueprints';
+import { Blueprint, Operation } from '@dxos/compute';
 import { Database, Feed, Obj, Ref } from '@dxos/echo';
 import { QueueService } from '@dxos/functions';
-import { Operation } from '@dxos/operation';
 
 import { Agent } from '../../../types';
 
@@ -31,7 +30,7 @@ export const CreateAgent = Operation.make({
     name: Schema.String.annotations({
       description: 'The name of the agent to create.',
     }),
-    spec: Schema.String.annotations({
+    instructions: Schema.String.annotations({
       description:
         'The goal of the agent. Be specific but not too verbose. The agent will use this as a core objective and set of rules to follow.',
     }),
@@ -52,7 +51,7 @@ export const SyncTriggers = Operation.make({
     key: 'org.dxos.function.agent.sync-triggers',
     name: 'Sync triggers',
     description:
-      'Synchronizes triggers in the database with the agent subscriptions. Call this after editing the subscriptions array.',
+      'Synchronizes triggers with the agent: subscriptions, cron, filter-events, and enabled (copied to every trigger). Call after editing those fields.',
   },
   input: Schema.Struct({
     agent: Ref.Ref(Agent.Agent).annotations({

package/src/blueprints/project-wizard/functions/index.ts

@@ -2,7 +2,7 @@
 // Copyright 2026 DXOS.org
 //
 
-import { OperationHandlerSet } from '@dxos/operation';
+import { OperationHandlerSet } from '@dxos/compute';
 
 export * from './definitions';
 

package/src/blueprints/project-wizard/functions/project-rules.ts

@@ -4,7 +4,7 @@
 
 import * as Effect from 'effect/Effect';
 
-import { Operation } from '@dxos/operation';
+import { Operation } from '@dxos/compute';
 import { trim } from '@dxos/util';
 
 import { AgentRules } from './definitions';
@@ -15,9 +15,9 @@ export default AgentRules.pipe(
       return trim`
         You can ask the user for qualifying questions about the agents.
         If agents should actively read incoming emails, query for mailboxes and add a subscription to them.
+        If the user wants the agent to run on a schedule (e.g. "every morning", "every 5 minutes"), set the agent's \`cron\` field to a standard cron expression (e.g. \`0 9 * * *\` for daily at 09:00, \`*/5 * * * *\` for every 5 minutes). Timer triggers bypass the qualifier and invoke the agent worker directly on the schedule.
         Use [query-blueprints] from the Blueprint Manager to query for available blueprints and their keys.
         Use [create-agent] function to create a new agent.
-        After creating an agent, explicitly remind the user to enable local triggers so the agent can be driven autonomously.
 
         Notable blueprints (query to get their keys):