@crewx/sdk 0.9.0-rc.7 → 0.9.0-rc.71

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

@@ -0,0 +1,65 @@
+import type { ActionReceipt, ActionReceiptOutcome, JsonObject, UiActionHandlerContext, UiActor, UiInstance } from './types.js';
+interface UiInstanceStoreTestHooks {
+    injectDatabaseError?: () => unknown | undefined;
+    bumpRevisionBeforeCas?: boolean;
+}
+export interface ReservationInput {
+    instanceId: string;
+    requestId: string;
+    actionId: string;
+    actor: UiActor;
+    source: 'cli' | 'ui_host' | 'system';
+    expectedRevision: number;
+    input: JsonObject;
+    now: number;
+}
+export interface StateHandlerExecution {
+    handle: (context: UiActionHandlerContext) => {
+        state?: JsonObject;
+        result?: JsonObject;
+    } | {
+        outcome: 'rejected' | 'failed';
+        errorCode: string;
+        state?: JsonObject;
+        result?: JsonObject;
+    };
+}
+export interface ExternalReservation {
+    instance: UiInstance;
+    receipt: ActionReceipt;
+    reservedRevision: number;
+}
+export declare class UiInstanceStore {
+    private readonly handle;
+    private readonly db;
+    private readonly testHooks?;
+    constructor(dbPath?: string, testHooks?: UiInstanceStoreTestHooks);
+    close(): void;
+    create(input: {
+        id: string;
+        definitionId: string;
+        definitionVersion: number;
+        definitionHash: string;
+        workspaceId: string;
+        threadId: string;
+        anchorTaskId: string | null;
+        domainRef: JsonObject;
+        state: JsonObject;
+        grants: readonly string[];
+        now: number;
+    }): UiInstance;
+    get(instanceId: string): UiInstance | null;
+    getReceipt(instanceId: string, requestId: string): ActionReceipt | null;
+    runStateOnly(reservation: ReservationInput, handler: StateHandlerExecution['handle']): ActionReceipt;
+    reserveExternal(reservation: ReservationInput): ExternalReservation;
+    settleExternal(input: {
+        reservation: ReservationInput;
+        reservedRevision: number;
+        outcome: ActionReceiptOutcome;
+        state: JsonObject;
+        result: JsonObject | null;
+        errorCode: string | null;
+        now: number;
+    }): ActionReceipt;
+}
+export {};

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

@@ -0,0 +1,200 @@
+export type JsonPrimitive = string | number | boolean | null;
+export type JsonValue = JsonPrimitive | JsonObject | JsonValue[];
+export interface JsonObject {
+    [key: string]: JsonValue;
+}
+export type UiInstanceStatus = 'active' | 'completed' | 'expired' | 'revoked' | 'unsupported';
+export interface UiDefinitionRef {
+    id: string;
+    version: number;
+    hash: string;
+}
+export interface UiDefinitionAction {
+    readonly capabilities: readonly string[];
+    readonly inputKeys?: readonly string[];
+    readonly resultProjection?: UiProjectionPolicy;
+}
+export interface UiProjectionPolicy {
+    allow: readonly string[];
+}
+export interface UiDefinitionInput {
+    readonly id: string;
+    readonly version: number;
+    readonly actions: Readonly<Record<string, UiDefinitionAction>>;
+    readonly renderer?: string;
+    readonly surfaces?: readonly string[];
+    readonly stateProjection?: UiProjectionPolicy;
+}
+export interface UiDefinition extends UiDefinitionInput {
+    readonly hash: string;
+}
+export interface CreateUiInstanceInput {
+    definition: UiDefinitionRef;
+    workspaceId: string;
+    threadId: string;
+    anchorTaskId?: string;
+    domainRef: JsonObject;
+    state: JsonObject;
+}
+export interface UiInstance {
+    id: string;
+    definition: UiDefinitionRef;
+    workspaceId: string;
+    threadId: string;
+    anchorTaskId: string | null;
+    domainRef: JsonObject;
+    state: JsonObject;
+    revision: number;
+    status: UiInstanceStatus;
+    grantedCapabilities: readonly string[];
+    createdAt: number;
+    updatedAt: number;
+}
+export interface UiActionEnvelope {
+    instanceId: string;
+    actionId: string;
+    expectedRevision: number;
+    requestId: string;
+    input: JsonObject;
+}
+export type UiActor = {
+    kind: 'local';
+    id: string;
+} | {
+    kind: 'authenticated';
+    id: string;
+};
+export interface UiExecutionContext {
+    source: 'cli' | 'ui_host' | 'system';
+    workspaceId: string;
+    actor: UiActor;
+}
+export interface UiAuthenticatedActor {
+    kind: 'authenticated';
+    id: string;
+}
+export interface UiAuthenticatedExecutionContext {
+    source: 'ui_host' | 'system';
+    workspaceId: string;
+    threadId: string;
+    actor: UiAuthenticatedActor;
+}
+export type ActionReceiptOutcome = 'succeeded' | 'rejected' | 'failed' | 'conflicted' | 'expired';
+export interface ActionReceipt {
+    id: string;
+    instanceId: string;
+    requestId: string;
+    actionId: string;
+    actor: UiActor;
+    source: 'cli' | 'ui_host' | 'system';
+    expectedRevision: number;
+    beforeRevision: number;
+    afterRevision: number | null;
+    status: 'requested' | 'settled';
+    outcome: ActionReceiptOutcome | null;
+    input: JsonObject;
+    result: JsonObject | null;
+    errorCode: string | null;
+    requestedAt: number;
+    settledAt: number | null;
+}
+export interface UiLocalGrantPolicy {
+    resolveInstanceGrants(input: {
+        definition: UiDefinitionRef;
+        workspaceId: string;
+        actor: Extract<UiActor, {
+            kind: 'local';
+        }>;
+    }): readonly string[];
+    resolveActionCapabilities(input: {
+        definition: UiDefinitionRef;
+        actionId: string;
+    }): readonly string[];
+}
+export interface UiActionHandlerContext {
+    instance: UiInstance;
+    actor: UiActor;
+    source: 'cli' | 'ui_host' | 'system';
+    input: JsonObject;
+    requestId: string;
+}
+export type UiActionHandlerResult = {
+    state?: JsonObject;
+    result?: JsonObject;
+} | {
+    outcome: 'rejected' | 'failed';
+    errorCode: string;
+    state?: JsonObject;
+    result?: JsonObject;
+};
+export interface UiStateActionHandlerRegistration {
+    definitionId: string;
+    version: number;
+    actionId: string;
+    kind: 'state';
+    handle: (context: UiActionHandlerContext) => UiActionHandlerResult;
+}
+export interface UiExternalActionHandlerRegistration {
+    definitionId: string;
+    version: number;
+    actionId: string;
+    kind: 'external';
+    handle: (context: UiActionHandlerContext) => Promise<UiActionHandlerResult>;
+}
+export type UiActionHandlerRegistration = UiStateActionHandlerRegistration | UiExternalActionHandlerRegistration;
+export interface UiRuntimeOptions {
+    dbPath?: string;
+    localActor: Extract<UiActor, {
+        kind: 'local';
+    }>;
+    localGrantPolicy?: UiLocalGrantPolicy;
+    definitions?: readonly UiDefinition[];
+    handlers?: readonly UiActionHandlerRegistration[];
+    clock?: () => number;
+}
+export interface UiRuntimeFacade {
+    resolveDefinition(ref: UiDefinitionRef): UiDefinition | null;
+    createInstance(input: CreateUiInstanceInput): Promise<UiInstance>;
+    dispatchAction(input: UiActionEnvelope, context: UiExecutionContext): Promise<ActionReceipt>;
+    getReceipt(instanceId: string, requestId: string): Promise<ActionReceipt | null>;
+    close(): void;
+}
+export interface UiAuthenticatedGrantPolicy {
+    resolveInstanceGrants(input: {
+        definition: UiDefinitionRef;
+        workspaceId: string;
+        actor: UiAuthenticatedActor;
+    }): readonly string[];
+    resolveDispatchCapabilities?(input: {
+        definition: UiDefinitionRef;
+        actionId: string;
+        actor: UiAuthenticatedActor;
+        source: 'ui_host' | 'system';
+    }): readonly string[];
+}
+export declare function resolveUiEffectiveCapabilities(declared: readonly string[], instanceGranted: readonly string[], dispatchGranted?: readonly string[]): readonly string[];
+export interface UiServerRuntimeOptions {
+    workspaceId: string;
+    dbPath: string;
+    definitions: readonly UiDefinition[];
+    handlers: readonly UiActionHandlerRegistration[];
+    grantPolicy: UiAuthenticatedGrantPolicy;
+    clock?: () => number;
+}
+export interface UiServerRuntimeFacade {
+    resolveDefinition(ref: UiDefinitionRef): UiDefinition | null;
+    getInstance(instanceId: string, context: UiAuthenticatedExecutionContext): Promise<UiInstance | null>;
+    createInstance(input: CreateUiInstanceInput, context: UiAuthenticatedExecutionContext): Promise<UiInstance>;
+    dispatchAction(input: UiActionEnvelope, context: UiAuthenticatedExecutionContext): Promise<ActionReceipt>;
+    getReceipt(instanceId: string, requestId: string, context: UiAuthenticatedExecutionContext): Promise<ActionReceipt | null>;
+    close(): void;
+}
+export interface UiAgentContextProjection {
+    instanceId: string;
+    definition: UiDefinitionRef;
+    revision: number;
+    facts: JsonObject;
+    recentChanges: readonly JsonObject[];
+    pendingDecision: JsonObject | null;
+    availableActions: readonly string[];
+}

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

@@ -0,0 +1 @@
+export declare function getCrewxHome(): 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';
 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/timestamp.d.ts

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

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.7",
+  "version": "0.9.0-rc.71",
   "license": "UNLICENSED",
   "engines": {
     "node": ">=20.19.0"
@@ -50,6 +50,16 @@
       "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"
+    },
+    "./publish": {
+      "types": "./dist/publish/index.d.ts",
+      "import": "./dist/publish/index.js",
+      "require": "./dist/publish/index.js"
+    },
     "./package.json": "./package.json"
   },
   "browser": {
@@ -60,7 +70,11 @@
     "./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/publish/index.js": false,
+    "./dist/esm/publish/index.js": false
   },
   "files": [
     "dist",
@@ -74,7 +88,9 @@
     "ai": "4.0.0",
     "drizzle-orm": "0.45.2",
     "handlebars": "4.7.9",
+    "js-tiktoken": "1.0.21",
     "js-yaml": "4.1.0",
+    "tar": "7.5.15",
     "zod": "3.25.76"
   },
   "peerDependencies": {