@nimbalyst/extension-sdk 0.4.0 → 0.6.0

package/CHANGELOG.md

@@ -8,6 +8,8 @@ The SDK is versioned independently of the Nimbalyst app. Each release declares i
 
 | SDK version | Minimum Nimbalyst app version |
 | --- | --- |
+| 0.6.0 | 0.78.0 |
+| 0.5.0 | 0.70.0 |
 | 0.4.0 | 0.70.0 |
 | 0.3.0 | 0.70.0 |
 | 0.2.2 | 0.58.5 |
@@ -18,6 +20,43 @@ The SDK is versioned independently of the Nimbalyst app. Each release declares i
 
 ## [Unreleased]
 
+## [0.6.0] - 2026-09-14
+
+Requires Nimbalyst 0.78.0, available on the alpha channel at publication, for the complete host API including native screenshots.
+
+### Added
+
+- `CollaborationCommentsService`, `CommentAnchor`, and codec-level `commentAnchors` let collaborative editors mount the platform comment experience and resolve structured anchors both live and headlessly.
+- `host.registerViewport()` and `EditorViewport` let an editor expose proportional scroll position to hosts that carry the reader's place between related documents; `createReadOnlyHost()` can receive those registrations.
+- `contributions.customEditors[].collaboration.documentType` lets a host identify a collaborative document type from the manifest before its extension bundle and codec are loaded.
+- `screenshotService` exposes host-provided element and file screenshots, including unopened documents.
+- `PanelHost.getWorkspaceFolders()` and `getPrimaryFolderPath()` expose multiple workspace roots; file-tree helpers accept those roots.
+- `EditorHost.getAssetUrl()` and the `assetUrls` capability let media editors stream local files through a host-provided URL.
+- The `agents`, `types/editor`, and `git-operation-log` entry points expose agent contracts, editor types, and Git operation selectors.
+- `ProtocolSession.appliedModel` and `deliveredMcpServerCount` report the model and MCP servers actually used by an agent.
+
+### Changed
+
+- `CollabCodec` documents file-form fallback for headless agent edits when no structured patch pair exists, while recommending structured edits for minimal concurrent deltas.
+
+### Fixed
+
+- Agent host declarations use a Node-compatible relative import for consumers using Node16 or NodeNext module resolution.
+
+## [0.5.0]
+
+Still runs on Nimbalyst 0.70.0: a host that declares no capabilities is treated as fully capable, so an extension written against this release keeps working on older desktop builds.
+
+### Added
+
+- `host.capabilities` plus `editorHostSupports()` and `editorHostCapabilityGap()` let one editor bundle run in hosts that cannot honour every part of `EditorHost` — check a capability before calling instead of discovering the gap at runtime.
+- `AiAgentProviderContribution` declares `supportsSlashCommands`, `supportsSkills`, and `compaction` instead of having the app infer them; all three default to off, so an unclaimed affordance is hidden rather than offered and silently broken.
+- `AgentProtocol.compactSession()` is the optional real compaction entry point for a transport that has one.
+
+### Changed
+
+- `host.filePath` is documented as an opaque document identifier — an absolute path on the desktop host, a synthetic URI on a host with no filesystem. Gate anything that touches disk on the `localFileSave` / `projectFileSystem` capabilities.
+
 ## [0.4.0]
 
 ### Added

package/dist/__tests__/editorHostCapabilities.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=editorHostCapabilities.test.d.ts.map

package/dist/__tests__/editorHostCapabilities.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"editorHostCapabilities.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/editorHostCapabilities.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/editorHostCapabilities.test.js

@@ -0,0 +1,24 @@
+// @vitest-environment node
+import { describe, expect, it } from 'vitest';
+import { editorHostCapabilityGap, editorHostSupports, } from '../editorHostCapabilities.js';
+const browserCapabilities = {
+    environment: 'browser',
+    unavailable: [{ capability: 'localFileSave', reason: 'No file to write.' }],
+    supports: (capability) => capability !== 'localFileSave',
+};
+describe('editorHostSupports', () => {
+    it('treats a host that makes no claim as fully capable', () => {
+        // The Electron renderer predates this contract and implements every
+        // member. Answering false there would make every portable extension
+        // silently drop features on desktop.
+        expect(editorHostSupports({}, 'localFileSave')).toBe(true);
+        expect(editorHostCapabilityGap({}, 'localFileSave')).toBeNull();
+    });
+    it('defers to a host that does declare capabilities', () => {
+        const host = { capabilities: browserCapabilities };
+        expect(editorHostSupports(host, 'collaboration')).toBe(true);
+        expect(editorHostSupports(host, 'localFileSave')).toBe(false);
+        expect(editorHostCapabilityGap(host, 'localFileSave')).toBe('No file to write.');
+        expect(editorHostCapabilityGap(host, 'collaboration')).toBeNull();
+    });
+});

package/dist/__tests__/fileDirectoryTree.test.js

@@ -56,4 +56,38 @@ describe('buildFileDirectoryTree', () => {
         expect(tree.fileCount).toBe(1);
         expect(tree.files).toHaveLength(1);
     });
+    describe('multi-root workspaces', () => {
+        const ROOTS = ['/repo', '/other/collab'];
+        it('leaves primary-root paths bare and names the attached root', () => {
+            expect(getWorkspaceRelativeFilePath('/repo/src/index.ts', ROOTS)).toBe('src/index.ts');
+            expect(getWorkspaceRelativeFilePath('/other/collab/src/index.ts', ROOTS))
+                .toBe('collab/src/index.ts');
+        });
+        it('keeps same-named files in different roots in separate groups', () => {
+            const tree = buildTree(['/repo/src/index.ts', '/other/collab/src/index.ts'], ROOTS);
+            // `collab/src` is the collapsed single-child chain; the point is that the
+            // two `src` directories do not merge into one group.
+            expect(getFileDirectoryPaths(tree)).toEqual(['src', 'collab/src']);
+            expect(tree.subdirectories.get('src')?.fileCount).toBe(1);
+            expect(tree.subdirectories.get('collab')?.fileCount).toBe(1);
+        });
+        it('prefers the deepest root for a root nested inside another root', () => {
+            expect(getWorkspaceRelativeFilePath('/repo/vendor/lib/a.ts', ['/repo', '/repo/vendor/lib']))
+                .toBe('lib/a.ts');
+        });
+        it('falls back to the absolute path for a file in no root', () => {
+            expect(getWorkspaceRelativeFilePath('/elsewhere/a.ts', ROOTS)).toBe('/elsewhere/a.ts');
+        });
+        it('disambiguates attached roots that share a basename', () => {
+            // `/app/api` and `/infra/api` are an ordinary pair, and a bare basename
+            // would collapse both repos into one `api` group in the tree.
+            const roots = ['/repo', '/app/api', '/infra/api'];
+            expect(getWorkspaceRelativeFilePath('/app/api/src/a.ts', roots)).toBe('app/api/src/a.ts');
+            expect(getWorkspaceRelativeFilePath('/infra/api/src/a.ts', roots)).toBe('infra/api/src/a.ts');
+        });
+        it('matches single-root behaviour when given one root', () => {
+            expect(getWorkspaceRelativeFilePath('/repo/src/index.ts', ['/repo']))
+                .toBe(getWorkspaceRelativeFilePath('/repo/src/index.ts', '/repo'));
+        });
+    });
 });

package/dist/__tests__/gitOperationLog.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=gitOperationLog.test.d.ts.map

package/dist/__tests__/gitOperationLog.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gitOperationLog.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/gitOperationLog.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/gitOperationLog.test.js

@@ -0,0 +1,51 @@
+import { describe, expect, it } from 'vitest';
+import { mergeGitOperationEntries, normalizeGitOperationEntry, selectLatestRunningGitOperation, selectLatestTerminalGitOperation, selectRunningGitOperations, } from '../gitOperationLog';
+function entry(overrides) {
+    return {
+        timestamp: 1000,
+        updatedAt: 1000,
+        command: 'git status',
+        executable: 'git',
+        args: ['status'],
+        cwd: '/repo',
+        status: 'running',
+        output: '',
+        stdout: '',
+        stderr: '',
+        ...overrides,
+    };
+}
+describe('git operation log selectors', () => {
+    it('keeps a live terminal event that landed while hydration was in flight', () => {
+        // The `git:operation-log:get` response is older than upserts that arrived
+        // after it was requested. Applying it blindly rewinds a finished push back
+        // to running, which is exactly the stale indicator this ordering prevents.
+        const hydrated = [entry({ id: 'a', status: 'running', updatedAt: 1000 })];
+        const live = [entry({ id: 'a', status: 'success', updatedAt: 2000 })];
+        expect(mergeGitOperationEntries(hydrated, live)[0].status).toBe('success');
+        expect(mergeGitOperationEntries(live, hydrated)[0].status).toBe('success');
+    });
+    it('names the newest running command and counts the rest', () => {
+        const entries = [
+            entry({ id: 'push', timestamp: 1000, command: 'git push' }),
+            entry({ id: 'fetch', timestamp: 3000, command: 'git fetch origin' }),
+            entry({ id: 'done', timestamp: 2000, status: 'success', updatedAt: 5000 }),
+        ];
+        expect(selectLatestRunningGitOperation(entries)?.id).toBe('fetch');
+        expect(selectRunningGitOperations(entries).map((e) => e.id)).toEqual(['push', 'fetch']);
+        expect(selectLatestTerminalGitOperation(entries)?.id).toBe('done');
+    });
+    it('reads a journal written before source metadata existed as app-owned direct git', () => {
+        const legacy = entry({ id: 'legacy' });
+        delete legacy.source;
+        delete legacy.executor;
+        const normalized = normalizeGitOperationEntry(legacy);
+        expect(normalized.source).toBe('nimbalyst');
+        expect(normalized.executor).toBe('git');
+    });
+    it('does not let an agent entry inherit the app-owned default', () => {
+        const agent = entry({ id: 'agent', source: 'agent', executor: 'shell', sessionId: 's1' });
+        expect(normalizeGitOperationEntry(agent).source).toBe('agent');
+        expect(normalizeGitOperationEntry(agent).executor).toBe('shell');
+    });
+});

package/dist/__tests__/useCollaborativeEditor.offline.test.js

@@ -1,4 +1,4 @@
-import { renderHook, waitFor } from '@testing-library/react';
+import { act, renderHook, waitFor } from '@testing-library/react';
 import { Awareness } from 'y-protocols/awareness';
 import { describe, expect, it, vi } from 'vitest';
 import * as Y from 'yjs';
@@ -31,4 +31,46 @@ describe('useCollaborativeEditor offline replica binding', () => {
         awareness.destroy();
         yDoc.destroy();
     });
+    it('does not start a second binding while the first async bind is unresolved', async () => {
+        const yDoc = new Y.Doc();
+        yDoc.getMap('nodes').set('node_root', 'persisted');
+        const awareness = new Awareness(yDoc);
+        let notifyStatusChange = () => { };
+        let finishBind = () => { };
+        const bindReady = new Promise((resolve) => {
+            finishBind = resolve;
+        });
+        const destroy = vi.fn();
+        const bind = vi.fn(async () => {
+            await bindReady;
+            return { destroy };
+        });
+        const host = {
+            collaboration: {
+                yDoc,
+                awareness,
+                user: { id: 'offline-user', name: 'Offline User', color: '#123456' },
+                getStatus: () => 'disconnected',
+                onStatusChange: (callback) => {
+                    notifyStatusChange = callback;
+                    return () => { };
+                },
+                loadInitialContent: vi.fn(async () => 'must not seed offline'),
+            },
+        };
+        const { result, unmount } = renderHook(() => useCollaborativeEditor(host, {
+            isEmpty: doc => doc.getMap('nodes').size === 0,
+            initializeFromContent: vi.fn(),
+            createBinding: bind,
+        }));
+        await waitFor(() => expect(bind).toHaveBeenCalledTimes(1));
+        act(() => notifyStatusChange());
+        expect(bind).toHaveBeenCalledTimes(1);
+        finishBind();
+        await waitFor(() => expect(result.current.binding).not.toBeNull());
+        unmount();
+        expect(destroy).toHaveBeenCalledTimes(1);
+        awareness.destroy();
+        yDoc.destroy();
+    });
 });

package/dist/agents/AgentProtocol.d.ts

@@ -129,6 +129,14 @@ export interface ProtocolSession {
     platform: string;
     /** Platform-specific session data (for internal use) */
     raw?: RawProtocolSession;
+    /** Number of host-supplied MCP servers this protocol actually delivered. */
+    deliveredMcpServerCount?: number;
+    /**
+     * Model the agent is actually running, when the protocol can observe it.
+     * Absent means "the protocol has no say"; the host then reports the model it
+     * asked for. Never report a requested model a protocol knows was not applied.
+     */
+    appliedModel?: string;
 }
 /**
  * Event types emitted during message streaming
@@ -229,5 +237,17 @@ export interface AgentProtocol {
      * @param session - Session to clean up
      */
     cleanupSession(session: ProtocolSession): void;
+    /**
+     * Compact the session's context in-place, if the transport supports it.
+     *
+     * Optional: a transport that cannot compact simply omits this, and callers
+     * must check for it before offering the action. Do NOT emulate compaction by
+     * sending a `/compact` string as a user turn -- for transports without a real
+     * compaction RPC that reaches the model as literal prompt text and silently
+     * does nothing (#1252).
+     *
+     * @param session - Session whose context should be compacted
+     */
+    compactSession?(session: ProtocolSession): Promise<void>;
 }
 //# sourceMappingURL=AgentProtocol.d.ts.map

package/dist/agents/AgentProtocol.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"AgentProtocol.d.ts","sourceRoot":"","sources":["../../src/agents/AgentProtocol.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"AgentProtocol.d.ts","sourceRoot":"","sources":["../../src/agents/AgentProtocol.ts"],"names":[],"mappings":"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"}

package/dist/agents/AgentProtocolHost.d.ts

@@ -39,7 +39,7 @@
  * See `docs/EXTENSION_ARCHITECTURE.md` and the Phase 4 SDK design doc
  * (Section 4.3) for the full host contract.
  */
-import type { MCPServerConfig } from './index';
+import type { MCPServerConfig } from './index.js';
 /**
  * Permission posture the host has set for the current turn.
  *

package/dist/agents/AgentProtocolHost.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"AgentProtocolHost.d.ts","sourceRoot":"","sources":["../../src/agents/AgentProtocolHost.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAwCG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAE/C;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,MAAM,cAAc,GAAG,KAAK,GAAG,MAAM,GAAG,MAAM,CAAC;AAErD;;;;;GAKG;AACH,MAAM,WAAW,iBAAiB;IAChC;;;OAGG;IACH,IAAI,EAAE,MAAM,CAAC;IAEb;;OAEG;IACH,WAAW,EAAE,MAAM,CAAC;IAEpB;;;OAGG;IACH,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACtC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,WAAW,iBAAiB;IAGhC,uDAAuD;IACvD,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAE7B;;;OAGG;IACH,QAAQ,CAAC,sBAAsB,EAAE,MAAM,CAAC;IAExC;;;OAGG;IACH,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IAIjC,iDAAiD;IACjD,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAE3B,wDAAwD;IACxD,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAE/B;;;OAGG;IACH,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IAExB;;;;OAIG;IACH,QAAQ,CAAC,WAAW,EAAE,WAAW,CAAC;IAElC,yDAAyD;IACzD,QAAQ,CAAC,cAAc,EAAE,cAAc,CAAC;IAExC;;;;;OAKG;IACH,QAAQ,CAAC,UAAU,EAAE,SAAS,eAAe,EAAE,CAAC;IAEhD;;;;OAIG;IACH,QAAQ,CAAC,GAAG,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IAI/C;;;;;;;;;;;OAWG;IACH,MAAM,CACJ,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,OAAO,GAAG,QAAQ,EAC7B,OAAO,EAAE,MAAM,EACf,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GACjC,OAAO,CAAC,IAAI,CAAC,CAAC;IAEjB;;;;;;;;OAQG;IACH,SAAS,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAAC;IAE3D;;;;;;;OAOG;IACH,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;IAErD;;;;OAIG;IACH,kBAAkB,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAErE;;;;;;;;;;;OAWG;IACH,gBAAgB,CAAC,KAAK,EAAE,iBAAiB,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC7D"}
+{"version":3,"file":"AgentProtocolHost.d.ts","sourceRoot":"","sources":["../../src/agents/AgentProtocolHost.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAwCG;AAMH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAElD;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,MAAM,cAAc,GAAG,KAAK,GAAG,MAAM,GAAG,MAAM,CAAC;AAErD;;;;;GAKG;AACH,MAAM,WAAW,iBAAiB;IAChC;;;OAGG;IACH,IAAI,EAAE,MAAM,CAAC;IAEb;;OAEG;IACH,WAAW,EAAE,MAAM,CAAC;IAEpB;;;OAGG;IACH,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACtC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,WAAW,iBAAiB;IAGhC,uDAAuD;IACvD,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAE7B;;;OAGG;IACH,QAAQ,CAAC,sBAAsB,EAAE,MAAM,CAAC;IAExC;;;OAGG;IACH,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IAIjC,iDAAiD;IACjD,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAE3B,wDAAwD;IACxD,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAE/B;;;OAGG;IACH,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IAExB;;;;OAIG;IACH,QAAQ,CAAC,WAAW,EAAE,WAAW,CAAC;IAElC,yDAAyD;IACzD,QAAQ,CAAC,cAAc,EAAE,cAAc,CAAC;IAExC;;;;;OAKG;IACH,QAAQ,CAAC,UAAU,EAAE,SAAS,eAAe,EAAE,CAAC;IAEhD;;;;OAIG;IACH,QAAQ,CAAC,GAAG,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IAI/C;;;;;;;;;;;OAWG;IACH,MAAM,CACJ,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,OAAO,GAAG,QAAQ,EAC7B,OAAO,EAAE,MAAM,EACf,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GACjC,OAAO,CAAC,IAAI,CAAC,CAAC;IAEjB;;;;;;;;OAQG;IACH,SAAS,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAAC;IAE3D;;;;;;;OAOG;IACH,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;IAErD;;;;OAIG;IACH,kBAAkB,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAErE;;;;;;;;;;;OAWG;IACH,gBAAgB,CAAC,KAAK,EAAE,iBAAiB,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC7D"}

package/dist/createReadOnlyHost.d.ts

@@ -21,7 +21,7 @@
  * host.setTheme('light');
  * ```
  */
-import type { EditorHost } from './types/editor.js';
+import type { EditorHost, EditorViewport } from './types/editor.js';
 export interface ReadOnlyHostOptions {
     /** Current theme name (e.g., 'dark', 'light') */
     theme: string;
@@ -34,6 +34,16 @@ export interface ReadOnlyHostOptions {
      * When true, extensions may suppress chrome that doesn't fit inline contexts.
      */
     embedded?: boolean;
+    /**
+     * Receives the editor's scroll viewport when it publishes one.
+     *
+     * Supplied only by a surface that shows several documents in sequence and
+     * wants to carry the reader's place between them -- the feedback detail
+     * popover comparing design alternatives. Absent, `registerViewport` is
+     * absent too, so an extension that checks before registering gets a straight
+     * answer rather than a silent no-op.
+     */
+    onViewportRegistered?(viewport: EditorViewport | null): void;
 }
 export interface ReadOnlyHost extends EditorHost {
     /** Update the theme (call from viewer chrome's theme toggle) */

package/dist/createReadOnlyHost.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"createReadOnlyHost.d.ts","sourceRoot":"","sources":["../src/createReadOnlyHost.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAiC,MAAM,mBAAmB,CAAC;AAEnF,MAAM,WAAW,mBAAmB;IAClC,iDAAiD;IACjD,KAAK,EAAE,MAAM,CAAC;IAEd,4BAA4B;IAC5B,QAAQ,EAAE,MAAM,CAAC;IAEjB,sEAAsE;IACtE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB;;;OAGG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,MAAM,WAAW,YAAa,SAAQ,UAAU;IAC9C,gEAAgE;IAChE,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;CAC/B;AAED;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAChC,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,mBAAmB,GACxB,YAAY,CA8Dd"}
+{"version":3,"file":"createReadOnlyHost.d.ts","sourceRoot":"","sources":["../src/createReadOnlyHost.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,OAAO,KAAK,EAEV,UAAU,EAEV,cAAc,EACf,MAAM,mBAAmB,CAAC;AAE3B,MAAM,WAAW,mBAAmB;IAClC,iDAAiD;IACjD,KAAK,EAAE,MAAM,CAAC;IAEd,4BAA4B;IAC5B,QAAQ,EAAE,MAAM,CAAC;IAEjB,sEAAsE;IACtE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB;;;OAGG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;IAEnB;;;;;;;;OAQG;IACH,oBAAoB,CAAC,CAAC,QAAQ,EAAE,cAAc,GAAG,IAAI,GAAG,IAAI,CAAC;CAC9D;AAED,MAAM,WAAW,YAAa,SAAQ,UAAU;IAC9C,gEAAgE;IAChE,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;CAC/B;AAED;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAChC,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,mBAAmB,GACxB,YAAY,CAiEd"}

package/dist/createReadOnlyHost.js

@@ -60,6 +60,9 @@ export function createReadOnlyHost(content, opts) {
         openHistory: () => { },
         registerMenuItems: (_items) => { },
         registerEditorAPI: () => { },
+        ...(opts.onViewportRegistered
+            ? { registerViewport: opts.onViewportRegistered }
+            : {}),
         setEditorContext: (_context) => { },
         setEditorContextItems: () => { },
         // -- Storage (in-memory, non-persistent) --

package/dist/editorHostCapabilities.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Reading `EditorHost.capabilities`.
+ *
+ * One function so the "host makes no claim" case is decided once instead of in
+ * every extension. See {@link EditorHostCapabilities}.
+ */
+import type { EditorHost, EditorHostCapability } from './types/editor.js';
+/**
+ * Whether `host` really provides `capability`.
+ *
+ * A host with no `capabilities` block is treated as fully capable. That is not
+ * an optimistic guess: the only such host is the Electron renderer, which
+ * predates this contract and does implement every member. Any host that cannot
+ * -- the browser collaborative host, and anything after it -- is required to
+ * populate `capabilities`, so "absent" and "incapable" never overlap.
+ *
+ * ```ts
+ * if (editorHostSupports(host, 'localFileSave')) {
+ *   await host.saveContent(serialize());
+ * }
+ * ```
+ */
+export declare function editorHostSupports(host: Pick<EditorHost, 'capabilities'>, capability: EditorHostCapability): boolean;
+/**
+ * The host's stated reason for withholding `capability`, or null when it is
+ * available (or the host makes no claim). For diagnostics and degraded-mode
+ * copy -- never branch on the string itself, branch on
+ * {@link editorHostSupports}.
+ */
+export declare function editorHostCapabilityGap(host: Pick<EditorHost, 'capabilities'>, capability: EditorHostCapability): string | null;
+//# sourceMappingURL=editorHostCapabilities.d.ts.map

package/dist/editorHostCapabilities.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"editorHostCapabilities.d.ts","sourceRoot":"","sources":["../src/editorHostCapabilities.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EACV,UAAU,EACV,oBAAoB,EACrB,MAAM,mBAAmB,CAAC;AAE3B;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,kBAAkB,CAChC,IAAI,EAAE,IAAI,CAAC,UAAU,EAAE,cAAc,CAAC,EACtC,UAAU,EAAE,oBAAoB,GAC/B,OAAO,CAET;AAED;;;;;GAKG;AACH,wBAAgB,uBAAuB,CACrC,IAAI,EAAE,IAAI,CAAC,UAAU,EAAE,cAAc,CAAC,EACtC,UAAU,EAAE,oBAAoB,GAC/B,MAAM,GAAG,IAAI,CAIf"}

package/dist/editorHostCapabilities.js

@@ -0,0 +1,35 @@
+/**
+ * Reading `EditorHost.capabilities`.
+ *
+ * One function so the "host makes no claim" case is decided once instead of in
+ * every extension. See {@link EditorHostCapabilities}.
+ */
+/**
+ * Whether `host` really provides `capability`.
+ *
+ * A host with no `capabilities` block is treated as fully capable. That is not
+ * an optimistic guess: the only such host is the Electron renderer, which
+ * predates this contract and does implement every member. Any host that cannot
+ * -- the browser collaborative host, and anything after it -- is required to
+ * populate `capabilities`, so "absent" and "incapable" never overlap.
+ *
+ * ```ts
+ * if (editorHostSupports(host, 'localFileSave')) {
+ *   await host.saveContent(serialize());
+ * }
+ * ```
+ */
+export function editorHostSupports(host, capability) {
+    return host.capabilities ? host.capabilities.supports(capability) : true;
+}
+/**
+ * The host's stated reason for withholding `capability`, or null when it is
+ * available (or the host makes no claim). For diagnostics and degraded-mode
+ * copy -- never branch on the string itself, branch on
+ * {@link editorHostSupports}.
+ */
+export function editorHostCapabilityGap(host, capability) {
+    const gap = host.capabilities?.unavailable
+        .find((entry) => entry.capability === capability);
+    return gap ? gap.reason : null;
+}

package/dist/externalsPlugin.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"externalsPlugin.d.ts","sourceRoot":"","sources":["../src/externalsPlugin.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,MAAM,CAAC;AAqDnC;;;;;;;;;GASG;AACH,wBAAgB,wBAAwB,IAAI,MAAM,CAyDjD"}
+{"version":3,"file":"externalsPlugin.d.ts","sourceRoot":"","sources":["../src/externalsPlugin.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,MAAM,CAAC;AAoDnC;;;;;;;;;GASG;AACH,wBAAgB,wBAAwB,IAAI,MAAM,CAyDjD"}

package/dist/externalsPlugin.js

@@ -45,7 +45,6 @@ const EXTERNALS_MAP = {
     '@nimbalyst/editor-context': '@nimbalyst/editor-context',
     '@nimbalyst/runtime/ui/icons/MaterialSymbol': '@nimbalyst/runtime/ui/icons/MaterialSymbol',
     '@nimbalyst/screenshot-service': '@nimbalyst/screenshot-service',
-    '@nimbalyst/datamodel-platform-service': '@nimbalyst/datamodel-platform-service',
     // Shared libraries
     'pdfjs-dist': 'pdfjs-dist',
     virtua: 'virtua',
@@ -230,7 +229,7 @@ function generateCommonExports(externalKey) {
     }
     else if (externalKey === '@nimbalyst/runtime') {
         exports = [
-            'MaterialSymbol', 'useDocumentPath', 'useEditorLifecycle',
+            'MaterialSymbol', 'useDocumentPath', 'useEditorLifecycle', 'screenshotService',
             'useCollaborativeEditor', 'COLLAB_INIT_ORIGIN',
             'setTranscriptMarkdownContributions', 'clearTranscriptMarkdownContributions',
             'MarkdownEditor', 'MonacoEditor', 'MonacoCodeEditor',
@@ -241,9 +240,6 @@ function generateCommonExports(externalKey) {
     else if (externalKey === '@nimbalyst/screenshot-service') {
         exports = ['screenshotService'];
     }
-    else if (externalKey === '@nimbalyst/datamodel-platform-service') {
-        exports = ['DataModelPlatformServiceImpl', 'getInstance'];
-    }
     else if (externalKey === 'pdfjs-dist') {
         exports = ['getDocument', 'GlobalWorkerOptions', 'version'];
     }

package/dist/fileDirectoryTree.d.ts

@@ -11,9 +11,16 @@ export declare function getFilePathBasename(filePath: string): string;
 /**
  * Return a forward-slash path relative to the workspace when the file is inside it.
  * Windows drive paths are compared case-insensitively to match filesystem behavior.
+ *
+ * A multi-root workspace passes every root, primary first. The primary root
+ * still yields a bare relative path, so a single-folder workspace is unchanged;
+ * a file in an attached root is prefixed with that root's heading, which is
+ * what groups it under its own heading in the directory tree instead of
+ * spelling out an absolute path. Deepest matching root wins, so a root checked
+ * out inside another root keeps its own prefix.
  */
-export declare function getWorkspaceRelativeFilePath(filePath: string, workspacePath?: string): string;
+export declare function getWorkspaceRelativeFilePath(filePath: string, workspacePath?: string | string[]): string;
 /** Build a collapsed directory tree for arbitrary file records. */
-export declare function buildFileDirectoryTree<T>(files: T[], getFilePath: (file: T) => string, workspacePath?: string): FileDirectoryNode<T>;
+export declare function buildFileDirectoryTree<T>(files: T[], getFilePath: (file: T) => string, workspacePath?: string | string[]): FileDirectoryNode<T>;
 export declare function getFileDirectoryPaths<T>(node: FileDirectoryNode<T>): string[];
 //# sourceMappingURL=fileDirectoryTree.d.ts.map

package/dist/fileDirectoryTree.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"fileDirectoryTree.d.ts","sourceRoot":"","sources":["../src/fileDirectoryTree.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,iBAAiB,CAAC,CAAC;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,CAAC,EAAE,CAAC;IACX,cAAc,EAAE,GAAG,CAAC,MAAM,EAAE,iBAAiB,CAAC,CAAC,CAAC,CAAC,CAAC;IAClD,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,qFAAqF;AACrF,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAE1D;AAED,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAG5D;AAED;;;GAGG;AACH,wBAAgB,4BAA4B,CAAC,QAAQ,EAAE,MAAM,EAAE,aAAa,CAAC,EAAE,MAAM,GAAG,MAAM,CAkB7F;AA6BD,mEAAmE;AACnE,wBAAgB,sBAAsB,CAAC,CAAC,EACtC,KAAK,EAAE,CAAC,EAAE,EACV,WAAW,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,MAAM,EAChC,aAAa,CAAC,EAAE,MAAM,GACrB,iBAAiB,CAAC,CAAC,CAAC,CAwCtB;AAED,wBAAgB,qBAAqB,CAAC,CAAC,EAAE,IAAI,EAAE,iBAAiB,CAAC,CAAC,CAAC,GAAG,MAAM,EAAE,CAM7E"}
+{"version":3,"file":"fileDirectoryTree.d.ts","sourceRoot":"","sources":["../src/fileDirectoryTree.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,iBAAiB,CAAC,CAAC;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,CAAC,EAAE,CAAC;IACX,cAAc,EAAE,GAAG,CAAC,MAAM,EAAE,iBAAiB,CAAC,CAAC,CAAC,CAAC,CAAC;IAClD,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,qFAAqF;AACrF,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAE1D;AAED,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAG5D;AAwDD;;;;;;;;;;GAUG;AACH,wBAAgB,4BAA4B,CAC1C,QAAQ,EAAE,MAAM,EAChB,aAAa,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,GAChC,MAAM,CAwBR;AA6BD,mEAAmE;AACnE,wBAAgB,sBAAsB,CAAC,CAAC,EACtC,KAAK,EAAE,CAAC,EAAE,EACV,WAAW,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,MAAM,EAChC,aAAa,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,GAChC,iBAAiB,CAAC,CAAC,CAAC,CAwCtB;AAED,wBAAgB,qBAAqB,CAAC,CAAC,EAAE,IAAI,EAAE,iBAAiB,CAAC,CAAC,CAAC,GAAG,MAAM,EAAE,CAM7E"}

package/dist/fileDirectoryTree.js

@@ -6,27 +6,95 @@ export function getFilePathBasename(filePath) {
     const normalizedPath = normalizeFilePath(filePath).replace(/\/+$/, '');
     return normalizedPath.slice(normalizedPath.lastIndexOf('/') + 1);
 }
+/** Relative to one root, or null when the file is not inside it. */
+function relativeToRoot(normalizedFile, rootPath) {
+    const normalizedRoot = normalizeFilePath(rootPath).replace(/\/$/, '');
+    if (!normalizedRoot)
+        return null;
+    const windowsDrivePath = /^[A-Za-z]:\//.test(normalizedFile)
+        && /^[A-Za-z]:\//.test(normalizedRoot);
+    const comparableFile = windowsDrivePath ? normalizedFile.toLowerCase() : normalizedFile;
+    const comparableRoot = windowsDrivePath ? normalizedRoot.toLowerCase() : normalizedRoot;
+    if (comparableFile === comparableRoot)
+        return '';
+    if (comparableFile.startsWith(`${comparableRoot}/`)) {
+        return normalizedFile.slice(normalizedRoot.length + 1);
+    }
+    return null;
+}
+/**
+ * Heading for each attached root, unique within the root list.
+ *
+ * Two roots sharing a basename is ordinary -- `app/api` and `infra/api`, or two
+ * checkouts of the same repo -- and a bare basename would collapse both into
+ * one directory group. Colliding roots grow parent segments until they differ;
+ * everything else stays the bare folder name. The primary root has no heading,
+ * so it never competes.
+ */
+function attachedRootLabels(roots) {
+    const segmentsPerRoot = roots.map((rootPath) => normalizeFilePath(rootPath).replace(/\/+$/, '').split('/').filter(Boolean));
+    const labels = roots.map((_, index) => segmentsPerRoot[index].slice(-1).join('/'));
+    // Grow every still-colliding label by one more parent segment per pass. A
+    // root can only run out of segments once it is the filesystem root, at which
+    // point its label is already unique.
+    for (let depth = 2; depth <= 16; depth++) {
+        const counts = new Map();
+        for (let index = 1; index < labels.length; index++) {
+            counts.set(labels[index], (counts.get(labels[index]) ?? 0) + 1);
+        }
+        if ([...counts.values()].every((count) => count < 2))
+            break;
+        let grew = false;
+        for (let index = 1; index < labels.length; index++) {
+            if ((counts.get(labels[index]) ?? 0) < 2)
+                continue;
+            if (segmentsPerRoot[index].length < depth)
+                continue;
+            labels[index] = segmentsPerRoot[index].slice(-depth).join('/');
+            grew = true;
+        }
+        if (!grew)
+            break;
+    }
+    return labels;
+}
 /**
  * Return a forward-slash path relative to the workspace when the file is inside it.
  * Windows drive paths are compared case-insensitively to match filesystem behavior.
+ *
+ * A multi-root workspace passes every root, primary first. The primary root
+ * still yields a bare relative path, so a single-folder workspace is unchanged;
+ * a file in an attached root is prefixed with that root's heading, which is
+ * what groups it under its own heading in the directory tree instead of
+ * spelling out an absolute path. Deepest matching root wins, so a root checked
+ * out inside another root keeps its own prefix.
  */
 export function getWorkspaceRelativeFilePath(filePath, workspacePath) {
     const normalizedFile = normalizeFilePath(filePath);
-    if (!workspacePath)
+    const roots = typeof workspacePath === 'string' ? [workspacePath] : workspacePath;
+    if (!roots || roots.length === 0)
         return normalizedFile;
-    const normalizedWorkspace = normalizeFilePath(workspacePath).replace(/\/$/, '');
-    const windowsDrivePath = /^[A-Za-z]:\//.test(normalizedFile)
-        && /^[A-Za-z]:\//.test(normalizedWorkspace);
-    const comparableFile = windowsDrivePath ? normalizedFile.toLowerCase() : normalizedFile;
-    const comparableWorkspace = windowsDrivePath
-        ? normalizedWorkspace.toLowerCase()
-        : normalizedWorkspace;
-    if (comparableFile === comparableWorkspace)
-        return '';
-    if (comparableFile.startsWith(`${comparableWorkspace}/`)) {
-        return normalizedFile.slice(normalizedWorkspace.length + 1);
-    }
-    return normalizedFile;
+    let bestIndex = -1;
+    let bestRelative = null;
+    let bestRootLength = -1;
+    roots.forEach((rootPath, index) => {
+        const relative = relativeToRoot(normalizedFile, rootPath);
+        if (relative === null)
+            return;
+        const rootLength = normalizeFilePath(rootPath).replace(/\/$/, '').length;
+        if (rootLength <= bestRootLength)
+            return;
+        bestIndex = index;
+        bestRelative = relative;
+        bestRootLength = rootLength;
+    });
+    if (bestRelative === null)
+        return normalizedFile;
+    if (bestIndex === 0)
+        return bestRelative;
+    // Attached root: name it, so two files called `src/index.ts` in two repos do
+    // not collapse into one directory group.
+    return `${attachedRootLabels(roots)[bestIndex]}/${bestRelative}`;
 }
 function collapseDirectoryTree(node) {
     node.subdirectories.forEach((subdirectory, key) => {