@dxos/assistant-toolkit 0.9.0 → 0.9.1-staging.ee54ba693a

package/src/{blueprints/agent/blueprint.test.ts → skills/agent/skill.test.ts}

@@ -6,10 +6,10 @@ import { describe, expect, it } from '@effect/vitest';
 import * as Effect from 'effect/Effect';
 import * as Exit from 'effect/Exit';
 
-import { MemoizedAiService } from '@dxos/ai/testing';
+import { MemoizedAiService, MemoizedLanguageModel } from '@dxos/ai/testing';
 import { AiSession } from '@dxos/assistant';
 import { SpaceProperties } from '@dxos/client-protocol';
-import { Blueprint, Trigger, Operation, OperationHandlerSet } from '@dxos/compute';
+import { Operation, OperationHandlerSet, Skill, Trigger } from '@dxos/compute';
 import { Collection, Database, Feed, Filter, Obj, Query, Ref } from '@dxos/echo';
 import { EffectEx } from '@dxos/effect';
 import { TestHelpers } from '@dxos/effect/testing';
@@ -17,7 +17,7 @@ import { TriggerDispatcher } from '@dxos/functions-runtime';
 import { AssistantTestLayerWithTriggers } from '@dxos/functions-runtime/testing';
 import { invariant } from '@dxos/invariant';
 import { EntityId } from '@dxos/keys';
-import { MarkdownBlueprint } from '@dxos/plugin-markdown';
+import { MarkdownSkill } from '@dxos/plugin-markdown';
 import { Markdown } from '@dxos/plugin-markdown';
 import { MarkdownOperationHandlerSet } from '@dxos/plugin-markdown/plugin';
 import { WithProperties } from '@dxos/plugin-markdown/testing';
@@ -25,19 +25,19 @@ import { Text } from '@dxos/schema';
 import { Message } from '@dxos/types';
 import { trim } from '@dxos/util';
 
-import { Chat, Plan, Agent } from '../../types';
+import { Agent, Chat, Plan } from '../../types';
 import { AgentWizardHandlers, AgentWizardOperations } from '../agent-wizard';
-import { PlanningBlueprint, PlanningHandlers } from '../planning';
-import AgentBlueprintDef from './blueprint';
-import { AgentBlueprintHandlers } from './operations';
+import { PlanningHandlers, PlanningSkill } from '../planning';
+import { AgentSkillHandlers } from './operations';
 import { AgentWorker } from './operations/definitions';
+import AgentSkillDef from './skill';
 
 EntityId.dangerouslyDisableRandomness();
 
 const TestLayer = AssistantTestLayerWithTriggers({
   aiServicePreset: 'edge-remote',
   operationHandlers: OperationHandlerSet.merge(
-    AgentBlueprintHandlers,
+    AgentSkillHandlers,
     AgentWizardHandlers,
     MarkdownOperationHandlerSet,
     PlanningHandlers,
@@ -48,13 +48,17 @@ const TestLayer = AssistantTestLayerWithTriggers({
     Chat.CompanionTo,
     Chat.Chat,
     SpaceProperties,
-    Blueprint.Blueprint,
+    Skill.Skill,
     Trigger.Trigger,
     Text.Text,
     Markdown.Document,
     Collection.Collection,
   ],
   tracing: 'pretty',
+  // EntityIds are deterministic (via dangerouslyDisableRandomness) but their values shift when
+  // internal ECHO object creation changes. Canonicalize them so recordings match structurally
+  // regardless of which specific IDs the current code generates.
+  dynamicValuePatterns: [MemoizedLanguageModel.SPACE_ID_PATTERN, MemoizedLanguageModel.ENTITY_ID_PATTERN],
 });
 
 const SYSTEM = trim`
@@ -65,7 +69,7 @@ const SYSTEM = trim`
 `;
 
 describe('Agent', () => {
-  const blueprint = AgentBlueprintDef.make();
+  const skill = AgentSkillDef.make();
 
   it.scoped(
     'agent adds artifact to agent',
@@ -75,9 +79,9 @@ describe('Agent', () => {
           {
             name: 'Test Agent',
             instructions: 'A test agent for adding artifacts.',
-            blueprints: [Ref.make(MarkdownBlueprint.make())],
+            skills: [Ref.make(MarkdownSkill.make())],
           },
-          blueprint,
+          skill,
         );
         yield* Database.flush();
 
@@ -93,7 +97,7 @@ describe('Agent', () => {
 
         const chatFeed = agent.chat?.target?.feed?.target;
         invariant(chatFeed, 'Agent chat feed not found.');
-        const runtime = yield* Effect.runtime<Feed.FeedService>();
+        const runtime = yield* Effect.runtime<Database.Service>();
         const session = yield* EffectEx.acquireReleaseResource(
           () => new AiSession.Session({ feed: chatFeed, runtime }),
         );
@@ -126,14 +130,14 @@ describe('Agent', () => {
           {
             name: 'Shopping list',
             instructions: 'Keep a shopping list of items to buy.',
-            blueprints: [Ref.make(MarkdownBlueprint.make())],
+            skills: [Ref.make(MarkdownSkill.make())],
           },
-          blueprint,
+          skill,
         );
         const chatFeed = agent.chat?.target?.feed?.target;
         invariant(chatFeed, 'Agent chat feed not found.');
         yield* Database.flush();
-        const runtime = yield* Effect.runtime<Feed.FeedService>();
+        const runtime = yield* Effect.runtime<Database.Service>();
         const session = yield* EffectEx.acquireReleaseResource(
           () => new AiSession.Session({ feed: chatFeed, runtime }),
         );
@@ -171,9 +175,9 @@ describe('Agent', () => {
               - Flight to London (2026-02-01): £100
               - Hotel in London (2026-02-01): £100
             `,
-            blueprints: [Ref.make(MarkdownBlueprint.make())],
+            skills: [Ref.make(MarkdownSkill.make())],
           },
-          blueprint,
+          skill,
         );
         yield* Database.flush();
 
@@ -182,7 +186,7 @@ describe('Agent', () => {
           Trigger.make({
             enabled: true,
             spec: Trigger.specFeed(inboxFeed),
-            function: Ref.make(Operation.serialize(AgentWorker)),
+            runnable: Ref.make(Operation.serialize(AgentWorker)),
             input: {
               agent: Ref.make(agent),
               event: '{{event}}',
@@ -217,17 +221,17 @@ describe('Agent', () => {
           {
             name: 'Scheduled agent',
             instructions: 'A scheduled agent that runs on a timer.',
-            blueprints: [Ref.make(MarkdownBlueprint.make())],
+            skills: [Ref.make(MarkdownSkill.make())],
             cron,
           },
-          blueprint,
+          skill,
         );
         yield* Database.flush();
 
         yield* Operation.invoke(AgentWizardOperations.SyncTriggers, { agent: Ref.make(agent) });
 
         const triggers = yield* Database.query(
-          Query.select(Filter.type(Trigger.Trigger)).debugLabel('assistant-toolkit.blueprint.test.timer'),
+          Query.select(Filter.type(Trigger.Trigger)).debugLabel('assistant-toolkit.skill.test.timer'),
         ).run;
         const timerTriggers = triggers.filter(
           (trigger) => trigger.spec?.kind === 'timer' && trigger.spec.cron === cron,
@@ -240,8 +244,8 @@ describe('Agent', () => {
         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(timerTrigger.runnable);
+        const operation = yield* Database.load(timerTrigger.runnable);
         invariant(Obj.instanceOf(Operation.PersistentOperation, operation));
         expect(Obj.getMeta(operation).key).toBe(AgentWorker.meta.key);
       },
@@ -279,16 +283,16 @@ describe('Agent', () => {
                 - Taken 2 raw eggs out of the fridge.
               </example>
             `,
-            blueprints: [Ref.make(MarkdownBlueprint.make()), Ref.make(Obj.clone(PlanningBlueprint.make()))],
+            skills: [Ref.make(MarkdownSkill.make()), Ref.make(Obj.clone(PlanningSkill.make()))],
           },
-          blueprint,
+          skill,
         );
         yield* Database.flush();
 
         const chatFeed = agent.chat?.target?.feed?.target;
         invariant(chatFeed, 'Agent chat feed not found.');
         yield* Database.flush();
-        const runtime = yield* Effect.runtime<Feed.FeedService>();
+        const runtime = yield* Effect.runtime<Database.Service>();
         const session = yield* EffectEx.acquireReleaseResource(
           () => new AiSession.Session({ feed: chatFeed, runtime }),
         );
@@ -318,18 +322,18 @@ describe('Agent', () => {
           {
             name: 'Toggle agent',
             instructions: 'Test enabled propagation.',
-            blueprints: [Ref.make(MarkdownBlueprint.make())],
+            skills: [Ref.make(MarkdownSkill.make())],
             enabled: false,
             cron: '0 9 * * *',
           },
-          blueprint,
+          skill,
         );
         yield* Database.flush();
 
         yield* Operation.invoke(AgentWizardOperations.SyncTriggers, { agent: Ref.make(agent) });
 
         const triggers = yield* Database.query(
-          Query.select(Filter.type(Trigger.Trigger)).debugLabel('assistant-toolkit.blueprint.test.toggle-enabled'),
+          Query.select(Filter.type(Trigger.Trigger)).debugLabel('assistant-toolkit.skill.test.toggle-enabled'),
         ).run;
         expect(triggers.every((trigger) => trigger.enabled === false)).toBe(true);
 
@@ -340,7 +344,7 @@ describe('Agent', () => {
         yield* Operation.invoke(AgentWizardOperations.SyncTriggers, { agent: Ref.make(agent) });
 
         const triggersAfter = yield* Database.query(
-          Query.select(Filter.type(Trigger.Trigger)).debugLabel('assistant-toolkit.blueprint.test.after'),
+          Query.select(Filter.type(Trigger.Trigger)).debugLabel('assistant-toolkit.skill.test.after'),
         ).run;
         expect(triggersAfter).toHaveLength(triggers.length);
         expect(triggersAfter.every((trigger) => trigger.enabled === true)).toBe(true);
@@ -357,7 +361,12 @@ const dumpAgent = async (agent: Agent.Agent) => {
   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`;
+  if (agent.chat) {
+    const chat = await agent.chat.load();
+    text += chat.plan ? `${await chat.plan.load().then((plan) => Plan.formatPlan(plan))}\n` : 'No plan found.\n';
+  } else {
+    text += 'No plan found.\n';
+  }
   text += `============== Artifacts ==============\n\n`;
   for (const artifact of agent.artifacts) {
     const data = await artifact.data.load();

package/src/{blueprints/agent/blueprint.ts → skills/agent/skill.ts}

@@ -2,21 +2,21 @@
 // Copyright 2026 DXOS.org
 //
 
-import { Blueprint, Template } from '@dxos/compute';
+import { Skill, Template } from '@dxos/compute';
 import { trim } from '@dxos/util';
 
 import { AddArtifact } from './operations/definitions';
 
-const BLUEPRINT_KEY = 'org.dxos.blueprint.agent';
+const SKILL_KEY = 'org.dxos.skill.agent';
 
 /**
- * Creates the Agent blueprint. This is a function to avoid circular dependency issues.
+ * Creates the Agent skill. This is a function to avoid circular dependency issues.
  */
 // TODO(dmaretskyi): Combine with Agent Wizard.
 const make = () =>
-  Blueprint.make({
-    key: BLUEPRINT_KEY,
-    name: 'Agent blueprint',
+  Skill.make({
+    key: SKILL_KEY,
+    name: 'Agent skill',
     instructions: Template.make({
       source: trim`
         You work on an agent. Each agent has instructions - the goal of the agent.
@@ -53,12 +53,12 @@ const make = () =>
         },
       ],
     }),
-    tools: Blueprint.toolDefinitions({ operations: [AddArtifact] }),
+    tools: Skill.toolDefinitions({ operations: [AddArtifact] }),
   });
 
-const blueprint: Blueprint.Definition = {
-  key: BLUEPRINT_KEY,
+const skill: Skill.Definition = {
+  key: SKILL_KEY,
   make,
 };
 
-export default blueprint;
+export default skill;

package/src/{blueprints → skills}/agent-wizard/index.ts

@@ -2,5 +2,5 @@
 // Copyright 2025 DXOS.org
 //
 
-export { default as AgentWizardBlueprint } from './blueprint';
+export { default as AgentWizardSkill } from './skill';
 export { AgentWizardHandlers, AgentWizardOperations } from './operations';

package/src/{blueprints → skills}/agent-wizard/operations/agent-rules.ts

@@ -16,19 +16,19 @@ export default AgentRules.pipe(
         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 [query-skills] from the Skill Manager to query for available skills and their keys.
         Use [create-agent] function to create a new agent.
 
-        Notable blueprints (query to get their keys):
+        Notable skills (query to get their keys):
 
-        - Blueprint Manger - allows agent to self-enable blueprints (always include this one).
+        - Skill Manger - allows agent to self-enable skills (always include this one).
         - Database -- CRUD on objects in the ECHO database.
         - Markdown -- Create and edit markdown documents.
         - Websearch -- Search the web for information.
         - Browser -- Virtual browser via playwright when simple WebSearch is not enough.
         - Memory -- Memory to store and retrieve information.
 
-        Experimental blueprints that are discouraged:
+        Experimental skills that are discouraged:
 
         - Research
         - Design
@@ -37,7 +37,7 @@ export default AgentRules.pipe(
         <example_agent>
           ## CRM from your inbox
 
-          Blueprints: database, websearch, browser
+          Skills: database, websearch, browser
 
           Subscribe to your inboxes.
           Spec says that on every email we should extract People and Organizations and save them to the database, but first query the database for existing people and organizations to avoid duplicates.
@@ -47,11 +47,11 @@ export default AgentRules.pipe(
         <example_agent>
           ## Parcel tracking
 
-          Blueprints: database
+          Skills: database
 
           Based on emails from vendors (amazon, fedex, etc.) track the status of the parcels ordered online and keep a table of orders.
 
-          Before creating an agent, use the Database blueprint to create an Order schema:
+          Before creating an agent, use the Database skill to create an Order schema:
             - seller
             - name
             - price
@@ -64,7 +64,7 @@ export default AgentRules.pipe(
         <example_agent>
           ## Comms assistant
 
-          Blueprints: database, markdown, inbox
+          Skills: database, markdown, inbox
 
           Helps user maintain comms with external parites via email.
           Ask user specifically who they want to communicate with and on what topic.

package/src/{blueprints → skills}/agent-wizard/operations/create-agent.ts

@@ -4,26 +4,24 @@
 
 import * as Effect from 'effect/Effect';
 
-import { Blueprint, Operation } from '@dxos/compute';
+import { Operation, Skill } from '@dxos/compute';
 import { Obj, Ref } from '@dxos/echo';
 
 import { Agent } from '../../../types';
-import { AgentBlueprint } from '../../agent';
+import { AgentSkill } from '../../agent';
 import { CreateAgent, SyncTriggers } from './definitions';
 
 export default CreateAgent.pipe(
   Operation.withHandler(
-    Effect.fnUntraced(function* ({ name, instructions, blueprints, subscriptions }) {
+    Effect.fnUntraced(function* ({ name, instructions, skills, subscriptions }) {
       const agent = yield* Agent.makeInitialized(
         {
           name,
           instructions,
-          blueprints: yield* Effect.forEach(blueprints, (key) =>
-            Blueprint.upsert(key).pipe(Effect.map(Ref.make), Effect.orDie),
-          ),
+          skills: yield* Effect.forEach(skills, (key) => Skill.upsert(key).pipe(Effect.map(Ref.make), Effect.orDie)),
           subscriptions,
         },
-        Obj.clone(AgentBlueprint.make()),
+        Obj.clone(AgentSkill.make()),
       );
       yield* Operation.invoke(SyncTriggers, { agent: Ref.make(agent) });
       return agent;

package/src/{blueprints → skills}/agent-wizard/operations/definitions.ts

@@ -5,7 +5,7 @@
 import * as Schema from 'effect/Schema';
 
 import { Operation } from '@dxos/compute';
-import { Database, Feed, Obj, Ref, Registry, Type } from '@dxos/echo';
+import { Database, Obj, Ref, Registry, Type } from '@dxos/echo';
 import { DXN } from '@dxos/keys';
 
 import { Agent } from '../../../types';
@@ -36,16 +36,16 @@ export const CreateAgent = Operation.make({
       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.',
     }),
-    blueprints: Schema.Array(Schema.String).annotations({
-      description: 'The blueprint keys to use for the agent.',
-      examples: [['org.dxos.blueprint.markdown', 'org.dxos.blueprint.database']],
+    skills: Schema.Array(Schema.String).annotations({
+      description: 'The skill keys to use for the agent.',
+      examples: [['org.dxos.skill.markdown', 'org.dxos.skill.database']],
     }),
     subscriptions: Schema.Array(Ref.Ref(Obj.Unknown)).annotations({
       description: 'The objects to subscribe to for the agent. Can be references to mailboxes.',
     }),
   }),
   output: Type.getSchema(Agent.Agent),
-  services: [Registry.Service, Database.Service, Feed.FeedService],
+  services: [Registry.Service, Database.Service],
 });
 
 export const SyncTriggers = Operation.make({

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

@@ -5,7 +5,7 @@
 import * as Effect from 'effect/Effect';
 import * as Option from 'effect/Option';
 
-import { Trigger, Operation } from '@dxos/compute';
+import { Operation, Trigger } from '@dxos/compute';
 import { Database, Feed, Filter, Obj, Ref, Type } from '@dxos/echo';
 import { FeedAnnotation } from '@dxos/schema';
 
@@ -103,7 +103,7 @@ const syncAgentTriggers = (agent: Agent.Agent): Effect.Effect<void, never, Datab
           },
           enabled: triggersEnabled,
           spec: Trigger.specFeed(feedObj),
-          function: Ref.make(Operation.serialize(filterEvents ? Qualifier : AgentWorker)),
+          runnable: Ref.make(Operation.serialize(filterEvents ? Qualifier : AgentWorker)),
           input: {
             agent: Ref.make(agent),
             event: '{{event}}',
@@ -131,7 +131,7 @@ const syncAgentTriggers = (agent: Agent.Agent): Effect.Effect<void, never, Datab
                 },
               ],
             },
-            function: Ref.make(Operation.serialize(AgentWorker)),
+            runnable: Ref.make(Operation.serialize(AgentWorker)),
             enabled: triggersEnabled,
             spec: Trigger.specFeed(agentFeedOption.value),
             input: {
@@ -156,7 +156,7 @@ const syncAgentTriggers = (agent: Agent.Agent): Effect.Effect<void, never, Datab
           },
           enabled: triggersEnabled,
           spec: Trigger.specTimer(agent.cron),
-          function: Ref.make(Operation.serialize(AgentWorker)),
+          runnable: Ref.make(Operation.serialize(AgentWorker)),
           input: {
             agent: Ref.make(agent),
             event: '{{event}}',

package/src/{blueprints/agent-wizard/blueprint.ts → skills/agent-wizard/skill.ts}

@@ -2,20 +2,20 @@
 // Copyright 2026 DXOS.org
 //
 
-import { Blueprint, Template } from '@dxos/compute';
+import { Skill, Template } from '@dxos/compute';
 import { trim } from '@dxos/util';
 
 import { AgentRules, CreateAgent, SyncTriggers } from './operations/definitions';
 
-const BLUEPRINT_KEY = 'org.dxos.blueprint.agentWizard';
+const SKILL_KEY = 'org.dxos.skill.agentWizard';
 
 /**
- * Creates the Agent Wizard blueprint. This is a function to avoid circular dependency issues.
+ * Creates the Agent Wizard skill. This is a function to avoid circular dependency issues.
  */
-// TODO(dmaretskyi): Combine with Agent Blueprint.
+// TODO(dmaretskyi): Combine with Agent Skill.
 const make = () =>
-  Blueprint.make({
-    key: BLUEPRINT_KEY,
+  Skill.make({
+    key: SKILL_KEY,
     name: 'Agent Wizard',
     description: 'Help the user create a new agent (subscriptions, optional cron timer, sync-triggers after edits).',
     agentCanEnable: true,
@@ -34,19 +34,19 @@ const make = () =>
         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.
+        The agent itself is an ECHO object and can be edited like any other object using the database skill.
         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.
       `,
     }),
-    tools: Blueprint.toolDefinitions({ operations: [AgentRules, CreateAgent, SyncTriggers] }),
+    tools: Skill.toolDefinitions({ operations: [AgentRules, CreateAgent, SyncTriggers] }),
   });
 
-const blueprint: Blueprint.Definition = {
-  key: BLUEPRINT_KEY,
+const skill: Skill.Definition = {
+  key: SKILL_KEY,
   make,
 };
 
-export default blueprint;
+export default skill;

package/src/skills/alarm/index.ts

@@ -0,0 +1,6 @@
+//
+// Copyright 2026 DXOS.org
+//
+
+export { default as AlarmSkill } from './skill';
+export { AlarmHandlers, AlarmOperations } from './operations';

package/src/skills/alarm/operations/definitions.ts

@@ -0,0 +1,54 @@
+//
+// Copyright 2026 DXOS.org
+//
+
+import * as Schema from 'effect/Schema';
+
+import { Harness } from '@dxos/assistant';
+import { Operation } from '@dxos/compute';
+import { DXN } from '@dxos/keys';
+import { trim } from '@dxos/util';
+
+export const SetAlarm = Operation.make({
+  meta: {
+    key: DXN.make('org.dxos.function.alarm.setAlarm'),
+    name: 'Set alarm',
+    icon: 'ph--alarm--regular',
+    description: trim`
+      Schedule an alarm to wake yourself up in the future.
+      Provide exactly one of "in" (a duration from now) or "at" (an absolute time).
+      When the alarm fires you will receive a prompt and can continue working.
+      Setting a new alarm replaces any previously scheduled one.
+    `,
+  },
+  input: Schema.Struct({
+    in: Schema.optional(
+      Schema.String.annotations({
+        description: 'Duration from now expressed as "<number> <unit>", e.g. "30 seconds", "5 minutes", "2 hours".',
+      }),
+    ),
+    at: Schema.optional(
+      Schema.String.annotations({
+        description: 'Absolute ISO-8601 timestamp to wake at, e.g. "2026-06-04T18:00:00.000Z".',
+      }),
+    ),
+    message: Schema.optional(
+      Schema.String.annotations({
+        description: 'Optional reminder surfaced verbatim when the alarm fires.',
+      }),
+    ),
+  }),
+  output: Schema.String,
+  services: [Harness.HarnessService],
+});
+
+export const GetCurrentDate = Operation.make({
+  meta: {
+    key: DXN.make('org.dxos.function.alarm.getCurrentDate'),
+    name: 'Get current date',
+    icon: 'ph--clock--regular',
+    description: 'Get the current date and time as an ISO-8601 string.',
+  },
+  input: Schema.Struct({}),
+  output: Schema.String,
+});

package/src/skills/alarm/operations/get-current-date.ts

@@ -0,0 +1,23 @@
+//
+// Copyright 2026 DXOS.org
+//
+
+import * as Clock from 'effect/Clock';
+import * as Effect from 'effect/Effect';
+
+import { Operation } from '@dxos/compute';
+
+import { GetCurrentDate } from './definitions';
+
+/**
+ * Reports the current time from the ambient Effect clock as an ISO-8601 string, so it stays
+ * consistent with alarm scheduling (and honors a TestClock under tests).
+ */
+export default GetCurrentDate.pipe(
+  Operation.withHandler(
+    Effect.fn(function* () {
+      const now = yield* Clock.currentTimeMillis;
+      return new Date(now).toISOString();
+    }),
+  ),
+);

package/src/skills/alarm/operations/index.ts

@@ -0,0 +1,12 @@
+//
+// Copyright 2026 DXOS.org
+//
+
+import { OperationHandlerSet } from '@dxos/compute';
+
+export * as AlarmOperations from './definitions';
+
+export const AlarmHandlers = OperationHandlerSet.lazy(
+  () => import('./set-alarm'),
+  () => import('./get-current-date'),
+);

package/src/skills/alarm/operations/resolve-wake-at.ts

@@ -0,0 +1,46 @@
+//
+// Copyright 2026 DXOS.org
+//
+
+import * as Duration from 'effect/Duration';
+import * as Either from 'effect/Either';
+import * as Option from 'effect/Option';
+
+interface ResolveAlarmInput {
+  /** Duration from now, e.g. `'30 seconds'`, `'5 minutes'`, `'1 hour'`. */
+  in?: string;
+  /** Absolute ISO-8601 timestamp, e.g. `'2026-06-04T18:00:00.000Z'`. */
+  at?: string;
+}
+
+const DURATION_PATTERN = /^(\d+(?:\.\d+)?)\s+(\S+)$/;
+
+/**
+ * Resolves an alarm specification into an absolute UNIX timestamp (ms).
+ * Returns a {@link Either.left} with a human-readable message describing invalid input.
+ */
+export const resolveWakeAt = (input: ResolveAlarmInput, now: number): Either.Either<number, string> => {
+  const { in: inDuration, at } = input;
+  if (inDuration != null && at != null) {
+    return Either.left('Specify either "in" or "at", not both.');
+  }
+  if (at != null) {
+    const timestamp = new Date(at).getTime();
+    if (Number.isNaN(timestamp)) {
+      return Either.left(`Invalid "at" timestamp: "${at}". Provide an ISO-8601 date-time string.`);
+    }
+    return Either.right(timestamp);
+  }
+  if (inDuration != null) {
+    const match = inDuration.trim().match(DURATION_PATTERN);
+    if (!match) {
+      return Either.left(`Invalid "in" duration: "${inDuration}". Use a value like "30 seconds" or "5 minutes".`);
+    }
+    const duration = Duration.decodeUnknown(inDuration.trim());
+    if (Option.isNone(duration)) {
+      return Either.left(`Invalid "in" duration: "${inDuration}". Use a value like "30 seconds" or "5 minutes".`);
+    }
+    return Either.right(now + Duration.toMillis(duration.value));
+  }
+  return Either.left('Specify either "in" (a duration from now) or "at" (an absolute time).');
+};