@openforge-app/plugin-sdk 0.2.6 → 0.2.8

package/dist/browserSurfaces.d.ts

@@ -9,12 +9,14 @@ export interface BrowserSurfaceNavigationError {
     message: string;
     url: string;
 }
+export type BrowserDevToolsPanel = 'elements' | 'console';
 export interface TaskBrowserSurfaceState {
     url: string;
     title: string;
     loading: boolean;
     canGoBack: boolean;
     canGoForward: boolean;
+    devToolsOpen: boolean;
     error: BrowserSurfaceNavigationError | null;
 }
 export interface BrowserSurfaceCapture {
@@ -63,6 +65,8 @@ export interface TaskBrowserSurfaceController {
     goForward(): Promise<TaskBrowserSurfaceState>;
     reload(): Promise<TaskBrowserSurfaceState>;
     stop(): Promise<TaskBrowserSurfaceState>;
+    openDevTools(panel?: BrowserDevToolsPanel): Promise<TaskBrowserSurfaceState>;
+    closeDevTools(): Promise<TaskBrowserSurfaceState>;
     selectVisibleRegion(): Promise<BrowserSurfaceFeedbackSelection | null>;
     cancelVisibleRegionSelection(): Promise<void>;
     clearVisualFeedback(): Promise<void>;

package/dist/browserSurfacesTesting.d.ts

@@ -1,4 +1,4 @@
-import type { BrowserSurfacesAPI, BrowserSurfaceVisualFeedback, GetOrCreateBrowserSurfaceRequest, TaskBrowserSurfaceState } from './browserSurfaces';
+import type { BrowserSurfacesAPI, BrowserDevToolsPanel, BrowserSurfaceVisualFeedback, GetOrCreateBrowserSurfaceRequest, TaskBrowserSurfaceState } from './browserSurfaces';
 export interface TestingBrowserSurfaceCalls {
     browserSurfaceGetOrCreate: GetOrCreateBrowserSurfaceRequest[];
     browserSurfaceAttachments: Array<{
@@ -22,7 +22,8 @@ export interface TestingBrowserSurfaceCalls {
     browserSurfaceControls: Array<{
         taskId: string;
         id: string;
-        action: 'goBack' | 'goForward' | 'reload' | 'stop';
+        action: 'goBack' | 'goForward' | 'reload' | 'stop' | 'openDevTools' | 'closeDevTools';
+        panel?: BrowserDevToolsPanel;
     }>;
     browserSurfaceSelections: Array<{
         taskId: string;

package/dist/browserSurfacesTesting.js

@@ -1,4 +1,4 @@
-import { BrowserSurfaceError, isAllowedBrowserSurfaceUrl, } from './browserSurfaces';
+import { BrowserSurfaceError, isAllowedBrowserSurfaceUrl, } from './browserSurfaces.js';
 function disposable(dispose) {
     let disposed = false;
     return {
@@ -49,6 +49,7 @@ class TestingTaskBrowserSurface {
             loading: false,
             canGoBack: false,
             canGoForward: false,
+            devToolsOpen: false,
             error: null,
         };
     }
@@ -124,6 +125,23 @@ class TestingTaskBrowserSurface {
         this.publish({ loading: false });
         return this.getState();
     }
+    async openDevTools(panel) {
+        this.assertLive();
+        this.calls.browserSurfaceControls.push({
+            taskId: this.taskId,
+            id: this.id,
+            action: 'openDevTools',
+            ...(panel ? { panel } : {}),
+        });
+        this.publish({ devToolsOpen: true });
+        return this.getState();
+    }
+    async closeDevTools() {
+        this.assertLive();
+        this.calls.browserSurfaceControls.push({ taskId: this.taskId, id: this.id, action: 'closeDevTools' });
+        this.publish({ devToolsOpen: false });
+        return this.getState();
+    }
     async selectVisibleRegion() {
         this.assertLive();
         this.calls.browserSurfaceSelections.push({ taskId: this.taskId, id: this.id });

package/dist/collapsibleSectionState.d.ts

@@ -0,0 +1,10 @@
+export type CollapsedSectionsState = Record<string, boolean>;
+export declare const COLLAPSED_SECTIONS_STORAGE_KEY = "openforge.infoPanelSectionCollapse.v1";
+export declare function pluginSectionKey(pluginId: string, sectionKey: string): string;
+export declare const collapsedSections: {
+    subscribe: (this: void, run: import("svelte/store").Subscriber<CollapsedSectionsState>, invalidate?: () => void) => import("svelte/store").Unsubscriber;
+};
+export declare function isSectionCollapsed(state: CollapsedSectionsState, key: string): boolean;
+export declare function setSectionCollapsed(key: string, collapsed: boolean): void;
+export declare function toggleSection(key: string): void;
+export declare function clearCollapsedSections(): void;

package/dist/collapsibleSectionState.js

@@ -0,0 +1,81 @@
+import { writable } from 'svelte/store';
+// The store started life in the host app as src/lib/infoPanelSectionState.ts. The key is
+// deliberately unchanged: renaming it would reset every user's collapsed sections.
+export const COLLAPSED_SECTIONS_STORAGE_KEY = 'openforge.infoPanelSectionCollapse.v1';
+export function pluginSectionKey(pluginId, sectionKey) {
+    return `plugin:${pluginId}:${sectionKey}`;
+}
+function getLocalStorage() {
+    try {
+        return globalThis.localStorage ?? null;
+    }
+    catch {
+        return null;
+    }
+}
+function readPersisted() {
+    const storage = getLocalStorage();
+    if (storage === null)
+        return {};
+    try {
+        const rawValue = storage.getItem(COLLAPSED_SECTIONS_STORAGE_KEY);
+        if (rawValue === null)
+            return {};
+        const parsed = JSON.parse(rawValue);
+        if (parsed === null || typeof parsed !== 'object' || Array.isArray(parsed))
+            return {};
+        const state = {};
+        for (const [key, value] of Object.entries(parsed)) {
+            if (value === true)
+                state[key] = true;
+        }
+        return state;
+    }
+    catch {
+        return {};
+    }
+}
+function writePersisted(state) {
+    const storage = getLocalStorage();
+    if (storage === null)
+        return;
+    try {
+        // Only persist collapsed sections; expanded is the default and needs no entry.
+        const collapsedOnly = {};
+        for (const [key, value] of Object.entries(state)) {
+            if (value === true)
+                collapsedOnly[key] = true;
+        }
+        if (Object.keys(collapsedOnly).length === 0) {
+            storage.removeItem(COLLAPSED_SECTIONS_STORAGE_KEY);
+            return;
+        }
+        storage.setItem(COLLAPSED_SECTIONS_STORAGE_KEY, JSON.stringify(collapsedOnly));
+    }
+    catch {
+        // Persistence is best effort and must not block the section from rendering.
+    }
+}
+const { subscribe, set, update } = writable(readPersisted());
+export const collapsedSections = { subscribe };
+export function isSectionCollapsed(state, key) {
+    return state[key] === true;
+}
+export function setSectionCollapsed(key, collapsed) {
+    update((current) => {
+        const next = { ...current, [key]: collapsed };
+        writePersisted(next);
+        return next;
+    });
+}
+export function toggleSection(key) {
+    update((current) => {
+        const next = { ...current, [key]: !isSectionCollapsed(current, key) };
+        writePersisted(next);
+        return next;
+    });
+}
+export function clearCollapsedSections() {
+    writePersisted({});
+    set({});
+}

package/dist/domain.d.ts

@@ -314,7 +314,7 @@ export interface ProjectAttention {
     unaddressed_comments: number;
     completed_agents: number;
 }
-export type TaskAttentionState = 'idle' | 'needs-input' | 'paused' | 'agent-done' | 'failed' | 'interrupted' | 'pr-draft' | 'pr-open' | 'ci-failed' | 'changes-requested' | 'unaddressed-comments' | 'ready-to-merge' | 'ready-to-enqueue' | 'pr-queued' | 'pr-merged' | 'pr-closed' | 'ci-running' | 'review-pending' | 'merge-conflict';
+export type TaskAttentionState = 'active' | 'backlog' | 'idle' | 'needs-input' | 'paused' | 'agent-done' | 'failed' | 'interrupted' | 'pr-draft' | 'pr-open' | 'ci-failed' | 'changes-requested' | 'unaddressed-comments' | 'ready-to-merge' | 'ready-to-enqueue' | 'pr-queued' | 'pr-merged' | 'pr-closed' | 'ci-running' | 'review-pending' | 'merge-conflict';
 /** Backend-owned, Task-only Needs Attention read model. */
 export interface TaskAttentionRow {
     task_id: string;
@@ -499,18 +499,6 @@ export interface ReviewSubmission {
     body: string;
     comments: ReviewSubmissionComment[];
 }
-/** Self-review comment for task implementation review */
-export interface SelfReviewComment {
-    id: number;
-    task_id: string;
-    round: number;
-    comment_type: string;
-    file_path: string | null;
-    line_number: number | null;
-    body: string;
-    created_at: number;
-    archived_at: number | null;
-}
 /** One file referenced by a walkthrough step. `hunk_indexes === null` means the entire file's diff belongs to the step. */
 export interface PrWalkthroughStepFile {
     filename: string;

package/dist/frontend.d.ts

@@ -1,10 +1,10 @@
-import type { BrowserSurfaceCapture, BrowserSurfaceFeedbackSelection, BrowserSurfaceVisualFeedback, BrowserSurfaceRegion, BrowserSurfaceErrorCode, BrowserSurfaceNavigationError, BrowserSurfacesAPI, GetOrCreateBrowserSurfaceRequest, TaskBrowserSurfaceController, TaskBrowserSurfaceState } from './browserSurfaces';
-import type { CommandDescriptor, CommandRegistry, CommandRegistration, CommandShortcutMetadata, ComposeTaskRequest, ComposeTaskResult, Disposable, FrontendBackendBridge, FrontendOpenForgeAPI, FrontendPlugin, FrontendPluginContext, FrontendSettingsRegistry, FrontendTaskPaneRegistry, FrontendInjectionPointRegistry, FrontendTaskStartRegistry, FrontendTaskUIRegistry, FrontendViewRegistry, InjectionPointLocation, NavigationAPI, OpenForgeContextChangeHandler, OpenForgeContextSnapshot, OpenForgeNavigationRequest, OpenForgeNavigationSnapshot, TaskLinkHandler, TaskLinkHandlerResult, TaskLinkOpenRequest, TaskLinksAPI, PluginIcon, PluginSidebarNavigationProps, PluginSidebarViewIdentity, PluginInjectionPointProps, PluginInjectionPointRegistration, PluginSettingsSectionProps, PluginSettingsSectionRegistration, PluginSettingsSectionScope, PluginStorageScope, PluginSvgIcon, PluginTaskPaneProps, PluginTaskPaneTabRegistration, PluginTaskUISectionProps, PluginTaskUISectionRegistration, PluginViewProps, PluginViewRegistration, TaskStartPrefixContext, TaskStartPrefixProviderRegistration, PtyBufferState, TerminalImageProtocol } from './types';
+import type { BrowserSurfaceCapture, BrowserDevToolsPanel, BrowserSurfaceFeedbackSelection, BrowserSurfaceVisualFeedback, BrowserSurfaceRegion, BrowserSurfaceErrorCode, BrowserSurfaceNavigationError, BrowserSurfacesAPI, GetOrCreateBrowserSurfaceRequest, TaskBrowserSurfaceController, TaskBrowserSurfaceState } from './browserSurfaces';
+import type { CommandDescriptor, CommandRegistry, CommandRegistration, CommandShortcutMetadata, ComposeTaskRequest, ComposeTaskResult, Disposable, FrontendBackendBridge, FrontendOpenForgeAPI, FrontendPlugin, FrontendPluginContext, FrontendSettingsRegistry, FrontendTaskPaneRegistry, FrontendInjectionPointRegistry, FrontendTaskStartRegistry, FrontendTaskUIRegistry, FrontendViewRegistry, InjectionPointLocation, NavigationAPI, OpenForgeContextChangeHandler, OpenForgeContextSnapshot, OpenForgeNavigationRequest, OpenForgeNavigationSnapshot, TaskLinkHandler, TaskLinkHandlerResult, TaskLinkOpenRequest, TaskLinksAPI, PluginIcon, PluginSidebarNavigationProps, PluginSidebarViewIdentity, PluginInjectionPointProps, PluginInjectionPointRegistration, PluginSettingsSectionProps, PluginSettingsSectionRegistration, PluginSettingsSectionScope, PluginStorageScope, PluginSvgIcon, PluginTaskPaneProps, PluginTaskPaneTabRegistration, PluginTaskUISectionProps, PluginTaskUISectionRegistration, PluginViewProps, PluginViewRegistration, TaskStartPrefixContext, TaskStartPrefixProviderRegistration, PtyBufferState, TerminalImageProtocol, TerminalViewSnapshot } from './types';
 export declare const OPENFORGE_FRONTEND_PLUGIN_MARKER = "__openforgeFrontendPlugin";
 export type MarkedFrontendPlugin<TPlugin extends FrontendPlugin = FrontendPlugin> = TPlugin & {
     readonly [OPENFORGE_FRONTEND_PLUGIN_MARKER]: true;
 };
 export declare function defineFrontendPlugin<const TPlugin extends FrontendPlugin>(plugin: TPlugin): MarkedFrontendPlugin<TPlugin>;
 export { BrowserSurfaceError, isAllowedBrowserSurfaceUrl } from './browserSurfaces';
-export type { BrowserSurfaceCapture, BrowserSurfaceFeedbackSelection, BrowserSurfaceVisualFeedback, BrowserSurfaceRegion, BrowserSurfaceErrorCode, BrowserSurfaceNavigationError, BrowserSurfacesAPI, GetOrCreateBrowserSurfaceRequest, TaskBrowserSurfaceController, TaskBrowserSurfaceState, };
-export type { CommandDescriptor, CommandRegistry, CommandRegistration, CommandShortcutMetadata, ComposeTaskRequest, ComposeTaskResult, Disposable, FrontendBackendBridge, FrontendOpenForgeAPI, FrontendPlugin, FrontendPluginContext, FrontendSettingsRegistry, FrontendTaskPaneRegistry, FrontendInjectionPointRegistry, FrontendTaskStartRegistry, FrontendTaskUIRegistry, FrontendViewRegistry, InjectionPointLocation, NavigationAPI, OpenForgeContextChangeHandler, OpenForgeContextSnapshot, OpenForgeNavigationRequest, OpenForgeNavigationSnapshot, TaskLinkHandler, TaskLinkHandlerResult, TaskLinkOpenRequest, TaskLinksAPI, PluginIcon, PluginSidebarNavigationProps, PluginSidebarViewIdentity, PluginInjectionPointProps, PluginInjectionPointRegistration, PluginSettingsSectionProps, PluginSettingsSectionRegistration, PluginSettingsSectionScope, PluginStorageScope, PluginSvgIcon, PluginTaskPaneProps, PluginTaskPaneTabRegistration, PluginTaskUISectionProps, PluginTaskUISectionRegistration, PluginViewProps, PluginViewRegistration, TaskStartPrefixContext, TaskStartPrefixProviderRegistration, PtyBufferState, TerminalImageProtocol, };
+export type { BrowserSurfaceCapture, BrowserDevToolsPanel, BrowserSurfaceFeedbackSelection, BrowserSurfaceVisualFeedback, BrowserSurfaceRegion, BrowserSurfaceErrorCode, BrowserSurfaceNavigationError, BrowserSurfacesAPI, GetOrCreateBrowserSurfaceRequest, TaskBrowserSurfaceController, TaskBrowserSurfaceState, };
+export type { CommandDescriptor, CommandRegistry, CommandRegistration, CommandShortcutMetadata, ComposeTaskRequest, ComposeTaskResult, Disposable, FrontendBackendBridge, FrontendOpenForgeAPI, FrontendPlugin, FrontendPluginContext, FrontendSettingsRegistry, FrontendTaskPaneRegistry, FrontendInjectionPointRegistry, FrontendTaskStartRegistry, FrontendTaskUIRegistry, FrontendViewRegistry, InjectionPointLocation, NavigationAPI, OpenForgeContextChangeHandler, OpenForgeContextSnapshot, OpenForgeNavigationRequest, OpenForgeNavigationSnapshot, TaskLinkHandler, TaskLinkHandlerResult, TaskLinkOpenRequest, TaskLinksAPI, PluginIcon, PluginSidebarNavigationProps, PluginSidebarViewIdentity, PluginInjectionPointProps, PluginInjectionPointRegistration, PluginSettingsSectionProps, PluginSettingsSectionRegistration, PluginSettingsSectionScope, PluginStorageScope, PluginSvgIcon, PluginTaskPaneProps, PluginTaskPaneTabRegistration, PluginTaskUISectionProps, PluginTaskUISectionRegistration, PluginViewProps, PluginViewRegistration, TaskStartPrefixContext, TaskStartPrefixProviderRegistration, PtyBufferState, TerminalImageProtocol, TerminalViewSnapshot, };

package/dist/index.d.ts

@@ -3,7 +3,7 @@ export type { BrowserSurfaceCapture, BrowserSurfaceFeedbackSelection, BrowserSur
 export { OPENFORGE_PACKAGE_METADATA_SCHEMA, OPENFORGE_PLUGIN_CAPABILITIES, isOpenForgePackageMetadata, isPluginPackageMetadata, isSupportedOpenForgeApiVersion, validateOpenForgePackageMetadata, validatePluginPackageMetadata, } from './manifest';
 export { createMemoryPluginStorage, createMockBackendOpenForgeApi, createMockFrontendOpenForgeApi, createMockOpenForgeApi, createMockPluginContext, createOpenForgeRegistryFake, createTestingCalls, TestingOpenForgeRegistryFake, TestingSubscriptionSink, } from './testing';
 export { DEFAULT_EXTERNAL_TEXT_FILE_CHUNK_SIZE_BYTES, MAX_EXTERNAL_TEXT_FILE_CHUNK_SIZE_BYTES, MIN_EXTERNAL_TEXT_FILE_CHUNK_SIZE_BYTES, TaskFollowUpError, MAX_SUPPORTED_API_VERSION, MIN_SUPPORTED_API_VERSION, OPENFORGE_PLUGIN_API_VERSION, SUPPORTED_OPENFORGE_API_VERSIONS, isPluginViewKey, resolveExternalTextFileChunkSize, makePluginViewKey, parsePluginViewKey, } from './types';
-export type { AgentCommandDescriptor, AgentCommandMetadata, AgentCommandRuntime, AttentionAPI, BackendReadyState, CommandDescriptor, CommandRegistry, CommandRegistration, CommandShortcutMetadata, ComposeTaskRequest, ComposeTaskResult, ConfigureStartPromptContributionRequest, CreateTaskRequest, Disposable, BackendFileSystemAPI, ExternalReadDirectoryRequest, ExternalReadFileRequest, ExternalReadTextFileChunksRequest, ExternalReadFileSystemAPI, FileSystemAPI, UserDataDirectoryRequest, UserDataFileRequest, UserDataFileSystemAPI, UserDataFileWriteRequest, ImplementationRun, InjectionPointLocation, JsonObject, JsonPrimitive, JsonSchema, JsonValue, MaybePromise, KeyValueConfigAPI, NotificationRequest, NavigationAPI, NotificationsAPI, OpenForgeCommonAPI, OpenForgeContextChangeHandler, OpenForgeContextSnapshot, OpenForgeNavigationRequest, OpenForgeNavigationSnapshot, OpenForgePackageMetadata, OpenForgePluginCapability, OpenForgePluginContext, OpenForgePluginPackageJson, PluginCommandInvocationContext, PluginCommandInvocationSource, PluginComponentLoader, PluginComponentModule, PluginEntry, PluginIcon, PluginSidebarNavigationProps, PluginSidebarViewIdentity, PluginInjectionPointProps, PluginSettingsSectionProps, PluginState, PluginSvgIcon, PluginTaskPaneProps, PluginTaskUISectionProps, PluginViewProps, PluginStorage, PluginStorageScope, PluginViewKey, ProjectsAPI, PtyBufferState, ShellAPI, ShellResizeRequest, TaskStartPrefixContext, TaskStartPrefixProviderRegistration, TerminalImageProtocol, ShellSessionRequest, ShellSpawnRequest, ShellTerminalQueryResponseRequest, ShellWriteRequest, StartPromptContribution, SendTaskFollowUpRequest, StartTaskImplementationRequest, TaskFollowUpDisposition, TaskFollowUpErrorCode, TaskFollowUpReceipt, SubscriptionSink, SupportedOpenForgeApiVersion, SystemAPI, TaskLinkHandler, TaskLinkHandlerResult, TaskLinkOpenRequest, TaskLinksAPI, TasksAPI, ValidationError, } from './types';
+export type { AgentCommandDescriptor, AgentCommandMetadata, AgentCommandRuntime, AttentionAPI, BackendReadyState, CommandDescriptor, CommandRegistry, CommandRegistration, CommandShortcutMetadata, ComposeTaskRequest, ComposeTaskResult, ConfigureStartPromptContributionRequest, CreateTaskRequest, Disposable, BackendFileSystemAPI, ExternalReadDirectoryRequest, ExternalReadFileRequest, ExternalReadTextFileChunksRequest, ExternalReadFileSystemAPI, FileSystemAPI, UserDataDirectoryRequest, UserDataFileRequest, UserDataFileSystemAPI, UserDataFileWriteRequest, ImplementationRun, InjectionPointLocation, JsonObject, JsonPrimitive, JsonSchema, JsonValue, MaybePromise, KeyValueConfigAPI, NotificationRequest, NavigationAPI, NotificationsAPI, OpenForgeCommonAPI, OpenForgeContextChangeHandler, OpenForgeContextSnapshot, OpenForgeNavigationRequest, OpenForgeNavigationSnapshot, OpenForgePackageMetadata, OpenForgePluginCapability, OpenForgePluginContext, OpenForgePluginPackageJson, PluginCommandInvocationContext, PluginCommandInvocationSource, PluginComponentLoader, PluginComponentModule, PluginEntry, PluginIcon, PluginSidebarNavigationProps, PluginSidebarViewIdentity, PluginInjectionPointProps, PluginSettingsSectionProps, PluginState, PluginSvgIcon, PluginTaskPaneProps, PluginTaskUISectionProps, PluginViewProps, PluginStorage, PluginStorageScope, PluginViewKey, ProjectsAPI, PtyBufferState, ShellAPI, ShellResizeRequest, TaskStartPrefixContext, TaskStartPrefixProviderRegistration, TerminalImageProtocol, TerminalViewSnapshot, ShellSessionRequest, ShellSpawnRequest, ShellTerminalQueryResponseRequest, ShellWriteRequest, StartPromptContribution, SendTaskFollowUpRequest, StartTaskImplementationRequest, TaskFollowUpDisposition, TaskFollowUpErrorCode, TaskFollowUpReceipt, SubscriptionSink, SupportedOpenForgeApiVersion, SystemAPI, TaskLinkHandler, TaskLinkHandlerResult, TaskLinkOpenRequest, TaskLinksAPI, TasksAPI, ValidationError, } from './types';
 export type { MockBackendOpenForgeAPI, MockFrontendOpenForgeAPI, TestingBackgroundServiceContribution, TestingBackendMethodContribution, TestingCommandContribution, TestingContributionBase, TestingExternalTextFile, TestingExternalTextFileChunksCall, TestingEventListenerContribution, TestingOpenForgeApiCalls, TestingOpenForgeApiOptions, TestingOpenForgeRegistrySnapshot, TestingRuntimeKind, TestingRuntimeScope, TestingSettingsSectionContribution, TestingTaskPaneTabContribution, TestingTaskUISectionContribution, TestingViewContribution, } from './testing';
 export { parseStrictFiniteNumber } from './numberParsing';
 export { buildProjectFileTree, flattenVisibleProjectFileTree, formatProjectFileTreeSize, getProjectFileTreeDepth, getProjectFileTreeItemAccessibility, getProjectFileTreeKeyboardAction, getProjectFileTreeParentPath, hasProjectFileTreeShortcutModifier, projectFileTreePathToId, } from './projectFileTree';

package/dist/publicUiExports.mjs

@@ -10,6 +10,7 @@ const PUBLIC_UI_COMPONENT_NAMES = Object.freeze([
   'PluginViewState',
   'PluginSidebarLink',
   'FileTypeIcon',
+  'CollapsibleSection',
 ])
 
 /**

package/dist/testing/backendServicesFake.d.ts

@@ -1,5 +1,5 @@
 import type { BackendOpenForgeAPI } from '../types';
-import { type TestingRegistryServices } from './support';
+import { type TestingRegistryServices } from './support.js';
 import type { TestingBackendMethodContribution, TestingBackgroundServiceContribution } from './contracts';
 export declare class TestingBackendServicesFake {
     private readonly services;

package/dist/testing/backendServicesFake.js

@@ -1,4 +1,4 @@
-import { assertFunction, createDisposable } from './support';
+import { assertFunction, createDisposable } from './support.js';
 export class TestingBackendServicesFake {
     services;
     backendMethods = new Map();

package/dist/testing/commonApiFake.d.ts

@@ -1,5 +1,5 @@
 import type { BackendOpenForgeAPI, FrontendOpenForgeAPI, OpenForgeCommonAPI } from '../types';
-import { type TestingRegistryServices } from './support';
+import { type TestingRegistryServices } from './support.js';
 import type { TestingCommandContribution, TestingEventListenerContribution } from './contracts';
 export type TestingCommonApi = OpenForgeCommonAPI & Pick<FrontendOpenForgeAPI, 'navigation'>;
 export declare class TestingCommonApiFake {

package/dist/testing/commonApiFake.js

@@ -1,5 +1,5 @@
-import { resolveExternalTextFileChunkSize } from '../types';
-import { assertFunction, assertTitle, commandDescriptor, createDisposable, isJsonValue, normalizeAgentCommandMetadata, } from './support';
+import { resolveExternalTextFileChunkSize } from '../types.js';
+import { assertFunction, assertTitle, commandDescriptor, createDisposable, isJsonValue, normalizeAgentCommandMetadata, } from './support.js';
 const UTF8_ENCODER = new TextEncoder();
 function* splitExternalTextFile(content, maxBytes) {
     let chunk = '';

package/dist/testing/frontendContributionFake.d.ts

@@ -1,6 +1,6 @@
-import { type TaskBrowserSurfaceState } from '../browserSurfaces';
+import { type TaskBrowserSurfaceState } from '../browserSurfaces.js';
 import type { FrontendOpenForgeAPI } from '../types';
-import { type TestingRegistryServices } from './support';
+import { type TestingRegistryServices } from './support.js';
 import type { TestingInjectionPointContribution, TestingTaskStartPrefixProviderContribution, TestingSettingsSectionContribution, TestingTaskPaneTabContribution, TestingTaskUISectionContribution, TestingViewContribution } from './contracts';
 type TestingFrontendContributionApi = Pick<FrontendOpenForgeAPI, 'browserSurfaces' | 'taskLinks' | 'views' | 'taskUI' | 'taskPane' | 'settings' | 'backend' | 'injectionPoints' | 'taskStart'>;
 export declare class TestingFrontendContributionFake {

package/dist/testing/frontendContributionFake.js

@@ -1,6 +1,6 @@
-import { createTestingBrowserSurfaces } from '../browserSurfacesTesting';
-import { isAllowedBrowserSurfaceUrl } from '../browserSurfaces';
-import { assertFunction, assertTitle, createDisposable, } from './support';
+import { createTestingBrowserSurfaces } from '../browserSurfacesTesting.js';
+import { isAllowedBrowserSurfaceUrl } from '../browserSurfaces.js';
+import { assertFunction, assertTitle, createDisposable, } from './support.js';
 export class TestingFrontendContributionFake {
     services;
     invokeBackendMethod;

package/dist/testing/registryFake.d.ts

@@ -1,7 +1,7 @@
 import type { TaskBrowserSurfaceState } from '../browserSurfaces';
 import type { BackendPlugin, BackendPluginContext, FrontendPlugin, FrontendPluginContext, OpenForgePackageMetadata, PluginStorage } from '../types';
 import type { MockBackendOpenForgeAPI, MockFrontendOpenForgeAPI, TestingOpenForgeApiCalls, TestingOpenForgeApiOptions, TestingOpenForgeRegistrySnapshot } from './contracts';
-import { TestingSubscriptionSink } from './support';
+import { TestingSubscriptionSink } from './support.js';
 export declare class TestingOpenForgeRegistryFake {
     readonly pluginId: string;
     readonly projectId: string | null;

package/dist/testing/registryFake.js

@@ -1,7 +1,7 @@
-import { TestingBackendServicesFake } from './backendServicesFake';
-import { TestingCommonApiFake } from './commonApiFake';
-import { TestingFrontendContributionFake } from './frontendContributionFake';
-import { TestingRegistryServices, TestingSubscriptionSink, } from './support';
+import { TestingBackendServicesFake } from './backendServicesFake.js';
+import { TestingCommonApiFake } from './commonApiFake.js';
+import { TestingFrontendContributionFake } from './frontendContributionFake.js';
+import { TestingRegistryServices, TestingSubscriptionSink, } from './support.js';
 export class TestingOpenForgeRegistryFake {
     pluginId;
     projectId;

package/dist/testing.d.ts

@@ -1,3 +1,3 @@
-export { createMockBackendOpenForgeApi, createMockFrontendOpenForgeApi, createMockOpenForgeApi, createMockPluginContext, createOpenForgeRegistryFake, TestingOpenForgeRegistryFake, } from './testing/registryFake';
-export { createMemoryPluginStorage, createTestingCalls, TestingSubscriptionSink, } from './testing/support';
-export type { MockBackendOpenForgeAPI, MockFrontendOpenForgeAPI, TestingBackgroundServiceContribution, TestingBackendMethodContribution, TestingCommandContribution, TestingContributionBase, TestingExternalTextFile, TestingExternalTextFileChunksCall, TestingEventListenerContribution, TestingInjectionPointContribution, TestingOpenForgeApiCalls, TestingOpenForgeApiOptions, TestingOpenForgeRegistrySnapshot, TestingRuntimeKind, TestingRuntimeScope, TestingSettingsSectionContribution, TestingTaskPaneTabContribution, TestingTaskUISectionContribution, TestingViewContribution, } from './testing/contracts';
+export { createMockBackendOpenForgeApi, createMockFrontendOpenForgeApi, createMockOpenForgeApi, createMockPluginContext, createOpenForgeRegistryFake, TestingOpenForgeRegistryFake, } from './testing/registryFake.js';
+export { createMemoryPluginStorage, createTestingCalls, TestingSubscriptionSink, } from './testing/support.js';
+export type { MockBackendOpenForgeAPI, MockFrontendOpenForgeAPI, TestingBackgroundServiceContribution, TestingBackendMethodContribution, TestingCommandContribution, TestingContributionBase, TestingExternalTextFile, TestingExternalTextFileChunksCall, TestingEventListenerContribution, TestingInjectionPointContribution, TestingOpenForgeApiCalls, TestingOpenForgeApiOptions, TestingOpenForgeRegistrySnapshot, TestingRuntimeKind, TestingRuntimeScope, TestingSettingsSectionContribution, TestingTaskPaneTabContribution, TestingTaskUISectionContribution, TestingViewContribution, } from './testing/contracts.js';

package/dist/testing.js

@@ -1,2 +1,2 @@
-export { createMockBackendOpenForgeApi, createMockFrontendOpenForgeApi, createMockOpenForgeApi, createMockPluginContext, createOpenForgeRegistryFake, TestingOpenForgeRegistryFake, } from './testing/registryFake';
-export { createMemoryPluginStorage, createTestingCalls, TestingSubscriptionSink, } from './testing/support';
+export { createMockBackendOpenForgeApi, createMockFrontendOpenForgeApi, createMockOpenForgeApi, createMockPluginContext, createOpenForgeRegistryFake, TestingOpenForgeRegistryFake, } from './testing/registryFake.js';
+export { createMemoryPluginStorage, createTestingCalls, TestingSubscriptionSink, } from './testing/support.js';

package/dist/types.d.ts

@@ -440,8 +440,15 @@ export interface ShellResizeRequest extends ShellSessionRequest {
     cols: number;
     rows: number;
 }
+export interface TerminalViewSnapshot {
+    instanceId: number;
+    watermark: number;
+    data: string;
+}
 export interface PtyBufferState {
+    authority?: 'xterm-authoritative' | 'ghostty-authoritative';
     buffer: string | null;
+    snapshot?: TerminalViewSnapshot | null;
     isLive: boolean;
     instanceId: number | null;
 }

package/dist/types.js

@@ -1,4 +1,4 @@
-import packageMetadataSchemaData from './openforgePackageMetadataSchema.json';
+import packageMetadataSchemaData from './openforgePackageMetadataSchema.json' with { type: 'json' };
 function readSupportedOpenForgeApiVersions() {
     const versions = packageMetadataSchemaData.properties.apiVersion.enum;
     if (!Array.isArray(versions) || versions.length === 0 || !versions.every((version) => typeof version === 'number' && Number.isInteger(version))) {

package/dist/ui/CollapsibleSection.svelte

@@ -0,0 +1,79 @@
+<script lang="ts">
+  import type { Snippet } from 'svelte'
+  import { collapsedSections, isSectionCollapsed, toggleSection } from '../collapsibleSectionState'
+
+  interface Props {
+    // Stable, global key used to persist the collapsed/expanded state. Plugins must
+    // build this with `pluginSectionKey(pluginId, key)` so two plugins cannot collide.
+    sectionKey: string
+    title: string
+    // aria-label for the section landmark (defaults to the title).
+    label?: string
+    // data-task-info-card value (defaults to the section key).
+    cardId?: string
+    ariaLive?: 'polite' | 'off'
+    // A 14px glyph identifying the section, drawn between the disclosure caret and the
+    // title. Keep it decorative: the host hides it from assistive tech so it cannot
+    // pollute the toggle's accessible name.
+    icon?: Snippet
+    // Optional per-section controls (refresh, edit, counts). Rendered as a sibling of
+    // the toggle button — never nested inside it — so nested <button>s stay valid.
+    actions?: Snippet
+    children: Snippet
+  }
+
+  let { sectionKey, title, label, cardId, ariaLive, icon, actions, children }: Props = $props()
+
+  let collapsed = $derived(isSectionCollapsed($collapsedSections, sectionKey))
+  let contentId = $derived(`info-section-${sectionKey}`)
+</script>
+
+<!-- `--section-inset` is the distance from the card edge to the caret. Hosts override it
+     per surface (the task inspector pushes it out to 1.5rem); the header and the body
+     both read it so they can never drift apart. `--section-caret-column` is the caret
+     plus the gap after it, so body content lines up with the icon and title rather than
+     starting under the caret. Keep it equal to the caret's `w-3` plus the header `gap-2`. -->
+<section
+  data-task-info-card={cardId ?? sectionKey}
+  data-card-sizing="natural"
+  class="rounded-lg border border-base-300/70 bg-base-100 overflow-hidden shrink-0 [--section-inset:0.75rem] [--section-caret-column:1.25rem]"
+  aria-label={label ?? title}
+  aria-live={ariaLive}
+>
+  <div class="flex items-stretch {collapsed ? '' : 'border-b border-base-300/70'}">
+    <h3 class="m-0 min-w-0 flex-1">
+      <button
+        type="button"
+        class="flex w-full items-center gap-2 px-[var(--section-inset)] py-2 text-left text-sm font-semibold text-base-content hover:bg-base-200/40 focus-visible:ring-2 focus-visible:ring-primary rounded"
+        aria-expanded={!collapsed}
+        aria-controls={contentId}
+        onclick={() => toggleSection(sectionKey)}
+      >
+        <!-- Fixed-width caret column so every section title starts at the same x,
+             including the single-row cards that render a blank column instead. -->
+        <span
+          class="w-3 shrink-0 text-center text-[0.7rem] leading-none text-base-content/40 transition-transform duration-150 {collapsed ? '-rotate-90' : ''}"
+          aria-hidden="true"
+        >▾</span>
+        {#if icon}
+          <span class="flex shrink-0 items-center text-base-content/50" aria-hidden="true">{@render icon()}</span>
+        {/if}
+        <span class="truncate">{title}</span>
+      </button>
+    </h3>
+    {#if actions}
+      <div class="flex shrink-0 items-center gap-2 pr-2">
+        {@render actions()}
+      </div>
+    {/if}
+  </div>
+
+  {#if !collapsed}
+    <div
+      id={contentId}
+      class="pl-[calc(var(--section-inset)_+_var(--section-caret-column))] pr-[var(--section-inset)]"
+    >
+      {@render children()}
+    </div>
+  {/if}
+</section>

package/dist/ui/MarkdownContent.svelte

@@ -8,6 +8,12 @@
     type ResolvedMarkdownMedia,
   } from '../markdown'
 
+  interface MarkdownImageOpenRequest {
+    src: string
+    alt: string
+    openLink?: () => void
+  }
+
   interface Props {
     content: string
     imageBaseUrl?: string | null
@@ -16,6 +22,7 @@
     resolveRemoteMedia?: (url: string) => Promise<ResolvedMarkdownMedia | null>
     onOpenRepositoryPath?: (repositoryPath: string, suffix: string) => void | Promise<void>
     onOpenUrl?: (url: string) => void | Promise<void>
+    onOpenImage?: (request: MarkdownImageOpenRequest) => void
   }
 
   let {
@@ -26,6 +33,7 @@
     resolveRemoteMedia,
     onOpenRepositoryPath,
     onOpenUrl,
+    onOpenImage,
   }: Props = $props()
 
   let root = $state<HTMLDivElement | null>(null)
@@ -37,6 +45,35 @@
     deferRemoteMedia: Boolean(resolveRemoteMedia),
   }))
 
+  function imageTrigger(image: HTMLImageElement): HTMLElement {
+    return image.closest('a') ?? image
+  }
+
+  function updateInteractiveImage(image: HTMLImageElement) {
+    const trigger = imageTrigger(image)
+    if (!onOpenImage || !image.getAttribute('src')) {
+      if (trigger.dataset.markdownImageTrigger === 'true') {
+        trigger.removeAttribute('role')
+        trigger.removeAttribute('tabindex')
+        trigger.removeAttribute('aria-label')
+        delete trigger.dataset.markdownImageTrigger
+      }
+      image.classList.remove('cursor-zoom-in')
+      return
+    }
+
+    const imageName = image.alt.trim()
+    trigger.setAttribute('role', 'button')
+    if (trigger === image) trigger.setAttribute('tabindex', '0')
+    trigger.setAttribute('aria-label', imageName ? `Open ${imageName} image` : 'Open image preview')
+    trigger.dataset.markdownImageTrigger = 'true'
+    image.classList.add('cursor-zoom-in')
+  }
+
+  function updateInteractiveImages() {
+    if (!root) return
+    root.querySelectorAll('img').forEach(updateInteractiveImage)
+  }
   async function resolveRepositoryImages(runId: number) {
     if (!root || !markdownFilePath || !resolveRepositoryImage) return
 
@@ -50,6 +87,7 @@
         if (runId !== imageResolutionId || !resolvedSrc) return
         image.setAttribute('src', resolvedSrc)
         image.removeAttribute('data-markdown-repository-path')
+        updateInteractiveImage(image)
       } catch {
         // Leave the image inert when an asset is missing or cannot be previewed.
       }
@@ -61,6 +99,7 @@
 
     if (element instanceof HTMLImageElement) {
       element.setAttribute('src', resolved?.url ?? url)
+      updateInteractiveImage(element)
       return
     }
 
@@ -102,6 +141,7 @@
     const runId = ++imageResolutionId
     void html
     if (!root) return
+    updateInteractiveImages()
 
     void resolveRepositoryImages(runId)
     void resolveRemoteMediaElements(runId)
@@ -111,17 +151,10 @@
     imageResolutionId++
   })
 
-  function handleClick(event: MouseEvent) {
-    if (!(event.target instanceof Element)) return
-
-    const anchor = event.target.closest('a')
-    const href = anchor?.getAttribute('href')
-    if (!anchor || !href) return
-
+  function openMarkdownLink(href: string, absoluteHref: string) {
     if (markdownFilePath) {
       const repositoryPath = resolveMarkdownRepositoryPath(href, markdownFilePath)
       if (repositoryPath) {
-        event.preventDefault()
         void onOpenRepositoryPath?.(repositoryPath, getMarkdownRepositoryLinkSuffix(href))
         return
       }
@@ -129,14 +162,62 @@
 
     if (href.startsWith('#')) return
 
-    event.preventDefault()
-    if (onOpenUrl && anchor.href) {
-      void onOpenUrl(href.startsWith('//') ? `https:${href}` : anchor.href)
+    if (onOpenUrl && absoluteHref) {
+      void onOpenUrl(href.startsWith('//') ? `https:${href}` : absoluteHref)
     }
   }
+
+  function openImage(image: HTMLImageElement) {
+    const src = image.getAttribute('src')
+    if (!onOpenImage || !src) return
+
+    const anchor = image.closest('a')
+    const href = anchor?.getAttribute('href')
+    onOpenImage({
+      src,
+      alt: image.alt,
+      openLink: href ? () => openMarkdownLink(href, anchor?.href ?? '') : undefined,
+    })
+  }
+
+  function findEventImage(target: Element): HTMLImageElement | null {
+    const image = target.closest('img')
+    if (image instanceof HTMLImageElement) return image
+
+    return target.closest('a')?.querySelector('img') ?? null
+  }
+
+  function handleClick(event: MouseEvent) {
+    if (!(event.target instanceof Element)) return
+
+    const image = findEventImage(event.target)
+    if (image && onOpenImage && image.getAttribute('src')) {
+      event.preventDefault()
+      imageTrigger(image).focus()
+      openImage(image)
+      return
+    }
+
+    const anchor = event.target.closest('a')
+    const href = anchor?.getAttribute('href')
+    if (!anchor || !href) return
+
+    if (!href.startsWith('#')) event.preventDefault()
+    openMarkdownLink(href, anchor.href)
+  }
+
+  function handleKeydown(event: KeyboardEvent) {
+    if (event.key !== 'Enter' && event.key !== ' ') return
+    if (!(event.target instanceof Element)) return
+
+    const image = findEventImage(event.target)
+    if (!image) return
+
+    event.preventDefault()
+    openImage(image)
+  }
 </script>
 
-<!-- svelte-ignore a11y_click_events_have_key_events -->
-<div bind:this={root} role="presentation" class="markdown-body" onclick={handleClick}>
+<div bind:this={root} role="presentation" class="markdown-body" onclick={handleClick} onkeydown={handleKeydown}>
   {@html html}
 </div>

package/dist/vite.js

@@ -39,6 +39,7 @@ const OPENFORGE_PLUGIN_SDK_SOURCE_ENTRYPOINTS = Object.freeze([
     ['@openforge-app/plugin-sdk/sanitize', 'packages/plugin-sdk/src/sanitize.ts'],
     ['@openforge-app/plugin-sdk/pluginIcons', 'packages/plugin-sdk/src/pluginIcons.ts'],
     ['@openforge-app/plugin-sdk/fileIcons', 'packages/plugin-sdk/src/fileIcons.ts'],
+    ['@openforge-app/plugin-sdk/collapsibleSectionState', 'packages/plugin-sdk/src/collapsibleSectionState.ts'],
     ...OPENFORGE_PLUGIN_SDK_PUBLIC_UI_EXPORTS.map(({ importSpecifier, workspaceSourcePath }) => [importSpecifier, workspaceSourcePath]),
     ['@openforge-app/plugin-sdk', 'packages/plugin-sdk/src/index.ts'],
 ]);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@openforge-app/plugin-sdk",
-  "version": "0.2.6",
+  "version": "0.2.8",
   "license": "MIT",
   "repository": {
     "type": "git",
@@ -64,6 +64,10 @@
       "types": "./dist/fileIcons.d.ts",
       "default": "./dist/fileIcons.js"
     },
+    "./collapsibleSectionState": {
+      "types": "./dist/collapsibleSectionState.d.ts",
+      "default": "./dist/collapsibleSectionState.js"
+    },
     "./ui/Button.svelte": "./dist/ui/Button.svelte",
     "./ui/Checkbox.svelte": "./dist/ui/Checkbox.svelte",
     "./ui/MarkdownContent.svelte": "./dist/ui/MarkdownContent.svelte",
@@ -72,7 +76,8 @@
     "./ui/PluginPageHeader.svelte": "./dist/ui/PluginPageHeader.svelte",
     "./ui/PluginViewState.svelte": "./dist/ui/PluginViewState.svelte",
     "./ui/PluginSidebarLink.svelte": "./dist/ui/PluginSidebarLink.svelte",
-    "./ui/FileTypeIcon.svelte": "./dist/ui/FileTypeIcon.svelte"
+    "./ui/FileTypeIcon.svelte": "./dist/ui/FileTypeIcon.svelte",
+    "./ui/CollapsibleSection.svelte": "./dist/ui/CollapsibleSection.svelte"
   },
   "files": [
     "dist",