@openforge-app/plugin-sdk 0.2.5 → 0.2.7

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

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

@@ -117,6 +117,7 @@ export interface PrComment {
     outdated: number;
     created_at: number;
 }
+export type PullRequestMergeMethod = 'merge' | 'squash' | 'rebase';
 export interface PullRequestInfo {
     id: number;
     pr_number: number;
@@ -149,6 +150,9 @@ export interface PullRequestInfo {
     merge_queue_required: boolean | null;
     merge_queue_state: string | null;
     readiness_updated_at: number | null;
+    merge_methods_policy_known?: boolean | null;
+    allowed_merge_methods?: string | PullRequestMergeMethod[] | null;
+    default_merge_method?: PullRequestMergeMethod | null;
 }
 export type PollOutcome = 'completed' | 'missing_github_token' | 'github_token_unavailable' | 'failed' | 'rate_limited';
 export interface PollResult {
@@ -310,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;
@@ -495,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,4 +1,4 @@
-import type { BrowserSurfaceCapture, BrowserSurfaceFeedbackSelection, BrowserSurfaceVisualFeedback, BrowserSurfaceRegion, BrowserSurfaceErrorCode, BrowserSurfaceNavigationError, BrowserSurfacesAPI, GetOrCreateBrowserSurfaceRequest, TaskBrowserSurfaceController, TaskBrowserSurfaceState } from './browserSurfaces';
+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 } from './types';
 export declare const OPENFORGE_FRONTEND_PLUGIN_MARKER = "__openforgeFrontendPlugin";
 export type MarkedFrontendPlugin<TPlugin extends FrontendPlugin = FrontendPlugin> = TPlugin & {
@@ -6,5 +6,5 @@ export type MarkedFrontendPlugin<TPlugin extends FrontendPlugin = FrontendPlugin
 };
 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 { 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, };

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, 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, 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/prStatusPresentation.d.ts

@@ -1,8 +1,9 @@
-import { type MergeReadinessAction, type MergeReadinessDetail, type MergeReadinessStatus, type MergeStatusInfo } from './domain';
+import { type MergeReadinessAction, type MergeReadinessDetail, type MergeReadinessStatus, type MergeStatusInfo, type PullRequestMergeMethod } from './domain';
 export type PrChipSurface = 'compact' | 'detail';
 export type PrChipVariant = 'success' | 'error' | 'pending' | 'muted' | 'neutral' | 'done' | 'merged' | 'closed';
 export type PrChipType = 'draft' | 'ci' | 'review' | 'merge';
 export type PrChipIcon = 'check' | 'cross' | 'clock' | null;
+export declare function getPullRequestMergeActionLabel(method: PullRequestMergeMethod, prNumber?: number): string;
 export interface PrStatusChipSpec {
     type: PrChipType;
     label: string;

package/dist/prStatusPresentation.js

@@ -1,4 +1,15 @@
 import { getMergeReadiness, isClosedUnmergedPullRequest, isMergedPullRequest } from './domain';
+const PULL_REQUEST_MERGE_ACTION_LABELS = {
+    merge: 'Create a merge commit',
+    squash: 'Squash and merge',
+    rebase: 'Rebase and merge',
+};
+export function getPullRequestMergeActionLabel(method, prNumber) {
+    const label = PULL_REQUEST_MERGE_ACTION_LABELS[method];
+    if (prNumber === undefined)
+        return label;
+    return method === 'merge' ? `${label} for PR #${prNumber}` : `${label} PR #${prNumber}`;
+}
 export function getPrStatusChips(pr, surface) {
     const chips = [];
     if (pr.draft && pr.state === 'open') {

package/dist/publicUiExports.mjs

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

package/dist/testing/commonApiFake.js

@@ -146,6 +146,7 @@ export class TestingCommonApiFake {
                 write: async (request) => {
                     this.services.calls.shellWrites.push(request);
                 },
+                writeTerminalQueryResponse: async () => { },
                 resize: async (request) => {
                     this.services.calls.shellResizes.push(request);
                 },
@@ -154,7 +155,7 @@ export class TestingCommonApiFake {
                 },
                 getBuffer: async (request) => {
                     this.services.calls.shellBuffers.push(request);
-                    return { buffer: null, isLive: false };
+                    return { buffer: null, isLive: false, instanceId: null };
                 },
             },
             notifications: {

package/dist/types.d.ts

@@ -432,6 +432,10 @@ export interface ShellSpawnRequest extends ShellSessionRequest {
 export interface ShellWriteRequest extends ShellSessionRequest {
     data: string;
 }
+export interface ShellTerminalQueryResponseRequest extends ShellSessionRequest {
+    ptyInstanceId: number;
+    data: string;
+}
 export interface ShellResizeRequest extends ShellSessionRequest {
     cols: number;
     rows: number;
@@ -439,10 +443,12 @@ export interface ShellResizeRequest extends ShellSessionRequest {
 export interface PtyBufferState {
     buffer: string | null;
     isLive: boolean;
+    instanceId: number | null;
 }
 export interface ShellAPI {
     spawn(request: ShellSpawnRequest): Promise<number>;
     write(request: ShellWriteRequest): Promise<void>;
+    writeTerminalQueryResponse(request: ShellTerminalQueryResponseRequest): Promise<void>;
     resize(request: ShellResizeRequest): Promise<void>;
     kill(request: ShellSessionRequest): Promise<void>;
     getBuffer(request: ShellSessionRequest): Promise<PtyBufferState>;

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.5",
+  "version": "0.2.7",
   "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",

package/dist/context.d.ts

@@ -1,15 +0,0 @@
-import type { Disposable, OpenForgeContextChangeHandler, OpenForgePackageMetadata, OpenForgePluginContext, SubscriptionSink, SupportedOpenForgeApiVersion } from './types';
-declare class SubscriptionSet implements SubscriptionSink {
-    private readonly subscriptions;
-    add(subscription: Disposable | (() => void)): void;
-    disposeAll(): Promise<void>;
-}
-export declare class PluginContextImpl implements OpenForgePluginContext {
-    readonly pluginId: string;
-    readonly apiVersion: SupportedOpenForgeApiVersion;
-    readonly packageMetadata: OpenForgePackageMetadata;
-    readonly subscriptions: SubscriptionSet;
-    onDidChange(_handler: OpenForgeContextChangeHandler): Disposable;
-    constructor(pluginId: string, apiVersion: SupportedOpenForgeApiVersion, packageMetadata: OpenForgePackageMetadata);
-}
-export {};

package/dist/context.js

@@ -1,33 +0,0 @@
-class SubscriptionSet {
-    subscriptions = new Set();
-    add(subscription) {
-        this.subscriptions.add(subscription);
-    }
-    async disposeAll() {
-        const subscriptions = [...this.subscriptions];
-        this.subscriptions.clear();
-        await Promise.all(subscriptions.map(async (subscription) => {
-            if (typeof subscription === 'function') {
-                subscription();
-            }
-            else {
-                await subscription.dispose();
-            }
-        }));
-    }
-}
-export class PluginContextImpl {
-    pluginId;
-    apiVersion;
-    packageMetadata;
-    subscriptions;
-    onDidChange(_handler) {
-        return { dispose: () => undefined };
-    }
-    constructor(pluginId, apiVersion, packageMetadata) {
-        this.pluginId = pluginId;
-        this.apiVersion = apiVersion;
-        this.packageMetadata = packageMetadata;
-        this.subscriptions = new SubscriptionSet();
-    }
-}