@crewx/sdk 0.9.0-rc.94 → 0.9.0-rc.96

package/dist/lifecycle/task-heartbeat.d.ts

@@ -0,0 +1,41 @@
+import type { TaskRepository } from '../repository/task.repository.js';
+export declare const TASK_HEARTBEAT_INTERVAL_MS = 10000;
+export declare const TASK_HEARTBEAT_STALE_MS = 30000;
+export declare const TASK_HEARTBEAT_HARD_STALE_MS: number;
+export declare const TASK_STOP_POLL_INTERVAL_MS = 1000;
+export declare function resolveTaskHeartbeatIntervalMs(): number;
+export declare function resolveTaskHeartbeatStaleMs(): number;
+export declare function resolveTaskHeartbeatHardStaleMs(): number;
+export interface TaskHeartbeatRow {
+    id?: string;
+    status: string;
+    run_epoch: number | null;
+    stop_requested_at: string | null;
+    stop_requested_epoch: number | null;
+    pid?: number | null;
+    metadata?: string | null;
+    started_at?: string;
+    duration_ms?: number | null;
+}
+export interface HeartbeatTickResult {
+    accepted: boolean;
+    row: TaskHeartbeatRow | null;
+}
+export interface TaskHeartbeatOptions {
+    taskId: string;
+    runEpoch: number;
+    onStopRequested?: (row: TaskHeartbeatRow) => void | Promise<void>;
+}
+export interface TaskHeartbeatHandle {
+    timer: ReturnType<typeof setInterval>;
+    runEpoch: number;
+    stopRequested: boolean;
+    lastHeartbeatAt: number;
+    heartbeatElapsedMs: number;
+}
+export declare const taskHeartbeatRegistry: Map<string, TaskHeartbeatHandle>;
+export declare function runHeartbeatTick(repo: Pick<TaskRepository, 'heartbeatTask' | 'getTask'>, options: TaskHeartbeatOptions & {
+    writeHeartbeat?: boolean;
+}): HeartbeatTickResult;
+export declare function stopTaskHeartbeat(taskId: string, runEpoch?: number | null): boolean;
+export declare function startTaskHeartbeat(repo: Pick<TaskRepository, 'heartbeatTask' | 'getTask'>, options: TaskHeartbeatOptions): boolean;

package/dist/lifecycle/task-stop.d.ts

@@ -0,0 +1,30 @@
+import type { TaskRepository } from '../repository/task.repository.js';
+import { checkProcessOwnershipAsync as defaultCheckProcessOwnershipAsync, terminateProcessTree as defaultTerminateProcessTree, type ProcessControlOptions } from '../process/process-control.js';
+export declare const TASK_STOP_DEFAULT_GRACE_MS = 5000;
+export declare const TASK_STOP_DEFAULT_POLL_MS = 250;
+export declare function resolveTaskStopMethod(requestedAt: string | null | undefined, completedAt?: string | number, graceMs?: number): 'cooperative' | 'forced';
+export declare const TASK_STOP_OWNED_PROCESS_MARKERS: readonly ["crewx", "claude", "codex", "opencode", "grok", "node"];
+export type StopTaskStatus = 'stopped' | 'not_running' | 'already_requested' | 'ownership_unverified' | 'failed';
+export interface StopTaskResult {
+    status: StopTaskStatus;
+    method?: 'cooperative' | 'forced';
+    finalStatus: string | null;
+    pid?: number;
+    error?: string;
+}
+export interface StopTaskProcessControl {
+    checkProcessOwnershipAsync?: typeof defaultCheckProcessOwnershipAsync;
+    terminateProcessTree?: typeof defaultTerminateProcessTree;
+}
+export interface StopTaskOptions {
+    graceMs?: number;
+    pollMs?: number;
+    platform?: NodeJS.Platform;
+    ownershipMarkers?: readonly string[];
+    processControl?: StopTaskProcessControl;
+    processControlOptions?: ProcessControlOptions;
+}
+type StopTaskRepository = Pick<TaskRepository, 'requestTaskStop' | 'getTask' | 'finalizeTaskStop'>;
+export declare function stopTask(taskId: string, options?: StopTaskOptions): Promise<StopTaskResult>;
+export declare function stopTask(repo: StopTaskRepository, taskId: string, options?: StopTaskOptions): Promise<StopTaskResult>;
+export {};

package/dist/mcp-app/errors.d.ts

@@ -0,0 +1,7 @@
+export type McpAppContractErrorCode = 'APP_ID_INVALID' | 'APP_ID_CONFLICT' | 'TOOL_ID_INVALID' | 'TOOL_ID_CONFLICT' | 'RESOURCE_URI_INVALID' | 'RESOURCE_NOT_FOUND' | 'HTML_INVALID' | 'TOOL_INVALID' | 'STATE_INVALID' | 'STATE_PROJECTION_INVALID' | 'BUTTON_INVALID' | 'SERIALIZATION_INVALID';
+export declare class McpAppContractError extends Error {
+    readonly code: McpAppContractErrorCode;
+    readonly name = "McpAppContractError";
+    constructor(code: McpAppContractErrorCode, message?: string);
+}
+export declare function rejectMcpApp(code: McpAppContractErrorCode, message?: string): never;

package/dist/mcp-app/index.d.ts

@@ -0,0 +1,6 @@
+export type { McpAppContractErrorCode } from './errors.js';
+export { McpAppContractError } from './errors.js';
+export { createMcpAppRegistry, createBuiltinMcpAppRegistry, registerMcpApp, resolveMcpAppResource, requireMcpAppResource, toMcpAppToolRegistration, } from './registry.js';
+export { buildMcpAppStateDescriptor, buildMcpAppStateProjections, buildTerminalMcpAppStateDescriptor, buildTerminalMcpAppStateProjections, createMcpAppToolResult, serializeMcpAppStateJson, serializeMcpAppStateXml, } from './projection.js';
+export { MCP_APP_HOST_TOOL_ALLOWLIST, MCP_APP_RESOURCE_MIME_TYPE, MCP_APP_RESOURCE_URI_PREFIX, } from './types.js';
+export type { McpAppActionDispatcherToolInput, McpAppActionToolDescriptor, McpAppActionToolInput, McpAppButtonDescriptor, McpAppButtonInput, McpAppDescriptor, McpAppDescriptorInput, McpAppInputSchema, McpAppTone, McpUiResourceCsp, McpAppRegistry, McpAppResource, McpAppServerStateInput, McpAppStateDescriptor, McpAppStateProjections, McpAppHostToolInput, McpAppHostToolName, McpAppReadToolInput, McpAppSingleActionToolInput, McpAppToolCommonInput, McpAppToolDescriptor, McpAppToolInput, McpAppToolMetadata, McpAppToolRegistration, McpAppToolResult, McpAppToolVisibility, } from './types.js';

package/dist/mcp-app/projection.d.ts

@@ -0,0 +1,12 @@
+import type { JsonObject } from '../ui-instance/types.js';
+import type { McpAppServerStateInput, McpAppStateDescriptor, McpAppStateProjections, McpAppToolDescriptor, McpAppToolResult } from './types.js';
+export declare function buildMcpAppStateDescriptor(input: McpAppServerStateInput): McpAppStateDescriptor;
+export declare function buildTerminalMcpAppStateDescriptor(input: McpAppServerStateInput): McpAppStateDescriptor;
+export declare function serializeMcpAppStateJson(descriptor: McpAppStateDescriptor): string;
+export declare function serializeMcpAppStateXml(descriptor: McpAppStateDescriptor): string;
+export declare function buildMcpAppStateProjections(input: McpAppServerStateInput): McpAppStateProjections;
+export declare function buildTerminalMcpAppStateProjections(input: McpAppServerStateInput): McpAppStateProjections;
+export declare function createMcpAppToolResult(tool: Pick<McpAppToolDescriptor, 'textFallback'>, options?: {
+    structuredContent?: JsonObject;
+    meta?: JsonObject;
+}): McpAppToolResult;

package/dist/mcp-app/registry.d.ts

@@ -0,0 +1,7 @@
+import { type McpAppDescriptor, type McpAppDescriptorInput, type McpAppRegistry, type McpAppResource, type McpAppToolDescriptor, type McpAppToolRegistration } from './types.js';
+export declare function createMcpAppRegistry(): McpAppRegistry;
+export declare function createBuiltinMcpAppRegistry(): McpAppRegistry;
+export declare function registerMcpApp(registry: McpAppRegistry, input: McpAppDescriptorInput): McpAppDescriptor;
+export declare function resolveMcpAppResource(registry: McpAppRegistry, uri: string): McpAppResource | null;
+export declare function requireMcpAppResource(registry: McpAppRegistry, uri: string): McpAppResource;
+export declare function toMcpAppToolRegistration(tool: McpAppToolDescriptor): McpAppToolRegistration;

package/dist/mcp-app/types.d.ts

@@ -0,0 +1,165 @@
+import type { JsonObject, UiDefinition, UiDefinitionRef, UiInstance, UiInstanceStatus, UiActionConfirmation } from '../ui-instance/types.js';
+export declare const MCP_APP_RESOURCE_MIME_TYPE: "text/html;profile=mcp-app";
+export declare const MCP_APP_RESOURCE_URI_PREFIX = "ui://crewx/";
+export type McpAppToolVisibility = 'model' | 'app';
+export type McpAppTone = 'blue' | 'violet' | 'emerald' | 'amber' | 'rose' | 'sky' | 'slate' | 'indigo';
+export declare const MCP_APP_HOST_TOOL_ALLOWLIST: readonly ["crewx_app_terminal_connect"];
+export type McpAppHostToolName = typeof MCP_APP_HOST_TOOL_ALLOWLIST[number];
+export interface McpUiResourceCsp {
+    readonly connectDomains?: readonly string[];
+    readonly resourceDomains?: readonly string[];
+    readonly frameDomains?: readonly string[];
+    readonly baseUriDomains?: readonly string[];
+}
+export type McpAppInputSchema = JsonObject;
+export interface McpAppToolCommonInput {
+    readonly name: string;
+    readonly description: string;
+    readonly inputSchema: McpAppInputSchema;
+    readonly textFallback: string;
+    readonly visibility: readonly McpAppToolVisibility[];
+}
+export interface McpAppReadToolInput extends McpAppToolCommonInput {
+    readonly kind: 'read';
+    readonly actionId?: never;
+}
+export interface McpAppSingleActionToolInput extends McpAppToolCommonInput {
+    readonly kind: 'action';
+    readonly actionId: string;
+    readonly actionIds?: never;
+}
+export interface McpAppActionDispatcherToolInput extends McpAppToolCommonInput {
+    readonly kind: 'action';
+    readonly actionId?: never;
+    readonly actionIds: readonly string[];
+}
+export type McpAppActionToolInput = McpAppSingleActionToolInput | McpAppActionDispatcherToolInput;
+export type McpAppActionToolDescriptor = (Omit<McpAppSingleActionToolInput, 'actionIds'> & {
+    readonly actionIds: readonly string[];
+}) | (Omit<McpAppActionDispatcherToolInput, 'actionId'> & {
+    readonly actionIds: readonly string[];
+});
+type McpAppToolDescriptorMetadata = {
+    readonly resourceUri: string;
+    readonly _meta: McpAppToolMetadata;
+};
+export interface McpAppHostToolInput extends Omit<McpAppToolCommonInput, 'name' | 'visibility'> {
+    readonly name: McpAppHostToolName;
+    readonly kind: 'host';
+    readonly visibility: readonly ['app'];
+    readonly actionId?: never;
+}
+export type McpAppToolInput = McpAppReadToolInput | McpAppActionToolInput | McpAppHostToolInput;
+export interface McpAppDescriptorInput {
+    readonly appId: string;
+    readonly html: string;
+    readonly name?: string;
+    readonly description?: string;
+    readonly icon?: string;
+    readonly tone?: McpAppTone;
+    readonly builtinOnly?: boolean;
+    readonly csp?: McpUiResourceCsp;
+    readonly tools: readonly McpAppToolInput[];
+    readonly definition?: UiDefinition;
+}
+export interface McpAppResource {
+    readonly uri: string;
+    readonly mimeType: typeof MCP_APP_RESOURCE_MIME_TYPE;
+    readonly text: string;
+    readonly _meta?: {
+        readonly ui?: {
+            readonly csp?: McpUiResourceCsp;
+        };
+    };
+}
+export interface McpAppToolMetadata {
+    readonly ui: {
+        readonly resourceUri: string;
+        readonly visibility: readonly McpAppToolVisibility[];
+    };
+}
+export type McpAppToolDescriptor = (McpAppReadToolInput & McpAppToolDescriptorMetadata) | (McpAppActionToolDescriptor & McpAppToolDescriptorMetadata) | (McpAppHostToolInput & McpAppToolDescriptorMetadata);
+export interface McpAppToolRegistration {
+    readonly name: string;
+    readonly description: string;
+    readonly inputSchema: McpAppInputSchema;
+    readonly _meta: McpAppToolMetadata;
+}
+export interface McpAppDescriptor {
+    readonly appId: string;
+    readonly name: string;
+    readonly description: string;
+    readonly icon?: string;
+    readonly tone?: McpAppTone;
+    readonly builtinOnly: boolean;
+    readonly csp?: McpUiResourceCsp;
+    readonly uiUri: string;
+    readonly html: string;
+    readonly definition?: UiDefinition;
+    readonly tools: readonly McpAppToolDescriptor[];
+}
+export interface McpAppToolResult {
+    readonly content: readonly [{
+        readonly type: 'text';
+        readonly text: string;
+    }];
+    readonly structuredContent?: JsonObject;
+    readonly _meta?: JsonObject;
+}
+export interface McpAppButtonInput {
+    readonly id: string;
+    readonly label: string;
+    readonly enabled: boolean;
+    readonly confirmation?: UiActionConfirmation;
+    readonly requiresHumanConfirmation?: boolean;
+    readonly disabledReason?: string;
+    readonly inputSchema: McpAppInputSchema;
+}
+export interface McpAppServerStateInput {
+    readonly source: 'server';
+    readonly instance: Pick<UiInstance, 'id' | 'definition' | 'revision' | 'status' | 'state'>;
+    readonly definition: UiDefinition;
+    readonly buttons: readonly McpAppButtonInput[];
+}
+export interface McpAppButtonDescriptor {
+    readonly id: string;
+    readonly label: string;
+    readonly enabled: boolean;
+    readonly confirmation: UiActionConfirmation;
+    readonly requiresHumanConfirmation?: boolean;
+    readonly disabledReason: string | null;
+    readonly inputSchema: McpAppInputSchema;
+}
+export interface McpAppStateDescriptor {
+    readonly schemaVersion: 1;
+    readonly source: 'server';
+    readonly instanceId: string;
+    readonly definition: UiDefinitionRef;
+    readonly revision: number;
+    readonly status: UiInstanceStatus;
+    readonly state: JsonObject;
+    readonly buttons: readonly McpAppButtonDescriptor[];
+}
+export interface McpAppStateProjections {
+    readonly descriptor: McpAppStateDescriptor;
+    readonly card: McpAppStateDescriptor;
+    readonly developer: {
+        readonly descriptor: McpAppStateDescriptor;
+        readonly json: string;
+    };
+    readonly ai: {
+        readonly descriptor: McpAppStateDescriptor;
+        readonly json: string;
+        readonly xml: string;
+    };
+}
+export interface McpAppRegistry {
+    registerMcpApp(input: McpAppDescriptorInput): McpAppDescriptor;
+    getMcpApp(appId: string): McpAppDescriptor | null;
+    listMcpApps(): readonly McpAppDescriptor[];
+    listMcpAppTools(): readonly McpAppToolDescriptor[];
+    resolveMcpAppTool(toolName: string): McpAppToolDescriptor | null;
+    resolveMcpAppResource(uri: string): McpAppResource | null;
+    requireMcpAppResource(uri: string): McpAppResource;
+}
+export {};

package/dist/migrations/0025_task_heartbeat.sql

@@ -0,0 +1,8 @@
+ALTER TABLE `tasks` ADD `heartbeat_at` text;
+--> statement-breakpoint
+ALTER TABLE `tasks` ADD `stop_requested_at` text;
+--> statement-breakpoint
+ALTER TABLE `tasks` ADD `stop_requested_epoch` integer;
+--> statement-breakpoint
+CREATE INDEX IF NOT EXISTS `idx_tasks_status_heartbeat`
+	ON `tasks` (`status`, `heartbeat_at`);

package/dist/migrations/0025_thread_app_instance_ledger.sql

@@ -0,0 +1,2 @@
+ALTER TABLE `ui_instances` ADD `app_id` text CONSTRAINT "ui_instances_app_id_ck" CHECK("ui_instances"."app_id" IS NULL OR length("ui_instances"."app_id") BETWEEN 1 AND 128);--> statement-breakpoint
+CREATE UNIQUE INDEX IF NOT EXISTS `ui_instances_workspace_thread_app_uq` ON `ui_instances` (`workspace_id`,`thread_id`,`app_id`);

package/dist/migrations/0026_mcp_action_source.sql

@@ -0,0 +1,47 @@
+PRAGMA foreign_keys=OFF;--> statement-breakpoint
+CREATE TABLE `__new_ui_action_receipts` (
+	`id` text PRIMARY KEY NOT NULL,
+	`instance_id` text NOT NULL,
+	`request_id` text NOT NULL,
+	`action_id` text NOT NULL,
+	`actor_json` text NOT NULL,
+	`source` text NOT NULL,
+	`expected_revision` integer NOT NULL,
+	`before_revision` integer NOT NULL,
+	`after_revision` integer,
+	`status` text NOT NULL,
+	`outcome` text,
+	`input_json` text NOT NULL,
+	`result_json` text,
+	`error_code` text,
+	`requested_at` integer NOT NULL,
+	`settled_at` integer,
+	CONSTRAINT "ui_action_receipts_id_ck" CHECK(length("__new_ui_action_receipts"."id") BETWEEN 5 AND 128),
+	CONSTRAINT "ui_action_receipts_instance_id_ck" CHECK(length("__new_ui_action_receipts"."instance_id") BETWEEN 1 AND 128),
+	CONSTRAINT "ui_action_receipts_request_id_ck" CHECK(length("__new_ui_action_receipts"."request_id") BETWEEN 1 AND 128),
+	CONSTRAINT "ui_action_receipts_action_id_ck" CHECK(length("__new_ui_action_receipts"."action_id") BETWEEN 1 AND 128),
+	CONSTRAINT "ui_action_receipts_actor_json_ck" CHECK(json_valid("__new_ui_action_receipts"."actor_json") AND json_type("__new_ui_action_receipts"."actor_json") = 'object'),
+	CONSTRAINT "ui_action_receipts_source_ck" CHECK("__new_ui_action_receipts"."source" IN ('ui_host', 'cli', 'system', 'mcp')),
+	CONSTRAINT "ui_action_receipts_expected_revision_ck" CHECK("__new_ui_action_receipts"."expected_revision" >= 0),
+	CONSTRAINT "ui_action_receipts_before_revision_ck" CHECK("__new_ui_action_receipts"."before_revision" >= 0),
+	CONSTRAINT "ui_action_receipts_after_revision_ck" CHECK("__new_ui_action_receipts"."after_revision" IS NULL OR "__new_ui_action_receipts"."after_revision" >= 0),
+	CONSTRAINT "ui_action_receipts_status_ck" CHECK("__new_ui_action_receipts"."status" IN ('requested', 'settled')),
+	CONSTRAINT "ui_action_receipts_outcome_ck" CHECK("__new_ui_action_receipts"."outcome" IS NULL OR "__new_ui_action_receipts"."outcome" IN ('succeeded', 'rejected', 'failed', 'conflicted', 'expired')),
+	CONSTRAINT "ui_action_receipts_input_json_ck" CHECK(json_valid("__new_ui_action_receipts"."input_json") AND json_type("__new_ui_action_receipts"."input_json") = 'object'),
+	CONSTRAINT "ui_action_receipts_result_json_ck" CHECK("__new_ui_action_receipts"."result_json" IS NULL OR (json_valid("__new_ui_action_receipts"."result_json") AND json_type("__new_ui_action_receipts"."result_json") = 'object')),
+	CONSTRAINT "ui_action_receipts_requested_at_ck" CHECK("__new_ui_action_receipts"."requested_at" >= 0),
+	CONSTRAINT "ui_action_receipts_settled_at_ck" CHECK("__new_ui_action_receipts"."settled_at" IS NULL OR "__new_ui_action_receipts"."settled_at" >= "__new_ui_action_receipts"."requested_at"),
+	CONSTRAINT "ui_action_receipts_status_transition_ck" CHECK((
+        ("__new_ui_action_receipts"."status" = 'requested' AND "__new_ui_action_receipts"."after_revision" IS NULL AND "__new_ui_action_receipts"."outcome" IS NULL AND "__new_ui_action_receipts"."settled_at" IS NULL)
+        OR
+        ("__new_ui_action_receipts"."status" = 'settled' AND "__new_ui_action_receipts"."after_revision" IS NOT NULL AND "__new_ui_action_receipts"."outcome" IS NOT NULL AND "__new_ui_action_receipts"."settled_at" IS NOT NULL)
+      ))
+);
+--> statement-breakpoint
+INSERT INTO `__new_ui_action_receipts`("id", "instance_id", "request_id", "action_id", "actor_json", "source", "expected_revision", "before_revision", "after_revision", "status", "outcome", "input_json", "result_json", "error_code", "requested_at", "settled_at") SELECT "id", "instance_id", "request_id", "action_id", "actor_json", "source", "expected_revision", "before_revision", "after_revision", "status", "outcome", "input_json", "result_json", "error_code", "requested_at", "settled_at" FROM `ui_action_receipts`;--> statement-breakpoint
+DROP TABLE `ui_action_receipts`;--> statement-breakpoint
+ALTER TABLE `__new_ui_action_receipts` RENAME TO `ui_action_receipts`;--> statement-breakpoint
+PRAGMA foreign_keys=ON;--> statement-breakpoint
+CREATE UNIQUE INDEX `ui_action_receipts_instance_request_uq` ON `ui_action_receipts` (`instance_id`,`request_id`);--> statement-breakpoint
+CREATE INDEX `ui_action_receipts_instance_id_idx` ON `ui_action_receipts` (`instance_id`);--> statement-breakpoint
+CREATE INDEX `ui_action_receipts_requested_at_idx` ON `ui_action_receipts` (`requested_at`);

package/dist/migrations/meta/_journal.json

@@ -176,6 +176,27 @@
       "when": 1788604428845,
       "tag": "0024_storage_metadata",
       "breakpoints": true
+    },
+    {
+      "idx": 25,
+      "version": "6",
+      "when": 1788854442066,
+      "tag": "0025_thread_app_instance_ledger",
+      "breakpoints": true
+    },
+    {
+      "idx": 26,
+      "version": "6",
+      "when": 1788944186188,
+      "tag": "0026_mcp_action_source",
+      "breakpoints": true
+    },
+    {
+      "idx": 27,
+      "version": "6",
+      "when": 1789128000000,
+      "tag": "0025_task_heartbeat",
+      "breakpoints": true
     }
   ]
 }

package/dist/plugins/index.d.ts

@@ -1,6 +1,6 @@
 export { FileLoggerPlugin } from './file-logger';
 export type { FileLoggerPluginOptions } from './file-logger';
 export { SqliteTracingPlugin } from './sqlite-tracing';
-export type { SqliteTracingPluginOptions } from './sqlite-tracing';
+export type { SqliteTracingPluginOptions, SqliteTracingRunnerIdentity } from './sqlite-tracing';
 export { ConversationPlugin } from './conversation';
 export type { ConversationPluginOptions } from './conversation';