@crewx/sdk 0.9.0-rc.13 → 0.9.0-rc.130

package/dist/mcp-app/types.d.ts

@@ -0,0 +1,458 @@
+import type { JsonObject, UiDefinition, UiDefinitionRef, UiDefinitionDisplayMode, UiDefinitionUsage, UiProjectionPolicy, UiInstance, UiInstanceStatus, UiActionConfirmation, UiActionHandlerRegistration } from '../ui-instance/types.js';
+import type { AppDiscoveryFileSystem, ProductAppBundleInput, ProductAppBundleProvenance, ProductAppBundleSnapshotMetadata } from './discovery.js';
+import type { UiPluginManifestV2 } from '../ui-plugin/types.js';
+export declare const MCP_APP_RESOURCE_MIME_TYPE: "text/html;profile=mcp-app";
+export declare const MCP_APP_RESOURCE_URI_PREFIX = "ui://crewx/";
+export type McpAppToolVisibility = 'model' | 'app';
+export type McpAppTone = 'blue' | 'violet' | 'emerald' | 'amber' | 'rose' | 'sky' | 'slate' | 'indigo';
+export declare const MCP_APP_HOST_TOOL_ALLOWLIST: readonly ["crewx_app_terminal_connect", "crewx_app_html_viewer_open"];
+export type McpAppHostToolName = typeof MCP_APP_HOST_TOOL_ALLOWLIST[number];
+export declare const MCP_CORE_TOOL_NAMES: readonly ["crewx_listWorkspaces", "crewx_queryAgent", "crewx_executeAgent", "crewx_getTaskResult", "crewx_listTasks", "crewx_listAgents", "callBrowser", "openTab", "listTabs", "closeTab"];
+export type McpCoreToolName = typeof MCP_CORE_TOOL_NAMES[number];
+export interface McpUiResourceCsp {
+    readonly connectDomains?: readonly string[];
+    readonly resourceDomains?: readonly string[];
+    readonly frameDomains?: readonly string[];
+    readonly baseUriDomains?: readonly string[];
+}
+export type McpAppInputSchema = JsonObject;
+export interface McpAppToolCommonInput {
+    readonly name: string;
+    readonly description: string;
+    readonly inputSchema: McpAppInputSchema;
+    readonly textFallback: string;
+    readonly visibility: readonly McpAppToolVisibility[];
+}
+export interface McpAppReadToolInput extends McpAppToolCommonInput {
+    readonly kind: 'read';
+    readonly actionId?: never;
+    readonly fixedResult?: McpAppFixedResult;
+}
+export interface McpAppFixedResult {
+    readonly structuredContent: JsonObject;
+    readonly argsPolicy: 'empty-only' | 'ignore';
+}
+export interface McpAppSingleActionToolInput extends McpAppToolCommonInput {
+    readonly kind: 'action';
+    readonly actionId: string;
+    readonly actionIds?: never;
+}
+export interface McpAppActionDispatcherToolInput extends McpAppToolCommonInput {
+    readonly kind: 'action';
+    readonly actionId?: never;
+    readonly actionIds: readonly string[];
+}
+export type McpAppActionToolInput = McpAppSingleActionToolInput | McpAppActionDispatcherToolInput;
+export type McpAppActionToolDescriptor = (Omit<McpAppSingleActionToolInput, 'actionIds'> & {
+    readonly actionIds: readonly string[];
+}) | (Omit<McpAppActionDispatcherToolInput, 'actionId'> & {
+    readonly actionIds: readonly string[];
+});
+type McpAppToolDescriptorMetadata = {
+    readonly appId?: string;
+    readonly provenance?: ProductAppBundleProvenance;
+    readonly resourceUri: string;
+    readonly _meta: McpAppToolMetadata;
+};
+export interface McpAppHostToolInput extends Omit<McpAppToolCommonInput, 'name' | 'visibility'> {
+    readonly name: McpAppHostToolName;
+    readonly kind: 'host';
+    readonly visibility: readonly ['app'];
+    readonly actionId?: never;
+}
+export type McpAppToolInput = McpAppReadToolInput | McpAppActionToolInput | McpAppHostToolInput;
+export interface McpAppDescriptorInput {
+    readonly appId: string;
+    readonly html: string;
+    readonly name?: string;
+    readonly description?: string;
+    readonly icon?: string;
+    readonly tone?: McpAppTone;
+    readonly builtinOnly?: boolean;
+    readonly csp?: McpUiResourceCsp;
+    readonly tools: readonly McpAppToolInput[];
+    readonly definition?: UiDefinition;
+    readonly provenance?: ProductAppBundleProvenance;
+    readonly entryBytes?: Uint8Array | readonly number[];
+}
+export interface McpAppResource {
+    readonly uri: string;
+    readonly mimeType: typeof MCP_APP_RESOURCE_MIME_TYPE;
+    readonly text: string;
+    readonly _meta?: {
+        readonly ui?: {
+            readonly csp?: McpUiResourceCsp;
+        };
+    };
+}
+export declare const MCP_APP_LOCAL_RESOURCE_MIME_TYPE: "text/html";
+export interface McpAppInstanceResourceBinding {
+    readonly kind: 'instance';
+}
+export interface McpAppMcpResourceBinding {
+    readonly kind: 'mcp';
+    readonly uri: string;
+}
+export type McpAppResourceBinding = McpAppInstanceResourceBinding | McpAppMcpResourceBinding;
+export interface McpAppLocalResource {
+    readonly mimeType: typeof MCP_APP_LOCAL_RESOURCE_MIME_TYPE;
+    readonly entryHash: string;
+    readonly html: string;
+    readonly bytes: readonly number[];
+    readonly initialState?: {
+        readonly hash: string;
+        readonly bytes: readonly number[];
+    };
+}
+export interface McpAppLocalRegistrationInput {
+    readonly appId: string;
+    readonly name: string;
+    readonly description: string;
+    readonly icon?: string;
+    readonly tone?: McpAppTone;
+    readonly csp?: McpUiResourceCsp;
+    readonly runtime?: NonNullable<UiPluginManifestV2['runtime']>;
+    readonly definition: UiDefinition;
+    readonly html: string;
+    readonly entryHash: string;
+    readonly entryBytes?: readonly number[];
+    readonly initialState?: JsonObject;
+    readonly initialStateHash?: string;
+    readonly initialStateBytes?: readonly number[];
+    readonly readToolName: string;
+    readonly actionToolName?: string;
+    readonly modelActions?: readonly string[];
+    readonly actions: readonly {
+        readonly actionId: string;
+        readonly inputSchema: McpAppInputSchema;
+        readonly backend?: {
+            readonly type: 'core';
+            readonly handler: string;
+        } | {
+            readonly type: 'skill';
+            readonly command?: readonly string[];
+        };
+    }[];
+}
+export interface McpAppLocalReadToolDescriptor extends McpAppToolCommonInput {
+    readonly kind: 'read';
+    readonly resourceBinding: McpAppInstanceResourceBinding;
+    readonly actionIds?: never;
+}
+export interface McpAppLocalActionToolDescriptor extends McpAppToolCommonInput {
+    readonly kind: 'action';
+    readonly resourceBinding: McpAppInstanceResourceBinding;
+    readonly actionIds: readonly string[];
+}
+export interface McpAppLocalSingleActionToolDescriptor extends McpAppToolCommonInput {
+    readonly kind: 'action';
+    readonly resourceBinding: McpAppInstanceResourceBinding;
+    readonly actionId: string;
+    readonly actionIds: readonly [string];
+    readonly _meta: {
+        readonly ui: {
+            readonly visibility: readonly McpAppToolVisibility[];
+        };
+    };
+}
+export interface McpAppLocalHostToolDescriptor extends Omit<McpAppToolCommonInput, 'name' | 'visibility'> {
+    readonly name: McpAppHostToolName;
+    readonly kind: 'host';
+    readonly visibility: readonly ['app'];
+    readonly resourceBinding: McpAppInstanceResourceBinding;
+    readonly actionId?: never;
+}
+export interface McpAppLocalToolDiagnostic {
+    readonly toolName: string;
+    readonly actionId: string;
+    readonly reason: 'name_too_long' | 'name_collision';
+}
+export type McpAppLocalToolDescriptor = McpAppLocalReadToolDescriptor | McpAppLocalActionToolDescriptor | McpAppLocalSingleActionToolDescriptor | McpAppLocalHostToolDescriptor;
+export interface McpAppLocalRegistration {
+    readonly appId: string;
+    readonly name: string;
+    readonly description: string;
+    readonly icon?: string;
+    readonly tone?: McpAppTone;
+    readonly builtinOnly: false;
+    readonly definition: UiDefinition;
+    readonly runtime?: NonNullable<UiPluginManifestV2['runtime']>;
+    readonly provenance?: ProductAppBundleProvenance;
+    readonly resourceBinding: McpAppInstanceResourceBinding;
+    readonly resource: McpAppLocalResource;
+    readonly tools: readonly McpAppLocalToolDescriptor[];
+    readonly toolDiagnostics: readonly McpAppLocalToolDiagnostic[];
+}
+export interface McpAppBuiltinRegistration {
+    readonly appId: string;
+    readonly name: string;
+    readonly description: string;
+    readonly icon?: string;
+    readonly tone?: McpAppTone;
+    readonly builtinOnly: boolean;
+    readonly uiUri: string;
+    readonly definition?: UiDefinition;
+    readonly resourceBinding: McpAppMcpResourceBinding;
+    readonly resource: McpAppResource;
+    readonly tools: readonly McpAppToolDescriptor[];
+    readonly descriptor: McpAppDescriptor;
+}
+export type McpAppResolvedRegistration = McpAppLocalRegistration | McpAppBuiltinRegistration;
+export interface McpAppLocalLauncher {
+    readonly appId: string;
+    readonly name: string;
+    readonly description: string;
+    readonly icon?: string;
+    readonly tone?: McpAppTone;
+    readonly builtinOnly: false;
+    readonly definition: UiDefinitionRef;
+    readonly provenance?: ProductAppBundleProvenance;
+    readonly entryHash: string;
+    readonly resourceBinding: McpAppInstanceResourceBinding;
+    readonly tools: readonly McpAppLocalToolDescriptor[];
+}
+export interface McpAppBuiltinLauncher {
+    readonly appId: string;
+    readonly name: string;
+    readonly description: string;
+    readonly icon?: string;
+    readonly tone?: McpAppTone;
+    readonly builtinOnly: boolean;
+    readonly uiUri: string;
+    readonly definition?: UiDefinitionRef;
+    readonly resourceBinding: McpAppMcpResourceBinding;
+    readonly tools: readonly McpAppToolDescriptor[];
+}
+export type McpAppLauncher = McpAppLocalLauncher | McpAppBuiltinLauncher;
+export type WorkspaceAppLauncher = McpAppLauncher;
+export type WorkspaceAppResolvedRegistration = McpAppResolvedRegistration;
+export interface McpAppWorkspaceRegistry {
+    getMcpApp(appId: string): McpAppDescriptor | null;
+    listMcpApps(): readonly McpAppDescriptor[];
+    listMcpAppTools(): readonly McpAppToolDescriptor[];
+    resolveMcpAppTool(toolName: string): McpAppToolDescriptor | null;
+    resolveMcpAppResource(uri: string): McpAppResource | null;
+    requireMcpAppResource(uri: string): McpAppResource;
+    listLocalMcpApps(): readonly McpAppLocalRegistration[];
+    getLocalMcpApp(appId: string): McpAppLocalRegistration | null;
+    listLocalMcpAppTools(): readonly McpAppLocalToolDescriptor[];
+    resolveLocalMcpAppTool(toolName: string): McpAppLocalToolDescriptor | null;
+    resolveLocalMcpAppResource(appId: string, definitionHash?: string): McpAppLocalResource | null;
+    listRegistrations(): readonly McpAppResolvedRegistration[];
+    getRegistration(appId: string): McpAppResolvedRegistration | null;
+    listLaunchers(): readonly McpAppLauncher[];
+    getLauncher(appId: string): McpAppLauncher | null;
+    resolveDefinition(ref: UiDefinitionRef): UiDefinition | null;
+    resolveActionHandler(definitionId: string, version: number, actionId: string): UiActionHandlerRegistration | null;
+}
+export type WorkspaceAppRegistry = McpAppWorkspaceRegistry;
+export interface McpAppWorkspaceRegistryInput {
+    readonly builtins?: McpAppRegistry;
+    readonly builtin?: McpAppRegistry;
+    readonly localApps?: readonly McpAppLocalRegistration[];
+    readonly locals?: readonly McpAppLocalRegistration[];
+    readonly definitions?: readonly UiDefinition[];
+    readonly handlers?: readonly UiActionHandlerRegistration[];
+}
+export interface McpAppToolMetadata {
+    readonly ui: {
+        readonly resourceUri: string;
+        readonly visibility: readonly McpAppToolVisibility[];
+    };
+}
+export type McpAppToolDescriptor = (McpAppReadToolInput & McpAppToolDescriptorMetadata) | (McpAppActionToolDescriptor & McpAppToolDescriptorMetadata) | (McpAppHostToolInput & McpAppToolDescriptorMetadata);
+export interface McpAppToolRegistration {
+    readonly name: string;
+    readonly description: string;
+    readonly inputSchema: McpAppInputSchema;
+    readonly _meta: McpAppToolMetadata;
+}
+export interface McpAppDescriptor {
+    readonly appId: string;
+    readonly name: string;
+    readonly description: string;
+    readonly icon?: string;
+    readonly tone?: McpAppTone;
+    readonly builtinOnly: boolean;
+    readonly csp?: McpUiResourceCsp;
+    readonly uiUri: string;
+    readonly html: string;
+    readonly definition?: UiDefinition;
+    readonly provenance?: ProductAppBundleProvenance;
+    readonly tools: readonly McpAppToolDescriptor[];
+}
+export interface McpAppFixedResultCall {
+    readonly kind: 'result';
+    readonly result: McpAppToolResult;
+}
+export interface McpAppFixedResultInvalidParams {
+    readonly kind: 'invalid_params';
+    readonly code: 'INVALID_PARAMS';
+    readonly message: string;
+}
+export interface McpAppFixedResultUnavailable {
+    readonly kind: 'unavailable';
+}
+export type McpAppFixedResultResolution = McpAppFixedResultCall | McpAppFixedResultInvalidParams | McpAppFixedResultUnavailable;
+export interface McpAppToolResult {
+    readonly content: readonly [{
+        readonly type: 'text';
+        readonly text: string;
+    }];
+    readonly structuredContent?: JsonObject;
+    readonly _meta?: JsonObject;
+}
+export interface McpAppButtonInput {
+    readonly id: string;
+    readonly label: string;
+    readonly enabled: boolean;
+    readonly confirmation?: UiActionConfirmation;
+    readonly requiresHumanConfirmation?: boolean;
+    readonly disabledReason?: string;
+    readonly inputSchema: McpAppInputSchema;
+}
+export interface McpAppServerStateInput {
+    readonly source: 'server';
+    readonly instance: Pick<UiInstance, 'id' | 'definition' | 'revision' | 'status' | 'state'>;
+    readonly definition: UiDefinition;
+    readonly buttons: readonly McpAppButtonInput[];
+}
+export interface McpAppButtonDescriptor {
+    readonly id: string;
+    readonly label: string;
+    readonly enabled: boolean;
+    readonly confirmation: UiActionConfirmation;
+    readonly requiresHumanConfirmation?: boolean;
+    readonly disabledReason: string | null;
+    readonly inputSchema: McpAppInputSchema;
+}
+export interface McpAppStateDescriptor {
+    readonly schemaVersion: 1;
+    readonly source: 'server';
+    readonly instanceId: string;
+    readonly definition: UiDefinitionRef;
+    readonly revision: number;
+    readonly status: UiInstanceStatus;
+    readonly state: JsonObject;
+    readonly buttons: readonly McpAppButtonDescriptor[];
+}
+export interface McpAppStateProjections {
+    readonly descriptor: McpAppStateDescriptor;
+    readonly card: McpAppStateDescriptor;
+    readonly developer: {
+        readonly descriptor: McpAppStateDescriptor;
+        readonly json: string;
+    };
+    readonly ai: {
+        readonly descriptor: McpAppStateDescriptor;
+        readonly json: string;
+        readonly xml: string;
+        readonly omittedPaths?: readonly string[];
+    };
+    readonly focusedAi: {
+        readonly descriptor: McpAppStateDescriptor;
+        readonly json: string;
+        readonly xml: string;
+        readonly omittedPaths?: readonly string[];
+    };
+}
+export interface McpAppRegistry {
+    registerMcpApp(input: McpAppDescriptorInput): McpAppDescriptor;
+    getMcpApp(appId: string): McpAppDescriptor | null;
+    listMcpApps(): readonly McpAppDescriptor[];
+    listMcpAppTools(): readonly McpAppToolDescriptor[];
+    resolveMcpAppTool(toolName: string): McpAppToolDescriptor | null;
+    resolveMcpAppResource(uri: string): McpAppResource | null;
+    requireMcpAppResource(uri: string): McpAppResource;
+}
+export interface McpAppRegistryOptions {
+    readonly reservedToolNames?: Iterable<string>;
+}
+export interface McpAppBundleHostToolTemplate {
+    readonly capability: string;
+    readonly description: string;
+    readonly inputSchema: McpAppInputSchema;
+    readonly textFallback: string;
+}
+export interface McpAppBundleAgentActionDescriptor {
+    readonly appId: string;
+    readonly provenance: ProductAppBundleProvenance;
+    readonly name: string;
+    readonly description: string;
+    readonly inputSchema: McpAppInputSchema;
+    readonly textFallback: string;
+    readonly kind: 'action';
+    readonly actionId: string;
+    readonly access: 'allowed' | 'approval_required' | 'denied';
+    readonly visibility: readonly McpAppToolVisibility[];
+    readonly resourceUri: string;
+    readonly _meta: McpAppToolMetadata;
+}
+export type CrewxAppCapability = 'screen' | 'skill';
+export type CrewxAppOrigin = 'local' | 'installed' | 'builtin';
+export type CrewxAppOwnership = 'mine' | 'external' | 'unknown';
+export type CrewxAppShareability = 'shareable' | 'requiresPublish' | 'forbidden' | 'unknown';
+export type CrewxAppSharingAvailability = 'ready' | 'loginRequired' | 'unavailable';
+export interface CrewxAppLocalDefinitionRef {
+    readonly packageRoot: string;
+}
+export interface CrewxAppDefinitionSummary extends UiDefinitionRef {
+    readonly usage: UiDefinitionUsage;
+    readonly detailPanel?: boolean;
+    readonly displayModes?: readonly UiDefinitionDisplayMode[];
+    readonly summaryProjection?: UiProjectionPolicy;
+}
+export interface CrewxAppDefinitionHashInput {
+    readonly screenHash?: string;
+    readonly skillHash?: string;
+    readonly relativePath?: string;
+    readonly fileBytes?: Uint8Array | ArrayBuffer | readonly number[] | string;
+}
+export interface CrewxAppSummary {
+    readonly appId: string;
+    readonly name: string;
+    readonly description: string;
+    readonly version?: string;
+    readonly capabilities: readonly CrewxAppCapability[];
+    readonly definition?: CrewxAppDefinitionSummary;
+    readonly skillName?: string;
+    readonly localDefinitionRef?: CrewxAppLocalDefinitionRef;
+    readonly origin: CrewxAppOrigin;
+    readonly ownership: CrewxAppOwnership;
+    readonly shareability: CrewxAppShareability;
+    readonly sharingAvailability: CrewxAppSharingAvailability;
+    readonly marketplaceContentId?: string;
+    readonly slug?: string;
+    readonly definitionHash: string;
+    readonly provenance?: ProductAppBundleProvenance;
+}
+export type CrewxAppDiagnosticCode = 'MANIFEST_MISSING' | 'MANIFEST_INVALID' | 'ENTRY_INVALID' | 'INITIAL_STATE_INVALID' | 'DUPLICATE_ID' | 'RESERVED_ID' | 'BUNDLE_INTEGRITY' | 'LINEAGE_INVALID' | 'LINEAGE_STALE' | 'PATH_ESCAPED' | 'LIMIT_EXCEEDED' | 'ASSET_CATALOG_INVALID' | 'EXEC_DENIED' | 'SKILL_INVALID' | 'SKILL_READ_FAILED' | 'INSTALLED_MISSING' | 'INSTALLED_CONTENT_ID_MISSING' | 'INSTALLED_IDENTITY_MISMATCH' | 'BUILTIN_INVALID';
+export type CrewxAppDiagnosticSource = 'apps' | 'skills' | 'bundled' | 'node_modules' | 'builtin' | 'installed';
+export interface CrewxAppDiagnostic {
+    readonly code: CrewxAppDiagnosticCode;
+    readonly source: CrewxAppDiagnosticSource;
+    readonly relativePath: string;
+    readonly appId?: string;
+}
+export interface CrewxAppInstalledProjection {
+    readonly packageRoot?: string;
+    readonly relativePath?: string;
+    readonly packageRootPath?: string;
+    readonly appId?: string;
+    readonly definitionHash?: string;
+    readonly marketplaceContentId?: string;
+    readonly slug?: string;
+}
+export type CrewxAppBuiltinCatalog = Pick<McpAppRegistry, 'listMcpApps' | 'listMcpAppTools'>;
+export interface CrewxAppCatalogOptions {
+    readonly filesystem?: AppDiscoveryFileSystem;
+    readonly productBundle?: ProductAppBundleInput;
+    readonly registeredProductBundle?: ProductAppBundleSnapshotMetadata;
+    readonly builtinCatalog?: CrewxAppBuiltinCatalog;
+    readonly installed?: readonly CrewxAppInstalledProjection[];
+}
+export interface CrewxAppCatalogResult {
+    readonly items: readonly CrewxAppSummary[];
+    readonly diagnostics: readonly CrewxAppDiagnostic[];
+}
+export {};

package/dist/mcp-app/workspace-app-assets.d.ts

@@ -0,0 +1,38 @@
+import type { AppDiscoveryFileSystem, WorkspaceAppCandidate, WorkspaceAppDiagnostic, WorkspaceAppSource } from './discovery.js';
+import { type ProductAppBundleAsset } from './product-bundle-assets.js';
+export interface WorkspaceAppAssetLocator {
+    readonly role: string;
+    readonly sha256: string;
+    readonly filename: string;
+}
+export interface WorkspaceAppAssetDescriptorV1 {
+    readonly schemaVersion: 1;
+    readonly styles: readonly WorkspaceAppAssetLocator[];
+    readonly imports: readonly WorkspaceAppAssetLocator[];
+    readonly moduleEntry: WorkspaceAppAssetLocator & {
+        readonly role: 'app-entry';
+    };
+    readonly workers: readonly WorkspaceAppAssetLocator[];
+}
+export interface WorkspaceAppAsset extends Pick<ProductAppBundleAsset, 'sha256' | 'filename' | 'contentType' | 'byteLength' | 'bytes'> {
+    readonly role: string;
+}
+export interface WorkspaceAppAssetCatalog {
+    readonly catalogId: string;
+    readonly snapshotHash: string;
+    readonly appId: string;
+    readonly source: WorkspaceAppSource;
+    readonly definitionHash: string;
+    readonly descriptor: WorkspaceAppAssetDescriptorV1;
+    readonly assets: readonly WorkspaceAppAsset[];
+    get(sha256: string, filename: string): WorkspaceAppAsset | undefined;
+    readVerified(sha256: string, filename: string): Promise<Uint8Array | undefined>;
+}
+export interface WorkspaceAppAssetCatalogDraft extends Omit<WorkspaceAppAssetCatalog, 'catalogId' | 'snapshotHash' | 'get'> {
+}
+export interface WorkspaceAppAssetCatalogLoadResult {
+    readonly catalogs: readonly WorkspaceAppAssetCatalogDraft[];
+    readonly diagnostics: readonly WorkspaceAppDiagnostic[];
+}
+export declare function loadWorkspaceAppAssetCatalogs(workspaceRoot: string, candidates: readonly WorkspaceAppCandidate[], filesystem?: AppDiscoveryFileSystem): Promise<WorkspaceAppAssetCatalogLoadResult>;
+export declare function sealWorkspaceAppAssetCatalog(draft: WorkspaceAppAssetCatalogDraft, snapshotHash: string): WorkspaceAppAssetCatalog;

package/dist/mcp-app/workspace-snapshot.d.ts

@@ -0,0 +1,70 @@
+import { type AppDiscoveryFileSystem, type WorkspaceAppDiscoveryIncompleteReason, type WorkspaceAppDiagnostic, type WorkspaceAppDiscoveryOptions, type WorkspaceAppDiscoveryResult, type WorkspaceAppSource, type ProductAppBundleProvenance, type ProductAppBundleSnapshotMetadata } from './discovery.js';
+import { type SkillBackendExecutionPort } from './skill-backend.js';
+import { type WorkspaceAppAssetCatalog } from './workspace-app-assets.js';
+import type { JsonObject, UiActionHandlerRegistration, UiDefinition, UiDefinitionRef } from '../ui-instance/types.js';
+import type { UiPluginManifestV2 } from '../ui-plugin/types.js';
+import type { McpAppLauncher, McpAppLocalResource, McpAppRegistry, McpAppWorkspaceRegistry } from './types.js';
+export interface WorkspaceAppSnapshotResource extends McpAppLocalResource {
+    readonly appId: string;
+    readonly definition: UiDefinitionRef;
+    readonly relativePath?: string;
+    readonly runtime?: NonNullable<UiPluginManifestV2['runtime']>;
+    readonly source?: WorkspaceAppSource;
+    readonly provenance?: ProductAppBundleProvenance;
+    readonly assetCatalogId?: string;
+}
+export interface WorkspaceAppSnapshotInitialState {
+    readonly appId: string;
+    readonly definition: UiDefinitionRef;
+    readonly hash: string;
+    readonly bytes: readonly number[];
+    readonly state: JsonObject;
+}
+export type WorkspaceAppInitialState = WorkspaceAppSnapshotInitialState;
+export interface WorkspaceAppSnapshotBuildOptions {
+    readonly builtins?: McpAppRegistry;
+    readonly builtin?: McpAppRegistry;
+    readonly registry?: McpAppRegistry;
+    readonly registeredProductBundle?: ProductAppBundleSnapshotMetadata;
+    readonly skillBackend?: SkillBackendExecutionPort;
+}
+export type WorkspaceAppSnapshotOptions = WorkspaceAppDiscoveryOptions & WorkspaceAppSnapshotBuildOptions;
+export interface WorkspaceAppSnapshot {
+    readonly snapshotHash: string;
+    readonly launchers: readonly McpAppLauncher[];
+    readonly definitions: readonly UiDefinition[];
+    readonly actionHandlers: readonly UiActionHandlerRegistration[];
+    readonly resources: readonly WorkspaceAppSnapshotResource[];
+    readonly assetCatalogs: readonly WorkspaceAppAssetCatalog[];
+    readonly initialStates: readonly WorkspaceAppSnapshotInitialState[];
+    readonly diagnostics: readonly WorkspaceAppDiagnostic[];
+    readonly registry: McpAppWorkspaceRegistry;
+    resolveDefinition(ref: UiDefinitionRef): UiDefinition | null;
+    resolveActionHandler(definitionId: string, version: number, actionId: string): UiActionHandlerRegistration | null;
+    resolveResource(appId: string, definitionHash?: string): WorkspaceAppSnapshotResource | null;
+    resolveAssetCatalog(appId: string, definitionHash?: string): WorkspaceAppAssetCatalog | null;
+}
+export type WorkspaceAppSnapshotReconfirmResult = {
+    readonly kind: 'same_generation';
+    readonly snapshot: WorkspaceAppSnapshot;
+    readonly diagnostics: readonly WorkspaceAppDiagnostic[];
+} | {
+    readonly kind: 'new_generation';
+    readonly previousSnapshot: WorkspaceAppSnapshot;
+    readonly snapshot: WorkspaceAppSnapshot;
+    readonly diagnostics: readonly WorkspaceAppDiagnostic[];
+} | {
+    readonly kind: 'incomplete';
+    readonly reason: WorkspaceAppDiscoveryIncompleteReason;
+    readonly snapshot: WorkspaceAppSnapshot;
+    readonly diagnostics: readonly WorkspaceAppDiagnostic[];
+} | {
+    readonly kind: 'io_error';
+    readonly snapshot: WorkspaceAppSnapshot;
+    readonly diagnostics: readonly WorkspaceAppDiagnostic[];
+};
+export declare function buildWorkspaceAppSnapshot(discovery: WorkspaceAppDiscoveryResult, options?: WorkspaceAppSnapshotBuildOptions): WorkspaceAppSnapshot;
+export declare function discoverWorkspaceAppSnapshot(workspaceRoot: string, options?: WorkspaceAppSnapshotOptions): Promise<WorkspaceAppSnapshot>;
+export declare function discoverWorkspaceAppSnapshot(workspaceRoot: string, filesystem: AppDiscoveryFileSystem, options?: WorkspaceAppSnapshotOptions): Promise<WorkspaceAppSnapshot>;
+export declare function reconfirmWorkspaceAppSnapshot(workspaceRoot: string, currentSnapshot: WorkspaceAppSnapshot, options?: WorkspaceAppSnapshotOptions): Promise<WorkspaceAppSnapshotReconfirmResult>;
+export declare function reconfirmWorkspaceAppSnapshot(workspaceRoot: string, currentSnapshot: WorkspaceAppSnapshot, filesystem: AppDiscoveryFileSystem, options?: WorkspaceAppSnapshotOptions): Promise<WorkspaceAppSnapshotReconfirmResult>;

package/dist/migrations/0010_analyze_stats.sql

@@ -0,0 +1,6 @@
+-- Custom SQL migration file, put your code below! --
+-- WI-20260706-006: seed sqlite_stat1 so the query planner has index
+-- selectivity data from the very first run on a fresh DB (idempotent).
+PRAGMA analysis_limit = 400;
+--> statement-breakpoint
+ANALYZE;

package/dist/migrations/0011_far_black_tarantula.sql

@@ -0,0 +1 @@
+CREATE INDEX IF NOT EXISTS `idx_threads_title` ON `threads` (`title`);

package/dist/migrations/0012_blue_turbo.sql

@@ -0,0 +1,23 @@
+CREATE TABLE IF NOT EXISTS `notification_reads` (
+	`notification_id` text NOT NULL,
+	`user_id` text NOT NULL,
+	`read_at` text NOT NULL,
+	PRIMARY KEY(`notification_id`, `user_id`)
+);
+--> statement-breakpoint
+CREATE TABLE IF NOT EXISTS `notifications` (
+	`id` text PRIMARY KEY NOT NULL,
+	`workspace_id` text NOT NULL,
+	`agent_id` text,
+	`task_id` text,
+	`thread_id` text,
+	`source` text DEFAULT 'agent' NOT NULL,
+	`level` text DEFAULT 'info' NOT NULL,
+	`title` text NOT NULL,
+	`body` text,
+	`target_user_id` text,
+	`created_at` text NOT NULL,
+	`metadata` text
+);
+--> statement-breakpoint
+CREATE INDEX IF NOT EXISTS `idx_notifications_ws_created` ON `notifications` (`workspace_id`,"created_at" DESC);

package/dist/migrations/0013_hesitant_adam_destine.sql

@@ -0,0 +1,15 @@
+CREATE TABLE IF NOT EXISTS `agent_suggestions` (
+	`id` text PRIMARY KEY NOT NULL,
+	`workspace_id` text NOT NULL,
+	`agent_id` text NOT NULL,
+	`task_id` text,
+	`type` text NOT NULL,
+	`status` text DEFAULT 'pending' NOT NULL,
+	`payload` text NOT NULL,
+	`applied_commit_sha` text,
+	`created_at` text NOT NULL,
+	`updated_at` text NOT NULL
+);
+--> statement-breakpoint
+CREATE INDEX IF NOT EXISTS `idx_agent_suggestions_ws_agent` ON `agent_suggestions` (`workspace_id`,`agent_id`);--> statement-breakpoint
+CREATE INDEX IF NOT EXISTS `idx_agent_suggestions_ws_created` ON `agent_suggestions` (`workspace_id`,`created_at`);