@crewx/sdk 0.9.0-rc.15 → 0.9.0-rc.150

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

@@ -0,0 +1,64 @@
+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"];
+export declare const APP_MANIFEST_REQUIRED_KEYS: readonly ["manifest_version", "name", "display_name", "version", "description", "_meta"];
+export declare const APP_MANIFEST_PASSTHROUGH_KEYS: readonly ("name" | "description" | "server" | "tools" | "version" | "_meta" | "icon" | "manifest_version" | "display_name" | "long_description" | "author" | "repository" | "homepage" | "documentation" | "support" | "icons" | "screenshots" | "localization" | "tools_generated" | "prompts" | "prompts_generated" | "keywords" | "license" | "privacy_policies" | "compatibility" | "user_config")[];
+export declare const CREWX_META_REQUIRED_KEYS: readonly ["entry", "surfaces", "size", "stateProjection", "actions"];
+export declare const CREWX_META_OPTIONAL_KEYS: readonly ["definitionId", "definitionVersion", "icon", "tone", "entryHash", "runtime", "initialState", "usage", "detailPanel", "displayModes", "summaryProjection", "dataPaths", "focusedAiDataPaths", "csp"];
+export declare function isAppSemver(value: unknown): value is string;
+export interface AppManifestReason {
+    readonly path: string;
+    readonly rule: string;
+    readonly message?: string;
+    readonly file?: AppManifestFileName | AppToolsFileName;
+}
+export type AppManifestRejectionCode = UiPluginValidationErrorCode | 'MANIFEST_DUAL_MISMATCH';
+export interface AppManifestRejection {
+    readonly code: AppManifestRejectionCode;
+    readonly reason: AppManifestReason;
+    readonly files: readonly AppManifestFileName[];
+}
+export interface AppManifestIdentity {
+    readonly pluginId: string;
+    readonly definitionId?: string;
+    readonly definitionVersion?: number;
+}
+export interface AppManifestFileResult {
+    readonly file: AppManifestFileName;
+    readonly manifest: UiPluginManifestV2;
+    readonly v2Input: Readonly<Record<string, unknown>>;
+    readonly releaseVersion?: string;
+    readonly mcpb?: Readonly<Record<string, JsonValue>>;
+}
+export interface AppManifestSource extends AppManifestFileResult {
+    readonly ok: true;
+    readonly identity: AppManifestIdentity;
+    readonly files: readonly AppManifestFileName[];
+}
+export interface AppManifestFailure {
+    readonly ok: false;
+    readonly rejection: AppManifestRejection;
+    readonly parseFailure: boolean;
+    readonly identity?: AppManifestIdentity;
+    readonly builtinOnly: boolean;
+}
+export type AppManifestResult = AppManifestSource | AppManifestFailure;
+export interface AppManifestOptions {
+    readonly mode?: UiPluginManifestMode;
+    readonly maxBytes?: number;
+}
+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/csp.d.ts

@@ -0,0 +1,28 @@
+export interface UiPluginCspInput {
+    readonly connectDomains?: readonly string[];
+    readonly frameDomains?: readonly string[];
+    readonly resourceDomains?: readonly string[];
+    readonly baseUriDomains?: readonly string[];
+}
+export type UiPluginCspNormalizationErrorCode = 'CSP_AXIS_UNSUPPORTED' | 'CSP_AXIS_UNKNOWN' | 'CSP_LIMIT_EXCEEDED' | 'CSP_ORIGIN_INVALID' | 'CSP_ORIGIN_FORBIDDEN';
+export interface NormalizedUiPluginCsp {
+    readonly declared: boolean;
+    readonly connectDomains: readonly string[];
+    readonly frameDomains: readonly string[];
+    readonly resourceDomains: readonly [];
+    readonly baseUriDomains: readonly [];
+    readonly cspHash: string;
+}
+export interface UiPluginCspNormalizeOptions {
+    readonly runtimeHostnames?: readonly string[];
+}
+export interface UiPluginPolicyRuntime {
+    readonly wasm?: boolean;
+}
+export interface UiPluginPolicyHashInput {
+    readonly runtime?: UiPluginPolicyRuntime;
+    readonly cspHash: string;
+    readonly policySchema: number;
+}
+export declare function normalizeUiPluginCsp(input: UiPluginCspInput | undefined, options?: UiPluginCspNormalizeOptions): NormalizedUiPluginCsp;
+export declare function policyHash(input: UiPluginPolicyHashInput): string;

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

@@ -0,0 +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, 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/limits.d.ts

@@ -0,0 +1,27 @@
+export declare const UI_PLUGIN_MAX_STRING_LENGTH = 4096;
+export declare const UI_PLUGIN_MAX_ARRAY_LENGTH = 128;
+export declare const UI_PLUGIN_MAX_SUBTREE_BYTES: number;
+export declare const UI_PLUGIN_MAX_INITIAL_STATE_BYTES: number;
+export declare const UI_PLUGIN_MAX_JSON_DEPTH = 8;
+export declare const UI_PLUGIN_MAX_SCHEMA_DEPTH = 8;
+export declare const UI_PLUGIN_MAX_SCHEMA_PROPERTIES = 64;
+export declare const UI_PLUGIN_MAX_ACTIONS = 32;
+export declare const UI_PLUGIN_MAX_SURFACES = 2;
+export declare const UI_PLUGIN_MAX_PROJECTION_PATHS = 128;
+export declare const UI_PLUGIN_MAX_COMMAND_PARTS = 16;
+export declare const UI_PLUGIN_MAX_COMMAND_LENGTH = 256;
+export declare const UI_PLUGIN_MAX_HEIGHT = 720;
+export declare const UI_PLUGIN_MAX_DISCOVERED_APPS = 64;
+export declare const UI_PLUGIN_MAX_MANIFEST_BYTES: number;
+export declare const UI_PLUGIN_MAX_CANDIDATE_DEPTH = 2;
+export declare const UI_PLUGIN_MAX_DISCOVERY_TIME_MS = 5000;
+export declare const UI_PLUGIN_RESERVED_STATE_KEYS: readonly ["__proto__", "prototype", "constructor", "proof", "token", "secret", "password", "cookie", "authorization", "private_key", "private-key", "stack", "exception", "plugin_text", "url", "uri", "endpoint", "path", "filename", "filepath", "cwd", "shell", "directory", "dir", "folder"];
+export declare function isUiPluginReservedStateKey(key: string): boolean;
+export declare const UI_PLUGIN_SAFE_PATH_SEGMENT_PATTERN: RegExp;
+export declare const UI_PLUGIN_SAFE_PATH_PATTERN: RegExp;
+export declare const UI_PLUGIN_IDENTIFIER_PATTERN: RegExp;
+export declare const UI_PLUGIN_CAPABILITY_PATTERN: RegExp;
+export declare const UI_PLUGIN_HANDLER_PATTERN: RegExp;
+export declare const UI_PLUGIN_SKILL_TOKEN_PATTERN: RegExp;
+export declare const UI_PLUGIN_TONES: readonly ["blue", "violet", "emerald", "amber", "rose", "sky", "slate", "indigo"];
+export declare const UI_PLUGIN_SURFACES: readonly ["inline", "panel"];

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

@@ -0,0 +1,3 @@
+import type { UiPluginManifest } from './types.js';
+export declare function canonicalManifestJson(manifest: UiPluginManifest): string;
+export declare function manifestHash(manifest: UiPluginManifest): string;

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

@@ -0,0 +1,203 @@
+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';
+export type UiPluginSchemaType = 'text' | 'text-list' | 'step-list';
+export interface UiPluginTextSchema {
+    readonly type: 'text';
+    readonly maxLength: number;
+}
+export interface UiPluginTextListSchema {
+    readonly type: 'text-list';
+    readonly max: number;
+    readonly itemMaxLength: number;
+}
+export interface UiPluginStepListSchema {
+    readonly type: 'step-list';
+    readonly min: number;
+    readonly max: number;
+    readonly labelMaxLength: number;
+    readonly detailMaxLength: number;
+}
+export type UiPluginFieldSchema = UiPluginTextSchema | UiPluginTextListSchema | UiPluginStepListSchema;
+export type UiPluginSchema = Readonly<Record<string, UiPluginFieldSchema>>;
+export interface UiPluginActivation {
+    readonly kind: 'fenced-code';
+    readonly language: string;
+}
+export interface UiPluginCardShellNode {
+    readonly primitive: 'card-shell';
+}
+export interface UiPluginMetaBannerNode {
+    readonly primitive: 'meta-banner';
+    readonly badgeToken: string;
+    readonly noticeToken: string;
+}
+export interface UiPluginHeadingNode {
+    readonly primitive: 'heading';
+    readonly field: string;
+}
+export interface UiPluginLabeledTextNode {
+    readonly primitive: 'labeled-text';
+    readonly titleToken: string;
+    readonly field: string;
+    readonly variant: 'callout';
+}
+export interface UiPluginStepFlowNode {
+    readonly primitive: 'step-flow';
+    readonly titleToken: string;
+    readonly field: string;
+}
+export interface UiPluginTextListNode {
+    readonly primitive: 'text-list';
+    readonly titleToken: string;
+    readonly field: string;
+    readonly emptyToken?: string;
+    readonly hideWhenEmpty?: boolean;
+}
+export type UiPluginLayoutNode = UiPluginCardShellNode | UiPluginMetaBannerNode | UiPluginHeadingNode | UiPluginLabeledTextNode | UiPluginStepFlowNode | UiPluginTextListNode;
+export type UiPluginLayout = readonly UiPluginLayoutNode[];
+export interface UiPluginManifestV1 {
+    readonly manifestVersion: 1;
+    readonly pluginId: string;
+    readonly definitionId: string;
+    readonly version: number;
+    readonly primitiveSet: number;
+    readonly activation: UiPluginActivation;
+    readonly schema: UiPluginSchema;
+    readonly layout: UiPluginLayout;
+}
+export type UiPluginManifestMode = 'local' | 'installed' | 'published';
+export type UiPluginSurface = 'inline' | 'panel';
+export type UiPluginTone = 'blue' | 'violet' | 'emerald' | 'amber' | 'rose' | 'sky' | 'slate' | 'indigo';
+export type UiPluginJsonSchemaType = 'object' | 'string' | 'number' | 'integer' | 'boolean' | 'array' | 'null';
+export interface UiPluginJsonSchema {
+    readonly type: UiPluginJsonSchemaType;
+    readonly enum?: readonly JsonValue[];
+    readonly minLength?: number;
+    readonly maxLength?: number;
+    readonly minItems?: number;
+    readonly maxItems?: number;
+    readonly minProperties?: number;
+    readonly maxProperties?: number;
+    readonly minimum?: number;
+    readonly maximum?: number;
+    readonly items?: UiPluginJsonSchema;
+    readonly properties?: Readonly<Record<string, UiPluginJsonSchema>>;
+    readonly required?: readonly string[];
+    readonly additionalProperties?: false;
+}
+export interface UiPluginInputSchema extends UiPluginJsonSchema {
+    readonly type: 'object';
+    readonly properties: Readonly<Record<string, UiPluginJsonSchema>>;
+}
+export interface UiPluginProjectionPolicy {
+    readonly allow: readonly string[];
+}
+export interface UiPluginCoreBackend {
+    readonly type: 'core';
+    readonly handler: string;
+}
+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;
+    readonly capability: string;
+    readonly mutation: boolean;
+    readonly inputSchema: UiPluginInputSchema;
+    readonly resultProjection: UiPluginProjectionPolicy;
+    readonly backend: UiPluginBackend;
+    readonly content?: UiActionContentDeclaration;
+    readonly dataInputs?: readonly string[];
+    readonly confirmation?: UiActionConfirmation;
+    readonly _meta?: JsonObject;
+}
+export interface UiPluginResourceRef {
+    readonly path: 'ui/index.html' | 'ui/state.json';
+    readonly hash?: string;
+}
+export interface UiPluginSize {
+    readonly height: number;
+}
+export interface UiPluginRuntimeRequest {
+    readonly wasm?: true;
+    readonly terminal?: true;
+    readonly htmlDocuments?: true;
+}
+export interface UiPluginCspRequest {
+    readonly connectDomains: readonly string[];
+}
+export interface UiPluginManifestV2 {
+    readonly manifestVersion: 2;
+    readonly pluginId: string;
+    readonly definitionId: string;
+    readonly version: number;
+    readonly name: string;
+    readonly description: string;
+    readonly icon?: string;
+    readonly tone?: UiPluginTone;
+    readonly entry: 'ui/index.html';
+    readonly entryHash?: string;
+    readonly runtime?: UiPluginRuntimeRequest;
+    readonly csp?: UiPluginCspRequest;
+    readonly initialState?: {
+        readonly path: 'ui/state.json';
+        readonly hash?: string;
+    };
+    readonly usage?: UiDefinitionInput['usage'];
+    readonly detailPanel?: UiDefinitionInput['detailPanel'];
+    readonly displayModes?: UiDefinitionInput['displayModes'];
+    readonly surfaces: readonly UiPluginSurface[];
+    readonly size: UiPluginSize;
+    readonly stateProjection: UiPluginProjectionPolicy;
+    readonly summaryProjection?: UiPluginProjectionPolicy;
+    readonly dataPaths?: readonly string[];
+    readonly actions: readonly UiPluginAction[];
+    readonly _meta?: JsonObject;
+}
+export type UiPluginManifest = UiPluginManifestV1 | UiPluginManifestV2;
+export interface UiPluginHandlerMetadata {
+    readonly actionId: string;
+    readonly mutation: boolean;
+    readonly backend: UiPluginBackend;
+    readonly launchPolicy: 'allowed' | 'denied';
+    readonly denialCode?: 'EXEC_DENIED';
+}
+export interface UiPluginResourceMetadata {
+    readonly entry: UiPluginResourceRef;
+    readonly initialState?: {
+        readonly path: 'ui/state.json';
+        readonly hash?: string;
+    };
+}
+export interface UiPluginNormalizedManifestV2 {
+    readonly manifest: UiPluginManifestV2;
+    readonly definition: UiDefinitionInput;
+    readonly handlers: Readonly<Record<string, UiPluginHandlerMetadata>>;
+    readonly resources: UiPluginResourceMetadata;
+}
+export type UiPluginNormalizedV2 = UiPluginNormalizedManifestV2;
+export interface UiPluginStep {
+    readonly label: string;
+    readonly detail: string;
+}
+export type UiPluginPayloadValue = string | string[] | UiPluginStep[];
+export type UiPluginPayload = Record<string, UiPluginPayloadValue>;
+export interface UiPluginValidationOptions {
+    readonly supportedPrimitiveSet?: number;
+    readonly mode?: UiPluginManifestMode;
+}
+export type UiPluginValidationErrorCode = 'MANIFEST_INVALID' | 'PRIMITIVE_UNKNOWN' | 'PRIMITIVE_SET_UNSUPPORTED' | 'SCHEMA_TYPE_UNSUPPORTED' | 'TOKEN_INVALID' | 'UNSAFE_VALUE' | 'LIMIT_EXCEEDED' | 'INITIAL_STATE_INVALID';

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

@@ -0,0 +1,18 @@
+import type { UiPluginManifest, UiPluginManifestV1, UiPluginManifestV2, UiPluginNormalizedManifestV2, UiPluginPayload, UiPluginValidationErrorCode, UiPluginValidationOptions } from './types.js';
+import type { JsonObject } from '../ui-instance/types.js';
+export declare class UiPluginValidationError extends Error {
+    readonly code: UiPluginValidationErrorCode;
+    readonly path?: string | undefined;
+    readonly rule?: string | undefined;
+    readonly name = "UiPluginValidationError";
+    constructor(code: UiPluginValidationErrorCode, message?: string, path?: string | undefined, rule?: string | undefined);
+    withPathPrefix(prefix: string): UiPluginValidationError;
+}
+export declare function validateInitialState(value: unknown, dataPaths?: readonly string[]): JsonObject;
+export declare function validateManifest(input: UiPluginManifestV1, options?: UiPluginValidationOptions): UiPluginManifestV1;
+export declare function validateManifest(input: UiPluginManifestV2, options?: UiPluginValidationOptions): UiPluginManifestV2;
+export declare function validateManifest(input: unknown, options?: UiPluginValidationOptions): UiPluginManifest;
+export declare function normalizeManifest(input: UiPluginManifestV1, options?: UiPluginValidationOptions): UiPluginManifestV1;
+export declare function normalizeManifest(input: UiPluginManifestV2, options?: UiPluginValidationOptions): UiPluginNormalizedManifestV2;
+export declare function normalizeManifest(input: unknown, options?: UiPluginValidationOptions): UiPluginManifestV1 | UiPluginNormalizedManifestV2;
+export declare function validatePayload(manifest: UiPluginManifestV1, rawPayload: unknown): UiPluginPayload;

package/dist/utils/crewx-executable.d.ts

@@ -0,0 +1,76 @@
+export type CrewxExecutableStage = 'env' | 'self' | 'workspace' | 'module' | 'path';
+export interface CrewxExecutableAttempt {
+    stage: CrewxExecutableStage;
+    reason: string;
+}
+export interface CrewxExecutableSuccess {
+    ok: true;
+    argv: string[];
+    stage: CrewxExecutableStage;
+    requiredEnv?: CrewxRequiredEnv;
+}
+export type CrewxRequiredEnv = Readonly<Partial<Record<'ELECTRON_RUN_AS_NODE', '1'>>>;
+export interface CrewxElectronRuntimeContext {
+    platform: NodeJS.Platform;
+    stage: CrewxExecutableStage;
+    isSelf: boolean;
+    execPath: string;
+    isFile: (candidate: string) => boolean;
+}
+export type CrewxElectronRuntimePredicate = (executable: string, context: CrewxElectronRuntimeContext) => boolean;
+export interface CrewxExecutableFailure {
+    ok: false;
+    reason: string;
+    attempts: CrewxExecutableAttempt[];
+}
+export type CrewxExecutableResolution = CrewxExecutableSuccess | CrewxExecutableFailure;
+export interface CrewxExecutablePathLookupOptions {
+    env: NodeJS.ProcessEnv;
+    cwd: string;
+    platform: NodeJS.Platform;
+}
+export type CrewxExecutablePathLookupResult = string | readonly string[] | undefined;
+export interface CrewxExecutableResolverOptions {
+    env?: NodeJS.ProcessEnv;
+    cwd?: string;
+    argv?: readonly string[];
+    execPath?: string;
+    platform?: NodeJS.Platform;
+    modulePaths?: readonly string[];
+    requireResolve?: (request: string) => string;
+    findOnPath?: (command: string, options: CrewxExecutablePathLookupOptions) => CrewxExecutablePathLookupResult;
+    isFile?: (candidate: string) => boolean;
+    isElectronRuntime?: CrewxElectronRuntimePredicate;
+}
+export interface CrewxCliShim {
+    directory: string;
+    executable: string;
+    fingerprint: string;
+}
+export interface CrewxCliShimOptions {
+    home?: string;
+    platform?: NodeJS.Platform;
+}
+export interface CrewxStableEntrypointOptions extends CrewxCliShimOptions {
+    cwd?: string;
+    allowEnvStage?: boolean;
+}
+export interface CrewxChildInvocation {
+    command: string;
+    args: string[];
+    env: Record<string, string>;
+}
+export interface CrewxChildInvocationOptions extends CrewxCliShimOptions {
+    baseEnv?: NodeJS.ProcessEnv;
+}
+export declare function isVolatilePath(candidate: string): boolean;
+export declare function isRotatingInstallPath(candidate: string): boolean;
+export declare function resolveCrewxExecutable(options?: CrewxExecutableResolverOptions): CrewxExecutableResolution;
+export declare const resolveCrewxCliArgv: typeof resolveCrewxExecutable;
+export declare function crewxCliShimFingerprint(resolution: CrewxExecutableSuccess): string;
+export declare function materializeCrewxCliShim(resolution: CrewxExecutableSuccess, options?: CrewxCliShimOptions): CrewxCliShim;
+export declare function createCrewxChildInvocation(resolution: CrewxExecutableSuccess, options?: CrewxChildInvocationOptions): CrewxChildInvocation;
+export declare function getCrewxStableEntrypoint(options?: CrewxCliShimOptions): string;
+export declare function materializeCrewxStableEntrypoint(resolution: CrewxExecutableResolution, options?: CrewxStableEntrypointOptions): string | undefined;
+export declare function formatCrewxExecutableArgv(argv: readonly string[], platform?: NodeJS.Platform): string;
+export declare function formatCrewxExecutableFailure(failure: CrewxExecutableFailure): string;

package/dist/utils/crewx-home.d.ts

@@ -0,0 +1 @@
+export declare function getCrewxHome(): string;

package/dist/utils/env-defaults.d.ts

@@ -1,2 +1,5 @@
+import { type CrewxExecutableResolution } from './crewx-executable';
+export declare function resolveCrewxCliDisplay(env?: Readonly<Record<string, string | undefined>>): string;
 export declare function resolveCrewxCli(): string;
+export declare function resolveCrewxCliArgv(): CrewxExecutableResolution;
 export declare function resolveCrewxWorkspace(): string;

package/dist/utils/id.d.ts

@@ -1,4 +1,4 @@
-export type EntityPrefix = 'tsk' | 'thd' | 'msg' | 'box' | 'prj' | 'mem' | 'spn' | 'cron' | 'wbs' | 'job' | 'tcl' | 'req' | 'ws' | 'wfr';
+export type EntityPrefix = 'tsk' | 'thd' | 'msg' | 'box' | 'prj' | 'mem' | 'spn' | 'cron' | 'wbs' | 'job' | 'tcl' | 'req' | 'ws' | 'wfr' | 'ntf' | 'sug' | 'brd' | 'pjc' | 'pje' | 'the' | 'thl' | 'thr';
 export type PrefixedId<P extends EntityPrefix> = `${P}_${string}`;
 export declare function generateId<P extends EntityPrefix>(prefix: P): PrefixedId<P>;
 export declare function generateFingerprint<P extends EntityPrefix>(prefix: P, input: string): PrefixedId<P>;

package/dist/utils/local-identity.d.ts

@@ -0,0 +1,2 @@
+export declare function normalizeLocalActorId(username: string, hostname: string): string | null;
+export declare function getLocalActorId(): string | null;

package/dist/utils/runner-env.d.ts

@@ -0,0 +1,3 @@
+export declare const CREWX_RUNNER_IDENTITY_ENV: readonly ["CREWX_ASSIGNED_TASK_ID", "CREWX_DETACHED_RUNNER"];
+export declare function withoutCrewxRunnerIdentity(env: NodeJS.ProcessEnv): NodeJS.ProcessEnv;
+export declare function withoutCrewxRootContext(env: NodeJS.ProcessEnv): NodeJS.ProcessEnv;

package/dist/utils/timestamp.d.ts

@@ -1 +1,2 @@
 export declare function formatTimestamp(date: Date): string;
+export declare function formatDisplayTimestamp(date: Date): string;

package/dist/utils/workspace.d.ts

@@ -1,4 +1,5 @@
 export declare function normalizeWorkspacePath(workspacePath: string): string;
 export declare function hashWorkspaceId(workspacePath: string): string;
+export declare function resolveWorkspaceOwnerPath(workspacePath: string): string;
 export declare function slugify(input: string): string;
 export declare function isValidSlug(slug: string): boolean;

package/dist/wi/create.d.ts

@@ -0,0 +1,48 @@
+export type WiStatus = 'draft' | 'approved' | 'in-progress' | 'done' | 'cancelled';
+export interface WiCreateInput {
+    title: string;
+    assignee?: string;
+    body?: string;
+    board?: string;
+    source?: string;
+    depends_on?: string[];
+}
+export interface WiBatchCreateInput {
+    board: string;
+    source?: string;
+    items: Array<{
+        key?: string;
+        title: string;
+        assignee?: string;
+        depends_on?: string[];
+        body: string;
+    }>;
+}
+export interface WiCreatedSummary {
+    wi_id: string;
+    title: string;
+    status: WiStatus;
+    priority?: string;
+    assignee?: string;
+    depends_on: string[];
+    blocks: string[];
+    date?: string;
+    board?: string;
+    source: string;
+    screens: string[];
+    path: string;
+    mtime: number;
+}
+export interface WiCreatedDetail {
+    summary: WiCreatedSummary;
+    frontmatter: Record<string, unknown>;
+    body: string;
+}
+export interface WiBatchCreateResult {
+    created: WiCreatedDetail[];
+}
+export declare class WiCreateError extends Error {
+    constructor(message: string);
+}
+export declare function createWorkInstruction(workspacePath: string, input: WiCreateInput): Promise<WiCreatedDetail>;
+export declare function createWorkInstructionBatch(workspacePath: string, input: WiBatchCreateInput): Promise<WiBatchCreateResult>;

package/dist/wi/select.d.ts

@@ -0,0 +1,20 @@
+export type WiSelectableStatus = 'draft' | 'approved' | 'in-progress' | 'done' | 'cancelled';
+export interface WiSummary {
+    wi_id: string;
+    status: WiSelectableStatus;
+    depends_on?: string[];
+}
+export type SelectNextWiResult = {
+    pick: string;
+} | {
+    blocked: true;
+    reason: string;
+} | {
+    cycle: string[];
+} | {
+    done: true;
+};
+export declare function selectNextWi(wis: WiSummary[], opts: {
+    batch: string[];
+    exclude?: string[];
+}): SelectNextWiResult;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@crewx/sdk",
-  "version": "0.9.0-rc.15",
+  "version": "0.9.0-rc.150",
   "license": "UNLICENSED",
   "engines": {
     "node": ">=20.19.0"
@@ -20,6 +20,19 @@
       "types": "./dist/index.browser.d.ts",
       "import": "./dist/index.browser.js"
     },
+    "./node": {
+      "types": "./dist/node/index.d.ts",
+      "node": {
+        "import": "./dist/node/index.js",
+        "require": "./dist/node/index.js"
+      },
+      "browser": null
+    },
+    "./skills": {
+      "types": "./dist/skills/index.d.ts",
+      "import": "./dist/skills/index.js",
+      "require": "./dist/skills/index.js"
+    },
     "./client": {
       "types": "./dist/client/index.d.ts",
       "import": "./dist/client/index.js",
@@ -50,6 +63,31 @@
       "import": "./dist/repository/index.js",
       "require": "./dist/repository/index.js"
     },
+    "./desktop": {
+      "types": "./dist/desktop/index.d.ts",
+      "import": "./dist/desktop/index.js",
+      "require": "./dist/desktop/index.js"
+    },
+    "./process": {
+      "types": "./dist/process/index.d.ts",
+      "import": "./dist/process/index.js",
+      "require": "./dist/process/index.js"
+    },
+    "./publish": {
+      "types": "./dist/publish/index.d.ts",
+      "import": "./dist/publish/index.js",
+      "require": "./dist/publish/index.js"
+    },
+    "./account": {
+      "types": "./dist/account/index.d.ts",
+      "import": "./dist/account/index.js",
+      "require": "./dist/account/index.js"
+    },
+    "./app": {
+      "types": "./dist/app/index.d.ts",
+      "import": "./dist/app/index.js",
+      "require": "./dist/app/index.js"
+    },
     "./package.json": "./package.json"
   },
   "browser": {
@@ -60,7 +98,19 @@
     "./dist/layout/loader.js": false,
     "./dist/esm/layout/loader.js": false,
     "./dist/repository/index.js": false,
-    "./dist/esm/repository/index.js": false
+    "./dist/esm/repository/index.js": false,
+    "./dist/desktop/index.js": false,
+    "./dist/esm/desktop/index.js": false,
+    "./dist/process/index.js": false,
+    "./dist/esm/process/index.js": false,
+    "./dist/publish/index.js": false,
+    "./dist/esm/publish/index.js": false,
+    "./dist/account/index.js": false,
+    "./dist/esm/account/index.js": false,
+    "./dist/app/index.js": false,
+    "./dist/esm/app/index.js": false,
+    "./dist/skills/index.js": false,
+    "./dist/esm/skills/index.js": false
   },
   "files": [
     "dist",
@@ -73,8 +123,11 @@
     "@modelcontextprotocol/sdk": "1.27.0",
     "ai": "4.0.0",
     "drizzle-orm": "0.45.2",
+    "dotenv": "17.2.3",
     "handlebars": "4.7.9",
+    "js-tiktoken": "1.0.21",
     "js-yaml": "4.1.0",
+    "tar": "7.5.15",
     "zod": "3.25.76"
   },
   "peerDependencies": {
@@ -117,7 +170,7 @@
     "vitest": "3.2.4"
   },
   "scripts": {
-    "prebuild": "node scripts/generate-pricing.mjs && node scripts/generate-models.mjs",
+    "prebuild": "node ../../scripts/check-sdk-app-imports.mjs && node scripts/generate-pricing.mjs && node scripts/generate-models.mjs",
     "build:cjs": "tsup --config tsup.cjs.js",
     "build:esm": "tsup --config tsup.esm.js",
     "build:browser": "tsup --config tsup.browser.js",
@@ -126,6 +179,7 @@
     "db:generate": "cd ../.. && drizzle-kit generate --config drizzle.config.ts && node packages/sdk/scripts/post-generate.mjs",
     "db:check": "cd ../.. && drizzle-kit check --config drizzle.config.ts",
     "test": "vitest run --config ./vitest.config.ts",
+    "test:bundle-provenance-dist": "node scripts/check-bundle-provenance-dist.mjs",
     "test:watch": "vitest --config ./vitest.config.ts",
     "lint": "echo 'SDK lint pending' && exit 0"
   }