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

package/dist/mcp-app/agent-access.d.ts

@@ -1,4 +1,6 @@
 import type { UiActionConfirmation } from '../ui-instance/types.js';
+import type { UiDefinition } from '../ui-instance/types.js';
+import type { ProductAppBundleProvenance } from './discovery.js';
 export type McpAppAgentAccess = 'allowed' | 'approval_required' | 'denied';
 export interface McpAppAgentAccessAction {
     readonly actionId: string;
@@ -11,4 +13,13 @@ export interface McpAppAgentAccessAction {
         readonly command?: readonly string[];
     };
 }
-export declare function resolveAgentAccess(action: McpAppAgentAccessAction, modelActions?: readonly string[]): McpAppAgentAccess;
+export interface McpAppVerifiedBundleAccessContext {
+    readonly appId: string;
+    readonly definition: UiDefinition;
+    readonly provenance: ProductAppBundleProvenance;
+}
+export declare function resolveAgentAccess(action: McpAppAgentAccessAction, modelActions?: readonly string[], bundle?: McpAppVerifiedBundleAccessContext): McpAppAgentAccess;
+export declare function listMcpAppAgentActions(actions: readonly McpAppAgentAccessAction[], modelActions?: readonly string[], bundle?: McpAppVerifiedBundleAccessContext): readonly {
+    readonly actionId: string;
+    readonly access: McpAppAgentAccess;
+}[];

package/dist/mcp-app/bundle-provenance.d.ts

@@ -0,0 +1,2 @@
+export declare function markVerifiedProductAppBundleProvenance<T extends object>(value: T): T;
+export declare function isVerifiedProductAppBundleProvenance(value: unknown): value is object;

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

@@ -13,6 +13,11 @@ export interface ProductAppBundleProvenance {
     readonly kind: 'bundled';
     readonly indexHash: string;
     readonly packageDir: string;
+    readonly appId: string;
+    readonly definitionId: string;
+    readonly version: number;
+    readonly definitionHash: string;
+    readonly files: readonly ProductAppBundleFileHash[];
 }
 export interface ProductAppBundleFileHash {
     readonly path: string;

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

@@ -2,25 +2,25 @@ export type { McpAppContractErrorCode } from './errors.js';
 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, } from './registry.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 { 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';
+export { MCP_APP_PROJECTION_MAX_BYTES, buildMcpAppStateDescriptor, buildMcpAppStateProjections, buildTerminalMcpAppStateDescriptor, buildTerminalMcpAppStateProjections, createMcpAppToolResult, projectMcpAppSummaryState, serializeMcpAppStateJson, serializeMcpAppStateXml, } from './projection.js';
 export { buildMcpAppsContext } from './apps-context.js';
 export type { McpAppsContext } from './apps-context.js';
 export { MCP_APP_MODEL_CONTEXT_MAX_ARRAY_LENGTH, MCP_APP_MODEL_CONTEXT_MAX_BYTES, MCP_APP_MODEL_CONTEXT_MAX_DEPTH, MCP_APP_MODEL_CONTEXT_MAX_STRING_LENGTH, sanitizeMcpAppModelContext, serializeMcpAppModelContextXml, } from './model-context.js';
 export type { McpAppModelContext, McpAppModelContextInput } from './model-context.js';
-export { resolveAgentAccess } from './agent-access.js';
-export type { McpAppAgentAccess, McpAppAgentAccessAction } from './agent-access.js';
+export { resolveAgentAccess, listMcpAppAgentActions } from './agent-access.js';
+export type { McpAppAgentAccess, McpAppAgentAccessAction, McpAppVerifiedBundleAccessContext } from './agent-access.js';
 export { buildStateSetHandler, createStateSetHandler, } from './state-set.js';
 export type { StateSetHandlerBuildInput } from './state-set.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 { SKILL_BACKEND_DEFAULT_TIMEOUT_MS, SKILL_BACKEND_INHERITED_ENV_ALLOWLIST, SKILL_BACKEND_MAX_INPUT_BYTES, SKILL_BACKEND_MAX_OUTPUT_BYTES, SKILL_BACKEND_SCHEMA_VERSION, buildSkillBackendChildEnvironment, buildSkillBackendHandler, buildVerifiedBundleSkillBackendHandler, } from './skill-backend.js';
+export type { SkillBackendChildEnvironment, SkillBackendExecutionPort, SkillBackendExecutionRequest, SkillBackendExecutionResponse, SkillBackendHandlerBuildInput, SkillBackendInfrastructureErrorCode, SkillBackendPayload, VerifiedBundleSkillBackendBuildInput, VerifiedBundleSkillRunnerPort, VerifiedBundleSkillSpawnRequest, } from './skill-backend.js';
 export { externalResourceCheckItems, inspectSkillBackendOutput, scanExternalResources, } from './dev-checks.js';
 export type { AppDevCheckItem, ExternalResourceFinding, ExternalResourceKind, InspectSkillBackendOutputOptions, ScanExternalResourcesOptions, } from './dev-checks.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, McpAppLocalSingleActionToolDescriptor, McpAppLocalToolDiagnostic, McpAppLocalToolDescriptor, McpAppLocalRegistration, McpAppBuiltinRegistration, McpAppResolvedRegistration, McpAppLocalLauncher, McpAppBuiltinLauncher, McpAppLauncher, WorkspaceAppLauncher, WorkspaceAppResolvedRegistration, McpAppWorkspaceRegistry, WorkspaceAppRegistry, McpAppWorkspaceRegistryInput, } from './types.js';
+export { MCP_APP_HOST_TOOL_ALLOWLIST, MCP_CORE_TOOL_NAMES, 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, McpCoreToolName, McpAppReadToolInput, McpAppSingleActionToolInput, McpAppToolCommonInput, McpAppToolDescriptor, McpAppFixedResult, McpAppFixedResultCall, McpAppFixedResultInvalidParams, McpAppFixedResultResolution, McpAppFixedResultUnavailable, McpAppToolInput, McpAppToolMetadata, McpAppToolRegistration, McpAppToolResult, McpAppToolVisibility, McpAppInstanceResourceBinding, McpAppMcpResourceBinding, McpAppResourceBinding, McpAppLocalResource, McpAppLocalRegistrationInput, McpAppLocalReadToolDescriptor, McpAppLocalActionToolDescriptor, McpAppLocalSingleActionToolDescriptor, McpAppLocalToolDiagnostic, McpAppLocalToolDescriptor, McpAppLocalRegistration, McpAppBuiltinRegistration, McpAppResolvedRegistration, McpAppLocalLauncher, McpAppBuiltinLauncher, McpAppLauncher, WorkspaceAppLauncher, WorkspaceAppResolvedRegistration, McpAppWorkspaceRegistry, WorkspaceAppRegistry, McpAppWorkspaceRegistryInput, McpAppRegistryOptions, McpAppBundleHostToolTemplate, McpAppBundleAgentActionDescriptor, } from './types.js';
 export { buildWorkspaceAppSnapshot, discoverWorkspaceAppSnapshot, reconfirmWorkspaceAppSnapshot, } from './workspace-snapshot.js';
 export type { WorkspaceAppSnapshot, WorkspaceAppSnapshotBuildOptions, WorkspaceAppSnapshotOptions, WorkspaceAppSnapshotReconfirmResult, WorkspaceAppSnapshotResource, WorkspaceAppSnapshotInitialState, WorkspaceAppInitialState, } from './workspace-snapshot.js';

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

@@ -1,7 +1,8 @@
-import type { JsonObject } from '../ui-instance/types.js';
+import type { JsonObject, UiDefinition } from '../ui-instance/types.js';
 import type { McpAppServerStateInput, McpAppStateDescriptor, McpAppStateProjections, McpAppToolDescriptor, McpAppToolResult } from './types.js';
 export declare const MCP_APP_PROJECTION_MAX_BYTES: number;
 export declare const SENSITIVE_KEY: RegExp;
+export declare function projectMcpAppSummaryState(state: unknown, definition: UiDefinition): JsonObject;
 export declare function buildMcpAppStateDescriptor(input: McpAppServerStateInput): McpAppStateDescriptor;
 export declare function buildTerminalMcpAppStateDescriptor(input: McpAppServerStateInput): McpAppStateDescriptor;
 export declare function serializeMcpAppStateJson(descriptor: McpAppStateDescriptor, dataPaths?: readonly string[]): string;

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

@@ -1,6 +1,15 @@
-import { type McpAppDescriptor, type McpAppDescriptorInput, type McpAppInputSchema, type McpAppLocalRegistration, type McpAppLocalRegistrationInput, type McpAppLocalResource, type McpAppRegistry, type McpAppResource, type McpAppWorkspaceRegistry, type McpAppWorkspaceRegistryInput, type McpAppToolDescriptor, type McpAppToolRegistration } from './types.js';
+import type { WorkspaceAppCandidate } from './discovery.js';
+import type { ProductAppBundlePackageIndex } from './discovery.js';
+import { type McpAppDescriptor, type McpAppDescriptorInput, type McpAppInputSchema, type McpAppLocalRegistration, type McpAppLocalRegistrationInput, type McpAppLocalResource, type McpAppRegistry, type McpAppResource, type McpAppWorkspaceRegistry, type McpAppWorkspaceRegistryInput, type McpAppToolDescriptor, type McpAppToolRegistration, type McpAppRegistryOptions, type McpAppBundleHostToolTemplate, type McpAppFixedResultResolution, type McpAppBundleAgentActionDescriptor } from './types.js';
 export declare const MAX_HTML_LENGTH: number;
-export declare function createMcpAppRegistry(): McpAppRegistry;
+export declare function resolveMcpAppFixedResultCall(tool: McpAppToolDescriptor, args: unknown): McpAppFixedResultResolution;
+export declare function buildMcpAppBundleRegistrationInput(candidate: WorkspaceAppCandidate, options?: {
+    readonly hostTools?: readonly McpAppBundleHostToolTemplate[];
+}): McpAppDescriptorInput;
+export declare function buildMcpAppBundleAgentActionDescriptors(candidate: WorkspaceAppCandidate): readonly McpAppBundleAgentActionDescriptor[];
+export declare function planProductBundleLegacyToolNames(apps: readonly ProductAppBundlePackageIndex[]): Readonly<Record<string, string>>;
+export declare function makeUiUri(appId: string, entry: string | Uint8Array | readonly number[]): string;
+export declare function createMcpAppRegistry(options?: McpAppRegistryOptions): McpAppRegistry;
 export declare function createBuiltinMcpAppRegistry(): McpAppRegistry;
 export declare function registerMcpApp(registry: McpAppRegistry, input: McpAppDescriptorInput): McpAppDescriptor;
 export declare function resolveMcpAppResource(registry: McpAppRegistry, uri: string): McpAppResource | null;

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

@@ -1,10 +1,11 @@
 import type { JsonObject, UiExternalActionHandlerRegistration } from '../ui-instance/types.js';
 import type { UiPluginNormalizedManifestV2 } from '../ui-plugin/types.js';
-import type { WorkspaceAppSource } from './discovery.js';
+import type { WorkspaceAppCandidate, 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_MAX_INPUT_BYTES = 524288;
+export declare const SKILL_BACKEND_MAX_OUTPUT_BYTES = 524288;
 export declare const SKILL_BACKEND_DEFAULT_TIMEOUT_MS = 15000;
+export declare const SKILL_BACKEND_INHERITED_ENV_ALLOWLIST: readonly ["CREWX_HOME", "CREWX_DB", "XDG_CONFIG_HOME"];
 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;
@@ -23,6 +24,8 @@ export type SkillBackendExecutionResponse = {
 };
 export interface SkillBackendExecutionRequest {
     readonly requestId?: string;
+    readonly reservationNowMs?: number;
+    readonly actorKind?: 'user' | 'agent';
     readonly instanceId: string;
     readonly appId: string;
     readonly definitionId: string;
@@ -37,6 +40,38 @@ export interface SkillBackendExecutionRequest {
 export interface SkillBackendExecutionPort {
     execute(request: SkillBackendExecutionRequest): PromiseLike<SkillBackendExecutionResponse>;
 }
+export interface SkillBackendChildEnvironment {
+    readonly CREWX_APP_REQUEST_ID: string;
+    readonly CREWX_APP_NOW_MS: string;
+    readonly CREWX_APP_ACTOR_KIND: 'user' | 'agent';
+}
+export declare function buildSkillBackendChildEnvironment(request: Pick<SkillBackendExecutionRequest, 'requestId' | 'reservationNowMs' | 'actorKind'>): SkillBackendChildEnvironment;
+export interface VerifiedBundleSkillSpawnRequest {
+    readonly appId: string;
+    readonly packageDir: string;
+    readonly packageCwd: string;
+    readonly executableRelativePath: string;
+    readonly command: readonly string[];
+    readonly payload: SkillBackendPayload;
+    readonly childEnvironment: SkillBackendChildEnvironment;
+    readonly inheritedEnvAllowlist: typeof SKILL_BACKEND_INHERITED_ENV_ALLOWLIST;
+    readonly requestId: string;
+}
+export interface VerifiedBundleSkillRunnerPort {
+    hashExecutable(input: {
+        readonly packageCwd: string;
+        readonly executableRelativePath: string;
+    }): PromiseLike<string>;
+    spawn(input: VerifiedBundleSkillSpawnRequest): PromiseLike<SkillBackendExecutionResponse>;
+}
+export interface VerifiedBundleSkillBackendBuildInput {
+    readonly normalized: UiPluginNormalizedManifestV2;
+    readonly actionId: string;
+    readonly candidate: WorkspaceAppCandidate;
+    readonly packageCwd: string;
+    readonly executableRelativePath: string;
+    readonly runner: VerifiedBundleSkillRunnerPort;
+}
 export interface SkillBackendHandlerBuildInput {
     readonly normalized: UiPluginNormalizedManifestV2;
     readonly actionId: string;
@@ -47,3 +82,4 @@ export interface SkillBackendHandlerBuildInput {
 }
 export declare function buildSkillBackendHandler(normalized: UiPluginNormalizedManifestV2, actionId: string, source: WorkspaceAppSource, relativePath: string, execute: SkillBackendExecutionPort): UiExternalActionHandlerRegistration | undefined;
 export declare function buildSkillBackendHandler(input: SkillBackendHandlerBuildInput): UiExternalActionHandlerRegistration | undefined;
+export declare function buildVerifiedBundleSkillBackendHandler(input: VerifiedBundleSkillBackendBuildInput): UiExternalActionHandlerRegistration | undefined;

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

@@ -1,4 +1,4 @@
-import type { JsonObject, UiDefinition, UiDefinitionRef, UiDefinitionDisplayMode, UiDefinitionUsage, UiInstance, UiInstanceStatus, UiActionConfirmation, UiActionHandlerRegistration } from '../ui-instance/types.js';
+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';
 export declare const MCP_APP_RESOURCE_MIME_TYPE: "text/html;profile=mcp-app";
 export declare const MCP_APP_RESOURCE_URI_PREFIX = "ui://crewx/";
@@ -6,6 +6,8 @@ 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[];
@@ -23,6 +25,11 @@ export interface McpAppToolCommonInput {
 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';
@@ -41,6 +48,8 @@ export type McpAppActionToolDescriptor = (Omit<McpAppSingleActionToolInput, 'act
     readonly actionIds: readonly string[];
 });
 type McpAppToolDescriptorMetadata = {
+    readonly appId?: string;
+    readonly provenance?: ProductAppBundleProvenance;
     readonly resourceUri: string;
     readonly _meta: McpAppToolMetadata;
 };
@@ -62,6 +71,8 @@ export interface McpAppDescriptorInput {
     readonly csp?: McpUiResourceCsp;
     readonly tools: readonly McpAppToolInput[];
     readonly definition?: UiDefinition;
+    readonly provenance?: ProductAppBundleProvenance;
+    readonly entryBytes?: Uint8Array | readonly number[];
 }
 export interface McpAppResource {
     readonly uri: string;
@@ -256,8 +267,22 @@ export interface McpAppDescriptor {
     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';
@@ -329,6 +354,29 @@ export interface McpAppRegistry {
     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';
@@ -341,6 +389,7 @@ export interface CrewxAppDefinitionSummary extends UiDefinitionRef {
     readonly usage: UiDefinitionUsage;
     readonly detailPanel?: boolean;
     readonly displayModes?: readonly UiDefinitionDisplayMode[];
+    readonly summaryProjection?: UiProjectionPolicy;
 }
 export interface CrewxAppDefinitionHashInput {
     readonly screenHash?: string;