@dxos/assistant-toolkit 0.14.0 → 0.16.0

package/dist/lib/ns/AgentSkill.mjs

@@ -1,46 +1,3 @@
-import { t as __exportAll } from "../chunk-rolldown-runtime.mjs";
 import { a as definitions_exports, t as AgentSkillHandlers } from "../chunk-operations7.mjs";
-import { trim } from "@dxos/util";
-import * as Skill from "@dxos/compute/Skill";
-import * as Template from "@dxos/compute/Template";
-//#region src/skills/agent/AgentSkill.ts
-var AgentSkill_exports = /* @__PURE__ */ __exportAll({
-	Handlers: () => AgentSkillHandlers,
-	Operations: () => definitions_exports,
-	key: () => key,
-	make: () => make
-});
-var key = "org.dxos.skill.agent";
-/**
-* Creates the Agent skill. This is a function to avoid circular dependency issues.
-*/
-var make = () => Skill.make({
-	key,
-	name: "Agent skill",
-	instructions: Template.make({
-		source: trim`
-        You work on an agent. Each agent has instructions - the goal of the agent.
-        The agent plan shows the current progress of the agent.
-
-        {{#with agent}}
-        <agent id="{{id}}" name="{{name}}">
-          <instructions>
-            {{instructions}}
-          </instructions>
-          <plan>
-            {{plan}}
-          </plan>
-        </agent>
-        {{/with}}
-      `,
-		inputs: [{
-			name: "agent",
-			kind: "operation",
-			operation: "org.dxos.operation.assistantToolkit.getContext"
-		}]
-	})
-});
-//#endregion
-export { AgentSkillHandlers as Handlers, definitions_exports as Operations, key, make, AgentSkill_exports as t };
-
-//# sourceMappingURL=AgentSkill.mjs.map
+import { n as key, r as make } from "../chunk-AgentSkill.mjs";
+export { AgentSkillHandlers as Handlers, definitions_exports as Operations, key, make };

package/dist/lib/ns/AlarmSkill.mjs

@@ -1,31 +1,3 @@
-import { t as __exportAll } from "../chunk-rolldown-runtime.mjs";
-import { i as definitions_exports, n as GetCurrentDate, r as SetAlarm, t as AlarmHandlers } from "../chunk-operations6.mjs";
-import { Ref } from "@dxos/echo";
-import { trim } from "@dxos/util";
-import * as Skill from "@dxos/compute/Skill";
-import { Text } from "@dxos/schema";
-//#region src/skills/alarm/AlarmSkill.ts
-var AlarmSkill_exports = /* @__PURE__ */ __exportAll({
-	Handlers: () => AlarmHandlers,
-	Operations: () => definitions_exports,
-	key: () => key,
-	make: () => make
-});
-var key = "org.dxos.skill.alarm";
-var instructions = trim`
-  You can schedule an alarm to wake yourself up in the future and continue working.
-  When the alarm fires you receive a prompt carrying any reminder you set.
-  Read the current time before computing an absolute wake time.
-`;
-var make = () => Skill.make({
-	key,
-	name: "Alarm",
-	description: "Schedule a self-wake and inspect the current time.",
-	agentCanEnable: true,
-	instructions: { source: Ref.make(Text.make({ content: instructions })) },
-	tools: Skill.toolDefinitions({ operations: [SetAlarm, GetCurrentDate] })
-});
-//#endregion
-export { AlarmHandlers as Handlers, definitions_exports as Operations, key, make, AlarmSkill_exports as t };
-
-//# sourceMappingURL=AlarmSkill.mjs.map
+import { i as definitions_exports, t as AlarmHandlers } from "../chunk-operations6.mjs";
+import { n as key, r as make } from "../chunk-AlarmSkill.mjs";
+export { AlarmHandlers as Handlers, definitions_exports as Operations, key, make };

package/dist/lib/ns/AutomationSkill.mjs

@@ -1,100 +1 @@
-import { t as __exportAll } from "../chunk-rolldown-runtime.mjs";
-import { Ref, Type } from "@dxos/echo";
-import { trim } from "@dxos/util";
-import * as Skill from "@dxos/compute/Skill";
-import * as Operation from "@dxos/compute/Operation";
-import { Text } from "@dxos/schema";
-import * as Trigger from "@dxos/compute/Trigger";
-//#region src/skills/automation/AutomationSkill.ts
-var AutomationSkill_exports = /* @__PURE__ */ __exportAll({
-	key: () => key,
-	make: () => make
-});
-var key = "org.dxos.skill.automation";
-var instructions = trim`
-  Automation allows you to automatically initiate actions based on events.
-  Automations are configured by creating a trigger that references a function.
-  Whenever event that matches the trigger occurs, the function is invoked.
-
-  ## Configuration
-
-  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 ${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
-
-  Input to the invoked function is defined by the input property of the Trigger object.
-  It's an object that supports constants or template strings.
-
-  Example:
-
-  {
-    item: '{{event.item}}',
-    instructions: 'Summarize and perform entity-extraction'
-    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 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 ${Type.getTypename(Trigger.Trigger)}.
-  You need access to the Database skill to manipulate triggers.
-  Read trigger schema before manipulating triggers.
-  Having a Trigger object in the database is enough to setup an automation. 
-
-  ## Examples
-
-  Timer:
-
-  {
-    "function": { "/": "echo://AAA/ZZZ" },
-    "enabled": true,
-    "spec": {
-      "kind": "timer",
-      "cron": "*/5 * * * *"
-    }
-  }
-
-  Queue:
-
-  {
-    "function": { "/": "echo://AAA/ZZZ" },
-    "enabled": true,
-    "spec": {
-      "kind": "queue",
-      "queue": "echo://XXX/YYY"
-    }
-  }
-
-  Subscription:
-
-  {
-    "function": { "/": "echo://AAA/ZZZ" },
-    "enabled": true,
-    "spec": {
-      "kind": "subscription",
-      "query": { "ast": { "type": "select", "filter": { "type": "object", "typename": "dxn:org.dxos.type.person" } } }
-    }
-  }
-`;
-var make = () => Skill.make({
-	key,
-	name: "Triggers",
-	description: "Trigger management and automation.",
-	instructions: { source: Ref.make(Text.make({ content: instructions })) }
-});
-//#endregion
-export { key, make, AutomationSkill_exports as t };
-
-//# sourceMappingURL=AutomationSkill.mjs.map
+export { n as key, r as make } from "../chunk-AutomationSkill.mjs";

package/dist/lib/ns/BrowserSkill.mjs

@@ -1,30 +1 @@
-import { t as __exportAll } from "../chunk-rolldown-runtime.mjs";
-import { Ref } from "@dxos/echo";
-import { trim } from "@dxos/util";
-import * as Skill from "@dxos/compute/Skill";
-import { Text } from "@dxos/schema";
-//#region src/skills/browser/BrowserSkill.ts
-var BrowserSkill_exports = /* @__PURE__ */ __exportAll({
-	key: () => key,
-	make: () => make
-});
-var key = "org.dxos.skill.browser";
-var instructions = trim`
-  You are able to connect and use a virtual browser with persistent session.
-  Browser tools are provided via MCP.
-`;
-var make = () => Skill.make({
-	key,
-	name: "Browser",
-	description: "Access to a real isolated browser.",
-	agentCanEnable: true,
-	instructions: { source: Ref.make(Text.make({ content: instructions })) },
-	mcpServers: [{
-		url: "https://playwright-mcp-example.dxos.workers.dev/sse",
-		protocol: "sse"
-	}]
-});
-//#endregion
-export { key, make, BrowserSkill_exports as t };
-
-//# sourceMappingURL=BrowserSkill.mjs.map
+export { n as key, r as make } from "../chunk-BrowserSkill.mjs";

package/dist/lib/ns/ChatContextSkill.mjs

@@ -1,31 +1,3 @@
-import { t as __exportAll } from "../chunk-rolldown-runtime.mjs";
-import { i as definitions_exports, n as ContextAdd, r as ContextRemove, t as ChatContextHandlers } from "../chunk-operations5.mjs";
-import { Ref } from "@dxos/echo";
-import { trim } from "@dxos/util";
-import * as Skill from "@dxos/compute/Skill";
-import { Text } from "@dxos/schema";
-//#region src/skills/chat-context/ChatContextSkill.ts
-var ChatContextSkill_exports = /* @__PURE__ */ __exportAll({
-	Handlers: () => ChatContextHandlers,
-	Operations: () => definitions_exports,
-	key: () => key,
-	make: () => make
-});
-var key = "org.dxos.skill.chatContext";
-var instructions = trim`
-  You can bind objects into the chat's context so later turns can see them, and unbind them again.
-  Reading and writing the objects themselves — including types, relations and tags — is the
-  Database skill's job (plugin-space).
-`;
-var make = () => Skill.make({
-	key,
-	name: "Chat context",
-	description: "Bind objects into the chat's context, and unbind them.",
-	agentCanEnable: true,
-	instructions: { source: Ref.make(Text.make({ content: instructions })) },
-	tools: Skill.toolDefinitions({ operations: [ContextAdd, ContextRemove] })
-});
-//#endregion
-export { ChatContextHandlers as Handlers, definitions_exports as Operations, key, make, ChatContextSkill_exports as t };
-
-//# sourceMappingURL=ChatContextSkill.mjs.map
+import { i as definitions_exports, t as ChatContextHandlers } from "../chunk-operations5.mjs";
+import { n as key, r as make } from "../chunk-ChatContextSkill.mjs";
+export { ChatContextHandlers as Handlers, definitions_exports as Operations, key, make };

package/dist/lib/ns/DelegationSkill.mjs

@@ -1,32 +1,3 @@
-import { t as __exportAll } from "../chunk-rolldown-runtime.mjs";
-import { i as definitions_exports, n as DelegateTask, r as DelegateTasks, t as DelegationSkillHandlers } from "../chunk-operations.mjs";
-import { trim } from "@dxos/util";
-import * as Skill from "@dxos/compute/Skill";
-import * as Template from "@dxos/compute/Template";
-//#region src/skills/delegation/DelegationSkill.ts
-var DelegationSkill_exports = /* @__PURE__ */ __exportAll({
-	Handlers: () => DelegationSkillHandlers,
-	Operations: () => definitions_exports,
-	key: () => key,
-	make: () => make
-});
-var key = "org.dxos.skill.delegation";
-var make = () => Skill.make({
-	key,
-	name: "Delegation",
-	description: "Delegates work to sub-agents and tracks it as plan tasks.",
-	tools: Skill.toolDefinitions({ operations: [DelegateTask, DelegateTasks] }),
-	instructions: Template.make({ source: trim`
-        {{! Delegation }}
-
-        Delegate existing checklist tasks with the delegate-tasks tool, selecting by 1-based
-        ordinal or exact title; delegate-task creates a NEW task from a title. When unsure what
-        the checklist holds, read it first (get-agent-context when available). Delegated tasks
-        run in the background once their dependencies are done, and each result is reported back
-        to the conversation.
-      ` })
-});
-//#endregion
-export { DelegationSkillHandlers as Handlers, definitions_exports as Operations, key, make, DelegationSkill_exports as t };
-
-//# sourceMappingURL=DelegationSkill.mjs.map
+import { i as definitions_exports, t as DelegationSkillHandlers } from "../chunk-operations.mjs";
+import { n as key, r as make } from "../chunk-DelegationSkill.mjs";
+export { DelegationSkillHandlers as Handlers, definitions_exports as Operations, key, make };

package/dist/lib/ns/DelegationStrategy.mjs

@@ -1,2 +1 @@
-import { n as isSubAgentTask, r as makeDelegationStrategy } from "../chunk-DelegationStrategy.mjs";
-export { isSubAgentTask, makeDelegationStrategy as make };
+export { n as isSubAgentTask, r as make } from "../chunk-DelegationStrategy.mjs";

package/dist/lib/ns/MemorySkill.mjs

@@ -1,39 +1,3 @@
-import { t as __exportAll } from "../chunk-rolldown-runtime.mjs";
-import { a as definitions_exports, i as SaveMemory, n as DeleteMemory, r as QueryMemories, t as MemoryHandlers } from "../chunk-operations4.mjs";
-import { Ref } from "@dxos/echo";
-import { trim } from "@dxos/util";
-import * as Skill from "@dxos/compute/Skill";
-import { Text } from "@dxos/schema";
-//#region src/skills/memory/MemorySkill.ts
-var MemorySkill_exports = /* @__PURE__ */ __exportAll({
-	Handlers: () => MemoryHandlers,
-	Operations: () => definitions_exports,
-	key: () => key,
-	make: () => make
-});
-var key = "org.dxos.skill.memory";
-var instructions = trim`
-  You have the ability to save and recall memories.
-  Memories are persistent knowledge units stored in the database.
-  Use memories to remember facts, user preferences, decisions, and any knowledge that should persist across conversations.
-
-  When the user asks you to remember something, save it as a memory with a descriptive title.
-  When the user asks about something you might have stored, query your memories first.
-  You can also delete outdated or incorrect memories.
-`;
-var make = () => Skill.make({
-	key,
-	name: "Memory",
-	description: "Persistent memory storage and retrieval.",
-	agentCanEnable: true,
-	instructions: { source: Ref.make(Text.make({ content: instructions })) },
-	tools: Skill.toolDefinitions({ operations: [
-		SaveMemory,
-		QueryMemories,
-		DeleteMemory
-	] })
-});
-//#endregion
-export { MemoryHandlers as Handlers, definitions_exports as Operations, key, make, MemorySkill_exports as t };
-
-//# sourceMappingURL=MemorySkill.mjs.map
+import { a as definitions_exports, t as MemoryHandlers } from "../chunk-operations4.mjs";
+import { n as key, r as make } from "../chunk-MemorySkill.mjs";
+export { MemoryHandlers as Handlers, definitions_exports as Operations, key, make };

package/dist/lib/ns/PlanningSkill.mjs

@@ -1,47 +1,3 @@
-import { t as __exportAll } from "../chunk-rolldown-runtime.mjs";
-import { a as definitions_exports, i as UpdateTasks, n as AskQuestion, r as PlanReminder, t as PlanningHandlers } from "../chunk-operations3.mjs";
-import { Ref } from "@dxos/echo";
-import { trim } from "@dxos/util";
-import * as Skill from "@dxos/compute/Skill";
-import * as Template from "@dxos/compute/Template";
-import * as Operation from "@dxos/compute/Operation";
-//#region src/skills/planning/PlanningSkill.ts
-var PlanningSkill_exports = /* @__PURE__ */ __exportAll({
-	Handlers: () => PlanningHandlers,
-	Operations: () => definitions_exports,
-	key: () => key,
-	make: () => make
-});
-var key = "org.dxos.skill.planning";
-var make = () => Skill.make({
-	key,
-	name: "Planning",
-	description: "Plans and tracks complex tasks using artifacts.",
-	agentCanEnable: true,
-	tools: Skill.toolDefinitions({ operations: [UpdateTasks, AskQuestion] }),
-	instructions: Template.make({ source: trim`
-        {{! Planning }}
-
-        The conversation has a durable, numbered task checklist that you cannot see directly.
-        Before answering any question about tasks — or acting on a task referenced by number or
-        title — read the current checklist first (call the get-agent-context tool when available;
-        otherwise the update-tasks result echoes it). Ordinals like "task 1" refer to that
-        numbered list, and each line carries the task's ref.
-        Track your work with update-tasks: address an existing task by its ref, set create only to
-        make a new one, keep exactly one task started at a time, and mark a task done as soon as it
-        completes. Starting a task assigns it to you.
-        Do only what the user asked: if they name a specific task or subset, complete exactly
-        that and stop — never start unrequested tasks on your own.
-        A task that already exists elsewhere (a project's task, a sub-task of one you were given) is
-        worked through its own ref — never recreate it with create. assign puts it on this checklist
-        and makes you its assignee; unassign takes it off and clears the assignee, never deleting it.
-      ` }),
-	hooks: [{
-		spec: { _tag: "end-request" },
-		function: Ref.make(Operation.serialize(PlanReminder))
-	}]
-});
-//#endregion
-export { PlanningHandlers as Handlers, definitions_exports as Operations, key, make, PlanningSkill_exports as t };
-
-//# sourceMappingURL=PlanningSkill.mjs.map
+import { a as definitions_exports, t as PlanningHandlers } from "../chunk-operations3.mjs";
+import { n as key, r as make } from "../chunk-PlanningSkill.mjs";
+export { PlanningHandlers as Handlers, definitions_exports as Operations, key, make };

package/dist/lib/ns/SkillManagerSkill.mjs

@@ -1,47 +1,3 @@
-import { t as __exportAll } from "../chunk-rolldown-runtime.mjs";
-import { i as definitions_exports, n as EnableSkills, r as QuerySkills, t as SkillManagerHandlers } from "../chunk-operations2.mjs";
-import { DXN } from "@dxos/keys";
-import { trim } from "@dxos/util";
-import * as Skill from "@dxos/compute/Skill";
-import * as Template from "@dxos/compute/Template";
-//#region src/skills/skill-manager/SkillManagerSkill.ts
-var SkillManagerSkill_exports = /* @__PURE__ */ __exportAll({
-	Handlers: () => SkillManagerHandlers,
-	Operations: () => definitions_exports,
-	key: () => key,
-	make: () => make
-});
-var key = "org.dxos.skill.skillManager";
-var make = () => Skill.make({
-	key,
-	name: "Skill Manager",
-	description: "Query and enable skills in the current conversation.",
-	instructions: Template.make({
-		source: trim`
-        The list below is the current set of available skills — it is rendered fresh into this prompt,
-        so do NOT call [query-skills] to obtain it. Call [enable-skills] directly with the keys you
-        need; only skills marked [agent-can-enable] can be enabled by the agent.
-        Reach for [query-skills] only to re-read the list after something has changed it.
-
-        <available_skills>
-        {{#each skills}}
-        - {{key}} "{{name}}"{{#if description}} -- {{description}}{{/if}}{{#if agentCanEnable}} [agent-can-enable]{{/if}}
-        {{/each}}
-        </available_skills>
-
-        NOTE: A skill's tools only appear once it is enabled. Skills already enabled in this
-        conversation expose their tools to you directly — do not re-enable a skill whose tools you
-        can already see.
-      `,
-		inputs: [{
-			name: "skills",
-			kind: "operation",
-			operation: DXN.getName(QuerySkills.meta.key)
-		}]
-	}),
-	tools: Skill.toolDefinitions({ operations: [QuerySkills, EnableSkills] })
-});
-//#endregion
-export { SkillManagerHandlers as Handlers, definitions_exports as Operations, key, make, SkillManagerSkill_exports as t };
-
-//# sourceMappingURL=SkillManagerSkill.mjs.map
+import { i as definitions_exports, t as SkillManagerHandlers } from "../chunk-operations2.mjs";
+import { n as key, r as make } from "../chunk-SkillManagerSkill.mjs";
+export { SkillManagerHandlers as Handlers, definitions_exports as Operations, key, make };

package/dist/lib/ns/SlashCommand.mjs

@@ -1,41 +1 @@
-import { t as __exportAll } from "../chunk-rolldown-runtime.mjs";
-//#region src/commands.ts
-/**
-* `1 3`, `1,3`, or titles. Quoting is what makes a title unambiguous — a title is often several
-* words (`"Draft release notes"`) and may itself be a number (`"123"`), neither of which a bare
-* whitespace split can express.
-*/
-var parseTaskSelectors = (args) => {
-	const selectors = [];
-	const tokens = args.matchAll(/"([^"]*)"|'([^']*)'|([^\s,]+)/g);
-	for (const [, doubleQuoted, singleQuoted, bare] of tokens) {
-		const quoted = doubleQuoted ?? singleQuoted;
-		if (quoted !== void 0) {
-			if (quoted.length > 0) selectors.push({ title: quoted });
-		} else if (bare !== void 0) selectors.push(/^\d+$/.test(bare) ? { ordinal: Number(bare) } : { title: bare });
-	}
-	return selectors;
-};
-/**
-* Resolves a prompt into one of `commands`: `undefined` when the text is not a known command (it
-* falls through to the model).
-*/
-var resolveSlashCommand = (text, commands) => {
-	if (!text.startsWith("/")) return;
-	const [name, ...rest] = text.split(/\s+/);
-	const command = commands.find((candidate) => candidate.command === name);
-	return command ? {
-		command,
-		args: rest.join(" ")
-	} : void 0;
-};
-//#endregion
-//#region src/SlashCommand.ts
-var SlashCommand_exports = /* @__PURE__ */ __exportAll({
-	parseTaskSelectors: () => parseTaskSelectors,
-	resolveSlashCommand: () => resolveSlashCommand
-});
-//#endregion
-export { parseTaskSelectors, resolveSlashCommand, SlashCommand_exports as t };
-
-//# sourceMappingURL=SlashCommand.mjs.map
+export { n as parseTaskSelectors, r as resolveSlashCommand } from "../chunk-SlashCommand.mjs";

package/dist/lib/ns/WebSearchSkill.mjs

@@ -1,2 +1 @@
-import { a as WebSearchToolkit, c as definitions_exports, i as WebSearchHandlers, n as key, o as WebSearchToolkitOpaque, r as make } from "../chunk-WebSearchSkill.mjs";
-export { WebSearchHandlers as Handlers, definitions_exports as Operations, WebSearchToolkit as Toolkit, WebSearchToolkitOpaque as ToolkitOpaque, key, make };
+export { i as Handlers, c as Operations, a as Toolkit, o as ToolkitOpaque, n as key, r as make } from "../chunk-WebSearchSkill.mjs";

package/dist/lib/testing.mjs

@@ -1,7 +1,7 @@
 import { t as DelegationSkillHandlers } from "./chunk-operations.mjs";
 import { t as SkillManagerHandlers } from "./chunk-operations2.mjs";
 import { t as PlanningHandlers } from "./chunk-operations3.mjs";
-import { Memory } from "./Memory.mjs";
+import { t as Memory } from "./chunk-Memory.mjs";
 import { t as MemoryHandlers } from "./chunk-operations4.mjs";
 import { t as ChatContextHandlers } from "./chunk-operations5.mjs";
 import { t as AlarmHandlers } from "./chunk-operations6.mjs";

package/dist/lib/testing.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"testing.mjs","names":[],"sources":["../../src/skills/testing.ts","../../src/testing/operations.ts","../../src/testing/plugins.tsx"],"sourcesContent":["//\n// Copyright 2025 DXOS.org\n//\n\nimport * as Arr from 'effect/Array';\nimport * as Effect from 'effect/Effect';\nimport { pipe } from 'effect/Function';\n\nimport { ConsolePrinter } from '@dxos/ai';\nimport { AiRequest, AiSession, GenerationObserver, Harness } from '@dxos/assistant';\nimport * as Skill from '@dxos/compute/Skill';\nimport { Database, Ref } from '@dxos/echo';\nimport { log } from '@dxos/log';\n\nexport type TestStep = Pick<AiSession.RunProps, 'prompt' | 'system'> & {\n  test?: () => Promise<void>;\n};\n\n/**\n * Runs the prompt steps, calling the test function after each step.\n */\nexport const runSteps: (\n  session: AiSession.Session,\n  steps: TestStep[],\n) => Effect.Effect<void, AiRequest.RunError, AiRequest.RunRequirements> = Effect.fn(function* (\n  session: AiSession.Session,\n  steps: TestStep[],\n) {\n  for (const { test, ...props } of steps) {\n    yield* session.createRequest({\n      ...props,\n      observer: GenerationObserver.fromPrinter(new ConsolePrinter({ mode: 'json' })),\n    });\n    const messages = yield* Effect.promise(() => session.getHistory());\n    log.info('conversation', { messages });\n    if (test) {\n      yield* Effect.promise(() => test());\n    }\n  }\n});\n\n/**\n * Binds skills from the skill definitions.\n */\n// TODO(dmaretskyi): Potentially the agent will auto-bind the skills.\nexport const addSkills = Effect.fnUntraced(function* (skills: Skill.Definition[]) {\n  const skillRefs = yield* pipe(\n    skills,\n    Arr.map((skill) => skill.make()),\n    Effect.forEach(Database.add),\n    Effect.map(Arr.map(Ref.make)),\n  );\n  yield* Harness.bindContext({ skills: skillRefs });\n});\n","//\n// Copyright 2026 DXOS.org\n//\n\nimport { AssistantTestLayerWithTriggers } from '@dxos/agent-runtime/testing';\nimport { AiContext } from '@dxos/assistant';\nimport * as Agent from '@dxos/assistant/Agent';\nimport * as Chat from '@dxos/assistant/Chat';\nimport { SpaceProperties } from '@dxos/client-protocol';\nimport * as Instructions from '@dxos/compute/Instructions';\nimport * as OperationHandlerSet from '@dxos/compute/OperationHandlerSet';\nimport * as Routine from '@dxos/compute/Routine';\nimport * as Skill from '@dxos/compute/Skill';\nimport * as Trigger from '@dxos/compute/Trigger';\nimport { Collection, Feed, Tag } from '@dxos/echo';\nimport { Text } from '@dxos/schema';\nimport { Employer, Organization, Outline, Person, Task, TaskSet } from '@dxos/types';\n\nimport { AgentHandlers } from '../operations/index.ts';\nimport { AgentSkillHandlers } from '../skills/agent/operations/index.ts';\nimport { AlarmHandlers } from '../skills/alarm/operations/index.ts';\nimport { ChatContextHandlers } from '../skills/chat-context/operations/index.ts';\nimport { DelegationSkillHandlers } from '../skills/delegation/operations/index.ts';\nimport { MemoryHandlers } from '../skills/memory/operations/index.ts';\nimport { PlanningHandlers } from '../skills/planning/operations/index.ts';\nimport { SkillManagerHandlers } from '../skills/skill-manager/operations/index.ts';\nimport * as Memory from '../types/Memory.ts';\n\n/**\n * Shared layer for operation tests: every handler in the package plus the types those handlers\n * touch, with no language model. Defined once so a `.test.ts` per handler does not restate it —\n * handler sets are lazy, so registering all of them costs nothing until one is invoked.\n */\nexport const OperationTestLayer = AssistantTestLayerWithTriggers({\n  operationHandlers: OperationHandlerSet.merge(\n    AgentHandlers,\n    AgentSkillHandlers,\n    AlarmHandlers,\n    ChatContextHandlers,\n    DelegationSkillHandlers,\n    MemoryHandlers,\n    PlanningHandlers,\n    SkillManagerHandlers,\n  ),\n  types: [\n    Agent.Agent,\n    AiContext.Binding,\n    Chat.Chat,\n    Collection.Collection,\n    Employer.Employer,\n    Feed.Feed,\n    Instructions.Instructions,\n    Memory.Memory,\n    Organization.Organization,\n    Person.Person,\n    Outline.Outline,\n    Routine.Routine,\n    Task.Task,\n    TaskSet.TaskSet,\n    Skill.Skill,\n    SpaceProperties,\n    Tag.Tag,\n    Text.Text,\n    Trigger.Trigger,\n  ],\n  disableLlmMemoization: true,\n});\n","//\n// Copyright 2025 DXOS.org\n//\n\nimport * as Schema from 'effect/Schema';\nimport React from 'react';\n\nimport * as Capabilities from '@dxos/app-framework/Capabilities';\nimport * as Capability from '@dxos/app-framework/Capability';\nimport * as Surface from '@dxos/app-framework/Surface';\nimport * as AppSurface from '@dxos/app-toolkit/AppSurface';\nimport { DXN, Format, type Obj, Type } from '@dxos/echo';\nimport { Syntax } from '@dxos/react-ui-syntax-highlighter';\nimport * as Card from '@dxos/react-ui/Card';\nimport * as Position from '@dxos/util/Position';\n\nexport const MapSchema = Schema.Struct({\n  coordinates: Format.GeoPoint,\n}).pipe(Type.makeObject(DXN.make('com.example.type.map', '0.1.0')));\n\nexport type MapSchema = Type.InstanceType<typeof MapSchema>;\n\n// TODO(burdon): Move to ECHO def.\nexport type ArtifactsContext = {\n  items: Obj.Unknown[];\n  getArtifacts: () => Obj.Unknown[];\n  addArtifact: (artifact: Obj.Unknown) => void;\n};\n\ndeclare global {\n  interface ToolContextExtensions {\n    artifacts?: ArtifactsContext;\n  }\n}\n\nexport const capabilities: Capability.AnyContribution[] = [\n  Capability.contribute(\n    Capabilities.ReactSurface,\n    Surface.create({\n      id: 'pluginDefault',\n      filter: Surface.makeFilter(AppSurface.CardContent),\n      position: Position.last,\n      component: ({ data }) => (\n        <Card.Body>\n          <Syntax.Root data={data}>\n            <Syntax.Content>\n              <Syntax.Filter />\n              <Syntax.Viewport>\n                <Syntax.Code />\n              </Syntax.Viewport>\n            </Syntax.Content>\n          </Syntax.Root>\n        </Card.Body>\n      ),\n    }),\n  ),\n];\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAqBA,IAAa,WAG6D,OAAO,GAAG,WAClF,SACA,OACA;CACA,KAAK,MAAM,EAAE,MAAM,GAAG,WAAW,OAAO;EACtC,OAAO,QAAQ,cAAc;GAC3B,GAAG;GACH,UAAU,mBAAmB,YAAY,IAAI,eAAe,EAAE,MAAM,OAAO,CAAC,CAAC;EAC/E,CAAC;EACD,MAAM,WAAW,OAAO,OAAO,cAAc,QAAQ,WAAW,CAAC;EACjE,IAAI,KAAK,gBAAgB,EAAE,SAAS,GAAA;GAAA,YAAA;GAAA,GAAA;GAAA,GAAA;GAAA,GAAA;EAAA,CAAC;EACrC,IAAI,MACF,OAAO,OAAO,cAAc,KAAK,CAAC;CAEtC;AACF,CAAC;;;;AAMD,IAAa,YAAY,OAAO,WAAW,WAAW,QAA4B;CAChF,MAAM,YAAY,OAAO,KACvB,QACA,IAAI,KAAK,UAAU,MAAM,KAAK,CAAC,GAC/B,OAAO,QAAQ,SAAS,GAAG,GAC3B,OAAO,IAAI,IAAI,IAAI,IAAI,IAAI,CAAC,CAC9B;CACA,OAAO,QAAQ,YAAY,EAAE,QAAQ,UAAU,CAAC;AAClD,CAAC;;;;;;;;ACpBD,IAAa,qBAAqB,+BAA+B;CAC/D,mBAAmB,oBAAoB,MACrC,eACA,oBACA,eACA,qBACA,yBACA,gBACA,kBACA,oBACF;CACA,OAAO;EACL,MAAM;EACN,UAAU;EACV,KAAK;EACL,WAAW;EACX,SAAS;EACT,KAAK;EACL,aAAa;EACb;EACA,aAAa;EACb,OAAO;EACP,QAAQ;EACR,QAAQ;EACR,KAAK;EACL,QAAQ;EACR,MAAM;EACN;EACA,IAAI;EACJ,KAAK;EACL,QAAQ;CACV;CACA,uBAAuB;AACzB,CAAC;;;AClDD,IAAa,YAAY,OAAO,OAAO,EACrC,aAAa,OAAO,SACtB,CAAC,CAAC,CAAC,KAAK,KAAK,WAAW,IAAI,KAAK,wBAAwB,OAAO,CAAC,CAAC;AAiBlE,IAAa,eAA6C,CACxD,WAAW,WACT,aAAa,cACb,QAAQ,OAAO;CACb,IAAI;CACJ,QAAQ,QAAQ,WAAW,WAAW,WAAW;CACjD,UAAU,SAAS;CACnB,YAAY,EAAE,WACZ,oBAAC,KAAK,MAAN,EAAA,UACE,oBAAC,OAAO,MAAR;EAAmB;EACjB,UAAA,qBAAC,OAAO,SAAR,EAAA,UAAA,CACE,oBAAC,OAAO,QAAR,CAAgB,CAAA,GAChB,oBAAC,OAAO,UAAR,EAAA,UACE,oBAAC,OAAO,MAAR,CAAc,CAAA,EACC,CAAA,CACH,EAAA,CAAA;CACL,CAAA,EACJ,CAAA;AAEf,CAAC,CACH,CACF"}
+{"version":3,"file":"testing.mjs","names":["Memory.Memory"],"sources":["../../src/skills/testing.ts","../../src/testing/operations.ts","../../src/testing/plugins.tsx"],"sourcesContent":["//\n// Copyright 2025 DXOS.org\n//\n\nimport * as Arr from 'effect/Array';\nimport * as Effect from 'effect/Effect';\nimport { pipe } from 'effect/Function';\n\nimport { ConsolePrinter } from '@dxos/ai';\nimport { AiRequest, AiSession, GenerationObserver, Harness } from '@dxos/assistant';\nimport * as Skill from '@dxos/compute/Skill';\nimport { Database, Ref } from '@dxos/echo';\nimport { log } from '@dxos/log';\n\nexport type TestStep = Pick<AiSession.RunProps, 'prompt' | 'system'> & {\n  test?: () => Promise<void>;\n};\n\n/**\n * Runs the prompt steps, calling the test function after each step.\n */\nexport const runSteps: (\n  session: AiSession.Session,\n  steps: TestStep[],\n) => Effect.Effect<void, AiRequest.RunError, AiRequest.RunRequirements> = Effect.fn(function* (\n  session: AiSession.Session,\n  steps: TestStep[],\n) {\n  for (const { test, ...props } of steps) {\n    yield* session.createRequest({\n      ...props,\n      observer: GenerationObserver.fromPrinter(new ConsolePrinter({ mode: 'json' })),\n    });\n    const messages = yield* Effect.promise(() => session.getHistory());\n    log.info('conversation', { messages });\n    if (test) {\n      yield* Effect.promise(() => test());\n    }\n  }\n});\n\n/**\n * Binds skills from the skill definitions.\n */\n// TODO(dmaretskyi): Potentially the agent will auto-bind the skills.\nexport const addSkills = Effect.fnUntraced(function* (skills: Skill.Definition[]) {\n  const skillRefs = yield* pipe(\n    skills,\n    Arr.map((skill) => skill.make()),\n    Effect.forEach(Database.add),\n    Effect.map(Arr.map(Ref.make)),\n  );\n  yield* Harness.bindContext({ skills: skillRefs });\n});\n","//\n// Copyright 2026 DXOS.org\n//\n\nimport { AssistantTestLayerWithTriggers } from '@dxos/agent-runtime/testing';\nimport { AiContext } from '@dxos/assistant';\nimport * as Agent from '@dxos/assistant/Agent';\nimport * as Chat from '@dxos/assistant/Chat';\nimport { SpaceProperties } from '@dxos/client-protocol';\nimport * as Instructions from '@dxos/compute/Instructions';\nimport * as OperationHandlerSet from '@dxos/compute/OperationHandlerSet';\nimport * as Routine from '@dxos/compute/Routine';\nimport * as Skill from '@dxos/compute/Skill';\nimport * as Trigger from '@dxos/compute/Trigger';\nimport { Collection, Feed, Tag } from '@dxos/echo';\nimport { Text } from '@dxos/schema';\nimport { Employer, Organization, Outline, Person, Task, TaskSet } from '@dxos/types';\n\nimport { AgentHandlers } from '../operations/index.ts';\nimport { AgentSkillHandlers } from '../skills/agent/operations/index.ts';\nimport { AlarmHandlers } from '../skills/alarm/operations/index.ts';\nimport { ChatContextHandlers } from '../skills/chat-context/operations/index.ts';\nimport { DelegationSkillHandlers } from '../skills/delegation/operations/index.ts';\nimport { MemoryHandlers } from '../skills/memory/operations/index.ts';\nimport { PlanningHandlers } from '../skills/planning/operations/index.ts';\nimport { SkillManagerHandlers } from '../skills/skill-manager/operations/index.ts';\nimport * as Memory from '../types/Memory.ts';\n\n/**\n * Shared layer for operation tests: every handler in the package plus the types those handlers\n * touch, with no language model. Defined once so a `.test.ts` per handler does not restate it —\n * handler sets are lazy, so registering all of them costs nothing until one is invoked.\n */\nexport const OperationTestLayer = AssistantTestLayerWithTriggers({\n  operationHandlers: OperationHandlerSet.merge(\n    AgentHandlers,\n    AgentSkillHandlers,\n    AlarmHandlers,\n    ChatContextHandlers,\n    DelegationSkillHandlers,\n    MemoryHandlers,\n    PlanningHandlers,\n    SkillManagerHandlers,\n  ),\n  types: [\n    Agent.Agent,\n    AiContext.Binding,\n    Chat.Chat,\n    Collection.Collection,\n    Employer.Employer,\n    Feed.Feed,\n    Instructions.Instructions,\n    Memory.Memory,\n    Organization.Organization,\n    Person.Person,\n    Outline.Outline,\n    Routine.Routine,\n    Task.Task,\n    TaskSet.TaskSet,\n    Skill.Skill,\n    SpaceProperties,\n    Tag.Tag,\n    Text.Text,\n    Trigger.Trigger,\n  ],\n  disableLlmMemoization: true,\n});\n","//\n// Copyright 2025 DXOS.org\n//\n\nimport * as Schema from 'effect/Schema';\nimport React from 'react';\n\nimport * as Capabilities from '@dxos/app-framework/Capabilities';\nimport * as Capability from '@dxos/app-framework/Capability';\nimport * as Surface from '@dxos/app-framework/Surface';\nimport * as AppSurface from '@dxos/app-toolkit/AppSurface';\nimport { DXN, Format, type Obj, Type } from '@dxos/echo';\nimport { Syntax } from '@dxos/react-ui-syntax-highlighter';\nimport * as Card from '@dxos/react-ui/Card';\nimport * as Position from '@dxos/util/Position';\n\nexport const MapSchema = Schema.Struct({\n  coordinates: Format.GeoPoint,\n}).pipe(Type.makeObject(DXN.make('com.example.type.map', '0.1.0')));\n\nexport type MapSchema = Type.InstanceType<typeof MapSchema>;\n\n// TODO(burdon): Move to ECHO def.\nexport type ArtifactsContext = {\n  items: Obj.Unknown[];\n  getArtifacts: () => Obj.Unknown[];\n  addArtifact: (artifact: Obj.Unknown) => void;\n};\n\ndeclare global {\n  interface ToolContextExtensions {\n    artifacts?: ArtifactsContext;\n  }\n}\n\nexport const capabilities: Capability.AnyContribution[] = [\n  Capability.contribute(\n    Capabilities.ReactSurface,\n    Surface.create({\n      id: 'pluginDefault',\n      filter: Surface.makeFilter(AppSurface.CardContent),\n      position: Position.last,\n      component: ({ data }) => (\n        <Card.Body>\n          <Syntax.Root data={data}>\n            <Syntax.Content>\n              <Syntax.Filter />\n              <Syntax.Viewport>\n                <Syntax.Code />\n              </Syntax.Viewport>\n            </Syntax.Content>\n          </Syntax.Root>\n        </Card.Body>\n      ),\n    }),\n  ),\n];\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAqBA,IAAa,WAG6D,OAAO,GAAG,WAClF,SACA,OACA;CACA,KAAK,MAAM,EAAE,MAAM,GAAG,WAAW,OAAO;EACtC,OAAO,QAAQ,cAAc;GAC3B,GAAG;GACH,UAAU,mBAAmB,YAAY,IAAI,eAAe,EAAE,MAAM,OAAO,CAAC,CAAC;EAC/E,CAAC;EACD,MAAM,WAAW,OAAO,OAAO,cAAc,QAAQ,WAAW,CAAC;EACjE,IAAI,KAAK,gBAAgB,EAAE,SAAS,GAAA;GAAA,YAAA;GAAA,GAAA;GAAA,GAAA;GAAA,GAAA;EAAA,CAAC;EACrC,IAAI,MACF,OAAO,OAAO,cAAc,KAAK,CAAC;CAEtC;AACF,CAAC;;;;AAMD,IAAa,YAAY,OAAO,WAAW,WAAW,QAA4B;CAChF,MAAM,YAAY,OAAO,KACvB,QACA,IAAI,KAAK,UAAU,MAAM,KAAK,CAAC,GAC/B,OAAO,QAAQ,SAAS,GAAG,GAC3B,OAAO,IAAI,IAAI,IAAI,IAAI,IAAI,CAAC,CAC9B;CACA,OAAO,QAAQ,YAAY,EAAE,QAAQ,UAAU,CAAC;AAClD,CAAC;;;;;;;;ACpBD,IAAa,qBAAqB,+BAA+B;CAC/D,mBAAmB,oBAAoB,MACrC,eACA,oBACA,eACA,qBACA,yBACA,gBACA,kBACA,oBACF;CACA,OAAO;EACL,MAAM;EACN,UAAU;EACV,KAAK;EACL,WAAW;EACX,SAAS;EACT,KAAK;EACL,aAAa;EACbA;EACA,aAAa;EACb,OAAO;EACP,QAAQ;EACR,QAAQ;EACR,KAAK;EACL,QAAQ;EACR,MAAM;EACN;EACA,IAAI;EACJ,KAAK;EACL,QAAQ;CACV;CACA,uBAAuB;AACzB,CAAC;;;AClDD,IAAa,YAAY,OAAO,OAAO,EACrC,aAAa,OAAO,SACtB,CAAC,CAAC,CAAC,KAAK,KAAK,WAAW,IAAI,KAAK,wBAAwB,OAAO,CAAC,CAAC;AAiBlE,IAAa,eAA6C,CACxD,WAAW,WACT,aAAa,cACb,QAAQ,OAAO;CACb,IAAI;CACJ,QAAQ,QAAQ,WAAW,WAAW,WAAW;CACjD,UAAU,SAAS;CACnB,YAAY,EAAE,WACZ,oBAAC,KAAK,MAAN,EAAA,UACE,oBAAC,OAAO,MAAR;EAAmB;EACjB,UAAA,qBAAC,OAAO,SAAR,EAAA,UAAA,CACE,oBAAC,OAAO,QAAR,CAAgB,CAAA,GAChB,oBAAC,OAAO,UAAR,EAAA,UACE,oBAAC,OAAO,MAAR,CAAc,CAAA,EACC,CAAA,CACH,EAAA,CAAA;CACL,CAAA,EACJ,CAAA;AAEf,CAAC,CACH,CACF"}

package/dist/types/src/skills/agent/operations/definitions.d.ts

@@ -16,6 +16,7 @@ export declare const Relay: Operation.Definition<{
     } | {
         readonly feed: import("@dxos/echo/internal").Ref<import("@dxos/echo/Feed").Feed & import("@dxos/echo/Entity").OfKind<import("@dxos/echo/internal").EntityKind.Object> & Obj.Unknown>;
         readonly item: any;
+        readonly items?: readonly any[] | undefined;
         readonly cursor: string;
     } | {
         readonly data?: {

package/dist/types/src/skills/agent/operations/definitions.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"definitions.d.ts","sourceRoot":"","sources":["../../../../../../src/skills/agent/operations/definitions.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AACrC,OAAO,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAC;AAC1C,OAAO,KAAK,KAAK,MAAM,uBAAuB,CAAC;AAC/C,OAAO,KAAK,IAAI,MAAM,sBAAsB,CAAC;AAC7C,OAAO,KAAK,YAAY,MAAM,4BAA4B,CAAC;AAC3D,OAAO,KAAK,SAAS,MAAM,yBAAyB,CAAC;AAErD,OAAO,EAAE,QAAQ,EAAE,GAAG,EAAO,MAAM,YAAY,CAAC;AAGhD,eAAO,MAAM,KAAK;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;4EAkBhB,CAAC;AAEH,eAAO,MAAM,UAAU;;;;;6CAerB,CAAC;AAEH,eAAO,MAAM,cAAc;;;;;0BA8BzB,CAAC"}
+{"version":3,"file":"definitions.d.ts","sourceRoot":"","sources":["../../../../../../src/skills/agent/operations/definitions.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AACrC,OAAO,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAC;AAC1C,OAAO,KAAK,KAAK,MAAM,uBAAuB,CAAC;AAC/C,OAAO,KAAK,IAAI,MAAM,sBAAsB,CAAC;AAC7C,OAAO,KAAK,YAAY,MAAM,4BAA4B,CAAC;AAC3D,OAAO,KAAK,SAAS,MAAM,yBAAyB,CAAC;AAErD,OAAO,EAAE,QAAQ,EAAE,GAAG,EAAO,MAAM,YAAY,CAAC;AAGhD,eAAO,MAAM,KAAK;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;4EAkBhB,CAAC;AAEH,eAAO,MAAM,UAAU;;;;;6CAerB,CAAC;AAEH,eAAO,MAAM,cAAc;;;;;0BA8BzB,CAAC"}