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

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

@@ -0,0 +1,204 @@
+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';
+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 schedule?: UiDefinitionActionSchedule;
+    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.16",
+  "version": "0.9.0-rc.161",
   "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"
   }