@crewx/sdk 0.9.0-rc.140 → 0.9.0-rc.142

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

@@ -4,8 +4,8 @@ export { UiRuntimeError } from './errors.js';
 export type { UiRuntimeErrorCode } from './errors.js';
 export { projectSafeJsonObject, redactJsonPaths } from './json.js';
 export { hashUiDefinition } from './definition.js';
-export { hasUiDefinitionLineageBreak, selectUiDefinitionLineageEntry, UiDefinitionLineageError, validateUiDefinitionLineage, } from './lineage.js';
+export { hasUiDefinitionLineageBreak, selectUiDefinitionLineageEntry, UiDefinitionLineageError, uiDefinitionStaticCompatibilityViolations, validateUiDefinitionLineage, } from './lineage.js';
 export type { UiDefinitionLineageEntry, UiDefinitionLineageFailureCode, ValidatedUiDefinitionLineage, } from './lineage.js';
-export { UiInstanceStore, openUiInstanceReadStore } from './store.js';
-export type { UiAuditSnapshotInput, UiInstanceReadStore, UiInstanceRepinInput, UiInstanceRepinLedgerEntry, UiInstanceRepinResult, UiInstanceRepinWorkspaceInput, ReservationInput, } from './store.js';
+export { UiInstanceStore, WORKSPACE_REPIN_ENV, isWorkspaceRepinEnabled, openUiInstanceReadStore } from './store.js';
+export type { UiAuditSnapshotInput, UiInstanceReadStore, UiInstanceRepinInput, UiInstanceRepinLedgerEntry, UiInstanceRepinResult, UiInstanceRepinWorkspaceGenerationInput, UiInstanceRepinWorkspaceInput, ReservationInput, } from './store.js';
 export { createUiRuntimeForTest, createUiServerRuntime } from './runtime.js';

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

@@ -17,6 +17,8 @@ export declare class UiDefinitionLineageError extends Error {
     readonly name = "UiDefinitionLineageError";
     constructor(code: UiDefinitionLineageFailureCode, message?: string, violations?: readonly string[]);
 }
+export declare function parseUiDefinitionInput(value: unknown): UiDefinitionInput;
+export declare function uiDefinitionStaticCompatibilityViolations(previous: UiDefinitionInput, current: UiDefinitionInput): string[];
 export declare function validateUiDefinitionLineage(entriesValue: unknown, currentValue: unknown): ValidatedUiDefinitionLineage;
 export declare function selectUiDefinitionLineageEntry(entries: unknown, current: unknown, selected: UiDefinitionRef): UiDefinition;
 export declare function hasUiDefinitionLineageBreak(lineage: ValidatedUiDefinitionLineage, from: UiDefinitionRef, to?: UiDefinitionRef): boolean;

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

@@ -6,6 +6,7 @@ interface UiInstanceStoreTestHooks {
     bumpRevisionBeforeCas?: boolean;
     beforeOpenRead?: () => void;
     bumpRevisionBeforeRepinCas?: boolean;
+    afterRepinGenerationRead?: () => void;
 }
 export interface ReservationInput {
     instanceId: string;
@@ -31,6 +32,15 @@ export interface UiInstanceRepinInput {
     readonly now: number;
 }
 export type UiInstanceRepinWorkspaceInput = Omit<UiInstanceRepinInput, 'instanceId' | 'observedRevision'>;
+export interface UiInstanceRepinWorkspaceGenerationInput {
+    readonly workspaceId: string;
+    readonly appId: string;
+    readonly currentDefinition: UiDefinition;
+    readonly hasSkillActions: boolean;
+    readonly now: number;
+}
+export declare const WORKSPACE_REPIN_ENV = "CREWX_APP_WORKSPACE_REPIN";
+export declare function isWorkspaceRepinEnabled(env?: Readonly<Record<string, string | undefined>>): boolean;
 export interface UiInstanceRepinLedgerEntry {
     readonly instanceId: string;
     readonly fromVersion: number;
@@ -113,6 +123,10 @@ export declare class UiInstanceStore {
     close(): void;
     repinInstance(input: UiInstanceRepinInput): UiInstanceRepinResult | null;
     repinWorkspaceApp(input: UiInstanceRepinWorkspaceInput): UiInstanceRepinResult[];
+    archiveDefinition(definition: UiDefinition, now: number): void;
+    getArchivedDefinition(definitionHash: string): UiDefinition | null;
+    repinWorkspaceGeneration(input: UiInstanceRepinWorkspaceGenerationInput): UiInstanceRepinResult[];
+    private repinGenerationRow;
     getRepinLedgerEntry(instanceId: string, workspaceId: string, appId: string, toHash: string): UiInstanceRepinLedgerEntry | null;
     listRepinLedgerEntries(workspaceId: string, appId: string, toHash: string): UiInstanceRepinLedgerEntry[];
     private writeRepinLedger;

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

@@ -1,9 +1,12 @@
 import type { JsonValue } from '../ui-instance/types.js';
+import { APP_TOOLS_FILE } from '../app/tool-mode.js';
 import type { UiPluginManifestMode, UiPluginManifestV2, UiPluginValidationErrorCode } from './types.js';
 export declare const APP_MANIFEST_FILE = "manifest.json";
 export declare const LEGACY_APP_MANIFEST_FILE = "ui-plugin.json";
 export declare const APP_MANIFEST_FILES: readonly ["manifest.json", "ui-plugin.json"];
 export type AppManifestFileName = (typeof APP_MANIFEST_FILES)[number];
+export { APP_TOOLS_FILE };
+export type AppToolsFileName = typeof APP_TOOLS_FILE;
 export declare const MCPB_MANIFEST_VERSION = "0.3";
 export declare const CREWX_META_NAMESPACE = "dev.crewx";
 export declare const MCPB_MANIFEST_KEYS: readonly ["manifest_version", "name", "display_name", "version", "description", "long_description", "author", "repository", "homepage", "documentation", "support", "icon", "icons", "screenshots", "localization", "server", "tools", "tools_generated", "prompts", "prompts_generated", "keywords", "license", "privacy_policies", "compatibility", "user_config", "_meta"];
@@ -16,7 +19,7 @@ export interface AppManifestReason {
     readonly path: string;
     readonly rule: string;
     readonly message?: string;
-    readonly file?: AppManifestFileName;
+    readonly file?: AppManifestFileName | AppToolsFileName;
 }
 export type AppManifestRejectionCode = UiPluginValidationErrorCode | 'MANIFEST_DUAL_MISMATCH';
 export interface AppManifestRejection {
@@ -53,7 +56,9 @@ export interface AppManifestOptions {
     readonly mode?: UiPluginManifestMode;
     readonly maxBytes?: number;
 }
-export type AppManifestFileBytes = Partial<Record<AppManifestFileName, Uint8Array>>;
+export type AppManifestFileBytes = Partial<Record<AppManifestFileName, Uint8Array>> & {
+    [APP_TOOLS_FILE]?: Uint8Array;
+};
 export declare function claimsCrewxNamespace(bytes: Uint8Array): boolean;
 export declare function appManifestDefinitionHash(manifest: UiPluginManifestV2): string;
 export declare function resolveAppManifest(files: AppManifestFileBytes, options?: AppManifestOptions): AppManifestResult;

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

@@ -1,6 +1,6 @@
 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, claimsCrewxNamespace, isAppSemver, resolveAppManifest, } from './app-manifest.js';
-export type { AppManifestFailure, AppManifestFileBytes, AppManifestFileName, AppManifestFileResult, AppManifestIdentity, AppManifestOptions, AppManifestReason, AppManifestRejection, AppManifestRejectionCode, AppManifestResult, AppManifestSource, } from './app-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 { 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,5 @@
 import type { JsonObject, JsonValue, UiActionConfirmation, 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';
 export type UiPluginPrimitive = 'card-shell' | 'meta-banner' | 'heading' | 'labeled-text' | 'step-flow' | 'text-list';
@@ -98,11 +99,19 @@ export interface UiPluginCoreBackend {
     readonly type: 'core';
     readonly handler: string;
 }
-export interface UiPluginSkillBackend {
+export interface UiPluginSkillCommandBackend {
     readonly type: 'skill';
     readonly command: readonly string[];
+    readonly entry?: never;
     readonly env?: readonly UiSkillBackendEnvironmentKey[];
 }
+export interface UiPluginSkillEntryBackend {
+    readonly type: 'skill';
+    readonly entry: typeof APP_TOOL_ENTRY;
+    readonly command?: never;
+    readonly env?: never;
+}
+export type UiPluginSkillBackend = UiPluginSkillCommandBackend | UiPluginSkillEntryBackend;
 export type UiPluginBackend = UiPluginCoreBackend | UiPluginSkillBackend;
 export interface UiPluginAction {
     readonly actionId: string;

package/package.json

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