@crewx/sdk 0.9.0-rc.115 → 0.9.0-rc.117

package/dist/lifecycle/update-admission.d.ts

@@ -1,5 +1,6 @@
 export declare const UPDATE_QUIESCE_LOCK_FILENAME = "update-quiesce.lock";
 export declare const UPDATE_ADMISSION_RESERVATION_DIRNAME = "update-admission";
+export declare const UPDATE_ADMISSION_SCOPE_ENV = "CREWX_UPDATE_ADMISSION_SCOPE";
 export declare function resolveUpdateQuiesceLockFile(): string;
 export declare function resolveUpdateAdmissionReservationDir(): string;
 export declare function isProcessAlive(pid: number): boolean;

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

@@ -3,6 +3,7 @@ import type { UiPluginHandlerMetadata, UiPluginManifestV2, UiPluginNormalizedMan
 import { AppDiscoveryFsError, NodeAppDiscoveryFs, NodeAppDiscoveryFsAdapter, defaultAppDiscoveryFs, defaultNodeAppDiscoveryFs, type AppDiscoveryFsErrorCode } from './node-app-discovery-fs.js';
 import type { McpAppRegistry } from './types.js';
 export type WorkspaceAppSource = 'apps' | 'skills';
+export type WorkspaceAppDiscoveryIncompleteReason = 'time_limit';
 export type WorkspaceAppDiagnosticCode = 'MANIFEST_MISSING' | 'MANIFEST_INVALID' | 'ENTRY_INVALID' | 'INITIAL_STATE_INVALID' | 'DUPLICATE_ID' | 'RESERVED_ID' | 'PATH_ESCAPED' | 'LIMIT_EXCEEDED' | 'EXEC_DENIED';
 export interface WorkspaceAppDiagnostic {
     readonly code: WorkspaceAppDiagnosticCode;
@@ -90,6 +91,8 @@ export interface WorkspaceAppCandidate {
 export interface WorkspaceAppDiscoveryResult {
     readonly apps: readonly WorkspaceAppCandidate[];
     readonly diagnostics: readonly WorkspaceAppDiagnostic[];
+    readonly complete: boolean;
+    readonly incompleteReason?: WorkspaceAppDiscoveryIncompleteReason;
     readonly candidates?: readonly WorkspaceAppCandidate[];
 }
 export declare const WORKSPACE_APP_TOOL_PREFIX = "crewx_local_app_";

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

@@ -4,7 +4,7 @@ export { INSTALLED_APP_ENTRY, InstalledAppRefError, buildInstalledAppRef, valida
 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, } 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, WorkspaceAppDiscoveryOptions, WorkspaceAppDiscoveryResult, WorkspaceAppDiagnostic, WorkspaceAppDiagnosticCode, WorkspaceAppResourceSnapshot, WorkspaceAppReservedCatalog, WorkspaceAppSource, WorkspaceAppToolNames, } from './discovery.js';
+export type { AppDiscoveryBytes, AppDiscoveryDiagnostic, AppDiscoveryDirectoryEntry, AppDiscoveryDirectoryEntryKind, AppDiscoveryDirectoryListing, AppDiscoveryFileSystem, AppDiscoveryFsErrorCode, AppDiscoveryMaybePromise, WorkspaceAppDiscoveryOptions as AppDiscoveryOptions, McpAppDiscoveryDiagnostic, WorkspaceAppBuiltinCatalog, WorkspaceAppCandidate, WorkspaceAppDiscoveryIncompleteReason, WorkspaceAppDiscoveryOptions, WorkspaceAppDiscoveryResult, WorkspaceAppDiagnostic, WorkspaceAppDiagnosticCode, WorkspaceAppResourceSnapshot, WorkspaceAppReservedCatalog, WorkspaceAppSource, WorkspaceAppToolNames, } 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, serializeMcpAppStateJson, serializeMcpAppStateXml, } from './projection.js';
@@ -12,8 +12,8 @@ export { buildMcpAppsContext } from './apps-context.js';
 export type { McpAppsContext } from './apps-context.js';
 export { buildStateSetHandler, createStateSetHandler, } from './state-set.js';
 export type { StateSetHandlerBuildInput } from './state-set.js';
-export { SQLITE_BROWSE_ACTION_IDS, SQLITE_BROWSE_DB_IDS, SQLITE_BROWSE_HANDLER, SQLITE_BROWSE_PAGE_SIZE, SQLITE_BROWSE_PLUGIN_ID, SQLITE_BROWSE_RELATIVE_PATH, SQLITE_BROWSE_ROWID_KEY, SqliteBrowseError, buildSqliteBrowseHandler, isSqliteBrowseOrigin, planSqliteBrowse, projectSqliteBrowse, } from './sqlite-browse.js';
-export type { SqliteBrowseActionId, SqliteBrowseCell, SqliteBrowseDbId, SqliteBrowseErrorCode, SqliteBrowseExecutePort, SqliteBrowseExecuteResult, SqliteBrowseHandlerBuildInput, SqliteBrowseOrigin, SqliteBrowseParameter, SqliteBrowsePlan, SqliteBrowsePlanInput, SqliteBrowseRawRow, SqliteBrowseState, } from './sqlite-browse.js';
+export { SKILL_BACKEND_DEFAULT_TIMEOUT_MS, SKILL_BACKEND_MAX_INPUT_BYTES, SKILL_BACKEND_MAX_OUTPUT_BYTES, SKILL_BACKEND_SCHEMA_VERSION, buildSkillBackendHandler, } from './skill-backend.js';
+export type { SkillBackendExecutionPort, SkillBackendExecutionRequest, SkillBackendExecutionResponse, SkillBackendHandlerBuildInput, SkillBackendInfrastructureErrorCode, SkillBackendPayload, } from './skill-backend.js';
 export { MCP_APP_HOST_TOOL_ALLOWLIST, MCP_APP_LOCAL_RESOURCE_MIME_TYPE, MCP_APP_RESOURCE_MIME_TYPE, MCP_APP_RESOURCE_URI_PREFIX, } from './types.js';
 export type { McpAppActionDispatcherToolInput, McpAppActionToolDescriptor, McpAppActionToolInput, McpAppButtonDescriptor, McpAppButtonInput, McpAppDescriptor, McpAppDescriptorInput, McpAppInputSchema, McpAppTone, McpUiResourceCsp, McpAppRegistry, McpAppResource, McpAppServerStateInput, McpAppStateDescriptor, McpAppStateProjections, McpAppHostToolInput, McpAppHostToolName, McpAppReadToolInput, McpAppSingleActionToolInput, McpAppToolCommonInput, McpAppToolDescriptor, McpAppToolInput, McpAppToolMetadata, McpAppToolRegistration, McpAppToolResult, McpAppToolVisibility, McpAppInstanceResourceBinding, McpAppMcpResourceBinding, McpAppResourceBinding, McpAppLocalResource, McpAppLocalRegistrationInput, McpAppLocalReadToolDescriptor, McpAppLocalActionToolDescriptor, McpAppLocalToolDescriptor, McpAppLocalRegistration, McpAppBuiltinRegistration, McpAppResolvedRegistration, McpAppLocalLauncher, McpAppBuiltinLauncher, McpAppLauncher, WorkspaceAppLauncher, WorkspaceAppResolvedRegistration, McpAppWorkspaceRegistry, WorkspaceAppRegistry, McpAppWorkspaceRegistryInput, } from './types.js';
 export { buildWorkspaceAppSnapshot, discoverWorkspaceAppSnapshot, reconfirmWorkspaceAppSnapshot, } from './workspace-snapshot.js';

package/dist/mcp-app/skill-backend.d.ts

@@ -0,0 +1,48 @@
+import type { JsonObject, UiExternalActionHandlerRegistration } from '../ui-instance/types.js';
+import type { UiPluginNormalizedManifestV2 } from '../ui-plugin/types.js';
+import type { WorkspaceAppSource } from './discovery.js';
+export declare const SKILL_BACKEND_SCHEMA_VERSION: 1;
+export declare const SKILL_BACKEND_MAX_INPUT_BYTES: number;
+export declare const SKILL_BACKEND_MAX_OUTPUT_BYTES: number;
+export declare const SKILL_BACKEND_DEFAULT_TIMEOUT_MS = 15000;
+export type SkillBackendInfrastructureErrorCode = 'EXEC_DENIED' | 'EXEC_TIMEOUT' | 'EXEC_OUTPUT_INVALID' | 'EXECUTION_FAILED' | 'ACTION_IN_FLIGHT' | 'INPUT_INVALID';
+export interface SkillBackendPayload {
+    readonly schemaVersion: typeof SKILL_BACKEND_SCHEMA_VERSION;
+    readonly actionId: string;
+    readonly input: JsonObject;
+    readonly state: JsonObject;
+}
+export type SkillBackendExecutionResponse = {
+    readonly state?: JsonObject;
+    readonly result?: JsonObject;
+} | {
+    readonly outcome: 'rejected' | 'failed';
+    readonly errorCode: string;
+    readonly state?: JsonObject;
+    readonly result?: JsonObject;
+};
+export interface SkillBackendExecutionRequest {
+    readonly instanceId: string;
+    readonly appId: string;
+    readonly definitionId: string;
+    readonly definitionVersion: number;
+    readonly definitionHash: string;
+    readonly actionId: string;
+    readonly source: WorkspaceAppSource;
+    readonly relativePath: string;
+    readonly command: readonly string[];
+    readonly payload: SkillBackendPayload;
+}
+export interface SkillBackendExecutionPort {
+    execute(request: SkillBackendExecutionRequest): PromiseLike<SkillBackendExecutionResponse>;
+}
+export interface SkillBackendHandlerBuildInput {
+    readonly normalized: UiPluginNormalizedManifestV2;
+    readonly actionId: string;
+    readonly source: WorkspaceAppSource;
+    readonly relativePath: string;
+    readonly execute: SkillBackendExecutionPort;
+    readonly definitionHash?: string;
+}
+export declare function buildSkillBackendHandler(normalized: UiPluginNormalizedManifestV2, actionId: string, source: WorkspaceAppSource, relativePath: string, execute: SkillBackendExecutionPort): UiExternalActionHandlerRegistration | undefined;
+export declare function buildSkillBackendHandler(input: SkillBackendHandlerBuildInput): UiExternalActionHandlerRegistration | undefined;

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

@@ -4,7 +4,7 @@ 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"];
+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 interface McpUiResourceCsp {
     readonly connectDomains?: readonly string[];

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

@@ -1,10 +1,11 @@
-import { type AppDiscoveryFileSystem, type WorkspaceAppDiagnostic, type WorkspaceAppDiscoveryOptions, type WorkspaceAppDiscoveryResult } from './discovery.js';
-import { type SqliteBrowseExecutePort } from './sqlite-browse.js';
+import { type AppDiscoveryFileSystem, type WorkspaceAppDiscoveryIncompleteReason, type WorkspaceAppDiagnostic, type WorkspaceAppDiscoveryOptions, type WorkspaceAppDiscoveryResult, type WorkspaceAppSource } from './discovery.js';
+import { type SkillBackendExecutionPort } from './skill-backend.js';
 import type { JsonObject, UiActionHandlerRegistration, UiDefinition, UiDefinitionRef } from '../ui-instance/types.js';
 import type { McpAppLauncher, McpAppLocalResource, McpAppRegistry, McpAppWorkspaceRegistry } from './types.js';
 export interface WorkspaceAppSnapshotResource extends McpAppLocalResource {
     readonly appId: string;
     readonly definition: UiDefinitionRef;
+    readonly source: WorkspaceAppSource;
 }
 export interface WorkspaceAppSnapshotInitialState {
     readonly appId: string;
@@ -18,7 +19,7 @@ export interface WorkspaceAppSnapshotBuildOptions {
     readonly builtins?: McpAppRegistry;
     readonly builtin?: McpAppRegistry;
     readonly registry?: McpAppRegistry;
-    readonly sqliteBrowse?: SqliteBrowseExecutePort;
+    readonly skillBackend?: SkillBackendExecutionPort;
 }
 export type WorkspaceAppSnapshotOptions = WorkspaceAppDiscoveryOptions & WorkspaceAppSnapshotBuildOptions;
 export interface WorkspaceAppSnapshot {
@@ -43,6 +44,11 @@ export type WorkspaceAppSnapshotReconfirmResult = {
     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;