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

package/dist/ui-instance/types.d.ts

@@ -1,3 +1,4 @@
+import type { AppScheduleDirective, AppScheduleIntervalMinutes, AppScheduleSnapshot } from '../app/schedule-contract.js';
 import type { ContentFrame, UiActionContentDeclaration, UiContentChannelPort, UiContentRangeRequest } from '../mcp-app/content-channel.js';
 export type JsonPrimitive = string | number | boolean | null;
 export type JsonValue = JsonPrimitive | JsonObject | JsonValue[];
@@ -23,6 +24,11 @@ export interface UiDefinitionAction {
     readonly resultProjection?: UiProjectionPolicy;
     readonly content?: UiActionContentDeclaration;
     readonly env?: readonly UiSkillBackendEnvironmentKey[];
+    readonly schedule?: UiDefinitionActionSchedule;
+}
+export interface UiDefinitionActionSchedule {
+    readonly everyMinutes: AppScheduleIntervalMinutes;
+    readonly timeoutMs: number;
 }
 export interface UiProjectionPolicy {
     allow: readonly string[];
@@ -234,11 +240,13 @@ export interface UiActionHandlerContext {
             readonly range?: UiContentRangeRequest;
         };
     };
+    schedule?: AppScheduleSnapshot;
 }
 export type UiActionHandlerResult = {
     state?: JsonObject;
     result?: JsonObject;
     content?: ContentFrame;
+    schedule?: AppScheduleDirective;
 } | {
     outcome: 'rejected' | 'failed';
     errorCode: string;

package/dist/ui-plugin/app-icon.d.ts

@@ -0,0 +1,50 @@
+export declare const APP_ICON_MAX_BYTES = 262144;
+export type AppIconContentType = 'image/svg+xml' | 'image/png' | 'image/jpeg';
+export type AppIconReason = 'missing' | 'bad-path' | 'bad-type' | 'bytes-mismatch' | 'too-large' | 'unsafe-svg';
+export interface AppIconDiagnostic {
+    readonly code: 'ICON_INVALID' | 'ICON_NOT_FILE' | 'ICON_NOT_SQUARE';
+    readonly severity: 'error' | 'warning';
+    readonly reason?: AppIconReason;
+    readonly declared?: string;
+}
+export interface AppIconFileBytes {
+    readonly path: string;
+    readonly contentType: AppIconContentType;
+    readonly byteLength: number;
+    readonly bytes: Uint8Array;
+}
+export interface AppIconFile {
+    readonly path: string;
+    readonly sha256: string;
+    readonly contentType: AppIconContentType;
+    readonly byteLength: number;
+}
+export type AppIconDeclaration = {
+    readonly kind: 'none';
+} | {
+    readonly kind: 'file';
+    readonly path: string;
+    readonly contentType: AppIconContentType;
+} | {
+    readonly kind: 'url';
+    readonly declared: string;
+} | {
+    readonly kind: 'invalid';
+    readonly reason: 'bad-path' | 'bad-type';
+    readonly declared?: string;
+};
+export type AppIconReadFailure = 'missing' | 'bad-path' | 'too-large';
+export interface ResolvedAppIcon {
+    readonly file?: AppIconFileBytes;
+    readonly diagnostics: readonly AppIconDiagnostic[];
+}
+export declare function classifyAppIconDeclaration(value: unknown): AppIconDeclaration;
+export declare function resolveAppIcon(value: unknown, read: (path: string) => Promise<Uint8Array | AppIconReadFailure>): Promise<ResolvedAppIcon>;
+export type AppIconInspection = {
+    readonly ok: true;
+    readonly square: boolean | undefined;
+} | {
+    readonly ok: false;
+    readonly reason: AppIconReason;
+};
+export declare function inspectAppIconBytes(contentType: AppIconContentType, bytes: Uint8Array): AppIconInspection;

package/dist/ui-plugin/index.d.ts

@@ -1,6 +1,8 @@
 export { canonicalManifestJson, manifestHash } from './manifest.js';
 export { APP_MANIFEST_FILE, APP_MANIFEST_FILES, APP_MANIFEST_PASSTHROUGH_KEYS, APP_MANIFEST_REQUIRED_KEYS, CREWX_META_NAMESPACE, CREWX_META_OPTIONAL_KEYS, CREWX_META_REQUIRED_KEYS, LEGACY_APP_MANIFEST_FILE, MCPB_MANIFEST_KEYS, MCPB_MANIFEST_VERSION, appManifestDefinitionHash, APP_TOOLS_FILE, claimsCrewxNamespace, isAppSemver, resolveAppManifest, } from './app-manifest.js';
 export type { AppManifestFailure, AppManifestFileBytes, AppManifestFileName, AppManifestFileResult, AppManifestIdentity, AppManifestOptions, AppManifestReason, AppManifestRejection, AppManifestRejectionCode, AppManifestResult, AppManifestSource, AppToolsFileName, } from './app-manifest.js';
+export { APP_ICON_MAX_BYTES, classifyAppIconDeclaration, inspectAppIconBytes, resolveAppIcon, } from './app-icon.js';
+export type { AppIconContentType, AppIconDeclaration, AppIconDiagnostic, AppIconFile, AppIconFileBytes, AppIconInspection, AppIconReadFailure, AppIconReason, ResolvedAppIcon, } from './app-icon.js';
 export { UiPluginValidationError, normalizeManifest, validateInitialState, validateManifest, validatePayload, } from './validator.js';
 export { UI_PLUGIN_CAPABILITY_PATTERN, UI_PLUGIN_HANDLER_PATTERN, UI_PLUGIN_IDENTIFIER_PATTERN, UI_PLUGIN_MAX_ACTIONS, UI_PLUGIN_MAX_ARRAY_LENGTH, UI_PLUGIN_MAX_CANDIDATE_DEPTH, UI_PLUGIN_MAX_COMMAND_LENGTH, UI_PLUGIN_MAX_COMMAND_PARTS, UI_PLUGIN_MAX_DISCOVERED_APPS, UI_PLUGIN_MAX_DISCOVERY_TIME_MS, UI_PLUGIN_MAX_HEIGHT, UI_PLUGIN_MAX_INITIAL_STATE_BYTES, UI_PLUGIN_MAX_JSON_DEPTH, UI_PLUGIN_MAX_MANIFEST_BYTES, UI_PLUGIN_MAX_PROJECTION_PATHS, UI_PLUGIN_MAX_SCHEMA_DEPTH, UI_PLUGIN_MAX_SCHEMA_PROPERTIES, UI_PLUGIN_MAX_STRING_LENGTH, UI_PLUGIN_MAX_SUBTREE_BYTES, UI_PLUGIN_MAX_SURFACES, UI_PLUGIN_RESERVED_STATE_KEYS, UI_PLUGIN_SAFE_PATH_PATTERN, UI_PLUGIN_SAFE_PATH_SEGMENT_PATTERN, UI_PLUGIN_SKILL_TOKEN_PATTERN, UI_PLUGIN_SURFACES, UI_PLUGIN_TONES, isUiPluginReservedStateKey, } from './limits.js';
 export type { UiPluginActivation, UiPluginAction, UiPluginBackend, UiPluginCardShellNode, UiPluginCoreBackend, UiPluginFieldSchema, UiPluginHeadingNode, UiPluginInputSchema, UiPluginJsonSchema, UiPluginJsonSchemaType, UiPluginLabeledTextNode, UiPluginLayoutNode, UiPluginLayout, UiPluginManifest, UiPluginManifestMode, UiPluginManifestV1, UiPluginManifestV2, UiPluginCspRequest, UiPluginRuntimeRequest, UiPluginMetaBannerNode, UiPluginNormalizedManifestV2, UiPluginNormalizedV2, UiPluginPayload, UiPluginPayloadValue, UiPluginPrimitive, UiPluginProjectionPolicy, UiPluginResourceMetadata, UiPluginResourceRef, UiPluginSchemaType, UiPluginSchema, UiPluginSize, UiPluginSkillBackend, UiPluginStep, UiPluginStepFlowNode, UiPluginStepListSchema, UiPluginTextListNode, UiPluginTextListSchema, UiPluginTextSchema, UiPluginSurface, UiPluginTone, UiPluginHandlerMetadata, UiPluginValidationErrorCode, UiPluginValidationOptions, } from './types.js';

package/dist/ui-plugin/types.d.ts

@@ -1,4 +1,4 @@
-import type { JsonObject, JsonValue, UiActionConfirmation, UiDefinitionInput } from '../ui-instance/types.js';
+import type { JsonObject, JsonValue, UiActionConfirmation, UiDefinitionActionSchedule, UiDefinitionInput } from '../ui-instance/types.js';
 import type { APP_TOOL_ENTRY } from '../app/tool-mode.js';
 import type { UiSkillBackendEnvironmentKey } from '../ui-instance/types.js';
 import type { UiActionContentDeclaration } from '../mcp-app/content-channel.js';
@@ -123,6 +123,7 @@ export interface UiPluginAction {
     readonly content?: UiActionContentDeclaration;
     readonly dataInputs?: readonly string[];
     readonly confirmation?: UiActionConfirmation;
+    readonly schedule?: UiDefinitionActionSchedule;
     readonly _meta?: JsonObject;
 }
 export interface UiPluginResourceRef {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@crewx/sdk",
-  "version": "0.9.0-rc.160",
+  "version": "0.9.0-rc.161",
   "license": "UNLICENSED",
   "engines": {
     "node": ">=20.19.0"