@dxos/assistant-toolkit 0.16.0 → 0.17.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (215) hide show
  1. package/dist/lib/chunk-AgentOperation.mjs +5 -1
  2. package/dist/lib/chunk-AgentOperation.mjs.map +1 -1
  3. package/dist/lib/chunk-AgentOperationHandlerSet.mjs +1 -1
  4. package/dist/lib/chunk-AgentSkill.mjs +1 -1
  5. package/dist/lib/chunk-AlarmSkill.mjs +1 -1
  6. package/dist/lib/chunk-BrowserSkill.mjs +4 -6
  7. package/dist/lib/chunk-BrowserSkill.mjs.map +1 -1
  8. package/dist/lib/chunk-ChatContextSkill.mjs +1 -1
  9. package/dist/lib/chunk-DelegationSkill.mjs +2 -2
  10. package/dist/lib/chunk-DelegationSkill.mjs.map +1 -1
  11. package/dist/lib/chunk-DelegationStrategy.mjs +16 -30
  12. package/dist/lib/chunk-DelegationStrategy.mjs.map +1 -1
  13. package/dist/lib/chunk-PlanningSkill.mjs +12 -10
  14. package/dist/lib/chunk-PlanningSkill.mjs.map +1 -1
  15. package/dist/lib/chunk-SkillManagerSkill.mjs +62 -7
  16. package/dist/lib/chunk-SkillManagerSkill.mjs.map +1 -1
  17. package/dist/lib/chunk-SlashCommand.mjs +2 -2
  18. package/dist/lib/chunk-SlashCommand.mjs.map +1 -1
  19. package/dist/lib/chunk-add-mcp-connection.mjs +58 -0
  20. package/dist/lib/chunk-add-mcp-connection.mjs.map +1 -0
  21. package/dist/lib/chunk-ask-question.mjs.map +1 -1
  22. package/dist/lib/chunk-catalog.mjs +86 -0
  23. package/dist/lib/chunk-catalog.mjs.map +1 -0
  24. package/dist/lib/chunk-context-add.mjs +1 -1
  25. package/dist/lib/chunk-context-remove.mjs +1 -1
  26. package/dist/lib/chunk-delegate-task.mjs +2 -2
  27. package/dist/lib/chunk-delegate-task.mjs.map +1 -1
  28. package/dist/lib/chunk-delegate-tasks.mjs +2 -8
  29. package/dist/lib/chunk-delegate-tasks.mjs.map +1 -1
  30. package/dist/lib/chunk-enable-skills.mjs +1 -1
  31. package/dist/lib/chunk-get-context.mjs +1 -1
  32. package/dist/lib/chunk-get-current-date.mjs +1 -1
  33. package/dist/lib/chunk-mcp-connections.mjs +26 -0
  34. package/dist/lib/chunk-mcp-connections.mjs.map +1 -0
  35. package/dist/lib/chunk-operations.mjs +2 -2
  36. package/dist/lib/chunk-operations.mjs.map +1 -1
  37. package/dist/lib/chunk-operations2.mjs +144 -9
  38. package/dist/lib/chunk-operations2.mjs.map +1 -1
  39. package/dist/lib/chunk-operations3.mjs +6 -5
  40. package/dist/lib/chunk-operations3.mjs.map +1 -1
  41. package/dist/lib/chunk-operations4.mjs +30 -55
  42. package/dist/lib/chunk-operations4.mjs.map +1 -1
  43. package/dist/lib/chunk-operations5.mjs +28 -27
  44. package/dist/lib/chunk-operations5.mjs.map +1 -1
  45. package/dist/lib/chunk-operations6.mjs +64 -29
  46. package/dist/lib/chunk-operations6.mjs.map +1 -1
  47. package/dist/lib/chunk-operations7.mjs +4 -79
  48. package/dist/lib/chunk-operations7.mjs.map +1 -1
  49. package/dist/lib/chunk-plan-reminder.mjs +7 -12
  50. package/dist/lib/chunk-plan-reminder.mjs.map +1 -1
  51. package/dist/lib/chunk-query-mcp-connections.mjs +16 -0
  52. package/dist/lib/chunk-query-mcp-connections.mjs.map +1 -0
  53. package/dist/lib/chunk-query-operations.mjs +23 -0
  54. package/dist/lib/chunk-query-operations.mjs.map +1 -0
  55. package/dist/lib/chunk-query-skills.mjs +23 -3
  56. package/dist/lib/chunk-query-skills.mjs.map +1 -1
  57. package/dist/lib/chunk-query-types.mjs +24 -0
  58. package/dist/lib/chunk-query-types.mjs.map +1 -0
  59. package/dist/lib/chunk-relay.mjs +1 -1
  60. package/dist/lib/chunk-run-instructions.mjs +14 -10
  61. package/dist/lib/chunk-run-instructions.mjs.map +1 -1
  62. package/dist/lib/chunk-set-alarm.mjs +1 -1
  63. package/dist/lib/chunk-set-mcp-connection.mjs +18 -0
  64. package/dist/lib/chunk-set-mcp-connection.mjs.map +1 -0
  65. package/dist/lib/chunk-sync-automation.mjs +1 -1
  66. package/dist/lib/chunk-update-tasks.mjs +20 -3
  67. package/dist/lib/chunk-update-tasks.mjs.map +1 -1
  68. package/dist/lib/index.mjs +1 -3
  69. package/dist/lib/ns/AgentOperationHandlerSet.mjs +1 -1
  70. package/dist/lib/ns/AgentSkill.mjs +1 -1
  71. package/dist/lib/ns/AlarmSkill.mjs +1 -1
  72. package/dist/lib/ns/ChatContextSkill.mjs +1 -1
  73. package/dist/lib/ns/PlanningSkill.mjs +2 -2
  74. package/dist/lib/ns/SkillManagerSkill.mjs +3 -3
  75. package/dist/lib/testing.mjs +7 -10
  76. package/dist/lib/testing.mjs.map +1 -1
  77. package/dist/types/src/commands.d.ts +10 -0
  78. package/dist/types/src/commands.d.ts.map +1 -1
  79. package/dist/types/src/operations/run-instructions.d.ts.map +1 -1
  80. package/dist/types/src/skills/browser/BrowserSkill.d.ts.map +1 -1
  81. package/dist/types/src/skills/delegation/operations/delegate-task.d.ts +1 -1
  82. package/dist/types/src/skills/delegation/operations/delegate-tasks.d.ts +0 -6
  83. package/dist/types/src/skills/delegation/operations/delegate-tasks.d.ts.map +1 -1
  84. package/dist/types/src/skills/index.d.ts +0 -1
  85. package/dist/types/src/skills/index.d.ts.map +1 -1
  86. package/dist/types/src/skills/planning/PlanningSkill.d.ts +3 -0
  87. package/dist/types/src/skills/planning/PlanningSkill.d.ts.map +1 -1
  88. package/dist/types/src/skills/planning/operations/definitions.d.ts +3 -1
  89. package/dist/types/src/skills/planning/operations/definitions.d.ts.map +1 -1
  90. package/dist/types/src/skills/planning/operations/plan-reminder.d.ts +6 -5
  91. package/dist/types/src/skills/planning/operations/plan-reminder.d.ts.map +1 -1
  92. package/dist/types/src/skills/planning/operations/update-tasks.d.ts +1 -1
  93. package/dist/types/src/skills/planning/operations/update-tasks.d.ts.map +1 -1
  94. package/dist/types/src/skills/skill-manager/SkillManagerSkill.d.ts +7 -0
  95. package/dist/types/src/skills/skill-manager/SkillManagerSkill.d.ts.map +1 -1
  96. package/dist/types/src/skills/skill-manager/lookup.test.d.ts +2 -0
  97. package/dist/types/src/skills/skill-manager/lookup.test.d.ts.map +1 -0
  98. package/dist/types/src/skills/skill-manager/operations/add-mcp-connection.d.ts +19 -0
  99. package/dist/types/src/skills/skill-manager/operations/add-mcp-connection.d.ts.map +1 -0
  100. package/dist/types/src/skills/skill-manager/operations/catalog.d.ts +36 -0
  101. package/dist/types/src/skills/skill-manager/operations/catalog.d.ts.map +1 -0
  102. package/dist/types/src/skills/skill-manager/operations/definitions.d.ts +116 -1
  103. package/dist/types/src/skills/skill-manager/operations/definitions.d.ts.map +1 -1
  104. package/dist/types/src/skills/skill-manager/operations/index.d.ts.map +1 -1
  105. package/dist/types/src/skills/skill-manager/operations/mcp-connections.d.ts +15 -0
  106. package/dist/types/src/skills/skill-manager/operations/mcp-connections.d.ts.map +1 -0
  107. package/dist/types/src/skills/skill-manager/operations/query-mcp-connections.d.ts +11 -0
  108. package/dist/types/src/skills/skill-manager/operations/query-mcp-connections.d.ts.map +1 -0
  109. package/dist/types/src/skills/skill-manager/operations/query-operations.d.ts +17 -0
  110. package/dist/types/src/skills/skill-manager/operations/query-operations.d.ts.map +1 -0
  111. package/dist/types/src/skills/skill-manager/operations/query-skills.d.ts +20 -2
  112. package/dist/types/src/skills/skill-manager/operations/query-skills.d.ts.map +1 -1
  113. package/dist/types/src/skills/skill-manager/operations/query-types.d.ts +13 -0
  114. package/dist/types/src/skills/skill-manager/operations/query-types.d.ts.map +1 -0
  115. package/dist/types/src/skills/skill-manager/operations/set-mcp-connection.d.ts +14 -0
  116. package/dist/types/src/skills/skill-manager/operations/set-mcp-connection.d.ts.map +1 -0
  117. package/dist/types/src/supervisor/delegation-strategy.d.ts +2 -7
  118. package/dist/types/src/supervisor/delegation-strategy.d.ts.map +1 -1
  119. package/dist/types/src/testing/operations.d.ts.map +1 -1
  120. package/dist/types/src/types/AgentOperation.d.ts +2 -1
  121. package/dist/types/src/types/AgentOperation.d.ts.map +1 -1
  122. package/dist/types/src/types/index.d.ts +0 -1
  123. package/dist/types/src/types/index.d.ts.map +1 -1
  124. package/dist/types/tsconfig.tsbuildinfo +1 -1
  125. package/package.json +32 -40
  126. package/src/commands.test.ts +4 -0
  127. package/src/commands.ts +12 -2
  128. package/src/operations/run-instructions.test.ts +12 -6
  129. package/src/operations/run-instructions.ts +12 -2
  130. package/src/skills/browser/BrowserSkill.ts +3 -8
  131. package/src/skills/chat-context/operations/context-add.test.ts +6 -4
  132. package/src/skills/chat-context/operations/context-remove.test.ts +6 -4
  133. package/src/skills/delegation/DelegationSkill.ts +2 -2
  134. package/src/skills/delegation/operations/definitions.ts +2 -2
  135. package/src/skills/delegation/operations/delegate-task.test.ts +1 -2
  136. package/src/skills/delegation/operations/delegate-task.ts +2 -2
  137. package/src/skills/delegation/operations/delegate-tasks.ts +2 -8
  138. package/src/skills/index.ts +0 -1
  139. package/src/skills/planning/PlanningSkill.ts +8 -12
  140. package/src/skills/planning/operations/definitions.ts +5 -4
  141. package/src/skills/planning/operations/plan-reminder.test.ts +9 -15
  142. package/src/skills/planning/operations/plan-reminder.ts +7 -13
  143. package/src/skills/planning/operations/update-tasks.md +7 -5
  144. package/src/skills/planning/operations/update-tasks.model.test.ts +2 -2
  145. package/src/skills/planning/operations/update-tasks.test.ts +110 -10
  146. package/src/skills/planning/operations/update-tasks.ts +22 -10
  147. package/src/skills/planning/skill.test.ts +9 -7
  148. package/src/skills/skill-manager/SkillManagerSkill.ts +71 -5
  149. package/src/skills/skill-manager/lookup.test.ts +308 -0
  150. package/src/skills/skill-manager/operations/add-mcp-connection.ts +83 -0
  151. package/src/skills/skill-manager/operations/catalog.ts +140 -0
  152. package/src/skills/skill-manager/operations/definitions.ts +168 -6
  153. package/src/skills/skill-manager/operations/index.ts +14 -1
  154. package/src/skills/skill-manager/operations/mcp-connections.ts +29 -0
  155. package/src/skills/skill-manager/operations/query-mcp-connections.ts +22 -0
  156. package/src/skills/skill-manager/operations/query-operations.ts +50 -0
  157. package/src/skills/skill-manager/operations/query-skills.ts +43 -3
  158. package/src/skills/skill-manager/operations/query-types.ts +32 -0
  159. package/src/skills/skill-manager/operations/set-mcp-connection.ts +28 -0
  160. package/src/skills/skill-manager/skill.test.ts +172 -9
  161. package/src/supervisor/delegation-strategy.test.ts +55 -4
  162. package/src/supervisor/delegation-strategy.ts +13 -28
  163. package/src/testing/operations.ts +2 -6
  164. package/src/types/AgentOperation.ts +6 -1
  165. package/src/types/index.ts +0 -1
  166. package/dist/lib/Memory.mjs +0 -1
  167. package/dist/lib/chunk-Memory.mjs +0 -19
  168. package/dist/lib/chunk-Memory.mjs.map +0 -1
  169. package/dist/lib/chunk-MemorySkill.mjs +0 -39
  170. package/dist/lib/chunk-MemorySkill.mjs.map +0 -1
  171. package/dist/lib/chunk-delete.mjs +0 -14
  172. package/dist/lib/chunk-delete.mjs.map +0 -1
  173. package/dist/lib/chunk-operations8.mjs +0 -9
  174. package/dist/lib/chunk-operations8.mjs.map +0 -1
  175. package/dist/lib/chunk-query.mjs +0 -18
  176. package/dist/lib/chunk-query.mjs.map +0 -1
  177. package/dist/lib/chunk-save.mjs +0 -17
  178. package/dist/lib/chunk-save.mjs.map +0 -1
  179. package/dist/lib/ns/MemorySkill.mjs +0 -3
  180. package/dist/types/src/skills/memory/MemorySkill.d.ts +0 -6
  181. package/dist/types/src/skills/memory/MemorySkill.d.ts.map +0 -1
  182. package/dist/types/src/skills/memory/index.d.ts +0 -2
  183. package/dist/types/src/skills/memory/index.d.ts.map +0 -1
  184. package/dist/types/src/skills/memory/operations/definitions.d.ts +0 -15
  185. package/dist/types/src/skills/memory/operations/definitions.d.ts.map +0 -1
  186. package/dist/types/src/skills/memory/operations/delete.d.ts +0 -7
  187. package/dist/types/src/skills/memory/operations/delete.d.ts.map +0 -1
  188. package/dist/types/src/skills/memory/operations/delete.test.d.ts +0 -2
  189. package/dist/types/src/skills/memory/operations/delete.test.d.ts.map +0 -1
  190. package/dist/types/src/skills/memory/operations/index.d.ts +0 -4
  191. package/dist/types/src/skills/memory/operations/index.d.ts.map +0 -1
  192. package/dist/types/src/skills/memory/operations/query.d.ts +0 -8
  193. package/dist/types/src/skills/memory/operations/query.d.ts.map +0 -1
  194. package/dist/types/src/skills/memory/operations/query.test.d.ts +0 -2
  195. package/dist/types/src/skills/memory/operations/query.test.d.ts.map +0 -1
  196. package/dist/types/src/skills/memory/operations/save.d.ts +0 -8
  197. package/dist/types/src/skills/memory/operations/save.d.ts.map +0 -1
  198. package/dist/types/src/skills/memory/operations/save.test.d.ts +0 -2
  199. package/dist/types/src/skills/memory/operations/save.test.d.ts.map +0 -1
  200. package/dist/types/src/skills/memory/skill.test.d.ts +0 -2
  201. package/dist/types/src/skills/memory/skill.test.d.ts.map +0 -1
  202. package/dist/types/src/types/Memory.d.ts +0 -12
  203. package/dist/types/src/types/Memory.d.ts.map +0 -1
  204. package/src/skills/memory/MemorySkill.ts +0 -39
  205. package/src/skills/memory/index.ts +0 -5
  206. package/src/skills/memory/operations/definitions.ts +0 -72
  207. package/src/skills/memory/operations/delete.test.ts +0 -37
  208. package/src/skills/memory/operations/delete.ts +0 -20
  209. package/src/skills/memory/operations/index.ts +0 -16
  210. package/src/skills/memory/operations/query.test.ts +0 -76
  211. package/src/skills/memory/operations/query.ts +0 -32
  212. package/src/skills/memory/operations/save.test.ts +0 -43
  213. package/src/skills/memory/operations/save.ts +0 -20
  214. package/src/skills/memory/skill.test.ts +0 -147
  215. package/src/types/Memory.ts +0 -22
@@ -1 +1 @@
1
- {"version":3,"file":"chunk-operations2.mjs","names":["DXN"],"sources":["../../src/skills/skill-manager/operations/definitions.ts","../../src/skills/skill-manager/operations/index.ts"],"sourcesContent":["//\n// Copyright 2026 DXOS.org\n//\n\nimport * as Schema from 'effect/Schema';\n\nimport { Harness } from '@dxos/assistant';\nimport * as Operation from '@dxos/compute/Operation';\nimport * as Skill from '@dxos/compute/Skill';\nimport { Database, Registry, Type } from '@dxos/echo';\nimport { DXN } from '@dxos/keys';\n\nexport const QuerySkills = Operation.make({\n meta: {\n key: DXN.make('org.dxos.operation.assistantToolkit.querySkills'),\n name: 'Query skills',\n description: 'Queries available skills.',\n icon: 'ph--student--regular',\n },\n input: Schema.Struct({}),\n output: Schema.Array(Type.getSchema(Skill.Skill)),\n services: [Registry.Service],\n});\n\nexport const EnableSkills = Operation.make({\n meta: {\n key: DXN.make('org.dxos.operation.assistantToolkit.enableSkills'),\n name: 'Enable skills',\n description:\n '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.',\n icon: 'ph--plugs-connected--regular',\n },\n input: Schema.Struct({\n keys: Schema.Array(Schema.String).annotate({\n description: 'The keys of the skills to enable.',\n examples: [['org.dxos.skill.memory', 'org.dxos.skill.database']],\n }),\n }),\n output: Schema.Struct({\n enabled: Schema.Array(Type.getSchema(Skill.Skill)),\n rejected: Schema.Array(\n Schema.Struct({\n key: Schema.String,\n reason: Schema.String,\n }),\n ),\n }),\n services: [Registry.Service, Database.Service, Harness.HarnessService],\n});\n","//\n// Copyright 2026 DXOS.org\n//\n\nimport * as Operation from '@dxos/compute/Operation';\nimport * as OperationHandlerSet from '@dxos/compute/OperationHandlerSet';\n\nimport { EnableSkills, QuerySkills } from './definitions.ts';\n\nexport * as SkillManagerOperations from './definitions.ts';\n\nexport const SkillManagerHandlers = OperationHandlerSet.lazy([\n QuerySkills.pipe(Operation.lazyHandler(() => import('./query-skills.ts'))),\n EnableSkills.pipe(Operation.lazyHandler(() => import('./enable-skills.ts'))),\n]);\n"],"mappings":";;;;;;;;;;;;;AAYA,IAAa,cAAc,UAAU,KAAK;CACxC,MAAM;EACJ,KAAKA,MAAI,KAAK,iDAAiD;EAC/D,MAAM;EACN,aAAa;EACb,MAAM;CACR;CACA,OAAO,OAAO,OAAO,CAAC,CAAC;CACvB,QAAQ,OAAO,MAAM,KAAK,UAAU,MAAM,KAAK,CAAC;CAChD,UAAU,CAAC,SAAS,OAAO;AAC7B,CAAC;AAED,IAAa,eAAe,UAAU,KAAK;CACzC,MAAM;EACJ,KAAKA,MAAI,KAAK,kDAAkD;EAChE,MAAM;EACN,aACE;EACF,MAAM;CACR;CACA,OAAO,OAAO,OAAO,EACnB,MAAM,OAAO,MAAM,OAAO,MAAM,CAAC,CAAC,SAAS;EACzC,aAAa;EACb,UAAU,CAAC,CAAC,yBAAyB,yBAAyB,CAAC;CACjE,CAAC,EACH,CAAC;CACD,QAAQ,OAAO,OAAO;EACpB,SAAS,OAAO,MAAM,KAAK,UAAU,MAAM,KAAK,CAAC;EACjD,UAAU,OAAO,MACf,OAAO,OAAO;GACZ,KAAK,OAAO;GACZ,QAAQ,OAAO;EACjB,CAAC,CACH;CACF,CAAC;CACD,UAAU;EAAC,SAAS;EAAS,SAAS;EAAS,QAAQ;CAAc;AACvE,CAAC;;;ACrCD,IAAa,uBAAuB,oBAAoB,KAAK,CAC3D,YAAY,KAAK,UAAU,kBAAkB,OAAO,2BAAoB,CAAC,GACzE,aAAa,KAAK,UAAU,kBAAkB,OAAO,4BAAqB,CAAC,CAC7E,CAAC"}
1
+ {"version":3,"file":"chunk-operations2.mjs","names":["DXN"],"sources":["../../src/skills/skill-manager/operations/definitions.ts","../../src/skills/skill-manager/operations/index.ts"],"sourcesContent":["//\n// Copyright 2026 DXOS.org\n//\n\nimport * as Schema from 'effect/Schema';\n\nimport { Harness } from '@dxos/assistant';\nimport * as Operation from '@dxos/compute/Operation';\nimport * as Skill from '@dxos/compute/Skill';\nimport { Database, Registry, Type } from '@dxos/echo';\nimport { DXN } from '@dxos/keys';\n\n/** An operation of a skill, as the lookups below describe it. */\nconst ListedOperation = Schema.Struct({\n key: Schema.String.annotate({ description: 'The operation key.' }),\n tool: Schema.String.annotate({ description: 'Its tool name.' }),\n name: Schema.optional(Schema.String),\n description: Schema.optional(Schema.String),\n skill: Schema.String.annotate({ description: 'Key of the skill that provides it.' }),\n enabled: Schema.Boolean.annotate({\n description: 'Whether its skill is enabled in this conversation, so it can be used now.',\n }),\n input: Schema.optional(Schema.String).annotate({\n description: 'Its input, e.g. `{ title: string, owner?: Ref<org.dxos.type.person> }`; given when looked up by key.',\n }),\n});\n\nexport interface ListedOperation extends Schema.Schema.Type<typeof ListedOperation> {}\n\n/** A skill, as `query-skills` describes it. */\nconst ListedSkill = Schema.Struct({\n key: Schema.String,\n name: Schema.String,\n description: Schema.optional(Schema.String),\n enabled: Schema.Boolean.annotate({ description: 'Whether the skill is enabled in this conversation.' }),\n agentCanEnable: Schema.Boolean.annotate({ description: 'Whether `enable-skills` may enable it.' }),\n instructions: Schema.optional(Schema.String).annotate({\n description: \"The skill's instructions; given when looked up by key.\",\n }),\n operations: Schema.optional(Schema.Array(ListedOperation)).annotate({\n description: 'Its operations; given when looked up by key.',\n }),\n});\n\nexport interface ListedSkill extends Schema.Schema.Type<typeof ListedSkill> {}\n\n/** A registered type, as `query-types` describes it. */\nconst ListedType = Schema.Struct({\n typename: Schema.String,\n dxn: Schema.String.annotate({ description: 'The versioned DXN the type resolves by.' }),\n kind: Schema.Literals(['object', 'relation']),\n fields: Schema.optional(Schema.String).annotate({ description: 'Its fields; given when looked up by typename.' }),\n});\n\nexport interface ListedType extends Schema.Schema.Type<typeof ListedType> {}\n\nexport const QuerySkills = Operation.make({\n meta: {\n key: DXN.make('org.dxos.operation.assistantToolkit.querySkills'),\n name: 'Query skills',\n description:\n 'Queries available skills, each saying whether it is enabled here and whether you may enable it. ' +\n 'Pass `query` to find the skill that provides a tool you lack: the words are matched against skill names, ' +\n 'descriptions and tool names, best match first. Pass `keys` to get those skills in full: their instructions ' +\n 'and operations.',\n icon: 'ph--student--regular',\n },\n input: Schema.Struct({\n query: Schema.optional(Schema.String).annotate({\n description: 'Words describing the tool or capability you need, e.g. \"link task to feature\".',\n }),\n keys: Schema.optional(Schema.Array(Schema.String)).annotate({ description: 'Skills to return in full.' }),\n }),\n output: Schema.Array(ListedSkill),\n services: [Registry.Service, Harness.HarnessService],\n});\n\nexport const QueryOperations = Operation.make({\n meta: {\n key: DXN.make('org.dxos.operation.assistantToolkit.queryOperations'),\n name: 'Query operations',\n description:\n 'Searches the operations of the skills you can use (enabled here, or ones you may enable) by what they do; ' +\n \"`skill` narrows to one skill's. Pass `keys` to get each in full, with its input.\",\n icon: 'ph--magnifying-glass--regular',\n },\n input: Schema.Struct({\n query: Schema.optional(Schema.String).annotate({ description: 'Words describing what the operation does.' }),\n skill: Schema.optional(Schema.String).annotate({ description: \"Only this skill's operations.\" }),\n keys: Schema.optional(Schema.Array(Schema.String)).annotate({ description: 'Operations to return in full.' }),\n }),\n output: Schema.Array(ListedOperation),\n services: [Registry.Service, Harness.HarnessService],\n});\n\nexport const QueryTypes = Operation.make({\n meta: {\n key: DXN.make('org.dxos.operation.assistantToolkit.queryTypes'),\n name: 'Query types',\n description: 'Searches the registered object and relation types. Pass `typenames` to get their fields.',\n icon: 'ph--shapes--regular',\n },\n input: Schema.Struct({\n query: Schema.optional(Schema.String).annotate({ description: 'Words in the type or field names.' }),\n typenames: Schema.optional(Schema.Array(Schema.String)).annotate({\n description: 'Types to return with their fields, by typename or DXN.',\n }),\n }),\n output: Schema.Array(ListedType),\n services: [Database.Service],\n});\n\nexport const EnableSkills = Operation.make({\n meta: {\n key: DXN.make('org.dxos.operation.assistantToolkit.enableSkills'),\n name: 'Enable skills',\n description:\n 'Enables skills in the current conversation by their keys, as query-skills lists them. Only skills with ' +\n 'agentCanEnable=true can be enabled.',\n icon: 'ph--plugs-connected--regular',\n },\n input: Schema.Struct({\n keys: Schema.Array(Schema.String).annotate({\n description: 'The keys of the skills to enable.',\n examples: [['org.dxos.skill.planning', 'org.dxos.skill.database']],\n }),\n }),\n output: Schema.Struct({\n enabled: Schema.Array(Type.getSchema(Skill.Skill)),\n rejected: Schema.Array(\n Schema.Struct({\n key: Schema.String,\n reason: Schema.String,\n }),\n ),\n }),\n services: [Registry.Service, Database.Service, Harness.HarnessService],\n});\n\nconst McpConnection = Schema.Struct({\n id: Schema.String.annotate({ description: \"The connection's id, or a built-in server's key.\" }),\n name: Schema.optional(Schema.String),\n connectorId: Schema.optional(Schema.String),\n enabled: Schema.Boolean.annotate({ description: 'Whether this conversation connects its MCP server.' }),\n builtin: Schema.optional(Schema.Boolean).annotate({\n description: 'A server Composer ships rather than a connection the space holds; off until turned on.',\n }),\n});\n\nexport const QueryMcpConnections = Operation.make({\n meta: {\n key: DXN.make('org.dxos.operation.assistantToolkit.queryMcpConnections'),\n name: 'Query MCP connections',\n description:\n \"Lists the MCP servers this conversation can connect and whether each is on: the space's connections, on unless the conversation turned them off, and the built-in servers Composer ships (such as Browser), off until turned on. A connection is not a skill: a skill whose tools come from one needs both.\",\n icon: 'ph--plugs-connected--regular',\n },\n input: Schema.Struct({}),\n output: Schema.Array(McpConnection),\n services: [Database.Service, Registry.Service, Harness.HarnessService],\n});\n\nexport const SetMcpConnection = Operation.make({\n meta: {\n key: DXN.make('org.dxos.operation.assistantToolkit.setMcpConnection'),\n name: 'Set MCP connection',\n description:\n \"Turns a connection's MCP server on or off for this conversation; enabling a skill does not do this. Its tools appear or disappear from your next step, so keep going in this response.\",\n icon: 'ph--plugs-connected--regular',\n },\n input: Schema.Struct({\n id: Schema.String.annotate({\n description: \"The connection's id or the built-in server's key, as the query lists it.\",\n }),\n enabled: Schema.Boolean,\n }),\n output: McpConnection,\n services: [Database.Service, Registry.Service, Harness.HarnessService],\n});\n\nexport const AddMcpConnection = Operation.make({\n meta: {\n key: DXN.make('org.dxos.operation.assistantToolkit.addMcpConnection'),\n name: 'Add MCP connection',\n description:\n \"Adds an MCP server to the space as a connection, with no credential or with an API key, or updates the connection the space already has for it. It is on in this conversation, so its tools are available from your next step. A server that needs sign-in can't be added this way: ask the user to connect it.\",\n icon: 'ph--plugs-connected--regular',\n },\n input: Schema.Struct({\n url: Schema.String.annotate({\n description: \"The server's MCP endpoint.\",\n examples: ['https://mcp.example.com/mcp'],\n }),\n name: Schema.optional(Schema.String).annotate({ description: 'Defaults to the URL host.' }),\n protocol: Schema.optional(Schema.Literals(['http', 'sse'])).annotate({\n description: 'Streamable HTTP unless the server only speaks the deprecated SSE transport.',\n }),\n key: Schema.optional(Schema.String).annotate({\n description:\n 'An API key the server takes as a Bearer token. It is stored in the space, readable by every member.',\n }),\n }),\n output: Schema.Struct({\n ...McpConnection.fields,\n tools: Schema.optional(Schema.Array(Schema.String)).annotate({ description: 'The tools the server listed.' }),\n problem: Schema.optional(Schema.String).annotate({\n description: 'Why the server could not be reached just now; the connection is still added.',\n }),\n }),\n services: [Database.Service, Harness.HarnessService],\n});\n","//\n// Copyright 2026 DXOS.org\n//\n\nimport * as Operation from '@dxos/compute/Operation';\nimport * as OperationHandlerSet from '@dxos/compute/OperationHandlerSet';\n\nimport {\n AddMcpConnection,\n EnableSkills,\n QueryMcpConnections,\n QueryOperations,\n QuerySkills,\n QueryTypes,\n SetMcpConnection,\n} from './definitions.ts';\n\nexport * as SkillManagerOperations from './definitions.ts';\n\nexport const SkillManagerHandlers = OperationHandlerSet.lazy([\n QuerySkills.pipe(Operation.lazyHandler(() => import('./query-skills.ts'))),\n QueryOperations.pipe(Operation.lazyHandler(() => import('./query-operations.ts'))),\n QueryTypes.pipe(Operation.lazyHandler(() => import('./query-types.ts'))),\n EnableSkills.pipe(Operation.lazyHandler(() => import('./enable-skills.ts'))),\n AddMcpConnection.pipe(Operation.lazyHandler(() => import('./add-mcp-connection.ts'))),\n QueryMcpConnections.pipe(Operation.lazyHandler(() => import('./query-mcp-connections.ts'))),\n SetMcpConnection.pipe(Operation.lazyHandler(() => import('./set-mcp-connection.ts'))),\n]);\n"],"mappings":"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"}
@@ -9,8 +9,9 @@ import * as Operation from "@dxos/compute/Operation";
9
9
  import * as OperationHandlerSet from "@dxos/compute/OperationHandlerSet";
10
10
  import { AiService } from "@dxos/ai";
11
11
  import * as Trace from "@dxos/compute/Trace";
12
+ import * as Hook from "@dxos/compute/Hook";
12
13
  //#region src/skills/planning/operations/update-tasks.md?raw
13
- 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 `started`, 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` takes `changes`, an array of edits applied together. Each change either names an\nexisting task by its ref, or sets `create` to make a new one — never both.\n\nEvery checklist line is followed by an indented note carrying the task's ref as a link, e.g.\n`(ref: [01ABC](echo://.../01ABC...); started)`. Pass the link's target back as a plain string —\n`task: \"echo://.../01ABC...\"` — not the label, not the whole link, and not a `{ \"/\": ... }` wrapper.\nNever copy the ordinal or the note into a title.\n\nEach change contains:\n\n- task (ref, optional): the existing task to change. Required unless `create` is set.\n- create (boolean, optional): make a new task on this checklist, assigned to you. Requires `title`.\n- title (string, optional): the new task's title, or a rename of an existing task.\n- status (string, optional): `todo` | `started` | `done`. `started` also assigns the task to you.\n- assign (boolean, optional): put an existing task on this checklist and make you its assignee.\n- unassign (boolean, optional): take a task off this checklist and clear its assignee. It is never deleted.\n\nStatus meanings: `todo` means not yet started, `started` means currently being worked on, `done` means completed successfully (rendered as a checked item).\n\nIf any change is malformed or names something that is not a task, nothing is applied and the error\nlists what to fix; resend the whole batch.\n\n### OPERATIONAL GUIDELINES\n\nUpdate tasks in realtime as work progresses. Mark tasks `done` immediately upon completion.\nMaintain only ONE task with `started` 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.\nA task that already exists — on this checklist, in a project, or as a sub-task of one you were given — is\nchanged through its ref. Only use `create` for work that has no task yet; recreating an existing task\nduplicates it.\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. {create: true, title: \"Research sustainable packaging materials\", status: \"started\"}\n2. {create: true, title: \"Compile cost comparison data\"}\n3. {create: true, title: \"Evaluate environmental impact metrics\"}\n4. {create: true, title: \"Write comparative analysis report\"}\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=\"progress_update\">\n<user_message>(The checklist shows \"1. [ ] Research sustainable packaging materials\" with ref [01AAA](echo://.../01AAA) and \"2. [ ] Compile cost comparison data\" with ref [01BBB](echo://.../01BBB).)</user_message>\n<assistant_action>\nFinishes the research and moves on:\n1. {task: \"echo://.../01AAA\", status: \"done\"}\n2. {task: \"echo://.../01BBB\", status: \"started\"}\n</assistant_action>\n<reasoning>Existing tasks are addressed by ref; starting the next one assigns it.</reasoning>\n</example>\n\n<example type=\"delegated_task\">\n<user_message>You have been assigned tasks to work on in this session. (The checklist holds a project task whose sub-tasks you read through the project; one of them has ref [01CCC](echo://.../01CCC).)</user_message>\n<assistant_action>\nStarts the existing sub-task rather than creating a copy of it:\n1. {task: \"echo://.../01CCC\", status: \"started\"}\n</assistant_action>\n<reasoning>Starting an existing task puts it on this checklist and assigns it to you; `create` would duplicate it.</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. {create: true, title: \"Research three competitor companies\", status: \"started\"}\n2. {create: true, title: \"Develop SWOT analysis\"}\n3. {create: true, title: \"Create market positioning recommendations\"}\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### BEST PRACTICES\n\nFor task creation: use specific titles, start the first task as `started`, batch initial creation with beginning work.\nFor progress tracking: update status immediately upon completion, keep only one `started` 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";
14
+ 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 `started`, 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` takes `changes`, an array of edits applied together. Each change either names an\nexisting task by its ref, or sets `create` to make a new one — never both.\n\nEvery checklist line is followed by an indented note carrying the task's ref as a link, e.g.\n`(ref: [01ABC](echo://.../01ABC...); started)`. Pass the link's target back as a plain string —\n`task: \"echo://.../01ABC...\"` — not the label, not the whole link, and not a `{ \"/\": ... }` wrapper.\nNever copy the ordinal or the note into a title.\n\nEach change contains:\n\n- task (ref, optional): the existing task to change. Required unless `create` is set.\n- create (boolean, optional): make a new task on this checklist, assigned to you. Requires `title`.\n- title (string, optional): the new task's title, or a rename of an existing task.\n- status (string, optional): `todo` | `started` | `done`. `started` also makes you the agent working the task.\n- assign (boolean, optional): put an existing task on this checklist with you working it.\n- unassign (boolean, optional): take a task off this checklist and stop working it. It is never deleted.\n\nStatus meanings: `todo` means not yet started, `started` means currently being worked on, `done` means completed successfully (rendered as a checked item).\nA person who answers for a task stays its assignee while you work it. When you mark it `done` it goes to\nthem for review, and they close it.\n\nIf any change is malformed or names something that is not a task, nothing is applied and the error\nlists what to fix; resend the whole batch.\n\n### OPERATIONAL GUIDELINES\n\nUpdate tasks in realtime as work progresses. Mark tasks `done` immediately upon completion.\nMaintain only ONE task with `started` 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.\nA task that already exists — on this checklist, in a project, or as a sub-task of one you were given — is\nchanged through its ref. Only use `create` for work that has no task yet; recreating an existing task\nduplicates it.\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. {create: true, title: \"Research sustainable packaging materials\", status: \"started\"}\n2. {create: true, title: \"Compile cost comparison data\"}\n3. {create: true, title: \"Evaluate environmental impact metrics\"}\n4. {create: true, title: \"Write comparative analysis report\"}\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=\"progress_update\">\n<user_message>(The checklist shows \"1. [ ] Research sustainable packaging materials\" with ref [01AAA](echo://.../01AAA) and \"2. [ ] Compile cost comparison data\" with ref [01BBB](echo://.../01BBB).)</user_message>\n<assistant_action>\nFinishes the research and moves on:\n1. {task: \"echo://.../01AAA\", status: \"done\"}\n2. {task: \"echo://.../01BBB\", status: \"started\"}\n</assistant_action>\n<reasoning>Existing tasks are addressed by ref; starting the next one makes you the agent working it.</reasoning>\n</example>\n\n<example type=\"delegated_task\">\n<user_message>You have been assigned tasks to work on in this session. (The checklist holds a project task whose sub-tasks you read through the project; one of them has ref [01CCC](echo://.../01CCC).)</user_message>\n<assistant_action>\nStarts the existing sub-task rather than creating a copy of it:\n1. {task: \"echo://.../01CCC\", status: \"started\"}\n</assistant_action>\n<reasoning>Starting an existing task puts it on this checklist with you working it; `create` would duplicate it.</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. {create: true, title: \"Research three competitor companies\", status: \"started\"}\n2. {create: true, title: \"Develop SWOT analysis\"}\n3. {create: true, title: \"Create market positioning recommendations\"}\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### BEST PRACTICES\n\nFor task creation: use specific titles, start the first task as `started`, batch initial creation with beginning work.\nFor progress tracking: update status immediately upon completion, keep only one `started` 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";
14
15
  //#endregion
15
16
  //#region src/skills/planning/operations/definitions.ts
16
17
  var definitions_exports = /* @__PURE__ */ __exportAll({
@@ -25,14 +26,14 @@ var definitions_exports = /* @__PURE__ */ __exportAll({
25
26
  var TaskChange = Schema.Struct({
26
27
  task: Ref.Ref(Task.Task).annotate({ description: "The existing task to change: the `echo://` URI inside the link on its checklist line, as a plain string. Omit with `create`." }).pipe(Schema.optional),
27
28
  create: Schema.Boolean.annotate({ description: "Create a new task on this checklist, assigned to you. Requires `title`; omit `task`." }).pipe(Schema.optional),
28
- assign: Schema.Boolean.annotate({ description: "Put the task on this checklist and make you its assignee." }).pipe(Schema.optional),
29
- unassign: Schema.Boolean.annotate({ description: "Take the task off this checklist and clear its assignee. Never deletes the task." }).pipe(Schema.optional),
29
+ assign: Schema.Boolean.annotate({ description: "Put the task on this checklist with you working it. A person who answers for it stays its assignee." }).pipe(Schema.optional),
30
+ unassign: Schema.Boolean.annotate({ description: "Take the task off this checklist and stop working it. Never deletes the task." }).pipe(Schema.optional),
30
31
  title: Schema.String.annotate({ description: "The new task title, or a rename of an existing task." }).pipe(Schema.optional),
31
32
  status: Schema.Literals([
32
33
  "todo",
33
34
  "started",
34
35
  "done"
35
- ]).annotate({ description: "`started` also assigns the task to you." }).pipe(Schema.optional)
36
+ ]).annotate({ description: "`started` also makes you the agent working it." }).pipe(Schema.optional)
36
37
  });
37
38
  var UpdateTasks = Operation.make({
38
39
  meta: {
@@ -91,7 +92,7 @@ var PlanReminder = Operation.make({
91
92
  description: "Reminds the agent to continue when its plan still has incomplete tasks."
92
93
  },
93
94
  input: Schema.Struct({}),
94
- output: Schema.Void,
95
+ output: Hook.Output,
95
96
  services: [
96
97
  Harness.HarnessService,
97
98
  Database.Service,
@@ -1 +1 @@
1
- {"version":3,"file":"chunk-operations3.mjs","names":["DXN","INSTRUCTIONS"],"sources":["../../src/skills/planning/operations/definitions.ts","../../src/skills/planning/operations/index.ts"],"sourcesContent":["//\n// Copyright 2026 DXOS.org\n//\n\nimport * as Schema from 'effect/Schema';\n\nimport { AiService } from '@dxos/ai';\nimport { Harness } from '@dxos/assistant';\nimport * as Operation from '@dxos/compute/Operation';\nimport * as Trace from '@dxos/compute/Trace';\nimport { Database, Ref } from '@dxos/echo';\nimport { DXN } from '@dxos/keys';\nimport { Task } from '@dxos/types';\nimport { trim } from '@dxos/util';\n\nimport INSTRUCTIONS from './update-tasks.md?raw';\n\n/**\n * One edit to the conversation's tasks. Flat rather than a union of create/update shapes: a union\n * renders as `anyOf`, which some providers handle poorly, so the handler enforces the combinations.\n */\nconst TaskChange = Schema.Struct({\n task: Ref.Ref(Task.Task)\n .annotate({\n description:\n 'The existing task to change: the `echo://` URI inside the link on its checklist line, as a plain string. Omit with `create`.',\n })\n .pipe(Schema.optional),\n create: Schema.Boolean.annotate({\n description: 'Create a new task on this checklist, assigned to you. Requires `title`; omit `task`.',\n }).pipe(Schema.optional),\n assign: Schema.Boolean.annotate({\n description: 'Put the task on this checklist and make you its assignee.',\n }).pipe(Schema.optional),\n unassign: Schema.Boolean.annotate({\n description: 'Take the task off this checklist and clear its assignee. Never deletes the task.',\n }).pipe(Schema.optional),\n title: Schema.String.annotate({ description: 'The new task title, or a rename of an existing task.' }).pipe(\n Schema.optional,\n ),\n status: Schema.Literals(['todo', 'started', 'done'])\n .annotate({ description: '`started` also assigns the task to you.' })\n .pipe(Schema.optional),\n});\n\nexport type TaskChange = Schema.Schema.Type<typeof TaskChange>;\n\nexport const UpdateTasks = Operation.make({\n meta: {\n key: DXN.make('org.dxos.operation.assistantToolkit.updateTasks'),\n name: 'Update tasks',\n description: INSTRUCTIONS,\n icon: 'ph--check-square-offset--regular',\n },\n input: Schema.Struct({\n changes: Schema.Array(TaskChange),\n }),\n output: Schema.Any,\n services: [Harness.HarnessService, Database.Service, Trace.TraceService],\n});\n\nexport const AskQuestion = Operation.make({\n meta: {\n key: DXN.make('org.dxos.operation.assistantToolkit.askQuestion'),\n name: 'Ask question',\n icon: 'ph--question--regular',\n description: trim`\n Ask the user a question you cannot answer yourself, and stop that task on it.\n Prefer asking to guessing: an assumption the checklist then carries as fact costs more than\n the round trip does.\n Every question is about one task on the checklist, named by its exact title: the task is put in\n 'blocked' and the question filed on it, so the person answering can see what it holds up.\n Offer the likely answers in \"options\" when you have them — the reader may still type their own,\n so never phrase the question as if the list were exhaustive.\n Ask only what you genuinely cannot decide: a question costs the user a round trip, and a\n blocked task stays blocked until they take it.\n You are not resumed by waiting: finish this turn after asking. When the answer lands you are\n sent a message naming the question, and you read it back with the get-objects tool.\n `,\n },\n input: Schema.Struct({\n task: Schema.String.annotate({\n description: 'Exact title of the checklist task this question blocks.',\n }),\n question: Schema.String.annotate({ description: 'The question, as put to the user.' }),\n context: Schema.optional(\n Schema.String.annotate({ description: 'Why you are asking — what you are blocked on, in a sentence or two.' }),\n ),\n options: Schema.optional(\n Schema.Array(\n Schema.Struct({\n title: Schema.String.annotate({ description: 'The answer, as the reader will see it on the button.' }),\n description: Schema.optional(Schema.String.annotate({ description: 'What choosing it means.' })),\n }),\n ).annotate({ description: 'Suggested answers. Omit when you have no plausible candidates.' }),\n ),\n }),\n output: Schema.Any,\n services: [Harness.HarnessService, Database.Service, Trace.TraceService],\n});\n\nexport const PlanReminder = Operation.make({\n meta: {\n key: DXN.make('org.dxos.operation.assistantToolkit.planReminder'),\n name: 'Plan reminder',\n description: 'Reminds the agent to continue when its plan still has incomplete tasks.',\n },\n input: Schema.Struct({}),\n output: Schema.Void,\n services: [Harness.HarnessService, Database.Service, AiService.AiService],\n});\n","//\n// Copyright 2026 DXOS.org\n//\n\nimport * as Operation from '@dxos/compute/Operation';\nimport * as OperationHandlerSet from '@dxos/compute/OperationHandlerSet';\n\nimport { AskQuestion, PlanReminder, UpdateTasks } from './definitions.ts';\n\nexport * as PlanningOperations from './definitions.ts';\n\nexport const PlanningHandlers = OperationHandlerSet.lazy([\n UpdateTasks.pipe(Operation.lazyHandler(() => import('./update-tasks.ts'))),\n AskQuestion.pipe(Operation.lazyHandler(() => import('./ask-question.ts'))),\n PlanReminder.pipe(Operation.lazyHandler(() => import('./plan-reminder.ts'))),\n]);\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;AAqBA,IAAM,aAAa,OAAO,OAAO;CAC/B,MAAM,IAAI,IAAI,KAAK,IAAI,CAAA,CACpB,SAAS,EACR,aACE,+HACJ,CAAC,CAAA,CACA,KAAK,OAAO,QAAQ;CACvB,QAAQ,OAAO,QAAQ,SAAS,EAC9B,aAAa,uFACf,CAAC,CAAC,CAAC,KAAK,OAAO,QAAQ;CACvB,QAAQ,OAAO,QAAQ,SAAS,EAC9B,aAAa,4DACf,CAAC,CAAC,CAAC,KAAK,OAAO,QAAQ;CACvB,UAAU,OAAO,QAAQ,SAAS,EAChC,aAAa,mFACf,CAAC,CAAC,CAAC,KAAK,OAAO,QAAQ;CACvB,OAAO,OAAO,OAAO,SAAS,EAAE,aAAa,uDAAuD,CAAC,CAAC,CAAC,KACrG,OAAO,QACT;CACA,QAAQ,OAAO,SAAS;EAAC;EAAQ;EAAW;CAAM,CAAC,CAAA,CAChD,SAAS,EAAE,aAAa,0CAA0C,CAAC,CAAA,CACnE,KAAK,OAAO,QAAQ;AACzB,CAAC;AAID,IAAa,cAAc,UAAU,KAAK;CACxC,MAAM;EACJ,KAAKA,MAAI,KAAK,iDAAiD;EAC/D,MAAM;EACN,aAAaC;EACb,MAAM;CACR;CACA,OAAO,OAAO,OAAO,EACnB,SAAS,OAAO,MAAM,UAAU,EAClC,CAAC;CACD,QAAQ,OAAO;CACf,UAAU;EAAC,QAAQ;EAAgB,SAAS;EAAS,MAAM;CAAY;AACzE,CAAC;AAED,IAAa,cAAc,UAAU,KAAK;CACxC,MAAM;EACJ,KAAKD,MAAI,KAAK,iDAAiD;EAC/D,MAAM;EACN,MAAM;EACN,aAAa,IAAI;;;;;;;;;;;;;CAanB;CACA,OAAO,OAAO,OAAO;EACnB,MAAM,OAAO,OAAO,SAAS,EAC3B,aAAa,0DACf,CAAC;EACD,UAAU,OAAO,OAAO,SAAS,EAAE,aAAa,oCAAoC,CAAC;EACrF,SAAS,OAAO,SACd,OAAO,OAAO,SAAS,EAAE,aAAa,sEAAsE,CAAC,CAC/G;EACA,SAAS,OAAO,SACd,OAAO,MACL,OAAO,OAAO;GACZ,OAAO,OAAO,OAAO,SAAS,EAAE,aAAa,uDAAuD,CAAC;GACrG,aAAa,OAAO,SAAS,OAAO,OAAO,SAAS,EAAE,aAAa,0BAA0B,CAAC,CAAC;EACjG,CAAC,CACH,CAAC,CAAC,SAAS,EAAE,aAAa,iEAAiE,CAAC,CAC9F;CACF,CAAC;CACD,QAAQ,OAAO;CACf,UAAU;EAAC,QAAQ;EAAgB,SAAS;EAAS,MAAM;CAAY;AACzE,CAAC;AAED,IAAa,eAAe,UAAU,KAAK;CACzC,MAAM;EACJ,KAAKA,MAAI,KAAK,kDAAkD;EAChE,MAAM;EACN,aAAa;CACf;CACA,OAAO,OAAO,OAAO,CAAC,CAAC;CACvB,QAAQ,OAAO;CACf,UAAU;EAAC,QAAQ;EAAgB,SAAS;EAAS,UAAU;CAAS;AAC1E,CAAC;;;ACnGD,IAAa,mBAAmB,oBAAoB,KAAK;CACvD,YAAY,KAAK,UAAU,kBAAkB,OAAO,2BAAoB,CAAC;CACzE,YAAY,KAAK,UAAU,kBAAkB,OAAO,2BAAoB,CAAC;CACzE,aAAa,KAAK,UAAU,kBAAkB,OAAO,4BAAqB,CAAC;AAC7E,CAAC"}
1
+ {"version":3,"file":"chunk-operations3.mjs","names":["DXN","INSTRUCTIONS"],"sources":["../../src/skills/planning/operations/definitions.ts","../../src/skills/planning/operations/index.ts"],"sourcesContent":["//\n// Copyright 2026 DXOS.org\n//\n\nimport * as Schema from 'effect/Schema';\n\nimport { AiService } from '@dxos/ai';\nimport { Harness } from '@dxos/assistant';\nimport * as Hook from '@dxos/compute/Hook';\nimport * as Operation from '@dxos/compute/Operation';\nimport * as Trace from '@dxos/compute/Trace';\nimport { Database, Ref } from '@dxos/echo';\nimport { DXN } from '@dxos/keys';\nimport { Task } from '@dxos/types';\nimport { trim } from '@dxos/util';\n\nimport INSTRUCTIONS from './update-tasks.md?raw';\n\n/**\n * One edit to the conversation's tasks. Flat rather than a union of create/update shapes: a union\n * renders as `anyOf`, which some providers handle poorly, so the handler enforces the combinations.\n */\nconst TaskChange = Schema.Struct({\n task: Ref.Ref(Task.Task)\n .annotate({\n description:\n 'The existing task to change: the `echo://` URI inside the link on its checklist line, as a plain string. Omit with `create`.',\n })\n .pipe(Schema.optional),\n create: Schema.Boolean.annotate({\n description: 'Create a new task on this checklist, assigned to you. Requires `title`; omit `task`.',\n }).pipe(Schema.optional),\n assign: Schema.Boolean.annotate({\n description: 'Put the task on this checklist with you working it. A person who answers for it stays its assignee.',\n }).pipe(Schema.optional),\n unassign: Schema.Boolean.annotate({\n description: 'Take the task off this checklist and stop working it. Never deletes the task.',\n }).pipe(Schema.optional),\n title: Schema.String.annotate({ description: 'The new task title, or a rename of an existing task.' }).pipe(\n Schema.optional,\n ),\n status: Schema.Literals(['todo', 'started', 'done'])\n .annotate({ description: '`started` also makes you the agent working it.' })\n .pipe(Schema.optional),\n});\n\nexport type TaskChange = Schema.Schema.Type<typeof TaskChange>;\n\nexport const UpdateTasks = Operation.make({\n meta: {\n key: DXN.make('org.dxos.operation.assistantToolkit.updateTasks'),\n name: 'Update tasks',\n description: INSTRUCTIONS,\n icon: 'ph--check-square-offset--regular',\n },\n input: Schema.Struct({\n changes: Schema.Array(TaskChange),\n }),\n output: Schema.Any,\n services: [Harness.HarnessService, Database.Service, Trace.TraceService],\n});\n\nexport const AskQuestion = Operation.make({\n meta: {\n key: DXN.make('org.dxos.operation.assistantToolkit.askQuestion'),\n name: 'Ask question',\n icon: 'ph--question--regular',\n description: trim`\n Ask the user a question you cannot answer yourself, and stop that task on it.\n Prefer asking to guessing: an assumption the checklist then carries as fact costs more than\n the round trip does.\n Every question is about one task on the checklist, named by its exact title: the task is put in\n 'blocked' and the question filed on it, so the person answering can see what it holds up.\n Offer the likely answers in \"options\" when you have them — the reader may still type their own,\n so never phrase the question as if the list were exhaustive.\n Ask only what you genuinely cannot decide: a question costs the user a round trip, and a\n blocked task stays blocked until they take it.\n You are not resumed by waiting: finish this turn after asking. When the answer lands you are\n sent a message naming the question, and you read it back with the get-objects tool.\n `,\n },\n input: Schema.Struct({\n task: Schema.String.annotate({\n description: 'Exact title of the checklist task this question blocks.',\n }),\n question: Schema.String.annotate({ description: 'The question, as put to the user.' }),\n context: Schema.optional(\n Schema.String.annotate({ description: 'Why you are asking — what you are blocked on, in a sentence or two.' }),\n ),\n options: Schema.optional(\n Schema.Array(\n Schema.Struct({\n title: Schema.String.annotate({ description: 'The answer, as the reader will see it on the button.' }),\n description: Schema.optional(Schema.String.annotate({ description: 'What choosing it means.' })),\n }),\n ).annotate({ description: 'Suggested answers. Omit when you have no plausible candidates.' }),\n ),\n }),\n output: Schema.Any,\n services: [Harness.HarnessService, Database.Service, Trace.TraceService],\n});\n\nexport const PlanReminder = Operation.make({\n meta: {\n key: DXN.make('org.dxos.operation.assistantToolkit.planReminder'),\n name: 'Plan reminder',\n description: 'Reminds the agent to continue when its plan still has incomplete tasks.',\n },\n input: Schema.Struct({}),\n output: Hook.Output,\n services: [Harness.HarnessService, Database.Service, AiService.AiService],\n});\n","//\n// Copyright 2026 DXOS.org\n//\n\nimport * as Operation from '@dxos/compute/Operation';\nimport * as OperationHandlerSet from '@dxos/compute/OperationHandlerSet';\n\nimport { AskQuestion, PlanReminder, UpdateTasks } from './definitions.ts';\n\nexport * as PlanningOperations from './definitions.ts';\n\nexport const PlanningHandlers = OperationHandlerSet.lazy([\n UpdateTasks.pipe(Operation.lazyHandler(() => import('./update-tasks.ts'))),\n AskQuestion.pipe(Operation.lazyHandler(() => import('./ask-question.ts'))),\n PlanReminder.pipe(Operation.lazyHandler(() => import('./plan-reminder.ts'))),\n]);\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;AAsBA,IAAM,aAAa,OAAO,OAAO;CAC/B,MAAM,IAAI,IAAI,KAAK,IAAI,CAAC,CACrB,SAAS,EACR,aACE,+HACJ,CAAC,CAAC,CACD,KAAK,OAAO,QAAQ;CACvB,QAAQ,OAAO,QAAQ,SAAS,EAC9B,aAAa,uFACf,CAAC,CAAC,CAAC,KAAK,OAAO,QAAQ;CACvB,QAAQ,OAAO,QAAQ,SAAS,EAC9B,aAAa,sGACf,CAAC,CAAC,CAAC,KAAK,OAAO,QAAQ;CACvB,UAAU,OAAO,QAAQ,SAAS,EAChC,aAAa,gFACf,CAAC,CAAC,CAAC,KAAK,OAAO,QAAQ;CACvB,OAAO,OAAO,OAAO,SAAS,EAAE,aAAa,uDAAuD,CAAC,CAAC,CAAC,KACrG,OAAO,QACT;CACA,QAAQ,OAAO,SAAS;EAAC;EAAQ;EAAW;CAAM,CAAC,CAAC,CACjD,SAAS,EAAE,aAAa,iDAAiD,CAAC,CAAC,CAC3E,KAAK,OAAO,QAAQ;AACzB,CAAC;AAID,IAAa,cAAc,UAAU,KAAK;CACxC,MAAM;EACJ,KAAKA,MAAI,KAAK,iDAAiD;EAC/D,MAAM;EACN,aAAaC;EACb,MAAM;CACR;CACA,OAAO,OAAO,OAAO,EACnB,SAAS,OAAO,MAAM,UAAU,EAClC,CAAC;CACD,QAAQ,OAAO;CACf,UAAU;EAAC,QAAQ;EAAgB,SAAS;EAAS,MAAM;CAAY;AACzE,CAAC;AAED,IAAa,cAAc,UAAU,KAAK;CACxC,MAAM;EACJ,KAAKD,MAAI,KAAK,iDAAiD;EAC/D,MAAM;EACN,MAAM;EACN,aAAa,IAAI;;;;;;;;;;;;;CAanB;CACA,OAAO,OAAO,OAAO;EACnB,MAAM,OAAO,OAAO,SAAS,EAC3B,aAAa,0DACf,CAAC;EACD,UAAU,OAAO,OAAO,SAAS,EAAE,aAAa,oCAAoC,CAAC;EACrF,SAAS,OAAO,SACd,OAAO,OAAO,SAAS,EAAE,aAAa,sEAAsE,CAAC,CAC/G;EACA,SAAS,OAAO,SACd,OAAO,MACL,OAAO,OAAO;GACZ,OAAO,OAAO,OAAO,SAAS,EAAE,aAAa,uDAAuD,CAAC;GACrG,aAAa,OAAO,SAAS,OAAO,OAAO,SAAS,EAAE,aAAa,0BAA0B,CAAC,CAAC;EACjG,CAAC,CACH,CAAC,CAAC,SAAS,EAAE,aAAa,iEAAiE,CAAC,CAC9F;CACF,CAAC;CACD,QAAQ,OAAO;CACf,UAAU;EAAC,QAAQ;EAAgB,SAAS;EAAS,MAAM;CAAY;AACzE,CAAC;AAED,IAAa,eAAe,UAAU,KAAK;CACzC,MAAM;EACJ,KAAKA,MAAI,KAAK,kDAAkD;EAChE,MAAM;EACN,aAAa;CACf;CACA,OAAO,OAAO,OAAO,CAAC,CAAC;CACvB,QAAQ,KAAK;CACb,UAAU;EAAC,QAAQ;EAAgB,SAAS;EAAS,UAAU;CAAS;AAC1E,CAAC;;;ACpGD,IAAa,mBAAmB,oBAAoB,KAAK;CACvD,YAAY,KAAK,UAAU,kBAAkB,OAAO,2BAAoB,CAAC;CACzE,YAAY,KAAK,UAAU,kBAAkB,OAAO,2BAAoB,CAAC;CACzE,aAAa,KAAK,UAAU,kBAAkB,OAAO,4BAAqB,CAAC;AAC7E,CAAC"}
@@ -1,73 +1,48 @@
1
1
  import { t as __exportAll } from "./chunk-rolldown-runtime.mjs";
2
- import { t as Memory } from "./chunk-Memory.mjs";
3
- import { Database, Ref } from "@dxos/echo";
2
+ import { Harness } from "@dxos/assistant";
3
+ import { Obj, Ref } from "@dxos/echo";
4
4
  import { DXN as DXN$1 } from "@dxos/keys";
5
+ import { trim } from "@dxos/util";
5
6
  import * as Schema from "effect/Schema";
6
7
  import * as Operation from "@dxos/compute/Operation";
7
8
  import * as OperationHandlerSet from "@dxos/compute/OperationHandlerSet";
8
- //#region src/skills/memory/operations/definitions.ts
9
+ //#region src/skills/chat-context/operations/definitions.ts
9
10
  var definitions_exports = /* @__PURE__ */ __exportAll({
10
- DeleteMemory: () => DeleteMemory,
11
- QueryMemories: () => QueryMemories,
12
- SaveMemory: () => SaveMemory
11
+ ContextAdd: () => ContextAdd,
12
+ ContextRemove: () => ContextRemove
13
13
  });
14
- var QueryMemories = Operation.make({
14
+ var ContextAdd = Operation.make({
15
15
  meta: {
16
- key: DXN$1.make("org.dxos.operation.assistantToolkit.query"),
17
- name: "Query memories",
18
- 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.",
19
- icon: "ph--brain--regular"
16
+ key: DXN$1.make("org.dxos.operation.assistantToolkit.addContext"),
17
+ name: "Add to context",
18
+ icon: "ph--plus-circle--regular",
19
+ description: trim`
20
+ Adds the object to the chat context.
21
+ Use this it for objects that are useful long-term for the conversation.
22
+ `
20
23
  },
21
- input: Schema.Struct({
22
- text: Schema.optional(Schema.String.annotate({
23
- description: "Full-text search query. Omit to list all memories.",
24
- examples: [
25
- "new york trip date plan",
26
- "favorite color",
27
- "project cyberdyne"
28
- ]
29
- })),
30
- limit: Schema.optional(Schema.Number.annotate({
31
- description: "Maximum number of results to return.",
32
- default: 10
33
- }))
34
- }),
35
- output: Schema.Array(Schema.Unknown),
36
- services: [Database.Service]
37
- });
38
- var SaveMemory = Operation.make({
39
- meta: {
40
- key: DXN$1.make("org.dxos.operation.assistantToolkit.save"),
41
- name: "Save memory",
42
- description: "Saves a new memory to the database. Use this to persist knowledge, facts, preferences, or any information that should be remembered across conversations.",
43
- icon: "ph--brain--regular"
44
- },
45
- input: Schema.Struct({
46
- title: Schema.String.annotate({ description: "Short descriptive title for the memory." }),
47
- content: Schema.String.annotate({ description: "The content of the memory. Can be a fact, preference, instruction, or any knowledge worth persisting." })
48
- }),
49
- output: Schema.Unknown,
50
- services: [Database.Service]
24
+ input: Schema.Struct({ obj: Ref.Ref(Obj.Unknown).annotate({ description: "Object to add to the chat context." }) }),
25
+ output: Schema.Void,
26
+ services: [Harness.HarnessService]
51
27
  });
52
- var DeleteMemory = Operation.make({
28
+ var ContextRemove = Operation.make({
53
29
  meta: {
54
- key: DXN$1.make("org.dxos.operation.assistantToolkit.delete"),
55
- name: "Delete memory",
56
- description: "Deletes a memory from the database. Use this to remove outdated or incorrect memories.",
57
- icon: "ph--trash--regular"
30
+ key: DXN$1.make("org.dxos.operation.assistantToolkit.removeContext"),
31
+ name: "Remove from context",
32
+ icon: "ph--minus-circle--regular",
33
+ description: trim`
34
+ Removes the object from the chat context.
35
+ Use this it for objects that are no longer useful for the conversation.
36
+ `
58
37
  },
59
- input: Schema.Struct({ memory: Ref.Ref(Memory) }),
38
+ input: Schema.Struct({ obj: Ref.Ref(Obj.Unknown).annotate({ description: "Object to remove from the chat context." }) }),
60
39
  output: Schema.Void,
61
- services: [Database.Service]
40
+ services: [Harness.HarnessService]
62
41
  });
63
42
  //#endregion
64
- //#region src/skills/memory/operations/index.ts
65
- var MemoryHandlers = OperationHandlerSet.lazy([
66
- SaveMemory.pipe(Operation.lazyHandler(() => import("./chunk-save.mjs"))),
67
- QueryMemories.pipe(Operation.lazyHandler(() => import("./chunk-query.mjs"))),
68
- DeleteMemory.pipe(Operation.lazyHandler(() => import("./chunk-delete.mjs")))
69
- ]);
43
+ //#region src/skills/chat-context/operations/index.ts
44
+ var ChatContextHandlers = OperationHandlerSet.lazy([ContextAdd.pipe(Operation.lazyHandler(() => import("./chunk-context-add.mjs"))), ContextRemove.pipe(Operation.lazyHandler(() => import("./chunk-context-remove.mjs")))]);
70
45
  //#endregion
71
- export { definitions_exports as a, SaveMemory as i, DeleteMemory as n, QueryMemories as r, MemoryHandlers as t };
46
+ export { definitions_exports as i, ContextAdd as n, ContextRemove as r, ChatContextHandlers as t };
72
47
 
73
48
  //# sourceMappingURL=chunk-operations4.mjs.map
@@ -1 +1 @@
1
- {"version":3,"file":"chunk-operations4.mjs","names":["DXN","Memory.Memory"],"sources":["../../src/skills/memory/operations/definitions.ts","../../src/skills/memory/operations/index.ts"],"sourcesContent":["//\n// Copyright 2026 DXOS.org\n//\n\nimport * as Schema from 'effect/Schema';\n\nimport * as Operation from '@dxos/compute/Operation';\nimport { Database, Ref } from '@dxos/echo';\nimport { DXN } from '@dxos/keys';\n\nimport * as Memory from '../../../types/Memory.ts';\n\nexport const QueryMemories = Operation.make({\n meta: {\n key: DXN.make('org.dxos.operation.assistantToolkit.query'),\n name: 'Query memories',\n description:\n 'Search for stored memories using full-text search. Returns memories matching the query terms. Use this to recall previously saved knowledge, facts, or preferences.',\n icon: 'ph--brain--regular',\n },\n input: Schema.Struct({\n text: Schema.optional(\n Schema.String.annotate({\n description: 'Full-text search query. Omit to list all memories.',\n examples: ['new york trip date plan', 'favorite color', 'project cyberdyne'],\n }),\n ),\n limit: Schema.optional(\n Schema.Number.annotate({\n description: 'Maximum number of results to return.',\n default: 10,\n }),\n ),\n }),\n output: Schema.Array(Schema.Unknown),\n services: [Database.Service],\n});\n\nexport const SaveMemory = Operation.make({\n meta: {\n key: DXN.make('org.dxos.operation.assistantToolkit.save'),\n name: 'Save memory',\n description:\n 'Saves a new memory to the database. Use this to persist knowledge, facts, preferences, or any information that should be remembered across conversations.',\n icon: 'ph--brain--regular',\n },\n input: Schema.Struct({\n title: Schema.String.annotate({\n description: 'Short descriptive title for the memory.',\n }),\n content: Schema.String.annotate({\n description:\n 'The content of the memory. Can be a fact, preference, instruction, or any knowledge worth persisting.',\n }),\n }),\n output: Schema.Unknown,\n services: [Database.Service],\n});\n\nexport const DeleteMemory = Operation.make({\n meta: {\n key: DXN.make('org.dxos.operation.assistantToolkit.delete'),\n name: 'Delete memory',\n description: 'Deletes a memory from the database. Use this to remove outdated or incorrect memories.',\n icon: 'ph--trash--regular',\n },\n input: Schema.Struct({\n memory: Ref.Ref(Memory.Memory),\n }),\n output: Schema.Void,\n services: [Database.Service],\n});\n","//\n// Copyright 2026 DXOS.org\n//\n\nimport * as Operation from '@dxos/compute/Operation';\nimport * as OperationHandlerSet from '@dxos/compute/OperationHandlerSet';\n\nimport { DeleteMemory, QueryMemories, SaveMemory } from './definitions.ts';\n\nexport * as MemoryOperations from './definitions.ts';\n\nexport const MemoryHandlers = OperationHandlerSet.lazy([\n SaveMemory.pipe(Operation.lazyHandler(() => import('./save.ts'))),\n QueryMemories.pipe(Operation.lazyHandler(() => import('./query.ts'))),\n DeleteMemory.pipe(Operation.lazyHandler(() => import('./delete.ts'))),\n]);\n"],"mappings":";;;;;;;;;;;;;AAYA,IAAa,gBAAgB,UAAU,KAAK;CAC1C,MAAM;EACJ,KAAKA,MAAI,KAAK,2CAA2C;EACzD,MAAM;EACN,aACE;EACF,MAAM;CACR;CACA,OAAO,OAAO,OAAO;EACnB,MAAM,OAAO,SACX,OAAO,OAAO,SAAS;GACrB,aAAa;GACb,UAAU;IAAC;IAA2B;IAAkB;GAAmB;EAC7E,CAAC,CACH;EACA,OAAO,OAAO,SACZ,OAAO,OAAO,SAAS;GACrB,aAAa;GACb,SAAS;EACX,CAAC,CACH;CACF,CAAC;CACD,QAAQ,OAAO,MAAM,OAAO,OAAO;CACnC,UAAU,CAAC,SAAS,OAAO;AAC7B,CAAC;AAED,IAAa,aAAa,UAAU,KAAK;CACvC,MAAM;EACJ,KAAKA,MAAI,KAAK,0CAA0C;EACxD,MAAM;EACN,aACE;EACF,MAAM;CACR;CACA,OAAO,OAAO,OAAO;EACnB,OAAO,OAAO,OAAO,SAAS,EAC5B,aAAa,0CACf,CAAC;EACD,SAAS,OAAO,OAAO,SAAS,EAC9B,aACE,wGACJ,CAAC;CACH,CAAC;CACD,QAAQ,OAAO;CACf,UAAU,CAAC,SAAS,OAAO;AAC7B,CAAC;AAED,IAAa,eAAe,UAAU,KAAK;CACzC,MAAM;EACJ,KAAKA,MAAI,KAAK,4CAA4C;EAC1D,MAAM;EACN,aAAa;EACb,MAAM;CACR;CACA,OAAO,OAAO,OAAO,EACnB,QAAQ,IAAI,IAAIC,MAAa,EAC/B,CAAC;CACD,QAAQ,OAAO;CACf,UAAU,CAAC,SAAS,OAAO;AAC7B,CAAC;;;AC5DD,IAAa,iBAAiB,oBAAoB,KAAK;CACrD,WAAW,KAAK,UAAU,kBAAkB,OAAO,mBAAY,CAAC;CAChE,cAAc,KAAK,UAAU,kBAAkB,OAAO,oBAAa,CAAC;CACpE,aAAa,KAAK,UAAU,kBAAkB,OAAO,qBAAc,CAAC;AACtE,CAAC"}
1
+ {"version":3,"file":"chunk-operations4.mjs","names":["DXN"],"sources":["../../src/skills/chat-context/operations/definitions.ts","../../src/skills/chat-context/operations/index.ts"],"sourcesContent":["//\n// Copyright 2025 DXOS.org\n//\n\nimport * as Schema from 'effect/Schema';\n\nimport { Harness } from '@dxos/assistant';\nimport * as Operation from '@dxos/compute/Operation';\nimport { Obj, Ref } from '@dxos/echo';\nimport { DXN } from '@dxos/keys';\nimport { trim } from '@dxos/util';\n\nexport const ContextAdd = Operation.make({\n meta: {\n key: DXN.make('org.dxos.operation.assistantToolkit.addContext'),\n name: 'Add to context',\n icon: 'ph--plus-circle--regular',\n description: trim`\n Adds the object to the chat context.\n Use this it for objects that are useful long-term for the conversation.\n `,\n },\n input: Schema.Struct({\n obj: Ref.Ref(Obj.Unknown).annotate({\n description: 'Object to add to the chat context.',\n }),\n }),\n output: Schema.Void,\n services: [Harness.HarnessService],\n});\n\nexport const ContextRemove = Operation.make({\n meta: {\n key: DXN.make('org.dxos.operation.assistantToolkit.removeContext'),\n name: 'Remove from context',\n icon: 'ph--minus-circle--regular',\n description: trim`\n Removes the object from the chat context.\n Use this it for objects that are no longer useful for the conversation.\n `,\n },\n input: Schema.Struct({\n obj: Ref.Ref(Obj.Unknown).annotate({\n description: 'Object to remove from the chat context.',\n }),\n }),\n output: Schema.Void,\n services: [Harness.HarnessService],\n});\n","//\n// Copyright 2025 DXOS.org\n//\n\nimport * as Operation from '@dxos/compute/Operation';\nimport * as OperationHandlerSet from '@dxos/compute/OperationHandlerSet';\n\nimport { ContextAdd, ContextRemove } from './definitions.ts';\n\nexport * as ChatContextOperations from './definitions.ts';\n\nexport const ChatContextHandlers = OperationHandlerSet.lazy([\n ContextAdd.pipe(Operation.lazyHandler(() => import('./context-add.ts'))),\n ContextRemove.pipe(Operation.lazyHandler(() => import('./context-remove.ts'))),\n]);\n"],"mappings":";;;;;;;;;;;;;AAYA,IAAa,aAAa,UAAU,KAAK;CACvC,MAAM;EACJ,KAAKA,MAAI,KAAK,gDAAgD;EAC9D,MAAM;EACN,MAAM;EACN,aAAa,IAAI;;;;CAInB;CACA,OAAO,OAAO,OAAO,EACnB,KAAK,IAAI,IAAI,IAAI,OAAO,CAAC,CAAC,SAAS,EACjC,aAAa,qCACf,CAAC,EACH,CAAC;CACD,QAAQ,OAAO;CACf,UAAU,CAAC,QAAQ,cAAc;AACnC,CAAC;AAED,IAAa,gBAAgB,UAAU,KAAK;CAC1C,MAAM;EACJ,KAAKA,MAAI,KAAK,mDAAmD;EACjE,MAAM;EACN,MAAM;EACN,aAAa,IAAI;;;;CAInB;CACA,OAAO,OAAO,OAAO,EACnB,KAAK,IAAI,IAAI,IAAI,OAAO,CAAC,CAAC,SAAS,EACjC,aAAa,0CACf,CAAC,EACH,CAAC;CACD,QAAQ,OAAO;CACf,UAAU,CAAC,QAAQ,cAAc;AACnC,CAAC;;;ACrCD,IAAa,sBAAsB,oBAAoB,KAAK,CAC1D,WAAW,KAAK,UAAU,kBAAkB,OAAO,0BAAmB,CAAC,GACvE,cAAc,KAAK,UAAU,kBAAkB,OAAO,6BAAsB,CAAC,CAC/E,CAAC"}
@@ -1,48 +1,49 @@
1
1
  import { t as __exportAll } from "./chunk-rolldown-runtime.mjs";
2
2
  import { Harness } from "@dxos/assistant";
3
- import { Obj, Ref } from "@dxos/echo";
4
- import { DXN as DXN$1 } from "@dxos/keys";
3
+ import { DXN } from "@dxos/keys";
5
4
  import { trim } from "@dxos/util";
6
5
  import * as Schema from "effect/Schema";
7
6
  import * as Operation from "@dxos/compute/Operation";
8
7
  import * as OperationHandlerSet from "@dxos/compute/OperationHandlerSet";
9
- //#region src/skills/chat-context/operations/definitions.ts
8
+ //#region src/skills/alarm/operations/definitions.ts
10
9
  var definitions_exports = /* @__PURE__ */ __exportAll({
11
- ContextAdd: () => ContextAdd,
12
- ContextRemove: () => ContextRemove
10
+ GetCurrentDate: () => GetCurrentDate,
11
+ SetAlarm: () => SetAlarm
13
12
  });
14
- var ContextAdd = Operation.make({
13
+ var SetAlarm = Operation.make({
15
14
  meta: {
16
- key: DXN$1.make("org.dxos.operation.assistantToolkit.addContext"),
17
- name: "Add to context",
18
- icon: "ph--plus-circle--regular",
15
+ key: DXN.make("org.dxos.operation.assistantToolkit.setAlarm"),
16
+ name: "Set alarm",
17
+ icon: "ph--alarm--regular",
19
18
  description: trim`
20
- Adds the object to the chat context.
21
- Use this it for objects that are useful long-term for the conversation.
19
+ Schedule an alarm to wake yourself up in the future.
20
+ Provide exactly one of "in" (a duration from now) or "at" (an absolute time).
21
+ When the alarm fires you will receive a prompt and can continue working.
22
+ Several alarms may be pending at once; each fires independently.
22
23
  `
23
24
  },
24
- input: Schema.Struct({ obj: Ref.Ref(Obj.Unknown).annotate({ description: "Object to add to the chat context." }) }),
25
- output: Schema.Void,
25
+ input: Schema.Struct({
26
+ in: Schema.optional(Schema.String.annotate({ description: "Duration from now expressed as \"<number> <unit>\", e.g. \"30 seconds\", \"5 minutes\", \"2 hours\"." })),
27
+ at: Schema.optional(Schema.String.annotate({ description: "Absolute ISO-8601 timestamp to wake at, e.g. \"2026-06-04T18:00:00.000Z\"." })),
28
+ message: Schema.optional(Schema.String.annotate({ description: "Optional reminder surfaced verbatim when the alarm fires." }))
29
+ }),
30
+ output: Schema.String,
26
31
  services: [Harness.HarnessService]
27
32
  });
28
- var ContextRemove = Operation.make({
33
+ var GetCurrentDate = Operation.make({
29
34
  meta: {
30
- key: DXN$1.make("org.dxos.operation.assistantToolkit.removeContext"),
31
- name: "Remove from context",
32
- icon: "ph--minus-circle--regular",
33
- description: trim`
34
- Removes the object from the chat context.
35
- Use this it for objects that are no longer useful for the conversation.
36
- `
35
+ key: DXN.make("org.dxos.operation.assistantToolkit.getCurrentDate"),
36
+ name: "Get current date",
37
+ icon: "ph--clock--regular",
38
+ description: "Get the current date and time as an ISO-8601 string."
37
39
  },
38
- input: Schema.Struct({ obj: Ref.Ref(Obj.Unknown).annotate({ description: "Object to remove from the chat context." }) }),
39
- output: Schema.Void,
40
- services: [Harness.HarnessService]
40
+ input: Schema.Struct({}),
41
+ output: Schema.String
41
42
  });
42
43
  //#endregion
43
- //#region src/skills/chat-context/operations/index.ts
44
- var ChatContextHandlers = OperationHandlerSet.lazy([ContextAdd.pipe(Operation.lazyHandler(() => import("./chunk-context-add.mjs"))), ContextRemove.pipe(Operation.lazyHandler(() => import("./chunk-context-remove.mjs")))]);
44
+ //#region src/skills/alarm/operations/index.ts
45
+ var AlarmHandlers = OperationHandlerSet.lazy([SetAlarm.pipe(Operation.lazyHandler(() => import("./chunk-set-alarm.mjs"))), GetCurrentDate.pipe(Operation.lazyHandler(() => import("./chunk-get-current-date.mjs")))]);
45
46
  //#endregion
46
- export { definitions_exports as i, ContextAdd as n, ContextRemove as r, ChatContextHandlers as t };
47
+ export { definitions_exports as i, GetCurrentDate as n, SetAlarm as r, AlarmHandlers as t };
47
48
 
48
49
  //# sourceMappingURL=chunk-operations5.mjs.map
@@ -1 +1 @@
1
- {"version":3,"file":"chunk-operations5.mjs","names":["DXN"],"sources":["../../src/skills/chat-context/operations/definitions.ts","../../src/skills/chat-context/operations/index.ts"],"sourcesContent":["//\n// Copyright 2025 DXOS.org\n//\n\nimport * as Schema from 'effect/Schema';\n\nimport { Harness } from '@dxos/assistant';\nimport * as Operation from '@dxos/compute/Operation';\nimport { Obj, Ref } from '@dxos/echo';\nimport { DXN } from '@dxos/keys';\nimport { trim } from '@dxos/util';\n\nexport const ContextAdd = Operation.make({\n meta: {\n key: DXN.make('org.dxos.operation.assistantToolkit.addContext'),\n name: 'Add to context',\n icon: 'ph--plus-circle--regular',\n description: trim`\n Adds the object to the chat context.\n Use this it for objects that are useful long-term for the conversation.\n `,\n },\n input: Schema.Struct({\n obj: Ref.Ref(Obj.Unknown).annotate({\n description: 'Object to add to the chat context.',\n }),\n }),\n output: Schema.Void,\n services: [Harness.HarnessService],\n});\n\nexport const ContextRemove = Operation.make({\n meta: {\n key: DXN.make('org.dxos.operation.assistantToolkit.removeContext'),\n name: 'Remove from context',\n icon: 'ph--minus-circle--regular',\n description: trim`\n Removes the object from the chat context.\n Use this it for objects that are no longer useful for the conversation.\n `,\n },\n input: Schema.Struct({\n obj: Ref.Ref(Obj.Unknown).annotate({\n description: 'Object to remove from the chat context.',\n }),\n }),\n output: Schema.Void,\n services: [Harness.HarnessService],\n});\n","//\n// Copyright 2025 DXOS.org\n//\n\nimport * as Operation from '@dxos/compute/Operation';\nimport * as OperationHandlerSet from '@dxos/compute/OperationHandlerSet';\n\nimport { ContextAdd, ContextRemove } from './definitions.ts';\n\nexport * as ChatContextOperations from './definitions.ts';\n\nexport const ChatContextHandlers = OperationHandlerSet.lazy([\n ContextAdd.pipe(Operation.lazyHandler(() => import('./context-add.ts'))),\n ContextRemove.pipe(Operation.lazyHandler(() => import('./context-remove.ts'))),\n]);\n"],"mappings":";;;;;;;;;;;;;AAYA,IAAa,aAAa,UAAU,KAAK;CACvC,MAAM;EACJ,KAAKA,MAAI,KAAK,gDAAgD;EAC9D,MAAM;EACN,MAAM;EACN,aAAa,IAAI;;;;CAInB;CACA,OAAO,OAAO,OAAO,EACnB,KAAK,IAAI,IAAI,IAAI,OAAO,CAAC,CAAC,SAAS,EACjC,aAAa,qCACf,CAAC,EACH,CAAC;CACD,QAAQ,OAAO;CACf,UAAU,CAAC,QAAQ,cAAc;AACnC,CAAC;AAED,IAAa,gBAAgB,UAAU,KAAK;CAC1C,MAAM;EACJ,KAAKA,MAAI,KAAK,mDAAmD;EACjE,MAAM;EACN,MAAM;EACN,aAAa,IAAI;;;;CAInB;CACA,OAAO,OAAO,OAAO,EACnB,KAAK,IAAI,IAAI,IAAI,OAAO,CAAC,CAAC,SAAS,EACjC,aAAa,0CACf,CAAC,EACH,CAAC;CACD,QAAQ,OAAO;CACf,UAAU,CAAC,QAAQ,cAAc;AACnC,CAAC;;;ACrCD,IAAa,sBAAsB,oBAAoB,KAAK,CAC1D,WAAW,KAAK,UAAU,kBAAkB,OAAO,0BAAmB,CAAC,GACvE,cAAc,KAAK,UAAU,kBAAkB,OAAO,6BAAsB,CAAC,CAC/E,CAAC"}
1
+ {"version":3,"file":"chunk-operations5.mjs","names":[],"sources":["../../src/skills/alarm/operations/definitions.ts","../../src/skills/alarm/operations/index.ts"],"sourcesContent":["//\n// Copyright 2026 DXOS.org\n//\n\nimport * as Schema from 'effect/Schema';\n\nimport { Harness } from '@dxos/assistant';\nimport * as Operation from '@dxos/compute/Operation';\nimport { DXN } from '@dxos/keys';\nimport { trim } from '@dxos/util';\n\nexport const SetAlarm = Operation.make({\n meta: {\n key: DXN.make('org.dxos.operation.assistantToolkit.setAlarm'),\n name: 'Set alarm',\n icon: 'ph--alarm--regular',\n description: trim`\n Schedule an alarm to wake yourself up in the future.\n Provide exactly one of \"in\" (a duration from now) or \"at\" (an absolute time).\n When the alarm fires you will receive a prompt and can continue working.\n Several alarms may be pending at once; each fires independently.\n `,\n },\n input: Schema.Struct({\n in: Schema.optional(\n Schema.String.annotate({\n description: 'Duration from now expressed as \"<number> <unit>\", e.g. \"30 seconds\", \"5 minutes\", \"2 hours\".',\n }),\n ),\n at: Schema.optional(\n Schema.String.annotate({\n description: 'Absolute ISO-8601 timestamp to wake at, e.g. \"2026-06-04T18:00:00.000Z\".',\n }),\n ),\n message: Schema.optional(\n Schema.String.annotate({\n description: 'Optional reminder surfaced verbatim when the alarm fires.',\n }),\n ),\n }),\n output: Schema.String,\n services: [Harness.HarnessService],\n});\n\nexport const GetCurrentDate = Operation.make({\n meta: {\n key: DXN.make('org.dxos.operation.assistantToolkit.getCurrentDate'),\n name: 'Get current date',\n icon: 'ph--clock--regular',\n description: 'Get the current date and time as an ISO-8601 string.',\n },\n input: Schema.Struct({}),\n output: Schema.String,\n});\n","//\n// Copyright 2026 DXOS.org\n//\n\nimport * as Operation from '@dxos/compute/Operation';\nimport * as OperationHandlerSet from '@dxos/compute/OperationHandlerSet';\n\nimport { GetCurrentDate, SetAlarm } from './definitions.ts';\n\nexport * as AlarmOperations from './definitions.ts';\n\nexport const AlarmHandlers = OperationHandlerSet.lazy([\n SetAlarm.pipe(Operation.lazyHandler(() => import('./set-alarm.ts'))),\n GetCurrentDate.pipe(Operation.lazyHandler(() => import('./get-current-date.ts'))),\n]);\n"],"mappings":";;;;;;;;;;;;AAWA,IAAa,WAAW,UAAU,KAAK;CACrC,MAAM;EACJ,KAAK,IAAI,KAAK,8CAA8C;EAC5D,MAAM;EACN,MAAM;EACN,aAAa,IAAI;;;;;;CAMnB;CACA,OAAO,OAAO,OAAO;EACnB,IAAI,OAAO,SACT,OAAO,OAAO,SAAS,EACrB,aAAa,uGACf,CAAC,CACH;EACA,IAAI,OAAO,SACT,OAAO,OAAO,SAAS,EACrB,aAAa,6EACf,CAAC,CACH;EACA,SAAS,OAAO,SACd,OAAO,OAAO,SAAS,EACrB,aAAa,4DACf,CAAC,CACH;CACF,CAAC;CACD,QAAQ,OAAO;CACf,UAAU,CAAC,QAAQ,cAAc;AACnC,CAAC;AAED,IAAa,iBAAiB,UAAU,KAAK;CAC3C,MAAM;EACJ,KAAK,IAAI,KAAK,oDAAoD;EAClE,MAAM;EACN,MAAM;EACN,aAAa;CACf;CACA,OAAO,OAAO,OAAO,CAAC,CAAC;CACvB,QAAQ,OAAO;AACjB,CAAC;;;AC1CD,IAAa,gBAAgB,oBAAoB,KAAK,CACpD,SAAS,KAAK,UAAU,kBAAkB,OAAO,wBAAiB,CAAC,GACnE,eAAe,KAAK,UAAU,kBAAkB,OAAO,+BAAwB,CAAC,CAClF,CAAC"}
@@ -1,49 +1,84 @@
1
1
  import { t as __exportAll } from "./chunk-rolldown-runtime.mjs";
2
2
  import { Harness } from "@dxos/assistant";
3
- import { DXN } from "@dxos/keys";
4
- import { trim } from "@dxos/util";
3
+ import * as Agent from "@dxos/assistant/Agent";
4
+ import * as Chat from "@dxos/assistant/Chat";
5
+ import { Database, Obj, Ref } from "@dxos/echo";
6
+ import { DXN as DXN$1 } from "@dxos/keys";
5
7
  import * as Schema from "effect/Schema";
6
8
  import * as Operation from "@dxos/compute/Operation";
7
9
  import * as OperationHandlerSet from "@dxos/compute/OperationHandlerSet";
8
- //#region src/skills/alarm/operations/definitions.ts
10
+ import { AiService } from "@dxos/ai";
11
+ import * as AgentService from "@dxos/compute/AgentService";
12
+ import * as TriggerEvent from "@dxos/compute/TriggerEvent";
13
+ //#region src/skills/agent/operations/definitions.ts
9
14
  var definitions_exports = /* @__PURE__ */ __exportAll({
10
- GetCurrentDate: () => GetCurrentDate,
11
- SetAlarm: () => SetAlarm
15
+ GetContext: () => GetContext,
16
+ Relay: () => Relay,
17
+ SyncAutomation: () => SyncAutomation
12
18
  });
13
- var SetAlarm = Operation.make({
19
+ var Relay = Operation.make({
14
20
  meta: {
15
- key: DXN.make("org.dxos.operation.assistantToolkit.setAlarm"),
16
- name: "Set alarm",
17
- icon: "ph--alarm--regular",
18
- description: trim`
19
- Schedule an alarm to wake yourself up in the future.
20
- Provide exactly one of "in" (a duration from now) or "at" (an absolute time).
21
- When the alarm fires you will receive a prompt and can continue working.
22
- Several alarms may be pending at once; each fires independently.
23
- `
21
+ key: DXN$1.make("org.dxos.operation.assistantToolkit.relay"),
22
+ name: "Agent Relay",
23
+ description: "Qualifies a subscription event with a cheap model and forwards it onto the durable agent session.",
24
+ icon: "ph--funnel--regular"
24
25
  },
25
26
  input: Schema.Struct({
26
- in: Schema.optional(Schema.String.annotate({ description: "Duration from now expressed as \"<number> <unit>\", e.g. \"30 seconds\", \"5 minutes\", \"2 hours\"." })),
27
- at: Schema.optional(Schema.String.annotate({ description: "Absolute ISO-8601 timestamp to wake at, e.g. \"2026-06-04T18:00:00.000Z\"." })),
28
- message: Schema.optional(Schema.String.annotate({ description: "Optional reminder surfaced verbatim when the alarm fires." }))
27
+ /** The chat whose durable session receives the event (carries feed, instructions, and agent). */
28
+ chat: Schema.suspend(() => Ref.Ref(Chat.Chat)),
29
+ event: Schema.optional(TriggerEvent.TriggerEvent),
30
+ /** Synthetic wake prompt (e.g. a cron tick) delivered instead of an event payload. */
31
+ prompt: Schema.optional(Schema.String),
32
+ /** Skip the cheap-model relevance check (default: qualify when an event is present). */
33
+ qualify: Schema.optional(Schema.Boolean)
29
34
  }),
30
- output: Schema.String,
31
- services: [Harness.HarnessService]
35
+ output: Schema.Void,
36
+ services: [
37
+ AiService.AiService,
38
+ Database.Service,
39
+ AgentService.AgentService
40
+ ]
32
41
  });
33
- var GetCurrentDate = Operation.make({
42
+ var GetContext = Operation.make({
34
43
  meta: {
35
- key: DXN.make("org.dxos.operation.assistantToolkit.getCurrentDate"),
36
- name: "Get current date",
37
- icon: "ph--clock--regular",
38
- description: "Get the current date and time as an ISO-8601 string."
44
+ key: DXN$1.make("org.dxos.operation.assistantToolkit.getContext"),
45
+ name: "Get Agent Context",
46
+ description: "Get the context of an agent.",
47
+ icon: "ph--info--regular"
39
48
  },
40
49
  input: Schema.Struct({}),
41
- output: Schema.String
50
+ output: Schema.Struct({
51
+ id: Schema.String,
52
+ name: Schema.String,
53
+ instructions: Schema.String,
54
+ checklist: Schema.String
55
+ }),
56
+ services: [Harness.HarnessService, Database.Service]
57
+ });
58
+ var SyncAutomation = Operation.make({
59
+ meta: {
60
+ key: DXN$1.make("org.dxos.operation.assistantToolkit.syncTriggers"),
61
+ name: "Sync automation",
62
+ 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.",
63
+ icon: "ph--arrows-clockwise--regular"
64
+ },
65
+ input: Schema.Struct({
66
+ agent: Schema.suspend(() => Ref.Ref(Agent.Agent)).annotate({ description: "The agent whose automation should be synced." }),
67
+ subscriptions: Schema.optional(Schema.Array(Ref.Ref(Obj.Unknown)).annotate({ description: "The objects to subscribe to (e.g. mailboxes); each compiles to a feed-triggered routine." })),
68
+ cron: Schema.optional(Schema.String.annotate({ description: "Cron expression for a scheduled wake routine." })),
69
+ qualify: Schema.optional(Schema.Boolean.annotate({ description: "Run the cheap-model relevance filter on subscription events (default true)." }))
70
+ }),
71
+ output: Schema.Void,
72
+ services: [Database.Service]
42
73
  });
43
74
  //#endregion
44
- //#region src/skills/alarm/operations/index.ts
45
- var AlarmHandlers = OperationHandlerSet.lazy([SetAlarm.pipe(Operation.lazyHandler(() => import("./chunk-set-alarm.mjs"))), GetCurrentDate.pipe(Operation.lazyHandler(() => import("./chunk-get-current-date.mjs")))]);
75
+ //#region src/skills/agent/operations/index.ts
76
+ var AgentSkillHandlers = OperationHandlerSet.lazy([
77
+ GetContext.pipe(Operation.lazyHandler(() => import("./chunk-get-context.mjs"))),
78
+ Relay.pipe(Operation.lazyHandler(() => import("./chunk-relay.mjs"))),
79
+ SyncAutomation.pipe(Operation.lazyHandler(() => import("./chunk-sync-automation.mjs")))
80
+ ]);
46
81
  //#endregion
47
- export { definitions_exports as i, GetCurrentDate as n, SetAlarm as r, AlarmHandlers as t };
82
+ export { definitions_exports as a, SyncAutomation as i, GetContext as n, Relay as r, AgentSkillHandlers as t };
48
83
 
49
84
  //# sourceMappingURL=chunk-operations6.mjs.map
@@ -1 +1 @@
1
- {"version":3,"file":"chunk-operations6.mjs","names":[],"sources":["../../src/skills/alarm/operations/definitions.ts","../../src/skills/alarm/operations/index.ts"],"sourcesContent":["//\n// Copyright 2026 DXOS.org\n//\n\nimport * as Schema from 'effect/Schema';\n\nimport { Harness } from '@dxos/assistant';\nimport * as Operation from '@dxos/compute/Operation';\nimport { DXN } from '@dxos/keys';\nimport { trim } from '@dxos/util';\n\nexport const SetAlarm = Operation.make({\n meta: {\n key: DXN.make('org.dxos.operation.assistantToolkit.setAlarm'),\n name: 'Set alarm',\n icon: 'ph--alarm--regular',\n description: trim`\n Schedule an alarm to wake yourself up in the future.\n Provide exactly one of \"in\" (a duration from now) or \"at\" (an absolute time).\n When the alarm fires you will receive a prompt and can continue working.\n Several alarms may be pending at once; each fires independently.\n `,\n },\n input: Schema.Struct({\n in: Schema.optional(\n Schema.String.annotate({\n description: 'Duration from now expressed as \"<number> <unit>\", e.g. \"30 seconds\", \"5 minutes\", \"2 hours\".',\n }),\n ),\n at: Schema.optional(\n Schema.String.annotate({\n description: 'Absolute ISO-8601 timestamp to wake at, e.g. \"2026-06-04T18:00:00.000Z\".',\n }),\n ),\n message: Schema.optional(\n Schema.String.annotate({\n description: 'Optional reminder surfaced verbatim when the alarm fires.',\n }),\n ),\n }),\n output: Schema.String,\n services: [Harness.HarnessService],\n});\n\nexport const GetCurrentDate = Operation.make({\n meta: {\n key: DXN.make('org.dxos.operation.assistantToolkit.getCurrentDate'),\n name: 'Get current date',\n icon: 'ph--clock--regular',\n description: 'Get the current date and time as an ISO-8601 string.',\n },\n input: Schema.Struct({}),\n output: Schema.String,\n});\n","//\n// Copyright 2026 DXOS.org\n//\n\nimport * as Operation from '@dxos/compute/Operation';\nimport * as OperationHandlerSet from '@dxos/compute/OperationHandlerSet';\n\nimport { GetCurrentDate, SetAlarm } from './definitions.ts';\n\nexport * as AlarmOperations from './definitions.ts';\n\nexport const AlarmHandlers = OperationHandlerSet.lazy([\n SetAlarm.pipe(Operation.lazyHandler(() => import('./set-alarm.ts'))),\n GetCurrentDate.pipe(Operation.lazyHandler(() => import('./get-current-date.ts'))),\n]);\n"],"mappings":";;;;;;;;;;;;AAWA,IAAa,WAAW,UAAU,KAAK;CACrC,MAAM;EACJ,KAAK,IAAI,KAAK,8CAA8C;EAC5D,MAAM;EACN,MAAM;EACN,aAAa,IAAI;;;;;;CAMnB;CACA,OAAO,OAAO,OAAO;EACnB,IAAI,OAAO,SACT,OAAO,OAAO,SAAS,EACrB,aAAa,uGACf,CAAC,CACH;EACA,IAAI,OAAO,SACT,OAAO,OAAO,SAAS,EACrB,aAAa,6EACf,CAAC,CACH;EACA,SAAS,OAAO,SACd,OAAO,OAAO,SAAS,EACrB,aAAa,4DACf,CAAC,CACH;CACF,CAAC;CACD,QAAQ,OAAO;CACf,UAAU,CAAC,QAAQ,cAAc;AACnC,CAAC;AAED,IAAa,iBAAiB,UAAU,KAAK;CAC3C,MAAM;EACJ,KAAK,IAAI,KAAK,oDAAoD;EAClE,MAAM;EACN,MAAM;EACN,aAAa;CACf;CACA,OAAO,OAAO,OAAO,CAAC,CAAC;CACvB,QAAQ,OAAO;AACjB,CAAC;;;AC1CD,IAAa,gBAAgB,oBAAoB,KAAK,CACpD,SAAS,KAAK,UAAU,kBAAkB,OAAO,wBAAiB,CAAC,GACnE,eAAe,KAAK,UAAU,kBAAkB,OAAO,+BAAwB,CAAC,CAClF,CAAC"}
1
+ {"version":3,"file":"chunk-operations6.mjs","names":["DXN"],"sources":["../../src/skills/agent/operations/definitions.ts","../../src/skills/agent/operations/index.ts"],"sourcesContent":["//\n// Copyright 2026 DXOS.org\n//\n\nimport * as Schema from 'effect/Schema';\n\nimport { AiService } from '@dxos/ai';\nimport { Harness } from '@dxos/assistant';\nimport * as Agent from '@dxos/assistant/Agent';\nimport * as Chat from '@dxos/assistant/Chat';\nimport * as AgentService from '@dxos/compute/AgentService';\nimport * as Operation from '@dxos/compute/Operation';\nimport * as TriggerEvent from '@dxos/compute/TriggerEvent';\nimport { Database, Obj, Ref } from '@dxos/echo';\nimport { DXN } from '@dxos/keys';\n\nexport const Relay = Operation.make({\n meta: {\n key: DXN.make('org.dxos.operation.assistantToolkit.relay'),\n name: 'Agent Relay',\n description: 'Qualifies a subscription event with a cheap model and forwards it onto the durable agent session.',\n icon: 'ph--funnel--regular',\n },\n input: Schema.Struct({\n /** The chat whose durable session receives the event (carries feed, instructions, and agent). */\n chat: Schema.suspend(() => Ref.Ref(Chat.Chat)),\n event: Schema.optional(TriggerEvent.TriggerEvent),\n /** Synthetic wake prompt (e.g. a cron tick) delivered instead of an event payload. */\n prompt: Schema.optional(Schema.String),\n /** Skip the cheap-model relevance check (default: qualify when an event is present). */\n qualify: Schema.optional(Schema.Boolean),\n }),\n output: Schema.Void,\n services: [AiService.AiService, Database.Service, AgentService.AgentService],\n});\n\nexport const GetContext = Operation.make({\n meta: {\n key: DXN.make('org.dxos.operation.assistantToolkit.getContext'),\n name: 'Get Agent Context',\n description: 'Get the context of an agent.',\n icon: 'ph--info--regular',\n },\n input: Schema.Struct({}),\n output: Schema.Struct({\n id: Schema.String,\n name: Schema.String,\n instructions: Schema.String,\n checklist: Schema.String,\n }),\n services: [Harness.HarnessService, Database.Service],\n});\n\nexport const SyncAutomation = Operation.make({\n meta: {\n key: DXN.make('org.dxos.operation.assistantToolkit.syncTriggers'),\n name: 'Sync automation',\n description:\n '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.',\n icon: 'ph--arrows-clockwise--regular',\n },\n input: Schema.Struct({\n agent: Schema.suspend(() => Ref.Ref(Agent.Agent)).annotate({\n description: 'The agent whose automation should be synced.',\n }),\n subscriptions: Schema.optional(\n Schema.Array(Ref.Ref(Obj.Unknown)).annotate({\n description: 'The objects to subscribe to (e.g. mailboxes); each compiles to a feed-triggered routine.',\n }),\n ),\n cron: Schema.optional(\n Schema.String.annotate({\n description: 'Cron expression for a scheduled wake routine.',\n }),\n ),\n qualify: Schema.optional(\n Schema.Boolean.annotate({\n description: 'Run the cheap-model relevance filter on subscription events (default true).',\n }),\n ),\n }),\n output: Schema.Void,\n services: [Database.Service],\n});\n","//\n// Copyright 2026 DXOS.org\n//\n\nimport * as Operation from '@dxos/compute/Operation';\nimport * as OperationHandlerSet from '@dxos/compute/OperationHandlerSet';\n\nimport { GetContext, Relay, SyncAutomation } from './definitions.ts';\n\nexport * as AgentSkillOperations from './definitions.ts';\n\nexport const AgentSkillHandlers = OperationHandlerSet.lazy([\n GetContext.pipe(Operation.lazyHandler(() => import('./get-context.ts'))),\n Relay.pipe(Operation.lazyHandler(() => import('./relay.ts'))),\n SyncAutomation.pipe(Operation.lazyHandler(() => import('./sync-automation.ts'))),\n]);\n"],"mappings":";;;;;;;;;;;;;;;;;;AAgBA,IAAa,QAAQ,UAAU,KAAK;CAClC,MAAM;EACJ,KAAKA,MAAI,KAAK,2CAA2C;EACzD,MAAM;EACN,aAAa;EACb,MAAM;CACR;CACA,OAAO,OAAO,OAAO;;EAEnB,MAAM,OAAO,cAAc,IAAI,IAAI,KAAK,IAAI,CAAC;EAC7C,OAAO,OAAO,SAAS,aAAa,YAAY;;EAEhD,QAAQ,OAAO,SAAS,OAAO,MAAM;;EAErC,SAAS,OAAO,SAAS,OAAO,OAAO;CACzC,CAAC;CACD,QAAQ,OAAO;CACf,UAAU;EAAC,UAAU;EAAW,SAAS;EAAS,aAAa;CAAY;AAC7E,CAAC;AAED,IAAa,aAAa,UAAU,KAAK;CACvC,MAAM;EACJ,KAAKA,MAAI,KAAK,gDAAgD;EAC9D,MAAM;EACN,aAAa;EACb,MAAM;CACR;CACA,OAAO,OAAO,OAAO,CAAC,CAAC;CACvB,QAAQ,OAAO,OAAO;EACpB,IAAI,OAAO;EACX,MAAM,OAAO;EACb,cAAc,OAAO;EACrB,WAAW,OAAO;CACpB,CAAC;CACD,UAAU,CAAC,QAAQ,gBAAgB,SAAS,OAAO;AACrD,CAAC;AAED,IAAa,iBAAiB,UAAU,KAAK;CAC3C,MAAM;EACJ,KAAKA,MAAI,KAAK,kDAAkD;EAChE,MAAM;EACN,aACE;EACF,MAAM;CACR;CACA,OAAO,OAAO,OAAO;EACnB,OAAO,OAAO,cAAc,IAAI,IAAI,MAAM,KAAK,CAAC,CAAC,CAAC,SAAS,EACzD,aAAa,+CACf,CAAC;EACD,eAAe,OAAO,SACpB,OAAO,MAAM,IAAI,IAAI,IAAI,OAAO,CAAC,CAAC,CAAC,SAAS,EAC1C,aAAa,2FACf,CAAC,CACH;EACA,MAAM,OAAO,SACX,OAAO,OAAO,SAAS,EACrB,aAAa,gDACf,CAAC,CACH;EACA,SAAS,OAAO,SACd,OAAO,QAAQ,SAAS,EACtB,aAAa,8EACf,CAAC,CACH;CACF,CAAC;CACD,QAAQ,OAAO;CACf,UAAU,CAAC,SAAS,OAAO;AAC7B,CAAC;;;ACxED,IAAa,qBAAqB,oBAAoB,KAAK;CACzD,WAAW,KAAK,UAAU,kBAAkB,OAAO,0BAAmB,CAAC;CACvE,MAAM,KAAK,UAAU,kBAAkB,OAAO,oBAAa,CAAC;CAC5D,eAAe,KAAK,UAAU,kBAAkB,OAAO,8BAAuB,CAAC;AACjF,CAAC"}