@crewx/sdk 0.9.0-rc.127 → 0.9.0-rc.128

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

@@ -5,12 +5,18 @@ import { AppDiscoveryFsError, NodeAppDiscoveryFs, NodeAppDiscoveryFsAdapter, def
 import type { McpAppRegistry } from './types.js';
 export type WorkspaceAppSource = 'apps' | 'skills';
 export type WorkspaceAppDiscoverySource = WorkspaceAppSource | 'bundled';
+export interface ProductAppBundleReservations {
+    readonly appIds: readonly string[];
+    readonly definitionIds: readonly string[];
+}
 export interface ProductAppBundleInput {
-    readonly root: string;
+    readonly root: string | null;
     readonly expectedIndexHash: string;
+    readonly reservedIds: ProductAppBundleReservations;
 }
 export interface ProductAppBundleProvenance {
     readonly kind: 'bundled';
+    readonly launcher: boolean;
     readonly indexHash: string;
     readonly packageDir: string;
     readonly appId: string;
@@ -30,6 +36,7 @@ export interface ProductAppBundleDefinitionIdentity {
 }
 export interface ProductAppBundlePackageIndex {
     readonly packageDir: string;
+    readonly launcher?: false;
     readonly appId: string;
     readonly definition: ProductAppBundleDefinitionIdentity;
     readonly lineage: readonly UiDefinitionLineageEntry[];
@@ -47,6 +54,12 @@ export interface WorkspaceAppDiagnostic {
     readonly source: WorkspaceAppDiscoverySource;
     readonly relativePath: string;
 }
+export interface ProductAppBundleSnapshotMetadata {
+    readonly indexHash?: string;
+    readonly diagnostics: readonly WorkspaceAppDiagnostic[];
+    readonly reservedAppIds: readonly string[];
+    readonly reservedDefinitionIds: readonly string[];
+}
 export type McpAppDiscoveryDiagnostic = WorkspaceAppDiagnostic;
 export type AppDiscoveryDiagnostic = WorkspaceAppDiagnostic;
 export type AppDiscoveryDirectoryEntryKind = 'file' | 'directory' | 'symlink' | 'other';
@@ -140,6 +153,7 @@ export interface WorkspaceAppDiscoveryResult {
     readonly complete: boolean;
     readonly incompleteReason?: WorkspaceAppDiscoveryIncompleteReason;
     readonly productBundleIndexHash?: string;
+    readonly productBundleSnapshotMetadata?: ProductAppBundleSnapshotMetadata;
     readonly candidates?: readonly WorkspaceAppCandidate[];
 }
 export declare const WORKSPACE_APP_TOOL_PREFIX = "crewx_local_app_";
@@ -147,6 +161,7 @@ export declare const LOCAL_APP_TOOL_PREFIX = "crewx_local_app_";
 export declare const MCP_APP_WORKSPACE_TOOL_PREFIX = "crewx_local_app_";
 export declare function deriveWorkspaceAppToolNames(pluginId: string): WorkspaceAppToolNames;
 export declare function deriveWorkspaceAppToolName(pluginId: string, kind?: 'read' | 'action'): string;
+export declare function productAppBundleReservations(packages: readonly ProductAppBundlePackageIndex[]): ProductAppBundleReservations;
 export declare function discoverWorkspaceApps(workspaceRoot: string, fs?: AppDiscoveryFileSystem, options?: WorkspaceAppDiscoveryOptions): Promise<WorkspaceAppDiscoveryResult>;
 export declare function discoverWorkspaceApps(workspaceRoot: string, options?: WorkspaceAppDiscoveryOptions): Promise<WorkspaceAppDiscoveryResult>;
 export declare const discoverWorkspaceAppCandidates: typeof discoverWorkspaceApps;

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

@@ -3,8 +3,8 @@ export { McpAppContractError } from './errors.js';
 export { INSTALLED_APP_ENTRY, InstalledAppRefError, buildInstalledAppRef, validateInstalledAppRef, } from './installed-app-ref.js';
 export type { BuildInstalledAppRefInput, InstalledAppPackageFile, InstalledAppRef, InstalledAppRefErrorCode, } from './installed-app-ref.js';
 export { MAX_HTML_LENGTH, createMcpAppRegistry, createBuiltinMcpAppRegistry, buildMcpAppLocalRegistration, createMcpAppLocalRegistration, registerLocalMcpApp, createMcpAppWorkspaceRegistry, createWorkspaceAppRegistry, createWorkspaceMcpAppRegistry, registerMcpApp, resolveMcpAppResource, resolveLocalMcpAppResource, requireMcpAppResource, toMcpAppToolRegistration, makeUiUri, buildMcpAppBundleRegistrationInput, buildMcpAppBundleAgentActionDescriptors, planProductBundleLegacyToolNames, resolveMcpAppFixedResultCall, } from './registry.js';
-export { AppDiscoveryFsError, NodeAppDiscoveryFs, NodeAppDiscoveryFsAdapter, defaultAppDiscoveryFs, defaultNodeAppDiscoveryFs, deriveWorkspaceAppToolName, deriveWorkspaceAppToolNames, discoverWorkspaceAppCandidates, discoverWorkspaceApps, LOCAL_APP_TOOL_PREFIX, MCP_APP_WORKSPACE_TOOL_PREFIX, scanWorkspaceApps, WORKSPACE_APP_TOOL_PREFIX, } from './discovery.js';
-export type { AppDiscoveryBytes, AppDiscoveryDiagnostic, AppDiscoveryDirectoryEntry, AppDiscoveryDirectoryEntryKind, AppDiscoveryDirectoryListing, AppDiscoveryFileSystem, AppDiscoveryFsErrorCode, AppDiscoveryMaybePromise, WorkspaceAppDiscoveryOptions as AppDiscoveryOptions, McpAppDiscoveryDiagnostic, WorkspaceAppBuiltinCatalog, WorkspaceAppCandidate, WorkspaceAppDiscoveryIncompleteReason, WorkspaceAppDiscoveryOptions, WorkspaceAppDiscoveryResult, WorkspaceAppDiagnostic, WorkspaceAppDiagnosticCode, WorkspaceAppDiscoverySource, WorkspaceAppResourceSnapshot, WorkspaceAppReservedCatalog, WorkspaceAppSource, WorkspaceAppToolNames, ProductAppBundleDefinitionIdentity, ProductAppBundleFileHash, ProductAppBundleIndex, ProductAppBundleInput, ProductAppBundlePackageIndex, ProductAppBundleProvenance, } from './discovery.js';
+export { AppDiscoveryFsError, NodeAppDiscoveryFs, NodeAppDiscoveryFsAdapter, defaultAppDiscoveryFs, defaultNodeAppDiscoveryFs, deriveWorkspaceAppToolName, deriveWorkspaceAppToolNames, discoverWorkspaceAppCandidates, discoverWorkspaceApps, LOCAL_APP_TOOL_PREFIX, MCP_APP_WORKSPACE_TOOL_PREFIX, productAppBundleReservations, scanWorkspaceApps, WORKSPACE_APP_TOOL_PREFIX, } from './discovery.js';
+export type { AppDiscoveryBytes, AppDiscoveryDiagnostic, AppDiscoveryDirectoryEntry, AppDiscoveryDirectoryEntryKind, AppDiscoveryDirectoryListing, AppDiscoveryFileSystem, AppDiscoveryFsErrorCode, AppDiscoveryMaybePromise, WorkspaceAppDiscoveryOptions as AppDiscoveryOptions, McpAppDiscoveryDiagnostic, WorkspaceAppBuiltinCatalog, WorkspaceAppCandidate, WorkspaceAppDiscoveryIncompleteReason, WorkspaceAppDiscoveryOptions, WorkspaceAppDiscoveryResult, WorkspaceAppDiagnostic, WorkspaceAppDiagnosticCode, WorkspaceAppDiscoverySource, WorkspaceAppResourceSnapshot, WorkspaceAppReservedCatalog, WorkspaceAppSource, WorkspaceAppToolNames, ProductAppBundleDefinitionIdentity, ProductAppBundleFileHash, ProductAppBundleIndex, ProductAppBundleInput, ProductAppBundlePackageIndex, ProductAppBundleReservations, ProductAppBundleProvenance, ProductAppBundleSnapshotMetadata, } from './discovery.js';
 export { createWorkspaceAppCatalog, discoverWorkspaceAppCatalog, hashAppDefinition, hashCrewxAppDefinition, listWorkspaceApps, } from './catalog.js';
 export type { CrewxAppBuiltinCatalog, CrewxAppCapability, CrewxAppCatalogOptions, CrewxAppCatalogResult, CrewxAppDefinitionHashInput, CrewxAppDefinitionSummary, CrewxAppDiagnostic, CrewxAppDiagnosticCode, CrewxAppDiagnosticSource, CrewxAppInstalledProjection, CrewxAppLocalDefinitionRef, CrewxAppOrigin, CrewxAppOwnership, CrewxAppShareability, CrewxAppSharingAvailability, CrewxAppSummary, } from './types.js';
 export { MCP_APP_PROJECTION_MAX_BYTES, buildMcpAppStateDescriptor, buildMcpAppStateProjections, buildTerminalMcpAppStateDescriptor, buildTerminalMcpAppStateProjections, createMcpAppToolResult, projectMcpAppSummaryState, serializeMcpAppStateJson, serializeMcpAppStateXml, } from './projection.js';

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

@@ -1,5 +1,5 @@
 import type { JsonObject, UiDefinition, UiDefinitionRef, UiDefinitionDisplayMode, UiDefinitionUsage, UiProjectionPolicy, UiInstance, UiInstanceStatus, UiActionConfirmation, UiActionHandlerRegistration } from '../ui-instance/types.js';
-import type { AppDiscoveryFileSystem, ProductAppBundleInput, ProductAppBundleProvenance } from './discovery.js';
+import type { AppDiscoveryFileSystem, ProductAppBundleInput, ProductAppBundleProvenance, ProductAppBundleSnapshotMetadata } from './discovery.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';
@@ -167,6 +167,7 @@ export interface McpAppLocalRegistration {
     readonly tone?: McpAppTone;
     readonly builtinOnly: false;
     readonly definition: UiDefinition;
+    readonly provenance?: ProductAppBundleProvenance;
     readonly resourceBinding: McpAppInstanceResourceBinding;
     readonly resource: McpAppLocalResource;
     readonly tools: readonly McpAppLocalToolDescriptor[];
@@ -436,6 +437,7 @@ export type CrewxAppBuiltinCatalog = Pick<McpAppRegistry, 'listMcpApps' | 'listM
 export interface CrewxAppCatalogOptions {
     readonly filesystem?: AppDiscoveryFileSystem;
     readonly productBundle?: ProductAppBundleInput;
+    readonly registeredProductBundle?: ProductAppBundleSnapshotMetadata;
     readonly builtinCatalog?: CrewxAppBuiltinCatalog;
     readonly installed?: readonly CrewxAppInstalledProjection[];
 }

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

@@ -1,10 +1,12 @@
-import { type AppDiscoveryFileSystem, type WorkspaceAppDiscoveryIncompleteReason, type WorkspaceAppDiagnostic, type WorkspaceAppDiscoveryOptions, type WorkspaceAppDiscoveryResult, type WorkspaceAppSource, type ProductAppBundleProvenance } from './discovery.js';
+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 { 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 runtime?: NonNullable<UiPluginManifestV2['runtime']>;
     readonly source?: WorkspaceAppSource;
     readonly provenance?: ProductAppBundleProvenance;
 }
@@ -20,6 +22,7 @@ export interface WorkspaceAppSnapshotBuildOptions {
     readonly builtins?: McpAppRegistry;
     readonly builtin?: McpAppRegistry;
     readonly registry?: McpAppRegistry;
+    readonly registeredProductBundle?: ProductAppBundleSnapshotMetadata;
     readonly skillBackend?: SkillBackendExecutionPort;
 }
 export type WorkspaceAppSnapshotOptions = WorkspaceAppDiscoveryOptions & WorkspaceAppSnapshotBuildOptions;