@dxos/plugin-assistant 0.8.4-main.fcfe5033a5 → 0.8.4-staging.60fe92afc8

package/dist/lib/neutral/automation-templates-M2XQWGR6.mjs

@@ -0,0 +1,115 @@
+import "./chunk-J5LGTIGS.mjs";
+
+// src/capabilities/automation-templates.ts
+import * as Effect2 from "effect/Effect";
+import { Capability } from "@dxos/app-framework";
+import { AutomationCapabilities } from "@dxos/plugin-automation";
+
+// src/templates/scaffold.ts
+import * as Effect from "effect/Effect";
+import * as Schema from "effect/Schema";
+import { AgentPrompt } from "@dxos/assistant-toolkit";
+import { Blueprint, Operation, Routine, Trigger } from "@dxos/compute";
+import { Database, Filter, Obj, Ref } from "@dxos/echo";
+import { Automation } from "@dxos/plugin-automation";
+var AGENT_PROMPT_KEY = "org.dxos.function.prompt";
+var makeScheduledRoutineAutomation = ({ name, instructions, blueprintKeys, cron }) => Effect.gen(function* () {
+  const blueprints = blueprintKeys.map((key) => Ref.fromURI(Blueprint.registryURI(key)));
+  const routine = yield* Database.add(Routine.make({
+    name,
+    instructions,
+    // No per-run input; the task lives in the instructions. Unknown (not Void) so the empty trigger
+    // input still validates.
+    input: Schema.Unknown,
+    output: Schema.Void,
+    blueprints,
+    context: []
+  }));
+  const existingFns = yield* Database.query(Filter.and(Filter.type(Operation.PersistentOperation), Filter.key(AGENT_PROMPT_KEY))).run;
+  const agentPromptFn = existingFns[0] ?? (yield* Database.add(Operation.serialize(AgentPrompt)));
+  const trigger = yield* Database.add(Obj.make(Trigger.Trigger, {
+    enabled: false,
+    function: Ref.make(agentPromptFn),
+    spec: Trigger.specTimer(cron),
+    input: {
+      prompt: Ref.make(routine),
+      input: {}
+    },
+    concurrency: 1
+  }));
+  const automation = Automation.make({
+    name,
+    runnable: Ref.make(agentPromptFn),
+    triggers: [
+      Ref.make(trigger)
+    ]
+  });
+  Obj.setParent(trigger, automation);
+  return automation;
+});
+
+// src/templates/daily-digest.ts
+var BLUEPRINT_KEYS = [
+  "org.dxos.blueprint.inbox",
+  "org.dxos.blueprint.database",
+  "org.dxos.blueprint.markdown"
+];
+var DEFAULT_CRON = "0 9 * * *";
+var DEFAULT_INSTRUCTIONS = `Summarize recent activity in this space into a markdown document.
+
+Review new messages in the inbox and recently changed objects. Produce a short digest grouped by theme,
+highlight anything that needs attention, and write it to a markdown document titled with the current date.
+`;
+var dailyDigest = {
+  id: "org.dxos.automation.dailyDigest",
+  label: "Daily Digest",
+  icon: "ph--list-bullets--regular",
+  scaffold: ({ name }) => makeScheduledRoutineAutomation({
+    name: name ?? "Daily Digest",
+    instructions: DEFAULT_INSTRUCTIONS,
+    blueprintKeys: BLUEPRINT_KEYS,
+    cron: DEFAULT_CRON
+  })
+};
+
+// src/templates/research-brief.ts
+var BLUEPRINT_KEYS2 = [
+  "org.dxos.blueprint.research",
+  "org.dxos.blueprint.webSearch",
+  "org.dxos.blueprint.markdown",
+  "org.dxos.blueprint.database"
+];
+var DEFAULT_CRON2 = "0 9 * * 1";
+var DEFAULT_INSTRUCTIONS2 = `Research the topic below and write a concise brief to a new markdown document.
+
+Topic: (replace with the topic you want tracked)
+
+Gather current information with the web-search and research tools. Summarize the key developments, link the
+sources you used, and create a markdown document titled with the topic and the current date.
+`;
+var researchBrief = {
+  id: "org.dxos.automation.researchBrief",
+  label: "Research Brief",
+  icon: "ph--newspaper--regular",
+  scaffold: ({ name }) => makeScheduledRoutineAutomation({
+    name: name ?? "Research Brief",
+    instructions: DEFAULT_INSTRUCTIONS2,
+    blueprintKeys: BLUEPRINT_KEYS2,
+    cron: DEFAULT_CRON2
+  })
+};
+
+// src/templates/index.ts
+var automationTemplates = [
+  researchBrief,
+  dailyDigest
+];
+
+// src/capabilities/automation-templates.ts
+var automation_templates_default = Capability.makeModule(Effect2.fnUntraced(function* () {
+  return automationTemplates.map((template) => Capability.contributes(AutomationCapabilities.Template, template));
+}));
+export {
+  automation_templates_default as default
+};
+//# sourceMappingURL=automation-templates-M2XQWGR6.mjs.map

package/dist/lib/neutral/automation-templates-M2XQWGR6.mjs.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/capabilities/automation-templates.ts", "../../../src/templates/scaffold.ts", "../../../src/templates/daily-digest.ts", "../../../src/templates/research-brief.ts", "../../../src/templates/index.ts"],
+  "sourcesContent": ["//\n// Copyright 2026 DXOS.org\n//\n\nimport * as Effect from 'effect/Effect';\n\nimport { Capability } from '@dxos/app-framework';\nimport { AutomationCapabilities } from '@dxos/plugin-automation';\n\nimport { automationTemplates } from '../templates';\n\nexport default Capability.makeModule(\n  Effect.fnUntraced(function* () {\n    return automationTemplates.map((template) => Capability.contributes(AutomationCapabilities.Template, template));\n  }),\n);\n", "//\n// Copyright 2026 DXOS.org\n//\n\nimport * as Effect from 'effect/Effect';\nimport * as Schema from 'effect/Schema';\n\nimport { AgentPrompt } from '@dxos/assistant-toolkit';\nimport { Blueprint, Operation, Routine, Trigger } from '@dxos/compute';\nimport { Database, Filter, Obj, Ref } from '@dxos/echo';\nimport { Automation } from '@dxos/plugin-automation';\n\n/** Registry key of the persisted AgentPrompt (\"Run Routine\") operation a routine trigger dispatches. */\nconst AGENT_PROMPT_KEY = 'org.dxos.function.prompt';\n\nexport type ScheduledRoutineOptions = {\n  name: string;\n  instructions: string;\n  blueprintKeys: readonly string[];\n  cron: string;\n};\n\n/**\n * Scaffold a timer-driven automation: a Routine (instructions + blueprints) run by the shared AgentPrompt\n * operation on a cron schedule. The trigger starts disabled so the user can review the schedule and\n * instructions before activating, and is owned by the automation (cascade-deletes with it); the routine\n * stays independent, since it is edited separately and may be reused.\n */\nexport const makeScheduledRoutineAutomation = ({\n  name,\n  instructions,\n  blueprintKeys,\n  cron,\n}: ScheduledRoutineOptions): Effect.Effect<Automation.Automation, Error, Database.Service> =>\n  Effect.gen(function* () {\n    const blueprints = blueprintKeys.map((key) => Ref.fromURI(Blueprint.registryURI(key)));\n    const routine = yield* Database.add(\n      Routine.make({\n        name,\n        instructions,\n        // No per-run input; the task lives in the instructions. Unknown (not Void) so the empty trigger\n        // input still validates.\n        input: Schema.Unknown,\n        output: Schema.Void,\n        blueprints,\n        context: [],\n      }),\n    );\n\n    // The trigger's `function` must reference an in-space PersistentOperation; reuse the space's AgentPrompt\n    // or persist it on first use.\n    const existingFns = yield* Database.query(\n      Filter.and(Filter.type(Operation.PersistentOperation), Filter.key(AGENT_PROMPT_KEY)),\n    ).run;\n    const agentPromptFn = existingFns[0] ?? (yield* Database.add(Operation.serialize(AgentPrompt)));\n\n    const trigger = yield* Database.add(\n      Obj.make(Trigger.Trigger, {\n        enabled: false,\n        function: Ref.make(agentPromptFn),\n        spec: Trigger.specTimer(cron),\n        input: { prompt: Ref.make(routine), input: {} },\n        concurrency: 1,\n      }),\n    );\n\n    const automation = Automation.make({\n      name,\n      runnable: Ref.make(agentPromptFn),\n      triggers: [Ref.make(trigger)],\n    });\n    Obj.setParent(trigger, automation);\n    return automation;\n  });\n", "//\n// Copyright 2026 DXOS.org\n//\n\nimport { type AutomationCapabilities } from '@dxos/plugin-automation';\n\nimport { makeScheduledRoutineAutomation } from './scaffold';\n\n/** Inbox supplies new messages; database queries recent objects; markdown writes the digest document. */\nconst BLUEPRINT_KEYS = [\n  'org.dxos.blueprint.inbox',\n  'org.dxos.blueprint.database',\n  'org.dxos.blueprint.markdown',\n] as const;\n\n/** Runs daily by default; the user edits the schedule and the scope by opening the trigger and routine. */\nconst DEFAULT_CRON = '0 9 * * *';\n\nconst DEFAULT_INSTRUCTIONS = `\\\nSummarize recent activity in this space into a markdown document.\n\nReview new messages in the inbox and recently changed objects. Produce a short digest grouped by theme,\nhighlight anything that needs attention, and write it to a markdown document titled with the current date.\n`;\n\nexport const dailyDigest: AutomationCapabilities.Template = {\n  id: 'org.dxos.automation.dailyDigest',\n  label: 'Daily Digest',\n  icon: 'ph--list-bullets--regular',\n  scaffold: ({ name }) =>\n    makeScheduledRoutineAutomation({\n      name: name ?? 'Daily Digest',\n      instructions: DEFAULT_INSTRUCTIONS,\n      blueprintKeys: BLUEPRINT_KEYS,\n      cron: DEFAULT_CRON,\n    }),\n};\n", "//\n// Copyright 2026 DXOS.org\n//\n\nimport { type AutomationCapabilities } from '@dxos/plugin-automation';\n\nimport { makeScheduledRoutineAutomation } from './scaffold';\n\n/** The research blueprint drives the brief; web-search, markdown, and database tools support it. */\nconst BLUEPRINT_KEYS = [\n  'org.dxos.blueprint.research',\n  'org.dxos.blueprint.webSearch',\n  'org.dxos.blueprint.markdown',\n  'org.dxos.blueprint.database',\n] as const;\n\n/** Runs weekly by default; the user edits the schedule and the topic by opening the trigger and routine. */\nconst DEFAULT_CRON = '0 9 * * 1';\n\nconst DEFAULT_INSTRUCTIONS = `\\\nResearch the topic below and write a concise brief to a new markdown document.\n\nTopic: (replace with the topic you want tracked)\n\nGather current information with the web-search and research tools. Summarize the key developments, link the\nsources you used, and create a markdown document titled with the topic and the current date.\n`;\n\nexport const researchBrief: AutomationCapabilities.Template = {\n  id: 'org.dxos.automation.researchBrief',\n  label: 'Research Brief',\n  icon: 'ph--newspaper--regular',\n  scaffold: ({ name }) =>\n    makeScheduledRoutineAutomation({\n      name: name ?? 'Research Brief',\n      instructions: DEFAULT_INSTRUCTIONS,\n      blueprintKeys: BLUEPRINT_KEYS,\n      cron: DEFAULT_CRON,\n    }),\n};\n", "//\n// Copyright 2026 DXOS.org\n//\n\nimport { type AutomationCapabilities } from '@dxos/plugin-automation';\n\nimport { dailyDigest } from './daily-digest';\nimport { researchBrief } from './research-brief';\n\n/** Generic, subject-less automation templates contributed alongside plugin-automation's Blank. */\nexport const automationTemplates: AutomationCapabilities.Template[] = [researchBrief, dailyDigest];\n"],
+  "mappings": ";;;AAIA,YAAYA,aAAY;AAExB,SAASC,kBAAkB;AAC3B,SAASC,8BAA8B;;;ACHvC,YAAYC,YAAY;AACxB,YAAYC,YAAY;AAExB,SAASC,mBAAmB;AAC5B,SAASC,WAAWC,WAAWC,SAASC,eAAe;AACvD,SAASC,UAAUC,QAAQC,KAAKC,WAAW;AAC3C,SAASC,kBAAkB;AAG3B,IAAMC,mBAAmB;AAelB,IAAMC,iCAAiC,CAAC,EAC7CC,MACAC,cACAC,eACAC,KAAI,MAEGC,WAAI,aAAA;AACT,QAAMC,aAAaH,cAAcI,IAAI,CAACC,QAAQX,IAAIY,QAAQnB,UAAUoB,YAAYF,GAAAA,CAAAA,CAAAA;AAChF,QAAMG,UAAU,OAAOjB,SAASkB,IAC9BpB,QAAQqB,KAAK;IACXZ;IACAC;;;IAGAY,OAAcC;IACdC,QAAeC;IACfX;IACAY,SAAS,CAAA;EACX,CAAA,CAAA;AAKF,QAAMC,cAAc,OAAOzB,SAAS0B,MAClCzB,OAAO0B,IAAI1B,OAAO2B,KAAK/B,UAAUgC,mBAAmB,GAAG5B,OAAOa,IAAIT,gBAAAA,CAAAA,CAAAA,EAClEyB;AACF,QAAMC,gBAAgBN,YAAY,CAAA,MAAO,OAAOzB,SAASkB,IAAIrB,UAAUmC,UAAUrC,WAAAA,CAAAA;AAEjF,QAAMsC,UAAU,OAAOjC,SAASkB,IAC9BhB,IAAIiB,KAAKpB,QAAQA,SAAS;IACxBmC,SAAS;IACTC,UAAUhC,IAAIgB,KAAKY,aAAAA;IACnBK,MAAMrC,QAAQsC,UAAU3B,IAAAA;IACxBU,OAAO;MAAEkB,QAAQnC,IAAIgB,KAAKF,OAAAA;MAAUG,OAAO,CAAC;IAAE;IAC9CmB,aAAa;EACf,CAAA,CAAA;AAGF,QAAMC,aAAapC,WAAWe,KAAK;IACjCZ;IACAkC,UAAUtC,IAAIgB,KAAKY,aAAAA;IACnBW,UAAU;MAACvC,IAAIgB,KAAKc,OAAAA;;EACtB,CAAA;AACA/B,MAAIyC,UAAUV,SAASO,UAAAA;AACvB,SAAOA;AACT,CAAA;;;AChEF,IAAMI,iBAAiB;EACrB;EACA;EACA;;AAIF,IAAMC,eAAe;AAErB,IAAMC,uBAAuB;;;;;AAOtB,IAAMC,cAA+C;EAC1DC,IAAI;EACJC,OAAO;EACPC,MAAM;EACNC,UAAU,CAAC,EAAEC,KAAI,MACfC,+BAA+B;IAC7BD,MAAMA,QAAQ;IACdE,cAAcR;IACdS,eAAeX;IACfY,MAAMX;EACR,CAAA;AACJ;;;AC3BA,IAAMY,kBAAiB;EACrB;EACA;EACA;EACA;;AAIF,IAAMC,gBAAe;AAErB,IAAMC,wBAAuB;;;;;;;AAStB,IAAMC,gBAAiD;EAC5DC,IAAI;EACJC,OAAO;EACPC,MAAM;EACNC,UAAU,CAAC,EAAEC,KAAI,MACfC,+BAA+B;IAC7BD,MAAMA,QAAQ;IACdE,cAAcR;IACdS,eAAeX;IACfY,MAAMX;EACR,CAAA;AACJ;;;AC7BO,IAAMY,sBAAyD;EAACC;EAAeC;;;;AJCtF,IAAA,+BAAeC,WAAWC,WACjBC,mBAAW,aAAA;AAChB,SAAOC,oBAAoBC,IAAI,CAACC,aAAaL,WAAWM,YAAYC,uBAAuBC,UAAUH,QAAAA,CAAAA;AACvG,CAAA,CAAA;",
+  "names": ["Effect", "Capability", "AutomationCapabilities", "Effect", "Schema", "AgentPrompt", "Blueprint", "Operation", "Routine", "Trigger", "Database", "Filter", "Obj", "Ref", "Automation", "AGENT_PROMPT_KEY", "makeScheduledRoutineAutomation", "name", "instructions", "blueprintKeys", "cron", "gen", "blueprints", "map", "key", "fromURI", "registryURI", "routine", "add", "make", "input", "Unknown", "output", "Void", "context", "existingFns", "query", "and", "type", "PersistentOperation", "run", "agentPromptFn", "serialize", "trigger", "enabled", "function", "spec", "specTimer", "prompt", "concurrency", "automation", "runnable", "triggers", "setParent", "BLUEPRINT_KEYS", "DEFAULT_CRON", "DEFAULT_INSTRUCTIONS", "dailyDigest", "id", "label", "icon", "scaffold", "name", "makeScheduledRoutineAutomation", "instructions", "blueprintKeys", "cron", "BLUEPRINT_KEYS", "DEFAULT_CRON", "DEFAULT_INSTRUCTIONS", "researchBrief", "id", "label", "icon", "scaffold", "name", "makeScheduledRoutineAutomation", "instructions", "blueprintKeys", "cron", "automationTemplates", "researchBrief", "dailyDigest", "Capability", "makeModule", "fnUntraced", "automationTemplates", "map", "template", "contributes", "AutomationCapabilities", "Template"]
+}

package/dist/lib/neutral/blueprint-definition-MH2QLYQH.mjs

@@ -0,0 +1,39 @@
+import "./chunk-J5LGTIGS.mjs";
+
+// src/capabilities/blueprint-definition.ts
+import * as Effect from "effect/Effect";
+import { Capabilities, Capability } from "@dxos/app-framework";
+import { AppCapabilities } from "@dxos/app-toolkit";
+import { AgentBlueprint, AgentBlueprintHandlers, AgentHandlers, AgentWizardBlueprint, AgentWizardHandlers, BlueprintManagerBlueprint, BlueprintManagerHandlers, BrowserBlueprint, DatabaseBlueprint, DatabaseHandlers, DiscordBlueprint, LinearBlueprint, PlanningBlueprint, WebSearchBlueprint, WebSearchHandlers, MemoryBlueprint, AutomationBlueprint, DelegationBlueprint, DelegationHandlers, makeDelegationStrategy } from "@dxos/assistant-toolkit";
+import { AutomationCapabilities } from "@dxos/plugin-automation";
+import { AssistantBlueprint } from "#blueprints";
+var blueprintDefinition = () => Effect.succeed([
+  Capability.contributes(AppCapabilities.BlueprintDefinition, AssistantBlueprint),
+  Capability.contributes(AppCapabilities.BlueprintDefinition, BrowserBlueprint),
+  Capability.contributes(AppCapabilities.BlueprintDefinition, DatabaseBlueprint),
+  Capability.contributes(AppCapabilities.BlueprintDefinition, WebSearchBlueprint),
+  Capability.contributes(AppCapabilities.BlueprintDefinition, DiscordBlueprint),
+  Capability.contributes(AppCapabilities.BlueprintDefinition, LinearBlueprint),
+  Capability.contributes(AppCapabilities.BlueprintDefinition, AgentBlueprint),
+  Capability.contributes(AppCapabilities.BlueprintDefinition, PlanningBlueprint),
+  Capability.contributes(AppCapabilities.BlueprintDefinition, MemoryBlueprint),
+  Capability.contributes(AppCapabilities.BlueprintDefinition, AutomationBlueprint),
+  Capability.contributes(AppCapabilities.BlueprintDefinition, BlueprintManagerBlueprint),
+  Capability.contributes(AppCapabilities.BlueprintDefinition, AgentWizardBlueprint),
+  Capability.contributes(AppCapabilities.BlueprintDefinition, DelegationBlueprint),
+  Capability.contributes(Capabilities.OperationHandler, AgentHandlers),
+  Capability.contributes(Capabilities.OperationHandler, AgentBlueprintHandlers),
+  Capability.contributes(Capabilities.OperationHandler, BlueprintManagerHandlers),
+  Capability.contributes(Capabilities.OperationHandler, DatabaseHandlers),
+  Capability.contributes(Capabilities.OperationHandler, WebSearchHandlers),
+  Capability.contributes(Capabilities.OperationHandler, AgentWizardHandlers),
+  Capability.contributes(Capabilities.OperationHandler, DelegationHandlers),
+  // Run the conversational agent as a supervisor: delegate in-progress plan tasks to sub-agents
+  // and fold their results back into the conversation (consumed by the AgentService LayerSpec).
+  Capability.contributes(AutomationCapabilities.AgentDelegationStrategy, makeDelegationStrategy())
+]);
+var blueprint_definition_default = blueprintDefinition;
+export {
+  blueprint_definition_default as default
+};
+//# sourceMappingURL=blueprint-definition-MH2QLYQH.mjs.map

package/dist/lib/neutral/blueprint-definition-MH2QLYQH.mjs.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/capabilities/blueprint-definition.ts"],
+  "sourcesContent": ["//\n// Copyright 2025 DXOS.org\n//\n\nimport * as Effect from 'effect/Effect';\n\nimport { Capabilities, Capability } from '@dxos/app-framework';\nimport { AppCapabilities } from '@dxos/app-toolkit';\nimport {\n  AgentBlueprint,\n  AgentBlueprintHandlers,\n  AgentHandlers,\n  AgentWizardBlueprint,\n  AgentWizardHandlers,\n  BlueprintManagerBlueprint,\n  BlueprintManagerHandlers,\n  BrowserBlueprint,\n  DatabaseBlueprint,\n  DatabaseHandlers,\n  DiscordBlueprint,\n  LinearBlueprint,\n  PlanningBlueprint,\n  WebSearchBlueprint,\n  WebSearchHandlers,\n  MemoryBlueprint,\n  AutomationBlueprint,\n  DelegationBlueprint,\n  DelegationHandlers,\n  makeDelegationStrategy,\n} from '@dxos/assistant-toolkit';\nimport { AutomationCapabilities } from '@dxos/plugin-automation';\n\nimport { AssistantBlueprint } from '#blueprints';\n\n// NOTE: Explicit annotation required: d.ts emit cannot portably name the inferred @dxos/compute types (TS2883).\nconst blueprintDefinition: () => Effect.Effect<Capability.Capability<unknown>[]> = () =>\n  Effect.succeed([\n    Capability.contributes(AppCapabilities.BlueprintDefinition, AssistantBlueprint),\n    Capability.contributes(AppCapabilities.BlueprintDefinition, BrowserBlueprint),\n    Capability.contributes(AppCapabilities.BlueprintDefinition, DatabaseBlueprint),\n    Capability.contributes(AppCapabilities.BlueprintDefinition, WebSearchBlueprint),\n    Capability.contributes(AppCapabilities.BlueprintDefinition, DiscordBlueprint),\n    Capability.contributes(AppCapabilities.BlueprintDefinition, LinearBlueprint),\n    Capability.contributes(AppCapabilities.BlueprintDefinition, AgentBlueprint),\n    Capability.contributes(AppCapabilities.BlueprintDefinition, PlanningBlueprint),\n    Capability.contributes(AppCapabilities.BlueprintDefinition, MemoryBlueprint),\n    Capability.contributes(AppCapabilities.BlueprintDefinition, AutomationBlueprint),\n    Capability.contributes(AppCapabilities.BlueprintDefinition, BlueprintManagerBlueprint),\n    Capability.contributes(AppCapabilities.BlueprintDefinition, AgentWizardBlueprint),\n    Capability.contributes(AppCapabilities.BlueprintDefinition, DelegationBlueprint),\n\n    Capability.contributes(Capabilities.OperationHandler, AgentHandlers),\n    Capability.contributes(Capabilities.OperationHandler, AgentBlueprintHandlers),\n    Capability.contributes(Capabilities.OperationHandler, BlueprintManagerHandlers),\n    Capability.contributes(Capabilities.OperationHandler, DatabaseHandlers),\n    Capability.contributes(Capabilities.OperationHandler, WebSearchHandlers),\n    Capability.contributes(Capabilities.OperationHandler, AgentWizardHandlers),\n    Capability.contributes(Capabilities.OperationHandler, DelegationHandlers),\n\n    // Run the conversational agent as a supervisor: delegate in-progress plan tasks to sub-agents\n    // and fold their results back into the conversation (consumed by the AgentService LayerSpec).\n    Capability.contributes(AutomationCapabilities.AgentDelegationStrategy, makeDelegationStrategy()),\n  ]);\n\nexport default blueprintDefinition;\n"],
+  "mappings": ";;;AAIA,YAAYA,YAAY;AAExB,SAASC,cAAcC,kBAAkB;AACzC,SAASC,uBAAuB;AAChC,SACEC,gBACAC,wBACAC,eACAC,sBACAC,qBACAC,2BACAC,0BACAC,kBACAC,mBACAC,kBACAC,kBACAC,iBACAC,mBACAC,oBACAC,mBACAC,iBACAC,qBACAC,qBACAC,oBACAC,8BACK;AACP,SAASC,8BAA8B;AAEvC,SAASC,0BAA0B;AAGnC,IAAMC,sBAA6E,MAC1EC,eAAQ;EACbzB,WAAW0B,YAAYzB,gBAAgB0B,qBAAqBJ,kBAAAA;EAC5DvB,WAAW0B,YAAYzB,gBAAgB0B,qBAAqBlB,gBAAAA;EAC5DT,WAAW0B,YAAYzB,gBAAgB0B,qBAAqBjB,iBAAAA;EAC5DV,WAAW0B,YAAYzB,gBAAgB0B,qBAAqBZ,kBAAAA;EAC5Df,WAAW0B,YAAYzB,gBAAgB0B,qBAAqBf,gBAAAA;EAC5DZ,WAAW0B,YAAYzB,gBAAgB0B,qBAAqBd,eAAAA;EAC5Db,WAAW0B,YAAYzB,gBAAgB0B,qBAAqBzB,cAAAA;EAC5DF,WAAW0B,YAAYzB,gBAAgB0B,qBAAqBb,iBAAAA;EAC5Dd,WAAW0B,YAAYzB,gBAAgB0B,qBAAqBV,eAAAA;EAC5DjB,WAAW0B,YAAYzB,gBAAgB0B,qBAAqBT,mBAAAA;EAC5DlB,WAAW0B,YAAYzB,gBAAgB0B,qBAAqBpB,yBAAAA;EAC5DP,WAAW0B,YAAYzB,gBAAgB0B,qBAAqBtB,oBAAAA;EAC5DL,WAAW0B,YAAYzB,gBAAgB0B,qBAAqBR,mBAAAA;EAE5DnB,WAAW0B,YAAY3B,aAAa6B,kBAAkBxB,aAAAA;EACtDJ,WAAW0B,YAAY3B,aAAa6B,kBAAkBzB,sBAAAA;EACtDH,WAAW0B,YAAY3B,aAAa6B,kBAAkBpB,wBAAAA;EACtDR,WAAW0B,YAAY3B,aAAa6B,kBAAkBjB,gBAAAA;EACtDX,WAAW0B,YAAY3B,aAAa6B,kBAAkBZ,iBAAAA;EACtDhB,WAAW0B,YAAY3B,aAAa6B,kBAAkBtB,mBAAAA;EACtDN,WAAW0B,YAAY3B,aAAa6B,kBAAkBR,kBAAAA;;;EAItDpB,WAAW0B,YAAYJ,uBAAuBO,yBAAyBR,uBAAAA,CAAAA;CACxE;AAEH,IAAA,+BAAeG;",
+  "names": ["Effect", "Capabilities", "Capability", "AppCapabilities", "AgentBlueprint", "AgentBlueprintHandlers", "AgentHandlers", "AgentWizardBlueprint", "AgentWizardHandlers", "BlueprintManagerBlueprint", "BlueprintManagerHandlers", "BrowserBlueprint", "DatabaseBlueprint", "DatabaseHandlers", "DiscordBlueprint", "LinearBlueprint", "PlanningBlueprint", "WebSearchBlueprint", "WebSearchHandlers", "MemoryBlueprint", "AutomationBlueprint", "DelegationBlueprint", "DelegationHandlers", "makeDelegationStrategy", "AutomationCapabilities", "AssistantBlueprint", "blueprintDefinition", "succeed", "contributes", "BlueprintDefinition", "OperationHandler", "AgentDelegationStrategy"]
+}

package/dist/lib/{browser → neutral}/blueprints/index.mjs

@@ -1,6 +1,6 @@
 import {
   blueprint_default
-} from "../chunk-EZRS3J25.mjs";
+} from "../chunk-5H6UJHLF.mjs";
 import "../chunk-J5LGTIGS.mjs";
 export {
   blueprint_default as AssistantBlueprint

package/dist/lib/neutral/capabilities/index.mjs

@@ -0,0 +1,45 @@
+import "../chunk-J5LGTIGS.mjs";
+
+// src/capabilities/index.ts
+import { Capability } from "@dxos/app-framework";
+var AgentHydrator = Capability.lazy("AgentHydrator", () => import("../agent-hydrator-PJBYVMBW.mjs"));
+var AgentRuntime = Capability.lazy("AgentRuntime", () => import("../agent-service-WCAP5MLI.mjs"));
+var AiContext = Capability.lazy("AiContext", () => import("../ai-context-7WRHWYXY.mjs"));
+var AiService = Capability.lazy("AiService", () => import("../ai-service-AADUIKBY.mjs"));
+var IntegrationProvider = Capability.lazy("AnthropicIntegrationProvider", () => import("../integration-provider-RBD3AFJU.mjs"));
+var AppGraphBuilder = Capability.lazy("AppGraphBuilder", () => import("../app-graph-builder-WUFHQH3Y.mjs"));
+var AutomationTemplates = Capability.lazy("AutomationTemplates", () => import("../automation-templates-M2XQWGR6.mjs"));
+var BlueprintDefinition = Capability.lazy("BlueprintDefinition", () => import("../blueprint-definition-MH2QLYQH.mjs"));
+var CompanionChatProvisioner = Capability.lazy("CompanionChatProvisioner", () => import("../companion-chat-provisioner-YZZ73P6E.mjs"));
+var CreateObject = Capability.lazy("CreateObject", () => import("../create-object-U2SOFZLR.mjs"));
+var EdgeModelResolver = Capability.lazy("EdgeModelResolver", () => import("../edge-model-resolver-BBVOJBGJ.mjs"));
+var LocalModelResolver = Capability.lazy("LocalModelResolver", () => import("../local-model-resolver-I2BENFFS.mjs"));
+var MarkdownExtension = Capability.lazy("MarkdownExtension", () => import("../markdown-extension-YMIFDMYF.mjs"));
+var Migrations = Capability.lazy("AssistantMigrations", () => import("../migrations-7DEMVBOG.mjs"));
+var OperationHandler = Capability.lazy("OperationHandler", () => import("../operation-handler-SF36MOB5.mjs"));
+var ReactSurface = Capability.lazy("ReactSurface", () => import("../react-surface-XRTBW5OJ.mjs"));
+var Settings = Capability.lazy("Settings", () => import("../settings-W4BLWQ53.mjs"));
+var AssistantState = Capability.lazy("AssistantState", () => import("../state-H3G7QCU6.mjs"));
+var Toolkit = Capability.lazy("Toolkit", () => import("../toolkit-GVWXPDLJ.mjs"));
+export {
+  AgentHydrator,
+  AgentRuntime,
+  AiContext,
+  AiService,
+  AppGraphBuilder,
+  AssistantState,
+  AutomationTemplates,
+  BlueprintDefinition,
+  CompanionChatProvisioner,
+  CreateObject,
+  EdgeModelResolver,
+  IntegrationProvider,
+  LocalModelResolver,
+  MarkdownExtension,
+  Migrations,
+  OperationHandler,
+  ReactSurface,
+  Settings,
+  Toolkit
+};
+//# sourceMappingURL=index.mjs.map

package/dist/lib/neutral/capabilities/index.mjs.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/capabilities/index.ts"],
+  "sourcesContent": ["//\n// Copyright 2025 DXOS.org\n//\n\nimport { Capability } from '@dxos/app-framework';\nimport type { OperationHandlerSet } from '@dxos/compute';\nimport { AutomationCapabilities } from '@dxos/plugin-automation';\n\nimport type { AssistantPluginOptions } from '#types';\n\nexport const AgentHydrator = Capability.lazy('AgentHydrator', () => import('./agent-hydrator'));\nexport const AgentRuntime = Capability.lazy<void, Capability.Any[]>('AgentRuntime', () => import('./agent-service'));\nexport const AiContext = Capability.lazy<void, Capability.Any[]>('AiContext', () => import('./ai-context'));\nexport const AiService = Capability.lazy<AssistantPluginOptions | void, Capability.Any[]>(\n  'AiService',\n  () => import('./ai-service'),\n);\nexport const IntegrationProvider = Capability.lazy(\n  'AnthropicIntegrationProvider',\n  () => import('./integration-provider'),\n);\nexport const AppGraphBuilder = Capability.lazy('AppGraphBuilder', () => import('./app-graph-builder'));\n// Explicit annotation: the contributed capability type references `Template` from @dxos/plugin-automation,\n// so the inferred lazy type needs annotating to stay portable (TS2883).\nexport const AutomationTemplates: Capability.LazyCapability<\n  void,\n  Capability.Capability<typeof AutomationCapabilities.Template>[]\n> = Capability.lazy('AutomationTemplates', () => import('./automation-templates'));\nexport const BlueprintDefinition = Capability.lazy('BlueprintDefinition', () => import('./blueprint-definition'));\nexport const CompanionChatProvisioner = Capability.lazy(\n  'CompanionChatProvisioner',\n  () => import('./companion-chat-provisioner'),\n);\nexport const CreateObject = Capability.lazy('CreateObject', () => import('./create-object'));\nexport const EdgeModelResolver = Capability.lazy('EdgeModelResolver', () => import('./edge-model-resolver'));\nexport const LocalModelResolver = Capability.lazy('LocalModelResolver', () => import('./local-model-resolver'));\nexport const MarkdownExtension = Capability.lazy('MarkdownExtension', () => import('./markdown-extension'));\nexport const Migrations = Capability.lazy('AssistantMigrations', () => import('./migrations'));\nexport const OperationHandler = Capability.lazy<OperationHandlerSet.OperationHandlerSet>(\n  'OperationHandler',\n  () => import('./operation-handler'),\n);\nexport const ReactSurface = Capability.lazy('ReactSurface', () => import('./react-surface'));\nexport const Settings = Capability.lazy('Settings', () => import('./settings'));\nexport const AssistantState = Capability.lazy('AssistantState', () => import('./state'));\nexport const Toolkit = Capability.lazy('Toolkit', () => import('./toolkit'));\n"],
+  "mappings": ";;;AAIA,SAASA,kBAAkB;AAMpB,IAAMC,gBAAgBD,WAAWE,KAAK,iBAAiB,MAAM,OAAO,gCAAA,CAAA;AACpE,IAAMC,eAAeH,WAAWE,KAA6B,gBAAgB,MAAM,OAAO,+BAAA,CAAA;AAC1F,IAAME,YAAYJ,WAAWE,KAA6B,aAAa,MAAM,OAAO,4BAAA,CAAA;AACpF,IAAMG,YAAYL,WAAWE,KAClC,aACA,MAAM,OAAO,4BAAA,CAAA;AAER,IAAMI,sBAAsBN,WAAWE,KAC5C,gCACA,MAAM,OAAO,sCAAA,CAAA;AAER,IAAMK,kBAAkBP,WAAWE,KAAK,mBAAmB,MAAM,OAAO,mCAAA,CAAA;AAGxE,IAAMM,sBAGTR,WAAWE,KAAK,uBAAuB,MAAM,OAAO,sCAAA,CAAA;AACjD,IAAMO,sBAAsBT,WAAWE,KAAK,uBAAuB,MAAM,OAAO,sCAAA,CAAA;AAChF,IAAMQ,2BAA2BV,WAAWE,KACjD,4BACA,MAAM,OAAO,4CAAA,CAAA;AAER,IAAMS,eAAeX,WAAWE,KAAK,gBAAgB,MAAM,OAAO,+BAAA,CAAA;AAClE,IAAMU,oBAAoBZ,WAAWE,KAAK,qBAAqB,MAAM,OAAO,qCAAA,CAAA;AAC5E,IAAMW,qBAAqBb,WAAWE,KAAK,sBAAsB,MAAM,OAAO,sCAAA,CAAA;AAC9E,IAAMY,oBAAoBd,WAAWE,KAAK,qBAAqB,MAAM,OAAO,oCAAA,CAAA;AAC5E,IAAMa,aAAaf,WAAWE,KAAK,uBAAuB,MAAM,OAAO,4BAAA,CAAA;AACvE,IAAMc,mBAAmBhB,WAAWE,KACzC,oBACA,MAAM,OAAO,mCAAA,CAAA;AAER,IAAMe,eAAejB,WAAWE,KAAK,gBAAgB,MAAM,OAAO,+BAAA,CAAA;AAClE,IAAMgB,WAAWlB,WAAWE,KAAK,YAAY,MAAM,OAAO,0BAAA,CAAA;AAC1D,IAAMiB,iBAAiBnB,WAAWE,KAAK,kBAAkB,MAAM,OAAO,uBAAA,CAAA;AACtE,IAAMkB,UAAUpB,WAAWE,KAAK,WAAW,MAAM,OAAO,yBAAA,CAAA;",
+  "names": ["Capability", "AgentHydrator", "lazy", "AgentRuntime", "AiContext", "AiService", "IntegrationProvider", "AppGraphBuilder", "AutomationTemplates", "BlueprintDefinition", "CompanionChatProvisioner", "CreateObject", "EdgeModelResolver", "LocalModelResolver", "MarkdownExtension", "Migrations", "OperationHandler", "ReactSurface", "Settings", "AssistantState", "Toolkit"]
+}

package/dist/lib/{browser/chunk-EZRS3J25.mjs → neutral/chunk-5H6UJHLF.mjs}

@@ -1,8 +1,8 @@
 // src/blueprints/assistant/blueprint.ts
 import { LayoutOperation } from "@dxos/app-toolkit";
 import { templates } from "@dxos/assistant";
-import { Blueprint } from "@dxos/blueprints";
-import { AssistantOperation } from "#operations";
+import { Blueprint } from "@dxos/compute";
+import { AssistantOperation } from "#types";
 var BLUEPRINT_KEY = "org.dxos.blueprint.assistant";
 var make = () => Blueprint.make({
   key: BLUEPRINT_KEY,
@@ -27,4 +27,4 @@ var blueprint_default = blueprint;
 export {
   blueprint_default
 };
-//# sourceMappingURL=chunk-EZRS3J25.mjs.map
+//# sourceMappingURL=chunk-5H6UJHLF.mjs.map

package/dist/lib/neutral/chunk-5H6UJHLF.mjs.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/blueprints/assistant/blueprint.ts"],
+  "sourcesContent": ["//\n// Copyright 2025 DXOS.org\n//\n\nimport { LayoutOperation } from '@dxos/app-toolkit';\nimport { templates } from '@dxos/assistant';\nimport { Blueprint } from '@dxos/compute';\n\nimport { AssistantOperation } from '#types';\n\nconst BLUEPRINT_KEY = 'org.dxos.blueprint.assistant';\n\nconst make = () =>\n  Blueprint.make({\n    key: BLUEPRINT_KEY,\n    name: 'Assistant',\n    tools: Blueprint.toolDefinitions({\n      // TODO(wittjosiah): LayoutOperation.Open requires Capability.Service which is only available\n      //   via the compute-runtime layer (plugin-automation). Once Capability.Service is propagated\n      //   through LocalFunctionExecutionService, this will work without the compute-runtime dependency.\n      operations: [LayoutOperation.Open, AssistantOperation.ResolveNavigationTargets],\n    }),\n    instructions: templates.system,\n  });\n\nconst blueprint: Blueprint.Definition = {\n  key: BLUEPRINT_KEY,\n  make,\n};\n\nexport default blueprint;\n"],
+  "mappings": ";AAIA,SAASA,uBAAuB;AAChC,SAASC,iBAAiB;AAC1B,SAASC,iBAAiB;AAE1B,SAASC,0BAA0B;AAEnC,IAAMC,gBAAgB;AAEtB,IAAMC,OAAO,MACXH,UAAUG,KAAK;EACbC,KAAKF;EACLG,MAAM;EACNC,OAAON,UAAUO,gBAAgB;;;;IAI/BC,YAAY;MAACV,gBAAgBW;MAAMR,mBAAmBS;;EACxD,CAAA;EACAC,cAAcZ,UAAUa;AAC1B,CAAA;AAEF,IAAMC,YAAkC;EACtCT,KAAKF;EACLC;AACF;AAEA,IAAA,oBAAeU;",
+  "names": ["LayoutOperation", "templates", "Blueprint", "AssistantOperation", "BLUEPRINT_KEY", "make", "key", "name", "tools", "toolDefinitions", "operations", "Open", "ResolveNavigationTargets", "instructions", "system", "blueprint"]
+}

package/dist/lib/neutral/chunk-HLANPOBA.mjs

@@ -0,0 +1,10 @@
+// src/paths.ts
+import { createTypeSectionPaths } from "@dxos/app-toolkit";
+import { Chat } from "@dxos/assistant-toolkit";
+var { getSectionPath: getChatsPath, getObjectPath: getChatPath } = createTypeSectionPaths(Chat.Chat);
+
+export {
+  getChatsPath,
+  getChatPath
+};
+//# sourceMappingURL=chunk-HLANPOBA.mjs.map

package/dist/lib/neutral/chunk-HLANPOBA.mjs.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/paths.ts"],
+  "sourcesContent": ["//\n// Copyright 2025 DXOS.org\n//\n\nimport { createTypeSectionPaths } from '@dxos/app-toolkit';\nimport { Chat } from '@dxos/assistant-toolkit';\n\nconst { getSectionPath: getChatsPath, getObjectPath: getChatPath } = createTypeSectionPaths(Chat.Chat);\n\nexport { getChatsPath, getChatPath };\n"],
+  "mappings": ";AAIA,SAASA,8BAA8B;AACvC,SAASC,YAAY;AAErB,IAAM,EAAEC,gBAAgBC,cAAcC,eAAeC,YAAW,IAAKL,uBAAuBC,KAAKA,IAAI;",
+  "names": ["createTypeSectionPaths", "Chat", "getSectionPath", "getChatsPath", "getObjectPath", "getChatPath"]
+}

package/dist/lib/neutral/chunk-KLYLW4WH.mjs

@@ -0,0 +1,9 @@
+// src/constants.ts
+var ANTHROPIC_PROVIDER_ID = "anthropic";
+var ANTHROPIC_SOURCE = "anthropic.com";
+
+export {
+  ANTHROPIC_PROVIDER_ID,
+  ANTHROPIC_SOURCE
+};
+//# sourceMappingURL=chunk-KLYLW4WH.mjs.map

package/dist/lib/neutral/chunk-KLYLW4WH.mjs.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/constants.ts"],
+  "sourcesContent": ["//\n// Copyright 2026 DXOS.org\n//\n\n/** Stable id used by `plugin-integration` to look up the Anthropic provider entry. */\nexport const ANTHROPIC_PROVIDER_ID = 'anthropic';\n\n/** Source string used in `AccessToken.source` and matched by `Header.byokLayer('anthropic.com')`. */\nexport const ANTHROPIC_SOURCE = 'anthropic.com';\n"],
+  "mappings": ";AAKO,IAAMA,wBAAwB;AAG9B,IAAMC,mBAAmB;",
+  "names": ["ANTHROPIC_PROVIDER_ID", "ANTHROPIC_SOURCE"]
+}

package/dist/lib/neutral/chunk-QAZMOFPI.mjs

@@ -0,0 +1,130 @@
+// src/AssistantPlugin.ts
+import { ActivationEvent, ActivationEvents, Capability, Plugin } from "@dxos/app-framework";
+import { AppActivationEvents, AppPlugin } from "@dxos/app-toolkit";
+import { AiContext } from "@dxos/assistant";
+import { Agent, Chat, McpServer, Memory, Plan } from "@dxos/assistant-toolkit";
+import { Blueprint, Routine } from "@dxos/compute";
+import { Sequence } from "@dxos/conductor";
+import { Feed } from "@dxos/echo";
+import { ClientEvents } from "@dxos/plugin-client";
+import { DeckEvents } from "@dxos/plugin-deck";
+import { MarkdownEvents } from "@dxos/plugin-markdown";
+import { Text } from "@dxos/schema";
+import { HasSubject, Message } from "@dxos/types";
+import { AgentHydrator, AgentRuntime, AiContext as AiContextCapability, AiService, IntegrationProvider, AppGraphBuilder, AutomationTemplates, AssistantState, BlueprintDefinition, CompanionChatProvisioner, CreateObject, EdgeModelResolver, LocalModelResolver, MarkdownExtension, Migrations, OperationHandler, ReactSurface, Settings, Toolkit } from "#capabilities";
+import { meta } from "#meta";
+import { translations } from "#translations";
+import { AssistantEvents } from "#types";
+
+// raw-loader:/__w/dxos/dxos/packages/plugins/plugin-assistant/PLUGIN.mdl?raw
+var PLUGIN_default = '---\nid: org.dxos.plugin.assistant\nname: AssistantPlugin\nversion: 0.1.0\n---\n\nAn AI assistant plugin for DXOS Composer that provides conversational AI, blueprint-driven automation,\nmulti-provider LLM support, and deep ECHO integration.\n\n## Extensions\n\nThe following extension dialects are used in this document.\nEach extension is defined in the Appendix or resolved via its URI.\n\n| Term        | URI                           |\n|-------------|-------------------------------|\n| `type`      | `org.dxos.mdl.type@1.0`      |\n| `feat`      | `org.dxos.mdl.feat@1.0`      |\n| `test`      | `org.dxos.mdl.test@1.0`      |\n| `component` | `org.dxos.mdl.component@1.0` |\n| `op`        | `org.dxos.mdl.op@1.0`        |\n\n## Types\n\n```mdl\ntype ModelProvider\n  literals: edge | ollama | lmstudio\n```\n\n```mdl\ntype ChatView\n  literals: normal | summary | thinking | debug\n```\n\n```mdl\ntype ModelDefaults\n  fields:\n    edge?: string\n    ollama?: string\n    lmstudio?: string\n```\n\n```mdl\ntype Settings\n  fields:\n    customPrompts?: boolean\n    chatView?: ChatView\n    modelProvider?: ModelProvider\n    modelDefaults?: ModelDefaults\n    tracePanelDebug?: boolean\n```\n\n```mdl\ntype Chat\n  fields:\n    id: string\n    name?: string\n    messages: Message[]\n```\n\n```mdl\ntype Message\n  fields:\n    id: string\n    role: user | assistant | system\n    content: string\n    timestamp: string\n```\n\n```mdl\ntype NavigationTarget\n  fields:\n    path: string\n    label: string\n    type: string\n```\n\n```mdl\ntype BlueprintForm\n  fields:\n    key: string\n    name: string\n    description?: string\n```\n\n## Components\n\n```mdl\ncomponent ChatPanel\n  desc: Main conversational interface for interacting with the AI assistant.\n  props:\n    chat: Chat\n    companionTo?: Obj\n  state:\n    messages: Message[]\n    pending: boolean\n    view: ChatView\n  slots:\n    toolbar?: ReactNode\n    empty?: ReactNode\n  actions:\n    sendMessage(content: string)\n    clearHistory()\n    switchView(view: ChatView)\n  emits:\n    onMessage(message: Message)\n  layout: |\n    \u250C\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2510\n    \u2502 [toolbar slot]          \u2502\n    \u251C\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2524\n    \u2502                         \u2502\n    \u2502  message list           \u2502\n    \u2502  [empty slot]           \u2502\n    \u2502                         \u2502\n    \u251C\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2524\n    \u2502  input + send           \u2502\n    \u2514\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2518\n```\n\n```mdl\ncomponent TracePanel\n  desc: Displays the execution trace of an AI operation as a commit graph or raw JSON.\n  props:\n    chat: Chat\n  state:\n    debug: boolean\n  actions:\n    toggleDebug()\n  layout: |\n    \u250C\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2510\n    \u2502 trace / span tree       \u2502\n    \u2514\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2518\n```\n\n```mdl\ncomponent AssistantSettings\n  desc: Settings panel for configuring the AI model provider, model defaults, and chat view.\n  props:\n    settings: Settings\n  emits:\n    onChange(settings: Settings)\n```\n\n## Operations\n\n```mdl\nop CreateChat\n  desc: Creates a new Chat object and optionally adds it to the active space.\n  input:\n    db: Database\n    name?: string\n    addToSpace?: boolean\n  output: Chat\n  effects: [echo:write]\n```\n\n```mdl\nop UpdateChatName\n  desc: Automatically derives and updates the name of a chat using the AI service.\n  input:\n    chat: Chat\n  output: void\n  effects: [echo:write, ai:infer]\n```\n\n```mdl\nop SetCurrentChat\n  desc: Associates a primary object with a specific companion chat in session state.\n  input:\n    companionTo: Obj\n    chat?: Chat\n  output: void\n```\n\n```mdl\nop RunPromptInNewChat\n  desc: Creates a new chat, binds context objects and blueprints, then runs a prompt.\n  input:\n    db: Database\n    objects?: Obj[]\n    blueprints?: string[]\n    prompt: string | RoutineRef\n    background?: boolean\n  output: Chat\n  effects: [echo:write, ai:infer]\n  note: |\n    When background is true, the prompt runs via the compute runtime without\n    opening the chat UI. The returned Chat can be used to track progress.\n```\n\n```mdl\nop EnsureCompanionChat\n  desc: Returns the companion chat for an object, creating one if none exists.\n  input:\n    db: Database\n    companionTo: Obj\n  output:\n    chat: Chat\n    persisted: boolean\n  effects: [echo:write]\n```\n\n```mdl\nop ResolveNavigationTargets\n  desc: Returns navigation paths for objects in the active space, optionally filtered by DXN.\n  input:\n    query?:\n      dxn?: DXN\n  output:\n    targets: NavigationTarget[]\n```\n\n```mdl\nop OnCreateSpace\n  desc: Provisions initial assistant objects when a new space is created.\n  input:\n    space: Space\n    rootCollection: Collection\n  output: void\n  effects: [echo:write]\n```\n\n```mdl\nop ToggleTracePanelDebug\n  desc: Toggles the trace panel between commit-graph and raw JSON debug view.\n  input:\n    state?: boolean\n  output: boolean\n```\n\n## Features\n\n```mdl\nfeat F-1: AI Chat\n\n  req F-1.1: User can create a new Chat object in any space.\n  req F-1.2: User can type a message and receive a streamed AI response.\n  req F-1.3: Chat history is persisted to ECHO and replicated to all peers.\n  req F-1.4:\n    when: chat has enough messages\n    then: chat name is automatically derived from the conversation\n```\n\n```mdl\nfeat F-2: Companion Chat\n\n  req F-2.1:\n    when: user opens an object that supports companions\n    then: a companion chat panel is shown alongside the object\n  req F-2.2:\n    when: companion chat does not yet exist\n    then: op:EnsureCompanionChat creates one and optionally persists it\n  req F-2.3:\n    when: user sends a message in the companion chat\n    then: the primary object is automatically bound as AI context\n```\n\n```mdl\nfeat F-3: Blueprint System\n\n  req F-3.1: Blueprints define named AI configurations (instructions, tools, model).\n  req F-3.2: Built-in blueprints include: Assistant, Browser, Database, WebSearch, Discord, Linear, Agent, Planning, Memory, Automation, BlueprintManager, AgentWizard.\n  req F-3.3:\n    when: user selects a blueprint for a chat\n    then: chat uses that blueprint\'s instructions and tool set\n  req F-3.4: op:RunPromptInNewChat accepts blueprint keys to bind before sending the prompt.\n```\n\n```mdl\nfeat F-4: Multi-Provider LLM\n\n  req F-4.1: Supported providers: DXOS Edge (remote), Ollama (local), LM Studio (local).\n  req F-4.2: User can configure the active provider and per-provider default model in Settings.\n  req F-4.3:\n    when: the active provider is unavailable\n    then: AiService falls back to the next registered resolver\n```\n\n```mdl\nfeat F-5: Tool Execution\n\n  req F-5.1: The assistant blueprint exposes LayoutOperation.Open and ResolveNavigationTargets as tools.\n  req F-5.2: Web search tool is registered via WebSearchToolkit.\n  req F-5.3:\n    when: AI invokes a tool during a conversation\n    then: operation is dispatched via the compute runtime and result returned to the model\n```\n\n```mdl\nfeat F-6: ECHO Integration\n\n  req F-6.1: Chat, CompanionTo, Blueprint, Feed, Message, Memory, Plan, Routine, Agent, McpServer, and Sequence schemas are registered with ECHO.\n  req F-6.2:\n    when: a new space is created\n    then: op:OnCreateSpace provisions default assistant objects\n  req F-6.3: AiContext.Binding schema supports binding ECHO objects as named context variables in a conversation.\n```\n\n```mdl\nfeat F-7: Execution Trace\n\n  req F-7.1: Every AI operation produces a structured span tree captured in the TracePanel.\n  req F-7.2: User can toggle between commit-graph and raw JSON views via op:ToggleTracePanelDebug.\n```\n\n## Acceptance\n\n```mdl\ntest T-1: Create chat and send message\n  given: a space is open and the assistant plugin is active\n  when: user creates a new Chat and sends "Hello"\n  then:\n    - Chat object appears in the space\n    - AI response is appended to Chat.messages\n    - Chat is persisted to ECHO\n```\n\n```mdl\ntest T-2: Companion chat provisioning\n  given: user opens a document with no companion chat\n  when: companion panel initializes\n  then:\n    - op:EnsureCompanionChat creates a new Chat\n    - persisted === false until user sends a message\n```\n\n```mdl\ntest T-3: Blueprint binding\n  given: a chat exists\n  when: user binds the "WebSearch" blueprint key\n  then:\n    - blueprint instructions are applied to the next AI request\n    - web search tool is available in the tool list\n```\n\n```mdl\ntest T-4: Model provider switch\n  given: assistant settings are open\n  when: user switches provider from edge to ollama\n  then:\n    - Settings.modelProvider === ollama\n    - next AI request is routed to the Ollama resolver\n```\n\n```mdl\ntest T-5: Run prompt in background\n  given: a database and a prompt string are available\n  when: op:RunPromptInNewChat is called with background: true\n  then:\n    - a new Chat is created and returned\n    - the prompt runs via compute runtime without opening the UI\n```\n\n```mdl\ntest T-6: Navigation target resolution\n  given: active space contains documents and collections\n  when: op:ResolveNavigationTargets is called with no query\n  then:\n    - returned targets include paths for all top-level navigable objects\n    - each target has a non-empty label and type\n```\n\n```mdl\ntest T-7: Trace panel debug toggle\n  given: trace panel is showing commit-graph view\n  when: op:ToggleTracePanelDebug is invoked with no argument\n  then:\n    - tracePanelDebug setting flips to true\n    - trace panel switches to raw JSON view\n```\n\n---\n\n## Appendix: Extension Definitions\n\nExtension block types used in this document are defined below using\nthe core `ext` primitive \u2014 the only construct the base language provides.\n\n```mdl\next type\n  uri: org.dxos.mdl.type@1.0\n  desc: A named data structure with typed fields and optional literals.\n  fields:\n    desc?: Prose\n    fields?: FieldMap\n    literals?: UnionList\n    extends?: TypeRef[]\n```\n\n```mdl\next feat\n  uri: org.dxos.mdl.feat@1.0\n  desc: A named feature grouping one or more requirements.\n  fields:\n    desc?: Prose\n    req: RequirementList\n  nesting: self\n```\n\n```mdl\next test\n  uri: org.dxos.mdl.test@1.0\n  desc: An acceptance scenario expressed as given / when / then steps.\n  fields:\n    given?: Step | Step[]\n    when?: Step | Step[]\n    then: Step | Step[]\n    tags?: TagList\n```\n\n```mdl\next component\n  uri: org.dxos.mdl.component@1.0\n  desc: A UI component with props, internal state, slots, actions, and events.\n  fields:\n    desc?: Prose\n    props?: FieldMap\n    state?: FieldMap\n    slots?: FieldMap\n    actions?: ActionMap\n    emits?: EventMap\n    layout?: CodeBlock\n```\n\n```mdl\next op\n  uri: org.dxos.mdl.op@1.0\n  desc: |\n    A named operation with typed inputs, outputs, and declared errors.\n    Pure ops have no effects or requires. Effectful ops declare both.\n  fields:\n    desc?: Prose\n    input?: FieldMap\n    output?: TypeExpr\n    errors?: ErrorMap\n    effects?: EffectList\n    requires?: ServiceList\n    note?: Prose\n```\n';
+
+// src/AssistantPlugin.ts
+var StateReady = AppActivationEvents.createStateEvent(meta.id);
+var AssistantPlugin = Plugin.define(meta).pipe(AppPlugin.addAppGraphModule({
+  activate: AppGraphBuilder
+}), AppPlugin.addBlueprintDefinitionModule({
+  activate: BlueprintDefinition
+}), AppPlugin.addCreateObjectModule({
+  activate: CreateObject
+}), AppPlugin.addOperationHandlerModule({
+  activate: OperationHandler
+}), AppPlugin.addSchemaModule({
+  schema: [
+    Chat.Chat,
+    Chat.CompanionTo,
+    Blueprint.Blueprint,
+    AiContext.Binding,
+    Feed.Feed,
+    HasSubject.HasSubject,
+    Message.Message,
+    Routine.Routine,
+    Agent.Agent,
+    McpServer.McpServer,
+    Plan.Plan,
+    Sequence.Sequence,
+    Memory.Memory,
+    Text.Text
+  ]
+}), AppPlugin.addSettingsModule({
+  activate: Settings
+}), AppPlugin.addSurfaceModule({
+  activate: ReactSurface,
+  firesBeforeActivation: [
+    AppActivationEvents.SetupArtifactDefinition
+  ]
+}), AppPlugin.addTranslationsModule({
+  translations
+}), Plugin.addModule({
+  id: "automation-templates",
+  activatesOn: AppActivationEvents.SetupSchema,
+  activate: AutomationTemplates
+}), Plugin.addModule({
+  id: "markdown",
+  activatesOn: MarkdownEvents.SetupExtensions,
+  activate: MarkdownExtension
+}), Plugin.addModule({
+  // TODO(wittjosiah): Does not integrate with settings store.
+  //   Should this be a different event?
+  //   Should settings store be renamed to be more generic?
+  activatesOn: AppActivationEvents.SetupSettings,
+  firesAfterActivation: [
+    StateReady
+  ],
+  activate: AssistantState
+}), Plugin.addModule({
+  activatesOn: AssistantEvents.SetupAiServiceProviders,
+  activate: EdgeModelResolver
+}), Plugin.addModule({
+  activatesOn: AssistantEvents.SetupAiServiceProviders,
+  activate: LocalModelResolver
+}), Plugin.addModule((options) => ({
+  id: Capability.getModuleTag(AiService),
+  firesBeforeActivation: [
+    AssistantEvents.SetupAiServiceProviders
+  ],
+  // TODO(dmaretskyi): This should activate lazily when the AI chat is used.
+  activatesOn: ActivationEvents.SetupProcessManager,
+  activate: () => AiService(options)
+})), Plugin.addModule({
+  // Process-affinity `AiContext.Service` LayerSpec — needed so operations
+  // dispatched as their own processes (e.g. via `Operation.invoke` from
+  // `AiSession.createRequest` or `TriggerDispatcher`) can resolve
+  // conversation-scoped services without an inline `Effect.provideService`
+  // upstream. See `capabilities/ai-context.ts` for the rationale.
+  activatesOn: ActivationEvents.SetupProcessManager,
+  activate: AiContextCapability
+}), Plugin.addModule({
+  activatesOn: ActivationEvents.SetupProcessManager,
+  activate: AgentRuntime
+})).pipe(Plugin.addModule({
+  // TODO(wittjosiah): Use a different event.
+  activatesOn: ActivationEvents.Startup,
+  activate: Toolkit
+}), Plugin.addModule({
+  activatesOn: ActivationEvents.ProcessManagerReady,
+  activate: AgentHydrator
+}), Plugin.addModule({
+  activatesOn: ActivationEvent.allOf(ActivationEvents.ProcessManagerReady, AppActivationEvents.AppGraphReady, DeckEvents.StateReady, StateReady),
+  activate: CompanionChatProvisioner
+}), Plugin.addModule({
+  activatesOn: ClientEvents.SetupMigration,
+  activate: Migrations
+}), Plugin.addModule({
+  activatesOn: AppActivationEvents.SetupIntegrationProviders,
+  activate: IntegrationProvider
+}), AppPlugin.addPluginAssetModule({
+  asset: {
+    pluginId: meta.id,
+    path: "PLUGIN.mdl",
+    content: PLUGIN_default,
+    mimeType: "application/x-mdl"
+  }
+}), Plugin.make);
+var AssistantPlugin_default = AssistantPlugin;
+
+export {
+  AssistantPlugin,
+  AssistantPlugin_default
+};
+//# sourceMappingURL=chunk-QAZMOFPI.mjs.map

package/dist/lib/neutral/chunk-QAZMOFPI.mjs.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/AssistantPlugin.ts", "raw-loader:/__w/dxos/dxos/packages/plugins/plugin-assistant/PLUGIN.mdl?raw"],
+  "sourcesContent": ["//\n// Copyright 2023 DXOS.org\n//\n\nimport { ActivationEvent, ActivationEvents, Capability, Plugin } from '@dxos/app-framework';\nimport { AppActivationEvents, AppPlugin } from '@dxos/app-toolkit';\nimport { AiContext } from '@dxos/assistant';\nimport { Agent, Chat, McpServer, Memory, Plan } from '@dxos/assistant-toolkit';\nimport { Blueprint, Routine } from '@dxos/compute';\nimport { Sequence } from '@dxos/conductor';\nimport { Feed } from '@dxos/echo';\nimport { ClientEvents } from '@dxos/plugin-client';\nimport { DeckEvents } from '@dxos/plugin-deck';\nimport { MarkdownEvents } from '@dxos/plugin-markdown';\nimport { Text } from '@dxos/schema';\nimport { HasSubject, Message } from '@dxos/types';\n\nimport {\n  AgentHydrator,\n  AgentRuntime,\n  AiContext as AiContextCapability,\n  AiService,\n  IntegrationProvider,\n  AppGraphBuilder,\n  AutomationTemplates,\n  AssistantState,\n  BlueprintDefinition,\n  CompanionChatProvisioner,\n  CreateObject,\n  EdgeModelResolver,\n  LocalModelResolver,\n  MarkdownExtension,\n  Migrations,\n  OperationHandler,\n  ReactSurface,\n  Settings,\n  Toolkit,\n} from '#capabilities';\nimport { meta } from '#meta';\nimport { translations } from '#translations';\nimport { AssistantEvents, type AssistantPluginOptions } from '#types';\n\n// eslint-disable-next-line import/no-relative-packages\nimport pluginSpec from '../PLUGIN.mdl?raw';\n\nconst StateReady = AppActivationEvents.createStateEvent(meta.id);\n\nexport const AssistantPlugin = Plugin.define<AssistantPluginOptions | void>(meta)\n  .pipe(\n    AppPlugin.addAppGraphModule({ activate: AppGraphBuilder }),\n    AppPlugin.addBlueprintDefinitionModule({ activate: BlueprintDefinition }),\n    AppPlugin.addCreateObjectModule({ activate: CreateObject }),\n    AppPlugin.addOperationHandlerModule({ activate: OperationHandler }),\n    AppPlugin.addSchemaModule({\n      schema: [\n        Chat.Chat,\n        Chat.CompanionTo,\n        Blueprint.Blueprint,\n        AiContext.Binding,\n        Feed.Feed,\n        HasSubject.HasSubject,\n        Message.Message,\n        Routine.Routine,\n        Agent.Agent,\n        McpServer.McpServer,\n        Plan.Plan,\n        Sequence.Sequence,\n        Memory.Memory,\n        Text.Text,\n      ],\n    }),\n    AppPlugin.addSettingsModule({ activate: Settings }),\n    AppPlugin.addSurfaceModule({\n      activate: ReactSurface,\n      firesBeforeActivation: [AppActivationEvents.SetupArtifactDefinition],\n    }),\n    AppPlugin.addTranslationsModule({ translations }),\n    Plugin.addModule({\n      id: 'automation-templates',\n      activatesOn: AppActivationEvents.SetupSchema,\n      activate: AutomationTemplates,\n    }),\n    Plugin.addModule({\n      id: 'markdown',\n      activatesOn: MarkdownEvents.SetupExtensions,\n      activate: MarkdownExtension,\n    }),\n    Plugin.addModule({\n      // TODO(wittjosiah): Does not integrate with settings store.\n      //   Should this be a different event?\n      //   Should settings store be renamed to be more generic?\n      activatesOn: AppActivationEvents.SetupSettings,\n      firesAfterActivation: [StateReady],\n      activate: AssistantState,\n    }),\n    Plugin.addModule({\n      activatesOn: AssistantEvents.SetupAiServiceProviders,\n      activate: EdgeModelResolver,\n    }),\n    Plugin.addModule({\n      activatesOn: AssistantEvents.SetupAiServiceProviders,\n      activate: LocalModelResolver,\n    }),\n    Plugin.addModule((options) => ({\n      id: Capability.getModuleTag(AiService),\n      firesBeforeActivation: [AssistantEvents.SetupAiServiceProviders],\n      // TODO(dmaretskyi): This should activate lazily when the AI chat is used.\n      activatesOn: ActivationEvents.SetupProcessManager,\n      activate: () => AiService(options),\n    })),\n    Plugin.addModule({\n      // Process-affinity `AiContext.Service` LayerSpec — needed so operations\n      // dispatched as their own processes (e.g. via `Operation.invoke` from\n      // `AiSession.createRequest` or `TriggerDispatcher`) can resolve\n      // conversation-scoped services without an inline `Effect.provideService`\n      // upstream. See `capabilities/ai-context.ts` for the rationale.\n      activatesOn: ActivationEvents.SetupProcessManager,\n      activate: AiContextCapability,\n    }),\n    Plugin.addModule({\n      activatesOn: ActivationEvents.SetupProcessManager,\n      activate: AgentRuntime,\n    }),\n  )\n  .pipe(\n    Plugin.addModule({\n      // TODO(wittjosiah): Use a different event.\n      activatesOn: ActivationEvents.Startup,\n      activate: Toolkit,\n    }),\n    Plugin.addModule({\n      activatesOn: ActivationEvents.ProcessManagerReady,\n      activate: AgentHydrator,\n    }),\n    Plugin.addModule({\n      activatesOn: ActivationEvent.allOf(\n        ActivationEvents.ProcessManagerReady,\n        AppActivationEvents.AppGraphReady,\n        DeckEvents.StateReady,\n        StateReady,\n      ),\n      activate: CompanionChatProvisioner,\n    }),\n    Plugin.addModule({\n      activatesOn: ClientEvents.SetupMigration,\n      activate: Migrations,\n    }),\n    Plugin.addModule({\n      activatesOn: AppActivationEvents.SetupIntegrationProviders,\n      activate: IntegrationProvider,\n    }),\n    AppPlugin.addPluginAssetModule({\n      asset: { pluginId: meta.id, path: 'PLUGIN.mdl', content: pluginSpec, mimeType: 'application/x-mdl' },\n    }),\n    Plugin.make,\n  );\n\nexport default AssistantPlugin;\n", "---\nid: org.dxos.plugin.assistant\nname: AssistantPlugin\nversion: 0.1.0\n---\n\nAn AI assistant plugin for DXOS Composer that provides conversational AI, blueprint-driven automation,\nmulti-provider LLM support, and deep ECHO integration.\n\n## Extensions\n\nThe following extension dialects are used in this document.\nEach extension is defined in the Appendix or resolved via its URI.\n\n| Term        | URI                           |\n|-------------|-------------------------------|\n| `type`      | `org.dxos.mdl.type@1.0`      |\n| `feat`      | `org.dxos.mdl.feat@1.0`      |\n| `test`      | `org.dxos.mdl.test@1.0`      |\n| `component` | `org.dxos.mdl.component@1.0` |\n| `op`        | `org.dxos.mdl.op@1.0`        |\n\n## Types\n\n```mdl\ntype ModelProvider\n  literals: edge | ollama | lmstudio\n```\n\n```mdl\ntype ChatView\n  literals: normal | summary | thinking | debug\n```\n\n```mdl\ntype ModelDefaults\n  fields:\n    edge?: string\n    ollama?: string\n    lmstudio?: string\n```\n\n```mdl\ntype Settings\n  fields:\n    customPrompts?: boolean\n    chatView?: ChatView\n    modelProvider?: ModelProvider\n    modelDefaults?: ModelDefaults\n    tracePanelDebug?: boolean\n```\n\n```mdl\ntype Chat\n  fields:\n    id: string\n    name?: string\n    messages: Message[]\n```\n\n```mdl\ntype Message\n  fields:\n    id: string\n    role: user | assistant | system\n    content: string\n    timestamp: string\n```\n\n```mdl\ntype NavigationTarget\n  fields:\n    path: string\n    label: string\n    type: string\n```\n\n```mdl\ntype BlueprintForm\n  fields:\n    key: string\n    name: string\n    description?: string\n```\n\n## Components\n\n```mdl\ncomponent ChatPanel\n  desc: Main conversational interface for interacting with the AI assistant.\n  props:\n    chat: Chat\n    companionTo?: Obj\n  state:\n    messages: Message[]\n    pending: boolean\n    view: ChatView\n  slots:\n    toolbar?: ReactNode\n    empty?: ReactNode\n  actions:\n    sendMessage(content: string)\n    clearHistory()\n    switchView(view: ChatView)\n  emits:\n    onMessage(message: Message)\n  layout: |\n    \u250C\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2510\n    \u2502 [toolbar slot]          \u2502\n    \u251C\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2524\n    \u2502                         \u2502\n    \u2502  message list           \u2502\n    \u2502  [empty slot]           \u2502\n    \u2502                         \u2502\n    \u251C\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2524\n    \u2502  input + send           \u2502\n    \u2514\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2518\n```\n\n```mdl\ncomponent TracePanel\n  desc: Displays the execution trace of an AI operation as a commit graph or raw JSON.\n  props:\n    chat: Chat\n  state:\n    debug: boolean\n  actions:\n    toggleDebug()\n  layout: |\n    \u250C\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2510\n    \u2502 trace / span tree       \u2502\n    \u2514\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2518\n```\n\n```mdl\ncomponent AssistantSettings\n  desc: Settings panel for configuring the AI model provider, model defaults, and chat view.\n  props:\n    settings: Settings\n  emits:\n    onChange(settings: Settings)\n```\n\n## Operations\n\n```mdl\nop CreateChat\n  desc: Creates a new Chat object and optionally adds it to the active space.\n  input:\n    db: Database\n    name?: string\n    addToSpace?: boolean\n  output: Chat\n  effects: [echo:write]\n```\n\n```mdl\nop UpdateChatName\n  desc: Automatically derives and updates the name of a chat using the AI service.\n  input:\n    chat: Chat\n  output: void\n  effects: [echo:write, ai:infer]\n```\n\n```mdl\nop SetCurrentChat\n  desc: Associates a primary object with a specific companion chat in session state.\n  input:\n    companionTo: Obj\n    chat?: Chat\n  output: void\n```\n\n```mdl\nop RunPromptInNewChat\n  desc: Creates a new chat, binds context objects and blueprints, then runs a prompt.\n  input:\n    db: Database\n    objects?: Obj[]\n    blueprints?: string[]\n    prompt: string | RoutineRef\n    background?: boolean\n  output: Chat\n  effects: [echo:write, ai:infer]\n  note: |\n    When background is true, the prompt runs via the compute runtime without\n    opening the chat UI. The returned Chat can be used to track progress.\n```\n\n```mdl\nop EnsureCompanionChat\n  desc: Returns the companion chat for an object, creating one if none exists.\n  input:\n    db: Database\n    companionTo: Obj\n  output:\n    chat: Chat\n    persisted: boolean\n  effects: [echo:write]\n```\n\n```mdl\nop ResolveNavigationTargets\n  desc: Returns navigation paths for objects in the active space, optionally filtered by DXN.\n  input:\n    query?:\n      dxn?: DXN\n  output:\n    targets: NavigationTarget[]\n```\n\n```mdl\nop OnCreateSpace\n  desc: Provisions initial assistant objects when a new space is created.\n  input:\n    space: Space\n    rootCollection: Collection\n  output: void\n  effects: [echo:write]\n```\n\n```mdl\nop ToggleTracePanelDebug\n  desc: Toggles the trace panel between commit-graph and raw JSON debug view.\n  input:\n    state?: boolean\n  output: boolean\n```\n\n## Features\n\n```mdl\nfeat F-1: AI Chat\n\n  req F-1.1: User can create a new Chat object in any space.\n  req F-1.2: User can type a message and receive a streamed AI response.\n  req F-1.3: Chat history is persisted to ECHO and replicated to all peers.\n  req F-1.4:\n    when: chat has enough messages\n    then: chat name is automatically derived from the conversation\n```\n\n```mdl\nfeat F-2: Companion Chat\n\n  req F-2.1:\n    when: user opens an object that supports companions\n    then: a companion chat panel is shown alongside the object\n  req F-2.2:\n    when: companion chat does not yet exist\n    then: op:EnsureCompanionChat creates one and optionally persists it\n  req F-2.3:\n    when: user sends a message in the companion chat\n    then: the primary object is automatically bound as AI context\n```\n\n```mdl\nfeat F-3: Blueprint System\n\n  req F-3.1: Blueprints define named AI configurations (instructions, tools, model).\n  req F-3.2: Built-in blueprints include: Assistant, Browser, Database, WebSearch, Discord, Linear, Agent, Planning, Memory, Automation, BlueprintManager, AgentWizard.\n  req F-3.3:\n    when: user selects a blueprint for a chat\n    then: chat uses that blueprint's instructions and tool set\n  req F-3.4: op:RunPromptInNewChat accepts blueprint keys to bind before sending the prompt.\n```\n\n```mdl\nfeat F-4: Multi-Provider LLM\n\n  req F-4.1: Supported providers: DXOS Edge (remote), Ollama (local), LM Studio (local).\n  req F-4.2: User can configure the active provider and per-provider default model in Settings.\n  req F-4.3:\n    when: the active provider is unavailable\n    then: AiService falls back to the next registered resolver\n```\n\n```mdl\nfeat F-5: Tool Execution\n\n  req F-5.1: The assistant blueprint exposes LayoutOperation.Open and ResolveNavigationTargets as tools.\n  req F-5.2: Web search tool is registered via WebSearchToolkit.\n  req F-5.3:\n    when: AI invokes a tool during a conversation\n    then: operation is dispatched via the compute runtime and result returned to the model\n```\n\n```mdl\nfeat F-6: ECHO Integration\n\n  req F-6.1: Chat, CompanionTo, Blueprint, Feed, Message, Memory, Plan, Routine, Agent, McpServer, and Sequence schemas are registered with ECHO.\n  req F-6.2:\n    when: a new space is created\n    then: op:OnCreateSpace provisions default assistant objects\n  req F-6.3: AiContext.Binding schema supports binding ECHO objects as named context variables in a conversation.\n```\n\n```mdl\nfeat F-7: Execution Trace\n\n  req F-7.1: Every AI operation produces a structured span tree captured in the TracePanel.\n  req F-7.2: User can toggle between commit-graph and raw JSON views via op:ToggleTracePanelDebug.\n```\n\n## Acceptance\n\n```mdl\ntest T-1: Create chat and send message\n  given: a space is open and the assistant plugin is active\n  when: user creates a new Chat and sends \"Hello\"\n  then:\n    - Chat object appears in the space\n    - AI response is appended to Chat.messages\n    - Chat is persisted to ECHO\n```\n\n```mdl\ntest T-2: Companion chat provisioning\n  given: user opens a document with no companion chat\n  when: companion panel initializes\n  then:\n    - op:EnsureCompanionChat creates a new Chat\n    - persisted === false until user sends a message\n```\n\n```mdl\ntest T-3: Blueprint binding\n  given: a chat exists\n  when: user binds the \"WebSearch\" blueprint key\n  then:\n    - blueprint instructions are applied to the next AI request\n    - web search tool is available in the tool list\n```\n\n```mdl\ntest T-4: Model provider switch\n  given: assistant settings are open\n  when: user switches provider from edge to ollama\n  then:\n    - Settings.modelProvider === ollama\n    - next AI request is routed to the Ollama resolver\n```\n\n```mdl\ntest T-5: Run prompt in background\n  given: a database and a prompt string are available\n  when: op:RunPromptInNewChat is called with background: true\n  then:\n    - a new Chat is created and returned\n    - the prompt runs via compute runtime without opening the UI\n```\n\n```mdl\ntest T-6: Navigation target resolution\n  given: active space contains documents and collections\n  when: op:ResolveNavigationTargets is called with no query\n  then:\n    - returned targets include paths for all top-level navigable objects\n    - each target has a non-empty label and type\n```\n\n```mdl\ntest T-7: Trace panel debug toggle\n  given: trace panel is showing commit-graph view\n  when: op:ToggleTracePanelDebug is invoked with no argument\n  then:\n    - tracePanelDebug setting flips to true\n    - trace panel switches to raw JSON view\n```\n\n---\n\n## Appendix: Extension Definitions\n\nExtension block types used in this document are defined below using\nthe core `ext` primitive \u2014 the only construct the base language provides.\n\n```mdl\next type\n  uri: org.dxos.mdl.type@1.0\n  desc: A named data structure with typed fields and optional literals.\n  fields:\n    desc?: Prose\n    fields?: FieldMap\n    literals?: UnionList\n    extends?: TypeRef[]\n```\n\n```mdl\next feat\n  uri: org.dxos.mdl.feat@1.0\n  desc: A named feature grouping one or more requirements.\n  fields:\n    desc?: Prose\n    req: RequirementList\n  nesting: self\n```\n\n```mdl\next test\n  uri: org.dxos.mdl.test@1.0\n  desc: An acceptance scenario expressed as given / when / then steps.\n  fields:\n    given?: Step | Step[]\n    when?: Step | Step[]\n    then: Step | Step[]\n    tags?: TagList\n```\n\n```mdl\next component\n  uri: org.dxos.mdl.component@1.0\n  desc: A UI component with props, internal state, slots, actions, and events.\n  fields:\n    desc?: Prose\n    props?: FieldMap\n    state?: FieldMap\n    slots?: FieldMap\n    actions?: ActionMap\n    emits?: EventMap\n    layout?: CodeBlock\n```\n\n```mdl\next op\n  uri: org.dxos.mdl.op@1.0\n  desc: |\n    A named operation with typed inputs, outputs, and declared errors.\n    Pure ops have no effects or requires. Effectful ops declare both.\n  fields:\n    desc?: Prose\n    input?: FieldMap\n    output?: TypeExpr\n    errors?: ErrorMap\n    effects?: EffectList\n    requires?: ServiceList\n    note?: Prose\n```\n"],
+  "mappings": ";AAIA,SAASA,iBAAiBC,kBAAkBC,YAAYC,cAAc;AACtE,SAASC,qBAAqBC,iBAAiB;AAC/C,SAASC,iBAAiB;AAC1B,SAASC,OAAOC,MAAMC,WAAWC,QAAQC,YAAY;AACrD,SAASC,WAAWC,eAAe;AACnC,SAASC,gBAAgB;AACzB,SAASC,YAAY;AACrB,SAASC,oBAAoB;AAC7B,SAASC,kBAAkB;AAC3B,SAASC,sBAAsB;AAC/B,SAASC,YAAY;AACrB,SAASC,YAAYC,eAAe;AAEpC,SACEC,eACAC,cACAjB,aAAakB,qBACbC,WACAC,qBACAC,iBACAC,qBACAC,gBACAC,qBACAC,0BACAC,cACAC,mBACAC,oBACAC,mBACAC,YACAC,kBACAC,cACAC,UACAC,eACK;AACP,SAASC,YAAY;AACrB,SAASC,oBAAoB;AAC7B,SAASC,uBAAoD;;;ACxC7D;;;AD6CA,IAAMC,aAAaC,oBAAoBC,iBAAiBC,KAAKC,EAAE;AAExD,IAAMC,kBAAkBC,OAAOC,OAAsCJ,IAAAA,EACzEK,KACCC,UAAUC,kBAAkB;EAAEC,UAAUC;AAAgB,CAAA,GACxDH,UAAUI,6BAA6B;EAAEF,UAAUG;AAAoB,CAAA,GACvEL,UAAUM,sBAAsB;EAAEJ,UAAUK;AAAa,CAAA,GACzDP,UAAUQ,0BAA0B;EAAEN,UAAUO;AAAiB,CAAA,GACjET,UAAUU,gBAAgB;EACxBC,QAAQ;IACNC,KAAKA;IACLA,KAAKC;IACLC,UAAUA;IACVC,UAAUC;IACVC,KAAKA;IACLC,WAAWA;IACXC,QAAQA;IACRC,QAAQA;IACRC,MAAMA;IACNC,UAAUA;IACVC,KAAKA;IACLC,SAASA;IACTC,OAAOA;IACPC,KAAKA;;AAET,CAAA,GACA1B,UAAU2B,kBAAkB;EAAEzB,UAAU0B;AAAS,CAAA,GACjD5B,UAAU6B,iBAAiB;EACzB3B,UAAU4B;EACVC,uBAAuB;IAACvC,oBAAoBwC;;AAC9C,CAAA,GACAhC,UAAUiC,sBAAsB;EAAEC;AAAa,CAAA,GAC/CrC,OAAOsC,UAAU;EACfxC,IAAI;EACJyC,aAAa5C,oBAAoB6C;EACjCnC,UAAUoC;AACZ,CAAA,GACAzC,OAAOsC,UAAU;EACfxC,IAAI;EACJyC,aAAaG,eAAeC;EAC5BtC,UAAUuC;AACZ,CAAA,GACA5C,OAAOsC,UAAU;;;;EAIfC,aAAa5C,oBAAoBkD;EACjCC,sBAAsB;IAACpD;;EACvBW,UAAU0C;AACZ,CAAA,GACA/C,OAAOsC,UAAU;EACfC,aAAaS,gBAAgBC;EAC7B5C,UAAU6C;AACZ,CAAA,GACAlD,OAAOsC,UAAU;EACfC,aAAaS,gBAAgBC;EAC7B5C,UAAU8C;AACZ,CAAA,GACAnD,OAAOsC,UAAU,CAACc,aAAa;EAC7BtD,IAAIuD,WAAWC,aAAaC,SAAAA;EAC5BrB,uBAAuB;IAACc,gBAAgBC;;;EAExCV,aAAaiB,iBAAiBC;EAC9BpD,UAAU,MAAMkD,UAAUH,OAAAA;AAC5B,EAAA,GACApD,OAAOsC,UAAU;;;;;;EAMfC,aAAaiB,iBAAiBC;EAC9BpD,UAAUqD;AACZ,CAAA,GACA1D,OAAOsC,UAAU;EACfC,aAAaiB,iBAAiBC;EAC9BpD,UAAUsD;AACZ,CAAA,CAAA,EAEDzD,KACCF,OAAOsC,UAAU;;EAEfC,aAAaiB,iBAAiBI;EAC9BvD,UAAUwD;AACZ,CAAA,GACA7D,OAAOsC,UAAU;EACfC,aAAaiB,iBAAiBM;EAC9BzD,UAAU0D;AACZ,CAAA,GACA/D,OAAOsC,UAAU;EACfC,aAAayB,gBAAgBC,MAC3BT,iBAAiBM,qBACjBnE,oBAAoBuE,eACpBC,WAAWzE,YACXA,UAAAA;EAEFW,UAAU+D;AACZ,CAAA,GACApE,OAAOsC,UAAU;EACfC,aAAa8B,aAAaC;EAC1BjE,UAAUkE;AACZ,CAAA,GACAvE,OAAOsC,UAAU;EACfC,aAAa5C,oBAAoB6E;EACjCnE,UAAUoE;AACZ,CAAA,GACAtE,UAAUuE,qBAAqB;EAC7BC,OAAO;IAAEC,UAAU/E,KAAKC;IAAI+E,MAAM;IAAcC,SAASC;IAAYC,UAAU;EAAoB;AACrG,CAAA,GACAhF,OAAOiF,IAAI;AAGf,IAAA,0BAAelF;",
+  "names": ["ActivationEvent", "ActivationEvents", "Capability", "Plugin", "AppActivationEvents", "AppPlugin", "AiContext", "Agent", "Chat", "McpServer", "Memory", "Plan", "Blueprint", "Routine", "Sequence", "Feed", "ClientEvents", "DeckEvents", "MarkdownEvents", "Text", "HasSubject", "Message", "AgentHydrator", "AgentRuntime", "AiContextCapability", "AiService", "IntegrationProvider", "AppGraphBuilder", "AutomationTemplates", "AssistantState", "BlueprintDefinition", "CompanionChatProvisioner", "CreateObject", "EdgeModelResolver", "LocalModelResolver", "MarkdownExtension", "Migrations", "OperationHandler", "ReactSurface", "Settings", "Toolkit", "meta", "translations", "AssistantEvents", "StateReady", "AppActivationEvents", "createStateEvent", "meta", "id", "AssistantPlugin", "Plugin", "define", "pipe", "AppPlugin", "addAppGraphModule", "activate", "AppGraphBuilder", "addBlueprintDefinitionModule", "BlueprintDefinition", "addCreateObjectModule", "CreateObject", "addOperationHandlerModule", "OperationHandler", "addSchemaModule", "schema", "Chat", "CompanionTo", "Blueprint", "AiContext", "Binding", "Feed", "HasSubject", "Message", "Routine", "Agent", "McpServer", "Plan", "Sequence", "Memory", "Text", "addSettingsModule", "Settings", "addSurfaceModule", "ReactSurface", "firesBeforeActivation", "SetupArtifactDefinition", "addTranslationsModule", "translations", "addModule", "activatesOn", "SetupSchema", "AutomationTemplates", "MarkdownEvents", "SetupExtensions", "MarkdownExtension", "SetupSettings", "firesAfterActivation", "AssistantState", "AssistantEvents", "SetupAiServiceProviders", "EdgeModelResolver", "LocalModelResolver", "options", "Capability", "getModuleTag", "AiService", "ActivationEvents", "SetupProcessManager", "AiContextCapability", "AgentRuntime", "Startup", "Toolkit", "ProcessManagerReady", "AgentHydrator", "ActivationEvent", "allOf", "AppGraphReady", "DeckEvents", "CompanionChatProvisioner", "ClientEvents", "SetupMigration", "Migrations", "SetupIntegrationProviders", "IntegrationProvider", "addPluginAssetModule", "asset", "pluginId", "path", "content", "pluginSpec", "mimeType", "make"]
+}