@clipbus/plugin-sdk 0.9.8 → 0.10.0

package/dist/generated/capabilities.generated.d.ts

@@ -0,0 +1,355 @@
+import type { PluginActionResult, PluginAttachmentMutationEntry, PluginConsoleLogLevel, PluginDiagnosticEvent, PluginDiagnosticReason, PluginInfoPanelDocument, PluginSearchExtensionEntry } from './data.generated.js';
+export interface PluginRuntimeInvokePayload {
+    key: string;
+    payload: unknown;
+    timeoutMs?: number;
+}
+export interface PluginRuntimeInvokeResponse {
+    response: unknown;
+}
+export interface PluginItemSetTagsPayload {
+    tags: string[];
+}
+export interface PluginItemSetTagsResponse {
+    tags: string[];
+}
+export interface PluginItemAddTagsPayload {
+    tags: string[];
+}
+export interface PluginItemAddTagsResponse {
+    tags: string[];
+}
+export interface PluginItemRemoveTagsPayload {
+    tags: string[];
+}
+export interface PluginItemRemoveTagsResponse {
+    tags: string[];
+}
+export interface PluginItemSetPinnedPayload {
+    pinned: boolean;
+}
+export interface PluginItemSetPinnedResponse {
+    pinned: boolean;
+}
+export interface PluginItemSetAttachmentsPayload {
+    owner: string;
+    attachmentType: string;
+    attachments: PluginAttachmentMutationEntry[];
+}
+export interface PluginItemSetAttachmentsResponse {
+}
+export interface PluginItemSetSearchExtensionPayload {
+    scope: string;
+    owner: string;
+    entries: PluginSearchExtensionEntry[];
+}
+export interface PluginItemSetSearchExtensionResponse {
+}
+export interface PluginItemMaterializeImagePathPayload {
+}
+export interface PluginItemMaterializeImagePathResponse {
+    path: string;
+}
+export interface PluginItemReadAttachmentPayload {
+    attachmentType: string;
+    attachmentKey: string;
+}
+export interface PluginItemReadAttachmentResponse {
+    payloadJson?: string;
+}
+export interface PluginAssetCurrentItemImageUrlPayload {
+}
+export interface PluginAssetCurrentItemImageUrlResponse {
+    url?: string;
+}
+export interface PluginAssetPathReferenceImageUrlPayload {
+    index: number;
+}
+export interface PluginAssetPathReferenceImageUrlResponse {
+    url?: string;
+}
+export interface PluginAssetCurrentActionInputImageUrlPayload {
+}
+export interface PluginAssetCurrentActionInputImageUrlResponse {
+    url?: string;
+}
+export interface PluginAssetCurrentActionInputPathReferenceImageUrlPayload {
+    index: number;
+}
+export interface PluginAssetCurrentActionInputPathReferenceImageUrlResponse {
+    url?: string;
+}
+export interface PluginAssetAllocateImageTempPathPayload {
+    formatHint: string;
+}
+export interface PluginAssetAllocateImageTempPathResponse {
+    path: string;
+}
+export interface PluginAssetRegisterImagePayload {
+    path: string;
+}
+export interface PluginAssetRegisterImageResponse {
+    url: string;
+}
+export interface PluginClipboardCopyTextPayload {
+    text: string;
+}
+export interface PluginClipboardCopyTextResponse {
+}
+export interface PluginNavigationOpenUrlPayload {
+    url: string;
+}
+export interface PluginNavigationOpenUrlResponse {
+}
+export interface PluginNavigationRevealInFinderPayload {
+    path: string;
+}
+export interface PluginNavigationRevealInFinderResponse {
+}
+export interface PluginNavigationOpenFilePathPayload {
+    path: string;
+}
+export interface PluginNavigationOpenFilePathResponse {
+}
+export interface PluginActionAllocateImageTempPathPayload {
+    formatHint: string;
+}
+export interface PluginActionAllocateImageTempPathResponse {
+    path: string;
+}
+export interface PluginActionMaterializeInputImagePathPayload {
+}
+export interface PluginActionMaterializeInputImagePathResponse {
+    path: string;
+}
+export interface PluginActionAllocateOutputFilePathPayload {
+    suggestedName?: string;
+}
+export interface PluginActionAllocateOutputFilePathResponse {
+    path: string;
+}
+export interface PluginActionSetButtonsPayload {
+    buttons: {
+        id: string;
+        title: string;
+        isEnabled?: boolean;
+    }[];
+}
+export interface PluginActionSetButtonsResponse {
+}
+export interface PluginActionCompletePayload {
+    result: PluginActionResult;
+    userMessage?: string;
+}
+export interface PluginActionCompleteResponse {
+}
+export interface PluginAttachmentRendererSetButtonsPayload {
+    buttons: {
+        id: string;
+        title: string;
+        isEnabled?: boolean;
+    }[];
+}
+export interface PluginAttachmentRendererSetButtonsResponse {
+}
+export interface PluginWindowSetHeightPayload {
+    height: number;
+}
+export interface PluginWindowSetHeightResponse {
+}
+export interface PluginWindowAutoFitPayload {
+}
+export interface PluginWindowAutoFitResponse {
+}
+export interface PluginInfoPanelOpenPayload {
+    document: PluginInfoPanelDocument;
+}
+export interface PluginInfoPanelOpenResponse {
+    panelID: string;
+}
+export interface PluginInfoPanelClosePayload {
+    panelID: string;
+}
+export interface PluginInfoPanelCloseResponse {
+}
+export interface PluginSettingsGetPayload {
+    key: string;
+}
+export interface PluginSettingsGetResponse {
+    value: unknown | null;
+}
+export interface PluginSettingsGetAllPayload {
+}
+export interface PluginSettingsGetAllResponse {
+    settings: Record<string, unknown>;
+}
+export interface PluginConsoleLogPayload {
+    level: PluginConsoleLogLevel;
+    message: string;
+}
+export interface PluginConsoleLogResponse {
+}
+export interface PluginConsoleDiagnosticPayload {
+    level: PluginConsoleLogLevel;
+    event: PluginDiagnosticEvent;
+    reason: PluginDiagnosticReason;
+    count: number;
+    durationMs: number;
+}
+export interface PluginConsoleDiagnosticResponse {
+}
+export interface PluginTextInputStateChangedPayload {
+    isFocused: boolean;
+    isComposing: boolean;
+}
+export interface PluginTextInputStateChangedResponse {
+}
+export interface PluginLocaleGetPayload {
+}
+export interface PluginLocaleGetResponse {
+    locale: string;
+}
+export declare const CAPABILITY_METHOD_NAMES: readonly ["runtime.invoke", "item.setTags", "item.addTags", "item.removeTags", "item.setPinned", "item.setAttachments", "item.setSearchExtension", "item.materializeImagePath", "item.readAttachment", "asset.currentItemImageUrl", "asset.pathReferenceImageUrl", "asset.currentActionInputImageUrl", "asset.currentActionInputPathReferenceImageUrl", "asset.allocateImageTempPath", "asset.registerImage", "clipboard.copyText", "navigation.openUrl", "navigation.revealInFinder", "navigation.openFilePath", "action.allocateImageTempPath", "action.materializeInputImagePath", "action.allocateOutputFilePath", "action.setButtons", "action.complete", "attachmentRenderer.setButtons", "window.setHeight", "window.autoFit", "infoPanel.open", "infoPanel.close", "settings.get", "settings.getAll", "console.log", "console.diagnostic", "textInput.stateChanged", "locale.get"];
+export type CapabilityMethodName = (typeof CAPABILITY_METHOD_NAMES)[number];
+export interface PluginCapabilityMap {
+    'runtime.invoke': {
+        payload: PluginRuntimeInvokePayload;
+        response: PluginRuntimeInvokeResponse;
+    };
+    'item.setTags': {
+        payload: PluginItemSetTagsPayload;
+        response: PluginItemSetTagsResponse;
+    };
+    'item.addTags': {
+        payload: PluginItemAddTagsPayload;
+        response: PluginItemAddTagsResponse;
+    };
+    'item.removeTags': {
+        payload: PluginItemRemoveTagsPayload;
+        response: PluginItemRemoveTagsResponse;
+    };
+    'item.setPinned': {
+        payload: PluginItemSetPinnedPayload;
+        response: PluginItemSetPinnedResponse;
+    };
+    'item.setAttachments': {
+        payload: PluginItemSetAttachmentsPayload;
+        response: PluginItemSetAttachmentsResponse;
+    };
+    'item.setSearchExtension': {
+        payload: PluginItemSetSearchExtensionPayload;
+        response: PluginItemSetSearchExtensionResponse;
+    };
+    'item.materializeImagePath': {
+        payload: PluginItemMaterializeImagePathPayload;
+        response: PluginItemMaterializeImagePathResponse;
+    };
+    'item.readAttachment': {
+        payload: PluginItemReadAttachmentPayload;
+        response: PluginItemReadAttachmentResponse;
+    };
+    'asset.currentItemImageUrl': {
+        payload: PluginAssetCurrentItemImageUrlPayload;
+        response: PluginAssetCurrentItemImageUrlResponse;
+    };
+    'asset.pathReferenceImageUrl': {
+        payload: PluginAssetPathReferenceImageUrlPayload;
+        response: PluginAssetPathReferenceImageUrlResponse;
+    };
+    'asset.currentActionInputImageUrl': {
+        payload: PluginAssetCurrentActionInputImageUrlPayload;
+        response: PluginAssetCurrentActionInputImageUrlResponse;
+    };
+    'asset.currentActionInputPathReferenceImageUrl': {
+        payload: PluginAssetCurrentActionInputPathReferenceImageUrlPayload;
+        response: PluginAssetCurrentActionInputPathReferenceImageUrlResponse;
+    };
+    'asset.allocateImageTempPath': {
+        payload: PluginAssetAllocateImageTempPathPayload;
+        response: PluginAssetAllocateImageTempPathResponse;
+    };
+    'asset.registerImage': {
+        payload: PluginAssetRegisterImagePayload;
+        response: PluginAssetRegisterImageResponse;
+    };
+    'clipboard.copyText': {
+        payload: PluginClipboardCopyTextPayload;
+        response: PluginClipboardCopyTextResponse;
+    };
+    'navigation.openUrl': {
+        payload: PluginNavigationOpenUrlPayload;
+        response: PluginNavigationOpenUrlResponse;
+    };
+    'navigation.revealInFinder': {
+        payload: PluginNavigationRevealInFinderPayload;
+        response: PluginNavigationRevealInFinderResponse;
+    };
+    'navigation.openFilePath': {
+        payload: PluginNavigationOpenFilePathPayload;
+        response: PluginNavigationOpenFilePathResponse;
+    };
+    'action.allocateImageTempPath': {
+        payload: PluginActionAllocateImageTempPathPayload;
+        response: PluginActionAllocateImageTempPathResponse;
+    };
+    'action.materializeInputImagePath': {
+        payload: PluginActionMaterializeInputImagePathPayload;
+        response: PluginActionMaterializeInputImagePathResponse;
+    };
+    'action.allocateOutputFilePath': {
+        payload: PluginActionAllocateOutputFilePathPayload;
+        response: PluginActionAllocateOutputFilePathResponse;
+    };
+    'action.setButtons': {
+        payload: PluginActionSetButtonsPayload;
+        response: PluginActionSetButtonsResponse;
+    };
+    'action.complete': {
+        payload: PluginActionCompletePayload;
+        response: PluginActionCompleteResponse;
+    };
+    'attachmentRenderer.setButtons': {
+        payload: PluginAttachmentRendererSetButtonsPayload;
+        response: PluginAttachmentRendererSetButtonsResponse;
+    };
+    'window.setHeight': {
+        payload: PluginWindowSetHeightPayload;
+        response: PluginWindowSetHeightResponse;
+    };
+    'window.autoFit': {
+        payload: PluginWindowAutoFitPayload;
+        response: PluginWindowAutoFitResponse;
+    };
+    'infoPanel.open': {
+        payload: PluginInfoPanelOpenPayload;
+        response: PluginInfoPanelOpenResponse;
+    };
+    'infoPanel.close': {
+        payload: PluginInfoPanelClosePayload;
+        response: PluginInfoPanelCloseResponse;
+    };
+    'settings.get': {
+        payload: PluginSettingsGetPayload;
+        response: PluginSettingsGetResponse;
+    };
+    'settings.getAll': {
+        payload: PluginSettingsGetAllPayload;
+        response: PluginSettingsGetAllResponse;
+    };
+    'console.log': {
+        payload: PluginConsoleLogPayload;
+        response: PluginConsoleLogResponse;
+    };
+    'console.diagnostic': {
+        payload: PluginConsoleDiagnosticPayload;
+        response: PluginConsoleDiagnosticResponse;
+    };
+    'textInput.stateChanged': {
+        payload: PluginTextInputStateChangedPayload;
+        response: PluginTextInputStateChangedResponse;
+    };
+    'locale.get': {
+        payload: PluginLocaleGetPayload;
+        response: PluginLocaleGetResponse;
+    };
+}

package/dist/generated/data.generated.d.ts

@@ -88,6 +88,8 @@ export interface PluginInfoPanelDocument {
     actions: PluginInfoPanelAction[];
 }
 export type PluginConsoleLogLevel = 'debug' | 'info' | 'warn' | 'error';
+export type PluginDiagnosticEvent = 'action_started' | 'action_completed' | 'action_failed' | 'renderer_ready' | 'renderer_failed' | 'detector_completed' | 'detector_failed' | 'runtime_ready' | 'runtime_failed';
+export type PluginDiagnosticReason = 'none' | 'invalid_input' | 'unsupported' | 'timeout' | 'unavailable' | 'failed';
 export interface PluginClipboardItem {
     id: string;
     type: string;
@@ -223,3 +225,34 @@ export interface PluginActionOperationResult {
     result: PluginActionResult;
     userMessage?: string;
 }
+export interface PluginNodeIPCRequestFrame {
+    id: string;
+    method: string;
+    request: unknown;
+}
+export interface PluginNodeIPCResponseFrame {
+    id?: string;
+    response?: unknown;
+    error?: unknown;
+}
+export interface PluginNodeIPCErrorFrame {
+    name: string;
+    message: string;
+    data?: unknown;
+}
+export interface PluginRuntimePluginDescriptor {
+    id: string;
+    title: string;
+    version: string;
+}
+export type PluginRuntimeHostPlatform = 'macos' | 'windows';
+export interface PluginRuntimeHostDescriptor {
+    platform: PluginRuntimeHostPlatform;
+    hostVersion: string;
+    devMode: boolean;
+}
+export interface PluginRuntimeLaunchContext {
+    plugin: PluginRuntimePluginDescriptor;
+    host: PluginRuntimeHostDescriptor;
+    supportedCapabilities: string[];
+}

package/dist/generated/hostClients.generated.d.ts

@@ -1,14 +1,17 @@
-import type { PluginActionAllocateImageTempPathPayload, PluginActionAllocateImageTempPathResponse, PluginActionAllocateOutputFilePathPayload, PluginActionAllocateOutputFilePathResponse, PluginActionMaterializeInputImagePathResponse, PluginAssetRegisterImagePayload, PluginAssetRegisterImageResponse, PluginClipboardCopyTextPayload, PluginClipboardCopyTextResponse, PluginConsoleLogPayload, PluginConsoleLogResponse, PluginItemAddTagsPayload, PluginItemAddTagsResponse, PluginItemMaterializeImagePathResponse, PluginItemReadAttachmentPayload, PluginItemReadAttachmentResponse, PluginItemRemoveTagsPayload, PluginItemRemoveTagsResponse, PluginItemSetAttachmentsPayload, PluginItemSetAttachmentsResponse, PluginItemSetPinnedPayload, PluginItemSetPinnedResponse, PluginItemSetSearchExtensionPayload, PluginItemSetSearchExtensionResponse, PluginItemSetTagsPayload, PluginItemSetTagsResponse, PluginLocaleGetResponse, PluginNavigationOpenFilePathPayload, PluginNavigationOpenFilePathResponse, PluginNavigationOpenUrlPayload, PluginNavigationOpenUrlResponse, PluginNavigationRevealInFinderPayload, PluginNavigationRevealInFinderResponse, PluginSettingsGetAllResponse, PluginSettingsGetPayload, PluginSettingsGetResponse } from './capabilityClients.generated.js';
-export interface IPCBus {
-    request<Req, Resp>(method: string, payload: Req): Promise<Resp>;
-}
+import type { PluginActionAllocateImageTempPathPayload, PluginActionAllocateImageTempPathResponse, PluginActionAllocateOutputFilePathPayload, PluginActionAllocateOutputFilePathResponse, PluginActionMaterializeInputImagePathResponse, PluginAssetAllocateImageTempPathPayload, PluginAssetAllocateImageTempPathResponse, PluginAssetRegisterImagePayload, PluginAssetRegisterImageResponse, PluginClipboardCopyTextPayload, PluginClipboardCopyTextResponse, PluginConsoleDiagnosticPayload, PluginConsoleDiagnosticResponse, PluginConsoleLogPayload, PluginConsoleLogResponse, PluginItemAddTagsPayload, PluginItemAddTagsResponse, PluginItemMaterializeImagePathResponse, PluginItemReadAttachmentPayload, PluginItemReadAttachmentResponse, PluginItemRemoveTagsPayload, PluginItemRemoveTagsResponse, PluginItemSetAttachmentsPayload, PluginItemSetAttachmentsResponse, PluginItemSetPinnedPayload, PluginItemSetPinnedResponse, PluginItemSetSearchExtensionPayload, PluginItemSetSearchExtensionResponse, PluginItemSetTagsPayload, PluginItemSetTagsResponse, PluginLocaleGetResponse, PluginNavigationOpenFilePathPayload, PluginNavigationOpenFilePathResponse, PluginNavigationOpenUrlPayload, PluginNavigationOpenUrlResponse, PluginNavigationRevealInFinderPayload, PluginNavigationRevealInFinderResponse, PluginSettingsGetAllResponse, PluginSettingsGetPayload, PluginSettingsGetResponse } from './capabilities.generated.js';
+export declare const RUNTIME_HOST_METHOD_NAMES: readonly ["item.setTags", "item.addTags", "item.removeTags", "item.setPinned", "item.setAttachments", "item.setSearchExtension", "item.materializeImagePath", "item.readAttachment", "asset.allocateImageTempPath", "asset.registerImage", "clipboard.copyText", "navigation.openUrl", "navigation.revealInFinder", "navigation.openFilePath", "action.allocateImageTempPath", "action.materializeInputImagePath", "action.allocateOutputFilePath", "settings.get", "settings.getAll", "console.log", "console.diagnostic", "locale.get"];
+export type RuntimeHostMethodName = (typeof RUNTIME_HOST_METHOD_NAMES)[number];
 export interface HostClient {
+    capabilities: {
+        has(name: RuntimeHostMethodName): boolean;
+    };
     action: {
         allocateImageTempPath(payload: PluginActionAllocateImageTempPathPayload): Promise<PluginActionAllocateImageTempPathResponse>;
         materializeInputImagePath(): Promise<PluginActionMaterializeInputImagePathResponse>;
         allocateOutputFilePath(payload: PluginActionAllocateOutputFilePathPayload): Promise<PluginActionAllocateOutputFilePathResponse>;
     };
     asset: {
+        allocateImageTempPath(payload: PluginAssetAllocateImageTempPathPayload): Promise<PluginAssetAllocateImageTempPathResponse>;
         registerImage(payload: PluginAssetRegisterImagePayload): Promise<PluginAssetRegisterImageResponse>;
     };
     clipboard: {
@@ -16,6 +19,7 @@ export interface HostClient {
     };
     console: {
         log(payload: PluginConsoleLogPayload): Promise<PluginConsoleLogResponse>;
+        diagnostic(payload: PluginConsoleDiagnosticPayload): Promise<PluginConsoleDiagnosticResponse>;
     };
     item: {
         setTags(payload: PluginItemSetTagsPayload): Promise<PluginItemSetTagsResponse>;
@@ -40,4 +44,3 @@ export interface HostClient {
         getAll(): Promise<PluginSettingsGetAllResponse>;
     };
 }
-export declare function createHostClient(bus: IPCBus): HostClient;

package/dist/generated/hostEvents.generated.d.ts

@@ -0,0 +1,68 @@
+import type { PluginActionUIInput, PluginAttachmentPayload, PluginClipboardItem, PluginThemeTokenSnapshot } from './data.generated.js';
+export interface PluginContextPayload {
+    mode: 'attachmentRenderer' | 'action';
+    pluginID: string;
+}
+export interface PluginAttachmentHostInvokePayload {
+    buttonID: string;
+}
+export interface PluginActionHostInvokePayload {
+    buttonID: string;
+}
+export interface PluginInfoPanelOnActionPayload {
+    panelID: string;
+    buttonID: string;
+}
+export interface PluginInfoPanelOnClosePayload {
+    panelID: string;
+}
+export interface PluginLocalePayload {
+    locale: string;
+}
+export interface PluginHostEventMap {
+    'clipbus-plugin-context': PluginContextPayload;
+    'clipbus-plugin-item': PluginClipboardItem;
+    'clipbus-plugin-attachment': PluginAttachmentPayload;
+    'clipbus-plugin-draft': Record<string, unknown>;
+    'clipbus-plugin-action-input': PluginActionUIInput;
+    'clipbus-plugin-theme': PluginThemeTokenSnapshot;
+    'clipbus-plugin-attachment-host-invoke': PluginAttachmentHostInvokePayload;
+    'clipbus-plugin-action-host-invoke': PluginActionHostInvokePayload;
+    'clipbus-plugin-info-panel-on-action': PluginInfoPanelOnActionPayload;
+    'clipbus-plugin-info-panel-on-close': PluginInfoPanelOnClosePayload;
+    'clipbus-plugin-locale': PluginLocalePayload;
+}
+export type HostEventName = keyof PluginHostEventMap;
+export declare const HOST_EVENT_WINDOW_GLOBALS: {
+    readonly [K in HostEventName]: string | null;
+};
+export interface PluginAttachmentBootstrap {
+    context?: PluginContextPayload;
+    item?: PluginClipboardItem;
+    attachment?: PluginAttachmentPayload;
+    theme?: PluginThemeTokenSnapshot;
+    locale?: PluginLocalePayload;
+}
+export declare const ATTACHMENT_BOOTSTRAP_EVENTS: {
+    readonly context: "clipbus-plugin-context";
+    readonly item: "clipbus-plugin-item";
+    readonly attachment: "clipbus-plugin-attachment";
+    readonly theme: "clipbus-plugin-theme";
+    readonly locale: "clipbus-plugin-locale";
+};
+export interface PluginActionBootstrap {
+    context?: PluginContextPayload;
+    item?: PluginClipboardItem;
+    draft?: Record<string, unknown>;
+    actionInput?: PluginActionUIInput;
+    theme?: PluginThemeTokenSnapshot;
+    locale?: PluginLocalePayload;
+}
+export declare const ACTION_BOOTSTRAP_EVENTS: {
+    readonly context: "clipbus-plugin-context";
+    readonly item: "clipbus-plugin-item";
+    readonly draft: "clipbus-plugin-draft";
+    readonly actionInput: "clipbus-plugin-action-input";
+    readonly theme: "clipbus-plugin-theme";
+    readonly locale: "clipbus-plugin-locale";
+};

package/dist/generated/nodeIPC.generated.d.ts

@@ -0,0 +1,106 @@
+import type { PluginActionOperationResult, PluginActionResolveResult, PluginAttachmentResolveResult, PluginAutoRunActionInput, PluginDetectorArtifact, PluginDetectorInput, PluginResolveActionSessionInput, PluginResolveAttachmentInput } from './data.generated.js';
+export interface PluginRuntimeUserRPCRequest {
+    key: string;
+    payload: unknown;
+}
+export interface PluginRuntimeUserRPCResponse {
+    result: unknown;
+}
+export interface PluginRuntimeInvokeRendererRequest {
+    requestID: string;
+    rendererID: string;
+    input: PluginResolveAttachmentInput;
+}
+export interface PluginRuntimeInvokeRendererResponse {
+    requestID: string;
+    result?: PluginAttachmentResolveResult;
+    errorMessage?: string;
+}
+export interface PluginRuntimeInvokeDetectorRequest {
+    requestID: string;
+    detectorID: string;
+    input: PluginDetectorInput;
+}
+export interface PluginRuntimeInvokeDetectorResponse {
+    requestID: string;
+    result?: PluginDetectorArtifact[];
+    errorMessage?: string;
+}
+export interface PluginRuntimeInvokeActionRequest {
+    requestID: string;
+    actionID: string;
+    input: PluginResolveActionSessionInput;
+}
+export interface PluginRuntimeInvokeActionResponse {
+    requestID: string;
+    result?: PluginActionResolveResult;
+    errorMessage?: string;
+}
+export interface PluginRuntimeInvokeActionAutoRunRequest {
+    requestID: string;
+    actionID: string;
+    input: PluginAutoRunActionInput;
+}
+export interface PluginRuntimeInvokeActionAutoRunResponse {
+    requestID: string;
+    result?: PluginActionOperationResult;
+    errorMessage?: string;
+}
+export interface PluginRuntimeReadyRequest {
+}
+export interface PluginRuntimeReadyResponse {
+}
+export interface PluginNodeIPCMethodMap {
+    'runtime.userRPC': {
+        request: PluginRuntimeUserRPCRequest;
+        response: PluginRuntimeUserRPCResponse;
+    };
+    'runtime.invokeRenderer': {
+        request: PluginRuntimeInvokeRendererRequest;
+        response: PluginRuntimeInvokeRendererResponse;
+    };
+    'runtime.invokeDetector': {
+        request: PluginRuntimeInvokeDetectorRequest;
+        response: PluginRuntimeInvokeDetectorResponse;
+    };
+    'runtime.invokeAction': {
+        request: PluginRuntimeInvokeActionRequest;
+        response: PluginRuntimeInvokeActionResponse;
+    };
+    'runtime.invokeActionAutoRun': {
+        request: PluginRuntimeInvokeActionAutoRunRequest;
+        response: PluginRuntimeInvokeActionAutoRunResponse;
+    };
+    'runtime.ready': {
+        request: PluginRuntimeReadyRequest;
+        response: PluginRuntimeReadyResponse;
+    };
+}
+export type NodeIPCMethodName = keyof PluginNodeIPCMethodMap;
+/** Methods dispatched to a plugin registry entry, keyed by Node IPC method. */
+export declare const NODE_IPC_HANDLER_ROUTES: {
+    readonly 'runtime.invokeRenderer': {
+        readonly registryKey: "attachmentRenderers";
+        readonly handlerMethod: "resolveAttachment";
+        readonly idField: "rendererID";
+        readonly inputField: "input";
+    };
+    readonly 'runtime.invokeDetector': {
+        readonly registryKey: "detectors";
+        readonly handlerMethod: "detect";
+        readonly idField: "detectorID";
+        readonly inputField: "input";
+    };
+    readonly 'runtime.invokeAction': {
+        readonly registryKey: "actions";
+        readonly handlerMethod: "resolveSession";
+        readonly idField: "actionID";
+        readonly inputField: "input";
+    };
+    readonly 'runtime.invokeActionAutoRun': {
+        readonly registryKey: "actions";
+        readonly handlerMethod: "runAutoAction";
+        readonly idField: "actionID";
+        readonly inputField: "input";
+    };
+};

package/dist/generated/{runtime.definePlugin.generated.d.ts → runtime.registry.generated.d.ts}

@@ -1,5 +1,6 @@
 import type { PluginAttachmentRendererHandler, PluginAutoRunActionHandler, PluginDetectorHandler } from './runtime.handlers.generated.js';
 import type { HostClient } from './hostClients.generated.js';
+import type { PluginRuntimeLaunchContext } from './data.generated.js';
 export interface MessageHandlerContext {
     host: HostClient;
 }
@@ -11,6 +12,5 @@ export interface PluginRegistry {
     messageHandlers?: Record<string, MessageHandler>;
 }
 export interface PluginSetup {
-    setup(): PluginRegistry;
+    setup(context?: PluginRuntimeLaunchContext): PluginRegistry;
 }
-export declare function definePlugin(definition: PluginRegistry | PluginSetup): PluginSetup;