@crewx/sdk 0.9.0-rc.103 → 0.9.0-rc.105

package/dist/repository/task.repository.d.ts

@@ -22,6 +22,13 @@ export interface TaskStopRequestResult {
     runEpoch: number;
     alreadyRequestedAt?: string;
 }
+export type TaskStopOrigin = 'http' | 'cli' | 'instruction' | 'workflow' | 'internal';
+export interface TaskStopRequestContext {
+    origin?: TaskStopOrigin;
+    at?: string;
+    callerPid?: number;
+    callerTaskId?: string;
+}
 export type TaskStopMethod = 'cooperative' | 'forced';
 export interface FinalizeTaskStopOptions {
     id: string;
@@ -177,6 +184,9 @@ export declare class TaskRepository extends BaseSqliteRepository {
     requestTaskStop(opts: {
         id: string;
         requestedAt: string;
+        origin?: TaskStopOrigin;
+        callerPid?: number;
+        callerTaskId?: string;
     }): TaskStopRequestResult;
     private requestTaskStopForInstruction;
     finalizeTaskStop(opts: FinalizeTaskStopOptions): boolean;
@@ -197,6 +207,7 @@ export declare class TaskRepository extends BaseSqliteRepository {
         command?: string | null;
         metadata?: string | null;
         workspaceId?: string | null;
+        cwd?: string | null;
         projectId?: string | null;
         platform?: string | null;
         crewxVersion?: string | null;
@@ -213,7 +224,7 @@ export declare class TaskRepository extends BaseSqliteRepository {
     }): boolean;
     adoptPendingTask(id: string): boolean;
     failPendingTask(id: string, error: string, completedAt?: string): boolean;
-    stopPendingTask(id: string, error?: string, completedAt?: string): boolean;
+    stopPendingTask(id: string, error?: string, completedAt?: string, stopRequest?: TaskStopRequestContext): boolean;
     listTasksByProjectId(projectId: string): TaskRow[];
     finishTask(opts: {
         id: string;

package/dist/schema/tasks.d.ts

@@ -668,6 +668,25 @@ export declare const tasks: import("drizzle-orm/sqlite-core").SQLiteTableWithCol
         }, {}, {
             length: number | undefined;
         }>;
+        cwd: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+            name: "cwd";
+            tableName: "tasks";
+            dataType: "string";
+            columnType: "SQLiteText";
+            data: string;
+            driverParam: string;
+            notNull: false;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {
+            length: number | undefined;
+        }>;
         project_id: import("drizzle-orm/sqlite-core").SQLiteColumn<{
             name: "project_id";
             tableName: "tasks";

package/dist/types/index.d.ts

@@ -2810,6 +2810,7 @@ export interface TraceContext {
 }
 export interface CrewxOptions {
     workspaceRoot?: string;
+    inheritWorktreeOwner?: boolean;
     platform?: Platform;
     execPolicy?: import('../template/types').ExecPolicy;
     api?: {

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

@@ -1,4 +1,5 @@
 import type { UiRuntimeFacade, UiRuntimeOptions, UiServerRuntimeFacade, UiServerRuntimeOptions } from './types.js';
+import { UiInstanceStore } from './store.js';
 export interface UiRuntimeTestHooks {
     beforeReservation?: () => Promise<void> | void;
     injectDatabaseError?: () => unknown | undefined;
@@ -7,7 +8,11 @@ export interface UiRuntimeTestHooks {
 export interface UiRuntimeForTestOptions extends UiRuntimeOptions {
     workspaceId: string;
     testHooks?: UiRuntimeTestHooks;
+    store?: UiInstanceStore;
 }
-export declare function createUiRuntime(workspaceId: string, options: UiRuntimeOptions): UiRuntimeFacade;
+export interface UiRuntimeStoreOptions {
+    readonly store?: UiInstanceStore;
+}
+export declare function createUiRuntime(workspaceId: string, options: UiRuntimeOptions & UiRuntimeStoreOptions): UiRuntimeFacade;
 export declare function createUiRuntimeForTest(options: UiRuntimeForTestOptions): UiRuntimeFacade;
-export declare function createUiServerRuntime(options: UiServerRuntimeOptions): UiServerRuntimeFacade;
+export declare function createUiServerRuntime(options: UiServerRuntimeOptions & UiRuntimeStoreOptions): UiServerRuntimeFacade;

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

@@ -2,6 +2,7 @@ import type { ActionReceipt, ActionReceiptOutcome, JsonObject, UiActionHandlerCo
 interface UiInstanceStoreTestHooks {
     injectDatabaseError?: () => unknown | undefined;
     bumpRevisionBeforeCas?: boolean;
+    beforeOpenRead?: () => void;
 }
 export interface ReservationInput {
     instanceId: string;

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

@@ -22,6 +22,7 @@ export interface UiProjectionPolicy {
 export interface UiDefinitionInput {
     readonly id: string;
     readonly version: number;
+    readonly sourceHash?: string;
     readonly actions: Readonly<Record<string, UiDefinitionAction>>;
     readonly renderer?: string;
     readonly surfaces?: readonly string[];

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

@@ -1,3 +1,4 @@
 export { canonicalManifestJson, manifestHash } from './manifest.js';
-export { UiPluginValidationError, normalizeManifest, validateManifest, validatePayload, } from './validator.js';
-export type { UiPluginActivation, UiPluginCardShellNode, UiPluginFieldSchema, UiPluginHeadingNode, UiPluginLabeledTextNode, UiPluginLayoutNode, UiPluginLayout, UiPluginManifest, UiPluginMetaBannerNode, UiPluginPayload, UiPluginPayloadValue, UiPluginPrimitive, UiPluginSchemaType, UiPluginSchema, UiPluginStep, UiPluginStepFlowNode, UiPluginStepListSchema, UiPluginTextListNode, UiPluginTextListSchema, UiPluginTextSchema, UiPluginValidationErrorCode, UiPluginValidationOptions, } from './types.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, 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/types.d.ts

@@ -1,3 +1,4 @@
+import type { JsonValue, UiDefinitionInput } from '../ui-instance/types.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 {
@@ -54,7 +55,7 @@ export interface UiPluginTextListNode {
 }
 export type UiPluginLayoutNode = UiPluginCardShellNode | UiPluginMetaBannerNode | UiPluginHeadingNode | UiPluginLabeledTextNode | UiPluginStepFlowNode | UiPluginTextListNode;
 export type UiPluginLayout = readonly UiPluginLayoutNode[];
-export interface UiPluginManifest {
+export interface UiPluginManifestV1 {
     readonly manifestVersion: 1;
     readonly pluginId: string;
     readonly definitionId: string;
@@ -64,6 +65,99 @@ export interface UiPluginManifest {
     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 UiPluginSkillBackend {
+    readonly type: 'skill';
+    readonly command: readonly string[];
+}
+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;
+}
+export interface UiPluginResourceRef {
+    readonly path: 'ui/index.html' | 'ui/state.json';
+    readonly hash?: string;
+}
+export interface UiPluginSize {
+    readonly height: number;
+}
+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 initialState?: {
+        readonly path: 'ui/state.json';
+        readonly hash?: string;
+    };
+    readonly surfaces: readonly UiPluginSurface[];
+    readonly size: UiPluginSize;
+    readonly stateProjection: UiPluginProjectionPolicy;
+    readonly actions: readonly UiPluginAction[];
+}
+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;
@@ -72,5 +166,6 @@ 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';
+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

@@ -1,9 +1,15 @@
-import type { UiPluginManifest, UiPluginPayload, UiPluginValidationErrorCode, UiPluginValidationOptions } from './types.js';
+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 name = "UiPluginValidationError";
     constructor(code: UiPluginValidationErrorCode, message?: string);
 }
+export declare function validateInitialState(value: unknown): 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: unknown, options?: UiPluginValidationOptions): UiPluginManifest;
-export declare function validatePayload(manifest: UiPluginManifest, rawPayload: unknown): UiPluginPayload;
+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/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/package.json

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