@dxos/plugin-assistant 0.12.0-next-73daef452f1464b62efdbca75fb0067c1066f264 → 0.14.0

package/PLUGIN.mdl

@@ -16,9 +16,10 @@ Each extension is defined in the Appendix or resolved via its URI.
 |-------------|-------------------------------|
 | `type`      | `org.dxos.mdl.type@1.0`      |
 | `feat`      | `org.dxos.mdl.feat@1.0`      |
-| `test`      | `org.dxos.mdl.test@1.0`      |
+| `scenario`  | `org.dxos.mdl.scenario@1.0`  |
 | `component` | `org.dxos.mdl.component@1.0` |
-| `op`        | `org.dxos.mdl.op@1.0`        |
+| `op`        | `org.dxos.mdl.op@1.1`        |
+| `test`      | `org.dxos.mdl.test@1.0`      |
 
 ## Types
 
@@ -47,6 +48,8 @@ type Settings
     chatView?: ChatView
     modelProvider?: ModelProvider
     modelDefaults?: ModelDefaults
+    codeMode?: boolean
+    reportStruggles?: boolean
     tracePanelDebug?: boolean
 ```
 
@@ -137,6 +140,7 @@ component AssistantSettings
 
 ```mdl
 op CreateChat
+  key: org.dxos.operation.assistant.createChat
   desc: Creates a new Chat object and optionally adds it to the active space.
   input:
     db: Database
@@ -148,6 +152,7 @@ op CreateChat
 
 ```mdl
 op UpdateChatName
+  key: org.dxos.operation.assistant.updateChatName
   desc: Automatically derives and updates the name of a chat using the AI service.
   input:
     chat: Chat
@@ -155,6 +160,15 @@ op UpdateChatName
   effects: [echo:write, ai:infer]
 ```
 
+```mdl
+op AnalyzeTurn
+  key: org.dxos.operation.assistant.analyzeTurn
+  desc: TurnReviewSkill's background end-request hook. Judges the turn that just ended with a small model and reports it when the agent struggled because of its prompting or tooling.
+  input: {}
+  output: void
+  effects: [echo:read, ai:infer, http:post]
+```
+
 ```mdl
 op SetCurrentChat
   desc: Associates a primary object with a specific companion chat in session state.
@@ -176,6 +190,7 @@ op RunPromptInNewChat
 
 ```mdl
 op EnsureCompanionChat
+  key: org.dxos.operation.assistant.ensureCompanionChat
   desc: Returns the companion chat for an object, creating one if none exists.
   input:
     db: Database
@@ -198,6 +213,7 @@ op OnCreateSpace
 
 ```mdl
 op ToggleTracePanelDebug
+  key: org.dxos.operation.assistant.setTracePanelDebug
   desc: Toggles the trace panel between commit-graph and raw JSON debug view.
   input:
     state?: boolean
@@ -237,7 +253,7 @@ feat F-2: Companion Chat
 feat F-3: Skill System
 
   req F-3.1: Skills define named AI configurations (instructions, tools, model).
-  req F-3.2: Built-in skills include: Assistant, Browser, Database, WebSearch, Discord, Linear, Agent, Planning, Memory, Automation, SkillManager, AgentWizard.
+  req F-3.2: Built-in skills include: Assistant, Browser, Database, WebSearch, Discord, Linear, Agent, Planning, Memory, Automation, SkillManager.
   req F-3.3:
     when: user selects a skill for a chat
     then: chat uses that skill's instructions and tool set
@@ -264,6 +280,12 @@ feat F-5: Tool Execution
   req F-5.3:
     when: AI invokes a tool during a conversation
     then: operation is dispatched via the compute runtime and result returned to the model
+  req F-5.4: Code mode is opt-in via `Settings.codeMode`, off by default; the host supplies the engine
+             through the `codeModeTurnProducer` plugin option, and without it the setting has no effect.
+  req F-5.5:
+    when: Settings.codeMode is enabled, the host supplied a code-mode producer, and no AgentTurnProducer is contributed
+    then: agent processes spawned afterwards run turns through the code-mode producer (one `eval` tool)
+          instead of AiSession
 ```
 
 ```mdl
@@ -283,10 +305,25 @@ feat F-7: Execution Trace
   req F-7.2: User can toggle between commit-graph and raw JSON views via op:ToggleTracePanelDebug.
 ```
 
+```mdl
+feat F-8: Agent Struggle Reports
+
+  req F-8.1: Reporting is opt-in via `Settings.reportStruggles`, off by default, and also requires telemetry to be enabled.
+  req F-8.2:
+    when: the chat processor issues a request with reporting enabled
+    then: TurnReviewSkill is bound to the chat; its end-request hook (op:AnalyzeTurn) runs in the background, so
+          the request settles without waiting for the review and the agent process awaits it before finishing
+  req F-8.3:
+    when: the reviewer judges the agent struggled from missing/wrong instructions or a missing/faulty tool
+    then: the trajectory is uploaded to the feedback-logs bucket under `trajectories/` and an `agent_struggle` event is captured
+          carrying the cause, model DXN, code mode, and enabled skills
+  req F-8.4: A review that fails is logged and dropped; it never surfaces to the user.
+```
+
 ## Acceptance
 
 ```mdl
-test T-1: Create chat and send message
+scenario T-1: Create chat and send message
   given: a space is open and the assistant plugin is active
   when: user creates a new Chat and sends "Hello"
   then:
@@ -296,7 +333,7 @@ test T-1: Create chat and send message
 ```
 
 ```mdl
-test T-2: Companion chat provisioning
+scenario T-2: Companion chat provisioning
   given: user opens a document with no companion chat
   when: companion panel initializes
   then:
@@ -305,7 +342,7 @@ test T-2: Companion chat provisioning
 ```
 
 ```mdl
-test T-3: Skill binding
+scenario T-3: Skill binding
   given: a chat exists
   when: user binds the "WebSearch" skill key
   then:
@@ -314,7 +351,7 @@ test T-3: Skill binding
 ```
 
 ```mdl
-test T-4: Model provider switch
+scenario T-4: Model provider switch
   given: assistant settings are open
   when: user switches provider from edge to ollama
   then:
@@ -323,7 +360,7 @@ test T-4: Model provider switch
 ```
 
 ```mdl
-test T-5: Run prompt in background
+scenario T-5: Run prompt in background
   given: a database and a prompt string are available
   when: op:RunPromptInNewChat is called with background: true
   then:
@@ -332,7 +369,7 @@ test T-5: Run prompt in background
 ```
 
 ```mdl
-test T-7: Trace panel debug toggle
+scenario T-7: Trace panel debug toggle
   given: trace panel is showing commit-graph view
   when: op:ToggleTracePanelDebug is invoked with no argument
   then:
@@ -340,6 +377,85 @@ test T-7: Trace panel debug toggle
     - trace panel switches to raw JSON view
 ```
 
+## QA
+
+Executable tests. Each step carries a human instruction (`do`) and, where the step maps to an
+invocable operation, an agent binding (`invoke`). Report failures by test and step number.
+
+```mdl
+test QA-1: Create a chat and send a message
+  desc: The core assistant round-trip — create a Chat, send a prompt, get a streamed AI response.
+  actors: both
+  covers: [F-1.1, F-1.2, F-1.3, F-1.4, T-1]
+  status: unverified
+  given:
+    - an identity exists
+    - space: a space is open
+    - no Chat named "QA Chat" exists — ABORT rather than deleting one this test did not create
+  steps:
+    - name: Create the chat
+      do: Open the assistant panel and click "New chat".
+      invoke: [op:CreateChat] { name: "QA Chat" }
+      capture: created
+      expect: a new Chat named "QA Chat" opens, empty
+      assert: return !!$created.object
+      note: |
+        CreateChat returns the chat UNFILED — the handler adds its feed regardless, but persisting
+        it in the space is a separate step (see plugin-space's addObject), which the UI's "New
+        chat" gesture does implicitly.
+    - name: Send a message
+      do: Type "Hello" into the chat input and press Enter.
+      expect: "Hello" appears as a user message, followed by a streamed assistant response, and
+        the chat is persisted to ECHO and replicated to peers
+      note: |
+        NO `invoke` — sending a prompt runs through the AI streaming path (`AiSession`), not
+        through the operation invoker; there is no `SendMessage` operation to call directly.
+    - name: Chat is auto-named
+      do: (no gesture — happens automatically once the chat has enough messages)
+      invoke: [op:UpdateChatName] { chat: $created.object }
+      expect: the chat's name changes from "QA Chat" to something derived from the conversation
+      assert: return typeof $result === 'undefined' || true;
+      note: |
+        `UpdateChatName` returns void — verify the effect on `chat.name`, not the return value
+        (Execution Rule 3). Included here for completeness; a fast QA pass may treat this as
+        `given` already established rather than re-triggering it.
+  after:
+    - name: Delete the chat
+      do: Right-click "QA Chat" in the navtree and choose Delete.
+      invoke: org.dxos.operation.space.removeObjects { objects: [$created.object], target: $given.space.db }
+      expect: the row leaves the navtree and its plank closes if it was open
+```
+
+```mdl
+test QA-2: Companion chat is provisioned and bound
+  desc: op:EnsureCompanionChat + op:BindChatContext — the chat a companioned object gets automatically.
+  actors: both
+  covers: [F-2.1, F-2.2, F-2.3, T-2]
+  status: unverified
+  given:
+    - an identity exists
+    - space: a space is open
+    - subject: a Document in the space that has no companion chat yet
+  steps:
+    - name: Ensure the companion chat
+      do: Open the document; the companion chat panel initializes automatically.
+      invoke: [op:EnsureCompanionChat] { companionTo: $given.subject }
+      capture: ensured
+      expect: a new Chat is returned and NOT yet persisted (`persisted === false`)
+      assert: return $result.persisted === false && !!$result.chat;
+    - name: Bind chat context
+      do: (no separate gesture — panel initialization runs this immediately after ensuring the chat)
+      invoke: org.dxos.operation.assistant.bindChatContext { chat: $ensured.chat, subject: $given.subject }
+      note: No `op BindChatContext` block is declared above — referenced by its full runtime key.
+      expect: the companion chat's context now includes the document (and any skills its type
+        declares via Skill.SkillsAnnotation)
+  after:
+    - name: (nothing to undo)
+      do: The companion chat is never persisted unless a message is sent, so nothing was written
+        to the space.
+      expect: the document still has no persisted companion chat
+```
+
 ---
 
 ## Appendix: Extension Definitions
@@ -369,8 +485,8 @@ ext feat
 ```
 
 ```mdl
-ext test
-  uri: org.dxos.mdl.test@1.0
+ext scenario
+  uri: org.dxos.mdl.scenario@1.0
   desc: An acceptance scenario expressed as given / when / then steps.
   fields:
     given?: Step | Step[]

package/dist/lib/Assistant.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"Assistant.mjs","names":[],"sources":["../../src/types/Assistant.ts"],"sourcesContent":["//\n// Copyright 2024 DXOS.org\n//\n\n// @import-as-namespace\n\nimport { type DXN } from '@dxos/keys';\n\n// Re-export Settings as merged const/type (not as namespace).\nimport * as SettingsModule from './Settings';\nexport const Settings = SettingsModule.Settings;\nexport type Settings = SettingsModule.Settings;\n\nexport const ChatViews = SettingsModule.ChatViews;\n\nexport const ModelProviders: readonly DXN.DXN[] = SettingsModule.ModelProviders;\nexport const ModelProvider = SettingsModule.ModelProvider;\nexport type ModelProvider = SettingsModule.ModelProvider;\n\nexport const ModelDefaults = SettingsModule.ModelDefaults;\nexport type ModelDefaults = SettingsModule.ModelDefaults;\n"],"mappings":";;;;;;;;;;AAUA,IAAa,WAAW;AAGxB,IAAa,YAAY;AAEzB,IAAa,iBAAqC;AAClD,IAAa,gBAAgB;AAG7B,IAAa,gBAAgB"}
+{"version":3,"file":"Assistant.mjs","names":[],"sources":["../../src/types/Assistant.ts"],"sourcesContent":["//\n// Copyright 2024 DXOS.org\n//\n\n// @import-as-namespace\n\nimport { type DXN } from '@dxos/keys';\n\n// Re-export Settings as merged const/type (not as namespace).\nimport * as SettingsModule from './Settings.ts';\nexport const Settings = SettingsModule.Settings;\nexport type Settings = SettingsModule.Settings;\n\nexport const ChatViews = SettingsModule.ChatViews;\n\nexport const ModelProviders: readonly DXN.DXN[] = SettingsModule.ModelProviders;\nexport const ModelProvider = SettingsModule.ModelProvider;\nexport type ModelProvider = SettingsModule.ModelProvider;\n\nexport const ModelDefaults = SettingsModule.ModelDefaults;\nexport type ModelDefaults = SettingsModule.ModelDefaults;\n"],"mappings":";;;;;;;;;;AAUA,IAAa,WAAW;AAGxB,IAAa,YAAY;AAEzB,IAAa,iBAAqC;AAClD,IAAa,gBAAgB;AAG7B,IAAa,gBAAgB"}

package/dist/lib/AssistantCapabilities.mjs

@@ -5,6 +5,8 @@ import * as Schema from "effect/Schema";
 import * as Struct from "effect/Struct";
 //#region src/types/AssistantCapabilities.ts
 var AssistantCapabilities_exports = /* @__PURE__ */ __exportAll({
+	Agent: () => Agent,
+	AgentProcess: () => AgentProcess,
 	AgentTurnProducer: () => AgentTurnProducer,
 	CompanionChatCache: () => CompanionChatCache,
 	HomeSuggestionsCache: () => HomeSuggestionsCache,
@@ -30,7 +32,9 @@ var HomeSuggestionsCacheSchema = Schema.Record(Schema.String, Schema.mutableKey(
 	/** Epoch ms timestamp of the successful generation that produced these prompts. */
 	generatedAt: Schema.Number,
 	/** Non-empty, trimmed prompts from a successful generation. */
-	prompts: Schema.Array(Schema.String)
+	prompts: Schema.Array(Schema.String),
+	/** The recent objects the prompts were generated from; an unchanged set reuses them. */
+	fingerprint: Schema.optional(Schema.String)
 })));
 /** Per-space cache of LLM-generated home starter prompts, persisted across page reloads. */
 var HomeSuggestionsCache = Capability.makeSingleton()(`${meta.profile.key}.capability.homeSuggestionsCache`);
@@ -43,8 +47,15 @@ var HomeSuggestionsCache = Capability.makeSingleton()(`${meta.profile.key}.capab
 * has to be able to contribute one before the app's own module activates without colliding.
 */
 var AgentTurnProducer = Capability.make()("org.dxos.plugin.assistant.capability.agentTurnProducer");
+var Agent = Capability.make()(`${meta.profile.key}.capability.agent`);
+/**
+* A durable process a chat can run on in place of the assistant's own agent process, named by its
+* key in `chat.session.process`. The agent service spawns it for such a chat; a chat that names
+* none runs on the assistant's.
+*/
+var AgentProcess = Capability.make()(`${meta.profile.key}.capability.agentProcess`);
 var SubjectContext = Capability.make()(`${meta.profile.key}.capability.subjectContext`);
 //#endregion
-export { AgentTurnProducer, CompanionChatCache, HomeSuggestionsCache, HomeSuggestionsCacheSchema, OllamaManager, Settings, State, StateSchema, SubjectContext, AssistantCapabilities_exports as t };
+export { Agent, AgentProcess, AgentTurnProducer, CompanionChatCache, HomeSuggestionsCache, HomeSuggestionsCacheSchema, OllamaManager, Settings, State, StateSchema, SubjectContext, AssistantCapabilities_exports as t };
 
 //# sourceMappingURL=AssistantCapabilities.mjs.map

package/dist/lib/AssistantCapabilities.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"AssistantCapabilities.mjs","names":[],"sources":["../../src/types/AssistantCapabilities.ts"],"sourcesContent":["//\n// Copyright 2025 DXOS.org\n//\n\n// @import-as-namespace\n\nimport type * as Effect from 'effect/Effect';\nimport * as Schema from 'effect/Schema';\nimport * as Struct from 'effect/Struct';\nimport type * as Atom from 'effect/unstable/reactivity/Atom';\n\nimport type { MakeTurnProducer } from '@dxos/agent-runtime';\nimport * as Capability from '@dxos/app-framework/Capability';\nimport type { AiContext } from '@dxos/assistant';\nimport type { Chat } from '@dxos/assistant-toolkit';\nimport type * as Instructions from '@dxos/compute/Instructions';\nimport { type Database, type Obj, type Ref, type Registry } from '@dxos/echo';\n\nimport { meta } from '#meta';\n\nimport * as Assistant from './Assistant';\nimport * as Ollama from './Ollama';\n\nexport const Settings = Capability.makeSingleton<Atom.Writable<Assistant.Settings>>()(\n  `${meta.profile.key}.capability.settings`,\n);\n\nexport const OllamaManager = Capability.makeSingleton<Ollama.Manager>()(`${meta.profile.key}.capability.ollamaManager`);\n\nexport const StateSchema = Schema.Struct({\n  /** Map of primary object dxn to current chat dxn. */\n  currentChat: Schema.Record(Schema.String, Schema.UndefinedOr(Schema.String)),\n  /** Map of chat object path to prompt text to auto-submit when the chat opens. */\n  pendingPrompts: Schema.Record(Schema.String, Schema.UndefinedOr(Schema.String)),\n}).mapFields(Struct.map(Schema.mutableKey));\n\nexport type AssistantState = Schema.Schema.Type<typeof StateSchema>;\n\nexport const State = Capability.makeSingleton<Atom.Writable<AssistantState>>()(`${meta.profile.key}.capability.state`);\n\n/** Session-scoped cache of transient (not yet persisted) companion chats keyed by companion DXN string. */\nexport const CompanionChatCache = Capability.makeSingleton<Atom.Writable<Record<string, Obj.Unknown | undefined>>>()(\n  `${meta.profile.key}.capability.companionChatCache`,\n);\n\nexport const HomeSuggestionsCacheSchema = Schema.Record(\n  Schema.String,\n  Schema.mutableKey(\n    Schema.Struct({\n      /** Epoch ms timestamp of the successful generation that produced these prompts. */\n      generatedAt: Schema.Number,\n      /** Non-empty, trimmed prompts from a successful generation. */\n      prompts: Schema.Array(Schema.String),\n    }),\n  ),\n);\nexport type HomeSuggestionsCache = Schema.Schema.Type<typeof HomeSuggestionsCacheSchema>;\n\n/** Per-space cache of LLM-generated home starter prompts, persisted across page reloads. */\nexport const HomeSuggestionsCache = Capability.makeSingleton<Atom.Writable<HomeSuggestionsCache>>()(\n  `${meta.profile.key}.capability.homeSuggestionsCache`,\n);\n\n/**\n * Optional engine for producing a conversation turn. When contributed, the agent process runs turns\n * through it instead of DXOS's own `AiSession` — e.g. a Claude Agent SDK host — while keeping its\n * queue, alarms, redelivery, delegation and hydration.\n *\n * A registry rather than a singleton, for the same reason as `AgentDelegationStrategy`: a harness\n * has to be able to contribute one before the app's own module activates without colliding.\n */\nexport const AgentTurnProducer = Capability.make<MakeTurnProducer>()(\n  'org.dxos.plugin.assistant.capability.agentTurnProducer',\n);\n\n/** Context a chat receives when it runs against a subject object. */\nexport type SubjectBindings = AiContext.BindingProps & {\n  /** Applied to `chat.instructions` only when the chat has none; reaches the model via the system prompt. */\n  instructions?: Ref.Ref<Instructions.Instructions>;\n};\n\n/**\n * Bindings contributed for a chat opened against a subject object — the object a companion chat is\n * attached to, or the object a chat was created for.\n *\n * Every contribution whose `appliesTo` accepts the subject runs and the results are merged, so a\n * type-specific provider adds to the default rather than replacing it. Invoked by\n * `AssistantOperation.BindChatContext`, which provides `Database.Service` for the subject's space and\n * declares `Registry.Service` for skills resolved out of the hypergraph registry.\n */\nexport type SubjectContext = {\n  /** Whether this provider applies to the subject. Absent ⇒ applies to every subject. */\n  appliesTo?: (subject: Obj.Unknown) => boolean;\n  getBindings: (params: {\n    subject: Obj.Unknown;\n    chat: Chat.Chat;\n  }) => Effect.Effect<SubjectBindings, Error, Database.Service | Registry.Service>;\n};\n\nexport const SubjectContext = Capability.make<SubjectContext>()(`${meta.profile.key}.capability.subjectContext`);\n"],"mappings":";;;;;;;;;;;;;;;;;AAuBA,IAAa,WAAW,WAAW,cAAiD,CAAC,CACnF,GAAG,KAAK,QAAQ,IAAI,qBACtB;AAEA,IAAa,gBAAgB,WAAW,cAA8B,CAAC,CAAC,GAAG,KAAK,QAAQ,IAAI,0BAA0B;AAEtH,IAAa,cAAc,OAAO,OAAO;;CAEvC,aAAa,OAAO,OAAO,OAAO,QAAQ,OAAO,YAAY,OAAO,MAAM,CAAC;;CAE3E,gBAAgB,OAAO,OAAO,OAAO,QAAQ,OAAO,YAAY,OAAO,MAAM,CAAC;AAChF,CAAC,CAAC,CAAC,UAAU,OAAO,IAAI,OAAO,UAAU,CAAC;AAI1C,IAAa,QAAQ,WAAW,cAA6C,CAAC,CAAC,GAAG,KAAK,QAAQ,IAAI,kBAAkB;;AAGrH,IAAa,qBAAqB,WAAW,cAAsE,CAAC,CAClH,GAAG,KAAK,QAAQ,IAAI,+BACtB;AAEA,IAAa,6BAA6B,OAAO,OAC/C,OAAO,QACP,OAAO,WACL,OAAO,OAAO;;CAEZ,aAAa,OAAO;;CAEpB,SAAS,OAAO,MAAM,OAAO,MAAM;AACrC,CAAC,CACH,CACF;;AAIA,IAAa,uBAAuB,WAAW,cAAmD,CAAC,CACjG,GAAG,KAAK,QAAQ,IAAI,iCACtB;;;;;;;;;AAUA,IAAa,oBAAoB,WAAW,KAAuB,CAAC,CAClE,wDACF;AA0BA,IAAa,iBAAiB,WAAW,KAAqB,CAAC,CAAC,GAAG,KAAK,QAAQ,IAAI,2BAA2B"}
+{"version":3,"file":"AssistantCapabilities.mjs","names":[],"sources":["../../src/types/AssistantCapabilities.ts"],"sourcesContent":["//\n// Copyright 2025 DXOS.org\n//\n\n// @import-as-namespace\n\nimport type * as Effect from 'effect/Effect';\nimport type * as Atom from 'effect/reactivity/Atom';\nimport * as Schema from 'effect/Schema';\nimport * as Struct from 'effect/Struct';\n\nimport type { AgentProcessDefinition, MakeTurnProducer } from '@dxos/agent-runtime';\nimport * as Capability from '@dxos/app-framework/Capability';\nimport type { AiContext } from '@dxos/assistant';\nimport type * as Chat from '@dxos/assistant/Chat';\nimport type * as Instructions from '@dxos/compute/Instructions';\nimport { type Database, type Obj, type Ref, type Registry } from '@dxos/echo';\nimport { type Message } from '@dxos/types';\n\nimport { meta } from '#meta';\n\nimport * as Assistant from './Assistant.ts';\nimport * as Ollama from './Ollama.ts';\n\nexport const Settings = Capability.makeSingleton<Atom.Writable<Assistant.Settings>>()(\n  `${meta.profile.key}.capability.settings`,\n);\n\nexport const OllamaManager = Capability.makeSingleton<Ollama.Manager>()(`${meta.profile.key}.capability.ollamaManager`);\n\nexport const StateSchema = Schema.Struct({\n  /** Map of primary object dxn to current chat dxn. */\n  currentChat: Schema.Record(Schema.String, Schema.UndefinedOr(Schema.String)),\n  /** Map of chat object path to prompt text to auto-submit when the chat opens. */\n  pendingPrompts: Schema.Record(Schema.String, Schema.UndefinedOr(Schema.String)),\n}).mapFields(Struct.map(Schema.mutableKey));\n\nexport type AssistantState = Schema.Schema.Type<typeof StateSchema>;\n\nexport const State = Capability.makeSingleton<Atom.Writable<AssistantState>>()(`${meta.profile.key}.capability.state`);\n\n/** Session-scoped cache of transient (not yet persisted) companion chats keyed by companion DXN string. */\nexport const CompanionChatCache = Capability.makeSingleton<Atom.Writable<Record<string, Obj.Unknown | undefined>>>()(\n  `${meta.profile.key}.capability.companionChatCache`,\n);\n\nexport const HomeSuggestionsCacheSchema = Schema.Record(\n  Schema.String,\n  Schema.mutableKey(\n    Schema.Struct({\n      /** Epoch ms timestamp of the successful generation that produced these prompts. */\n      generatedAt: Schema.Number,\n      /** Non-empty, trimmed prompts from a successful generation. */\n      prompts: Schema.Array(Schema.String),\n      /** The recent objects the prompts were generated from; an unchanged set reuses them. */\n      fingerprint: Schema.optional(Schema.String),\n    }),\n  ),\n);\nexport type HomeSuggestionsCache = Schema.Schema.Type<typeof HomeSuggestionsCacheSchema>;\n\n/** Per-space cache of LLM-generated home starter prompts, persisted across page reloads. */\nexport const HomeSuggestionsCache = Capability.makeSingleton<Atom.Writable<HomeSuggestionsCache>>()(\n  `${meta.profile.key}.capability.homeSuggestionsCache`,\n);\n\n/**\n * Optional engine for producing a conversation turn. When contributed, the agent process runs turns\n * through it instead of DXOS's own `AiSession` — e.g. a Claude Agent SDK host — while keeping its\n * queue, alarms, redelivery, delegation and hydration.\n *\n * A registry rather than a singleton, for the same reason as `AgentDelegationStrategy`: a harness\n * has to be able to contribute one before the app's own module activates without colliding.\n */\nexport const AgentTurnProducer = Capability.make<MakeTurnProducer>()(\n  'org.dxos.plugin.assistant.capability.agentTurnProducer',\n);\n\n/**\n * Whether an agent can run on this device; one that cannot is still listed, with the reason as a\n * short lowercase phrase shown after its name.\n */\nexport type AgentAvailability = { readonly available: true } | { readonly available: false; readonly reason: string };\n\n/** A person's answer to a request block an agent added to a chat. */\nexport type AgentResponse = {\n  chat: Chat.Chat;\n  /** The message holding the request block. */\n  message: Message.Message;\n  requestId: string;\n  optionId: string;\n};\n\n/**\n * An agent a chat can run on, keyed by `chat.session.harness`. Each plugin registers the agents it\n * provides; this plugin registers Composer's own loop as `composer`.\n */\nexport type Agent = {\n  readonly id: string;\n  readonly label: string;\n  readonly icon: string;\n  readonly availability: Atom.Atom<AgentAvailability>;\n  readonly makeTurnProducer: MakeTurnProducer;\n  /** Hands a person's answer to the agent; false when nothing is waiting on that request. */\n  readonly respond?: (response: AgentResponse) => Effect.Effect<boolean, never, Database.Service>;\n};\n\nexport const Agent = Capability.make<Agent>()(`${meta.profile.key}.capability.agent`);\n\n/**\n * A durable process a chat can run on in place of the assistant's own agent process, named by its\n * key in `chat.session.process`. The agent service spawns it for such a chat; a chat that names\n * none runs on the assistant's.\n */\nexport const AgentProcess = Capability.make<AgentProcessDefinition>()(`${meta.profile.key}.capability.agentProcess`);\n\n/** Context a chat receives when it runs against a subject object. */\nexport type SubjectBindings = AiContext.BindingProps & {\n  /** Applied to `chat.instructions` only when the chat has none; reaches the model via the system prompt. */\n  instructions?: Ref.Ref<Instructions.Instructions>;\n};\n\n/**\n * Bindings contributed for a chat opened against a subject object — the object a companion chat is\n * attached to, or the object a chat was created for.\n *\n * Every contribution whose `appliesTo` accepts the subject runs and the results are merged, so a\n * type-specific provider adds to the default rather than replacing it. Invoked by\n * `AssistantOperation.BindChatContext`, which provides `Database.Service` for the subject's space and\n * declares `Registry.Service` for skills resolved out of the hypergraph registry.\n */\nexport type SubjectContext = {\n  /** Whether this provider applies to the subject. Absent ⇒ applies to every subject. */\n  appliesTo?: (subject: Obj.Unknown) => boolean;\n  getBindings: (params: {\n    subject: Obj.Unknown;\n    chat: Chat.Chat;\n  }) => Effect.Effect<SubjectBindings, Error, Database.Service | Registry.Service>;\n};\n\nexport const SubjectContext = Capability.make<SubjectContext>()(`${meta.profile.key}.capability.subjectContext`);\n"],"mappings":";;;;;;;;;;;;;;;;;;;AAwBA,IAAa,WAAW,WAAW,cAAiD,CAAC,CACnF,GAAG,KAAK,QAAQ,IAAI,qBACtB;AAEA,IAAa,gBAAgB,WAAW,cAA8B,CAAC,CAAC,GAAG,KAAK,QAAQ,IAAI,0BAA0B;AAEtH,IAAa,cAAc,OAAO,OAAO;;CAEvC,aAAa,OAAO,OAAO,OAAO,QAAQ,OAAO,YAAY,OAAO,MAAM,CAAC;;CAE3E,gBAAgB,OAAO,OAAO,OAAO,QAAQ,OAAO,YAAY,OAAO,MAAM,CAAC;AAChF,CAAC,CAAC,CAAC,UAAU,OAAO,IAAI,OAAO,UAAU,CAAC;AAI1C,IAAa,QAAQ,WAAW,cAA6C,CAAC,CAAC,GAAG,KAAK,QAAQ,IAAI,kBAAkB;;AAGrH,IAAa,qBAAqB,WAAW,cAAsE,CAAC,CAClH,GAAG,KAAK,QAAQ,IAAI,+BACtB;AAEA,IAAa,6BAA6B,OAAO,OAC/C,OAAO,QACP,OAAO,WACL,OAAO,OAAO;;CAEZ,aAAa,OAAO;;CAEpB,SAAS,OAAO,MAAM,OAAO,MAAM;;CAEnC,aAAa,OAAO,SAAS,OAAO,MAAM;AAC5C,CAAC,CACH,CACF;;AAIA,IAAa,uBAAuB,WAAW,cAAmD,CAAC,CACjG,GAAG,KAAK,QAAQ,IAAI,iCACtB;;;;;;;;;AAUA,IAAa,oBAAoB,WAAW,KAAuB,CAAC,CAClE,wDACF;AA+BA,IAAa,QAAQ,WAAW,KAAY,CAAC,CAAC,GAAG,KAAK,QAAQ,IAAI,kBAAkB;;;;;;AAOpF,IAAa,eAAe,WAAW,KAA6B,CAAC,CAAC,GAAG,KAAK,QAAQ,IAAI,yBAAyB;AA0BnH,IAAa,iBAAiB,WAAW,KAAqB,CAAC,CAAC,GAAG,KAAK,QAAQ,IAAI,2BAA2B"}

package/dist/lib/AssistantOperation.mjs

@@ -1,19 +1,25 @@
 import { t as __exportAll } from "./chunk-rolldown-runtime.mjs";
 import * as Capability from "@dxos/app-framework/Capability";
-import { Chat } from "@dxos/assistant-toolkit";
-import { DXN } from "@dxos/keys";
+import * as Chat from "@dxos/assistant/Chat";
 import { Database, Obj, Ref, Registry, Type } from "@dxos/echo";
+import { DXN as DXN$1 } from "@dxos/keys";
 import { AiService } from "@dxos/ai";
+import { ContentBlock, Task } from "@dxos/types";
+import * as AgentService from "@dxos/compute/AgentService";
 import * as Operation from "@dxos/compute/Operation";
+import * as Trace from "@dxos/compute/Trace";
 import * as Schema from "effect/Schema";
 import * as Instructions from "@dxos/compute/Instructions";
 //#region src/types/AssistantOperation.ts
 var AssistantOperation_exports = /* @__PURE__ */ __exportAll({
+	AnswerQuestion: () => AnswerQuestion,
 	BindChatContext: () => BindChatContext,
 	CreateChat: () => CreateChat,
 	EnsureCompanionChat: () => EnsureCompanionChat,
 	ForkChat: () => ForkChat,
 	GenerateHomeSuggestions: () => GenerateHomeSuggestions,
+	RespondToRequest: () => RespondToRequest,
+	RunPromptInChat: () => RunPromptInChat,
 	SetCurrentChat: () => SetCurrentChat,
 	SetTracePanelDebug: () => SetTracePanelDebug,
 	SkillForm: () => SkillForm,
@@ -21,7 +27,7 @@ var AssistantOperation_exports = /* @__PURE__ */ __exportAll({
 });
 var CreateChat = Operation.make({
 	meta: {
-		key: DXN.make("org.dxos.operation.assistant.createChat"),
+		key: DXN$1.make("org.dxos.operation.assistant.createChat"),
 		name: "Create Chat",
 		icon: "ph--chat-text--regular"
 	},
@@ -38,7 +44,7 @@ var CreateChat = Operation.make({
 });
 var UpdateChatName = Operation.make({
 	meta: {
-		key: DXN.make("org.dxos.operation.assistant.updateChatName"),
+		key: DXN$1.make("org.dxos.operation.assistant.updateChatName"),
 		name: "Update Chat Name",
 		icon: "ph--pencil--regular"
 	},
@@ -52,7 +58,7 @@ var UpdateChatName = Operation.make({
 });
 var SetCurrentChat = Operation.make({
 	meta: {
-		key: DXN.make("org.dxos.operation.assistant.setCurrentChat"),
+		key: DXN$1.make("org.dxos.operation.assistant.setCurrentChat"),
 		name: "Set Current Chat",
 		icon: "ph--chat-text--regular"
 	},
@@ -65,7 +71,7 @@ var SetCurrentChat = Operation.make({
 });
 var ForkChat = Operation.make({
 	meta: {
-		key: DXN.make("org.dxos.operation.assistant.forkChat"),
+		key: DXN$1.make("org.dxos.operation.assistant.forkChat"),
 		name: "Fork Chat",
 		icon: "ph--git-branch--regular",
 		skipRegistry: true
@@ -86,7 +92,7 @@ var ForkChat = Operation.make({
 */
 var BindChatContext = Operation.make({
 	meta: {
-		key: DXN.make("org.dxos.operation.assistant.bindChatContext"),
+		key: DXN$1.make("org.dxos.operation.assistant.bindChatContext"),
 		name: "Bind Chat Context",
 		icon: "ph--link--regular"
 	},
@@ -100,7 +106,7 @@ var BindChatContext = Operation.make({
 });
 var EnsureCompanionChat = Operation.make({
 	meta: {
-		key: DXN.make("org.dxos.operation.assistant.ensureCompanionChat"),
+		key: DXN$1.make("org.dxos.operation.assistant.ensureCompanionChat"),
 		name: "Ensure Companion Chat",
 		icon: "ph--chat-text--regular"
 	},
@@ -112,6 +118,101 @@ var EnsureCompanionChat = Operation.make({
 		persisted: Schema.Boolean
 	})
 });
+/**
+* Runs `prompt` as a turn on an existing chat, for a caller starting one on the chat's behalf
+* (delegation, a routine) rather than a reader typing it.
+*
+* The session is created with the model the chat's own UI would use — resolved from the assistant
+* settings — because `AgentService` binds the model to the agent process at spawn and tears that
+* process down when a later caller asks for a different one. A turn started on any other model
+* therefore interrupts itself the moment the reader opens the chat.
+*/
+var RunPromptInChat = Operation.make({
+	meta: {
+		key: DXN$1.make("org.dxos.operation.assistant.runPromptInChat"),
+		name: "Run Prompt in Chat",
+		icon: "ph--chat-text--regular",
+		skipRegistry: true
+	},
+	services: [
+		Capability.Service,
+		Database.Service,
+		AgentService.AgentService
+	],
+	input: Schema.Struct({
+		chat: Schema.optional(Type.getSchema(Chat.Chat)),
+		companionTo: Schema.optional(Obj.Unknown),
+		prompt: Schema.String,
+		/**
+		* How the turn is attributed. `synthetic` marks a prompt the system raised on the reader's
+		* behalf — a resumed agent must be able to tell one from something a person typed, since only
+		* the latter is an instruction it owes an answer to.
+		*
+		* @default 'user'
+		*/
+		disposition: Schema.optional(ContentBlock.Disposition)
+	}),
+	output: Schema.Void
+});
+/**
+* Answers a request an agent raised in a chat (allow or refuse a tool call) and hands the choice to the
+* agent waiting on it.
+*/
+var RespondToRequest = Operation.make({
+	meta: {
+		key: DXN$1.make("org.dxos.operation.assistant.respondToRequest"),
+		name: "Respond to Request",
+		icon: "ph--check-circle--regular",
+		skipRegistry: true
+	},
+	services: [Capability.Service, Database.Service],
+	input: Schema.Struct({
+		chat: Type.getSchema(Chat.Chat),
+		/** The message holding the request block. */
+		messageId: Schema.String,
+		requestId: Schema.String,
+		optionId: Schema.String
+	}),
+	output: Schema.Struct({ 
+	/** False when nothing was waiting on the request any more (its turn ended, or it was answered). */
+answered: Schema.Boolean })
+});
+/**
+* Records a reader's answer to a question in a task's history and resumes the conversation that
+* asked it.
+*
+* The resume is a synthetic prompt naming the question rather than the answer itself: the answer is
+* already durable in the task's history, and an agent that reads it back there sees the record
+* itself rather than a copy frozen into a message.
+*/
+var AnswerQuestion = Operation.make({
+	meta: {
+		key: DXN$1.make("org.dxos.operation.assistant.answerQuestion"),
+		name: "Answer Question",
+		description: "Answer a question an agent asked, and resume the conversation that asked it.",
+		icon: "ph--question--regular",
+		skipRegistry: true
+	},
+	services: [Database.Service, Trace.TraceService],
+	input: Schema.Struct({
+		task: Type.getSchema(Task.Task),
+		/** Id of the question's entry in the task's history. */
+		question: Schema.String,
+		answer: Schema.String.annotate({ description: "The chosen option's title, or free-form text." })
+	}),
+	output: Schema.Struct({
+		/**
+		* False when the answer was blank, the question is not in the task's history, or it was already
+		* answered — nothing was written.
+		*/
+		accepted: Schema.Boolean,
+		/**
+		* Whether the asking conversation was woken. Separate from `accepted` because the answer is
+		* durable either way, and conflating them would show a resumed agent that is still blocked.
+		*/
+		resumed: Schema.Boolean
+	})
+}).pipe(Operation.mutation("write"));
 var SkillForm = Schema.Struct({
 	key: Schema.String,
 	name: Schema.String,
@@ -119,7 +220,7 @@ var SkillForm = Schema.Struct({
 });
 var GenerateHomeSuggestions = Operation.make({
 	meta: {
-		key: DXN.make("org.dxos.operation.assistant.generateHomeSuggestions"),
+		key: DXN$1.make("org.dxos.operation.assistant.generateHomeSuggestions"),
 		name: "Generate Home Suggestions",
 		icon: "ph--sparkle--regular",
 		skipRegistry: true
@@ -134,7 +235,7 @@ var GenerateHomeSuggestions = Operation.make({
 });
 var SetTracePanelDebug = Operation.make({
 	meta: {
-		key: DXN.make("org.dxos.operation.assistant.setTracePanelDebug"),
+		key: DXN$1.make("org.dxos.operation.assistant.setTracePanelDebug"),
 		name: "Set trace panel debug",
 		description: "Show the trace panel as a raw span tree JSON rather than a commit graph.",
 		icon: "ph--bug--regular"
@@ -144,6 +245,6 @@ var SetTracePanelDebug = Operation.make({
 	output: Schema.Boolean
 });
 //#endregion
-export { BindChatContext, CreateChat, EnsureCompanionChat, ForkChat, GenerateHomeSuggestions, SetCurrentChat, SetTracePanelDebug, SkillForm, UpdateChatName, AssistantOperation_exports as t };
+export { AnswerQuestion, BindChatContext, CreateChat, EnsureCompanionChat, ForkChat, GenerateHomeSuggestions, RespondToRequest, RunPromptInChat, SetCurrentChat, SetTracePanelDebug, SkillForm, UpdateChatName, AssistantOperation_exports as t };
 
 //# sourceMappingURL=AssistantOperation.mjs.map

package/dist/lib/AssistantOperation.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"AssistantOperation.mjs","names":[],"sources":["../../src/types/AssistantOperation.ts"],"sourcesContent":["//\n// Copyright 2025 DXOS.org\n//\n\n// @import-as-namespace\n\nimport * as Schema from 'effect/Schema';\n\nimport { AiService } from '@dxos/ai';\nimport * as Capability from '@dxos/app-framework/Capability';\nimport { Chat } from '@dxos/assistant-toolkit';\nimport * as Instructions from '@dxos/compute/Instructions';\nimport * as Operation from '@dxos/compute/Operation';\nimport { Database, Obj, Ref, Registry, Type } from '@dxos/echo';\nimport { DXN } from '@dxos/keys';\n\nexport const CreateChat = Operation.make({\n  meta: {\n    key: DXN.make('org.dxos.operation.assistant.createChat'),\n    name: 'Create Chat',\n    icon: 'ph--chat-text--regular',\n  },\n  // The chat is returned unfiled, for the caller to add with `SpaceOperation.AddObject` when it wants\n  // a durable one. Its feed is added regardless — see the handler.\n  services: [Capability.Service, Database.Service],\n  input: Schema.Struct({\n    name: Schema.optional(Schema.String),\n    /**\n     * Instructions steering the conversation, rendered into the system prompt at request time.\n     * Held by reference so the chat follows later edits to them.\n     */\n    instructions: Schema.optional(Ref.Ref(Instructions.Instructions)),\n  }),\n  output: Schema.Struct({\n    object: Type.getSchema(Chat.Chat),\n  }),\n});\n\nexport const UpdateChatName = Operation.make({\n  meta: {\n    key: DXN.make('org.dxos.operation.assistant.updateChatName'),\n    name: 'Update Chat Name',\n    icon: 'ph--pencil--regular',\n  },\n  services: [Database.Service, AiService.AiService],\n  input: Schema.Struct({\n    chat: Type.getSchema(Chat.Chat),\n    /** Initial user message text; used when the feed has no history yet (e.g. auto-rename on first send). */\n    prompt: Schema.optional(Schema.String),\n  }),\n  output: Schema.Void,\n});\n\nexport const SetCurrentChat = Operation.make({\n  meta: {\n    key: DXN.make('org.dxos.operation.assistant.setCurrentChat'),\n    name: 'Set Current Chat',\n    icon: 'ph--chat-text--regular',\n  },\n  services: [Capability.Service],\n  input: Schema.Struct({\n    companionTo: Obj.Unknown,\n    chat: Type.getSchema(Chat.Chat).pipe(Schema.optional),\n  }),\n  output: Schema.Void,\n});\n\nexport const ForkChat = Operation.make({\n  meta: {\n    key: DXN.make('org.dxos.operation.assistant.forkChat'),\n    name: 'Fork Chat',\n    icon: 'ph--git-branch--regular',\n    skipRegistry: true,\n  },\n  services: [Capability.Service, Database.Service],\n  input: Schema.Struct({\n    chat: Type.getSchema(Chat.Chat),\n    /** When provided, the forked chat is set as the companion for this object rather than opened standalone. */\n    companionTo: Schema.optional(Obj.Unknown),\n  }),\n  output: Schema.Struct({\n    object: Type.getSchema(Chat.Chat),\n  }),\n});\n\n/**\n * Applies every applicable `AssistantCapabilities.SubjectContext` contribution to a chat, binding the\n * subject and whatever else its providers derive from it (annotated skills, a project's instruction\n * objects, ...). Idempotent: `AiContext.Binder.bind` drops refs already in the conversation, so\n * re-running on an existing chat backfills bindings added since it was created.\n */\nexport const BindChatContext = Operation.make({\n  meta: {\n    key: DXN.make('org.dxos.operation.assistant.bindChatContext'),\n    name: 'Bind Chat Context',\n    icon: 'ph--link--regular',\n  },\n  services: [Capability.Service, Registry.Service],\n  input: Schema.Struct({\n    chat: Type.getSchema(Chat.Chat),\n    /** The object the chat runs against — a companion's primary object, or a chat's originating object. */\n    subject: Obj.Unknown,\n  }),\n  output: Schema.Void,\n});\n\nexport const EnsureCompanionChat = Operation.make({\n  meta: {\n    key: DXN.make('org.dxos.operation.assistant.ensureCompanionChat'),\n    name: 'Ensure Companion Chat',\n    icon: 'ph--chat-text--regular',\n  },\n  services: [Capability.Service, Database.Service],\n  input: Schema.Struct({\n    companionTo: Obj.Unknown,\n  }),\n  output: Schema.Struct({\n    chat: Type.getSchema(Chat.Chat),\n    /** Whether the returned chat was already persisted in the space. */\n    persisted: Schema.Boolean,\n  }),\n});\n\nexport const SkillForm = Schema.Struct({\n  key: Schema.String,\n  name: Schema.String,\n  description: Schema.optional(Schema.String),\n});\n\nexport const GenerateHomeSuggestions = Operation.make({\n  meta: {\n    key: DXN.make('org.dxos.operation.assistant.generateHomeSuggestions'),\n    name: 'Generate Home Suggestions',\n    icon: 'ph--sparkle--regular',\n    // Internal UI operation — not exposed as an agent tool.\n    skipRegistry: true,\n  },\n  services: [Capability.Service, AiService.AiService, Database.Service],\n  input: Schema.Struct({}),\n  output: Schema.Struct({ prompts: Schema.Array(Schema.String) }),\n});\n\nexport const SetTracePanelDebug = Operation.make({\n  meta: {\n    key: DXN.make('org.dxos.operation.assistant.setTracePanelDebug'),\n    name: 'Set trace panel debug',\n    description: 'Show the trace panel as a raw span tree JSON rather than a commit graph.',\n    icon: 'ph--bug--regular',\n  },\n  services: [Capability.Service],\n  // Required: a caller that omitted it used to get a flip, which made the result depend on state the\n  // caller had not read — two calls racing would land wherever the interleaving left them.\n  input: Schema.Struct({\n    state: Schema.Boolean,\n  }),\n  output: Schema.Boolean,\n});\n"],"mappings":"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"}
+{"version":3,"file":"AssistantOperation.mjs","names":[],"sources":["../../src/types/AssistantOperation.ts"],"sourcesContent":["//\n// Copyright 2025 DXOS.org\n//\n\n// @import-as-namespace\n\nimport * as Schema from 'effect/Schema';\n\nimport { AiService } from '@dxos/ai';\nimport * as Capability from '@dxos/app-framework/Capability';\nimport * as Chat from '@dxos/assistant/Chat';\nimport * as AgentService from '@dxos/compute/AgentService';\nimport * as Instructions from '@dxos/compute/Instructions';\nimport * as Operation from '@dxos/compute/Operation';\nimport * as Trace from '@dxos/compute/Trace';\nimport { Database, Obj, Ref, Registry, Type } from '@dxos/echo';\nimport { DXN } from '@dxos/keys';\nimport { ContentBlock, Task } from '@dxos/types';\n\nexport const CreateChat = Operation.make({\n  meta: {\n    key: DXN.make('org.dxos.operation.assistant.createChat'),\n    name: 'Create Chat',\n    icon: 'ph--chat-text--regular',\n  },\n  // The chat is returned unfiled, for the caller to add with `SpaceOperation.AddObject` when it wants\n  // a durable one. Its feed is added regardless — see the handler.\n  services: [Capability.Service, Database.Service],\n  input: Schema.Struct({\n    name: Schema.optional(Schema.String),\n    /**\n     * Instructions steering the conversation, rendered into the system prompt at request time.\n     * Held by reference so the chat follows later edits to them.\n     */\n    instructions: Schema.optional(Ref.Ref(Instructions.Instructions)),\n  }),\n  output: Schema.Struct({\n    object: Type.getSchema(Chat.Chat),\n  }),\n});\n\nexport const UpdateChatName = Operation.make({\n  meta: {\n    key: DXN.make('org.dxos.operation.assistant.updateChatName'),\n    name: 'Update Chat Name',\n    icon: 'ph--pencil--regular',\n  },\n  services: [Database.Service, AiService.AiService],\n  input: Schema.Struct({\n    chat: Type.getSchema(Chat.Chat),\n    /** Initial user message text; used when the feed has no history yet (e.g. auto-rename on first send). */\n    prompt: Schema.optional(Schema.String),\n  }),\n  output: Schema.Void,\n});\n\nexport const SetCurrentChat = Operation.make({\n  meta: {\n    key: DXN.make('org.dxos.operation.assistant.setCurrentChat'),\n    name: 'Set Current Chat',\n    icon: 'ph--chat-text--regular',\n  },\n  services: [Capability.Service],\n  input: Schema.Struct({\n    companionTo: Obj.Unknown,\n    chat: Type.getSchema(Chat.Chat).pipe(Schema.optional),\n  }),\n  output: Schema.Void,\n});\n\nexport const ForkChat = Operation.make({\n  meta: {\n    key: DXN.make('org.dxos.operation.assistant.forkChat'),\n    name: 'Fork Chat',\n    icon: 'ph--git-branch--regular',\n    skipRegistry: true,\n  },\n  services: [Capability.Service, Database.Service],\n  input: Schema.Struct({\n    chat: Type.getSchema(Chat.Chat),\n    /** When provided, the forked chat is set as the companion for this object rather than opened standalone. */\n    companionTo: Schema.optional(Obj.Unknown),\n  }),\n  output: Schema.Struct({\n    object: Type.getSchema(Chat.Chat),\n  }),\n});\n\n/**\n * Applies every applicable `AssistantCapabilities.SubjectContext` contribution to a chat, binding the\n * subject and whatever else its providers derive from it (annotated skills, a project's instruction\n * objects, ...). Idempotent: `AiContext.Binder.bind` drops refs already in the conversation, so\n * re-running on an existing chat backfills bindings added since it was created.\n */\nexport const BindChatContext = Operation.make({\n  meta: {\n    key: DXN.make('org.dxos.operation.assistant.bindChatContext'),\n    name: 'Bind Chat Context',\n    icon: 'ph--link--regular',\n  },\n  services: [Capability.Service, Registry.Service],\n  input: Schema.Struct({\n    chat: Type.getSchema(Chat.Chat),\n    /** The object the chat runs against — a companion's primary object, or a chat's originating object. */\n    subject: Obj.Unknown,\n  }),\n  output: Schema.Void,\n});\n\nexport const EnsureCompanionChat = Operation.make({\n  meta: {\n    key: DXN.make('org.dxos.operation.assistant.ensureCompanionChat'),\n    name: 'Ensure Companion Chat',\n    icon: 'ph--chat-text--regular',\n  },\n  services: [Capability.Service, Database.Service],\n  input: Schema.Struct({\n    companionTo: Obj.Unknown,\n  }),\n  output: Schema.Struct({\n    chat: Type.getSchema(Chat.Chat),\n    /** Whether the returned chat was already persisted in the space. */\n    persisted: Schema.Boolean,\n  }),\n});\n\n/**\n * Runs `prompt` as a turn on an existing chat, for a caller starting one on the chat's behalf\n * (delegation, a routine) rather than a reader typing it.\n *\n * The session is created with the model the chat's own UI would use — resolved from the assistant\n * settings — because `AgentService` binds the model to the agent process at spawn and tears that\n * process down when a later caller asks for a different one. A turn started on any other model\n * therefore interrupts itself the moment the reader opens the chat.\n */\nexport const RunPromptInChat = Operation.make({\n  meta: {\n    key: DXN.make('org.dxos.operation.assistant.runPromptInChat'),\n    name: 'Run Prompt in Chat',\n    icon: 'ph--chat-text--regular',\n    // An agent already runs inside a session; handing it one that starts another is a footgun.\n    skipRegistry: true,\n  },\n  services: [Capability.Service, Database.Service, AgentService.AgentService],\n  input: Schema.Struct({\n    chat: Schema.optional(Type.getSchema(Chat.Chat)),\n    // The object whose companion chat should run the prompt — the way to name a companion chat that\n    // has not been persisted yet, which a caller outside the page (an agent) cannot hold.\n    companionTo: Schema.optional(Obj.Unknown),\n    prompt: Schema.String,\n    /**\n     * How the turn is attributed. `synthetic` marks a prompt the system raised on the reader's\n     * behalf — a resumed agent must be able to tell one from something a person typed, since only\n     * the latter is an instruction it owes an answer to.\n     *\n     * @default 'user'\n     */\n    disposition: Schema.optional(ContentBlock.Disposition),\n  }),\n  output: Schema.Void,\n});\n\n/**\n * Answers a request an agent raised in a chat (allow or refuse a tool call) and hands the choice to the\n * agent waiting on it.\n */\nexport const RespondToRequest = Operation.make({\n  meta: {\n    key: DXN.make('org.dxos.operation.assistant.respondToRequest'),\n    name: 'Respond to Request',\n    icon: 'ph--check-circle--regular',\n    // Kept off every agent's tool surface: an agent must never be able to answer its own request.\n    skipRegistry: true,\n  },\n  services: [Capability.Service, Database.Service],\n  input: Schema.Struct({\n    chat: Type.getSchema(Chat.Chat),\n    /** The message holding the request block. */\n    messageId: Schema.String,\n    requestId: Schema.String,\n    optionId: Schema.String,\n  }),\n  output: Schema.Struct({\n    /** False when nothing was waiting on the request any more (its turn ended, or it was answered). */\n    answered: Schema.Boolean,\n  }),\n});\n\n/**\n * Records a reader's answer to a question in a task's history and resumes the conversation that\n * asked it.\n *\n * The resume is a synthetic prompt naming the question rather than the answer itself: the answer is\n * already durable in the task's history, and an agent that reads it back there sees the record\n * itself rather than a copy frozen into a message.\n */\nexport const AnswerQuestion = Operation.make({\n  meta: {\n    key: DXN.make('org.dxos.operation.assistant.answerQuestion'),\n    name: 'Answer Question',\n    description: 'Answer a question an agent asked, and resume the conversation that asked it.',\n    icon: 'ph--question--regular',\n    // The asker is the agent; handing it the tool to answer itself is a footgun.\n    skipRegistry: true,\n  },\n  // Not `Capability.Service`: the resume goes through `RunPromptInChat`, which declares the\n  // services it needs itself, so requiring them here too would fail a caller that only records.\n  services: [Database.Service, Trace.TraceService],\n  input: Schema.Struct({\n    task: Type.getSchema(Task.Task),\n    /** Id of the question's entry in the task's history. */\n    question: Schema.String,\n    answer: Schema.String.annotate({ description: \"The chosen option's title, or free-form text.\" }),\n  }),\n  output: Schema.Struct({\n    /**\n     * False when the answer was blank, the question is not in the task's history, or it was already\n     * answered — nothing was written.\n     */\n    accepted: Schema.Boolean,\n    /**\n     * Whether the asking conversation was woken. Separate from `accepted` because the answer is\n     * durable either way, and conflating them would show a resumed agent that is still blocked.\n     */\n    resumed: Schema.Boolean,\n  }),\n}).pipe(Operation.mutation('write'));\n\nexport const SkillForm = Schema.Struct({\n  key: Schema.String,\n  name: Schema.String,\n  description: Schema.optional(Schema.String),\n});\n\nexport const GenerateHomeSuggestions = Operation.make({\n  meta: {\n    key: DXN.make('org.dxos.operation.assistant.generateHomeSuggestions'),\n    name: 'Generate Home Suggestions',\n    icon: 'ph--sparkle--regular',\n    // Internal UI operation — not exposed as an agent tool.\n    skipRegistry: true,\n  },\n  services: [Capability.Service, AiService.AiService, Database.Service],\n  input: Schema.Struct({}),\n  output: Schema.Struct({ prompts: Schema.Array(Schema.String) }),\n});\n\nexport const SetTracePanelDebug = Operation.make({\n  meta: {\n    key: DXN.make('org.dxos.operation.assistant.setTracePanelDebug'),\n    name: 'Set trace panel debug',\n    description: 'Show the trace panel as a raw span tree JSON rather than a commit graph.',\n    icon: 'ph--bug--regular',\n  },\n  services: [Capability.Service],\n  // Required: a caller that omitted it used to get a flip, which made the result depend on state the\n  // caller had not read — two calls racing would land wherever the interleaving left them.\n  input: Schema.Struct({\n    state: Schema.Boolean,\n  }),\n  output: Schema.Boolean,\n});\n"],"mappings":"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"}

package/dist/lib/AssistantOptions.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"AssistantOptions.mjs","names":[],"sources":["../../src/types/AssistantOptions.ts"],"sourcesContent":["//\n// Copyright 2024 DXOS.org\n//\n\nimport type { AiService } from '@dxos/ai';\n\nexport interface AssistantPluginOptions {\n  aiServiceMiddleware?: (aiService: AiService.Service) => AiService.Service;\n\n  /**\n   * Whether creation is offered for the unfinished types (`Agent`, `Sequence`) — default true, off in\n   * the curated set, which must not advertise a type it cannot yet do anything useful with.\n   */\n  experimentalTypes?: boolean;\n}\n"],"mappings":""}
+{"version":3,"file":"AssistantOptions.mjs","names":[],"sources":["../../src/types/AssistantOptions.ts"],"sourcesContent":["//\n// Copyright 2024 DXOS.org\n//\n\nimport type { MakeTurnProducer } from '@dxos/agent-runtime';\nimport type { AiService } from '@dxos/ai';\nimport type * as CapabilityManager from '@dxos/app-framework/CapabilityManager';\n\nexport interface AssistantPluginOptions {\n  aiServiceMiddleware?: (aiService: AiService.Service) => AiService.Service;\n\n  /**\n   * Whether creation is offered for the unfinished types (`Agent`, `Sequence`) — default true, off in\n   * the curated set, which must not advertise a type it cannot yet do anything useful with.\n   */\n  experimentalTypes?: boolean;\n\n  /**\n   * Builds the turn engine used when the user enables `Settings.codeMode`; injected by the host\n   * because the code-mode package is not published. Handed the app's capabilities so the host can\n   * reach what its sandbox needs (e.g. the client's services). Without it the setting has no effect.\n   */\n  codeModeTurnProducer?: (capabilities: CapabilityManager.CapabilityManager) => MakeTurnProducer;\n}\n"],"mappings":""}

package/dist/lib/AssistantService.mjs

@@ -1,5 +1,5 @@
 import { t as __exportAll } from "./chunk-rolldown-runtime.mjs";
-import { DXN, Ref, Type } from "@dxos/echo";
+import { Annotation, DXN, Ref, Type } from "@dxos/echo";
 import * as Operation from "@dxos/compute/Operation";
 import * as Schema from "effect/Schema";
 import { ComputeGraph } from "@dxos/conductor";
@@ -63,7 +63,7 @@ var ServiceType = class extends Type.makeObject(DXN.make("org.dxos.type.service"
 	* Entries exposed: functions, workflows, and APIs.
 	*/
 	interfaces: Schema.optional(Schema.Array(ServiceInterface))
-})) {};
+}).pipe(Annotation.UserType.set())) {};
 var categoryIcons = {
 	finance: "ph--bank--regular",
 	health: "ph--heart--regular",

package/dist/lib/AssistantService.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"AssistantService.mjs","names":[],"sources":["../../src/types/AssistantService.ts"],"sourcesContent":["//\n// Copyright 2024 DXOS.org\n//\n\nimport * as Schema from 'effect/Schema';\n\nimport * as Operation from '@dxos/compute/Operation';\nimport { ComputeGraph } from '@dxos/conductor';\nimport { DXN, Ref, Type } from '@dxos/echo';\n\n// TODO(burdon): Factor out and reconcile with https://github.com/dxos/dxos/blob/main/packages/plugins/plugin-token-manager/src/defs/presets.ts#L7\n\nconst ApiAuthorizationKey = Schema.Struct({\n  type: Schema.Literal('api-key'),\n  key: Schema.String,\n  placement: Schema.Union([\n    Schema.Struct({\n      type: Schema.Literal('authorization-header'),\n    }),\n    Schema.Struct({\n      type: Schema.Literal('query'),\n      name: Schema.String,\n    }),\n  ]),\n});\n\nconst ApiAuthorizationOauth = Schema.Struct({\n  type: Schema.Literal('oauth'),\n  clientId: Schema.String,\n  clientSecret: Schema.String,\n  tokenUrl: Schema.String,\n  grantType: Schema.String,\n});\n\nexport const ApiAuthorization = Schema.Union([ApiAuthorizationKey, ApiAuthorizationOauth]);\nexport type ApiAuthorization = Schema.Schema.Type<typeof ApiAuthorization>;\n\nconst ServiceInterfaceFunction = Schema.Struct({\n  kind: Schema.Literal('function'),\n  fn: Ref.Ref(Operation.PersistentOperation),\n});\n\nconst ServiceInterfaceWorkflow = Schema.Struct({\n  kind: Schema.Literal('workflow'),\n  workflow: Ref.Ref(ComputeGraph),\n});\n\nconst ServiceInterfaceApi = Schema.Struct({\n  kind: Schema.Literal('api'),\n\n  /**\n   * URL to fetch the openapi schema.\n   */\n  schemaUrl: Schema.optional(Schema.String),\n\n  /**\n   * Inlined openapi schema.\n   */\n  schema: Schema.optional(Schema.Any),\n\n  /**\n   * Authorization configuration if required.\n   */\n  authorization: Schema.optional(ApiAuthorization),\n});\n\nconst ServiceInterface = Schema.Union([\n  // Service types.\n  ServiceInterfaceFunction,\n  ServiceInterfaceWorkflow,\n  ServiceInterfaceApi,\n]);\n\nexport type ServiceInterface = Schema.Schema.Type<typeof ServiceInterface>;\n\nexport class ServiceType extends Type.makeObject<ServiceType>(DXN.make('org.dxos.type.service', '0.1.0'))(\n  Schema.Struct({\n    serviceId: Schema.String,\n    name: Schema.optional(Schema.String),\n    description: Schema.optional(Schema.String),\n    category: Schema.optional(Schema.String),\n    enabled: Schema.optional(Schema.Boolean),\n\n    /**\n     * Entries exposed: functions, workflows, and APIs.\n     */\n    interfaces: Schema.optional(Schema.Array(ServiceInterface)),\n  }),\n) {}\n\n//\n// Service Registry\n//\n\nexport interface BaseServiceRegistry {\n  queryServices(query?: ServiceQuery): Promise<ServiceType[]>;\n}\n\nexport type ServiceQuery = {\n  name?: string;\n  category?: string;\n};\n\nexport const categoryIcons: Record<string, string> = {\n  finance: 'ph--bank--regular',\n  health: 'ph--heart--regular',\n  geolocation: 'ph--globe-simple--regular',\n  education: 'ph--books--regular',\n  entertainment: 'ph--music-notes--regular',\n  shopping: 'ph--shopping-cart--regular',\n  travel: 'ph--airplane-takeoff--regular',\n  utilities: 'ph--lightning--regular',\n  weather: 'ph--cloud-rain--regular',\n} as const;\n"],"mappings":";;;;;;;;;;;AAYA,IAAM,sBAAsB,OAAO,OAAO;CACxC,MAAM,OAAO,QAAQ,SAAS;CAC9B,KAAK,OAAO;CACZ,WAAW,OAAO,MAAM,CACtB,OAAO,OAAO,EACZ,MAAM,OAAO,QAAQ,sBAAsB,EAC7C,CAAC,GACD,OAAO,OAAO;EACZ,MAAM,OAAO,QAAQ,OAAO;EAC5B,MAAM,OAAO;CACf,CAAC,CACH,CAAC;AACH,CAAC;AAED,IAAM,wBAAwB,OAAO,OAAO;CAC1C,MAAM,OAAO,QAAQ,OAAO;CAC5B,UAAU,OAAO;CACjB,cAAc,OAAO;CACrB,UAAU,OAAO;CACjB,WAAW,OAAO;AACpB,CAAC;AAED,IAAa,mBAAmB,OAAO,MAAM,CAAC,qBAAqB,qBAAqB,CAAC;AAGzF,IAAM,2BAA2B,OAAO,OAAO;CAC7C,MAAM,OAAO,QAAQ,UAAU;CAC/B,IAAI,IAAI,IAAI,UAAU,mBAAmB;AAC3C,CAAC;AAED,IAAM,2BAA2B,OAAO,OAAO;CAC7C,MAAM,OAAO,QAAQ,UAAU;CAC/B,UAAU,IAAI,IAAI,YAAY;AAChC,CAAC;AAED,IAAM,sBAAsB,OAAO,OAAO;CACxC,MAAM,OAAO,QAAQ,KAAK;;;;CAK1B,WAAW,OAAO,SAAS,OAAO,MAAM;;;;CAKxC,QAAQ,OAAO,SAAS,OAAO,GAAG;;;;CAKlC,eAAe,OAAO,SAAS,gBAAgB;AACjD,CAAC;AAED,IAAM,mBAAmB,OAAO,MAAM;CAEpC;CACA;CACA;AACF,CAAC;AAID,IAAa,cAAb,cAAiC,KAAK,WAAwB,IAAI,KAAK,yBAAyB,OAAO,CAAC,CAAC,CACvG,OAAO,OAAO;CACZ,WAAW,OAAO;CAClB,MAAM,OAAO,SAAS,OAAO,MAAM;CACnC,aAAa,OAAO,SAAS,OAAO,MAAM;CAC1C,UAAU,OAAO,SAAS,OAAO,MAAM;CACvC,SAAS,OAAO,SAAS,OAAO,OAAO;;;;CAKvC,YAAY,OAAO,SAAS,OAAO,MAAM,gBAAgB,CAAC;AAC5D,CAAC,CACH,CAAC,CAAC,CAAC;AAeH,IAAa,gBAAwC;CACnD,SAAS;CACT,QAAQ;CACR,aAAa;CACb,WAAW;CACX,eAAe;CACf,UAAU;CACV,QAAQ;CACR,WAAW;CACX,SAAS;AACX"}
+{"version":3,"file":"AssistantService.mjs","names":[],"sources":["../../src/types/AssistantService.ts"],"sourcesContent":["//\n// Copyright 2024 DXOS.org\n//\n\nimport * as Schema from 'effect/Schema';\n\nimport * as Operation from '@dxos/compute/Operation';\nimport { ComputeGraph } from '@dxos/conductor';\nimport { Annotation, DXN, Ref, Type } from '@dxos/echo';\n\n// TODO(burdon): Factor out and reconcile with https://github.com/dxos/dxos/blob/main/packages/plugins/plugin-token-manager/src/defs/presets.ts#L7\n\nconst ApiAuthorizationKey = Schema.Struct({\n  type: Schema.Literal('api-key'),\n  key: Schema.String,\n  placement: Schema.Union([\n    Schema.Struct({\n      type: Schema.Literal('authorization-header'),\n    }),\n    Schema.Struct({\n      type: Schema.Literal('query'),\n      name: Schema.String,\n    }),\n  ]),\n});\n\nconst ApiAuthorizationOauth = Schema.Struct({\n  type: Schema.Literal('oauth'),\n  clientId: Schema.String,\n  clientSecret: Schema.String,\n  tokenUrl: Schema.String,\n  grantType: Schema.String,\n});\n\nexport const ApiAuthorization = Schema.Union([ApiAuthorizationKey, ApiAuthorizationOauth]);\nexport type ApiAuthorization = Schema.Schema.Type<typeof ApiAuthorization>;\n\nconst ServiceInterfaceFunction = Schema.Struct({\n  kind: Schema.Literal('function'),\n  fn: Ref.Ref(Operation.PersistentOperation),\n});\n\nconst ServiceInterfaceWorkflow = Schema.Struct({\n  kind: Schema.Literal('workflow'),\n  workflow: Ref.Ref(ComputeGraph),\n});\n\nconst ServiceInterfaceApi = Schema.Struct({\n  kind: Schema.Literal('api'),\n\n  /**\n   * URL to fetch the openapi schema.\n   */\n  schemaUrl: Schema.optional(Schema.String),\n\n  /**\n   * Inlined openapi schema.\n   */\n  schema: Schema.optional(Schema.Any),\n\n  /**\n   * Authorization configuration if required.\n   */\n  authorization: Schema.optional(ApiAuthorization),\n});\n\nconst ServiceInterface = Schema.Union([\n  // Service types.\n  ServiceInterfaceFunction,\n  ServiceInterfaceWorkflow,\n  ServiceInterfaceApi,\n]);\n\nexport type ServiceInterface = Schema.Schema.Type<typeof ServiceInterface>;\n\nexport class ServiceType extends Type.makeObject<ServiceType>(DXN.make('org.dxos.type.service', '0.1.0'))(\n  Schema.Struct({\n    serviceId: Schema.String,\n    name: Schema.optional(Schema.String),\n    description: Schema.optional(Schema.String),\n    category: Schema.optional(Schema.String),\n    enabled: Schema.optional(Schema.Boolean),\n\n    /**\n     * Entries exposed: functions, workflows, and APIs.\n     */\n    interfaces: Schema.optional(Schema.Array(ServiceInterface)),\n  }).pipe(Annotation.UserType.set()),\n) {}\n\n//\n// Service Registry\n//\n\nexport interface BaseServiceRegistry {\n  queryServices(query?: ServiceQuery): Promise<ServiceType[]>;\n}\n\nexport type ServiceQuery = {\n  name?: string;\n  category?: string;\n};\n\nexport const categoryIcons: Record<string, string> = {\n  finance: 'ph--bank--regular',\n  health: 'ph--heart--regular',\n  geolocation: 'ph--globe-simple--regular',\n  education: 'ph--books--regular',\n  entertainment: 'ph--music-notes--regular',\n  shopping: 'ph--shopping-cart--regular',\n  travel: 'ph--airplane-takeoff--regular',\n  utilities: 'ph--lightning--regular',\n  weather: 'ph--cloud-rain--regular',\n} as const;\n"],"mappings":";;;;;;;;;;;AAYA,IAAM,sBAAsB,OAAO,OAAO;CACxC,MAAM,OAAO,QAAQ,SAAS;CAC9B,KAAK,OAAO;CACZ,WAAW,OAAO,MAAM,CACtB,OAAO,OAAO,EACZ,MAAM,OAAO,QAAQ,sBAAsB,EAC7C,CAAC,GACD,OAAO,OAAO;EACZ,MAAM,OAAO,QAAQ,OAAO;EAC5B,MAAM,OAAO;CACf,CAAC,CACH,CAAC;AACH,CAAC;AAED,IAAM,wBAAwB,OAAO,OAAO;CAC1C,MAAM,OAAO,QAAQ,OAAO;CAC5B,UAAU,OAAO;CACjB,cAAc,OAAO;CACrB,UAAU,OAAO;CACjB,WAAW,OAAO;AACpB,CAAC;AAED,IAAa,mBAAmB,OAAO,MAAM,CAAC,qBAAqB,qBAAqB,CAAC;AAGzF,IAAM,2BAA2B,OAAO,OAAO;CAC7C,MAAM,OAAO,QAAQ,UAAU;CAC/B,IAAI,IAAI,IAAI,UAAU,mBAAmB;AAC3C,CAAC;AAED,IAAM,2BAA2B,OAAO,OAAO;CAC7C,MAAM,OAAO,QAAQ,UAAU;CAC/B,UAAU,IAAI,IAAI,YAAY;AAChC,CAAC;AAED,IAAM,sBAAsB,OAAO,OAAO;CACxC,MAAM,OAAO,QAAQ,KAAK;;;;CAK1B,WAAW,OAAO,SAAS,OAAO,MAAM;;;;CAKxC,QAAQ,OAAO,SAAS,OAAO,GAAG;;;;CAKlC,eAAe,OAAO,SAAS,gBAAgB;AACjD,CAAC;AAED,IAAM,mBAAmB,OAAO,MAAM;CAEpC;CACA;CACA;AACF,CAAC;AAID,IAAa,cAAb,cAAiC,KAAK,WAAwB,IAAI,KAAK,yBAAyB,OAAO,CAAC,CAAC,CACvG,OAAO,OAAO;CACZ,WAAW,OAAO;CAClB,MAAM,OAAO,SAAS,OAAO,MAAM;CACnC,aAAa,OAAO,SAAS,OAAO,MAAM;CAC1C,UAAU,OAAO,SAAS,OAAO,MAAM;CACvC,SAAS,OAAO,SAAS,OAAO,OAAO;;;;CAKvC,YAAY,OAAO,SAAS,OAAO,MAAM,gBAAgB,CAAC;AAC5D,CAAC,CAAC,CAAC,KAAK,WAAW,SAAS,IAAI,CAAC,CACnC,CAAC,CAAC,CAAC;AAeH,IAAa,gBAAwC;CACnD,SAAS;CACT,QAAQ;CACR,aAAa;CACb,WAAW;CACX,eAAe;CACf,UAAU;CACV,QAAQ;CACR,WAAW;CACX,SAAS;AACX"}

package/dist/lib/AssistantSkill.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"AssistantSkill.mjs","names":[],"sources":["../../src/skills/assistant/AssistantSkill.ts"],"sourcesContent":["//\n// Copyright 2025 DXOS.org\n//\n\nimport * as LayoutOperation from '@dxos/app-toolkit/LayoutOperation';\nimport * as NavigationOperation from '@dxos/app-toolkit/NavigationOperation';\nimport { templates } from '@dxos/assistant';\nimport * as Skill from '@dxos/compute/Skill';\n\nexport const key = 'org.dxos.skill.assistant';\n\nexport const make = (): Skill.Skill =>\n  Skill.make({\n    key,\n    name: 'Assistant',\n    tools: Skill.toolDefinitions({\n      // TODO(wittjosiah): LayoutOperation.Open requires Capability.Service which is only available\n      //   via the compute-runtime layer (plugin-routine). Once Capability.Service is propagated\n      //   through the process operation runtime, this will work without the compute-runtime dependency.\n      operations: [LayoutOperation.Open, NavigationOperation.ResolveNavigationTargets],\n    }),\n    instructions: templates.system,\n  });\n"],"mappings":";;;;;;;;;;AASA,IAAa,MAAM;AAEnB,IAAa,aACX,MAAM,KAAK;CACT;CACA,MAAM;CACN,OAAO,MAAM,gBAAgB,EAI3B,YAAY,CAAC,gBAAgB,MAAM,oBAAoB,wBAAwB,EACjF,CAAC;CACD,cAAc,UAAU;AAC1B,CAAC"}
+{"version":3,"file":"AssistantSkill.mjs","names":[],"sources":["../../src/skills/assistant/AssistantSkill.ts"],"sourcesContent":["//\n// Copyright 2025 DXOS.org\n//\n\n// @import-as-namespace\n\nimport * as LayoutOperation from '@dxos/app-toolkit/LayoutOperation';\nimport * as NavigationOperation from '@dxos/app-toolkit/NavigationOperation';\nimport { templates } from '@dxos/assistant';\nimport * as Skill from '@dxos/compute/Skill';\n\nexport const key = 'org.dxos.skill.assistant';\n\nexport const make = (): Skill.Skill =>\n  Skill.make({\n    key,\n    name: 'Assistant',\n    tools: Skill.toolDefinitions({\n      // TODO(wittjosiah): LayoutOperation.Open requires Capability.Service which is only available\n      //   via the compute-runtime layer (plugin-routine). Once Capability.Service is propagated\n      //   through the process operation runtime, this will work without the compute-runtime dependency.\n      operations: [LayoutOperation.Open, NavigationOperation.ResolveNavigationTargets],\n    }),\n    instructions: templates.system,\n  });\n"],"mappings":";;;;;;;;;;AAWA,IAAa,MAAM;AAEnB,IAAa,aACX,MAAM,KAAK;CACT;CACA,MAAM;CACN,OAAO,MAAM,gBAAgB,EAI3B,YAAY,CAAC,gBAAgB,MAAM,oBAAoB,wBAAwB,EACjF,CAAC;CACD,cAAc,UAAU;AAC1B,CAAC"}