@crewx/sdk 0.9.0-rc.160 → 0.9.0-rc.161

package/dist/mcp-app/app-icon-read.d.ts

@@ -0,0 +1,7 @@
+import type { AppIconContentType, AppIconFile } from '../ui-plugin/app-icon.js';
+export interface WorkspaceAppIconBytes {
+    readonly bytes: Uint8Array;
+    readonly contentType: AppIconContentType;
+    readonly sha256: string;
+}
+export declare function readWorkspaceAppIconFile(workspaceRoot: string, appRelativePath: string, iconFile: AppIconFile): Promise<WorkspaceAppIconBytes | undefined>;

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

@@ -0,0 +1,85 @@
+import { type SkillBackendExecutionRequest, type SkillBackendPayloadV1 } from './skill-backend.js';
+import { type AppScheduleIntervalMinutes, type AppSchedulePeriodicReason, type AppScheduleRunVerdict, type AppScheduleSnapshot } from '../app/schedule-contract.js';
+import type { UiDefinitionInput } from '../ui-instance/types.js';
+import type { WorkspaceAppSource } from './discovery.js';
+export { decideScheduleDirective } from '../app/schedule-contract.js';
+export type { AppScheduleActorKind, ScheduleDirectiveDecision } from '../app/schedule-contract.js';
+export type AppScheduleOwnerSource = WorkspaceAppSource | 'bundled';
+export interface AppScheduleOwner {
+    readonly appId: string;
+    readonly actionId: string;
+    readonly source: AppScheduleOwnerSource;
+}
+export interface AppScheduleBinding extends AppScheduleOwner {
+    readonly enabled: boolean;
+}
+export interface ResolvedAppSchedule {
+    readonly actionId: string;
+    readonly everyMinutes: AppScheduleIntervalMinutes;
+    readonly timeoutMs: number;
+}
+export interface AppScheduleTemplate {
+    readonly cron: string;
+    readonly timeout_ms: number;
+    readonly name: string | null;
+}
+export interface AppScheduleRowView extends AppScheduleTemplate {
+    readonly id: string;
+    readonly app: AppScheduleBinding;
+    readonly last_started_at?: string;
+    readonly last_run?: string;
+    readonly last_outcome?: string;
+    readonly last_error_code?: string;
+    readonly next_run?: string | null;
+}
+export type AppScheduleAvailability = {
+    readonly periodic: 'available';
+} | {
+    readonly periodic: 'unavailable';
+    readonly reason: AppSchedulePeriodicReason;
+};
+export type ScheduleLifecycleEntry = {
+    readonly kind: 'absent';
+} | {
+    readonly kind: 'invalid';
+} | {
+    readonly kind: 'verified';
+    readonly source: AppScheduleOwnerSource;
+    readonly declaration: ResolvedAppSchedule | undefined;
+    readonly name: string | null;
+};
+export type AppScheduledRunPayload = SkillBackendPayloadV1 & {
+    readonly schedule: AppScheduleSnapshot;
+};
+export interface AppScheduledRunPlan {
+    readonly actorKind: 'schedule';
+    readonly instanceId: string;
+    readonly threadId: null;
+    readonly actionId: string;
+    readonly payload: AppScheduledRunPayload;
+}
+export type ScheduledAppLaunchRequest = AppScheduledRunPlan & Pick<SkillBackendExecutionRequest, 'appId' | 'definitionId' | 'definitionVersion' | 'definitionHash' | 'command' | 'entry' | 'relativePath'>;
+export type ScheduleLifecyclePlan = {
+    readonly kind: 'run';
+    readonly run: AppScheduledRunPlan;
+} | {
+    readonly kind: 'refresh';
+    readonly owner: AppScheduleOwner;
+    readonly template: AppScheduleTemplate;
+} | {
+    readonly kind: 'skip';
+    readonly code: 'APP_INVALID' | 'APP_SCHEDULE_OFF';
+} | {
+    readonly kind: 'disable';
+    readonly code: 'APP_SCHEDULE_UNDECLARED' | 'APP_SCHEDULE_SOURCE_CHANGED';
+} | {
+    readonly kind: 'remove';
+    readonly code: 'APP_MISSING';
+};
+export declare function cronExpressionForInterval(everyMinutes: AppScheduleIntervalMinutes): string;
+export declare function appScheduleCommandLabel(owner: Pick<AppScheduleOwner, 'appId' | 'actionId'>): string;
+export declare function resolveDeclaredSchedule(definition: Pick<UiDefinitionInput, 'actions'>): ResolvedAppSchedule | undefined;
+export declare function scheduleTemplateFor(declaration: ResolvedAppSchedule, name: string | null): AppScheduleTemplate;
+export declare function toScheduleSnapshot(row: Pick<AppScheduleRowView, 'app' | 'last_started_at' | 'last_run' | 'last_outcome' | 'last_error_code' | 'next_run'> | undefined, declared: Pick<ResolvedAppSchedule, 'everyMinutes'>, availability: AppScheduleAvailability): AppScheduleSnapshot;
+export declare function toScheduledRunVerdict(response: unknown): AppScheduleRunVerdict;
+export declare function planScheduledFire(row: AppScheduleRowView, entry: ScheduleLifecycleEntry, availability: AppScheduleAvailability): ScheduleLifecyclePlan;

package/dist/mcp-app/dev-checks.d.ts

@@ -1,3 +1,4 @@
+import type { AppIconDiagnostic } from '../ui-plugin/app-icon.js';
 export type AppDevCheckItem = {
     readonly rule: 'manifest' | 'external_resource' | 'output_unsafe_string' | 'output_invalid' | 'output_size' | 'call_duration';
     readonly severity: 'error' | 'warning' | 'ok';
@@ -27,3 +28,4 @@ export interface ScanExternalResourcesOptions {
 export declare function inspectSkillBackendOutput(stdoutText: string, options: InspectSkillBackendOutputOptions): AppDevCheckItem[];
 export declare function scanExternalResources(html: string, options: ScanExternalResourcesOptions): ExternalResourceFinding[];
 export declare function externalResourceCheckItems(entryRelativePath: string, findings: readonly ExternalResourceFinding[]): AppDevCheckItem[];
+export declare function appIconCheckItems(diagnostics: readonly AppIconDiagnostic[]): AppDevCheckItem[];

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

@@ -1,6 +1,7 @@
 import type { UiDefinitionLineageEntry } from '../ui-instance/lineage.js';
 import type { JsonObject, JsonValue, UiDefinition } from '../ui-instance/types.js';
 import type { AppManifestFileName, AppManifestReason } from '../ui-plugin/index.js';
+import type { AppIconDiagnostic, AppIconFile } from '../ui-plugin/app-icon.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';
@@ -118,6 +119,8 @@ interface WorkspaceAppCandidateBase {
     readonly description: string;
     readonly icon?: string;
     readonly tone?: UiPluginManifestV2['tone'];
+    readonly iconFile?: AppIconFile;
+    readonly iconDiagnostics?: readonly AppIconDiagnostic[];
     readonly definition: UiDefinition;
     readonly handlers: Readonly<Record<string, UiPluginHandlerMetadata>>;
     readonly resources: WorkspaceAppResourceSnapshot;

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

@@ -29,9 +29,13 @@ export { buildStateSetHandler, createStateSetHandler, } from './state-set.js';
 export type { StateSetHandlerBuildInput } from './state-set.js';
 export { SKILL_BACKEND_DEFAULT_TIMEOUT_MS, SKILL_BACKEND_INHERITED_ENV_ALLOWLIST, SKILL_BACKEND_CONTENT_SCHEMA_VERSION, 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, SkillBackendPayloadV1, SkillBackendPayloadV2, SkillBackendContentInputHeader, SkillBackendContentOutputHeader, } from './skill-backend.js';
-export { externalResourceCheckItems, inspectSkillBackendOutput, scanExternalResources, } from './dev-checks.js';
+export { externalResourceCheckItems, appIconCheckItems, inspectSkillBackendOutput, scanExternalResources, } from './dev-checks.js';
+export { readWorkspaceAppIconFile } from './app-icon-read.js';
+export type { WorkspaceAppIconBytes } from './app-icon-read.js';
 export type { AppDevCheckItem, ExternalResourceFinding, ExternalResourceKind, InspectSkillBackendOutputOptions, ScanExternalResourcesOptions, } from './dev-checks.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, McpAppLayoutSnapshot, McpAppPromptResult, McpAppPromptStatus, McpAppWindowState, McpAppStateView, McpAppHostToolName, McpCoreToolName, McpAppReadToolInput, McpAppSingleActionToolInput, McpAppToolCommonInput, McpAppToolDescriptor, McpAppFixedResult, McpAppFixedResultCall, McpAppFixedResultInvalidParams, McpAppFixedResultResolution, McpAppFixedResultUnavailable, McpAppToolInput, McpAppToolMetadata, McpAppToolRegistration, McpAppToolResult, McpAppToolVisibility, McpAppInstanceResourceBinding, McpAppMcpResourceBinding, McpAppResourceBinding, McpAppLocalResource, McpAppLocalRegistrationInput, McpAppLocalReadToolDescriptor, McpAppLocalActionToolDescriptor, McpAppLocalSingleActionToolDescriptor, McpAppLocalHostToolDescriptor, 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';
+export { appScheduleCommandLabel, cronExpressionForInterval, decideScheduleDirective, planScheduledFire, resolveDeclaredSchedule, scheduleTemplateFor, toScheduledRunVerdict, toScheduleSnapshot, } from './app-schedule.js';
+export type { AppScheduleActorKind, AppScheduleAvailability, AppScheduleBinding, AppScheduleOwner, AppScheduleOwnerSource, AppScheduleRowView, AppScheduleTemplate, AppScheduledRunPayload, AppScheduledRunPlan, ResolvedAppSchedule, ScheduleDirectiveDecision, ScheduleLifecycleEntry, ScheduleLifecyclePlan, ScheduledAppLaunchRequest, } from './app-schedule.js';

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

@@ -1,4 +1,5 @@
 import { SKILL_BACKEND_CONTENT_SCHEMA_VERSION, SKILL_BACKEND_MAX_INPUT_BYTES, SKILL_BACKEND_MAX_OUTPUT_BYTES } from '../app/protocol.js';
+import { type AppScheduleDirective, type AppScheduleSnapshot } from '../app/schedule-contract.js';
 import type { ContentFrame, UiContentMediaType, UiContentRangeRequest } from './content-channel.js';
 import type { JsonObject, UiExternalActionHandlerRegistration, UiSkillBackendEnvironmentKey } from '../ui-instance/types.js';
 import type { UiPluginNormalizedManifestV2 } from '../ui-plugin/types.js';
@@ -13,6 +14,7 @@ export interface SkillBackendPayloadV1 {
     readonly actionId: string;
     readonly input: JsonObject;
     readonly state: JsonObject;
+    readonly schedule?: AppScheduleSnapshot;
 }
 export interface SkillBackendContentInputHeader {
     readonly mediaType: UiContentMediaType;
@@ -39,6 +41,7 @@ export type SkillBackendExecutionResponse = {
     readonly state?: JsonObject;
     readonly result?: JsonObject;
     readonly content?: ContentFrame;
+    readonly schedule?: AppScheduleDirective;
 } | {
     readonly outcome: 'rejected' | 'failed';
     readonly errorCode: string;
@@ -49,7 +52,7 @@ export type SkillBackendExecutionResponse = {
 interface SkillBackendExecutionRequestBase {
     readonly requestId?: string;
     readonly reservationNowMs?: number;
-    readonly actorKind?: 'user' | 'agent';
+    readonly actorKind?: 'user' | 'agent' | 'schedule';
     readonly instanceId: string;
     readonly appId: string;
     readonly definitionId: string;
@@ -82,7 +85,7 @@ export interface SkillBackendExecutionPort {
 export interface SkillBackendChildEnvironment {
     readonly CREWX_APP_REQUEST_ID: string;
     readonly CREWX_APP_NOW_MS: string;
-    readonly CREWX_APP_ACTOR_KIND: 'user' | 'agent';
+    readonly CREWX_APP_ACTOR_KIND: 'user' | 'agent' | 'schedule';
 }
 export declare function buildSkillBackendChildEnvironment(request: Pick<SkillBackendExecutionRequest, 'requestId' | 'reservationNowMs' | 'actorKind'>): SkillBackendChildEnvironment;
 export interface VerifiedBundleSkillSpawnRequest {

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

@@ -1,6 +1,7 @@
 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 { AppIconDiagnostic, AppIconFile } from '../ui-plugin/app-icon.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';
@@ -8,6 +9,8 @@ export interface WorkspaceAppSnapshotResource extends McpAppLocalResource {
     readonly appId: string;
     readonly definition: UiDefinitionRef;
     readonly relativePath?: string;
+    readonly iconFile?: AppIconFile;
+    readonly iconDiagnostics?: readonly AppIconDiagnostic[];
     readonly runtime?: NonNullable<UiPluginManifestV2['runtime']>;
     readonly csp?: NonNullable<UiPluginManifestV2['csp']>;
     readonly source?: WorkspaceAppSource;

package/dist/publish/errors.d.ts

@@ -1,4 +1,4 @@
-export type PublishErrorCode = 'APP_ID_REQUIRED' | 'APP_DEFINITION_HASH_REQUIRED' | 'APP_NOT_FOUND' | 'APP_AMBIGUOUS' | 'APP_NAME_CONFLICT' | 'APP_DEFINITION_CONFLICT' | 'APP_PACKAGE_ROOT_INVALID' | 'APP_UI_MANIFEST_INVALID' | 'APP_SKILL_MISSING' | 'APP_INITIAL_STATE_OUT_OF_SCOPE' | 'PACKAGE_PATH_TRAVERSAL' | 'PACKAGE_SYMLINK' | 'PACKAGE_FILE_INVALID' | 'PACKAGE_SIZE_LIMIT' | 'PACKAGE_GENERATED_FILE_MISSING' | 'PACKAGE_STAGED_BYTES_MISMATCH' | 'PUBLISH_SECRET_FINDINGS' | 'PUBLISH_CONTENT_ID_MISSING' | 'PUBLISH_CONTENT_SUSPENDED' | 'CONTENT_REJECTED' | 'APP_VERSION_MUST_INCREASE' | 'APP_VERSION_INVALID';
+export type PublishErrorCode = 'APP_ID_REQUIRED' | 'APP_DEFINITION_HASH_REQUIRED' | 'APP_NOT_FOUND' | 'APP_AMBIGUOUS' | 'APP_NAME_CONFLICT' | 'APP_DEFINITION_CONFLICT' | 'APP_PACKAGE_ROOT_INVALID' | 'APP_UI_MANIFEST_INVALID' | 'ICON_INVALID' | 'APP_SKILL_MISSING' | 'APP_INITIAL_STATE_OUT_OF_SCOPE' | 'PACKAGE_PATH_TRAVERSAL' | 'PACKAGE_SYMLINK' | 'PACKAGE_FILE_INVALID' | 'PACKAGE_SIZE_LIMIT' | 'PACKAGE_GENERATED_FILE_MISSING' | 'PACKAGE_STAGED_BYTES_MISMATCH' | 'PUBLISH_SECRET_FINDINGS' | 'PUBLISH_CONTENT_ID_MISSING' | 'PUBLISH_CONTENT_SUSPENDED' | 'CONTENT_REJECTED' | 'APP_VERSION_MUST_INCREASE' | 'APP_VERSION_INVALID';
 export declare class PublishError extends Error {
     readonly code: PublishErrorCode;
     readonly name = "PublishError";

package/dist/publish/index.d.ts

@@ -14,11 +14,16 @@ export interface PublishOptions {
     maxFiles?: number;
     maxBytes?: number;
 }
+export interface PublishWarning {
+    readonly code: 'ICON_NOT_FILE' | 'ICON_NOT_SQUARE';
+    readonly path: string;
+}
 export interface PublishPlan {
     manifest: PublishManifest;
     included: string[];
     excluded: ExcludedEntry[];
     secretFindings: SecretFinding[];
+    warnings?: PublishWarning[];
 }
 export declare function planPublish(dir: string, opts?: PublishOptions): Promise<PublishPlan>;
 export declare function packPublish(dir: string, opts?: PublishOptions): Promise<{