@openforge-app/plugin-sdk 0.2.8 → 0.2.10

package/dist/backend.d.ts

@@ -1,3 +1,3 @@
-import type { BackendFileSystemAPI, BackendMethodRegistration, BackendMethodRegistry, BackendOpenForgeAPI, BackendPlugin, BackendPluginContext, BackgroundServiceRegistration, BackgroundServiceRegistry, CommandDescriptor, CommandRegistry, CommandRegistration, CommandShortcutMetadata, Disposable, ExternalReadDirectoryRequest, ExternalReadFileRequest, ExternalReadTextFileChunksRequest, ExternalReadFileSystemAPI, UserDataDirectoryRequest, UserDataFileRequest, UserDataFileSystemAPI, UserDataFileWriteRequest, NavigationAPI, OpenForgeContextChangeHandler, OpenForgeContextSnapshot, OpenForgeNavigationRequest, OpenForgeNavigationSnapshot } from './types';
+import type { BackendFileSystemAPI, BackendMethodRegistration, BackendMethodRegistry, BackendOpenForgeAPI, BackendPlugin, BackendPluginContext, BackgroundServiceRegistration, BackgroundServiceRegistry, CommandDescriptor, CommandRegistry, CommandRegistration, CommandShortcutMetadata, Disposable, ExternalFileMetadata, ExternalReadDirectoryRequest, ExternalReadFileRequest, ExternalReadTextFileChunksRequest, ExternalReadFileSystemAPI, UserDataDirectoryRequest, UserDataFileAppendResult, UserDataFileRequest, UserDataFileSystemAPI, UserDataFileWriteRequest, NavigationAPI, OpenForgeContextChangeHandler, OpenForgeContextSnapshot, OpenForgeNavigationRequest, OpenForgeNavigationSnapshot } from './types';
 export declare function defineBackendPlugin<const TPlugin extends BackendPlugin>(plugin: TPlugin): TPlugin;
-export type { BackendFileSystemAPI, BackendMethodRegistration, BackendMethodRegistry, BackendOpenForgeAPI, BackendPlugin, BackendPluginContext, BackgroundServiceRegistration, BackgroundServiceRegistry, CommandDescriptor, CommandRegistry, CommandRegistration, CommandShortcutMetadata, Disposable, ExternalReadDirectoryRequest, ExternalReadFileRequest, ExternalReadTextFileChunksRequest, ExternalReadFileSystemAPI, UserDataDirectoryRequest, UserDataFileRequest, UserDataFileSystemAPI, UserDataFileWriteRequest, NavigationAPI, OpenForgeContextChangeHandler, OpenForgeContextSnapshot, OpenForgeNavigationRequest, OpenForgeNavigationSnapshot, };
+export type { BackendFileSystemAPI, BackendMethodRegistration, BackendMethodRegistry, BackendOpenForgeAPI, BackendPlugin, BackendPluginContext, BackgroundServiceRegistration, BackgroundServiceRegistry, CommandDescriptor, CommandRegistry, CommandRegistration, CommandShortcutMetadata, Disposable, ExternalFileMetadata, ExternalReadDirectoryRequest, ExternalReadFileRequest, ExternalReadTextFileChunksRequest, ExternalReadFileSystemAPI, UserDataDirectoryRequest, UserDataFileAppendResult, UserDataFileRequest, UserDataFileSystemAPI, UserDataFileWriteRequest, NavigationAPI, OpenForgeContextChangeHandler, OpenForgeContextSnapshot, OpenForgeNavigationRequest, OpenForgeNavigationSnapshot, };

package/dist/collapsibleSectionState.js

@@ -2,6 +2,7 @@ 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';
+const SHARED_STATE_SYMBOL = Symbol.for('com.openforge.plugin-sdk.collapsible-section-state.v1');
 export function pluginSectionKey(pluginId, sectionKey) {
     return `plugin:${pluginId}:${sectionKey}`;
 }
@@ -13,10 +14,10 @@ function getLocalStorage() {
         return null;
     }
 }
-function readPersisted() {
+function readPersisted(fallback = {}) {
     const storage = getLocalStorage();
     if (storage === null)
-        return {};
+        return fallback;
     try {
         const rawValue = storage.getItem(COLLAPSED_SECTIONS_STORAGE_KEY);
         if (rawValue === null)
@@ -32,7 +33,7 @@ function readPersisted() {
         return state;
     }
     catch {
-        return {};
+        return fallback;
     }
 }
 function writePersisted(state) {
@@ -56,23 +57,40 @@ function writePersisted(state) {
         // Persistence is best effort and must not block the section from rendering.
     }
 }
-const { subscribe, set, update } = writable(readPersisted());
+function updatePersistedSection(current, key, collapsed) {
+    // localStorage is the cross-realm source of truth. Re-read it for every mutation so
+    // a bundle that cannot share this page's singleton still cannot overwrite newer keys.
+    const next = { ...readPersisted(current) };
+    if (collapsed)
+        next[key] = true;
+    else
+        delete next[key];
+    writePersisted(next);
+    return next;
+}
+function getSharedState() {
+    const registry = globalThis;
+    const existing = registry[SHARED_STATE_SYMBOL];
+    if (existing !== undefined)
+        return existing;
+    // Trusted Plugin bundles contain their own copy of this module. Symbol.for gives those
+    // copies and the host one live access to the same Svelte store in this renderer realm.
+    const shared = { store: writable(readPersisted()) };
+    registry[SHARED_STATE_SYMBOL] = shared;
+    return shared;
+}
+const { subscribe, set, update } = getSharedState().store;
 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;
-    });
+    update((current) => updatePersistedSection(current, key, collapsed));
 }
 export function toggleSection(key) {
     update((current) => {
-        const next = { ...current, [key]: !isSectionCollapsed(current, key) };
-        writePersisted(next);
-        return next;
+        const latest = readPersisted(current);
+        return updatePersistedSection(latest, key, !isSectionCollapsed(latest, key));
     });
 }
 export function clearCollapsedSections() {

package/dist/domain.d.ts

@@ -179,6 +179,7 @@ export interface MergeReadinessInfo extends MergeStatusInfo {
     review_status?: string | null;
     draft?: boolean;
     is_queued?: boolean;
+    merge_queue_required?: boolean | null;
     unaddressed_comment_count?: number;
     head_sha?: string | null;
     updated_at?: number | null;

package/dist/domain.js

@@ -199,7 +199,8 @@ export function getMergeReadiness(pr, options = {}) {
         warnings.push(mergeReadinessDetail('unprotected_fallback', 'Using simple mergeability because no protected-branch checks or review state are available.'));
     }
     if (hasDirectMergeability || isUnprotectedFallback) {
-        return mergeReadinessResult(pr, options.requireMergeQueue === true ? 'ready_to_enqueue' : 'ready_to_merge', options.requireMergeQueue === true ? 'enqueue' : 'merge', blockers, warnings);
+        const mergeQueueRequired = options.requireMergeQueue === true || pr.merge_queue_required === true;
+        return mergeReadinessResult(pr, mergeQueueRequired ? 'ready_to_enqueue' : 'ready_to_merge', mergeQueueRequired ? 'enqueue' : 'merge', blockers, warnings);
     }
     if (mergeableState === 'unknown' || pr.mergeable === null || (mergeableState === null && pr.mergeable !== false)) {
         warnings.push(mergeReadinessDetail('mergeability_unknown', 'GitHub has not reported definitive mergeability yet.'));

package/dist/frontend.d.ts

@@ -1,5 +1,5 @@
 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';
+import type { CommandDescriptor, CommandRegistry, CommandRegistration, CommandShortcutMetadata, ComposeTaskRequest, ComposeTaskResult, Disposable, FrontendBackendBridge, FrontendOpenForgeAPI, FrontendPlugin, FrontendPluginContext, FrontendSettingsRegistry, FrontendTaskPaneRegistry, FrontendInjectionPointRegistry, FrontendTaskStartRegistry, FrontendReviewUIRegistry, FrontendTaskUIRegistry, FrontendViewRegistry, InjectionPointLocation, NavigationAPI, OpenForgeContextChangeHandler, OpenForgeContextSnapshot, OpenForgeNavigationRequest, OpenForgeNavigationSnapshot, PluginIcon, PluginSidebarNavigationProps, PluginSidebarViewIdentity, PluginInjectionPointProps, PluginInjectionPointRegistration, PluginSettingsSectionProps, PluginSettingsSectionRegistration, PluginSettingsSectionScope, PluginStorageScope, PluginSvgIcon, PluginTaskPaneProps, PluginTaskPaneTabRegistration, PluginReviewRowActionProps, PluginReviewRowActionRegistration, 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;
@@ -7,4 +7,4 @@ 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, 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, };
+export type { CommandDescriptor, CommandRegistry, CommandRegistration, CommandShortcutMetadata, ComposeTaskRequest, ComposeTaskResult, Disposable, FrontendBackendBridge, FrontendOpenForgeAPI, FrontendPlugin, FrontendPluginContext, FrontendSettingsRegistry, FrontendTaskPaneRegistry, FrontendInjectionPointRegistry, FrontendTaskStartRegistry, FrontendReviewUIRegistry, FrontendTaskUIRegistry, FrontendViewRegistry, InjectionPointLocation, NavigationAPI, OpenForgeContextChangeHandler, OpenForgeContextSnapshot, OpenForgeNavigationRequest, OpenForgeNavigationSnapshot, PluginIcon, PluginSidebarNavigationProps, PluginSidebarViewIdentity, PluginInjectionPointProps, PluginInjectionPointRegistration, PluginSettingsSectionProps, PluginSettingsSectionRegistration, PluginSettingsSectionScope, PluginStorageScope, PluginSvgIcon, PluginTaskPaneProps, PluginTaskPaneTabRegistration, PluginReviewRowActionProps, PluginReviewRowActionRegistration, PluginTaskUISectionProps, PluginTaskUISectionRegistration, PluginViewProps, PluginViewRegistration, TaskStartPrefixContext, TaskStartPrefixProviderRegistration, PtyBufferState, TerminalImageProtocol, TerminalViewSnapshot, };

package/dist/index.d.ts

@@ -2,8 +2,8 @@ export { BrowserSurfaceError, isAllowedBrowserSurfaceUrl } from './browserSurfac
 export type { BrowserSurfaceCapture, BrowserSurfaceFeedbackSelection, BrowserSurfaceVisualFeedback, BrowserSurfaceRegion, BrowserSurfaceErrorCode, BrowserSurfaceNavigationError, BrowserSurfacesAPI, GetOrCreateBrowserSurfaceRequest, TaskBrowserSurfaceController, TaskBrowserSurfaceState, } from './browserSurfaces';
 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, TerminalViewSnapshot, ShellSessionRequest, ShellSpawnRequest, ShellTerminalQueryResponseRequest, ShellWriteRequest, StartPromptContribution, SendTaskFollowUpRequest, StartTaskImplementationRequest, TaskFollowUpDisposition, TaskFollowUpErrorCode, TaskFollowUpReceipt, SubscriptionSink, SupportedOpenForgeApiVersion, SystemAPI, TaskLinkHandler, TaskLinkHandlerResult, TaskLinkOpenRequest, TaskLinksAPI, TasksAPI, ValidationError, } from './types';
+export { MAX_AGENT_SESSION_PAGE_SIZE, 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 { AgentSessionCursor, AgentSessionOverlap, AgentSessionsAPI, AgentSessionSummary, AgentSessionSummaryPage, AgentSessionTaskSummary, AgentSessionWorkspace, AgentCommandDescriptor, AgentCommandMetadata, AgentCommandRuntime, AttentionAPI, BackendReadyState, CommandDescriptor, CommandRegistry, CommandRegistration, CommandShortcutMetadata, ComposeTaskRequest, ComposeTaskResult, ConfigureStartPromptContributionRequest, CreateTaskRequest, Disposable, BackendFileSystemAPI, ExternalFileMetadata, ExternalReadDirectoryRequest, ExternalReadFileRequest, ExternalReadTextFileChunksRequest, ExternalReadFileSystemAPI, FileSystemAPI, UserDataDirectoryRequest, UserDataFileAppendResult, UserDataFileRequest, UserDataFileSystemAPI, UserDataFileWriteRequest, ImplementationRun, ListAgentSessionsRequest, ListTaskSessionsRequest, 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, ShellWriteRequest, StartPromptContribution, SendTaskFollowUpRequest, StartTaskImplementationRequest, TaskFollowUpDisposition, TaskFollowUpErrorCode, TaskFollowUpReceipt, SubscriptionSink, SupportedOpenForgeApiVersion, SystemAPI, 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/index.js

@@ -1,7 +1,7 @@
 export { BrowserSurfaceError, isAllowedBrowserSurfaceUrl } from './browserSurfaces';
 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 { MAX_AGENT_SESSION_PAGE_SIZE, 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 { parseStrictFiniteNumber } from './numberParsing';
 export { buildProjectFileTree, flattenVisibleProjectFileTree, formatProjectFileTreeSize, getProjectFileTreeDepth, getProjectFileTreeItemAccessibility, getProjectFileTreeKeyboardAction, getProjectFileTreeParentPath, hasProjectFileTreeShortcutModifier, projectFileTreePathToId, } from './projectFileTree';
 export { canMergePullRequest, getMergeReadiness, hasMergeConflicts, isClosedUnmergedPullRequest, isMergedPullRequest, isQueuedForMerge, isReadyToMerge, parseCheckRuns, preservePullRequestState, splitCheckRuns, } from './domain';

package/dist/manifest.d.ts

@@ -117,6 +117,7 @@ export declare const OPENFORGE_PACKAGE_METADATA_SCHEMA: {
         backend: {
             type: string;
             minLength: number;
+            pattern: string;
             description: string;
         };
         requires: {

package/dist/manifest.js

@@ -28,6 +28,15 @@ function validateOptionalString(value, path) {
     }
     return [];
 }
+function validateBackendEntry(value) {
+    const errors = validateOptionalString(value, 'backend');
+    if (!isNonEmptyString(value))
+        return errors;
+    if (!['.mjs', '.js', '.cjs'].some(extension => value.endsWith(extension))) {
+        errors.push({ path: 'backend', message: 'Must point to a built .mjs, .js, or .cjs artifact' });
+    }
+    return errors;
+}
 function validateEnablement(value) {
     if (value === undefined || value === 'app' || value === 'project') {
         return [];
@@ -117,7 +126,7 @@ export function validateOpenForgePackageMetadata(data) {
     if (data.frontendStyles !== undefined && !isNonEmptyString(data.frontend)) {
         errors.push({ path: 'frontendStyles', message: 'Requires a frontend entry' });
     }
-    errors.push(...validateOptionalString(data.backend, 'backend'));
+    errors.push(...validateBackendEntry(data.backend));
     errors.push(...validateRequires(data.requires));
     if (data.enablement === 'app' && (!Array.isArray(data.requires) || !data.requires.includes('appEnablement'))) {
         errors.push({ path: 'requires', message: 'App enablement requires the appEnablement capability' });
@@ -125,9 +134,6 @@ export function validateOpenForgePackageMetadata(data) {
     if (Array.isArray(data.requires) && data.requires.includes('browserSurfaces') && !isNonEmptyString(data.frontend)) {
         errors.push({ path: 'requires', message: 'browserSurfaces capability requires a frontend entry' });
     }
-    if (Array.isArray(data.requires) && data.requires.includes('taskLinks') && !isNonEmptyString(data.frontend)) {
-        errors.push({ path: 'requires', message: 'taskLinks capability requires a frontend entry' });
-    }
     if (data.contributes !== undefined) {
         errors.push({ path: 'contributes', message: 'Manifest contribution arrays are not supported; register contributions at runtime' });
     }

package/dist/markdown.d.ts

@@ -11,6 +11,15 @@ export interface ResolvedMarkdownMedia {
 }
 /** Attribute holding the original URL of a `<img>`/`<a>` awaiting resolution. */
 export declare const MARKDOWN_REMOTE_MEDIA_ATTRIBUTE = "data-markdown-remote-src";
+export interface RenderedMarkdownCacheStats {
+    capacity: number;
+    size: number;
+    hits: number;
+    misses: number;
+    evictions: number;
+}
+export declare function getRenderedMarkdownCacheStats(): Readonly<RenderedMarkdownCacheStats>;
+export declare function clearRenderedMarkdownCache(): void;
 export declare function resolveMarkdownRepositoryPath(value: string | null, markdownFilePath: string): string | null;
 export declare function getMarkdownRepositoryLinkSuffix(value: string): string;
 export declare function resolveMarkdownImageSrc(src: string | null, imageBaseUrl: string | null | undefined, markdownFilePath?: string): string | null;

package/dist/markdown.js

@@ -6,6 +6,56 @@ const markedOptions = {
     gfm: true,
     breaks: true,
 };
+const RENDERED_MARKDOWN_CACHE_CAPACITY = 100;
+const renderedMarkdownCache = new Map();
+let renderedMarkdownCacheHits = 0;
+let renderedMarkdownCacheMisses = 0;
+let renderedMarkdownCacheEvictions = 0;
+function renderedMarkdownCacheKey(content, options) {
+    return JSON.stringify([
+        content,
+        options.imageBaseUrl ?? null,
+        options.markdownFilePath ?? null,
+        Boolean(options.deferRepositoryImages),
+        Boolean(options.deferRemoteMedia),
+    ]);
+}
+function readRenderedMarkdownCache(key) {
+    const cached = renderedMarkdownCache.get(key);
+    if (cached === undefined) {
+        renderedMarkdownCacheMisses++;
+        return undefined;
+    }
+    renderedMarkdownCacheHits++;
+    renderedMarkdownCache.delete(key);
+    renderedMarkdownCache.set(key, cached);
+    return cached;
+}
+function writeRenderedMarkdownCache(key, html) {
+    if (renderedMarkdownCache.size >= RENDERED_MARKDOWN_CACHE_CAPACITY) {
+        const oldestKey = renderedMarkdownCache.keys().next().value;
+        if (oldestKey !== undefined) {
+            renderedMarkdownCache.delete(oldestKey);
+            renderedMarkdownCacheEvictions++;
+        }
+    }
+    renderedMarkdownCache.set(key, html);
+}
+export function getRenderedMarkdownCacheStats() {
+    return {
+        capacity: RENDERED_MARKDOWN_CACHE_CAPACITY,
+        size: renderedMarkdownCache.size,
+        hits: renderedMarkdownCacheHits,
+        misses: renderedMarkdownCacheMisses,
+        evictions: renderedMarkdownCacheEvictions,
+    };
+}
+export function clearRenderedMarkdownCache() {
+    renderedMarkdownCache.clear();
+    renderedMarkdownCacheHits = 0;
+    renderedMarkdownCacheMisses = 0;
+    renderedMarkdownCacheEvictions = 0;
+}
 function hasAbsoluteOrSpecialUrl(value) {
     return /^[a-z][a-z\d+.-]*:/i.test(value) || value.startsWith('//') || value.startsWith('#');
 }
@@ -144,6 +194,12 @@ function prepareMarkdownMediaSources(html, options) {
     return template.innerHTML;
 }
 export function renderMarkdownHtml(content, options = {}) {
+    const cacheKey = renderedMarkdownCacheKey(content, options);
+    const cached = readRenderedMarkdownCache(cacheKey);
+    if (cached !== undefined)
+        return cached;
     const rawHtml = marked.parse(content, markedOptions);
-    return sanitizeHtml(prepareMarkdownMediaSources(rawHtml, options));
+    const html = sanitizeHtml(prepareMarkdownMediaSources(rawHtml, options));
+    writeRenderedMarkdownCache(cacheKey, html);
+    return html;
 }

package/dist/openforgePackageMetadataSchema.json

@@ -19,15 +19,6 @@
             },
             "then": { "required": ["frontend"] }
         },
-        {
-            "if": {
-                "properties": {
-                    "requires": { "contains": { "const": "taskLinks" } }
-                },
-                "required": ["requires"]
-            },
-            "then": { "required": ["frontend"] }
-        },
         {
             "if": {
                 "properties": { "enablement": { "const": "app" } },
@@ -106,7 +97,8 @@
         "backend": {
             "type": "string",
             "minLength": 1,
-            "description": "Path to the built backend JavaScript entry artifact."
+            "pattern": "\\.(?:mjs|js|cjs)$",
+            "description": "Path to the built backend JavaScript artifact. Use .mjs for new plugins; .js and .cjs remain supported for compatibility. The host runs each backend in a replaceable worker."
         },
         "requires": {
             "type": "array",
@@ -136,9 +128,9 @@
                     "config",
                     "projectConfig",
                     "browserSurfaces",
-                    "taskLinks",
                     "appEnablement",
-                    "customSidebarNavigation"
+                    "customSidebarNavigation",
+                    "reviewUI"
                 ]
             }
         }

package/dist/publicEntrypoints.d.mts

@@ -0,0 +1,26 @@
+export type OpenForgePluginSdkConditionalExport = Readonly<{
+  types: `./dist/${string}.d.ts`
+  default: `./dist/${string}.js`
+}>
+
+export type OpenForgePluginSdkPublicEntrypoint = Readonly<{
+  packageSubpath: '.' | `./${string}`
+  importSpecifier: '@openforge-app/plugin-sdk' | `@openforge-app/plugin-sdk/${string}`
+  sourcePath: `src/${string}`
+  workspaceSourcePath: `packages/plugin-sdk/src/${string}`
+  packageExport: string | OpenForgePluginSdkConditionalExport
+}>
+
+export const OPENFORGE_PLUGIN_SDK_PUBLIC_ENTRYPOINTS: readonly OpenForgePluginSdkPublicEntrypoint[]
+
+export function createOpenForgePluginSdkPackageExports(): Record<
+  string,
+  string | { types: string; default: string }
+>
+
+export function createOpenForgePluginSdkTypeScriptPaths(): Record<string, [string]>
+
+export function assertOpenForgePluginSdkEntrypointRegistries(registries: {
+  packageExports: unknown
+  typeScriptPaths: unknown
+}): void

package/dist/publicEntrypoints.mjs

@@ -0,0 +1,103 @@
+import { isDeepStrictEqual } from 'node:util'
+import { OPENFORGE_PLUGIN_SDK_PUBLIC_UI_EXPORTS } from './publicUiExports.mjs'
+
+const PLUGIN_SDK_PACKAGE_NAME = '@openforge-app/plugin-sdk'
+
+function moduleEntrypoint(packageSubpath, sourceName) {
+  const importSuffix = packageSubpath === '.' ? '' : packageSubpath.slice(1)
+  return Object.freeze({
+    packageSubpath,
+    importSpecifier: `${PLUGIN_SDK_PACKAGE_NAME}${importSuffix}`,
+    sourcePath: `src/${sourceName}.ts`,
+    workspaceSourcePath: `packages/plugin-sdk/src/${sourceName}.ts`,
+    packageExport: Object.freeze({
+      types: `./dist/${sourceName}.d.ts`,
+      default: `./dist/${sourceName}.js`,
+    }),
+  })
+}
+
+const PUBLIC_MODULE_ENTRYPOINTS = [
+  moduleEntrypoint('.', 'index'),
+  moduleEntrypoint('./frontend', 'frontend'),
+  moduleEntrypoint('./backend', 'backend'),
+  moduleEntrypoint('./testing', 'testing'),
+  moduleEntrypoint('./vite', 'vite'),
+  moduleEntrypoint('./domain', 'domain'),
+  moduleEntrypoint('./prStatusPresentation', 'prStatusPresentation'),
+  moduleEntrypoint('./markdown', 'markdown'),
+  moduleEntrypoint('./numberParsing', 'numberParsing'),
+  moduleEntrypoint('./projectFileTree', 'projectFileTree'),
+  moduleEntrypoint('./sanitize', 'sanitize'),
+  moduleEntrypoint('./pluginIcons', 'pluginIcons'),
+  moduleEntrypoint('./fileIcons', 'fileIcons'),
+  moduleEntrypoint('./collapsibleSectionState', 'collapsibleSectionState'),
+  moduleEntrypoint('./taskBrowserDevToolsShortcuts', 'taskBrowserDevToolsShortcuts'),
+]
+
+const PACKAGE_METADATA_SCHEMA_ENTRYPOINT = Object.freeze({
+  packageSubpath: './package-metadata-schema.json',
+  importSpecifier: `${PLUGIN_SDK_PACKAGE_NAME}/package-metadata-schema.json`,
+  sourcePath: 'src/openforgePackageMetadataSchema.json',
+  workspaceSourcePath: 'packages/plugin-sdk/src/openforgePackageMetadataSchema.json',
+  packageExport: './dist/openforgePackageMetadataSchema.json',
+})
+
+const PUBLIC_UI_ENTRYPOINTS = OPENFORGE_PLUGIN_SDK_PUBLIC_UI_EXPORTS.map((entrypoint) => Object.freeze({
+  packageSubpath: entrypoint.packageSubpath,
+  importSpecifier: entrypoint.importSpecifier,
+  sourcePath: entrypoint.sourcePath,
+  workspaceSourcePath: entrypoint.workspaceSourcePath,
+  packageExport: entrypoint.distPath,
+}))
+
+/** Canonical registrations for every public Plugin SDK entrypoint. */
+export const OPENFORGE_PLUGIN_SDK_PUBLIC_ENTRYPOINTS = Object.freeze([
+  ...PUBLIC_MODULE_ENTRYPOINTS.slice(0, 5),
+  PACKAGE_METADATA_SCHEMA_ENTRYPOINT,
+  ...PUBLIC_MODULE_ENTRYPOINTS.slice(5),
+  ...PUBLIC_UI_ENTRYPOINTS,
+])
+
+export function createOpenForgePluginSdkPackageExports() {
+  return Object.fromEntries(
+    OPENFORGE_PLUGIN_SDK_PUBLIC_ENTRYPOINTS.map(({ packageSubpath, packageExport }) => [
+      packageSubpath,
+      typeof packageExport === 'string' ? packageExport : { ...packageExport },
+    ]),
+  )
+}
+
+export function createOpenForgePluginSdkTypeScriptPaths() {
+  return Object.fromEntries(
+    OPENFORGE_PLUGIN_SDK_PUBLIC_ENTRYPOINTS.map(({ importSpecifier, workspaceSourcePath }) => [
+      importSpecifier,
+      [`./${workspaceSourcePath}`],
+    ]),
+  )
+}
+
+export function assertOpenForgePluginSdkEntrypointRegistries({ packageExports, typeScriptPaths }) {
+  assertRegistryMatches('package exports', packageExports, createOpenForgePluginSdkPackageExports())
+  assertRegistryMatches('root TypeScript paths', typeScriptPaths, createOpenForgePluginSdkTypeScriptPaths())
+}
+
+function assertRegistryMatches(registryName, actual, expected) {
+  if (!actual || typeof actual !== 'object' || Array.isArray(actual)) {
+    throw new Error(`Plugin SDK ${registryName} must be an object`)
+  }
+
+  const missingOrMismatched = Object.entries(expected)
+    .filter(([key, value]) => !isDeepStrictEqual(actual[key], value))
+    .map(([key]) => key)
+  const unexpected = Object.keys(actual).filter((key) => !(key in expected))
+
+  if (missingOrMismatched.length === 0 && unexpected.length === 0) return
+
+  const details = [
+    missingOrMismatched.length > 0 ? `missing or mismatched: ${missingOrMismatched.join(', ')}` : null,
+    unexpected.length > 0 ? `not in the canonical manifest: ${unexpected.join(', ')}` : null,
+  ].filter(Boolean)
+
+  throw new Error(`Plugin SDK ${registryName} drifted from the canonical manifest (${details.join('; ')})`)
+}

package/dist/publicUiExports.mjs

@@ -7,9 +7,11 @@ const PUBLIC_UI_COMPONENT_NAMES = Object.freeze([
   'ResizablePanel',
   'Modal',
   'PluginPageHeader',
+  'PluginPageShell',
   'PluginViewState',
   'PluginSidebarLink',
   'FileTypeIcon',
+  'ProjectFileTree',
   'CollapsibleSection',
 ])
 

package/dist/taskBrowserDevToolsShortcuts.d.ts

@@ -0,0 +1,12 @@
+export type TaskBrowserDevToolsShortcutPlatform = 'macos' | 'other';
+export type TaskBrowserDevToolsShortcut = 'toggle' | 'elements' | 'console';
+export interface TaskBrowserDevToolsShortcutInput {
+    key: string;
+    keyDown: boolean;
+    repeat: boolean;
+    control: boolean;
+    shift: boolean;
+    alt: boolean;
+    meta: boolean;
+}
+export declare function classifyTaskBrowserDevToolsShortcut(platform: TaskBrowserDevToolsShortcutPlatform, input: TaskBrowserDevToolsShortcutInput): TaskBrowserDevToolsShortcut | null;

package/dist/taskBrowserDevToolsShortcuts.js

@@ -0,0 +1,20 @@
+export function classifyTaskBrowserDevToolsShortcut(platform, input) {
+    if (!input.keyDown || input.repeat)
+        return null;
+    if (input.key === 'f12')
+        return 'toggle';
+    if (input.key === 'c') {
+        const elementsModified = platform === 'macos'
+            ? input.meta && input.shift && !input.control && !input.alt
+            : input.control && input.shift && !input.meta && !input.alt;
+        return elementsModified ? 'elements' : null;
+    }
+    const modified = platform === 'macos'
+        ? input.meta && input.alt && !input.control && !input.shift
+        : input.control && input.shift && !input.meta && !input.alt;
+    if (!modified)
+        return null;
+    if (input.key === 'i')
+        return 'toggle';
+    return input.key === 'j' ? 'console' : null;
+}