@openchamber/sdk 2.3.0 → 2.3.2

package/GUEST_SERVICES.md

@@ -156,6 +156,7 @@ Ship `service/main.js` already built. Same packaging rule as `panel/main.js`.
 | Panel open | Status via `serviceStatus`. Dead service restarts on the next `serviceRequest`. |
 | Uninstall | SIGTERM, then kill after timeout. Clear grant and socket overrides. Path-install does not delete the user's folder. |
 | Host quit | Kill every guest service. |
+| Host crash | The service keeps running until the next host start, which stops it (SIGTERM, then kill after timeout) before spawning any service. |
 | Crash | Status `failed`. Panel sees `SERVICE_FAILED` / status. Manual retry, not silent loops. |
 
 ## Security invariants

package/dist/contract.d.ts

@@ -53,7 +53,7 @@ export type HostTheme = {
     mode: HostThemeMode;
     tokens: HostThemeTokens;
 };
-export declare const START_SESSION_SENT: readonly ["sent", "no-model", "skipped", "failed"];
+export declare const START_SESSION_SENT: readonly ['sent', 'no-model', 'skipped', 'failed'];
 export type StartSessionSent = (typeof START_SESSION_SENT)[number];
 export type SessionSnapshot = {
     id: string;
@@ -103,16 +103,16 @@ export type PromptRequest = {
 export type PromptResult = {
     sent: StartSessionSent;
 };
-export declare const SESSION_LIFECYCLE_PHASES: readonly ["started", "completed", "failure"];
+export declare const SESSION_LIFECYCLE_PHASES: readonly ['started', 'completed', 'failure'];
 export type SessionLifecyclePhase = (typeof SESSION_LIFECYCLE_PHASES)[number];
 export type SessionLifecycleEvent = {
     sessionId: string;
     phase: SessionLifecyclePhase;
 };
-export declare const GUEST_FILE_ENTRY_KINDS: readonly ["file", "directory", "other"];
+export declare const GUEST_FILE_ENTRY_KINDS: readonly ['file', 'directory', 'other'];
 /** What a directory entry or an existing path is. */
 export type GuestFileEntryKind = (typeof GUEST_FILE_ENTRY_KINDS)[number];
-export declare const GUEST_FILE_STAT_KINDS: readonly ["file", "directory", "other", "missing"];
+export declare const GUEST_FILE_STAT_KINDS: readonly ['file', 'directory', 'other', 'missing'];
 /** `stat` answer: an entry kind, or `missing` when nothing is at that path. */
 export type GuestFileStatKind = (typeof GUEST_FILE_STAT_KINDS)[number];
 /**
@@ -364,8 +364,8 @@ export declare const GUEST_BADGE_MAX = 999;
 export declare const GUEST_FRAME_HEIGHT_MAX = 10000;
 /** Characters in a `resolve-result` error string. */
 export declare const GUEST_RESOLVE_ERROR_MAX = 500;
-export declare const HOST_REQUEST_ERROR_CODES: readonly ["HOST_UNAVAILABLE", "HOST_TIMEOUT", "HOST_REJECTED", "DISCONNECTED", "DISABLED", "BAD_PATH", "NO_INTEGRATION", "NO_SERVICE", "SERVICE_FAILED", "REQUEST_FAILED", "RESPONSE_TOO_LARGE", "NO_SESSION", "SESSION_BUSY", "NOT_GRANTED", "NO_DIRECTORY", "NOT_FOUND", "FILE_TOO_LARGE", "DENIED", "NO_MODEL", "MODEL_FAILED", "UNSUPPORTED"];
-export declare const SERVICE_STATUS_VALUES: readonly ["stopped", "starting", "ready", "failed"];
+export declare const HOST_REQUEST_ERROR_CODES: readonly ['HOST_UNAVAILABLE', 'HOST_TIMEOUT', 'HOST_REJECTED', 'DISCONNECTED', 'DISABLED', 'BAD_PATH', 'NO_INTEGRATION', 'NO_SERVICE', 'SERVICE_FAILED', 'REQUEST_FAILED', 'RESPONSE_TOO_LARGE', 'NO_SESSION', 'SESSION_BUSY', 'NOT_GRANTED', 'NO_DIRECTORY', 'NOT_FOUND', 'FILE_TOO_LARGE', 'DENIED', 'NO_MODEL', 'MODEL_FAILED', 'UNSUPPORTED'];
+export declare const SERVICE_STATUS_VALUES: readonly ['stopped', 'starting', 'ready', 'failed'];
 export type ServiceStatus = (typeof SERVICE_STATUS_VALUES)[number];
 export type ServiceStatusResult = {
     status: ServiceStatus;
@@ -613,5 +613,5 @@ export declare const isGenerateResult: (value: HostResultPayload | undefined) =>
  * carries no schema library for it. The host side parses guest input with
  * `guestMessageSchema` in `@openchamber/sdk/schemas`.
  */
-export declare const readHostMessage: (data: MessageEvent["data"]) => HostMessage | null;
+export declare const readHostMessage: (data: MessageEvent['data']) => HostMessage | null;
 export {};

package/dist/contract.js

@@ -1,4 +1,4 @@
-import { OPENCHAMBER_SDK_API_VERSION, OPENCHAMBER_SDK_CHANNEL } from "./api-version.js";
+import { OPENCHAMBER_SDK_API_VERSION, OPENCHAMBER_SDK_CHANNEL } from './api-version.js';
 export const START_SESSION_SENT = ['sent', 'no-model', 'skipped', 'failed'];
 export const SESSION_LIFECYCLE_PHASES = ['started', 'completed', 'failure'];
 export const GUEST_FILE_ENTRY_KINDS = ['file', 'directory', 'other'];

package/dist/host.js

@@ -1,10 +1,10 @@
-import { OPENCHAMBER_SDK_API_VERSION, OPENCHAMBER_SDK_CHANNEL } from "./api-version.js";
-import { GUEST_STORAGE_KEY_MAX, GUEST_STORAGE_VALUE_BYTES } from "./workspace.js";
-import { isGuestStatusControls } from "./status-controls.js";
-import { isGuestPopoverRequest } from "./popover.js";
-import { GUEST_FILE_EDITOR_CONTENT_MAX, GUEST_FILE_EDITOR_VERSION_MAX, fileEditorPayloadSize, sameFileEditorDocument, } from "./file-editor.js";
-import { GUEST_FILE_CONTENT_MAX, GUEST_CLIPBOARD_TEXT_MAX, GUEST_TOAST_MAX, GUEST_FILE_PATH_MAX, GUEST_GENERATE_OUTPUT_TOKENS_MAX, GUEST_GENERATE_PROMPT_MAX, GUEST_GENERATE_SYSTEM_MAX, GUEST_GENERATE_TIMEOUT_MS, GUEST_REQUEST_TIMEOUT_MS, GUEST_RESOLVE_ERROR_MAX, isGuestFilePath, isGuestRequestPath, clampAttachRequest, clampBadgeCount, clampFrameHeight, isGuestCommitSha, clampPromptRequest, clampStartSessionRequest, readHostMessage, isGenerateResult, isFileListResult, isFileReadResult, isFileStatResult, isJsonValue, isFileWriteResult, isServiceStatusResult, isGuestRequestResult, isPromptResult, isStartSessionResult, } from "./contract.js";
-import { GUEST_SHELL_ID_MAX, GUEST_SHELL_OUTPUT_TAIL_MAX } from "./shells.js";
+import { OPENCHAMBER_SDK_API_VERSION, OPENCHAMBER_SDK_CHANNEL } from './api-version.js';
+import { GUEST_STORAGE_KEY_MAX, GUEST_STORAGE_VALUE_BYTES } from './workspace.js';
+import { isGuestStatusControls } from './status-controls.js';
+import { isGuestPopoverRequest } from './popover.js';
+import { GUEST_FILE_EDITOR_CONTENT_MAX, GUEST_FILE_EDITOR_VERSION_MAX, fileEditorPayloadSize, sameFileEditorDocument, } from './file-editor.js';
+import { GUEST_FILE_CONTENT_MAX, GUEST_CLIPBOARD_TEXT_MAX, GUEST_TOAST_MAX, GUEST_FILE_PATH_MAX, GUEST_GENERATE_OUTPUT_TOKENS_MAX, GUEST_GENERATE_PROMPT_MAX, GUEST_GENERATE_SYSTEM_MAX, GUEST_GENERATE_TIMEOUT_MS, GUEST_REQUEST_TIMEOUT_MS, GUEST_RESOLVE_ERROR_MAX, isGuestFilePath, isGuestRequestPath, clampAttachRequest, clampBadgeCount, clampFrameHeight, isGuestCommitSha, clampPromptRequest, clampStartSessionRequest, readHostMessage, isGenerateResult, isFileListResult, isFileReadResult, isFileStatResult, isJsonValue, isFileWriteResult, isServiceStatusResult, isGuestRequestResult, isPromptResult, isStartSessionResult, } from './contract.js';
+import { GUEST_SHELL_ID_MAX, GUEST_SHELL_OUTPUT_TAIL_MAX } from './shells.js';
 // Structural, not `instanceof KeyboardEvent`: the frame's own realm owns that
 // constructor, and non-browser runtimes have none.
 const isKeyEvent = (event) => 'key' in event && 'metaKey' in event && 'ctrlKey' in event;

package/dist/index.js

@@ -1,15 +1,15 @@
-export { OPENCHAMBER_SDK_API_VERSION, OPENCHAMBER_SDK_CHANNEL, OPENCHAMBER_SDK_MANIFEST_API_VERSIONS } from "./api-version.js";
-export { GUEST_SCROLLBAR_CSS, GUEST_SCROLLBAR_SCRIPT } from "./scrollbar-style.js";
-export { guestFramePolicy } from "./frame-policy.js";
-export { GUEST_STORAGE_KEY_MAX, GUEST_STORAGE_KEYS_MAX, GUEST_STORAGE_VALUE_BYTES, GUEST_STORAGE_TOTAL_BYTES, GUEST_DEVICE_STORAGE_TOTAL_BYTES } from "./workspace.js";
-export { GUEST_SHELL_END_STATUSES, GUEST_SHELL_ID_MAX, GUEST_SHELLS_MAX, GUEST_SHELL_OUTPUT_TAIL_MAX, } from "./shells.js";
-export { GUEST_STATUS_CONTROLS_MAX, GUEST_STATUS_CONTROL_ID, GUEST_STATUS_CONTROL_LABEL_MAX, GUEST_STATUS_CONTROL_OPTIONS_MAX, GUEST_STATUS_CONTROL_VALUE_MAX } from "./status-controls.js";
-export { compareOpenChamberVersions, hostMeetsOpenChamberEngine, openChamberEngineMinimum, OPENCHAMBER_ENGINE_PATTERN, parseOpenChamberVersion, } from "./host-version.js";
-export { DECLARED_GUEST_CAPABILITIES, GUEST_ACTIONS_MAX, GUEST_ACTION_LABEL_MAX, GUEST_CAPABILITIES, GUEST_COMMANDS_MAX, GUEST_COMMAND_DESCRIPTION_MAX, GUEST_COMMAND_NAME, GUEST_TOOLS_MAX, GUEST_TOOL_COLUMNS_MAX, GUEST_TOOL_COLUMN_MAX, GUEST_TOOL_LANGUAGE_MAX, GUEST_TOOL_MATCH, GUEST_TOOL_MATCH_MAX, GUEST_TOOL_NAME_MAX, GUEST_TOOL_OUTPUTS, GUEST_TOOL_TEMPLATE_MAX, GUEST_TOOL_TEMPLATE_VALUE_MAX, guestActionsNeedConversation, GUEST_FILESYSTEM_PATTERN_MAX, GUEST_FILESYSTEM_PATTERNS_MAX, GUEST_ORIGINS_MAX, GUEST_SERVICE_PROVIDES, GUEST_SURFACE_DOCKS, GUEST_SURFACE_DOCK_DEFAULT, GUEST_SURFACE_DOCK_SIZE_DEFAULT, GUEST_SURFACE_DOCK_SIZE_MAX, GUEST_SURFACE_DOCK_SIZE_MIN, GUEST_STATUS_SECTION_HEIGHT_DEFAULT, GUEST_STATUS_SECTION_HEIGHT_MAX, GUEST_STATUS_SECTION_HEIGHT_MIN, GUEST_STATUS_SECTION_TITLE_MAX, clampStatusSectionHeight, HOST_LINEAR_API_ORIGIN, isGuestFilesystemPattern, hasGuestCapability, hasGuestPage, isGuestApproved, isGuestPackageSvgIcon, requestedGuestCapabilities, resolveAttachEntry, resolvePageEntry, resolveStatusSectionEntry, resolveAttachMode, resolveIntegrationApi, resolveIntegrationAuth, serviceProvides, toPublicService, toPublicIntegration, } from "./manifest.js";
-export { GUEST_FILE_EDITORS_MAX, GUEST_FILE_EDITOR_CONTENT_MAX, GUEST_FILE_EDITOR_PATTERNS_MAX, GUEST_FILE_EDITOR_PATTERN_MAX, GUEST_FILE_EDITOR_TITLE_MAX, GUEST_FILE_EDITOR_VERSION_MAX, createFileSaveTracker, fileEditorPayloadSize, isFileEditorPattern, matchesFileEditorPattern, } from "./file-editor.js";
-export { connectHost, HostRequestError } from "./host.js";
-export { GUEST_POPOVER_COORDINATE_MAX, GUEST_POPOVER_DATA_DEPTH_MAX, GUEST_POPOVER_DATA_MAX, GUEST_POPOVER_HEIGHT_MAX, GUEST_POPOVER_HEIGHT_MIN, GUEST_POPOVER_ID, GUEST_POPOVER_SIDES, GUEST_POPOVER_WIDTH_MAX, GUEST_POPOVER_WIDTH_MIN, GUEST_POPOVER_CLOSE_REASONS, isGuestPopoverRequest, } from "./popover.js";
-export { clampAttachRequest, clampBadgeCount, clampFrameHeight, isGuestCommitSha, GUEST_COMMIT_SHA, clampPromptRequest, clampStartSessionRequest, guestFileScope, isAttachData, isJsonValue, isFileListResult, isFileReadResult, isFileStatResult, isGenerateResult, isFileWriteResult, isGuestFilePath, isGuestAttachItem, isGuestMessageItem, isGuestSessionItem, isServiceStatusResult, isGuestRequestPath, isGuestRequestResult, isHostRequestErrorCode, isPromptResult, isStartSessionResult, readHostMessage, resolveHostRequestErrorCode, } from "./contract.js";
-export { EMPTY_GUEST_CONNECTION, GUEST_BADGE_MAX, GUEST_FRAME_HEIGHT_MAX, GUEST_ITEM_MESSAGE_TEXT_MAX, GUEST_ITEM_SESSION_MAX, GUEST_RESOLVE_ERROR_MAX, GUEST_FILE_CONTENT_MAX, GUEST_FILE_ENTRY_KINDS, GUEST_FILE_LIST_MAX, GUEST_FILE_PATH_MAX, GUEST_GENERATE_OUTPUT_TOKENS_MAX, GUEST_GENERATE_PROMPT_MAX, GUEST_GENERATE_SYSTEM_MAX, GUEST_GENERATE_TEXT_MAX, GUEST_GENERATE_TIMEOUT_MS, GUEST_FILE_STAT_KINDS, SERVICE_STATUS_VALUES, HOST_REQUEST_ERROR_CODES, SESSION_LIFECYCLE_PHASES, START_SESSION_SENT, GUEST_ACCOUNT_MAX, GUEST_SESSION_AGENT_MAX, GUEST_SESSION_MODEL_MAX, GUEST_ATTACH_AUTHOR_MAX, GUEST_ATTACH_BRANCH_MAX, GUEST_ATTACH_DATA_MAX, GUEST_ATTACH_ID_MAX, GUEST_ATTACH_TEXT_MAX, GUEST_ATTACH_TITLE_MAX, GUEST_ATTACH_URL_MAX, GUEST_CLIPBOARD_TEXT_MAX, GUEST_TOAST_MAX, GUEST_COMPOSE_TEXT_MAX, GUEST_REQUEST_BODY_MAX, GUEST_REQUEST_PATH_MAX, GUEST_REQUEST_RESPONSE_MAX, GUEST_REQUEST_TIMEOUT_MS, GUEST_SETTING_VALUE_MAX, } from "./contract.js";
-export { BROWSER_CONTROL_ACTIONS, BROWSER_PROVIDER_ACTION_TIMEOUT_MS, BROWSER_PROVIDER_IDLE_MS, BROWSER_PROVIDER_OPEN_TIMEOUT_MS, BROWSER_PROVIDER_PATH, BROWSER_PROVIDER_RESPONSE_MAX, BROWSER_SCROLL_DIRECTIONS, BROWSER_VIEWPORT_MODES, isBrowserControlAction, readBrowserProviderRequest, } from "./service-providers.js";
-export { SURFACE_AGENT_ACTIVE_HEADER, SURFACE_AGENT_HOLD_MS, SURFACE_CLIPBOARD_PATH, SURFACE_CONTROL_PATH, SURFACE_CONTROLLERS, SURFACE_DIMENSION_MAX, SURFACE_FRAME_MAX_BYTES, SURFACE_FRAME_MIMES, SURFACE_FRAME_PATH, SURFACE_FRAME_SEQ_HEADER, SURFACE_FRAME_WAIT_MS, SURFACE_HEIGHT_HEADER, SURFACE_INPUT_BATCH_MAX, SURFACE_INPUT_PATH, SURFACE_RESIZE_PATH, SURFACE_SEQ_HEADER, SURFACE_TEXT_MAX, SURFACE_TITLE_HEADER, SURFACE_TITLE_MAX, SURFACE_VIEWER_CONTROLS_HEADER, SURFACE_VIEWER_HEADER, SURFACE_WIDTH_HEADER, readSurfaceControlNotice, readSurfaceInputBatch, readSurfaceResizeRequest, } from "./service-surface.js";
+export { OPENCHAMBER_SDK_API_VERSION, OPENCHAMBER_SDK_CHANNEL, OPENCHAMBER_SDK_MANIFEST_API_VERSIONS } from './api-version.js';
+export { GUEST_SCROLLBAR_CSS, GUEST_SCROLLBAR_SCRIPT } from './scrollbar-style.js';
+export { guestFramePolicy } from './frame-policy.js';
+export { GUEST_STORAGE_KEY_MAX, GUEST_STORAGE_KEYS_MAX, GUEST_STORAGE_VALUE_BYTES, GUEST_STORAGE_TOTAL_BYTES, GUEST_DEVICE_STORAGE_TOTAL_BYTES } from './workspace.js';
+export { GUEST_SHELL_END_STATUSES, GUEST_SHELL_ID_MAX, GUEST_SHELLS_MAX, GUEST_SHELL_OUTPUT_TAIL_MAX, } from './shells.js';
+export { GUEST_STATUS_CONTROLS_MAX, GUEST_STATUS_CONTROL_ID, GUEST_STATUS_CONTROL_LABEL_MAX, GUEST_STATUS_CONTROL_OPTIONS_MAX, GUEST_STATUS_CONTROL_VALUE_MAX } from './status-controls.js';
+export { compareOpenChamberVersions, hostMeetsOpenChamberEngine, openChamberEngineMinimum, OPENCHAMBER_ENGINE_PATTERN, parseOpenChamberVersion, } from './host-version.js';
+export { DECLARED_GUEST_CAPABILITIES, GUEST_ACTIONS_MAX, GUEST_ACTION_LABEL_MAX, GUEST_CAPABILITIES, GUEST_COMMANDS_MAX, GUEST_COMMAND_DESCRIPTION_MAX, GUEST_COMMAND_NAME, GUEST_TOOLS_MAX, GUEST_TOOL_COLUMNS_MAX, GUEST_TOOL_COLUMN_MAX, GUEST_TOOL_LANGUAGE_MAX, GUEST_TOOL_MATCH, GUEST_TOOL_MATCH_MAX, GUEST_TOOL_NAME_MAX, GUEST_TOOL_OUTPUTS, GUEST_TOOL_TEMPLATE_MAX, GUEST_TOOL_TEMPLATE_VALUE_MAX, guestActionsNeedConversation, GUEST_FILESYSTEM_PATTERN_MAX, GUEST_FILESYSTEM_PATTERNS_MAX, GUEST_ORIGINS_MAX, GUEST_SERVICE_PROVIDES, GUEST_SURFACE_DOCKS, GUEST_SURFACE_DOCK_DEFAULT, GUEST_SURFACE_DOCK_SIZE_DEFAULT, GUEST_SURFACE_DOCK_SIZE_MAX, GUEST_SURFACE_DOCK_SIZE_MIN, GUEST_STATUS_SECTION_HEIGHT_DEFAULT, GUEST_STATUS_SECTION_HEIGHT_MAX, GUEST_STATUS_SECTION_HEIGHT_MIN, GUEST_STATUS_SECTION_TITLE_MAX, clampStatusSectionHeight, HOST_LINEAR_API_ORIGIN, isGuestFilesystemPattern, hasGuestCapability, hasGuestPage, isGuestApproved, isGuestPackageSvgIcon, requestedGuestCapabilities, resolveAttachEntry, resolvePageEntry, resolveStatusSectionEntry, resolveAttachMode, resolveIntegrationApi, resolveIntegrationAuth, serviceProvides, toPublicService, toPublicIntegration, } from './manifest.js';
+export { GUEST_FILE_EDITORS_MAX, GUEST_FILE_EDITOR_CONTENT_MAX, GUEST_FILE_EDITOR_PATTERNS_MAX, GUEST_FILE_EDITOR_PATTERN_MAX, GUEST_FILE_EDITOR_TITLE_MAX, GUEST_FILE_EDITOR_VERSION_MAX, createFileSaveTracker, fileEditorPayloadSize, isFileEditorPattern, matchesFileEditorPattern, } from './file-editor.js';
+export { connectHost, HostRequestError } from './host.js';
+export { GUEST_POPOVER_COORDINATE_MAX, GUEST_POPOVER_DATA_DEPTH_MAX, GUEST_POPOVER_DATA_MAX, GUEST_POPOVER_HEIGHT_MAX, GUEST_POPOVER_HEIGHT_MIN, GUEST_POPOVER_ID, GUEST_POPOVER_SIDES, GUEST_POPOVER_WIDTH_MAX, GUEST_POPOVER_WIDTH_MIN, GUEST_POPOVER_CLOSE_REASONS, isGuestPopoverRequest, } from './popover.js';
+export { clampAttachRequest, clampBadgeCount, clampFrameHeight, isGuestCommitSha, GUEST_COMMIT_SHA, clampPromptRequest, clampStartSessionRequest, guestFileScope, isAttachData, isJsonValue, isFileListResult, isFileReadResult, isFileStatResult, isGenerateResult, isFileWriteResult, isGuestFilePath, isGuestAttachItem, isGuestMessageItem, isGuestSessionItem, isServiceStatusResult, isGuestRequestPath, isGuestRequestResult, isHostRequestErrorCode, isPromptResult, isStartSessionResult, readHostMessage, resolveHostRequestErrorCode, } from './contract.js';
+export { EMPTY_GUEST_CONNECTION, GUEST_BADGE_MAX, GUEST_FRAME_HEIGHT_MAX, GUEST_ITEM_MESSAGE_TEXT_MAX, GUEST_ITEM_SESSION_MAX, GUEST_RESOLVE_ERROR_MAX, GUEST_FILE_CONTENT_MAX, GUEST_FILE_ENTRY_KINDS, GUEST_FILE_LIST_MAX, GUEST_FILE_PATH_MAX, GUEST_GENERATE_OUTPUT_TOKENS_MAX, GUEST_GENERATE_PROMPT_MAX, GUEST_GENERATE_SYSTEM_MAX, GUEST_GENERATE_TEXT_MAX, GUEST_GENERATE_TIMEOUT_MS, GUEST_FILE_STAT_KINDS, SERVICE_STATUS_VALUES, HOST_REQUEST_ERROR_CODES, SESSION_LIFECYCLE_PHASES, START_SESSION_SENT, GUEST_ACCOUNT_MAX, GUEST_SESSION_AGENT_MAX, GUEST_SESSION_MODEL_MAX, GUEST_ATTACH_AUTHOR_MAX, GUEST_ATTACH_BRANCH_MAX, GUEST_ATTACH_DATA_MAX, GUEST_ATTACH_ID_MAX, GUEST_ATTACH_TEXT_MAX, GUEST_ATTACH_TITLE_MAX, GUEST_ATTACH_URL_MAX, GUEST_CLIPBOARD_TEXT_MAX, GUEST_TOAST_MAX, GUEST_COMPOSE_TEXT_MAX, GUEST_REQUEST_BODY_MAX, GUEST_REQUEST_PATH_MAX, GUEST_REQUEST_RESPONSE_MAX, GUEST_REQUEST_TIMEOUT_MS, GUEST_SETTING_VALUE_MAX, } from './contract.js';
+export { BROWSER_CONTROL_ACTIONS, BROWSER_PROVIDER_ACTION_TIMEOUT_MS, BROWSER_PROVIDER_IDLE_MS, BROWSER_PROVIDER_OPEN_TIMEOUT_MS, BROWSER_PROVIDER_PATH, BROWSER_PROVIDER_RESPONSE_MAX, BROWSER_SCROLL_DIRECTIONS, BROWSER_VIEWPORT_MODES, isBrowserControlAction, readBrowserProviderRequest, } from './service-providers.js';
+export { SURFACE_AGENT_ACTIVE_HEADER, SURFACE_AGENT_HOLD_MS, SURFACE_CLIPBOARD_PATH, SURFACE_CONTROL_PATH, SURFACE_CONTROLLERS, SURFACE_DIMENSION_MAX, SURFACE_FRAME_MAX_BYTES, SURFACE_FRAME_MIMES, SURFACE_FRAME_PATH, SURFACE_FRAME_SEQ_HEADER, SURFACE_FRAME_WAIT_MS, SURFACE_HEIGHT_HEADER, SURFACE_INPUT_BATCH_MAX, SURFACE_INPUT_PATH, SURFACE_RESIZE_PATH, SURFACE_SEQ_HEADER, SURFACE_TEXT_MAX, SURFACE_TITLE_HEADER, SURFACE_TITLE_MAX, SURFACE_VIEWER_CONTROLS_HEADER, SURFACE_VIEWER_HEADER, SURFACE_WIDTH_HEADER, readSurfaceControlNotice, readSurfaceInputBatch, readSurfaceResizeRequest, } from './service-surface.js';

package/dist/manifest.d.ts

@@ -22,7 +22,7 @@ export type PanelContribution = {
     dock?: GuestSurfaceDock;
     size?: number;
 };
-export declare const GUEST_SURFACE_DOCKS: readonly ["top", "bottom", "left", "right"];
+export declare const GUEST_SURFACE_DOCKS: readonly ['top', 'bottom', 'left', 'right'];
 export type GuestSurfaceDock = (typeof GUEST_SURFACE_DOCKS)[number];
 export declare const GUEST_SURFACE_DOCK_DEFAULT: GuestSurfaceDock;
 /** Thickness in CSS px of a docked `panel.entry` when the manifest names none. */
@@ -129,7 +129,7 @@ export declare const GUEST_TOOL_LANGUAGE_MAX = 32;
 export declare const GUEST_TOOL_COLUMNS_MAX = 16;
 /** Characters in one column path. */
 export declare const GUEST_TOOL_COLUMN_MAX = 64;
-export declare const GUEST_TOOL_OUTPUTS: readonly ["auto", "text", "json", "markdown", "code", "table"];
+export declare const GUEST_TOOL_OUTPUTS: readonly ['auto', 'text', 'json', 'markdown', 'code', 'table'];
 /** How the expanded body of a matched tool call renders. `auto` keeps the host's own detection. */
 export type GuestToolOutput = (typeof GUEST_TOOL_OUTPUTS)[number];
 /**
@@ -215,7 +215,7 @@ export type PublicIntegration = {
     apiOrigin?: string;
     settings?: IntegrationSettingField[];
 };
-export declare const resolveIntegrationAuth: (integration: Pick<IntegrationContribution, "oauth" | "token" | "host">) => IntegrationAuth | null;
+export declare const resolveIntegrationAuth: (integration: Pick<IntegrationContribution, 'oauth' | 'token' | 'host'>) => IntegrationAuth | null;
 export declare const resolveIntegrationApi: (integration: IntegrationContribution) => ResolvedGuestApi | null;
 export type SocketPlatform = 'linux' | 'darwin' | 'win32';
 /** Declared socket the service may dial. Candidates are per host platform. */
@@ -245,7 +245,7 @@ export type PublicSocketBinding = {
  * `service-providers.ts`. A service that provides a role needs no panel or
  * background entry: the host starts it on the first action.
  */
-export declare const GUEST_SERVICE_PROVIDES: readonly ["browser"];
+export declare const GUEST_SERVICE_PROVIDES: readonly ['browser'];
 export type GuestServiceProvides = (typeof GUEST_SERVICE_PROVIDES)[number];
 export type ServiceContribution = {
     entry: string;
@@ -269,7 +269,7 @@ export type PublicService = {
     surface?: true;
     granted: boolean;
 };
-export declare const serviceProvides: (service: Pick<ServiceContribution, "provides"> | undefined, role: GuestServiceProvides) => boolean;
+export declare const serviceProvides: (service: Pick<ServiceContribution, 'provides'> | undefined, role: GuestServiceProvides) => boolean;
 /**
  * What a guest may do beyond drawing its own panel. The user approves the
  * full list once, when the package is installed; a later package that asks
@@ -279,9 +279,9 @@ export declare const serviceProvides: (service: Pick<ServiceContribution, "provi
  * `contributes.integration`, `contributes.filesystem` and `contributes.origins`. `model` is one-off text generation with the
  * user's Small Model (`host.generate`), outside any session.
  */
-export declare const GUEST_CAPABILITIES: readonly ["prompt", "sessions", "files", "model", "shells", "conversation", "service", "network", "filesystem", "origins"];
+export declare const GUEST_CAPABILITIES: readonly ['prompt', 'sessions', 'files', 'model', 'shells', 'conversation', 'service', 'network', 'filesystem', 'origins'];
 export type GuestCapability = (typeof GUEST_CAPABILITIES)[number];
-export declare const DECLARED_GUEST_CAPABILITIES: readonly ["prompt", "sessions", "files", "model", "shells"];
+export declare const DECLARED_GUEST_CAPABILITIES: readonly ['prompt', 'sessions', 'files', 'model', 'shells'];
 /** The capabilities a manifest may ask for directly. */
 export type DeclaredGuestCapability = (typeof DECLARED_GUEST_CAPABILITIES)[number];
 /** How many `contributes.origins` a package may declare. */
@@ -329,12 +329,12 @@ export type PublicGuestCapabilities = {
     requested: GuestCapability[];
     granted: GuestCapability[];
 };
-export declare const requestedGuestCapabilities: (contributes: Pick<OpenChamberContributes, "capabilities" | "integration" | "service" | "filesystem" | "actions" | "origins">) => GuestCapability[];
+export declare const requestedGuestCapabilities: (contributes: Pick<OpenChamberContributes, 'capabilities' | 'integration' | 'service' | 'filesystem' | 'actions' | 'origins'>) => GuestCapability[];
 /**
  * Whether the package ships a visible panel. Background-only extensions can
  * execute code but have no rail surface, attach picker, or full-screen page.
  */
-export declare const hasGuestPage: (contributes: Pick<OpenChamberContributes, "panel">) => boolean;
+export declare const hasGuestPage: (contributes: Pick<OpenChamberContributes, 'panel'>) => boolean;
 export declare const isGuestApproved: (capabilities: PublicGuestCapabilities) => boolean;
 export declare const hasGuestCapability: (capabilities: PublicGuestCapabilities, capability: GuestCapability) => boolean;
 export declare const resolveAttachMode: (attach: AttachContribution | undefined) => AttachMode | null;
@@ -342,14 +342,14 @@ export declare const resolveAttachMode: (attach: AttachContribution | undefined)
  * The page the attach dialog loads, or `null` when the dialog reuses
  * `panel.entry`. Only the object form with `mode: "dialog"` can name one.
  */
-export declare const resolveAttachEntry: (contributes: Pick<OpenChamberContributes, "attach">) => string | null;
-export declare const resolvePageEntry: (contributes: Pick<OpenChamberContributes, "panel" | "page">) => string | null;
+export declare const resolveAttachEntry: (contributes: Pick<OpenChamberContributes, 'attach'>) => string | null;
+export declare const resolvePageEntry: (contributes: Pick<OpenChamberContributes, 'panel' | 'page'>) => string | null;
 /**
  * The HTML the Work Status section loads: `panel.entry` for `true`, the
  * object's own `entry` otherwise, `null` when nothing is declared or `true`
  * has no panel page to reuse.
  */
-export declare const resolveStatusSectionEntry: (contributes: Pick<OpenChamberContributes, "panel" | "statusSection">) => string | null;
+export declare const resolveStatusSectionEntry: (contributes: Pick<OpenChamberContributes, 'panel' | 'statusSection'>) => string | null;
 /** Clamp a requested status section height to what the host allows. */
 export declare const clampStatusSectionHeight: (height: number) => number;
 export type OpenChamberEngines = {

package/dist/parse.d.ts

@@ -12,10 +12,10 @@ export declare const openChamberManifestSchema: z.ZodObject<{
             icon: z.ZodString;
             entry: z.ZodOptional<z.ZodString>;
             dock: z.ZodOptional<z.ZodEnum<{
+                bottom: "bottom";
                 left: "left";
                 right: "right";
                 top: "top";
-                bottom: "bottom";
             }>>;
             size: z.ZodOptional<z.ZodNumber>;
         }, z.core.$strip>;
@@ -23,12 +23,12 @@ export declare const openChamberManifestSchema: z.ZodObject<{
             entry: z.ZodString;
         }, z.core.$strip>>;
         attach: z.ZodOptional<z.ZodUnion<readonly [z.ZodBoolean, z.ZodEnum<{
-            panel: "panel";
             dialog: "dialog";
+            panel: "panel";
         }>, z.ZodObject<{
             mode: z.ZodEnum<{
-                panel: "panel";
                 dialog: "dialog";
+                panel: "panel";
             }>;
             entry: z.ZodOptional<z.ZodString>;
         }, z.core.$strip>]>>;
@@ -44,11 +44,11 @@ export declare const openChamberManifestSchema: z.ZodObject<{
             requiresProject: z.ZodOptional<z.ZodBoolean>;
         }, z.core.$strip>]>>;
         capabilities: z.ZodOptional<z.ZodArray<z.ZodEnum<{
-            shells: "shells";
-            sessions: "sessions";
-            prompt: "prompt";
             files: "files";
             model: "model";
+            prompt: "prompt";
+            sessions: "sessions";
+            shells: "shells";
         }>>>;
         integration: z.ZodOptional<z.ZodObject<{
             name: z.ZodString;
@@ -70,9 +70,9 @@ export declare const openChamberManifestSchema: z.ZodObject<{
                     name: z.ZodString;
                 }, z.core.$strip>>;
                 scheme: z.ZodOptional<z.ZodEnum<{
-                    raw: "raw";
-                    bearer: "bearer";
                     basic: "basic";
+                    bearer: "bearer";
+                    raw: "raw";
                 }>>;
                 usernameLabel: z.ZodOptional<z.ZodString>;
             }, z.core.$strip>>;
@@ -124,16 +124,16 @@ export declare const openChamberManifestSchema: z.ZodObject<{
             label: z.ZodString;
             icon: z.ZodOptional<z.ZodString>;
             where: z.ZodEnum<{
-                session: "session";
                 message: "message";
+                session: "session";
             }>;
             mode: z.ZodOptional<z.ZodEnum<{
                 background: "background";
                 open: "open";
             }>>;
             roles: z.ZodOptional<z.ZodArray<z.ZodEnum<{
-                user: "user";
                 assistant: "assistant";
+                user: "user";
             }>>>;
             payload: z.ZodOptional<z.ZodArray<z.ZodEnum<{
                 messages: "messages";
@@ -150,12 +150,12 @@ export declare const openChamberManifestSchema: z.ZodObject<{
             title: z.ZodOptional<z.ZodString>;
             subtitle: z.ZodOptional<z.ZodString>;
             output: z.ZodOptional<z.ZodEnum<{
-                text: "text";
-                code: "code";
                 auto: "auto";
+                code: "code";
                 json: "json";
                 markdown: "markdown";
                 table: "table";
+                text: "text";
             }>>;
             language: z.ZodOptional<z.ZodString>;
             columns: z.ZodOptional<z.ZodArray<z.ZodString>>;
@@ -166,8 +166,8 @@ export declare const openChamberManifestSchema: z.ZodObject<{
             match: z.ZodArray<z.ZodString>;
             entry: z.ZodString;
             content: z.ZodOptional<z.ZodEnum<{
-                text: "text";
                 binary: "binary";
+                text: "text";
             }>>;
         }, z.core.$strip>>>;
     }, z.core.$strip>;
@@ -187,10 +187,10 @@ export declare const packageManifestSchema: z.ZodObject<{
                 icon: z.ZodString;
                 entry: z.ZodOptional<z.ZodString>;
                 dock: z.ZodOptional<z.ZodEnum<{
+                    bottom: "bottom";
                     left: "left";
                     right: "right";
                     top: "top";
-                    bottom: "bottom";
                 }>>;
                 size: z.ZodOptional<z.ZodNumber>;
             }, z.core.$strip>;
@@ -198,12 +198,12 @@ export declare const packageManifestSchema: z.ZodObject<{
                 entry: z.ZodString;
             }, z.core.$strip>>;
             attach: z.ZodOptional<z.ZodUnion<readonly [z.ZodBoolean, z.ZodEnum<{
-                panel: "panel";
                 dialog: "dialog";
+                panel: "panel";
             }>, z.ZodObject<{
                 mode: z.ZodEnum<{
-                    panel: "panel";
                     dialog: "dialog";
+                    panel: "panel";
                 }>;
                 entry: z.ZodOptional<z.ZodString>;
             }, z.core.$strip>]>>;
@@ -219,11 +219,11 @@ export declare const packageManifestSchema: z.ZodObject<{
                 requiresProject: z.ZodOptional<z.ZodBoolean>;
             }, z.core.$strip>]>>;
             capabilities: z.ZodOptional<z.ZodArray<z.ZodEnum<{
-                shells: "shells";
-                sessions: "sessions";
-                prompt: "prompt";
                 files: "files";
                 model: "model";
+                prompt: "prompt";
+                sessions: "sessions";
+                shells: "shells";
             }>>>;
             integration: z.ZodOptional<z.ZodObject<{
                 name: z.ZodString;
@@ -245,9 +245,9 @@ export declare const packageManifestSchema: z.ZodObject<{
                         name: z.ZodString;
                     }, z.core.$strip>>;
                     scheme: z.ZodOptional<z.ZodEnum<{
-                        raw: "raw";
-                        bearer: "bearer";
                         basic: "basic";
+                        bearer: "bearer";
+                        raw: "raw";
                     }>>;
                     usernameLabel: z.ZodOptional<z.ZodString>;
                 }, z.core.$strip>>;
@@ -299,16 +299,16 @@ export declare const packageManifestSchema: z.ZodObject<{
                 label: z.ZodString;
                 icon: z.ZodOptional<z.ZodString>;
                 where: z.ZodEnum<{
-                    session: "session";
                     message: "message";
+                    session: "session";
                 }>;
                 mode: z.ZodOptional<z.ZodEnum<{
                     background: "background";
                     open: "open";
                 }>>;
                 roles: z.ZodOptional<z.ZodArray<z.ZodEnum<{
-                    user: "user";
                     assistant: "assistant";
+                    user: "user";
                 }>>>;
                 payload: z.ZodOptional<z.ZodArray<z.ZodEnum<{
                     messages: "messages";
@@ -325,12 +325,12 @@ export declare const packageManifestSchema: z.ZodObject<{
                 title: z.ZodOptional<z.ZodString>;
                 subtitle: z.ZodOptional<z.ZodString>;
                 output: z.ZodOptional<z.ZodEnum<{
-                    text: "text";
-                    code: "code";
                     auto: "auto";
+                    code: "code";
                     json: "json";
                     markdown: "markdown";
                     table: "table";
+                    text: "text";
                 }>>;
                 language: z.ZodOptional<z.ZodString>;
                 columns: z.ZodOptional<z.ZodArray<z.ZodString>>;
@@ -341,8 +341,8 @@ export declare const packageManifestSchema: z.ZodObject<{
                 match: z.ZodArray<z.ZodString>;
                 entry: z.ZodString;
                 content: z.ZodOptional<z.ZodEnum<{
-                    text: "text";
                     binary: "binary";
+                    text: "text";
                 }>>;
             }, z.core.$strip>>>;
         }, z.core.$strip>;

package/dist/parse.js

@@ -1,8 +1,8 @@
 import { z } from 'zod';
-import { OPENCHAMBER_SDK_MANIFEST_API_VERSIONS } from "./api-version.js";
-import { OPENCHAMBER_ENGINE_PATTERN } from "./host-version.js";
-import { DECLARED_GUEST_CAPABILITIES, GUEST_ACTIONS_MAX, GUEST_ACTION_LABEL_MAX, GUEST_COMMANDS_MAX, GUEST_COMMAND_DESCRIPTION_MAX, GUEST_COMMAND_NAME, GUEST_FILESYSTEM_PATTERNS_MAX, GUEST_FILESYSTEM_PATTERN_MAX, GUEST_ORIGINS_MAX, GUEST_SERVICE_PROVIDES, GUEST_TOOLS_MAX, GUEST_TOOL_COLUMNS_MAX, GUEST_TOOL_COLUMN_MAX, GUEST_TOOL_LANGUAGE_MAX, GUEST_TOOL_MATCH, GUEST_TOOL_MATCH_MAX, GUEST_TOOL_NAME_MAX, GUEST_TOOL_OUTPUTS, GUEST_TOOL_TEMPLATE_MAX, PANEL_ID, hasGuestPage, isGuestFilesystemPattern, isGuestPackageSvgIcon, isSafeAssetPath, resolveIntegrationAuth, GUEST_SURFACE_DOCKS, GUEST_SURFACE_DOCK_SIZE_MAX, GUEST_SURFACE_DOCK_SIZE_MIN, GUEST_STATUS_SECTION_HEIGHT_MAX, GUEST_STATUS_SECTION_HEIGHT_MIN, GUEST_STATUS_SECTION_TITLE_MAX, } from "./manifest.js";
-import { GUEST_FILE_EDITORS_MAX, GUEST_FILE_EDITOR_PATTERNS_MAX, GUEST_FILE_EDITOR_TITLE_MAX, isFileEditorPattern, } from "./file-editor.js";
+import { OPENCHAMBER_SDK_MANIFEST_API_VERSIONS } from './api-version.js';
+import { OPENCHAMBER_ENGINE_PATTERN } from './host-version.js';
+import { DECLARED_GUEST_CAPABILITIES, GUEST_ACTIONS_MAX, GUEST_ACTION_LABEL_MAX, GUEST_COMMANDS_MAX, GUEST_COMMAND_DESCRIPTION_MAX, GUEST_COMMAND_NAME, GUEST_FILESYSTEM_PATTERNS_MAX, GUEST_FILESYSTEM_PATTERN_MAX, GUEST_ORIGINS_MAX, GUEST_SERVICE_PROVIDES, GUEST_TOOLS_MAX, GUEST_TOOL_COLUMNS_MAX, GUEST_TOOL_COLUMN_MAX, GUEST_TOOL_LANGUAGE_MAX, GUEST_TOOL_MATCH, GUEST_TOOL_MATCH_MAX, GUEST_TOOL_NAME_MAX, GUEST_TOOL_OUTPUTS, GUEST_TOOL_TEMPLATE_MAX, PANEL_ID, hasGuestPage, isGuestFilesystemPattern, isGuestPackageSvgIcon, isSafeAssetPath, resolveIntegrationAuth, GUEST_SURFACE_DOCKS, GUEST_SURFACE_DOCK_SIZE_MAX, GUEST_SURFACE_DOCK_SIZE_MIN, GUEST_STATUS_SECTION_HEIGHT_MAX, GUEST_STATUS_SECTION_HEIGHT_MIN, GUEST_STATUS_SECTION_TITLE_MAX, } from './manifest.js';
+import { GUEST_FILE_EDITORS_MAX, GUEST_FILE_EDITOR_PATTERNS_MAX, GUEST_FILE_EDITOR_TITLE_MAX, isFileEditorPattern, } from './file-editor.js';
 const isPanelIcon = (value) => (PANEL_ID.test(value) || isGuestPackageSvgIcon(value));
 const isHttpsUrl = (value) => {
     try {

package/dist/popover-schemas.d.ts

@@ -12,10 +12,10 @@ export declare const guestPopoverRequestSchema: z.ZodObject<{
     width: z.ZodNumber;
     height: z.ZodNumber;
     side: z.ZodOptional<z.ZodEnum<{
+        bottom: "bottom";
         left: "left";
         right: "right";
         top: "top";
-        bottom: "bottom";
     }>>;
     focus: z.ZodOptional<z.ZodBoolean>;
     data: z.ZodCustom<JsonValue, JsonValue>;
@@ -23,11 +23,11 @@ export declare const guestPopoverRequestSchema: z.ZodObject<{
 export declare const guestPopoverClosedEventSchema: z.ZodObject<{
     id: z.ZodString;
     reason: z.ZodEnum<{
+        anchor: "anchor";
+        closed: "closed";
         escape: "escape";
         outside: "outside";
-        anchor: "anchor";
         owner: "owner";
-        closed: "closed";
         replaced: "replaced";
     }>;
 }, z.core.$strict>;

package/dist/popover-schemas.js

@@ -1,5 +1,5 @@
 import { z } from 'zod';
-import { GUEST_POPOVER_CLOSE_REASONS, GUEST_POPOVER_COORDINATE_MAX, GUEST_POPOVER_DATA_MAX, GUEST_POPOVER_DATA_DEPTH_MAX, GUEST_POPOVER_HEIGHT_MAX, GUEST_POPOVER_HEIGHT_MIN, GUEST_POPOVER_ID, GUEST_POPOVER_SIDES, GUEST_POPOVER_WIDTH_MAX, GUEST_POPOVER_WIDTH_MIN, } from "./popover.js";
+import { GUEST_POPOVER_CLOSE_REASONS, GUEST_POPOVER_COORDINATE_MAX, GUEST_POPOVER_DATA_MAX, GUEST_POPOVER_DATA_DEPTH_MAX, GUEST_POPOVER_HEIGHT_MAX, GUEST_POPOVER_HEIGHT_MIN, GUEST_POPOVER_ID, GUEST_POPOVER_SIDES, GUEST_POPOVER_WIDTH_MAX, GUEST_POPOVER_WIDTH_MIN, } from './popover.js';
 const jsonPrimitive = z.union([z.string().max(GUEST_POPOVER_DATA_MAX), z.number(), z.boolean(), z.null()]);
 const jsonRecord = z.record(z.string().max(GUEST_POPOVER_DATA_MAX), z.unknown());
 // Parse one level at a time: recursive z.json() would traverse a hostile cycle

package/dist/popover.d.ts

@@ -7,7 +7,7 @@ export declare const GUEST_POPOVER_HEIGHT_MIN = 48;
 export declare const GUEST_POPOVER_HEIGHT_MAX = 480;
 export declare const GUEST_POPOVER_DATA_MAX = 16000;
 export declare const GUEST_POPOVER_DATA_DEPTH_MAX = 32;
-export declare const GUEST_POPOVER_SIDES: readonly ["left", "right", "top", "bottom"];
+export declare const GUEST_POPOVER_SIDES: readonly ['left', 'right', 'top', 'bottom'];
 export type GuestPopoverSide = (typeof GUEST_POPOVER_SIDES)[number];
 export type GuestPopoverAnchor = {
     x: number;
@@ -28,7 +28,7 @@ export type GuestPopoverContext = {
     id: string;
     data: JsonValue;
 };
-export declare const GUEST_POPOVER_CLOSE_REASONS: readonly ["escape", "outside", "anchor", "owner", "closed", "replaced"];
+export declare const GUEST_POPOVER_CLOSE_REASONS: readonly ['escape', 'outside', 'anchor', 'owner', 'closed', 'replaced'];
 export type GuestPopoverClosedEvent = {
     id: string;
     reason: (typeof GUEST_POPOVER_CLOSE_REASONS)[number];