@dxos/assistant-toolkit 0.14.0 → 0.16.0

package/dist/lib/AgentOperation.mjs

@@ -1,55 +1 @@
-import { t as __exportAll } from "./chunk-rolldown-runtime.mjs";
-import * as Chat from "@dxos/assistant/Chat";
-import * as Instructions from "@dxos/compute/Instructions";
-import { Database, Feed, Ref, Registry } from "@dxos/echo";
-import { DXN as DXN$1 } from "@dxos/keys";
-import * as Schema from "effect/Schema";
-import * as Operation from "@dxos/compute/Operation";
-import { AiService, OpaqueToolkit } from "@dxos/ai";
-import * as Trace from "@dxos/compute/Trace";
-import { Text } from "@dxos/schema";
-//#region src/types/AgentOperation.ts
-var AgentOperation_exports = /* @__PURE__ */ __exportAll({ RunInstructions: () => RunInstructions });
-var RunInstructions = Operation.make({
-	meta: {
-		key: DXN$1.make("org.dxos.operation.assistantToolkit.runInstructions"),
-		name: "Run Instructions",
-		description: "Agentic worker that executes a provided prompt using skills and tools.",
-		icon: "ph--brain--regular"
-	},
-	input: Schema.Struct({
-		instructions: Ref.Ref(Instructions.Instructions),
-		/**
-		* Input object or data.
-		* References get auto-resolved.
-		*/
-		input: Schema.Any.pipe(Schema.annotate({ title: "Input" })),
-		/**
-		* When set, runs in this chat (history, queue, and bound context). Routine skills and context objects are merged into the conversation for this request.
-		*/
-		chat: Schema.optional(Ref.Ref(Chat.Chat)),
-		/**
-		* @default `dxn:com.anthropic.model.claude-opus-5.default`.
-		*/
-		model: Schema.optional(DXN$1.Schema),
-		systemInstructions: Schema.optional(Schema.String).annotate({ description: "Additional system instructions to add to the system prompt." })
-	}),
-	output: Schema.Any,
-	types: [
-		Instructions.Instructions,
-		Text.Text,
-		Feed.Feed,
-		Chat.Chat
-	],
-	services: [
-		AiService.AiService,
-		Database.Service,
-		OpaqueToolkit.OpaqueToolkitProvider,
-		Registry.Service,
-		Trace.TraceService
-	]
-});
-//#endregion
-export { RunInstructions, AgentOperation_exports as t };
-
-//# sourceMappingURL=AgentOperation.mjs.map
+export { n as RunInstructions } from "./chunk-AgentOperation.mjs";

package/dist/lib/Memory.mjs

@@ -1,19 +1 @@
-import { t as __exportAll } from "./chunk-rolldown-runtime.mjs";
-import { Annotation, DXN, Type } from "@dxos/echo";
-import * as Schema from "effect/Schema";
-//#region src/types/Memory.ts
-var Memory_exports = /* @__PURE__ */ __exportAll({ Memory: () => Memory });
-/**
-* Unit of knowledge generated by an agent.
-*/
-var Memory = class extends Type.makeObject(DXN.make("org.dxos.type.memory", "0.1.0"))(Schema.Struct({
-	title: Schema.String,
-	content: Schema.String
-}).pipe(Annotation.LabelAnnotation.set(["title"]), Annotation.IconAnnotation.set({
-	icon: "ph--brain--regular",
-	hue: "pink"
-}))) {};
-//#endregion
-export { Memory, Memory_exports as t };
-
-//# sourceMappingURL=Memory.mjs.map
+export { t as Memory } from "./chunk-Memory.mjs";

package/dist/lib/chunk-AgentOperation.mjs

@@ -0,0 +1,55 @@
+import { t as __exportAll } from "./chunk-rolldown-runtime.mjs";
+import * as Chat from "@dxos/assistant/Chat";
+import * as Instructions from "@dxos/compute/Instructions";
+import { Database, Feed, Ref, Registry } from "@dxos/echo";
+import { DXN as DXN$1 } from "@dxos/keys";
+import * as Schema from "effect/Schema";
+import * as Operation from "@dxos/compute/Operation";
+import { AiService, OpaqueToolkit } from "@dxos/ai";
+import * as Trace from "@dxos/compute/Trace";
+import { Text } from "@dxos/schema";
+//#region src/types/AgentOperation.ts
+var AgentOperation_exports = /* @__PURE__ */ __exportAll({ RunInstructions: () => RunInstructions });
+var RunInstructions = Operation.make({
+	meta: {
+		key: DXN$1.make("org.dxos.operation.assistantToolkit.runInstructions"),
+		name: "Run Instructions",
+		description: "Agentic worker that executes a provided prompt using skills and tools.",
+		icon: "ph--brain--regular"
+	},
+	input: Schema.Struct({
+		instructions: Ref.Ref(Instructions.Instructions),
+		/**
+		* Input object or data.
+		* References get auto-resolved.
+		*/
+		input: Schema.Any.pipe(Schema.annotate({ title: "Input" })),
+		/**
+		* When set, runs in this chat (history, queue, and bound context). Routine skills and context objects are merged into the conversation for this request.
+		*/
+		chat: Schema.optional(Ref.Ref(Chat.Chat)),
+		/**
+		* @default `dxn:com.anthropic.model.claude-opus-5.default`.
+		*/
+		model: Schema.optional(DXN$1.Schema),
+		systemInstructions: Schema.optional(Schema.String).annotate({ description: "Additional system instructions to add to the system prompt." })
+	}),
+	output: Schema.Any,
+	types: [
+		Instructions.Instructions,
+		Text.Text,
+		Feed.Feed,
+		Chat.Chat
+	],
+	services: [
+		AiService.AiService,
+		Database.Service,
+		OpaqueToolkit.OpaqueToolkitProvider,
+		Registry.Service,
+		Trace.TraceService
+	]
+});
+//#endregion
+export { RunInstructions as n, AgentOperation_exports as t };
+
+//# sourceMappingURL=chunk-AgentOperation.mjs.map

package/dist/lib/chunk-AgentOperation.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"chunk-AgentOperation.mjs","names":["DXN"],"sources":["../../src/types/AgentOperation.ts"],"sourcesContent":["//\n// Copyright 2025 DXOS.org\n//\n\n// @import-as-namespace\n\nimport * as Schema from 'effect/Schema';\n\nimport { AiService, OpaqueToolkit } from '@dxos/ai';\nimport * as Chat from '@dxos/assistant/Chat';\nimport * as Instructions from '@dxos/compute/Instructions';\nimport * as Operation from '@dxos/compute/Operation';\nimport * as Trace from '@dxos/compute/Trace';\nimport { Database, Feed, Ref, Registry } from '@dxos/echo';\nimport { DXN } from '@dxos/keys';\nimport { Text } from '@dxos/schema';\n\nexport const RunInstructions = Operation.make({\n  meta: {\n    key: DXN.make('org.dxos.operation.assistantToolkit.runInstructions'),\n    name: 'Run Instructions',\n    description: 'Agentic worker that executes a provided prompt using skills and tools.',\n    icon: 'ph--brain--regular',\n  },\n  input: Schema.Struct({\n    instructions: Ref.Ref(Instructions.Instructions),\n\n    /**\n     * Input object or data.\n     * References get auto-resolved.\n     */\n    input: Schema.Any.pipe(Schema.annotate({ title: 'Input' })),\n\n    /**\n     * When set, runs in this chat (history, queue, and bound context). Routine skills and context objects are merged into the conversation for this request.\n     */\n    chat: Schema.optional(Ref.Ref(Chat.Chat)),\n\n    /**\n     * @default `dxn:com.anthropic.model.claude-opus-5.default`.\n     */\n    model: Schema.optional(DXN.Schema),\n\n    systemInstructions: Schema.optional(Schema.String).annotate({\n      description: 'Additional system instructions to add to the system prompt.',\n    }),\n  }),\n  output: Schema.Any,\n  // ECHO types that the handler loads via Database.load(). Declaring them here ensures the\n  // runtime registers their schema before remote invocation (e.g. via the EDGE function service).\n  types: [Instructions.Instructions, Text.Text, Feed.Feed, Chat.Chat],\n  services: [\n    AiService.AiService,\n    Database.Service,\n    OpaqueToolkit.OpaqueToolkitProvider,\n    Registry.Service,\n    Trace.TraceService,\n  ],\n});\n"],"mappings":";;;;;;;;;;;;AAiBA,IAAa,kBAAkB,UAAU,KAAK;CAC5C,MAAM;EACJ,KAAKA,MAAI,KAAK,qDAAqD;EACnE,MAAM;EACN,aAAa;EACb,MAAM;CACR;CACA,OAAO,OAAO,OAAO;EACnB,cAAc,IAAI,IAAI,aAAa,YAAY;;;;;EAM/C,OAAO,OAAO,IAAI,KAAK,OAAO,SAAS,EAAE,OAAO,QAAQ,CAAC,CAAC;;;;EAK1D,MAAM,OAAO,SAAS,IAAI,IAAI,KAAK,IAAI,CAAC;;;;EAKxC,OAAO,OAAO,SAASA,MAAI,MAAM;EAEjC,oBAAoB,OAAO,SAAS,OAAO,MAAM,CAAC,CAAC,SAAS,EAC1D,aAAa,8DACf,CAAC;CACH,CAAC;CACD,QAAQ,OAAO;CAGf,OAAO;EAAC,aAAa;EAAc,KAAK;EAAM,KAAK;EAAM,KAAK;CAAI;CAClE,UAAU;EACR,UAAU;EACV,SAAS;EACT,cAAc;EACd,SAAS;EACT,MAAM;CACR;AACF,CAAC"}

package/dist/lib/chunk-AgentOperationHandlerSet.mjs

@@ -0,0 +1,8 @@
+import { t as __exportAll } from "./chunk-rolldown-runtime.mjs";
+import { t as AgentHandlers } from "./chunk-operations8.mjs";
+//#region src/AgentOperationHandlerSet.ts
+var AgentOperationHandlerSet_exports = /* @__PURE__ */ __exportAll({ handlers: () => AgentHandlers });
+//#endregion
+export { AgentOperationHandlerSet_exports as t };
+
+//# sourceMappingURL=chunk-AgentOperationHandlerSet.mjs.map

package/dist/lib/chunk-AgentOperationHandlerSet.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"chunk-AgentOperationHandlerSet.mjs","names":[],"sources":["../../src/AgentOperationHandlerSet.ts"],"sourcesContent":["//\n// Copyright 2026 DXOS.org\n//\n\n// @import-as-namespace\n\nexport { AgentHandlers as handlers } from './operations/index.ts';\n"],"mappings":""}

package/dist/lib/chunk-AgentSkill.mjs

@@ -0,0 +1,46 @@
+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 { key as n, make as r, AgentSkill_exports as t };
+
+//# sourceMappingURL=chunk-AgentSkill.mjs.map

package/dist/lib/chunk-AgentSkill.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"chunk-AgentSkill.mjs","names":[],"sources":["../../src/skills/agent/AgentSkill.ts"],"sourcesContent":["//\n// Copyright 2026 DXOS.org\n//\n\n// @import-as-namespace\n\nimport * as Skill from '@dxos/compute/Skill';\nimport * as Template from '@dxos/compute/Template';\nimport { trim } from '@dxos/util';\n\nexport const key = 'org.dxos.skill.agent';\n\n/**\n * Creates the Agent skill. This is a function to avoid circular dependency issues.\n */\nexport const make = () =>\n  Skill.make({\n    key,\n    name: 'Agent skill',\n    instructions: Template.make({\n      source: trim`\n        You work on an agent. Each agent has instructions - the goal of the agent.\n        The agent plan shows the current progress of the agent.\n\n        {{#with agent}}\n        <agent id=\"{{id}}\" name=\"{{name}}\">\n          <instructions>\n            {{instructions}}\n          </instructions>\n          <plan>\n            {{plan}}\n          </plan>\n        </agent>\n        {{/with}}\n      `,\n      inputs: [\n        {\n          name: 'agent',\n          kind: 'operation',\n          operation: 'org.dxos.operation.assistantToolkit.getContext',\n        },\n      ],\n    }),\n  });\n\nexport { AgentSkillHandlers as Handlers } from './operations/index.ts';\nexport * as Operations from './operations/definitions.ts';\n"],"mappings":";;;;;;;;;;;;AAUA,IAAa,MAAM;;;;AAKnB,IAAa,aACX,MAAM,KAAK;CACT;CACA,MAAM;CACN,cAAc,SAAS,KAAK;EAC1B,QAAQ,IAAI;;;;;;;;;;;;;;;EAeZ,QAAQ,CACN;GACE,MAAM;GACN,MAAM;GACN,WAAW;EACb,CACF;CACF,CAAC;AACH,CAAC"}

package/dist/lib/chunk-AlarmSkill.mjs

@@ -0,0 +1,31 @@
+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 { key as n, make as r, AlarmSkill_exports as t };
+
+//# sourceMappingURL=chunk-AlarmSkill.mjs.map

package/dist/lib/chunk-AlarmSkill.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"chunk-AlarmSkill.mjs","names":[],"sources":["../../src/skills/alarm/AlarmSkill.ts"],"sourcesContent":["//\n// Copyright 2026 DXOS.org\n//\n\n// @import-as-namespace\n\nimport * as Skill from '@dxos/compute/Skill';\nimport { Ref } from '@dxos/echo';\nimport { Text } from '@dxos/schema';\nimport { trim } from '@dxos/util';\n\nimport { GetCurrentDate, SetAlarm } from './operations/definitions.ts';\n\nexport const key = 'org.dxos.skill.alarm';\n\nconst instructions = trim`\n  You can schedule an alarm to wake yourself up in the future and continue working.\n  When the alarm fires you receive a prompt carrying any reminder you set.\n  Read the current time before computing an absolute wake time.\n`;\n\nexport const make = () =>\n  Skill.make({\n    key,\n    name: 'Alarm',\n    description: 'Schedule a self-wake and inspect the current time.',\n    agentCanEnable: true,\n    instructions: {\n      source: Ref.make(Text.make({ content: instructions })),\n    },\n    tools: Skill.toolDefinitions({ operations: [SetAlarm, GetCurrentDate] }),\n  });\n\nexport { AlarmHandlers as Handlers } from './operations/index.ts';\nexport * as Operations from './operations/definitions.ts';\n"],"mappings":";;;;;;;;;;;;;AAaA,IAAa,MAAM;AAEnB,IAAM,eAAe,IAAI;;;;;AAMzB,IAAa,aACX,MAAM,KAAK;CACT;CACA,MAAM;CACN,aAAa;CACb,gBAAgB;CAChB,cAAc,EACZ,QAAQ,IAAI,KAAK,KAAK,KAAK,EAAE,SAAS,aAAa,CAAC,CAAC,EACvD;CACA,OAAO,MAAM,gBAAgB,EAAE,YAAY,CAAC,UAAU,cAAc,EAAE,CAAC;AACzE,CAAC"}

package/dist/lib/chunk-AutomationSkill.mjs

@@ -0,0 +1,100 @@
+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 as n, make as r, AutomationSkill_exports as t };
+
+//# sourceMappingURL=chunk-AutomationSkill.mjs.map

package/dist/lib/chunk-AutomationSkill.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"chunk-AutomationSkill.mjs","names":[],"sources":["../../src/skills/automation/AutomationSkill.ts"],"sourcesContent":["//\n// Copyright 2026 DXOS.org\n//\n\n// @import-as-namespace\n\nimport * as Operation from '@dxos/compute/Operation';\nimport * as Skill from '@dxos/compute/Skill';\nimport * as Trigger from '@dxos/compute/Trigger';\nimport { Ref, Type } from '@dxos/echo';\nimport { Text } from '@dxos/schema';\nimport { trim } from '@dxos/util';\n\nexport const key = 'org.dxos.skill.automation';\n\nconst instructions = trim`\n  Automation allows you to automatically initiate actions based on events.\n  Automations are configured by creating a trigger that references a function.\n  Whenever event that matches the trigger occurs, the function is invoked.\n\n  ## Configuration\n\n  Triggers are configured by the properties of the Trigger object.\n  - enabled: Must be true for trigger to run.\n  - spec: Events that the trigger matches.\n  - 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.\n  - input: The spec of the input data that will be passed to the function.\n\n  ## Input patterns\n\n  Input to the invoked function is defined by the input property of the Trigger object.\n  It's an object that supports constants or template strings.\n\n  Example:\n\n  {\n    item: '{{event.item}}',\n    instructions: 'Summarize and perform entity-extraction'\n    mailbox: { '/': 'echo://AAA/ZZZ' }\n  }\n\n  ## Trigger kinds\n\n  - Timer: Triggered by a cron schedule.\n  - Queue: Subscribes and processes items begginging to end.\n            Note: queues are the same as feeds. The queue EID should be of form: echo://<space-id>/<queue-id>.\n  - Subscription: Subscribes and processes database items based on a query.\n\n  Avoid: email and webhook triggers.\n\n  ## Editing triggers\n\n  Triggers are represented as objects of type ${Type.getTypename(Trigger.Trigger)}.\n  You need access to the Database skill to manipulate triggers.\n  Read trigger schema before manipulating triggers.\n  Having a Trigger object in the database is enough to setup an automation. \n\n  ## Examples\n\n  Timer:\n\n  {\n    \"function\": { \"/\": \"echo://AAA/ZZZ\" },\n    \"enabled\": true,\n    \"spec\": {\n      \"kind\": \"timer\",\n      \"cron\": \"*/5 * * * *\"\n    }\n  }\n\n  Queue:\n\n  {\n    \"function\": { \"/\": \"echo://AAA/ZZZ\" },\n    \"enabled\": true,\n    \"spec\": {\n      \"kind\": \"queue\",\n      \"queue\": \"echo://XXX/YYY\"\n    }\n  }\n\n  Subscription:\n\n  {\n    \"function\": { \"/\": \"echo://AAA/ZZZ\" },\n    \"enabled\": true,\n    \"spec\": {\n      \"kind\": \"subscription\",\n      \"query\": { \"ast\": { \"type\": \"select\", \"filter\": { \"type\": \"object\", \"typename\": \"dxn:org.dxos.type.person\" } } }\n    }\n  }\n`;\n\nexport const make = () =>\n  Skill.make({\n    key,\n    name: 'Triggers',\n    description: 'Trigger management and automation.',\n    instructions: {\n      source: Ref.make(Text.make({ content: instructions })),\n    },\n  });\n"],"mappings":";;;;;;;;;;;;AAaA,IAAa,MAAM;AAEnB,IAAM,eAAe,IAAI;;;;;;;;;;yBAUA,KAAK,YAAY,UAAU,mBAAmB,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;gDA2BzB,KAAK,YAAY,QAAQ,OAAO,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAyClF,IAAa,aACX,MAAM,KAAK;CACT;CACA,MAAM;CACN,aAAa;CACb,cAAc,EACZ,QAAQ,IAAI,KAAK,KAAK,KAAK,EAAE,SAAS,aAAa,CAAC,CAAC,EACvD;AACF,CAAC"}

package/dist/lib/chunk-BrowserSkill.mjs

@@ -0,0 +1,30 @@
+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 as n, make as r, BrowserSkill_exports as t };
+
+//# sourceMappingURL=chunk-BrowserSkill.mjs.map

package/dist/lib/chunk-BrowserSkill.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"chunk-BrowserSkill.mjs","names":[],"sources":["../../src/skills/browser/BrowserSkill.ts"],"sourcesContent":["//\n// Copyright 2025 DXOS.org\n//\n\n// @import-as-namespace\n\nimport * as Skill from '@dxos/compute/Skill';\nimport { Ref } from '@dxos/echo';\nimport { Text } from '@dxos/schema';\nimport { trim } from '@dxos/util';\n\nexport const key = 'org.dxos.skill.browser';\n\nconst instructions = trim`\n  You are able to connect and use a virtual browser with persistent session.\n  Browser tools are provided via MCP.\n`;\n\nexport const make = () =>\n  Skill.make({\n    key,\n    name: 'Browser',\n    description: 'Access to a real isolated browser.',\n    agentCanEnable: true,\n    instructions: {\n      source: Ref.make(Text.make({ content: instructions })),\n    },\n    mcpServers: [\n      {\n        // https://dash.cloudflare.com/950816f3f59b079880a1ae33fb0ec320/workers/services/view/playwright-mcp-example/production\n        url: 'https://playwright-mcp-example.dxos.workers.dev/sse',\n        protocol: 'sse',\n      },\n    ],\n  });\n"],"mappings":";;;;;;;;;;AAWA,IAAa,MAAM;AAEnB,IAAM,eAAe,IAAI;;;;AAKzB,IAAa,aACX,MAAM,KAAK;CACT;CACA,MAAM;CACN,aAAa;CACb,gBAAgB;CAChB,cAAc,EACZ,QAAQ,IAAI,KAAK,KAAK,KAAK,EAAE,SAAS,aAAa,CAAC,CAAC,EACvD;CACA,YAAY,CACV;EAEE,KAAK;EACL,UAAU;CACZ,CACF;AACF,CAAC"}

package/dist/lib/chunk-ChatContextSkill.mjs

@@ -0,0 +1,31 @@
+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 { key as n, make as r, ChatContextSkill_exports as t };
+
+//# sourceMappingURL=chunk-ChatContextSkill.mjs.map

package/dist/lib/chunk-ChatContextSkill.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"chunk-ChatContextSkill.mjs","names":[],"sources":["../../src/skills/chat-context/ChatContextSkill.ts"],"sourcesContent":["//\n// Copyright 2025 DXOS.org\n//\n\n// @import-as-namespace\n\nimport * as Skill from '@dxos/compute/Skill';\nimport { Ref } from '@dxos/echo';\nimport { Text } from '@dxos/schema';\nimport { trim } from '@dxos/util';\n\nimport { ContextAdd, ContextRemove } from './operations/definitions.ts';\n\nexport const key = 'org.dxos.skill.chatContext';\n\nconst instructions = trim`\n  You can bind objects into the chat's context so later turns can see them, and unbind them again.\n  Reading and writing the objects themselves — including types, relations and tags — is the\n  Database skill's job (plugin-space).\n`;\n\nexport const make = () =>\n  Skill.make({\n    key,\n    name: 'Chat context',\n    description: \"Bind objects into the chat's context, and unbind them.\",\n    agentCanEnable: true,\n    instructions: {\n      source: Ref.make(Text.make({ content: instructions })),\n    },\n    tools: Skill.toolDefinitions({\n      operations: [ContextAdd, ContextRemove],\n    }),\n  });\n\nexport { ChatContextHandlers as Handlers } from './operations/index.ts';\nexport * as Operations from './operations/definitions.ts';\n"],"mappings":";;;;;;;;;;;;;AAaA,IAAa,MAAM;AAEnB,IAAM,eAAe,IAAI;;;;;AAMzB,IAAa,aACX,MAAM,KAAK;CACT;CACA,MAAM;CACN,aAAa;CACb,gBAAgB;CAChB,cAAc,EACZ,QAAQ,IAAI,KAAK,KAAK,KAAK,EAAE,SAAS,aAAa,CAAC,CAAC,EACvD;CACA,OAAO,MAAM,gBAAgB,EAC3B,YAAY,CAAC,YAAY,aAAa,EACxC,CAAC;AACH,CAAC"}

package/dist/lib/chunk-DelegationSkill.mjs

@@ -0,0 +1,32 @@
+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 { key as n, make as r, DelegationSkill_exports as t };
+
+//# sourceMappingURL=chunk-DelegationSkill.mjs.map

package/dist/lib/chunk-DelegationSkill.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"chunk-DelegationSkill.mjs","names":[],"sources":["../../src/skills/delegation/DelegationSkill.ts"],"sourcesContent":["//\n// Copyright 2026 DXOS.org\n//\n\n// @import-as-namespace\n\nimport * as Skill from '@dxos/compute/Skill';\nimport * as Template from '@dxos/compute/Template';\nimport { trim } from '@dxos/util';\n\nimport { DelegateTask, DelegateTasks } from './operations/definitions.ts';\n\nexport const key = 'org.dxos.skill.delegation';\n\nexport const make = () =>\n  Skill.make({\n    key,\n    name: 'Delegation',\n    description: 'Delegates work to sub-agents and tracks it as plan tasks.',\n    tools: Skill.toolDefinitions({ operations: [DelegateTask, DelegateTasks] }),\n    instructions: Template.make({\n      source: trim`\n        {{! Delegation }}\n\n        Delegate existing checklist tasks with the delegate-tasks tool, selecting by 1-based\n        ordinal or exact title; delegate-task creates a NEW task from a title. When unsure what\n        the checklist holds, read it first (get-agent-context when available). Delegated tasks\n        run in the background once their dependencies are done, and each result is reported back\n        to the conversation.\n      `,\n    }),\n  });\n\nexport { DelegationSkillHandlers as Handlers } from './operations/index.ts';\nexport * as Operations from './operations/definitions.ts';\n"],"mappings":";;;;;;;;;;;;AAYA,IAAa,MAAM;AAEnB,IAAa,aACX,MAAM,KAAK;CACT;CACA,MAAM;CACN,aAAa;CACb,OAAO,MAAM,gBAAgB,EAAE,YAAY,CAAC,cAAc,aAAa,EAAE,CAAC;CAC1E,cAAc,SAAS,KAAK,EAC1B,QAAQ,IAAI;;;;;;;;QASd,CAAC;AACH,CAAC"}

package/dist/lib/chunk-DelegationStrategy.mjs

@@ -1,7 +1,7 @@
 import { t as __exportAll } from "./chunk-rolldown-runtime.mjs";
 import { n as ToolkitError } from "./chunk-errors.mjs";
-import { key } from "./ns/DelegationSkill.mjs";
-import { RunInstructions } from "./AgentOperation.mjs";
+import { n as key } from "./chunk-DelegationSkill.mjs";
+import { n as RunInstructions } from "./chunk-AgentOperation.mjs";
 import * as Cause from "effect/Cause";
 import * as Effect from "effect/Effect";
 import * as Exit from "effect/Exit";

package/dist/lib/chunk-DelegationStrategy.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"chunk-DelegationStrategy.mjs","names":[],"sources":["../../src/supervisor/delegation-strategy.ts","../../src/DelegationStrategy.ts"],"sourcesContent":["//\n// Copyright 2026 DXOS.org\n//\n\nimport * as Cause from 'effect/Cause';\nimport * as Effect from 'effect/Effect';\nimport * as Exit from 'effect/Exit';\n\nimport { type Delegation, type DelegationStrategy } from '@dxos/agent-runtime';\nimport { AiContext } from '@dxos/assistant';\nimport * as Agent from '@dxos/assistant/Agent';\nimport * as Chat from '@dxos/assistant/Chat';\nimport { OperationProcess } from '@dxos/compute-runtime';\nimport * as Instructions from '@dxos/compute/Instructions';\nimport * as Process from '@dxos/compute/Process';\nimport { Database, Feed, Filter, Obj, Query, Ref } from '@dxos/echo';\nimport * as EffectEx from '@dxos/effect/EffectEx';\nimport { EID, EntityId } from '@dxos/keys';\nimport { log } from '@dxos/log';\nimport { Message, Task } from '@dxos/types';\nimport { trim } from '@dxos/util';\n\nimport { ToolkitError } from '../errors.ts';\nimport * as DelegationSkill from '../skills/delegation/DelegationSkill.ts';\nimport * as AgentOperation from '../types/AgentOperation.ts';\n\n/**\n * Normalizes an LLM-reported artifact reference (bare entity id or full ECHO URI) to a\n * fully-qualified ref in the current space. Not resolved here — it resolves lazily when read.\n */\nconst resolveArtifactRef = (id: string): Effect.Effect<Ref.Ref<Obj.Unknown>, Error, Database.Service> =>\n  Effect.gen(function* () {\n    const parsed = EID.tryParse(id);\n    const candidate = (parsed ? EID.getEntityId(parsed) : undefined) ?? id;\n    if (!EntityId.isValid(candidate)) {\n      // Malformed LLM-reported id: fail so the caller's `orElseSucceed` drops it.\n      return yield* Effect.fail(new ToolkitError({ message: `Invalid artifact id: ${id}` }));\n    }\n    const { db } = yield* Database.Service;\n    return db.makeRef<Obj.Unknown>(EID.make({ spaceId: db.spaceId, entityId: candidate }));\n  });\n\n/**\n * Renders a sub-agent result for inclusion in a notification message.\n */\nconst formatResult = (value: unknown): string => (typeof value === 'string' ? value : JSON.stringify(value));\n\n/**\n * Extracts artifact ids a sub-agent reported in its result (see the synthesized instructions\n * instructions). Tolerates the result being a string, or an object with `artifactIds`/`artifactId`.\n */\nconst extractArtifactIds = (value: unknown): string[] => {\n  if (typeof value !== 'object' || value === null) {\n    return [];\n  }\n\n  const record = value as { artifactIds?: unknown; artifactId?: unknown };\n  const ids = Array.isArray(record.artifactIds)\n    ? record.artifactIds\n    : typeof record.artifactId === 'string'\n      ? [record.artifactId]\n      : [];\n  return ids.filter((id): id is string => typeof id === 'string');\n};\n\n/**\n * A task handed to a sub-agent by the delegation verbs, which assign `{ role: 'assistant' }` and\n * nothing else. An assistant assignee carrying a `subject` names a concrete session that owns the\n * task — the conversation's own agent starting it from the planning tool, or a remote session —\n * so it is that session's work, not a spawn request for the supervisor.\n */\nexport const isSubAgentTask = (task: Task.Task): boolean =>\n  task.assignee?.role === 'assistant' && task.assignee.subject === undefined;\n\n/**\n * The durable agent tasks awaiting a sub-agent for this conversation: queued (`todo`) tasks of\n * the chat's checklist whose assignee is an agent, all of whose dependencies are done. Ordinary\n * (unassigned) tasks are never spawned — delegation happens only through the delegation verbs.\n * `started` always means a live process (set at spawn), so a started agent task with no process\n * is an orphan — {@link sweepOrphanedTasks}.\n */\nconst findPendingTasks = (\n  chat: Chat.Chat,\n  activeIds: ReadonlySet<string>,\n): Effect.Effect<Task.Task[], never, Database.Service> =>\n  Effect.gen(function* () {\n    const tasks = yield* Chat.loadTasks(chat);\n    // The chat's `tasks` array is flat, so a delegated sub-task is found without descending.\n    return tasks.filter(\n      (task) =>\n        isSubAgentTask(task) &&\n        (task.status ?? 'todo') === 'todo' &&\n        !activeIds.has(task.id) &&\n        Task.isTaskReady(tasks, task),\n    );\n  });\n\n/**\n * Fails agent tasks stuck in `started` with no live process — a crashed or never-exited\n * sub-agent (e.g. the host reloaded mid-run) must not wedge the task or the delegation loop.\n */\nconst sweepOrphanedTasks = (\n  chat: Chat.Chat,\n  activeIds: ReadonlySet<string>,\n): Effect.Effect<void, never, Database.Service> =>\n  Effect.gen(function* () {\n    const tasks = yield* Chat.loadTasks(chat);\n    const orphans = tasks.filter(\n      (task) => isSubAgentTask(task) && task.status === 'started' && !activeIds.has(task.id),\n    );\n    if (orphans.length === 0) {\n      return;\n    }\n    for (const task of orphans) {\n      log.warn('orphaned delegated task failed', { taskId: task.id, title: task.title });\n      Obj.update(task, (task) => {\n        task.status = 'failed';\n      });\n    }\n    yield* Database.flush();\n  });\n\n/**\n * Fails the tasks the conversation's own agent holds when its turn fails — a model error ends the\n * process before any reconcile, so a task left `started` would read as underway indefinitely.\n * Sub-agent tasks are left to their own process's exit, which may still succeed.\n */\nconst failHeldTasks = (chat: Chat.Chat, cause: Cause.Cause<unknown>): Effect.Effect<void, never, Database.Service> =>\n  Effect.gen(function* () {\n    const held = (yield* Chat.loadTasks(chat)).filter((task) => Task.isAgentWorking(task) && !isSubAgentTask(task));\n    if (held.length === 0) {\n      return;\n    }\n\n    // The reader sees the error message; the full cause goes to the log.\n    const reason = Cause.prettyErrors(cause)\n      .map((error) => error.message)\n      .join('; ');\n    log.warn('agent turn failed; failing held tasks', { chatId: chat.id, cause: Cause.pretty(cause) });\n    for (const task of held) {\n      Task.setStatus(task, 'failed', {\n        actor: { role: 'assistant', subject: Ref.make(chat) },\n        description: `The agent's request failed${reason ? `: ${reason}` : '.'}`,\n      });\n    }\n    yield* Database.flush();\n  });\n\n/**\n * Supervisor behaviour for the conversational agent: after each turn, every queued agent task\n * whose dependencies are done is run by a sub-agent (a synthesized minimal `Routine` executed via\n * `RunInstructions`), marked started at spawn; on exit the task is marked done/failed and a\n * templated message is posted back to the conversation, whose turn re-runs this reconcile — so a\n * batch of delegated tasks drains in dependency order without further prompting.\n */\nexport const makeDelegationStrategy = (): DelegationStrategy => ({\n  reconcile: (chat, activeIds) =>\n    Effect.gen(function* () {\n      yield* sweepOrphanedTasks(chat, activeIds);\n      const pending = yield* findPendingTasks(chat, activeIds);\n      if (pending.length === 0) {\n        return [];\n      }\n\n      // Sub-agents inherit the supervisor's bound skills (so they have the same tools/\n      // capabilities), minus the delegation skill itself — otherwise a sub-agent could\n      // recursively delegate. Resolved from the conversation's AiContext bindings.\n      const feed = yield* Database.load(chat.feed).pipe(Effect.orDie);\n      const inheritedSkills = yield* Effect.gen(function* () {\n        const runtime = yield* Effect.context<Database.Service>();\n        const binder = yield* EffectEx.acquireReleaseResource(() => new AiContext.Binder({ feed, runtime }));\n        return binder.getSkills().filter((skill) => Obj.getMeta(skill).key !== DelegationSkill.key);\n      }).pipe(Effect.scoped);\n      const skills = inheritedSkills.map((skill) => Ref.make(skill));\n\n      const delegations: Delegation[] = [];\n      for (const task of pending) {\n        // Synthesize a minimal instructions whose goal is the task; the sub-agent runs it via RunInstructions\n        // with the inherited skills bound.\n        const instructions = yield* Database.add(\n          Instructions.make({\n            name: task.title,\n            text: trim`\n              Complete the following task and report the result concisely.\n\n              If you create any documents or artifacts, call completeJob with a JSON object of the\n              form { \"summary\": string, \"artifactIds\": string[] }, where artifactIds are the exact\n              ids returned by the tools that created them. Otherwise return a short summary string.\n\n              Task: ${task.title}\n            `,\n            skills,\n          }),\n        );\n\n        // Started is stamped when the delegation is handed to the runtime — never by the\n        // delegation verbs — so `started` always means a spawning/live sub-agent and an orphaned\n        // `started` is detectable (see the sweep).\n        Obj.update(task, (task) => {\n          task.status = 'started';\n        });\n\n        delegations.push({\n          id: task.id,\n          spawn: Effect.gen(function* () {\n            // The task ↔ process mapping lives runtime-side (the supervisor's activeIds keyed by\n            // task id) — nothing is stamped on the durable task.\n            const handle = yield* Process.spawn(OperationProcess.make(AgentOperation.RunInstructions), {\n              instructions: Ref.make(instructions),\n              input: {},\n            });\n            return handle.pid;\n          }),\n        });\n      }\n      yield* Database.flush();\n      return delegations;\n    }),\n\n  onTurnFailed: failHeldTasks,\n\n  onComplete: (chat, id, exit) =>\n    Effect.gen(function* () {\n      const agent = yield* Agent.loadForChat(chat);\n\n      // Resolve the durable task by its id and record the outcome directly on it — the task set\n      // is the working surface, so there is no separate mirror to reconcile.\n      let title = id;\n      const tasks = yield* Database.query(Query.select(Filter.id(id))).run.pipe(Effect.orElseSucceed(() => []));\n      const task = tasks.find((candidate): candidate is Task.Task => Obj.instanceOf(Task.Task, candidate));\n      if (task) {\n        Obj.update(task, (task) => {\n          task.status = Exit.isSuccess(exit) ? 'done' : 'failed';\n        });\n        title = task.title;\n      }\n\n      // Surface any artifacts the sub-agent produced as inline reference blocks in the notification\n      // message, so follow-up turns can reference them (durable filing belongs to the project's\n      // collection — the agent stores no artifacts).\n      const artifactRefs: Ref.Ref<Obj.Unknown>[] = [];\n      if (agent && Exit.isSuccess(exit)) {\n        for (const artifactId of extractArtifactIds(exit.value)) {\n          const ref = yield* resolveArtifactRef(artifactId).pipe(Effect.orElseSucceed(() => undefined));\n          if (ref) {\n            artifactRefs.push(ref);\n          }\n        }\n      }\n\n      // The full cause (with stack traces) goes to the log; the conversation gets the error\n      // messages only, so delegation errors stay debuggable without dumping a stack in the chat.\n      if (Exit.isFailure(exit)) {\n        log.warn('sub-agent failed', { taskId: id, title, cause: Cause.pretty(exit.cause) });\n      }\n      const failureSummary = Exit.isFailure(exit)\n        ? Cause.prettyErrors(exit.cause)\n            .map((error) => error.message)\n            .join('; ')\n        : undefined;\n\n      const text = Exit.isSuccess(exit)\n        ? `The sub-agent completed \"${title}\".${artifactRefs.length === 0 ? ` ${formatResult(exit.value)}` : ''}`\n        : `The sub-agent failed to complete \"${title}\": ${failureSummary || 'unknown error'}`;\n\n      // Embed each produced artifact as a `reference` block — the chat renders these as a dx-anchor\n      // tag with an inline object preview, rather than a raw `echo://` URI in the text.\n      const blocks = [\n        { _tag: 'text' as const, text },\n        ...artifactRefs.map((reference) => ({ _tag: 'reference' as const, reference })),\n      ];\n\n      const feed = yield* Database.load(chat.feed).pipe(Effect.orDie);\n      yield* Feed.append(feed, [Message.make({ sender: 'assistant', blocks })]);\n    }),\n});\n","//\n// Copyright 2026 DXOS.org\n//\n\n// @import-as-namespace\n\nexport { isSubAgentTask, makeDelegationStrategy as make } from './supervisor/delegation-strategy.ts';\n"],"mappings":"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"}
+{"version":3,"file":"chunk-DelegationStrategy.mjs","names":["DelegationSkill.key","AgentOperation.RunInstructions"],"sources":["../../src/supervisor/delegation-strategy.ts","../../src/DelegationStrategy.ts"],"sourcesContent":["//\n// Copyright 2026 DXOS.org\n//\n\nimport * as Cause from 'effect/Cause';\nimport * as Effect from 'effect/Effect';\nimport * as Exit from 'effect/Exit';\n\nimport { type Delegation, type DelegationStrategy } from '@dxos/agent-runtime';\nimport { AiContext } from '@dxos/assistant';\nimport * as Agent from '@dxos/assistant/Agent';\nimport * as Chat from '@dxos/assistant/Chat';\nimport { OperationProcess } from '@dxos/compute-runtime';\nimport * as Instructions from '@dxos/compute/Instructions';\nimport * as Process from '@dxos/compute/Process';\nimport { Database, Feed, Filter, Obj, Query, Ref } from '@dxos/echo';\nimport * as EffectEx from '@dxos/effect/EffectEx';\nimport { EID, EntityId } from '@dxos/keys';\nimport { log } from '@dxos/log';\nimport { Message, Task } from '@dxos/types';\nimport { trim } from '@dxos/util';\n\nimport { ToolkitError } from '../errors.ts';\nimport * as DelegationSkill from '../skills/delegation/DelegationSkill.ts';\nimport * as AgentOperation from '../types/AgentOperation.ts';\n\n/**\n * Normalizes an LLM-reported artifact reference (bare entity id or full ECHO URI) to a\n * fully-qualified ref in the current space. Not resolved here — it resolves lazily when read.\n */\nconst resolveArtifactRef = (id: string): Effect.Effect<Ref.Ref<Obj.Unknown>, Error, Database.Service> =>\n  Effect.gen(function* () {\n    const parsed = EID.tryParse(id);\n    const candidate = (parsed ? EID.getEntityId(parsed) : undefined) ?? id;\n    if (!EntityId.isValid(candidate)) {\n      // Malformed LLM-reported id: fail so the caller's `orElseSucceed` drops it.\n      return yield* Effect.fail(new ToolkitError({ message: `Invalid artifact id: ${id}` }));\n    }\n    const { db } = yield* Database.Service;\n    return db.makeRef<Obj.Unknown>(EID.make({ spaceId: db.spaceId, entityId: candidate }));\n  });\n\n/**\n * Renders a sub-agent result for inclusion in a notification message.\n */\nconst formatResult = (value: unknown): string => (typeof value === 'string' ? value : JSON.stringify(value));\n\n/**\n * Extracts artifact ids a sub-agent reported in its result (see the synthesized instructions\n * instructions). Tolerates the result being a string, or an object with `artifactIds`/`artifactId`.\n */\nconst extractArtifactIds = (value: unknown): string[] => {\n  if (typeof value !== 'object' || value === null) {\n    return [];\n  }\n\n  const record = value as { artifactIds?: unknown; artifactId?: unknown };\n  const ids = Array.isArray(record.artifactIds)\n    ? record.artifactIds\n    : typeof record.artifactId === 'string'\n      ? [record.artifactId]\n      : [];\n  return ids.filter((id): id is string => typeof id === 'string');\n};\n\n/**\n * A task handed to a sub-agent by the delegation verbs, which assign `{ role: 'assistant' }` and\n * nothing else. An assistant assignee carrying a `subject` names a concrete session that owns the\n * task — the conversation's own agent starting it from the planning tool, or a remote session —\n * so it is that session's work, not a spawn request for the supervisor.\n */\nexport const isSubAgentTask = (task: Task.Task): boolean =>\n  task.assignee?.role === 'assistant' && task.assignee.subject === undefined;\n\n/**\n * The durable agent tasks awaiting a sub-agent for this conversation: queued (`todo`) tasks of\n * the chat's checklist whose assignee is an agent, all of whose dependencies are done. Ordinary\n * (unassigned) tasks are never spawned — delegation happens only through the delegation verbs.\n * `started` always means a live process (set at spawn), so a started agent task with no process\n * is an orphan — {@link sweepOrphanedTasks}.\n */\nconst findPendingTasks = (\n  chat: Chat.Chat,\n  activeIds: ReadonlySet<string>,\n): Effect.Effect<Task.Task[], never, Database.Service> =>\n  Effect.gen(function* () {\n    const tasks = yield* Chat.loadTasks(chat);\n    // The chat's `tasks` array is flat, so a delegated sub-task is found without descending.\n    return tasks.filter(\n      (task) =>\n        isSubAgentTask(task) &&\n        (task.status ?? 'todo') === 'todo' &&\n        !activeIds.has(task.id) &&\n        Task.isTaskReady(tasks, task),\n    );\n  });\n\n/**\n * Fails agent tasks stuck in `started` with no live process — a crashed or never-exited\n * sub-agent (e.g. the host reloaded mid-run) must not wedge the task or the delegation loop.\n */\nconst sweepOrphanedTasks = (\n  chat: Chat.Chat,\n  activeIds: ReadonlySet<string>,\n): Effect.Effect<void, never, Database.Service> =>\n  Effect.gen(function* () {\n    const tasks = yield* Chat.loadTasks(chat);\n    const orphans = tasks.filter(\n      (task) => isSubAgentTask(task) && task.status === 'started' && !activeIds.has(task.id),\n    );\n    if (orphans.length === 0) {\n      return;\n    }\n    for (const task of orphans) {\n      log.warn('orphaned delegated task failed', { taskId: task.id, title: task.title });\n      Obj.update(task, (task) => {\n        task.status = 'failed';\n      });\n    }\n    yield* Database.flush();\n  });\n\n/**\n * Fails the tasks the conversation's own agent holds when its turn fails — a model error ends the\n * process before any reconcile, so a task left `started` would read as underway indefinitely.\n * Sub-agent tasks are left to their own process's exit, which may still succeed.\n */\nconst failHeldTasks = (chat: Chat.Chat, cause: Cause.Cause<unknown>): Effect.Effect<void, never, Database.Service> =>\n  Effect.gen(function* () {\n    const held = (yield* Chat.loadTasks(chat)).filter((task) => Task.isAgentWorking(task) && !isSubAgentTask(task));\n    if (held.length === 0) {\n      return;\n    }\n\n    // The reader sees the error message; the full cause goes to the log.\n    const reason = Cause.prettyErrors(cause)\n      .map((error) => error.message)\n      .join('; ');\n    log.warn('agent turn failed; failing held tasks', { chatId: chat.id, cause: Cause.pretty(cause) });\n    for (const task of held) {\n      Task.setStatus(task, 'failed', {\n        actor: { role: 'assistant', subject: Ref.make(chat) },\n        description: `The agent's request failed${reason ? `: ${reason}` : '.'}`,\n      });\n    }\n    yield* Database.flush();\n  });\n\n/**\n * Supervisor behaviour for the conversational agent: after each turn, every queued agent task\n * whose dependencies are done is run by a sub-agent (a synthesized minimal `Routine` executed via\n * `RunInstructions`), marked started at spawn; on exit the task is marked done/failed and a\n * templated message is posted back to the conversation, whose turn re-runs this reconcile — so a\n * batch of delegated tasks drains in dependency order without further prompting.\n */\nexport const makeDelegationStrategy = (): DelegationStrategy => ({\n  reconcile: (chat, activeIds) =>\n    Effect.gen(function* () {\n      yield* sweepOrphanedTasks(chat, activeIds);\n      const pending = yield* findPendingTasks(chat, activeIds);\n      if (pending.length === 0) {\n        return [];\n      }\n\n      // Sub-agents inherit the supervisor's bound skills (so they have the same tools/\n      // capabilities), minus the delegation skill itself — otherwise a sub-agent could\n      // recursively delegate. Resolved from the conversation's AiContext bindings.\n      const feed = yield* Database.load(chat.feed).pipe(Effect.orDie);\n      const inheritedSkills = yield* Effect.gen(function* () {\n        const runtime = yield* Effect.context<Database.Service>();\n        const binder = yield* EffectEx.acquireReleaseResource(() => new AiContext.Binder({ feed, runtime }));\n        return binder.getSkills().filter((skill) => Obj.getMeta(skill).key !== DelegationSkill.key);\n      }).pipe(Effect.scoped);\n      const skills = inheritedSkills.map((skill) => Ref.make(skill));\n\n      const delegations: Delegation[] = [];\n      for (const task of pending) {\n        // Synthesize a minimal instructions whose goal is the task; the sub-agent runs it via RunInstructions\n        // with the inherited skills bound.\n        const instructions = yield* Database.add(\n          Instructions.make({\n            name: task.title,\n            text: trim`\n              Complete the following task and report the result concisely.\n\n              If you create any documents or artifacts, call completeJob with a JSON object of the\n              form { \"summary\": string, \"artifactIds\": string[] }, where artifactIds are the exact\n              ids returned by the tools that created them. Otherwise return a short summary string.\n\n              Task: ${task.title}\n            `,\n            skills,\n          }),\n        );\n\n        // Started is stamped when the delegation is handed to the runtime — never by the\n        // delegation verbs — so `started` always means a spawning/live sub-agent and an orphaned\n        // `started` is detectable (see the sweep).\n        Obj.update(task, (task) => {\n          task.status = 'started';\n        });\n\n        delegations.push({\n          id: task.id,\n          spawn: Effect.gen(function* () {\n            // The task ↔ process mapping lives runtime-side (the supervisor's activeIds keyed by\n            // task id) — nothing is stamped on the durable task.\n            const handle = yield* Process.spawn(OperationProcess.make(AgentOperation.RunInstructions), {\n              instructions: Ref.make(instructions),\n              input: {},\n            });\n            return handle.pid;\n          }),\n        });\n      }\n      yield* Database.flush();\n      return delegations;\n    }),\n\n  onTurnFailed: failHeldTasks,\n\n  onComplete: (chat, id, exit) =>\n    Effect.gen(function* () {\n      const agent = yield* Agent.loadForChat(chat);\n\n      // Resolve the durable task by its id and record the outcome directly on it — the task set\n      // is the working surface, so there is no separate mirror to reconcile.\n      let title = id;\n      const tasks = yield* Database.query(Query.select(Filter.id(id))).run.pipe(Effect.orElseSucceed(() => []));\n      const task = tasks.find((candidate): candidate is Task.Task => Obj.instanceOf(Task.Task, candidate));\n      if (task) {\n        Obj.update(task, (task) => {\n          task.status = Exit.isSuccess(exit) ? 'done' : 'failed';\n        });\n        title = task.title;\n      }\n\n      // Surface any artifacts the sub-agent produced as inline reference blocks in the notification\n      // message, so follow-up turns can reference them (durable filing belongs to the project's\n      // collection — the agent stores no artifacts).\n      const artifactRefs: Ref.Ref<Obj.Unknown>[] = [];\n      if (agent && Exit.isSuccess(exit)) {\n        for (const artifactId of extractArtifactIds(exit.value)) {\n          const ref = yield* resolveArtifactRef(artifactId).pipe(Effect.orElseSucceed(() => undefined));\n          if (ref) {\n            artifactRefs.push(ref);\n          }\n        }\n      }\n\n      // The full cause (with stack traces) goes to the log; the conversation gets the error\n      // messages only, so delegation errors stay debuggable without dumping a stack in the chat.\n      if (Exit.isFailure(exit)) {\n        log.warn('sub-agent failed', { taskId: id, title, cause: Cause.pretty(exit.cause) });\n      }\n      const failureSummary = Exit.isFailure(exit)\n        ? Cause.prettyErrors(exit.cause)\n            .map((error) => error.message)\n            .join('; ')\n        : undefined;\n\n      const text = Exit.isSuccess(exit)\n        ? `The sub-agent completed \"${title}\".${artifactRefs.length === 0 ? ` ${formatResult(exit.value)}` : ''}`\n        : `The sub-agent failed to complete \"${title}\": ${failureSummary || 'unknown error'}`;\n\n      // Embed each produced artifact as a `reference` block — the chat renders these as a dx-anchor\n      // tag with an inline object preview, rather than a raw `echo://` URI in the text.\n      const blocks = [\n        { _tag: 'text' as const, text },\n        ...artifactRefs.map((reference) => ({ _tag: 'reference' as const, reference })),\n      ];\n\n      const feed = yield* Database.load(chat.feed).pipe(Effect.orDie);\n      yield* Feed.append(feed, [Message.make({ sender: 'assistant', blocks })]);\n    }),\n});\n","//\n// Copyright 2026 DXOS.org\n//\n\n// @import-as-namespace\n\nexport { isSubAgentTask, makeDelegationStrategy as make } from './supervisor/delegation-strategy.ts';\n"],"mappings":"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"}

package/dist/lib/chunk-Memory.mjs

@@ -0,0 +1,19 @@
+import { t as __exportAll } from "./chunk-rolldown-runtime.mjs";
+import { Annotation, DXN, Type } from "@dxos/echo";
+import * as Schema from "effect/Schema";
+//#region src/types/Memory.ts
+var Memory_exports = /* @__PURE__ */ __exportAll({ Memory: () => Memory });
+/**
+* Unit of knowledge generated by an agent.
+*/
+var Memory = class extends Type.makeObject(DXN.make("org.dxos.type.memory", "0.1.0"))(Schema.Struct({
+	title: Schema.String,
+	content: Schema.String
+}).pipe(Annotation.LabelAnnotation.set(["title"]), Annotation.IconAnnotation.set({
+	icon: "ph--brain--regular",
+	hue: "pink"
+}))) {};
+//#endregion
+export { Memory_exports as n, Memory as t };
+
+//# sourceMappingURL=chunk-Memory.mjs.map

package/dist/lib/chunk-Memory.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"chunk-Memory.mjs","names":[],"sources":["../../src/types/Memory.ts"],"sourcesContent":["//\n// Copyright 2026 DXOS.org\n//\n\n// @import-as-namespace\n\nimport * as Schema from 'effect/Schema';\n\nimport { Annotation, DXN, Type } from '@dxos/echo';\n\n/**\n * Unit of knowledge generated by an agent.\n */\nexport class Memory extends Type.makeObject<Memory>(DXN.make('org.dxos.type.memory', '0.1.0'))(\n  Schema.Struct({\n    title: Schema.String,\n    content: Schema.String,\n  }).pipe(\n    Annotation.LabelAnnotation.set(['title']),\n    Annotation.IconAnnotation.set({ icon: 'ph--brain--regular', hue: 'pink' }),\n  ),\n) {}\n"],"mappings":";;;;;;;;AAaA,IAAa,SAAb,cAA4B,KAAK,WAAmB,IAAI,KAAK,wBAAwB,OAAO,CAAC,CAAC,CAC5F,OAAO,OAAO;CACZ,OAAO,OAAO;CACd,SAAS,OAAO;AAClB,CAAC,CAAC,CAAC,KACD,WAAW,gBAAgB,IAAI,CAAC,OAAO,CAAC,GACxC,WAAW,eAAe,IAAI;CAAE,MAAM;CAAsB,KAAK;AAAO,CAAC,CAC3E,CACF,CAAC,CAAC,CAAC"}

package/dist/lib/chunk-MemorySkill.mjs

@@ -0,0 +1,39 @@
+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 { key as n, make as r, MemorySkill_exports as t };
+
+//# sourceMappingURL=chunk-MemorySkill.mjs.map