@dxos/app-framework 0.12.0-next-73daef452f1464b62efdbca75fb0067c1066f264 → 0.14.0

package/CHANGELOG.md

@@ -1,6 +1,121 @@
 # @dxos/app-framework
 
-## 0.12.0-next-73daef452f1464b62efdbca75fb0067c1066f264
+## 0.14.0
+
+### Patch Changes
+
+- 0715304: An app now has one process manager: the stack's `Process.ManagerService`, which the app's operation invoker, `Capabilities.ProcessManager` and `AgentService` all use. Operations the app invokes with `on: 'edge'` therefore run on EDGE instead of dying with "Remote process requested, but RemoteProcessManager offers no process control", which an agent's watches and Brain store views logged every three seconds. `@dxos/app-framework` now owns the unified-manager spec that `@dxos/plugin-routine` used to contribute, with a no-op remote manager as a fallback, and a `LayerStack` spec now outranks an ambient service of the same tag.
+- Updated dependencies [0715304]
+- Updated dependencies [ec6da5a]
+- Updated dependencies [a1e64db]
+- Updated dependencies [28bb45b]
+- Updated dependencies [1eed6b1]
+- Updated dependencies [6847fe2]
+- Updated dependencies [35217f4]
+- Updated dependencies [1819960]
+- Updated dependencies [eb5d14d]
+- Updated dependencies [5324de6]
+- Updated dependencies [b07f49f]
+  - @dxos/compute-runtime@0.14.0
+  - @dxos/compute@0.14.0
+  - @dxos/echo@0.14.0
+  - @dxos/effect@0.14.0
+  - @dxos/ui-theme@0.14.0
+  - @dxos/operation@0.14.0
+  - @dxos/graph@0.14.0
+  - @dxos/edge-client@0.14.0
+  - @dxos/protocols@0.14.0
+  - @dxos/async@0.14.0
+  - @dxos/context@0.14.0
+  - @dxos/debug@0.14.0
+  - @dxos/errors@0.14.0
+  - @dxos/invariant@0.14.0
+  - @dxos/keys@0.14.0
+  - @dxos/log@0.14.0
+  - @dxos/util@0.14.0
+  - @dxos/web-context@0.14.0
+  - @dxos/web-context-react@0.14.0
+  - @dxos/react-error-boundary@0.14.0
+  - @dxos/react-hooks@0.14.0
+
+## 0.13.0
+
+### Minor Changes
+
+- 9ab98cd: The roots of `@dxos/app-framework`, `@dxos/app-graph`, `@dxos/app-toolkit`, `@dxos/assistant-toolkit`, `@dxos/compute`, `@dxos/effect`, `@dxos/graph`, `@dxos/observability` and every plugin now export namespaces only, and every namespace has its own subpath: import it with `import * as Hooks from '@dxos/app-framework/Hooks'` and call `Hooks.useOperationInvoker()`. A compound component exports its parts (`<ObjectCard.Root>`, `<ObjectCard.Header>`), a single component keeps its own name (`<TracePanel.TracePanel>`), and errors live in the namespace that owns them (`Operation.NoHandlerError`, `Capability.NotFoundError`, `ConnectorSync.DatabaseMissingError`) or in a `<Domain>Error` module (`FunctionsAiError`, `ConnectorError`).
+
+  Breaking: names that were exported flat from a root moved into namespaces, e.g. `ProcessManagerPlugin.make()`, `PluginManager.Context`, `PluginManifest.DEV_SERVER_PORT`, `Progress.makeTraceSink`, `SpaceSurface.RENAME_POPOVER`, `Calendar.getRangeSelectionId`, `AgentSkill.Handlers`, `SlashCommand.resolveSlashCommand`, `SelectionModel.SelectionModel`, `HaloServices.layer`, `PluginStorage.loadPlugins`, `CorePlugins.make()`, `KvsStore.make` (formerly `createKvsStore`), `CardSlot.IconSlot` and `CardSlot.MenuSlot` (formerly `CardIconSlot` and `CardMenuSlot`), `Hooks.useUpdateRow` in `@dxos/app-toolkit` and `OtelTracer.make`/`OtelTracer.layer` in `@dxos/effect`; a plugin's `meta` is `<Name>Plugin.meta`. Flat names nothing imported outside their package are no longer exported. `@dxos/compute/Errors` is removed, `@dxos/app-solid` no longer re-exports `@dxos/app-framework`, and `@dxos/util/Position` is a subpath.
+
+  `HomeSection` and `NamePopover` move from `@dxos/app-framework` to `@dxos/app-toolkit` (`@dxos/app-toolkit/HomeSection`, `@dxos/app-toolkit/NamePopover`), so app-framework no longer depends on `@dxos/react-ui`. A `check-module-structure` guard fails if any app-framework export reaches react-ui again.
+
+### Patch Changes
+
+- 246ee3c: Add `@dxos/plugin-agent`, an agent that talks to people through any channel, remembers them as ECHO objects, reads every conversation turn into facts, relays messages, and keeps one-time and ongoing ("keep me posted") watches whose updates it writes from the conversation's context. Every subpath of the package is a namespace: `AgentState` and `AgentKnowledge` (each with a `Root` container), one per skill (`ConversationSkill`, `GoalsSkill`, `InterviewSkill`, `ModesSkill`, `NoteTakerSkill`, `RelaySkill`), and one per type and operation set.
+
+  `@dxos/plugin-thread` channel backends can now open direct conversations (`openDirect`), post into threads (`threads.send`), run a connection (`connection.start`/`stop`/`status`), and return a send receipt. New operations `sendToChannel`, `openDirect`, `connectChannel`, `disconnectChannel` and `getChannelStatus` dispatch to them, and the handlers are published as the `ThreadOperationHandlerSet` subpath. The Discord and Slack plugins implement these backends.
+
+  An agent prompt can name its sender: `AgentProcess` accepts `{ prompt, sender?, properties? }` as well as a bare prompt (`AgentInput`, `makeInputMessage`), `AgentService.Session.submitPrompt` and the assistant's request and session take a `sender`, and the model sees a named sender as `[From: <name>]`. `useChatProcessor` and `AiChatProcessor` take a `sender`, and `ChatThread` takes a `userHue`.
+
+  `Agent.loadChat` no longer picks a chat bridged from an external conversation as the agent's primary chat, and finds chats with a child-of filter so it also works on EDGE. `Agent.makeInitialized` accepts a skill ref, and `Skill.makeRef` binds a database skill as-is and any other by registry URI.
+
+  The `ProfileOf` relation moves from `@dxos/plugin-crm` to `@dxos/types` with its typename unchanged, so existing profiles still resolve. `EdgeHttpClient.request` makes an authenticated call to any EDGE route. `pipeline-rdf` exports `DEFAULT_MODEL`. `FormInlineAnnotation` now survives the JSON-schema round trip. A plugin that declares two modules with the same id now fails when it is constructed instead of silently dropping one.
+
+- Updated dependencies [bbe9f18]
+- Updated dependencies [162fd6d]
+- Updated dependencies [aad3e41]
+- Updated dependencies [bb2b672]
+- Updated dependencies [cb1e218]
+- Updated dependencies [1ef899b]
+- Updated dependencies [32f32a0]
+- Updated dependencies [469e7f7]
+- Updated dependencies [665261a]
+- Updated dependencies [68dc875]
+- Updated dependencies [2e96a73]
+- Updated dependencies [fe08304]
+- Updated dependencies [945092e]
+- Updated dependencies [c531b05]
+- Updated dependencies [3672aff]
+- Updated dependencies [2f95d25]
+- Updated dependencies [c7cc480]
+- Updated dependencies [e99ee70]
+- Updated dependencies [161f994]
+- Updated dependencies [1894fc1]
+- Updated dependencies [246ee3c]
+- Updated dependencies [8ebe8d6]
+- Updated dependencies [0ee5ecf]
+- Updated dependencies [596728d]
+- Updated dependencies [7715216]
+- Updated dependencies [1737cad]
+- Updated dependencies [6a7bed4]
+- Updated dependencies [3022878]
+- Updated dependencies [c2a300a]
+- Updated dependencies [17008f0]
+- Updated dependencies [dde8f43]
+- Updated dependencies [4f8e566]
+- Updated dependencies [a449958]
+  - @dxos/compute@0.13.0
+  - @dxos/echo@0.13.0
+  - @dxos/util@0.13.0
+  - @dxos/edge-client@0.13.0
+  - @dxos/compute-runtime@0.13.0
+  - @dxos/operation@0.13.0
+  - @dxos/async@0.13.0
+  - @dxos/context@0.13.0
+  - @dxos/effect@0.13.0
+  - @dxos/graph@0.13.0
+  - @dxos/log@0.13.0
+  - @dxos/protocols@0.13.0
+  - @dxos/react-hooks@0.13.0
+  - @dxos/react-error-boundary@0.13.0
+  - @dxos/debug@0.13.0
+  - @dxos/errors@0.13.0
+  - @dxos/invariant@0.13.0
+  - @dxos/keys@0.13.0
+  - @dxos/web-context@0.13.0
+  - @dxos/web-context-react@0.13.0
+  - @dxos/ui-theme@0.13.0
+
+## 0.12.0
 
 ### Minor Changes
 
@@ -10,6 +125,14 @@
 
   The `@dxos/app-toolkit` maker families that back the app shell — `settings`, `operationHandler`, `reactContext`, `reactRoot`, `navigationResolver` and `navigationHandler` — now state `Startup` explicitly, so modules built with them are unaffected. `appGraphBuilder` (idle) and `skillDefinition` (assistant start) were already explicit.
 
+- 6d52561: The boot loader now shows plugin activation as a row of icons rather than a scrolling text log.
+
+  `window.__bootLoader` gains two methods: `plugins(entries)` registers the icon of every plugin that could activate (drawing nothing on its own), and `activated(id)` adds that plugin's icon to the row. Icons come from each plugin's own `meta.profile.icon` and resolve against the host's static sprite (`/icons.svg` by default; `bootLoaderPlugin({ spritePath })` overrides it). Arrivals queue and drain one at a time, spaced 200–400ms, since activation lands in bursts of a dozen inside a couple of frames.
+
+  The per-module `Activating …` status lines are gone by default — a boot emitted hundreds of them. `useApp({ verboseStatus: true })` brings them back, collapsed to one line per plugin; `composer-app` exposes that as `VITE_DX_BOOT_VERBOSE=true` or `?boot-verbose`.
+
+  `StartupProgress` gains `pluginName` and `pluginSlug`, identifying the plugin owning the in-flight module, so a host can render or filter transitions per plugin without parsing module ids.
+
 - 34a8433: Order module activation by capability dependencies instead of hand-wired events.
   A module declares the capabilities it `requires` and `provides` (or a runtime
   `activatesOn` event) and the plugin manager topologically orders activation from
@@ -39,6 +162,15 @@
   (`make<T>()(nsid)`) so the NSID literal brands the identifier. The
   `withPluginManager` `capabilities` test option now accepts `Contribution[]`.
 
+- 497caab: Report every write to a space as a product event, however it happened, with whether it was a person's action. ECHO emits vendor-neutral events on a new `trace.events` channel in `@dxos/tracing` for adds and removes of objects and relations, persisted types, and feed appends, named by `Database.TraceEvents`. Each carries an origin: `user` for a person's own action, `system` for everything else (agents, syncs and imports, seeding, automation), or `unknown` when nothing attributed the write, so unattributed call sites stay visible. The origin is passed with the new `origin` write option or provided once as `Database.Origin`, and replaces the `track` add option. Operations the app framework's invoker runs are attributed to the `user`, trigger runs and operations in an agent's conversation to the `system`, and each process passes its origin to the operations it invokes. The new `ObservabilityProvider.ObjectEvents` data provider reports every write as `space.object.add`, `space.object.remove`, `space.relation.add`, `space.relation.remove`, `space.type.add` or `space.feed.append`, with the `origin` as a property.
+- f0d3620: `Capability.AnyTag` is one interface rather than `Tag<any, any> | MultiTag<any, any>`. Both tag types remain assignable to it (`Context.Key` is covariant in both parameters), so a value that satisfied the union still satisfies the interface, and `Tag`, `MultiTag` and `IdentifierOf` are unchanged. Generic code that discriminated on the union's constituents — for instance instantiating `IdentifierOf<AnyTag>`, which is now `never` — needs the concrete tag type instead.
+- 548e82c: `environments` now lists every runtime condition a capability module loads under, `browser` included. `dx-plugin gen` slices every condition by one rule and writes `#capabilities` without a `default`, so a runtime a plugin names no condition for fails to resolve. UI maker families default to `['browser', 'tauri']`, headless families to all four conditions.
+- 2c06e2e: Fix two packaging defects that only appear outside the monorepo, where a package resolves through its published manifest instead of workspace links.
+
+  A `#alias` declared in a package's `imports` map as a plain string answered every condition with the same target, and that target was TypeScript source. Because the alias survives into the emitted `.d.ts` and `.mjs`, a consumer installing the package resolved it into `node_modules/@dxos/<pkg>/src/`: tsc typechecked SDK source as if it were the consumer's own code (`skipLibCheck` does not apply, these are `.ts` files, not `.d.ts`), and Node failed outright on a specifier such as `#meta` with `ERR_UNSUPPORTED_NODE_MODULES_TYPE_STRIPPING`. All 33 affected packages now declare `source`, `types` and `default`, so the alias resolves to `dist/` everywhere but the monorepo.
+
+  `@dxos/app-framework/testing` imported `@dxos/storybook-addon-logger/download`, which was only a devDependency, so importing that entrypoint from an installed copy threw `Cannot find package`. `StorybookErrorFallback` now lives in `@dxos/storybook-addon-logger`, which owns the download channel it calls. Stories keep the "Download logs" action: the shared storybook preview installs it through the new `setStoryErrorFallback` export. Anyone importing `StorybookErrorFallback` from `@dxos/app-framework/testing` should import it from `@dxos/storybook-addon-logger/StorybookErrorFallback` instead.
+
 - 61fe676: Defer activation events dispatched while startup is running until the startup wave completes, so a module activating on one can rely on every startup capability being present. Keep the composed React context stable across renders so a capability change no longer remounts the application. Add a `client` option to the client plugin, letting a host construct and begin initializing the client before the activation pass reaches the plugin.
 - 63e500b: Space object CRUD is now projected from operations, and space operations no longer reach for app
   plugins to do it.
@@ -168,80 +300,363 @@
 
   `@dxos/react-ui-assistant` gains a `./translations` export so consumers can take its translation resources without pulling the React root barrel.
 
+- 886453b: Report where startup and the worker connection failed instead of only that they timed out. Failures raise typed errors (`StartupTimeoutError`, `WorkerError`, `WorkerConnectionError`) carrying their diagnostics in `BaseError.context`, so error tracking names the failure instead of showing a bare `Error` and `Effect.catchTag` can discriminate on it. `useApp` reports the modules still in flight and dispatches `STARTUP_FAILED_EVENT` on a module activation error as well as on the deadline, and `Connection` reports the leader and connect phase it reached, whether it holds the leader lock, and its retry counters. `@dxos/log` lifts an error's `context` onto the entry whether the error arrives as the entry's error, as the call's context, or as a value inside it, so callers no longer hand-lift it, and the PostHog log processor forwards structured context rather than dropping every value that is not a string, number, or boolean. `withContext` in `@dxos/errors` replaces the ad-hoc probes that read that field.
+- d205e96: A capability module can be annotated `environments: ['tauri']` to load only in Tauri builds. `dx-plugin gen` gives the `tauri` condition every browser module plus the annotated ones, and leaves the annotated ones out of the `default` barrel, so web bundles never carry them.
+- 4a10672: New `useOperationHandler(operation, map?)` hook: suspensefully resolves an operation's handler as an effect fn (`(input) => Effect<Output>`), or — with `map` — as a callback-args binding (`(...args) => Effect<Output>`). The component suspends while the handler's module lazy-loads; a miss throws `NoHandlerError`. Resolution goes through the new `Capabilities.OperationHandlers` singleton — the merged reactive handler set the process manager already builds for the operation invoker, now also contributed as a capability. `OperationHandlerSet.reactive` memoizes `getHandlerFor` promises per key (invalidated when contributions change) so React's `use` can resume suspended renders, and `OperationHandlerSet.findHandler(set, definition)` is the definition-typed promise counterpart of `getHandler`.
+
+  `useSpaceCallback` now passes the returned callback's arguments through to `fn`, so gesture handlers can build effects from per-call inputs. BREAKING: the optimistic-overlay layer is removed entirely — `useOptimisticOperation`, `OptimisticBinding`, `useOptimisticQuery`, and the `@dxos/app-framework/Optimistic` module. Local-first sync writes need no overlay; a query view is a memoized `Atom.make` over `query.atom` read with `useAtomValue`.
+
+  New `Ref.peek()` / `Database.peek(ref)` — the target when already materialized: the pinned target or a side-effect-free working-set lookup; never throws, never triggers loading. `Ref.target` is deprecated in its favor (it loads and registers a resolution callback as side effects, and can throw). Compose `Database.peek(ref) ?? (yield* Database.load(ref))` for a sync-when-materialized read with an async fallback — an effect built only from materialized refs runs under `Effect.runSync`. `Database.load` itself is unchanged — its async resolution also settles a just-added object into its own document, which flows like branching depend on. `TaskSet.resolveParentTask` uses that composition, and its cycle check walks the candidate's `parentTask` ancestor chain (equivalent to the old subtree collection, and it sees cross-set descendants) instead of querying.
+
+  BREAKING: `TaskOperation.MoveTask`'s input requires a `taskSet` ref alongside the task and its handler needs no services. With loaded refs the whole operation completes without an async boundary — a drop runs it with `Effect.runSync` so the write lands in the gesture frame, with no optimistic overlay — while unloaded refs (e.g. an agent caller) load asynchronously through the same path.
+
+- ee180f6: `useOperation(operation, map, options?)` in `@dxos/app-framework/ui`: binds an operation to a UI callback in one step — `map` turns the component's callback arguments into the operation input, and the returned handler keeps a stable identity across renders (the mapper and options are read through refs). `Optimistic.make(source)` in `@dxos/app-framework` overlays ordered optimistic entries on a reactive row-source atom (apply entries retire on the first source emission after the operation settles and auto-revert on failure; retain entries pin rows evicted from a filtered source through a grace window), and `useOptimisticOperation` binds an operation dispatch to such an overlay. `TaskSet.reorderItems` in `@dxos/types` generalizes `TaskSet.reorder` over any keyed list so optimistic transforms share the handler's ordering.
+
 ### Patch Changes
 
+- 3c7b013: ECHO atom families no longer use `Atom.keepAlive`, so an entity's atoms, snapshots and subscriptions are released once nothing observes them instead of being retained for the lifetime of the page. Multi-key families (`Obj.atomProperty`, `Annotation.atom`, ref properties) are keyed by a tuple rather than nested families.
+
+  `@dxos/effect` adds the `AtomEx` namespace with `AtomEx.makeRegistry`, an atom registry with a 5 second idle grace period (`AtomEx.DEFAULT_IDLE_TTL`). Use it for any registry that hosts ECHO atoms, which no longer carry `keepAlive`. The plugin manager's registry uses it (`atomIdleTTL`).
+
+  Breaking: app-graph's `Graph.nodeOrThrow` and `@dxos/graph`'s `Store.nodeOrThrow` atoms are removed. Use `getNodeOrThrow`, which now throws `GraphNode.NotFoundError`, or read `node` and handle `Option.none`.
+
+- 1a8043c: The boot loader no longer leaves a document-level click listener behind after it unmounts, which kept the app's first click event, and the view it landed in, from being garbage collected.
+- 520c34f: The boot loader's plugin activation row now shows its icons on a cold first load. The row resolved each icon through an external `<use href="/icons.svg#…">`, which the browser only requests when the first icon lands; on an empty cache that ~200KB sprite arrived after the row had filled — or after the loader had gone — so the first visit showed empty slots and every later visit, served from cache, showed glyphs. The loader now fetches the sprite when it mounts and inlines its symbols, so the download starts with the page and the icons reference it locally.
+- 9714c75: `@dxos/brand/channels` names the prerelease channels (`dev`, `preview`, `staging`) and the colour each one paints the mark, and `channelMarkFilter` turns that colour into a CSS filter over the released artwork. The boot loader applies that filter to the mark, the ring and its head together, so a channel build no longer ships its own copy of the mark and the ring agrees with it; the composer app's icon variants are generated from the same definitions. The brand `Icons` story shows the channels in a row.
+
+  The boot loader's activation row is a flex row translated as one group: a plugin's icon is appended at the end and fades in, and the row slides half a slot to stay centred on an eased count driven by the same frame loop as the ring, so arrivals in quick succession keep the row moving rather than stopping it between each.
+
+  Breaking: `react-ui`'s `Stepper` is renamed `Steps`, after the Ark machine it sits on, as the rest of the family is named: `StepsProps`, `StepsStyleProps`, `stepsTheme` and the `steps.*` theme keys follow. The `Step`, `StepOptions`, `stepCount` and `stepAt` helpers keep their names.
+
 - 4a0b78b: Bundler-plugin entrypoints no longer publish a `source` export condition: `@dxos/app-framework/vite-plugin` and `@dxos/ui-theme/plugin`. These run in Node inside a `vite.config.ts` and reach `node:*`, so a `source` condition let an app's `source`-first resolver pull their Node-only sources into a browser bundle.
 
   Default resolution is unchanged — both entrypoints already resolved to their built `dist` for ordinary consumers, with the same exports and runtime behaviour. Only resolution under `--conditions=source` changes: it now yields the built output, matching `@dxos/config`'s bundler-plugin entrypoints.
 
 - 5305365: Plugin body imports resolve concurrently instead of one at a time, so core plugins activate first and startup drops ~500 ms.
+- 318d610: A plugin loaded through Plugins → Dev Server loads from the right server and stays enabled after a reload. `composerPlugin`'s dev and preview servers now fail when their port is taken instead of moving to the next free one, so the setting never loads a plugin from whatever else holds port 3967. Synced plugin settings no longer turn off a plugin the dev plugin depends on, and no longer record the dev plugin's own enabled state as the account's choice.
+- ab56cfe: Devtools panels are article containers (`*Article`, exported from `containers/panels`) and the stats panel is a stack of `StatCard` cards, each contributed as a surface on `AppSurface.DevtoolsOverview`; the `Panel` accordion and `*Panel` exports are gone, and the duplicate `logs` deck companion is removed in favour of the debug panel's Logs page.
+
+  `Button` gains a `tag` variant with a `hue` (the `dx-tag` look on a button), `Field.Switch` takes a `density` and shrinks at `sm`, and `Card.Root`'s `density` now applies to its contents. `Surface.getMounted()` lists the surfaces currently mounted and `Surface.useProfilerSnapshot()` reads the profiler's cumulative per-surface stats without subscribing.
+
+  `JsonHighlighter` and `SyntaxHighlighter` scroll inside the family's themed `ScrollArea` (`scroll` picks the axes; `scroll={false}` gives the bare leaf that `Syntax.Code` uses), so the shorthand replaces a hand-built `Syntax.Root/Content/Viewport/Code` wherever no filter or depth control is needed.
+
+- 2643a00: Fix `dx-plugin gen` silently dropping a capability from every generated per-environment barrel (`src/capabilities/gen/<env>.ts`) — neither as a real export nor as its `undefined` stub — when its declaration was reached through an already-extensioned relative re-export (e.g. `export { X } from './x/index.ts'` or `export * from './x/index.ts'`). `resolveRelativeModule` always appended a resolution extension to the specifier, so an already-extensioned one resolved to a nonexistent path (`index.ts.ts`) and the barrel parse silently gave up on that branch. This broke plugin loading outright for any capability affected this way (confirmed on `plugin-space`'s `NavigationHandler` and `plugin-connector`'s `Coordinator`, also present in `plugin-client` and `plugin-file-system`) — the CLI failed with `LazyPluginError`/`SyntaxError: Export named 'X' not found` for every command, since plugin manager initialization eagerly resolves every plugin.
+- 362fd0f: `dx-plugin gen` is silent by default; pass `--verbose` to print each generated barrel.
+- 4e4c25d: A plugin enabled after boot now gets its services without a reload. The process manager used to
+  build its service stack from the `LayerSpec`s present at boot and only log the ones contributed
+  later, so enabling a plugin such as Sandbox at runtime left its tools failing with
+  `ServiceNotAvailable`. `LayerStack.addLayers` now adds specs to a live stack: built slices are
+  extended in place, so services already running are neither rebuilt nor released, and a spec that
+  was pruned for a dependency nobody provided yet is re-admitted once a later spec provides it. A spec
+  that would close a requires/provides cycle is rejected with an error and the rest are still added.
+  Disabling a plugin does not remove its services until the next boot.
 - 9c86066: Resolve trace sinks per write instead of snapshotting them when the process-manager runtime is built. A sink contributed by an on-demand module (plugin-progress contributes its progress adapter that way) landed after the snapshot and was silently dropped, so every operation's `status.update` reached the durable sink while the progress meters stayed empty.
+- e26af7e: Count the startup deadline in observed execution time instead of wall clock, so a boot overlapping process suspension (a hidden native-app webview, App Nap, system sleep) no longer raises the fatal startup-timeout dialog. The native app also disables WKWebView background throttling, which suspended every JS realm for hours once the window sat hidden.
+- d308bf8: `PluginManager.add` activates a plugin whose id is already enabled, such as one enabled in an earlier session and
+  loaded again from its URL. Before, it read as enabled while none of its modules ran, until it was switched off and on.
+- 07514c2: `composerPlugin` loads `dx.config.ts` with bun when the build runs under bun, including a `bun build --compile`
+  executable, so a plugin builds on a machine without node.
 - 256f286: Projects gain a lifecycle `status` field (`active | paused | blocked | ended`), surfaced through the MCP-projected verbs, and plugin-projects ships a project-management skill for external agents — including the `/codeProject setup` flow that binds a repo to an existing space. The skill's key segment is `codeProject` because the segment doubles as the projected MCP prompt name and plain `project` belongs to assistant-toolkit's own skill.
 
   `toEffectSchema` recognizes ECHO's reference sentinel before the generic `type: 'object'` branch, so a reference node widened with structural keywords (as a wire boundary may do for schema-unaware consumers) decodes as a reference instead of a plain struct. Serialization is unchanged — persisted schemas stay byte-identical to previous releases.
 
   Worker (`workerd`) bundles no longer pull in React. Wrangler resolves `workerd, worker, browser` and never `node`, so a `#capabilities` map offering only `node` and `default` handed workers the browser barrel and its React surfaces. Every plugin with a headless entry now resolves a server-safe barrel under a `workerd` condition, and the `check-module-structure` guards trace with `workerd,worker` — the conditions a worker actually resolves — so a reintroduced leak fails the check instead of passing against a build that is never shipped.
 
+- 582fc22: `Surface` holds its previous `data` reference while the incoming one is shallow-equal to it, so an ancestor render no longer re-renders the plugin subtree below a surface.
+
+  `shallowEqual` moves to `@dxos/util` (with `useStable` in `@dxos/react-hooks`) and now compares array shape, so `app-graph` node-change detection tells `[]` from `{}` and notices a trailing hole.
+
+- 892b718: Surfaces register with the mount registry under a profiler provider in production builds, so the devtools Surfaces card lists them and its highlight toggle works outside dev.
+- Updated dependencies [a92ea18]
+- Updated dependencies [9477170]
+- Updated dependencies [0c6c186]
+- Updated dependencies [af1c007]
+- Updated dependencies [12461e1]
+- Updated dependencies [4862c8e]
+- Updated dependencies [106d38a]
+- Updated dependencies [9049c30]
+- Updated dependencies [6186edc]
+- Updated dependencies [e3ceced]
+- Updated dependencies [6a457ac]
+- Updated dependencies [e2eecf2]
+- Updated dependencies [2800d03]
+- Updated dependencies [4ececc6]
+- Updated dependencies [96f94c2]
+- Updated dependencies [c95def4]
+- Updated dependencies [3c7b013]
+- Updated dependencies [fd873d2]
+- Updated dependencies [b1dc20c]
+- Updated dependencies [ac71815]
+- Updated dependencies [7c87626]
+- Updated dependencies [c020513]
+- Updated dependencies [6388838]
+- Updated dependencies [f82c78f]
+- Updated dependencies [9714c75]
 - Updated dependencies [e954c0f]
 - Updated dependencies [9ef5485]
 - Updated dependencies [22bea85]
+- Updated dependencies [a069511]
+- Updated dependencies [066b35d]
+- Updated dependencies [63fc847]
+- Updated dependencies [b4ceea2]
 - Updated dependencies [bdb02cd]
 - Updated dependencies [48eb05d]
+- Updated dependencies [2d58ea5]
+- Updated dependencies [bd6ba8e]
+- Updated dependencies [0fe00c5]
 - Updated dependencies [b8762ef]
 - Updated dependencies [73daef4]
+- Updated dependencies [75971ad]
+- Updated dependencies [3958355]
+- Updated dependencies [fd23a8b]
 - Updated dependencies [4e417e9]
+- Updated dependencies [5262408]
+- Updated dependencies [194b1d3]
+- Updated dependencies [d194929]
+- Updated dependencies [6ef35a6]
+- Updated dependencies [d17d75a]
 - Updated dependencies [557e243]
+- Updated dependencies [ea11703]
+- Updated dependencies [b2caee6]
+- Updated dependencies [9baf25f]
+- Updated dependencies [34f7d92]
 - Updated dependencies [a3d45c4]
+- Updated dependencies [dcf911b]
+- Updated dependencies [b63506b]
+- Updated dependencies [6af89f4]
+- Updated dependencies [d770fe7]
+- Updated dependencies [da37a13]
+- Updated dependencies [0a01ff7]
+- Updated dependencies [1c995c4]
+- Updated dependencies [6f4a887]
+- Updated dependencies [ab56cfe]
+- Updated dependencies [1aabb03]
+- Updated dependencies [7575cb6]
+- Updated dependencies [7ec1738]
+- Updated dependencies [df295b2]
+- Updated dependencies [d0beedc]
+- Updated dependencies [731b264]
+- Updated dependencies [a69d861]
+- Updated dependencies [ba08e65]
+- Updated dependencies [07565c8]
+- Updated dependencies [5fcd238]
+- Updated dependencies [5e8878c]
+- Updated dependencies [6409948]
+- Updated dependencies [792c756]
+- Updated dependencies [497caab]
+- Updated dependencies [35d6e86]
+- Updated dependencies [1cf6347]
+- Updated dependencies [0cde959]
+- Updated dependencies [e094f74]
+- Updated dependencies [9ab38fa]
+- Updated dependencies [b3673ee]
 - Updated dependencies [23d2d8c]
 - Updated dependencies [b0953f0]
 - Updated dependencies [375b863]
+- Updated dependencies [915db6a]
+- Updated dependencies [020af54]
+- Updated dependencies [4864912]
 - Updated dependencies [3e02201]
 - Updated dependencies [261c821]
+- Updated dependencies [6c25ed3]
 - Updated dependencies [dde6714]
+- Updated dependencies [9d4dec3]
+- Updated dependencies [2e4c299]
+- Updated dependencies [a3b6ef0]
+- Updated dependencies [4c55b5d]
+- Updated dependencies [782a442]
 - Updated dependencies [b02fe16]
+- Updated dependencies [4c52ca6]
+- Updated dependencies [472ca95]
+- Updated dependencies [252ca39]
+- Updated dependencies [8fb29b3]
+- Updated dependencies [c439ba0]
+- Updated dependencies [6af130f]
+- Updated dependencies [2c442f9]
+- Updated dependencies [0264069]
+- Updated dependencies [2922d36]
+- Updated dependencies [d62a947]
+- Updated dependencies [872f391]
+- Updated dependencies [51820a1]
+- Updated dependencies [9ae0e5f]
+- Updated dependencies [7d000b9]
 - Updated dependencies [e56276b]
+- Updated dependencies [66e9264]
 - Updated dependencies [813069c]
+- Updated dependencies [84362af]
+- Updated dependencies [76d6fca]
+- Updated dependencies [4c107a2]
+- Updated dependencies [84622b1]
+- Updated dependencies [e5c13e4]
+- Updated dependencies [26e31c1]
+- Updated dependencies [8c20ee2]
+- Updated dependencies [b9d72bb]
+- Updated dependencies [eeff74c]
+- Updated dependencies [251f586]
+- Updated dependencies [3c85350]
+- Updated dependencies [967b130]
+- Updated dependencies [3e9a10f]
+- Updated dependencies [8ea2bf9]
+- Updated dependencies [6139557]
 - Updated dependencies [5ceaf9c]
+- Updated dependencies [8ca2ac7]
 - Updated dependencies [098a0bb]
+- Updated dependencies [72f7584]
+- Updated dependencies [e94ed89]
+- Updated dependencies [882ac2a]
+- Updated dependencies [0132aab]
+- Updated dependencies [3ea0b0f]
+- Updated dependencies [47c8d7e]
+- Updated dependencies [10b1239]
+- Updated dependencies [490127e]
+- Updated dependencies [851791f]
+- Updated dependencies [608a172]
+- Updated dependencies [d535d55]
 - Updated dependencies [5180720]
+- Updated dependencies [b600f72]
+- Updated dependencies [99e323d]
+- Updated dependencies [ea11703]
+- Updated dependencies [bcfe4c5]
+- Updated dependencies [ce194c0]
+- Updated dependencies [818a096]
+- Updated dependencies [4aa6a33]
+- Updated dependencies [9636ce1]
+- Updated dependencies [0ac2e5f]
+- Updated dependencies [9426389]
+- Updated dependencies [2e5e188]
+- Updated dependencies [ebb8f4a]
+- Updated dependencies [9d2466a]
 - Updated dependencies [557e243]
+- Updated dependencies [ca34a80]
+- Updated dependencies [29543ca]
+- Updated dependencies [08cddf6]
+- Updated dependencies [a04ab6e]
+- Updated dependencies [a283607]
+- Updated dependencies [24fcadc]
+- Updated dependencies [b00ee72]
+- Updated dependencies [4804da0]
+- Updated dependencies [d4b4919]
 - Updated dependencies [63e500b]
 - Updated dependencies [7c426d4]
+- Updated dependencies [02fe893]
+- Updated dependencies [78e5596]
+- Updated dependencies [b1bb838]
+- Updated dependencies [19f19a2]
+- Updated dependencies [2a41efd]
+- Updated dependencies [a09e18e]
+- Updated dependencies [142ba02]
+- Updated dependencies [e1ee9dd]
+- Updated dependencies [cff311f]
+- Updated dependencies [8610d9d]
+- Updated dependencies [fc8c80c]
+- Updated dependencies [f3c02b3]
 - Updated dependencies [0a3e9dd]
+- Updated dependencies [e2b04f6]
 - Updated dependencies [256f286]
+- Updated dependencies [4689d66]
 - Updated dependencies [306f50d]
+- Updated dependencies [61becad]
+- Updated dependencies [690dcaa]
+- Updated dependencies [14c2fab]
+- Updated dependencies [e207c68]
+- Updated dependencies [89f2811]
+- Updated dependencies [b7822a7]
+- Updated dependencies [c8b65f3]
+- Updated dependencies [9feee5e]
+- Updated dependencies [f2d8a92]
+- Updated dependencies [d005fd9]
+- Updated dependencies [0e44f24]
+- Updated dependencies [cef0a3b]
+- Updated dependencies [bd06669]
+- Updated dependencies [5b504b4]
+- Updated dependencies [d7b0a3b]
+- Updated dependencies [1482a3f]
+- Updated dependencies [16e0588]
 - Updated dependencies [4663f24]
+- Updated dependencies [2513a52]
 - Updated dependencies [2896a58]
+- Updated dependencies [17ed864]
+- Updated dependencies [1d6f730]
+- Updated dependencies [b125655]
+- Updated dependencies [10defed]
 - Updated dependencies [9e91762]
+- Updated dependencies [f4c2702]
+- Updated dependencies [2df0297]
+- Updated dependencies [3e08678]
+- Updated dependencies [7407d65]
+- Updated dependencies [318bbad]
 - Updated dependencies [fc83abd]
+- Updated dependencies [9a3f01e]
+- Updated dependencies [178bc6d]
 - Updated dependencies [8904184]
+- Updated dependencies [e680b16]
+- Updated dependencies [a805212]
+- Updated dependencies [6fed038]
 - Updated dependencies [f8bfba0]
+- Updated dependencies [ea11703]
+- Updated dependencies [fa82aef]
+- Updated dependencies [178a283]
+- Updated dependencies [56276cd]
+- Updated dependencies [18597fc]
+- Updated dependencies [9205bd3]
+- Updated dependencies [fce2060]
+- Updated dependencies [bda45ac]
+- Updated dependencies [5885380]
+- Updated dependencies [881f900]
+- Updated dependencies [6a1ec57]
+- Updated dependencies [82a9c4e]
+- Updated dependencies [72b2984]
+- Updated dependencies [693d1b4]
+- Updated dependencies [32584c9]
+- Updated dependencies [32353e6]
+- Updated dependencies [559acfa]
+- Updated dependencies [631df48]
 - Updated dependencies [e8088ea]
 - Updated dependencies [bb94124]
+- Updated dependencies [928e0b2]
+- Updated dependencies [1a3de22]
+- Updated dependencies [5d816a6]
 - Updated dependencies [85e6347]
+- Updated dependencies [4c5b2c7]
+- Updated dependencies [f9816c0]
 - Updated dependencies [78523d2]
+- Updated dependencies [6fd2a5d]
+- Updated dependencies [525aee0]
+- Updated dependencies [40b50c2]
+- Updated dependencies [f112c37]
+- Updated dependencies [8048e42]
+- Updated dependencies [520c34f]
+- Updated dependencies [e64e2b5]
+- Updated dependencies [85bdad2]
 - Updated dependencies [77d0026]
-  - @dxos/protocols@0.12.0-next-73daef452f1464b62efdbca75fb0067c1066f264
-  - @dxos/compute@0.12.0-next-73daef452f1464b62efdbca75fb0067c1066f264
-  - @dxos/react-ui@0.12.0-next-73daef452f1464b62efdbca75fb0067c1066f264
-  - @dxos/edge-client@0.12.0-next-73daef452f1464b62efdbca75fb0067c1066f264
-  - @dxos/compute-runtime@0.12.0-next-73daef452f1464b62efdbca75fb0067c1066f264
-  - @dxos/graph@0.12.0-next-73daef452f1464b62efdbca75fb0067c1066f264
-  - @dxos/util@0.12.0-next-73daef452f1464b62efdbca75fb0067c1066f264
-  - @dxos/react-hooks@0.12.0-next-73daef452f1464b62efdbca75fb0067c1066f264
-  - @dxos/operation@0.12.0-next-73daef452f1464b62efdbca75fb0067c1066f264
-  - @dxos/async@0.12.0-next-73daef452f1464b62efdbca75fb0067c1066f264
-  - @dxos/context@0.12.0-next-73daef452f1464b62efdbca75fb0067c1066f264
-  - @dxos/effect@0.12.0-next-73daef452f1464b62efdbca75fb0067c1066f264
-  - @dxos/log@0.12.0-next-73daef452f1464b62efdbca75fb0067c1066f264
-  - @dxos/react-error-boundary@0.12.0-next-73daef452f1464b62efdbca75fb0067c1066f264
-  - @dxos/debug@0.12.0-next-73daef452f1464b62efdbca75fb0067c1066f264
-  - @dxos/errors@0.12.0-next-73daef452f1464b62efdbca75fb0067c1066f264
-  - @dxos/invariant@0.12.0-next-73daef452f1464b62efdbca75fb0067c1066f264
-  - @dxos/keys@0.12.0-next-73daef452f1464b62efdbca75fb0067c1066f264
-  - @dxos/web-context@0.12.0-next-73daef452f1464b62efdbca75fb0067c1066f264
-  - @dxos/web-context-react@0.12.0-next-73daef452f1464b62efdbca75fb0067c1066f264
-  - @dxos/ui-theme@0.12.0-next-73daef452f1464b62efdbca75fb0067c1066f264
+- Updated dependencies [4a10672]
+- Updated dependencies [c209b42]
+- Updated dependencies [eda8b55]
+- Updated dependencies [cc11297]
+- Updated dependencies [ff37699]
+- Updated dependencies [6dadb41]
+  - @dxos/echo@0.12.0
+  - @dxos/compute-runtime@0.12.0
+  - @dxos/ui-theme@0.12.0
+  - @dxos/compute@0.12.0
+  - @dxos/react-ui@0.12.0
+  - @dxos/effect@0.12.0
+  - @dxos/graph@0.12.0
+  - @dxos/protocols@0.12.0
+  - @dxos/edge-client@0.12.0
+  - @dxos/errors@0.12.0
+  - @dxos/util@0.12.0
+  - @dxos/async@0.12.0
+  - @dxos/log@0.12.0
+  - @dxos/debug@0.12.0
+  - @dxos/context@0.12.0
+  - @dxos/react-hooks@0.12.0
+  - @dxos/operation@0.12.0
+  - @dxos/react-error-boundary@0.12.0
+  - @dxos/keys@0.12.0
+  - @dxos/invariant@0.12.0
+  - @dxos/web-context@0.12.0
+  - @dxos/web-context-react@0.12.0
 
 ## 0.11.1
 

package/bin/dx-plugin.mjs

@@ -4,4 +4,4 @@
 // Copyright 2026 DXOS.org
 //
 
-void import('../dist/plugin-cli/node-esm/main.mjs');
+void import('../dist/lib/plugin-cli.mjs');

package/dist/lib/App.mjs

@@ -0,0 +1,2 @@
+import { D as bootLoader, E as App } from "./chunk-hooks.mjs";
+export { App, bootLoader };

package/dist/lib/Hooks.mjs

@@ -0,0 +1,2 @@
+import { C as pluginSlugOf, O as useActivationSignal, S as StartupTimeoutError, T as useApp, _ as useOptionalCapabilities, a as useSpaceService, b as STARTUP_ACTIVATED_EVENT, c as useAtomCapability, d as useCapability, f as useOperation, g as useOptionalAtomCapabilityState, h as useOptionalAtomCapability, i as useSpaceCallback, l as useAtomCapabilityState, m as useOperationInvoker, n as useSettingsState, o as LoadingState, p as useOperationHandler, r as useProcessManagerRuntime, s as useLoading, t as useSurface, u as useCapabilities, v as useOptionalCapability, w as pluginSlugOfKey, x as STARTUP_FAILED_EVENT, y as FIRST_INTERACTIVE_EVENT } from "./chunk-hooks.mjs";
+export { FIRST_INTERACTIVE_EVENT, LoadingState, STARTUP_ACTIVATED_EVENT, STARTUP_FAILED_EVENT, StartupTimeoutError, pluginSlugOf, pluginSlugOfKey, useActivationSignal, useApp, useAtomCapability, useAtomCapabilityState, useCapabilities, useCapability, useLoading, useOperation, useOperationHandler, useOperationInvoker, useOptionalAtomCapability, useOptionalAtomCapabilityState, useOptionalCapabilities, useOptionalCapability, useProcessManagerRuntime, useSettingsState, useSpaceCallback, useSpaceService, useSurface };

package/dist/lib/PluginManagerProvider.mjs

@@ -0,0 +1,21 @@
+import { createContext, useContext } from "react";
+import { raise } from "@dxos/debug";
+//#region src/ui/components/PluginManager/PluginManagerProvider.ts
+var PluginManagerContext = createContext(void 0);
+/**
+* Get the plugin manager.
+*/
+var usePluginManager = () => useContext(PluginManagerContext) ?? raise(/* @__PURE__ */ new Error("Missing PluginManagerContext"));
+/**
+* Get the plugin manager, or undefined outside a provider. Surfaces and activation signals fire
+* demand events opportunistically and must not throw when rendered standalone (stories, tests).
+*/
+var useOptionalPluginManager = () => useContext(PluginManagerContext);
+/**
+* Context provider for a plugin manager.
+*/
+var PluginManagerProvider = PluginManagerContext.Provider;
+//#endregion
+export { PluginManagerProvider, useOptionalPluginManager, usePluginManager };
+
+//# sourceMappingURL=PluginManagerProvider.mjs.map

package/dist/lib/PluginManagerProvider.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"PluginManagerProvider.mjs","names":[],"sources":["../../src/ui/components/PluginManager/PluginManagerProvider.ts"],"sourcesContent":["//\n// Copyright 2024 DXOS.org\n//\n\nimport { createContext, useContext } from 'react';\n\nimport { raise } from '@dxos/debug';\n\nimport { type PluginManager } from '../../../core/index.ts';\n\nconst PluginManagerContext = createContext<PluginManager.PluginManager | undefined>(undefined);\n\n/**\n * Get the plugin manager.\n */\nexport const usePluginManager = (): PluginManager.PluginManager =>\n  useContext(PluginManagerContext) ?? raise(new Error('Missing PluginManagerContext'));\n\n/**\n * Get the plugin manager, or undefined outside a provider. Surfaces and activation signals fire\n * demand events opportunistically and must not throw when rendered standalone (stories, tests).\n */\nexport const useOptionalPluginManager = (): PluginManager.PluginManager | undefined => useContext(PluginManagerContext);\n\n/**\n * Context provider for a plugin manager.\n */\nexport const PluginManagerProvider = PluginManagerContext.Provider;\n"],"mappings":";;;AAUA,IAAM,uBAAuB,cAAuD,KAAA,CAAS;;;;AAK7F,IAAa,yBACX,WAAW,oBAAoB,KAAK,sBAAM,IAAI,MAAM,8BAA8B,CAAC;;;;;AAMrF,IAAa,iCAA0E,WAAW,oBAAoB;;;;AAKtH,IAAa,wBAAwB,qBAAqB"}

package/dist/lib/Surface.mjs

@@ -0,0 +1,3 @@
+import { d as SurfaceManagerProvider, f as useSurfaceManager, t as SurfaceManager } from "./chunk-SurfaceManager.mjs";
+import { i as Surface_exports } from "./chunk-Surface.mjs";
+export { Surface_exports as Surface, SurfaceManager, SurfaceManagerProvider, useSurfaceManager };