@crewx/sdk 0.9.0-rc.136 → 0.9.0-rc.138

package/dist/mcp-app/apps-context.d.ts

@@ -2,5 +2,19 @@ import type { McpAppStateDescriptor } from './types.js';
 import type { McpAppModelContext } from './model-context.js';
 export interface McpAppsContext {
     readonly rendered: string;
+    readonly guidanceRendered?: string;
+    readonly available?: ReadonlyArray<{
+        readonly id: string;
+        readonly name: string;
+        readonly description: string;
+        readonly agent: 'direct' | 'approval' | 'none';
+    }>;
+    readonly availableRendered?: string;
 }
-export declare function buildMcpAppsContext(descriptors: readonly McpAppStateDescriptor[] | undefined, modelContext?: McpAppModelContext): McpAppsContext | undefined;
+export interface McpAppsContextOptions {
+    readonly cli?: string;
+    readonly available?: McpAppsContext['available'];
+}
+export declare const MCP_APPS_AVAILABLE_MAX_BYTES: number;
+export declare function buildMcpAppsContext(descriptors: readonly McpAppStateDescriptor[] | undefined, modelContext?: McpAppModelContext, optionsOrAvailable?: McpAppsContextOptions | McpAppsContext['available']): McpAppsContext | undefined;
+export declare function attachAvailableApps(context: McpAppsContext | undefined, available: McpAppsContext['available'], cli?: string): McpAppsContext | undefined;

package/dist/mcp-app/diagnostic-reason.d.ts

@@ -0,0 +1,3 @@
+import type { AppManifestFileName, AppManifestReason } from '../ui-plugin/app-manifest.js';
+export declare function projectAppManifestReason(value: unknown): AppManifestReason | undefined;
+export declare function projectAppManifestFiles(value: unknown): readonly AppManifestFileName[] | undefined;

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

@@ -1,5 +1,6 @@
 import type { UiDefinitionLineageEntry } from '../ui-instance/lineage.js';
-import type { JsonObject, UiDefinition } from '../ui-instance/types.js';
+import type { JsonObject, JsonValue, UiDefinition } from '../ui-instance/types.js';
+import type { AppManifestFileName, AppManifestReason } from '../ui-plugin/index.js';
 import type { UiPluginHandlerMetadata, UiPluginManifestV2, UiPluginNormalizedManifestV2 } from '../ui-plugin/types.js';
 import { createWorkspaceAppScanCache, type WorkspaceAppScanCache, type WorkspaceAppScanRootIdentity } from './workspace-app-scan-cache.js';
 import { AppDiscoveryFsError, NodeAppDiscoveryFs, NodeAppDiscoveryFsAdapter, defaultAppDiscoveryFs, defaultNodeAppDiscoveryFs, type AppDiscoveryFsErrorCode } from './node-app-discovery-fs.js';
@@ -18,12 +19,14 @@ export interface ProductAppBundleProvenance extends LoadedProductAppBundleProven
     readonly files: readonly ProductAppBundleFileHash[];
 }
 export type WorkspaceAppDiscoveryIncompleteReason = 'time_limit';
-export type WorkspaceAppDiagnosticCode = 'MANIFEST_MISSING' | 'MANIFEST_INVALID' | 'ENTRY_INVALID' | 'INITIAL_STATE_INVALID' | 'DUPLICATE_ID' | 'RESERVED_ID' | 'BUNDLE_INTEGRITY' | 'LINEAGE_INVALID' | 'LINEAGE_STALE' | 'PATH_ESCAPED' | 'LIMIT_EXCEEDED' | 'DISCOVERY_TIME_LIMIT' | 'ASSET_CATALOG_INVALID' | 'EXEC_DENIED';
+export type WorkspaceAppDiagnosticCode = 'MANIFEST_MISSING' | 'MANIFEST_INVALID' | 'MANIFEST_DUAL_MISMATCH' | 'ENTRY_INVALID' | 'INITIAL_STATE_INVALID' | 'DUPLICATE_ID' | 'RESERVED_ID' | 'BUNDLE_INTEGRITY' | 'LINEAGE_INVALID' | 'LINEAGE_STALE' | 'PATH_ESCAPED' | 'LIMIT_EXCEEDED' | 'DISCOVERY_TIME_LIMIT' | 'ASSET_CATALOG_INVALID' | 'EXEC_DENIED';
 export interface WorkspaceAppDiagnostic {
     readonly code: WorkspaceAppDiagnosticCode;
     readonly pluginId?: string;
     readonly source: WorkspaceAppDiscoverySource;
     readonly relativePath: string;
+    readonly reason?: AppManifestReason;
+    readonly files?: readonly AppManifestFileName[];
 }
 export interface ProductAppBundleSnapshotMetadata {
     readonly indexHash?: string;
@@ -104,6 +107,9 @@ interface WorkspaceAppCandidateBase {
     readonly pluginId: string;
     readonly definitionId: string;
     readonly version: number;
+    readonly releaseVersion?: string;
+    readonly manifestFile?: AppManifestFileName;
+    readonly mcpb?: Readonly<Record<string, JsonValue>>;
     readonly relativePath: string;
     readonly manifest: UiPluginManifestV2;
     readonly normalized: UiPluginNormalizedManifestV2;

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

@@ -11,8 +11,8 @@ export type { AppDiscoveryBytes, AppDiscoveryDiagnostic, AppDiscoveryDirectoryEn
 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, createMcpAppToolResult, projectMcpAppSummaryState, serializeMcpAppStateJson, serializeMcpAppStateXml, } from './projection.js';
-export { buildMcpAppsContext } from './apps-context.js';
-export type { McpAppsContext } from './apps-context.js';
+export { attachAvailableApps, buildMcpAppsContext } from './apps-context.js';
+export type { McpAppsContext, McpAppsContextOptions } from './apps-context.js';
 export { UI_CONTENT_ERROR_CODES, UI_CONTENT_MAX_BYTES, UI_CONTENT_MAX_LINES, UI_CONTENT_MAX_MEMORY_BYTES, UI_CONTENT_MEDIA_TYPES, UI_CONTENT_OUTPUT_TTL_MS, UI_CONTENT_TICKET_TTL_MS, UiContentChannelError, contentBindingMatches, countContentLines, decodeContentUtf8, isUiContentDeclaration, isUiContentMediaType, isUiContentRangeRequest, isValidUiAppInstanceId, isValidUiThreadIdentity, sha256Content, validateContentBytes, validateContentFrame, } from './content-channel.js';
 export type { ContentFrame, UiActionContentDeclaration, UiContentBinding, UiContentChannelPort, UiContentErrorCode, UiContentInputDeclaration, UiContentInputTicket, UiContentMediaType, UiContentOutputDeclaration, UiContentRange, UiContentRangeRequest, ValidateContentFrameOptions, } from './content-channel.js';
 export { buildMcpAppContentActions, contentActionsMatch, isMcpAppContentActions, } from './content-declarations.js';

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

@@ -1,6 +1,8 @@
 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';
+import type { AppManifestFileName, AppManifestReason } from '../ui-plugin/app-manifest.js';
+import type { McpAppAgentAccess } from './agent-access.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';
@@ -308,13 +310,20 @@ export interface McpAppButtonInput {
     readonly enabled: boolean;
     readonly confirmation?: UiActionConfirmation;
     readonly requiresHumanConfirmation?: boolean;
+    readonly agentAccess?: McpAppAgentAccess;
     readonly disabledReason?: string;
     readonly inputSchema: McpAppInputSchema;
 }
+export interface McpAppDescriptorAppInfo {
+    readonly id: string;
+    readonly name: string;
+    readonly description: string;
+}
 export interface McpAppServerStateInput {
     readonly source: 'server';
     readonly instance: Pick<UiInstance, 'id' | 'definition' | 'revision' | 'status' | 'state'>;
     readonly definition: UiDefinition;
+    readonly app?: McpAppDescriptorAppInfo;
     readonly buttons: readonly McpAppButtonInput[];
 }
 export interface McpAppButtonDescriptor {
@@ -323,6 +332,7 @@ export interface McpAppButtonDescriptor {
     readonly enabled: boolean;
     readonly confirmation: UiActionConfirmation;
     readonly requiresHumanConfirmation?: boolean;
+    readonly agentAccess?: McpAppAgentAccess;
     readonly disabledReason: string | null;
     readonly inputSchema: McpAppInputSchema;
 }
@@ -331,6 +341,7 @@ export interface McpAppStateDescriptor {
     readonly source: 'server';
     readonly instanceId: string;
     readonly definition: UiDefinitionRef;
+    readonly app?: McpAppDescriptorAppInfo;
     readonly revision: number;
     readonly status: UiInstanceStatus;
     readonly state: JsonObject;
@@ -425,14 +436,17 @@ export interface CrewxAppSummary {
     readonly slug?: string;
     readonly definitionHash: string;
     readonly provenance?: ProductAppBundleProvenance;
+    readonly connectDomains?: readonly string[];
 }
-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' | 'DISCOVERY_TIME_LIMIT' | 'ASSET_CATALOG_INVALID' | 'EXEC_DENIED' | 'SKILL_INVALID' | 'SKILL_READ_FAILED' | 'INSTALLED_MISSING' | 'INSTALLED_CONTENT_ID_MISSING' | 'INSTALLED_IDENTITY_MISMATCH' | 'BUILTIN_INVALID';
+export type CrewxAppDiagnosticCode = 'MANIFEST_MISSING' | 'MANIFEST_INVALID' | 'MANIFEST_DUAL_MISMATCH' | 'ENTRY_INVALID' | 'INITIAL_STATE_INVALID' | 'DUPLICATE_ID' | 'RESERVED_ID' | 'BUNDLE_INTEGRITY' | 'LINEAGE_INVALID' | 'LINEAGE_STALE' | 'PATH_ESCAPED' | 'LIMIT_EXCEEDED' | 'DISCOVERY_TIME_LIMIT' | '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;
+    readonly reason?: AppManifestReason;
+    readonly files?: readonly AppManifestFileName[];
 }
 export interface CrewxAppInstalledProjection {
     readonly packageRoot?: string;

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

@@ -9,6 +9,7 @@ export interface WorkspaceAppSnapshotResource extends McpAppLocalResource {
     readonly definition: UiDefinitionRef;
     readonly relativePath?: string;
     readonly runtime?: NonNullable<UiPluginManifestV2['runtime']>;
+    readonly csp?: NonNullable<UiPluginManifestV2['csp']>;
     readonly source?: WorkspaceAppSource;
     readonly provenance?: ProductAppBundleProvenance;
     readonly assetCatalogId?: string;