@nimbalyst/extension-sdk 0.5.0 → 0.6.0

package/CHANGELOG.md

@@ -8,6 +8,7 @@ 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 |
@@ -19,6 +20,29 @@ 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.

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/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

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/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) => {

package/dist/gitOperationLog.d.ts

@@ -0,0 +1,104 @@
+/**
+ * Wire contract and pure selectors for the host's Git operation journal.
+ *
+ * The journal lives in the Electron main process and is published over two host
+ * channels: `git:operation-log:get` (hydration) and `git:operation-log-changed`
+ * (live upsert/clear). Both the Git extension's Output tab and Nimbalyst's own
+ * menu-bar indicator project the same journal, so the merge and "what is running
+ * right now" rules have to agree exactly -- two surfaces disagreeing about
+ * whether a push is still in flight is the bug this module exists to prevent.
+ *
+ * Everything here is pure: no React, no IPC, no host runtime.
+ */
+/** Terminal states are everything except `running`. */
+export type GitOperationStatus = 'running' | 'success' | 'error' | 'interrupted';
+/** Who started the command. Absent on journals written before agent activity existed. */
+export type GitOperationSource = 'nimbalyst' | 'agent';
+/**
+ * How the command reached Git. `git` is an app-owned direct invocation with a
+ * meaningful `args` array; `shell` is an observed command line whose Git segment
+ * we detected but did not spawn ourselves.
+ */
+export type GitOperationExecutor = 'git' | 'shell';
+/** An entry exactly as it crosses the IPC boundary (timestamps are epoch ms). */
+export interface GitOperationLogWireEntry {
+    id: string;
+    timestamp: number;
+    updatedAt: number;
+    /** Redacted, display-ready command text. */
+    command: string;
+    executable: 'git';
+    args: string[];
+    cwd: string;
+    status: GitOperationStatus;
+    output: string;
+    stdout: string;
+    stderr: string;
+    error?: string;
+    exitCode?: number;
+    durationMs?: number;
+    source?: GitOperationSource;
+    executor?: GitOperationExecutor;
+    sessionId?: string;
+    provider?: string;
+    providerToolCallId?: string;
+}
+export type GitOperationLogEvent = {
+    workspacePath: string;
+    type: 'upsert';
+    entry: GitOperationLogWireEntry;
+} | {
+    workspacePath: string;
+    type: 'clear';
+};
+/**
+ * Window CustomEvent the host dispatches when the user asks to see Git activity
+ * detail (for example from the menu-bar indicator's running-command row).
+ *
+ * The Git panel owns which tab is showing, and that state is private to the
+ * extension bundle. Rather than let the host reach into it, the host states the
+ * intent and the panel decides how to honour it. `detail.workspacePath` lets a
+ * panel bound to a different workspace ignore the request.
+ */
+export declare const GIT_SHOW_OUTPUT_REQUEST_EVENT = "nimbalyst:git-show-output";
+export interface GitShowOutputRequestDetail {
+    workspacePath: string;
+}
+/** The minimum shape the selectors below need. */
+interface MergeableEntry {
+    id: string;
+    timestamp: number | Date;
+    updatedAt: number;
+    status: GitOperationStatus;
+}
+/**
+ * Fill in metadata that predates the field. A journal written before agent
+ * activity existed only ever recorded app-owned direct `git` invocations, so
+ * that is what an absent `source`/`executor` means -- resolved here at the
+ * projection boundary rather than by rewriting the persisted journal.
+ */
+export declare function normalizeGitOperationEntry(entry: GitOperationLogWireEntry): GitOperationLogWireEntry & {
+    source: GitOperationSource;
+    executor: GitOperationExecutor;
+};
+/**
+ * Fold incoming entries into the current list, newest write per id wins.
+ *
+ * `updatedAt` is the tiebreak rather than arrival order because hydration and
+ * the live subscription race: a `git:operation-log:get` response can land after
+ * upserts it predates, and applying it blindly would rewind a finished
+ * operation back to `running`.
+ */
+export declare function mergeGitOperationEntries<T extends MergeableEntry>(current: T[], incoming: T[]): T[];
+/** Every entry still in flight, oldest first. */
+export declare function selectRunningGitOperations<T extends MergeableEntry>(entries: T[]): T[];
+/**
+ * The entry a single-line indicator should name. Newest start wins: when an
+ * agent kicks off a fetch while a push is already running, the thing the user
+ * just caused is the more informative label.
+ */
+export declare function selectLatestRunningGitOperation<T extends MergeableEntry>(entries: T[]): T | undefined;
+/** The most recently updated entry that has already settled, if any. */
+export declare function selectLatestTerminalGitOperation<T extends MergeableEntry>(entries: T[]): T | undefined;
+export {};
+//# sourceMappingURL=gitOperationLog.d.ts.map

package/dist/gitOperationLog.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gitOperationLog.d.ts","sourceRoot":"","sources":["../src/gitOperationLog.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,uDAAuD;AACvD,MAAM,MAAM,kBAAkB,GAAG,SAAS,GAAG,SAAS,GAAG,OAAO,GAAG,aAAa,CAAC;AAEjF,yFAAyF;AACzF,MAAM,MAAM,kBAAkB,GAAG,WAAW,GAAG,OAAO,CAAC;AAEvD;;;;GAIG;AACH,MAAM,MAAM,oBAAoB,GAAG,KAAK,GAAG,OAAO,CAAC;AAEnD,iFAAiF;AACjF,MAAM,WAAW,wBAAwB;IACvC,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,4CAA4C;IAC5C,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,KAAK,CAAC;IAClB,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,kBAAkB,CAAC;IAC3B,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,kBAAkB,CAAC;IAC5B,QAAQ,CAAC,EAAE,oBAAoB,CAAC;IAChC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,kBAAkB,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED,MAAM,MAAM,oBAAoB,GAC5B;IAAE,aAAa,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,QAAQ,CAAC;IAAC,KAAK,EAAE,wBAAwB,CAAA;CAAE,GAC1E;IAAE,aAAa,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,OAAO,CAAA;CAAE,CAAC;AAE7C;;;;;;;;GAQG;AACH,eAAO,MAAM,6BAA6B,8BAA8B,CAAC;AAEzE,MAAM,WAAW,0BAA0B;IACzC,aAAa,EAAE,MAAM,CAAC;CACvB;AAED,kDAAkD;AAClD,UAAU,cAAc;IACtB,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,kBAAkB,CAAC;CAC5B;AAMD;;;;;GAKG;AACH,wBAAgB,0BAA0B,CACxC,KAAK,EAAE,wBAAwB,GAC9B,wBAAwB,GAAG;IAC5B,MAAM,EAAE,kBAAkB,CAAC;IAC3B,QAAQ,EAAE,oBAAoB,CAAC;CAChC,CAMA;AAED;;;;;;;GAOG;AACH,wBAAgB,wBAAwB,CAAC,CAAC,SAAS,cAAc,EAC/D,OAAO,EAAE,CAAC,EAAE,EACZ,QAAQ,EAAE,CAAC,EAAE,GACZ,CAAC,EAAE,CAWL;AAED,iDAAiD;AACjD,wBAAgB,0BAA0B,CAAC,CAAC,SAAS,cAAc,EAAE,OAAO,EAAE,CAAC,EAAE,GAAG,CAAC,EAAE,CAEtF;AAED;;;;GAIG;AACH,wBAAgB,+BAA+B,CAAC,CAAC,SAAS,cAAc,EACtE,OAAO,EAAE,CAAC,EAAE,GACX,CAAC,GAAG,SAAS,CASf;AAED,wEAAwE;AACxE,wBAAgB,gCAAgC,CAAC,CAAC,SAAS,cAAc,EACvE,OAAO,EAAE,CAAC,EAAE,GACX,CAAC,GAAG,SAAS,CASf"}

package/dist/gitOperationLog.js

@@ -0,0 +1,88 @@
+/**
+ * Wire contract and pure selectors for the host's Git operation journal.
+ *
+ * The journal lives in the Electron main process and is published over two host
+ * channels: `git:operation-log:get` (hydration) and `git:operation-log-changed`
+ * (live upsert/clear). Both the Git extension's Output tab and Nimbalyst's own
+ * menu-bar indicator project the same journal, so the merge and "what is running
+ * right now" rules have to agree exactly -- two surfaces disagreeing about
+ * whether a push is still in flight is the bug this module exists to prevent.
+ *
+ * Everything here is pure: no React, no IPC, no host runtime.
+ */
+/**
+ * Window CustomEvent the host dispatches when the user asks to see Git activity
+ * detail (for example from the menu-bar indicator's running-command row).
+ *
+ * The Git panel owns which tab is showing, and that state is private to the
+ * extension bundle. Rather than let the host reach into it, the host states the
+ * intent and the panel decides how to honour it. `detail.workspacePath` lets a
+ * panel bound to a different workspace ignore the request.
+ */
+export const GIT_SHOW_OUTPUT_REQUEST_EVENT = 'nimbalyst:git-show-output';
+function toMillis(timestamp) {
+    return typeof timestamp === 'number' ? timestamp : timestamp.getTime();
+}
+/**
+ * Fill in metadata that predates the field. A journal written before agent
+ * activity existed only ever recorded app-owned direct `git` invocations, so
+ * that is what an absent `source`/`executor` means -- resolved here at the
+ * projection boundary rather than by rewriting the persisted journal.
+ */
+export function normalizeGitOperationEntry(entry) {
+    return {
+        ...entry,
+        source: entry.source ?? 'nimbalyst',
+        executor: entry.executor ?? 'git',
+    };
+}
+/**
+ * Fold incoming entries into the current list, newest write per id wins.
+ *
+ * `updatedAt` is the tiebreak rather than arrival order because hydration and
+ * the live subscription race: a `git:operation-log:get` response can land after
+ * upserts it predates, and applying it blindly would rewind a finished
+ * operation back to `running`.
+ */
+export function mergeGitOperationEntries(current, incoming) {
+    const byId = new Map(current.map((entry) => [entry.id, entry]));
+    for (const entry of incoming) {
+        const existing = byId.get(entry.id);
+        if (!existing || entry.updatedAt >= existing.updatedAt) {
+            byId.set(entry.id, entry);
+        }
+    }
+    return Array.from(byId.values()).sort((a, b) => toMillis(a.timestamp) - toMillis(b.timestamp));
+}
+/** Every entry still in flight, oldest first. */
+export function selectRunningGitOperations(entries) {
+    return entries.filter((entry) => entry.status === 'running');
+}
+/**
+ * The entry a single-line indicator should name. Newest start wins: when an
+ * agent kicks off a fetch while a push is already running, the thing the user
+ * just caused is the more informative label.
+ */
+export function selectLatestRunningGitOperation(entries) {
+    let latest;
+    for (const entry of entries) {
+        if (entry.status !== 'running')
+            continue;
+        if (!latest || toMillis(entry.timestamp) >= toMillis(latest.timestamp)) {
+            latest = entry;
+        }
+    }
+    return latest;
+}
+/** The most recently updated entry that has already settled, if any. */
+export function selectLatestTerminalGitOperation(entries) {
+    let latest;
+    for (const entry of entries) {
+        if (entry.status === 'running')
+            continue;
+        if (!latest || entry.updatedAt >= latest.updatedAt) {
+            latest = entry;
+        }
+    }
+    return latest;
+}

package/dist/index.d.ts

@@ -38,4 +38,5 @@ export { buildFileDirectoryTree, getFileDirectoryPaths, getFilePathBasename, get
 export { validateExtensionBundle, printValidationResult, type ValidationResult, } from './validate.js';
 export { validateBackendModules, assertBackendModulesValid, effectiveModulePermissions, validateAgentProviders, assertAgentProvidersValid, extractBackendModuleIds, MAX_AGENT_PROVIDERS_PER_EXTENSION, type BackendModuleValidationIssue, type AgentProviderValidationIssue, } from './manifestValidation.js';
 export type { AgentProtocol, ProtocolEvent, ProtocolMessage, ProtocolSession, SessionOptions, ProtocolEventType, ToolResult as ProtocolToolResult, MCPServerConfig, RawProtocolSession, AgentProtocolHost, PermissionMode, McpToolDefinition, } from './agents/index.js';
+export { screenshotService } from '@nimbalyst/runtime';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAGH,OAAO,EACL,kBAAkB,EAClB,iBAAiB,EACjB,gBAAgB,EAChB,KAAK,gBAAgB,GACtB,MAAM,gBAAgB,CAAC;AAGxB,cAAc,kBAAkB,CAAC;AAGjC,OAAO,EACL,kBAAkB,EAClB,KAAK,yBAAyB,EAC9B,KAAK,wBAAwB,EAC7B,KAAK,SAAS,GACf,MAAM,yBAAyB,CAAC;AAEjC,OAAO,EACL,kBAAkB,EAClB,uBAAuB,GACxB,MAAM,6BAA6B,CAAC;AAErC,OAAO,EACL,sBAAsB,EACtB,kBAAkB,EAClB,KAAK,4BAA4B,EACjC,KAAK,4BAA4B,EACjC,KAAK,0BAA0B,GAChC,MAAM,6BAA6B,CAAC;AAErC,OAAO,EACL,8BAA8B,EAC9B,6CAA6C,EAC7C,yBAAyB,EACzB,KAAK,+BAA+B,GACrC,MAAM,4CAA4C,CAAC;AAEpD,OAAO,EACL,aAAa,EACb,YAAY,EACZ,KAAK,aAAa,GACnB,MAAM,6BAA6B,CAAC;AAGrC,OAAO,EACL,eAAe,EACf,KAAK,wBAAwB,GAC9B,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAIrD,OAAO,EACL,oBAAoB,EACpB,sBAAsB,EACtB,0BAA0B,EAC1B,2BAA2B,EAC3B,KAAK,wBAAwB,EAC7B,KAAK,yBAAyB,EAC9B,KAAK,2BAA2B,GACjC,MAAM,wBAAwB,CAAC;AAGhC,OAAO,EACL,kBAAkB,EAClB,KAAK,YAAY,EACjB,KAAK,mBAAmB,GACzB,MAAM,yBAAyB,CAAC;AAGjC,OAAO,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAGhE,OAAO,EACL,sBAAsB,EACtB,qBAAqB,EACrB,mBAAmB,EACnB,4BAA4B,EAC5B,iBAAiB,EACjB,KAAK,iBAAiB,GACvB,MAAM,wBAAwB,CAAC;AAGhC,OAAO,EACL,uBAAuB,EACvB,qBAAqB,EACrB,KAAK,gBAAgB,GACtB,MAAM,eAAe,CAAC;AAEvB,OAAO,EACL,sBAAsB,EACtB,yBAAyB,EACzB,0BAA0B,EAC1B,sBAAsB,EACtB,yBAAyB,EACzB,uBAAuB,EACvB,iCAAiC,EACjC,KAAK,4BAA4B,EACjC,KAAK,4BAA4B,GAClC,MAAM,yBAAyB,CAAC;AAYjC,YAAY,EACV,aAAa,EACb,aAAa,EACb,eAAe,EACf,eAAe,EACf,cAAc,EACd,iBAAiB,EACjB,UAAU,IAAI,kBAAkB,EAChC,eAAe,EACf,kBAAkB,EAClB,iBAAiB,EACjB,cAAc,EACd,iBAAiB,GAClB,MAAM,mBAAmB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAGH,OAAO,EACL,kBAAkB,EAClB,iBAAiB,EACjB,gBAAgB,EAChB,KAAK,gBAAgB,GACtB,MAAM,gBAAgB,CAAC;AAGxB,cAAc,kBAAkB,CAAC;AAGjC,OAAO,EACL,kBAAkB,EAClB,KAAK,yBAAyB,EAC9B,KAAK,wBAAwB,EAC7B,KAAK,SAAS,GACf,MAAM,yBAAyB,CAAC;AAEjC,OAAO,EACL,kBAAkB,EAClB,uBAAuB,GACxB,MAAM,6BAA6B,CAAC;AAErC,OAAO,EACL,sBAAsB,EACtB,kBAAkB,EAClB,KAAK,4BAA4B,EACjC,KAAK,4BAA4B,EACjC,KAAK,0BAA0B,GAChC,MAAM,6BAA6B,CAAC;AAErC,OAAO,EACL,8BAA8B,EAC9B,6CAA6C,EAC7C,yBAAyB,EACzB,KAAK,+BAA+B,GACrC,MAAM,4CAA4C,CAAC;AAEpD,OAAO,EACL,aAAa,EACb,YAAY,EACZ,KAAK,aAAa,GACnB,MAAM,6BAA6B,CAAC;AAGrC,OAAO,EACL,eAAe,EACf,KAAK,wBAAwB,GAC9B,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAIrD,OAAO,EACL,oBAAoB,EACpB,sBAAsB,EACtB,0BAA0B,EAC1B,2BAA2B,EAC3B,KAAK,wBAAwB,EAC7B,KAAK,yBAAyB,EAC9B,KAAK,2BAA2B,GACjC,MAAM,wBAAwB,CAAC;AAGhC,OAAO,EACL,kBAAkB,EAClB,KAAK,YAAY,EACjB,KAAK,mBAAmB,GACzB,MAAM,yBAAyB,CAAC;AAGjC,OAAO,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAGhE,OAAO,EACL,sBAAsB,EACtB,qBAAqB,EACrB,mBAAmB,EACnB,4BAA4B,EAC5B,iBAAiB,EACjB,KAAK,iBAAiB,GACvB,MAAM,wBAAwB,CAAC;AAGhC,OAAO,EACL,uBAAuB,EACvB,qBAAqB,EACrB,KAAK,gBAAgB,GACtB,MAAM,eAAe,CAAC;AAEvB,OAAO,EACL,sBAAsB,EACtB,yBAAyB,EACzB,0BAA0B,EAC1B,sBAAsB,EACtB,yBAAyB,EACzB,uBAAuB,EACvB,iCAAiC,EACjC,KAAK,4BAA4B,EACjC,KAAK,4BAA4B,GAClC,MAAM,yBAAyB,CAAC;AAYjC,YAAY,EACV,aAAa,EACb,aAAa,EACb,eAAe,EACf,eAAe,EACf,cAAc,EACd,iBAAiB,EACjB,UAAU,IAAI,kBAAkB,EAChC,eAAe,EACf,kBAAkB,EAClB,iBAAiB,EACjB,cAAc,EACd,iBAAiB,GAClB,MAAM,mBAAmB,CAAC;AAG3B,OAAO,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/index.js

@@ -47,3 +47,5 @@ export { buildFileDirectoryTree, getFileDirectoryPaths, getFilePathBasename, get
 // Re-export validation
 export { validateExtensionBundle, printValidationResult, } from './validate.js';
 export { validateBackendModules, assertBackendModulesValid, effectiveModulePermissions, validateAgentProviders, assertAgentProvidersValid, extractBackendModuleIds, MAX_AGENT_PROVIDERS_PER_EXTENSION, } from './manifestValidation.js';
+// Host-owned native screenshots for every built-in and extension editor.
+export { screenshotService } from '@nimbalyst/runtime';