@crewx/sdk 0.9.0-rc.120 → 0.9.0-rc.121

package/dist/repository/thread-origin-verdict.d.ts

@@ -0,0 +1,27 @@
+export type ThreadOriginKind = 'human' | 'agent' | 'system';
+export interface ThreadOriginRow {
+    origin: 'direct' | 'delegated';
+    delegatedByAgentId: string | null;
+}
+export interface RawThreadOriginRow {
+    task_id: string;
+    thread_id: string;
+    caller_agent_id: string | null;
+    parent_task_id: string | null;
+    schedule_id: unknown;
+    platform: string | null;
+    parent_thread_id: string | null;
+    parent_agent_id: string | null;
+}
+export interface RawThreadCreatorPointerRow {
+    thread_id: string;
+    created_by_kind: string | null;
+    created_by_id: string | null;
+    created_by_task_id: string | null;
+    creator_task_id: string | null;
+    creator_actor_kind: string | null;
+    creator_actor_id: string | null;
+    creator_pointer_unverified: number;
+}
+export declare function lineageThreadOrigin(row: RawThreadOriginRow): ThreadOriginRow;
+export declare function resolveThreadOrigin(row: RawThreadCreatorPointerRow, pointerLineage?: RawThreadOriginRow, fallbackLineage?: RawThreadOriginRow): ThreadOriginRow | undefined;

package/dist/repository/thread.repository.d.ts

@@ -1,7 +1,9 @@
 import { BaseSqliteRepository } from './base-sqlite-repository.js';
 import { RepositoryError } from './errors.js';
 import { threads } from '../schema/index.js';
+import type { ThreadOriginRow } from './thread-origin-verdict.js';
 import type { TaskRow, TaskListRow } from './task.repository.js';
+export type { ThreadOriginRow } from './thread-origin-verdict.js';
 export type ThreadRow = typeof threads.$inferSelect;
 export type NewThread = typeof threads.$inferInsert;
 export type ThreadActorKind = NonNullable<NewThread['created_by_kind']>;
@@ -12,10 +14,6 @@ export interface ThreadCreationOptions {
 }
 export type ThreadOriginFilter = 'direct' | 'delegated' | 'all';
 type ThreadOriginScope = Exclude<ThreadOriginFilter, 'all'>;
-export interface ThreadOriginRow {
-    origin: 'direct' | 'delegated';
-    delegatedByAgentId: string | null;
-}
 export interface ThreadTitleMetadataPatch {
     priority?: string | null;
     state?: string | null;
@@ -38,9 +36,12 @@ export declare class ThreadRepository extends BaseSqliteRepository {
     });
     resolveDbPath(): string;
     private openHandle;
-    private validateWorkspaceId;
     private topLevelTaskPredicateSql;
     private findAllThreadsQuery;
+    private findThreadIdsQuery;
+    private readThreadIds;
+    private readThreadRowsByIds;
+    private readThreadRows;
     findAllThreads(workspaceId?: string, createdByKind?: ThreadActorKind): ThreadRow[];
     explainFindAllThreadsPlan(workspaceId?: string, createdByKind?: ThreadActorKind): string[];
     findThreadsByIdsOrTitles(ids: string[], workspaceId?: string): ThreadRow[];
@@ -63,9 +64,8 @@ export declare class ThreadRepository extends BaseSqliteRepository {
     private batchFetchTasksQuery;
     batchFetchTasks(threadIds: string[], workspaceId?: string): Map<string, TaskListRow[]>;
     private findThreadOriginsQuery;
-    private findRecordedThreadOriginsQuery;
-    private findThreadsByOriginQuery;
-    private findLegacyThreadsQuery;
+    private findCreatorPointersQuery;
+    private findTaskOriginLineageQuery;
     findThreadOrigins(threadIds: string[], workspaceId?: string): Map<string, ThreadOriginRow>;
     findThreadsByOrigin(origin: ThreadOriginScope, workspaceId?: string): ThreadRow[];
     explainBatchFetchTasksPlan(threadIds: string[], workspaceId?: string): string[];
@@ -116,4 +116,3 @@ export declare class ThreadRepository extends BaseSqliteRepository {
         remaining: number;
     } | null;
 }
-export {};

package/dist/schema/index.d.ts

@@ -2,6 +2,7 @@ export * from './workspaces.js';
 export * from './tasks.js';
 export * from './task-log-events.js';
 export * from './threads.js';
+export * from './thread-creator-unverified.js';
 export * from './spans.js';
 export * from './tool-calls.js';
 export * from './thread-boxes.js';

package/dist/schema/thread-creator-unverified.d.ts

@@ -0,0 +1,45 @@
+export declare const thread_creator_unverified: import("drizzle-orm/sqlite-core").SQLiteTableWithColumns<{
+    name: "thread_creator_unverified";
+    schema: undefined;
+    columns: {
+        thread_id: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+            name: "thread_id";
+            tableName: "thread_creator_unverified";
+            dataType: "string";
+            columnType: "SQLiteText";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {
+            length: number | undefined;
+        }>;
+        created_by_task_id: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+            name: "created_by_task_id";
+            tableName: "thread_creator_unverified";
+            dataType: "string";
+            columnType: "SQLiteText";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {
+            length: number | undefined;
+        }>;
+    };
+    dialect: "sqlite";
+}>;

package/dist/types/index.d.ts

@@ -2868,6 +2868,7 @@ export interface QueryOptions {
     messages?: import('../conversation/types').TemplateMessage[];
     uiProjections?: readonly import('../ui-instance/types').UiAgentContextProjection[];
     mcpAppProjections?: readonly McpAppStateDescriptor[];
+    mcpAppModelContext?: import('../mcp-app/model-context.js').McpAppModelContext;
     vars?: Record<string, unknown>;
     cwd?: string;
     resumeSessionId?: string;
@@ -2917,6 +2918,7 @@ export interface ExecuteOptions {
     messages?: import('../conversation/types').TemplateMessage[];
     uiProjections?: readonly import('../ui-instance/types').UiAgentContextProjection[];
     mcpAppProjections?: readonly McpAppStateDescriptor[];
+    mcpAppModelContext?: import('../mcp-app/model-context.js').McpAppModelContext;
     vars?: Record<string, unknown>;
     cwd?: string;
     resumeSessionId?: string;

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

@@ -1,4 +1,4 @@
-export type { ActionReceipt, ActionReceiptOutcome, CreateUiInstanceInput, JsonObject, JsonPrimitive, JsonValue, UiActionHandlerContext, UiActionHandlerRegistration, UiActionHandlerResult, UiActionEnvelope, UiActionConfirmation, UiActor, UiDefinition, UiDefinitionAction, UiDefinitionDisplayMode, UiDefinitionInput, UiDefinitionRef, UiDefinitionUsage, UiProjectionPolicy, UiExecutionContext, UiAuthenticatedActor, UiTaskActorSnapshot, UiAuthenticatedExecutionContext, UiAuthenticatedGrantPolicy, UiServerRuntimeFacade, UiServerRuntimeOptions, UiAgentContextProjection, UiExternalActionHandlerRegistration, UiInstance, UiInstanceStatus, UiLocalGrantPolicy, UiRuntimeFacade, UiRuntimeOptions, UiStateActionHandlerRegistration, } from './types.js';
+export type { ActionReceipt, ActionReceiptOutcome, CreateUiInstanceInput, JsonObject, JsonPrimitive, JsonValue, UiActionHandlerContext, UiActionHandlerRegistration, UiActionHandlerResult, UiActionEnvelope, UiActionConfirmation, UiActor, UiDefinition, UiDefinitionAction, UiDefinitionDisplayMode, UiDefinitionInput, UiDefinitionRef, UiDefinitionUsage, UiProjectionPolicy, UiExecutionContext, UiAuthenticatedActor, UiTaskActorSnapshot, UiAuthenticatedExecutionContext, UiApprovalRequestContext, UiTaskExecutionContext, UiApprovalDecisionProvenance, UiApprovalPendingReceipt, UiApprovalRequestReceiptResult, UiAuthenticatedGrantPolicy, UiServerRuntimeFacade, UiServerRuntimeOptions, UiAgentContextProjection, UiExternalActionHandlerRegistration, UiInstance, UiInstanceStatus, UiLocalGrantPolicy, UiRuntimeFacade, UiRuntimeOptions, UiStateActionHandlerRegistration, } from './types.js';
 export { isUiAuthenticatedActor, resolveUiEffectiveCapabilities } from './types.js';
 export { UiRuntimeError } from './errors.js';
 export type { UiRuntimeErrorCode } from './errors.js';

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

@@ -1,4 +1,4 @@
-import type { ActionReceipt, ActionReceiptOutcome, JsonObject, UiActionHandlerContext, UiActor, UiInstance, UiAuthenticatedActor, UiDefinitionRef } from './types.js';
+import type { ActionReceipt, ActionReceiptOutcome, UiApprovalDecisionProvenance, UiApprovalPendingReceipt, UiApprovalRequestReceiptResult, JsonObject, UiActionHandlerContext, UiActor, UiInstance, UiAuthenticatedActor, UiDefinitionRef } from './types.js';
 export type UiInstanceDataPathResolver = (definition: UiDefinitionRef) => readonly string[];
 interface UiInstanceStoreTestHooks {
     injectDatabaseError?: () => unknown | undefined;
@@ -17,6 +17,30 @@ export interface ReservationInput {
     receiptInput?: JsonObject;
     now: number;
 }
+export interface ApprovalPendingReservationInput {
+    readonly reservation: ReservationInput;
+    readonly approvalId: string;
+    readonly expiresAt: number;
+}
+export type ApprovalPendingReservationResult = {
+    readonly kind: 'reserved';
+    readonly reservation: ExternalReservation;
+} | {
+    readonly kind: 'settled';
+    readonly receipt: ActionReceipt;
+};
+interface ApprovalReceiptMarker {
+    state: 'pending' | 'executing' | 'settled';
+    approvalId: string;
+    expiresAt: number;
+    decidedBy?: string;
+}
+interface ApprovalReceiptRecord {
+    readonly receipt: ActionReceipt;
+    readonly approvalId: string;
+    readonly expiresAt: number;
+    readonly state: ApprovalReceiptMarker['state'];
+}
 export interface StateHandlerExecution {
     handle: (context: UiActionHandlerContext) => {
         state?: JsonObject;
@@ -90,9 +114,18 @@ export declare class UiInstanceStore {
     updateAuditSnapshot(input: UiAuditSnapshotInput): UiInstance | null;
     getReceipt(instanceId: string, requestId: string): ActionReceipt | null;
     getReceiptById(receiptId: string): ActionReceipt | null;
+    createApprovalPendingReceipt(reservation: ReservationInput, approval: {
+        readonly approvalId: string;
+        readonly expiresAt: number;
+    }): UiApprovalRequestReceiptResult;
+    getApprovalPendingReceipt(receiptId: string): UiApprovalPendingReceipt | null;
+    getApprovalReceipt(receiptId: string): ApprovalReceiptRecord | null;
+    listApprovalPendingReceipts(): UiApprovalPendingReceipt[];
+    settleApprovalPendingReceipt(receiptId: string, outcome: 'rejected' | 'expired' | 'conflicted', provenance: UiApprovalDecisionProvenance, now: number): ActionReceipt | null;
     getLatestReceiptForInstance(instanceId: string): ActionReceipt | null;
     runStateOnly(reservation: ReservationInput, handler: StateHandlerExecution['handle']): ActionReceipt;
     reserveExternal(reservation: ReservationInput): ExternalReservation;
+    reserveApprovalPendingReceipt(reservation: ReservationInput, receiptId: string, provenance: UiApprovalDecisionProvenance): ApprovalPendingReservationResult;
     settleExternal(input: {
         reservation: ReservationInput;
         reservedRevision: number;

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

@@ -35,7 +35,6 @@ export interface UiDefinitionInput {
     readonly surfaces?: readonly string[];
     readonly stateProjection?: UiProjectionPolicy;
     readonly dataPaths?: readonly string[];
-    readonly focusedAiDataPaths?: readonly string[];
 }
 export interface UiDefinition extends UiDefinitionInput {
     readonly hash: string;
@@ -103,6 +102,36 @@ export interface UiAuthenticatedExecutionContext {
     threadId: string;
     actor: UiAuthenticatedActor;
 }
+export interface UiApprovalRequestContext {
+    source: 'cli';
+    workspaceId: string;
+    threadId: string;
+    actor: UiAuthenticatedActor;
+}
+export interface UiTaskExecutionContext {
+    source: 'cli';
+    workspaceId: string;
+    threadId: string;
+    actor: UiAuthenticatedActor & {
+        task: UiTaskActorSnapshot;
+    };
+}
+export interface UiApprovalDecisionProvenance {
+    approvalId: string;
+    decidedBy: string;
+}
+export interface UiApprovalPendingReceipt {
+    receipt: ActionReceipt;
+    approvalId: string;
+    expiresAt: number;
+}
+export interface UiApprovalRequestReceiptResult {
+    receipt: ActionReceipt;
+    approval: {
+        approvalId: string;
+        expiresAt: number;
+    } | null;
+}
 export type ActionReceiptOutcome = 'succeeded' | 'rejected' | 'failed' | 'conflicted' | 'expired';
 export interface ActionReceipt {
     id: string;
@@ -193,7 +222,7 @@ export interface UiAuthenticatedGrantPolicy {
         definition: UiDefinitionRef;
         actionId: string;
         actor: UiAuthenticatedActor;
-        source: 'ui_host' | 'system';
+        source: 'ui_host' | 'system' | 'cli';
     }): readonly string[];
 }
 export declare function resolveUiEffectiveCapabilities(declared: readonly string[], instanceGranted: readonly string[], dispatchGranted?: readonly string[]): readonly string[];
@@ -209,8 +238,15 @@ 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>;
+    dispatchAction(input: UiActionEnvelope, context: UiAuthenticatedExecutionContext | UiTaskExecutionContext): Promise<ActionReceipt>;
     getReceipt(instanceId: string, requestId: string, context: UiAuthenticatedExecutionContext): Promise<ActionReceipt | null>;
+    createApprovalPendingReceipt(input: UiActionEnvelope, context: UiApprovalRequestContext, approval: {
+        approvalId: string;
+        expiresAt: number;
+    }): Promise<UiApprovalRequestReceiptResult>;
+    executeApprovalPending(input: UiActionEnvelope, receiptId: string, provenance: UiApprovalDecisionProvenance): Promise<ActionReceipt>;
+    settleApprovalPending(receiptId: string, outcome: 'rejected' | 'expired' | 'conflicted', provenance: UiApprovalDecisionProvenance): Promise<ActionReceipt | null>;
+    listApprovalPendingReceipts(): Promise<UiApprovalPendingReceipt[]>;
     close(): void;
 }
 export interface UiAgentContextProjection {

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

@@ -1,4 +1,4 @@
-import type { JsonValue, UiActionConfirmation, UiDefinitionInput } from '../ui-instance/types.js';
+import type { JsonObject, JsonValue, UiActionConfirmation, 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 {
@@ -110,6 +110,7 @@ export interface UiPluginAction {
     readonly backend: UiPluginBackend;
     readonly dataInputs?: readonly string[];
     readonly confirmation?: UiActionConfirmation;
+    readonly _meta?: JsonObject;
 }
 export interface UiPluginResourceRef {
     readonly path: 'ui/index.html' | 'ui/state.json';
@@ -140,8 +141,8 @@ export interface UiPluginManifestV2 {
     readonly size: UiPluginSize;
     readonly stateProjection: UiPluginProjectionPolicy;
     readonly dataPaths?: readonly string[];
-    readonly focusedAiDataPaths?: readonly string[];
     readonly actions: readonly UiPluginAction[];
+    readonly _meta?: JsonObject;
 }
 export type UiPluginManifest = UiPluginManifestV1 | UiPluginManifestV2;
 export interface UiPluginHandlerMetadata {

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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@crewx/sdk",
-  "version": "0.9.0-rc.120",
+  "version": "0.9.0-rc.121",
   "license": "UNLICENSED",
   "engines": {
     "node": ">=20.19.0"
@@ -20,6 +20,14 @@
       "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",