@dxos/assistant-toolkit 0.10.0 → 0.11.0

package/dist/lib/chunk-operations.mjs

@@ -0,0 +1,714 @@
+import { t as __exportAll } from "./chunk-rolldown-runtime.mjs";
+import { i as ensureOutlineText, o as getFromContext, t as Chat } from "./chunk-Chat.mjs";
+import { n as Agent } from "./chunk-types.mjs";
+import { t as Memory } from "./chunk-Memory.mjs";
+import { Instructions, Operation, OperationHandlerSet, Skill, Trace, TriggerEvent } from "@dxos/compute";
+import { trim } from "@dxos/util";
+import * as Schema from "effect/Schema";
+import { AiService, OpaqueToolkit } from "@dxos/ai";
+import { Harness } from "@dxos/assistant";
+import { AgentService } from "@dxos/compute/AgentService";
+import { Database, Feed, Obj, Ref, Registry, Relation, Tag, Type } from "@dxos/echo";
+import { DXN as DXN$1 } from "@dxos/keys";
+import * as Effect from "effect/Effect";
+import { Outline } from "@dxos/types";
+import { Text } from "@dxos/schema";
+//#region src/skills/agent/operations/definitions.ts
+var definitions_exports$6 = /* @__PURE__ */ __exportAll({
+	GetContext: () => GetContext,
+	Relay: () => Relay
+});
+var Relay = Operation.make({
+	meta: {
+		key: DXN$1.make("org.dxos.function.agent.relay"),
+		name: "Agent Relay",
+		description: "Qualifies a subscription event with a cheap model and forwards it onto the durable agent session.",
+		icon: "ph--funnel--regular"
+	},
+	input: Schema.Struct({
+		/** The chat whose durable session receives the event (carries feed, instructions, and agent). */
+		chat: Schema.suspend(() => Ref.Ref(Chat)),
+		event: Schema.optional(TriggerEvent.TriggerEvent),
+		/** Synthetic wake prompt (e.g. a cron tick) delivered instead of an event payload. */
+		prompt: Schema.optional(Schema.String),
+		/** Skip the cheap-model relevance check (default: qualify when an event is present). */
+		qualify: Schema.optional(Schema.Boolean)
+	}),
+	output: Schema.Void,
+	services: [
+		AiService.AiService,
+		Database.Service,
+		AgentService
+	]
+});
+var GetContext = Operation.make({
+	meta: {
+		key: DXN$1.make("org.dxos.function.agent.getContext"),
+		name: "Get Agent Context",
+		description: "Get the context of an agent.",
+		icon: "ph--info--regular"
+	},
+	input: Schema.Struct({}),
+	output: Schema.Struct({
+		id: Schema.String,
+		name: Schema.String,
+		instructions: Schema.String,
+		checklist: Schema.String
+	}),
+	services: [Harness.HarnessService, Database.Service]
+});
+//#endregion
+//#region src/skills/agent/operations/index.ts
+var AgentSkillHandlers = OperationHandlerSet.lazy(() => import("./chunk-get-context.mjs"), () => import("./chunk-relay.mjs"));
+//#endregion
+//#region src/skills/agent-wizard/operations/definitions.ts
+var definitions_exports$5 = /* @__PURE__ */ __exportAll({
+	AgentRules: () => AgentRules,
+	CreateAgent: () => CreateAgent,
+	SyncAutomation: () => SyncAutomation
+});
+var AgentRules = Operation.make({
+	meta: {
+		key: DXN$1.make("org.dxos.function.agentWizard.agentRules"),
+		name: "Agent rules",
+		description: "Gets the rules for creating an agent.",
+		icon: "ph--book-open--regular"
+	},
+	input: Schema.Struct({}),
+	output: Schema.String
+});
+var CreateAgent = Operation.make({
+	meta: {
+		key: DXN$1.make("org.dxos.function.agentWizard.createAgent"),
+		name: "Create agent",
+		description: "Creates a new agent.",
+		icon: "ph--brain--regular"
+	},
+	input: Schema.Struct({
+		name: Schema.String.annotations({ description: "The name of the agent to create." }),
+		instructions: Schema.String.annotations({ description: "The goal of the agent. Be specific but not too verbose. The agent will use this as a core objective and set of rules to follow." }),
+		skills: Schema.Array(Schema.String).annotations({
+			description: "The skill keys to use for the agent.",
+			examples: [["org.dxos.skill.markdown", "org.dxos.skill.database"]]
+		}),
+		subscriptions: Schema.Array(Ref.Ref(Obj.Unknown)).annotations({ description: "The objects to subscribe to for the agent. Can be references to mailboxes." })
+	}),
+	output: Type.getSchema(Agent),
+	services: [Registry.Service, Database.Service]
+});
+var SyncAutomation = Operation.make({
+	meta: {
+		key: DXN$1.make("org.dxos.function.agent.syncTriggers"),
+		name: "Sync automation",
+		description: "Compiles the agent automation config (subscriptions, optional cron) into Routines that relay events onto the agent session. Recreates everything, so call with the FULL desired config after any change; enabled is copied from the agent onto every trigger.",
+		icon: "ph--arrows-clockwise--regular"
+	},
+	input: Schema.Struct({
+		agent: Ref.Ref(Agent).annotations({ description: "The agent whose automation should be synced." }),
+		subscriptions: Schema.optional(Schema.Array(Ref.Ref(Obj.Unknown)).annotations({ description: "The objects to subscribe to (e.g. mailboxes); each compiles to a feed-triggered routine." })),
+		cron: Schema.optional(Schema.String.annotations({ description: "Cron expression for a scheduled wake routine." })),
+		qualify: Schema.optional(Schema.Boolean.annotations({ description: "Run the cheap-model relevance filter on subscription events (default true)." }))
+	}),
+	output: Schema.Void,
+	services: [Database.Service]
+});
+//#endregion
+//#region src/skills/agent-wizard/operations/index.ts
+var AgentWizardHandlers = OperationHandlerSet.lazy(() => import("./chunk-create-agent.mjs"), () => import("./chunk-agent-rules.mjs"), () => import("./chunk-sync-automation.mjs"));
+//#endregion
+//#region src/skills/alarm/operations/definitions.ts
+var definitions_exports$4 = /* @__PURE__ */ __exportAll({
+	GetCurrentDate: () => GetCurrentDate,
+	SetAlarm: () => SetAlarm
+});
+var SetAlarm = Operation.make({
+	meta: {
+		key: DXN$1.make("org.dxos.function.alarm.setAlarm"),
+		name: "Set alarm",
+		icon: "ph--alarm--regular",
+		description: trim`
+      Schedule an alarm to wake yourself up in the future.
+      Provide exactly one of "in" (a duration from now) or "at" (an absolute time).
+      When the alarm fires you will receive a prompt and can continue working.
+      Setting a new alarm replaces any previously scheduled one.
+    `
+	},
+	input: Schema.Struct({
+		in: Schema.optional(Schema.String.annotations({ description: "Duration from now expressed as \"<number> <unit>\", e.g. \"30 seconds\", \"5 minutes\", \"2 hours\"." })),
+		at: Schema.optional(Schema.String.annotations({ description: "Absolute ISO-8601 timestamp to wake at, e.g. \"2026-06-04T18:00:00.000Z\"." })),
+		message: Schema.optional(Schema.String.annotations({ description: "Optional reminder surfaced verbatim when the alarm fires." }))
+	}),
+	output: Schema.String,
+	services: [Harness.HarnessService]
+});
+var GetCurrentDate = Operation.make({
+	meta: {
+		key: DXN$1.make("org.dxos.function.alarm.getCurrentDate"),
+		name: "Get current date",
+		icon: "ph--clock--regular",
+		description: "Get the current date and time as an ISO-8601 string."
+	},
+	input: Schema.Struct({}),
+	output: Schema.String
+});
+//#endregion
+//#region src/skills/alarm/operations/index.ts
+var AlarmHandlers = OperationHandlerSet.lazy(() => import("./chunk-set-alarm.mjs"), () => import("./chunk-get-current-date.mjs"));
+//#endregion
+//#region src/skills/skill-manager/operations/definitions.ts
+var definitions_exports$3 = /* @__PURE__ */ __exportAll({
+	EnableSkills: () => EnableSkills,
+	QuerySkills: () => QuerySkills
+});
+var QuerySkills = Operation.make({
+	meta: {
+		key: DXN$1.make("org.dxos.function.skillManager.querySkills"),
+		name: "Query skills",
+		description: "Queries available skills.",
+		icon: "ph--blueprint--regular"
+	},
+	input: Schema.Struct({}),
+	output: Schema.Array(Type.getSchema(Skill.Skill)),
+	services: [Registry.Service]
+});
+var EnableSkills = Operation.make({
+	meta: {
+		key: DXN$1.make("org.dxos.function.skillManager.enableSkills"),
+		name: "Enable skills",
+		description: "Enables skills in the current conversation by their keys. Only skills with agentCanEnable=true can be enabled. The available keys are already listed in the system prompt, so call this directly rather than querying first.",
+		icon: "ph--plugs-connected--regular"
+	},
+	input: Schema.Struct({ keys: Schema.Array(Schema.String).annotations({
+		description: "The keys of the skills to enable.",
+		examples: [["org.dxos.skill.memory", "org.dxos.skill.database"]]
+	}) }),
+	output: Schema.Struct({
+		enabled: Schema.Array(Type.getSchema(Skill.Skill)),
+		rejected: Schema.Array(Schema.Struct({
+			key: Schema.String,
+			reason: Schema.String
+		}))
+	}),
+	services: [
+		Registry.Service,
+		Database.Service,
+		Harness.HarnessService
+	]
+});
+//#endregion
+//#region src/skills/skill-manager/operations/index.ts
+var SkillManagerHandlers = OperationHandlerSet.lazy(() => import("./chunk-query-skills.mjs"), () => import("./chunk-enable-skills.mjs"));
+//#endregion
+//#region src/skills/database/operations/definitions.ts
+var definitions_exports$2 = /* @__PURE__ */ __exportAll({
+	ContextAdd: () => ContextAdd,
+	ContextRemove: () => ContextRemove,
+	Load: () => Load,
+	ObjectCreate: () => ObjectCreate,
+	ObjectDelete: () => ObjectDelete,
+	ObjectUpdate: () => ObjectUpdate,
+	Query: () => Query$1,
+	RelationCreate: () => RelationCreate,
+	RelationDelete: () => RelationDelete,
+	SchemaAdd: () => SchemaAdd,
+	SchemaList: () => SchemaList,
+	TagAdd: () => TagAdd,
+	TagRemove: () => TagRemove
+});
+var Query$1 = Operation.make({
+	meta: {
+		key: DXN$1.make("org.dxos.function.database.query"),
+		name: "Query",
+		icon: "ph--magnifying-glass--regular",
+		description: trim`
+      Query for objects in ECHO.
+      Use this tool when searching for information in the space (both automerge and queues).
+      Currently, two types of queries are supported:
+        - Full-text search - terms may appear anywhere in the object.
+        - Type-based search - objects of a specific type.
+      You can use them together, for example, to search for objects of a specific type that match a full-text query.
+      Important: Whem querying by typename, make sure to list the schema first, to get the exact typename.
+
+      Omit both typename and text to search for all objects.
+
+      <output_format>
+        You can choose to either return the full object data, or just the DXN, type and label.
+        When expecting a lot of results, run with includeContent=false to not pollute the context, and then load specific objects using the load tool.
+
+        You can choose to get the content right away, if you don't expect a lot of results.
+        To load content right away, run with includeContent=true.
+        When loading content, set an appropriate limit on the number of results to avoid overwhelming the context.
+      </output_format>
+
+      <example description="All tasks related to Cyberdyne and Bob">
+        {
+          "typename": "org.dxos.type.task",
+          "text": "cyberdyne bob",
+        }
+      </example>
+
+      <example description="Financial report Q1 2026">
+        {
+          "typename": "org.dxos.type.document",
+          "text": "financial report Q1 2026",
+          "includeContent": true
+          "limit": 3
+        }
+      </example>
+
+      <example description="Emails from specific mailboxes">
+        {
+          "in": [{"/" : "echo:///YYYYYY"}, {"/" : "echo:///XXXXXXX"}],
+          "typename": "org.dxos.type.email",
+          "includeContent": true,
+          "limit": 20
+        }
+      </example>
+    `
+	},
+	input: Schema.Struct({
+		in: Schema.optional(Schema.Array(Ref.Ref(Obj.Unknown)).annotations({ description: "Scope the query to children of specific objects (transitively). Use this to query items within containers such as feeds or folders. For example, to find emails use `in: [mailbox1.feed, mailbox2.feed]`." })),
+		typename: Schema.optional(Schema.String.annotations({
+			description: "The typename of the objects to list.",
+			example: "org.dxos.type.task"
+		})),
+		text: Schema.optional(Schema.String.annotations({
+			description: "Full text search query.",
+			example: "email cyberdyne bob"
+		})),
+		includeContent: Schema.optional(Schema.Boolean.annotations({
+			description: "Include the full object data in the response.",
+			default: false
+		})),
+		limit: Schema.optional(Schema.Number.annotations({
+			description: "The maximum number of results to return.",
+			default: 10
+		})),
+		includeQueues: Schema.optional(Schema.Boolean.annotations({
+			description: "Search in queues as well as spaces. Only use this if searching for emails.",
+			default: false
+		}))
+	}),
+	output: Schema.Array(Schema.Unknown),
+	services: [Database.Service]
+});
+var Load = Operation.make({
+	meta: {
+		key: DXN$1.make("org.dxos.function.database.load"),
+		name: "Load object",
+		icon: "ph--download--regular",
+		description: trim`
+      Loads the object or relation content.
+      Can load multiple objects at at time.
+      Use the to read the data when you have a DXN.
+      Call this tool with an array of one or more DXNs or object IDs.
+      When use see a reference ({ '/': 'echo:...' }), you can call this function to load the object.
+      Note that returned data is only a snapshot in time, and might have changed since the object was last loaded.
+    `
+	},
+	input: Schema.Struct({ refs: Schema.Array(Ref.Ref(Obj.Unknown)) }),
+	output: Schema.Unknown,
+	services: [Database.Service]
+});
+var ObjectCreate = Operation.make({
+	meta: {
+		key: DXN$1.make("org.dxos.function.database.objectCreate"),
+		name: "Create object",
+		icon: "ph--plus--regular",
+		description: trim`
+      Creates a new object of any type and adds it to the current space.
+      When a type has its own create tool (e.g. the markdown skill creates documents), prefer that
+      tool — it builds the object's owned parts correctly. Use this one for types that have none.
+      Get the schema from the schema-list tool and ensure that the data matches the corresponding schema.
+      References are provided in the following format: { "/": "echo:..." }.
+      Reference examples: { "/": "echo:///01KG7R1ZXWFMWQ4DA1Q6TN1DG4" }, { "/": "echo://<space id>/01KG7R1ZXWFMWQ4DA1Q6TN1DG4" }
+    `
+	},
+	input: Schema.Struct({
+		typename: Schema.String.annotations({
+			description: "The typename of the object to create.",
+			examples: ["dxn:org.dxos.type.person"]
+		}),
+		properties: Schema.Record({
+			key: Schema.String,
+			value: Schema.Any
+		}),
+		attach: Schema.optional(Schema.Boolean).annotations({ description: trim`
+        Attach the object to the space root collection so it appears in the navigation tree.
+        Set for top-level objects; leave unset for subordinate objects referenced by others.
+      ` })
+	}),
+	output: Schema.Unknown,
+	services: [Database.Service]
+});
+var ObjectUpdate = Operation.make({
+	meta: {
+		key: DXN$1.make("org.dxos.function.database.objectUpdate"),
+		name: "Update object",
+		icon: "ph--pencil--regular",
+		description: trim`
+      Updates the object properties.
+      References are provided in the following format: { "/": "echo:..." }.
+      Reference examples: { "/": "echo:///01KG7R1ZXWFMWQ4DA1Q6TN1DG4" }, { "/": "echo://<space id>/01KG7R1ZXWFMWQ4DA1Q6TN1DG4" }
+    `
+	},
+	input: Schema.Struct({
+		obj: Ref.Ref(Obj.Unknown),
+		properties: Schema.Record({
+			key: Schema.String,
+			value: Schema.Any
+		})
+	}),
+	output: Schema.Unknown,
+	services: [Database.Service]
+});
+var ObjectDelete = Operation.make({
+	meta: {
+		key: DXN$1.make("org.dxos.function.database.objectDelete"),
+		name: "Delete object",
+		description: trim`
+      Deletes the object.
+    `,
+		icon: "ph--trash--regular"
+	},
+	input: Schema.Struct({ obj: Ref.Ref(Obj.Unknown) }),
+	output: Schema.Void,
+	services: [Database.Service]
+});
+var SchemaAdd = Operation.make({
+	meta: {
+		key: DXN$1.make("org.dxos.function.database.schemaAdd"),
+		name: "Add schema",
+		icon: "ph--plus--regular",
+		description: trim`
+      Adds a schema to the space.
+      The name will be used when displayed to the user.
+    `
+	},
+	input: Schema.Struct({
+		name: Schema.String,
+		typename: Schema.String.annotations({ description: "The typename of the schema in the format of \"com.example.type.type\"." }),
+		jsonSchema: Schema.Record({
+			key: Schema.String,
+			value: Schema.Any
+		}).annotations({ description: "The JSON Schema (draft-07) object describing the fields of the new type." })
+	}),
+	output: Schema.Void,
+	services: [Database.Service]
+});
+var SchemaList = Operation.make({
+	meta: {
+		key: DXN$1.make("org.dxos.function.database.schemaList"),
+		name: "List schemas",
+		icon: "ph--list--regular",
+		description: trim`
+      Lists schemas definitions.
+    `
+	},
+	input: Schema.Struct({ limit: Schema.optional(Schema.Number) }),
+	output: Schema.Array(Schema.Unknown),
+	services: [Database.Service]
+});
+var ContextAdd = Operation.make({
+	meta: {
+		key: DXN$1.make("org.dxos.function.database.contextAdd"),
+		name: "Add to context",
+		icon: "ph--plus-circle--regular",
+		description: trim`
+      Adds the object to the chat context.
+      Use this it for objects that are useful long-term for the conversation.
+    `
+	},
+	input: Schema.Struct({ obj: Ref.Ref(Obj.Unknown).annotations({ description: "Object to add to the chat context." }) }),
+	output: Schema.Void,
+	services: [Harness.HarnessService]
+});
+var ContextRemove = Operation.make({
+	meta: {
+		key: DXN$1.make("org.dxos.function.database.contextRemove"),
+		name: "Remove from context",
+		icon: "ph--minus-circle--regular",
+		description: trim`
+      Removes the object from the chat context.
+      Use this it for objects that are no longer useful for the conversation.
+    `
+	},
+	input: Schema.Struct({ obj: Ref.Ref(Obj.Unknown).annotations({ description: "Object to remove from the chat context." }) }),
+	output: Schema.Void,
+	services: [Harness.HarnessService]
+});
+var RelationCreate = Operation.make({
+	meta: {
+		key: DXN$1.make("org.dxos.function.database.relationCreate"),
+		name: "Create relation",
+		icon: "ph--arrows-merge--regular",
+		description: trim`
+      Creates a new relation and adds it to the current space.
+      Get the schema from the schema-list tool and ensure that the data matches the corresponding schema.
+    `
+	},
+	input: Schema.Struct({
+		typename: Schema.String,
+		source: Ref.Ref(Obj.Unknown),
+		target: Ref.Ref(Obj.Unknown),
+		properties: Schema.Any.annotations({ description: "The data to be stored in the relation." })
+	}),
+	output: Schema.Unknown,
+	services: [Database.Service]
+});
+var RelationDelete = Operation.make({
+	meta: {
+		key: DXN$1.make("org.dxos.function.database.relationDelete"),
+		name: "Delete relation",
+		description: trim`
+      Deletes the relation.
+    `,
+		icon: "ph--trash--regular"
+	},
+	input: Schema.Struct({ rel: Ref.Ref(Relation.Unknown) }),
+	output: Schema.Void,
+	services: [Database.Service]
+});
+var TagAdd = Operation.make({
+	meta: {
+		key: DXN$1.make("org.dxos.function.database.tagAdd"),
+		name: "Add tag",
+		icon: "ph--tag--regular",
+		description: trim`
+      Adds a tag to an object.
+      Tags are objects of type ${Type.getTypename(Tag.Tag)}.
+      You must search database for available tags, or create a new one.
+    `
+	},
+	input: Schema.Struct({
+		tag: Ref.Ref(Tag.Tag),
+		obj: Ref.Ref(Obj.Unknown)
+	}),
+	output: Schema.Unknown,
+	services: [Database.Service]
+});
+var TagRemove = Operation.make({
+	meta: {
+		key: DXN$1.make("org.dxos.function.database.tagRemove"),
+		name: "Remove tag",
+		icon: "ph--tag--regular",
+		description: trim`
+      Removes a tag from an object.
+      Tags are objects of type ${Type.getTypename(Tag.Tag)}.
+    `
+	},
+	input: Schema.Struct({
+		tag: Ref.Ref(Tag.Tag),
+		obj: Ref.Ref(Obj.Unknown)
+	}),
+	output: Schema.Unknown,
+	services: [Database.Service]
+});
+//#endregion
+//#region src/skills/database/operations/index.ts
+var DatabaseHandlers = OperationHandlerSet.lazy(() => import("./chunk-context-add.mjs"), () => import("./chunk-context-remove.mjs"), () => import("./chunk-load.mjs"), () => import("./chunk-object-create.mjs"), () => import("./chunk-object-delete.mjs"), () => import("./chunk-object-update.mjs"), () => import("./chunk-query.mjs"), () => import("./chunk-relation-create.mjs"), () => import("./chunk-relation-delete.mjs"), () => import("./chunk-schema-add.mjs"), () => import("./chunk-schema-list.mjs"), () => import("./chunk-tag-add.mjs"), () => import("./chunk-tag-remove.mjs"));
+//#endregion
+//#region src/skills/delegation/operations/delegate-task.ts
+var delegate_task_exports = /* @__PURE__ */ __exportAll({
+	DelegateTask: () => DelegateTask,
+	default: () => delegate_task_default
+});
+var DelegateTask = Operation.make({
+	meta: {
+		key: DXN$1.make("org.dxos.function.delegation.delegateTask"),
+		name: "Delegate task",
+		description: trim`
+      Delegate a unit of work to a sub-agent.
+      Promotes the titled checklist item to a durable in-progress task assigned to an agent, so
+      the supervisor spawns a background sub-agent. Creates the checklist item if absent.
+    `,
+		icon: "ph--share-network--regular"
+	},
+	input: Schema.Struct({ title: Schema.String.annotations({ description: "Title of the work to delegate (matched against the checklist, created if new)." }) }),
+	output: Schema.Any,
+	services: [Harness.HarnessService, Database.Service]
+});
+/**
+* Delegation is the promotion moment: the scratch checklist item becomes a durable `Task`
+* (parented to the outline's task set) assigned to an agent (`role: 'assistant'`), which the
+* supervisor's reconcile loop picks up. The markdown line is checked off only when the sub-agent
+* completes (see the delegation strategy).
+*/
+var delegate_task_default = DelegateTask.pipe(Operation.withHandler(Effect.fn(function* ({ title }) {
+	if (title.length === 0) return yield* Effect.fail(/* @__PURE__ */ new Error("Provide a non-empty task title."));
+	const { outline, text } = yield* ensureOutlineText(yield* getFromContext);
+	const { db } = yield* Database.Service;
+	const task = yield* Effect.promise(() => Outline.createTask(outline, db, title, {
+		status: "in-progress",
+		assignee: { role: "assistant" }
+	}));
+	Obj.update(text, (text) => {
+		text.content = Outline.upsertChecklistItems(text.content, [{
+			title: task.title,
+			done: false
+		}]);
+	});
+	yield* Database.flush();
+	return trim`
+        Delegated "${task.title}" as an in-progress agent task (id: ${task.id}).
+        Current checklist:
+        <checklist>
+          ${text.content}
+        </checklist>
+      `;
+})));
+//#endregion
+//#region src/skills/delegation/operations/index.ts
+var DelegationHandlers = OperationHandlerSet.lazy(() => Promise.resolve().then(() => delegate_task_exports));
+//#endregion
+//#region src/skills/memory/operations/definitions.ts
+var definitions_exports$1 = /* @__PURE__ */ __exportAll({
+	DeleteMemory: () => DeleteMemory,
+	QueryMemories: () => QueryMemories,
+	SaveMemory: () => SaveMemory
+});
+var QueryMemories = Operation.make({
+	meta: {
+		key: DXN$1.make("org.dxos.function.memory.query"),
+		name: "Query memories",
+		description: "Search for stored memories using full-text search. Returns memories matching the query terms. Use this to recall previously saved knowledge, facts, or preferences.",
+		icon: "ph--brain--regular"
+	},
+	input: Schema.Struct({
+		text: Schema.optional(Schema.String.annotations({
+			description: "Full-text search query. Omit to list all memories.",
+			examples: [
+				"new york trip date plan",
+				"favorite color",
+				"project cyberdyne"
+			]
+		})),
+		limit: Schema.optional(Schema.Number.annotations({
+			description: "Maximum number of results to return.",
+			default: 10
+		}))
+	}),
+	output: Schema.Array(Schema.Unknown),
+	services: [Database.Service]
+});
+var SaveMemory = Operation.make({
+	meta: {
+		key: DXN$1.make("org.dxos.function.memory.save"),
+		name: "Save memory",
+		description: "Saves a new memory to the database. Use this to persist knowledge, facts, preferences, or any information that should be remembered across conversations.",
+		icon: "ph--brain--regular"
+	},
+	input: Schema.Struct({
+		title: Schema.String.annotations({ description: "Short descriptive title for the memory." }),
+		content: Schema.String.annotations({ description: "The content of the memory. Can be a fact, preference, instruction, or any knowledge worth persisting." })
+	}),
+	output: Schema.Unknown,
+	services: [Database.Service]
+});
+var DeleteMemory = Operation.make({
+	meta: {
+		key: DXN$1.make("org.dxos.function.memory.delete"),
+		name: "Delete memory",
+		description: "Deletes a memory from the database. Use this to remove outdated or incorrect memories.",
+		icon: "ph--trash--regular"
+	},
+	input: Schema.Struct({ memory: Ref.Ref(Memory) }),
+	output: Schema.Void,
+	services: [Database.Service]
+});
+//#endregion
+//#region src/skills/memory/operations/index.ts
+var MemoryHandlers = OperationHandlerSet.lazy(() => import("./chunk-save.mjs"), () => import("./chunk-query2.mjs"), () => import("./chunk-delete.mjs"));
+//#endregion
+//#region src/skills/planning/operations/update-tasks.md?raw
+var update_tasks_default = "## PLANNING TOOL\n\nThis tool maintains an organized task list.\nUse this to track progress, break down objectives, and ensure thoroughness.\nIf you are asked to create a plan use this tool instead of creating a new document.\nAfter creating initial tasks, update them silently without announcing changes to the user.\nImportant: Do not show or summarize the contents of the task list unless the user asks for this.\n\n### CORE USAGE PRINCIPLES\n\nCreate and manage tasks for: multi-step objectives requiring 3+ distinct actions, complex projects needing careful sequencing,\nuser requests for task organization, multiple deliverables provided together, new instructions (capture as tasks immediately),\ncompleted work (mark `done` and add follow-ups), and active work (mark as `in-progress`, limit one at a time).\n\nSkip task management for: single straightforward actions, simple requests achievable in 1-2 steps,\ninformational queries, quick lookups or clarifications, and avoid creating verification tasks unless requested.\n\n### TOOL SPECIFICATION\n\n`update-tasks` requires an array of task objects. The task list is a markdown checklist; the\ntitle is the key — reuse the exact title to update an existing item, use a new title to add one.\nEach task object contains:\n\n- title (string, required): specific, actionable task description; also the update key\n- status (string, required): `todo` | `in-progress` | `done`\n\nTask status meanings: 'todo' means not yet started, `in-progress` means currently being worked on, `done` means completed successfully (rendered as a checked item).\n\n### OPERATIONAL GUIDELINES\n\nUpdate tasks in realtime as work progresses. Mark tasks `done` immediately upon completion.\nMaintain only ONE task with `in-progress` status at a time. Complete current tasks before starting new ones.\nUse specific, actionable task titles. Break complex work into manageable logical pieces.\nBatch task updates with other actions when possible for efficiency.\n\n### USAGE EXAMPLES\n\n<example type=\"research_project\">\n<user_message>I need to research sustainable packaging options and write a report comparing costs and environmental impact.</user_message>\n<assistant_action>\nCreates tasks:\n1. {title: \"Research sustainable packaging materials\", status: \"in-progress\"}\n2. {title: \"Compile cost comparison data\", status: \"todo\"}\n3. {title: \"Evaluate environmental impact metrics\", status: \"todo\"}\n4. {title: \"Write comparative analysis report\", status: \"todo\"}\n\nBegins research work immediately in same response.\n</assistant_action>\n<reasoning>Multi-phase project requiring systematic tracking across research, analysis, and writing stages.</reasoning>\n</example>\n\n<example type=\"event_planning\">\n<user_message>Help me plan a team retreat - venue, agenda, catering, and send invitations.</user_message>\n<assistant_action>\nCreates tasks:\n1. {title: \"Research and recommend venues\", status: \"in-progress\"}\n2. {title: \"Create retreat agenda\", status: \"todo\"}\n3. {title: \"Coordinate catering options\", status: \"todo\"}\n4. {title: \"Draft and send invitations\", status: \"todo\"}\n</assistant_action>\n<reasoning>Multiple distinct deliverables with dependencies requiring organized tracking.</reasoning>\n</example>\n\n<example type=\"document_analysis\">\n<user_message>Review this 30-page contract for key terms, risks, and negotiation points.</user_message>\n<assistant_action>\nCreates tasks:\n1. {title: \"Identify key contractual terms\", status: \"in-progress\"}\n2. {title: \"Flag potential risks and liabilities\", status: \"todo\"}\n3. {title: \"Compile negotiation recommendations\", status: \"todo\"}\n4. {title: \"Prepare executive summary\", status: \"todo\"}\n</assistant_action>\n<reasoning>Substantial analysis work requiring methodical breakdown and systematic review.</reasoning>\n</example>\n\n<example type=\"multiple_deliverables\">\n<user_message>I need: 1) competitor analysis for three companies, 2) SWOT analysis, 3) market positioning recommendations.</user_message>\n<assistant_action>\nCreates tasks:\n1. {title: \"Research three competitor companies\", status: \"in-progress\"}\n2. {title: \"Develop SWOT analysis\", status: \"todo\"}\n3. {title: \"Create market positioning recommendations\", status: \"todo\"}\n</assistant_action>\n<reasoning>User provided numbered list of distinct deliverables requiring separate effort.</reasoning>\n</example>\n\n<example type=\"skip_simple_question\">\n<user_message>What's the difference between renewable and sustainable energy?</user_message>\n<assistant_action>Provides explanation directly without creating tasks.</assistant_action>\n<reasoning>Informational request with no actionable work to complete or track.</reasoning>\n</example>\n\n<example type=\"skip_quick_lookup\">\n<user_message>Find the population of Tokyo.</user_message>\n<assistant_action>Searches and provides answer without task tracking.</assistant_action>\n<reasoning>Single straightforward lookup completable immediately.</reasoning>\n</example>\n\n<example type=\"skip_trivial_task\">\n<user_message>Summarize this 2-paragraph email.</user_message>\n<assistant_action>Provides summary directly without creating tasks.</assistant_action>\n<reasoning>Single simple action requiring no breakdown or progress tracking.</reasoning>\n</example>\n\n<example type=\"skip_single_action\">\n<user_message>Check if my flight is on time.</user_message>\n<assistant_action>Performs lookup and reports status without task management.</assistant_action>\n<reasoning>One-step action with immediate completion, no organizational benefit from tasks.</reasoning>\n</example>\n\n### BEST PRACTICES\n\nFor task creation: use specific stable titles (they are the update key), start first task as `in-progress`, batch initial creation with beginning work.\nFor progress tracking: update status immediately upon completion, keep only one `in-progress` task unless parallel work is natural, add follow-up tasks as they emerge. For task breakdown: aim for reasonably-scoped tasks, group related small actions into logical units, split tasks requiring different approaches.\n\nWhen uncertain whether to use task management, err on the side of creating tasks.\nProactive organization demonstrates thoroughness and ensures comprehensive work completion.\n";
+//#endregion
+//#region src/skills/planning/operations/definitions.ts
+var definitions_exports = /* @__PURE__ */ __exportAll({
+	PlanReminder: () => PlanReminder,
+	UpdateTasks: () => UpdateTasks
+});
+/**
+* LLM-facing checklist entry: items are addressed by title (the checklist is markdown — see
+* `Outline.upsertChecklistItems`); `in-progress` renders unchecked, nuance lives in conversation.
+*/
+var ChecklistTask = Schema.Struct({
+	title: Schema.String.annotations({ description: "Task title; also the key for updates." }),
+	status: Schema.Literal("todo", "in-progress", "done")
+});
+var UpdateTasks = Operation.make({
+	meta: {
+		key: DXN$1.make("org.dxos.function.planning.updateTasks"),
+		name: "Update tasks",
+		description: update_tasks_default,
+		icon: "ph--check-square-offset--regular"
+	},
+	input: Schema.Struct({ tasks: Schema.Array(ChecklistTask) }),
+	output: Schema.Any,
+	services: [Harness.HarnessService, Database.Service]
+});
+var PlanReminder = Operation.make({
+	meta: {
+		key: DXN$1.make("org.dxos.function.planning.planReminder"),
+		name: "Plan reminder",
+		description: "Reminds the agent to continue when its plan still has incomplete tasks."
+	},
+	input: Schema.Struct({}),
+	output: Schema.Void,
+	services: [
+		Harness.HarnessService,
+		Database.Service,
+		AiService.AiService
+	]
+});
+//#endregion
+//#region src/skills/planning/operations/index.ts
+var PlanningHandlers = OperationHandlerSet.lazy(() => import("./chunk-update-tasks.mjs"), () => import("./chunk-plan-reminder.mjs"));
+//#endregion
+//#region src/operations/definitions.ts
+var RunInstructions = Operation.make({
+	meta: {
+		key: DXN$1.make("org.dxos.function.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.annotations({ 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)),
+		/**
+		* @default dxn:com.anthropic.model.claude-opus-4-8.default
+		*/
+		model: Schema.optional(DXN$1.Schema),
+		systemInstructions: Schema.optional(Schema.String).annotations({ description: "Additional system instructions to add to the system prompt." })
+	}),
+	output: Schema.Any,
+	types: [
+		Instructions.Instructions,
+		Text.Text,
+		Feed.Feed,
+		Chat
+	],
+	services: [
+		AiService.AiService,
+		Database.Service,
+		OpaqueToolkit.OpaqueToolkitProvider,
+		Registry.Service,
+		Trace.TraceService
+	]
+});
+//#endregion
+//#region src/operations/index.ts
+var AgentHandlers = OperationHandlerSet.lazy(() => import("./chunk-run-instructions.mjs"));
+//#endregion
+export { SkillManagerHandlers as A, CreateAgent as B, RelationCreate as C, TagAdd as D, SchemaList as E, GetCurrentDate as F, Relay as G, definitions_exports$5 as H, SetAlarm as I, definitions_exports$6 as K, definitions_exports$4 as L, QuerySkills as M, definitions_exports$3 as N, TagRemove as O, AlarmHandlers as P, AgentWizardHandlers as R, Query$1 as S, SchemaAdd as T, AgentSkillHandlers as U, SyncAutomation as V, GetContext as W, ContextRemove as _, UpdateTasks as a, ObjectDelete as b, DeleteMemory as c, definitions_exports$1 as d, DelegationHandlers as f, ContextAdd as g, DatabaseHandlers as h, PlanReminder as i, EnableSkills as j, definitions_exports$2 as k, QueryMemories as l, delegate_task_exports as m, RunInstructions as n, definitions_exports as o, DelegateTask as p, PlanningHandlers as r, MemoryHandlers as s, AgentHandlers as t, SaveMemory as u, Load as v, RelationDelete as w, ObjectUpdate as x, ObjectCreate as y, AgentRules as z };
+
+//# sourceMappingURL=chunk-operations.mjs.map