@crewx/sdk 0.9.0-rc.11 → 0.9.0-rc.110

package/dist/mcp-app/state-set.d.ts

@@ -0,0 +1,9 @@
+import type { UiStateActionHandlerRegistration } from '../ui-instance/types.js';
+import type { UiPluginNormalizedManifestV2 } from '../ui-plugin/types.js';
+export interface StateSetHandlerBuildInput {
+    readonly normalized: UiPluginNormalizedManifestV2;
+    readonly actionId: string;
+}
+export declare function buildStateSetHandler(normalized: UiPluginNormalizedManifestV2, actionId: string): UiStateActionHandlerRegistration | undefined;
+export declare function buildStateSetHandler(input: StateSetHandlerBuildInput): UiStateActionHandlerRegistration | undefined;
+export declare const createStateSetHandler: typeof buildStateSetHandler;

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

@@ -0,0 +1,362 @@
+import type { JsonObject, UiDefinition, UiDefinitionRef, UiDefinitionDisplayMode, UiDefinitionUsage, UiInstance, UiInstanceStatus, UiActionConfirmation, UiActionHandlerRegistration } from '../ui-instance/types.js';
+import type { AppDiscoveryFileSystem } from './discovery.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 declare const MCP_APP_LOCAL_RESOURCE_MIME_TYPE: "text/html";
+export interface McpAppInstanceResourceBinding {
+    readonly kind: 'instance';
+}
+export interface McpAppMcpResourceBinding {
+    readonly kind: 'mcp';
+    readonly uri: string;
+}
+export type McpAppResourceBinding = McpAppInstanceResourceBinding | McpAppMcpResourceBinding;
+export interface McpAppLocalResource {
+    readonly mimeType: typeof MCP_APP_LOCAL_RESOURCE_MIME_TYPE;
+    readonly entryHash: string;
+    readonly html: string;
+    readonly bytes: readonly number[];
+    readonly initialState?: {
+        readonly hash: string;
+        readonly bytes: readonly number[];
+    };
+}
+export interface McpAppLocalRegistrationInput {
+    readonly appId: string;
+    readonly name: string;
+    readonly description: string;
+    readonly icon?: string;
+    readonly tone?: McpAppTone;
+    readonly csp?: McpUiResourceCsp;
+    readonly definition: UiDefinition;
+    readonly html: string;
+    readonly entryHash: string;
+    readonly entryBytes?: readonly number[];
+    readonly initialState?: JsonObject;
+    readonly initialStateHash?: string;
+    readonly initialStateBytes?: readonly number[];
+    readonly readToolName: string;
+    readonly actionToolName?: string;
+    readonly actions: readonly {
+        readonly actionId: string;
+        readonly inputSchema: McpAppInputSchema;
+    }[];
+}
+export interface McpAppLocalReadToolDescriptor extends McpAppToolCommonInput {
+    readonly kind: 'read';
+    readonly resourceBinding: McpAppInstanceResourceBinding;
+    readonly actionIds?: never;
+}
+export interface McpAppLocalActionToolDescriptor extends McpAppToolCommonInput {
+    readonly kind: 'action';
+    readonly resourceBinding: McpAppInstanceResourceBinding;
+    readonly actionIds: readonly string[];
+}
+export type McpAppLocalToolDescriptor = McpAppLocalReadToolDescriptor | McpAppLocalActionToolDescriptor;
+export interface McpAppLocalRegistration {
+    readonly appId: string;
+    readonly name: string;
+    readonly description: string;
+    readonly icon?: string;
+    readonly tone?: McpAppTone;
+    readonly builtinOnly: false;
+    readonly definition: UiDefinition;
+    readonly resourceBinding: McpAppInstanceResourceBinding;
+    readonly resource: McpAppLocalResource;
+    readonly tools: readonly McpAppLocalToolDescriptor[];
+}
+export interface McpAppBuiltinRegistration {
+    readonly appId: string;
+    readonly name: string;
+    readonly description: string;
+    readonly icon?: string;
+    readonly tone?: McpAppTone;
+    readonly builtinOnly: boolean;
+    readonly uiUri: string;
+    readonly definition?: UiDefinition;
+    readonly resourceBinding: McpAppMcpResourceBinding;
+    readonly resource: McpAppResource;
+    readonly tools: readonly McpAppToolDescriptor[];
+    readonly descriptor: McpAppDescriptor;
+}
+export type McpAppResolvedRegistration = McpAppLocalRegistration | McpAppBuiltinRegistration;
+export interface McpAppLocalLauncher {
+    readonly appId: string;
+    readonly name: string;
+    readonly description: string;
+    readonly icon?: string;
+    readonly tone?: McpAppTone;
+    readonly builtinOnly: false;
+    readonly definition: UiDefinitionRef;
+    readonly entryHash: string;
+    readonly resourceBinding: McpAppInstanceResourceBinding;
+    readonly tools: readonly McpAppLocalToolDescriptor[];
+}
+export interface McpAppBuiltinLauncher {
+    readonly appId: string;
+    readonly name: string;
+    readonly description: string;
+    readonly icon?: string;
+    readonly tone?: McpAppTone;
+    readonly builtinOnly: boolean;
+    readonly uiUri: string;
+    readonly definition?: UiDefinitionRef;
+    readonly resourceBinding: McpAppMcpResourceBinding;
+    readonly tools: readonly McpAppToolDescriptor[];
+}
+export type McpAppLauncher = McpAppLocalLauncher | McpAppBuiltinLauncher;
+export type WorkspaceAppLauncher = McpAppLauncher;
+export type WorkspaceAppResolvedRegistration = McpAppResolvedRegistration;
+export interface McpAppWorkspaceRegistry {
+    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;
+    listLocalMcpApps(): readonly McpAppLocalRegistration[];
+    getLocalMcpApp(appId: string): McpAppLocalRegistration | null;
+    listLocalMcpAppTools(): readonly McpAppLocalToolDescriptor[];
+    resolveLocalMcpAppTool(toolName: string): McpAppLocalToolDescriptor | null;
+    resolveLocalMcpAppResource(appId: string, definitionHash?: string): McpAppLocalResource | null;
+    listRegistrations(): readonly McpAppResolvedRegistration[];
+    getRegistration(appId: string): McpAppResolvedRegistration | null;
+    listLaunchers(): readonly McpAppLauncher[];
+    getLauncher(appId: string): McpAppLauncher | null;
+    resolveDefinition(ref: UiDefinitionRef): UiDefinition | null;
+    resolveActionHandler(definitionId: string, version: number, actionId: string): UiActionHandlerRegistration | null;
+}
+export type WorkspaceAppRegistry = McpAppWorkspaceRegistry;
+export interface McpAppWorkspaceRegistryInput {
+    readonly builtins?: McpAppRegistry;
+    readonly builtin?: McpAppRegistry;
+    readonly localApps?: readonly McpAppLocalRegistration[];
+    readonly locals?: readonly McpAppLocalRegistration[];
+    readonly definitions?: readonly UiDefinition[];
+    readonly handlers?: readonly UiActionHandlerRegistration[];
+}
+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 type CrewxAppCapability = 'screen' | 'skill';
+export type CrewxAppOrigin = 'local' | 'installed' | 'builtin';
+export type CrewxAppOwnership = 'mine' | 'external' | 'unknown';
+export type CrewxAppShareability = 'shareable' | 'requiresPublish' | 'forbidden' | 'unknown';
+export type CrewxAppSharingAvailability = 'ready' | 'loginRequired' | 'unavailable';
+export interface CrewxAppLocalDefinitionRef {
+    readonly packageRoot: string;
+}
+export interface CrewxAppDefinitionSummary extends UiDefinitionRef {
+    readonly usage: UiDefinitionUsage;
+    readonly detailPanel?: boolean;
+    readonly displayModes?: readonly UiDefinitionDisplayMode[];
+}
+export interface CrewxAppDefinitionHashInput {
+    readonly screenHash?: string;
+    readonly skillHash?: string;
+    readonly relativePath?: string;
+    readonly fileBytes?: Uint8Array | ArrayBuffer | readonly number[] | string;
+}
+export interface CrewxAppSummary {
+    readonly appId: string;
+    readonly name: string;
+    readonly description: string;
+    readonly version?: string;
+    readonly capabilities: readonly CrewxAppCapability[];
+    readonly definition?: CrewxAppDefinitionSummary;
+    readonly skillName?: string;
+    readonly localDefinitionRef?: CrewxAppLocalDefinitionRef;
+    readonly origin: CrewxAppOrigin;
+    readonly ownership: CrewxAppOwnership;
+    readonly shareability: CrewxAppShareability;
+    readonly sharingAvailability: CrewxAppSharingAvailability;
+    readonly marketplaceContentId?: string;
+    readonly slug?: string;
+    readonly definitionHash: string;
+}
+export type CrewxAppDiagnosticCode = 'MANIFEST_MISSING' | 'MANIFEST_INVALID' | 'ENTRY_INVALID' | 'INITIAL_STATE_INVALID' | 'DUPLICATE_ID' | 'RESERVED_ID' | 'PATH_ESCAPED' | 'LIMIT_EXCEEDED' | 'EXEC_DENIED' | 'SKILL_INVALID' | 'SKILL_READ_FAILED' | 'INSTALLED_MISSING' | 'INSTALLED_CONTENT_ID_MISSING' | 'INSTALLED_IDENTITY_MISMATCH' | 'BUILTIN_INVALID';
+export type CrewxAppDiagnosticSource = 'apps' | 'skills' | 'node_modules' | 'builtin' | 'installed';
+export interface CrewxAppDiagnostic {
+    readonly code: CrewxAppDiagnosticCode;
+    readonly source: CrewxAppDiagnosticSource;
+    readonly relativePath: string;
+    readonly appId?: string;
+}
+export interface CrewxAppInstalledProjection {
+    readonly packageRoot?: string;
+    readonly relativePath?: string;
+    readonly packageRootPath?: string;
+    readonly appId?: string;
+    readonly definitionHash?: string;
+    readonly marketplaceContentId?: string;
+    readonly slug?: string;
+}
+export type CrewxAppBuiltinCatalog = Pick<McpAppRegistry, 'listMcpApps' | 'listMcpAppTools'>;
+export interface CrewxAppCatalogOptions {
+    readonly filesystem?: AppDiscoveryFileSystem;
+    readonly builtinCatalog?: CrewxAppBuiltinCatalog;
+    readonly installed?: readonly CrewxAppInstalledProjection[];
+}
+export interface CrewxAppCatalogResult {
+    readonly items: readonly CrewxAppSummary[];
+    readonly diagnostics: readonly CrewxAppDiagnostic[];
+}
+export {};

package/dist/mcp-app/workspace-snapshot.d.ts

@@ -0,0 +1,53 @@
+import { type AppDiscoveryFileSystem, type WorkspaceAppDiagnostic, type WorkspaceAppDiscoveryOptions, type WorkspaceAppDiscoveryResult } from './discovery.js';
+import type { JsonObject, UiActionHandlerRegistration, UiDefinition, UiDefinitionRef } from '../ui-instance/types.js';
+import type { McpAppLauncher, McpAppLocalResource, McpAppRegistry, McpAppWorkspaceRegistry } from './types.js';
+export interface WorkspaceAppSnapshotResource extends McpAppLocalResource {
+    readonly appId: string;
+    readonly definition: UiDefinitionRef;
+}
+export interface WorkspaceAppSnapshotInitialState {
+    readonly appId: string;
+    readonly definition: UiDefinitionRef;
+    readonly hash: string;
+    readonly bytes: readonly number[];
+    readonly state: JsonObject;
+}
+export type WorkspaceAppInitialState = WorkspaceAppSnapshotInitialState;
+export interface WorkspaceAppSnapshotBuildOptions {
+    readonly builtins?: McpAppRegistry;
+    readonly builtin?: McpAppRegistry;
+    readonly registry?: McpAppRegistry;
+}
+export type WorkspaceAppSnapshotOptions = WorkspaceAppDiscoveryOptions & WorkspaceAppSnapshotBuildOptions;
+export interface WorkspaceAppSnapshot {
+    readonly snapshotHash: string;
+    readonly launchers: readonly McpAppLauncher[];
+    readonly definitions: readonly UiDefinition[];
+    readonly actionHandlers: readonly UiActionHandlerRegistration[];
+    readonly resources: readonly WorkspaceAppSnapshotResource[];
+    readonly initialStates: readonly WorkspaceAppSnapshotInitialState[];
+    readonly diagnostics: readonly WorkspaceAppDiagnostic[];
+    readonly registry: McpAppWorkspaceRegistry;
+    resolveDefinition(ref: UiDefinitionRef): UiDefinition | null;
+    resolveActionHandler(definitionId: string, version: number, actionId: string): UiActionHandlerRegistration | null;
+    resolveResource(appId: string, definitionHash?: string): WorkspaceAppSnapshotResource | null;
+}
+export type WorkspaceAppSnapshotReconfirmResult = {
+    readonly kind: 'same_generation';
+    readonly snapshot: WorkspaceAppSnapshot;
+    readonly diagnostics: readonly WorkspaceAppDiagnostic[];
+} | {
+    readonly kind: 'new_generation';
+    readonly previousSnapshot: WorkspaceAppSnapshot;
+    readonly snapshot: WorkspaceAppSnapshot;
+    readonly diagnostics: readonly WorkspaceAppDiagnostic[];
+} | {
+    readonly kind: 'io_error';
+    readonly snapshot: WorkspaceAppSnapshot;
+    readonly diagnostics: readonly WorkspaceAppDiagnostic[];
+};
+export declare function buildWorkspaceAppSnapshot(discovery: WorkspaceAppDiscoveryResult, options?: WorkspaceAppSnapshotBuildOptions): WorkspaceAppSnapshot;
+export declare function discoverWorkspaceAppSnapshot(workspaceRoot: string, options?: WorkspaceAppSnapshotOptions): Promise<WorkspaceAppSnapshot>;
+export declare function discoverWorkspaceAppSnapshot(workspaceRoot: string, filesystem: AppDiscoveryFileSystem, options?: WorkspaceAppSnapshotOptions): Promise<WorkspaceAppSnapshot>;
+export declare function reconfirmWorkspaceAppSnapshot(workspaceRoot: string, currentSnapshot: WorkspaceAppSnapshot, options?: WorkspaceAppSnapshotOptions): Promise<WorkspaceAppSnapshotReconfirmResult>;
+export declare function reconfirmWorkspaceAppSnapshot(workspaceRoot: string, currentSnapshot: WorkspaceAppSnapshot, filesystem: AppDiscoveryFileSystem, options?: WorkspaceAppSnapshotOptions): Promise<WorkspaceAppSnapshotReconfirmResult>;

package/dist/migrations/0008_careful_black_bird.sql

@@ -0,0 +1,17 @@
+CREATE TABLE IF NOT EXISTS `usage_reports` (
+	`id` text PRIMARY KEY NOT NULL,
+	`workspace_id` text NOT NULL,
+	`month` text NOT NULL,
+	`generated_at` text NOT NULL,
+	`source_range` text NOT NULL,
+	`tier` text NOT NULL,
+	`total_tokens` integer NOT NULL,
+	`total_cost_usd` real NOT NULL,
+	`payload` text NOT NULL,
+	`payload_hash` text,
+	`signature` text,
+	`signed_at` text,
+	`issuer` text
+);
+--> statement-breakpoint
+CREATE UNIQUE INDEX IF NOT EXISTS `uniq_usage_reports_ws_month` ON `usage_reports` (`workspace_id`,`month`);

package/dist/migrations/0009_hot_dark_phoenix.sql

@@ -0,0 +1 @@
+CREATE INDEX IF NOT EXISTS `idx_threads_ws_updated` ON `threads` (`workspace_id`,`updated_at`);

package/dist/migrations/0010_analyze_stats.sql

@@ -0,0 +1,6 @@
+-- Custom SQL migration file, put your code below! --
+-- WI-20260706-006: seed sqlite_stat1 so the query planner has index
+-- selectivity data from the very first run on a fresh DB (idempotent).
+PRAGMA analysis_limit = 400;
+--> statement-breakpoint
+ANALYZE;

package/dist/migrations/0011_far_black_tarantula.sql

@@ -0,0 +1 @@
+CREATE INDEX IF NOT EXISTS `idx_threads_title` ON `threads` (`title`);

package/dist/migrations/0012_blue_turbo.sql

@@ -0,0 +1,23 @@
+CREATE TABLE IF NOT EXISTS `notification_reads` (
+	`notification_id` text NOT NULL,
+	`user_id` text NOT NULL,
+	`read_at` text NOT NULL,
+	PRIMARY KEY(`notification_id`, `user_id`)
+);
+--> statement-breakpoint
+CREATE TABLE IF NOT EXISTS `notifications` (
+	`id` text PRIMARY KEY NOT NULL,
+	`workspace_id` text NOT NULL,
+	`agent_id` text,
+	`task_id` text,
+	`thread_id` text,
+	`source` text DEFAULT 'agent' NOT NULL,
+	`level` text DEFAULT 'info' NOT NULL,
+	`title` text NOT NULL,
+	`body` text,
+	`target_user_id` text,
+	`created_at` text NOT NULL,
+	`metadata` text
+);
+--> statement-breakpoint
+CREATE INDEX IF NOT EXISTS `idx_notifications_ws_created` ON `notifications` (`workspace_id`,"created_at" DESC);

package/dist/migrations/0013_hesitant_adam_destine.sql

@@ -0,0 +1,15 @@
+CREATE TABLE IF NOT EXISTS `agent_suggestions` (
+	`id` text PRIMARY KEY NOT NULL,
+	`workspace_id` text NOT NULL,
+	`agent_id` text NOT NULL,
+	`task_id` text,
+	`type` text NOT NULL,
+	`status` text DEFAULT 'pending' NOT NULL,
+	`payload` text NOT NULL,
+	`applied_commit_sha` text,
+	`created_at` text NOT NULL,
+	`updated_at` text NOT NULL
+);
+--> statement-breakpoint
+CREATE INDEX IF NOT EXISTS `idx_agent_suggestions_ws_agent` ON `agent_suggestions` (`workspace_id`,`agent_id`);--> statement-breakpoint
+CREATE INDEX IF NOT EXISTS `idx_agent_suggestions_ws_created` ON `agent_suggestions` (`workspace_id`,`created_at`);

package/dist/migrations/0014_organic_mongu.sql

@@ -0,0 +1,73 @@
+CREATE TABLE IF NOT EXISTS `ui_instances` (
+	`id` text PRIMARY KEY NOT NULL,
+	`definition_id` text NOT NULL,
+	`definition_version` integer NOT NULL,
+	`definition_hash` text NOT NULL,
+	`workspace_id` text NOT NULL,
+	`thread_id` text NOT NULL,
+	`anchor_task_id` text,
+	`domain_ref_json` text NOT NULL,
+	`state_json` text NOT NULL,
+	`revision` integer DEFAULT 0 NOT NULL,
+	`status` text DEFAULT 'active' NOT NULL,
+	`granted_capabilities_json` text DEFAULT '[]' NOT NULL,
+	`created_at` integer NOT NULL,
+	`updated_at` integer NOT NULL,
+	CONSTRAINT "ui_instances_id_ck" CHECK(length("ui_instances"."id") BETWEEN 5 AND 128 AND "ui_instances"."id" GLOB 'uic_*'),
+	CONSTRAINT "ui_instances_definition_id_ck" CHECK(length("ui_instances"."definition_id") BETWEEN 1 AND 128),
+	CONSTRAINT "ui_instances_definition_version_ck" CHECK("ui_instances"."definition_version" >= 1),
+	CONSTRAINT "ui_instances_definition_hash_ck" CHECK(length("ui_instances"."definition_hash") = 64 AND "ui_instances"."definition_hash" NOT GLOB '*[^0-9a-f]*'),
+	CONSTRAINT "ui_instances_workspace_id_ck" CHECK(length("ui_instances"."workspace_id") BETWEEN 1 AND 256),
+	CONSTRAINT "ui_instances_thread_id_ck" CHECK(length("ui_instances"."thread_id") BETWEEN 1 AND 256),
+	CONSTRAINT "ui_instances_domain_ref_json_ck" CHECK(json_valid("ui_instances"."domain_ref_json") AND json_type("ui_instances"."domain_ref_json") = 'object'),
+	CONSTRAINT "ui_instances_state_json_ck" CHECK(json_valid("ui_instances"."state_json") AND json_type("ui_instances"."state_json") = 'object'),
+	CONSTRAINT "ui_instances_revision_ck" CHECK("ui_instances"."revision" >= 0),
+	CONSTRAINT "ui_instances_status_ck" CHECK("ui_instances"."status" IN ('active', 'completed', 'expired', 'revoked', 'unsupported')),
+	CONSTRAINT "ui_instances_granted_capabilities_json_ck" CHECK(json_valid("ui_instances"."granted_capabilities_json") AND json_type("ui_instances"."granted_capabilities_json") = 'array'),
+	CONSTRAINT "ui_instances_created_at_ck" CHECK("ui_instances"."created_at" >= 0),
+	CONSTRAINT "ui_instances_updated_at_ck" CHECK("ui_instances"."updated_at" >= "ui_instances"."created_at")
+);
+--> statement-breakpoint
+CREATE INDEX IF NOT EXISTS `ui_instances_workspace_thread_idx` ON `ui_instances` (`workspace_id`,`thread_id`);--> statement-breakpoint
+CREATE TABLE IF NOT EXISTS `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("ui_action_receipts"."id") BETWEEN 5 AND 128),
+	CONSTRAINT "ui_action_receipts_instance_id_ck" CHECK(length("ui_action_receipts"."instance_id") BETWEEN 1 AND 128),
+	CONSTRAINT "ui_action_receipts_request_id_ck" CHECK(length("ui_action_receipts"."request_id") BETWEEN 1 AND 128),
+	CONSTRAINT "ui_action_receipts_action_id_ck" CHECK(length("ui_action_receipts"."action_id") BETWEEN 1 AND 128),
+	CONSTRAINT "ui_action_receipts_actor_json_ck" CHECK(json_valid("ui_action_receipts"."actor_json") AND json_type("ui_action_receipts"."actor_json") = 'object'),
+	CONSTRAINT "ui_action_receipts_source_ck" CHECK("ui_action_receipts"."source" IN ('ui_host', 'cli', 'system')),
+	CONSTRAINT "ui_action_receipts_expected_revision_ck" CHECK("ui_action_receipts"."expected_revision" >= 0),
+	CONSTRAINT "ui_action_receipts_before_revision_ck" CHECK("ui_action_receipts"."before_revision" >= 0),
+	CONSTRAINT "ui_action_receipts_after_revision_ck" CHECK("ui_action_receipts"."after_revision" IS NULL OR "ui_action_receipts"."after_revision" >= 0),
+	CONSTRAINT "ui_action_receipts_status_ck" CHECK("ui_action_receipts"."status" IN ('requested', 'settled')),
+	CONSTRAINT "ui_action_receipts_outcome_ck" CHECK("ui_action_receipts"."outcome" IS NULL OR "ui_action_receipts"."outcome" IN ('succeeded', 'rejected', 'failed', 'conflicted', 'expired')),
+	CONSTRAINT "ui_action_receipts_input_json_ck" CHECK(json_valid("ui_action_receipts"."input_json") AND json_type("ui_action_receipts"."input_json") = 'object'),
+	CONSTRAINT "ui_action_receipts_result_json_ck" CHECK("ui_action_receipts"."result_json" IS NULL OR (json_valid("ui_action_receipts"."result_json") AND json_type("ui_action_receipts"."result_json") = 'object')),
+	CONSTRAINT "ui_action_receipts_requested_at_ck" CHECK("ui_action_receipts"."requested_at" >= 0),
+	CONSTRAINT "ui_action_receipts_settled_at_ck" CHECK("ui_action_receipts"."settled_at" IS NULL OR "ui_action_receipts"."settled_at" >= "ui_action_receipts"."requested_at"),
+	CONSTRAINT "ui_action_receipts_status_transition_ck" CHECK((
+        ("ui_action_receipts"."status" = 'requested' AND "ui_action_receipts"."after_revision" IS NULL AND "ui_action_receipts"."outcome" IS NULL AND "ui_action_receipts"."settled_at" IS NULL)
+        OR
+        ("ui_action_receipts"."status" = 'settled' AND "ui_action_receipts"."after_revision" IS NOT NULL AND "ui_action_receipts"."outcome" IS NOT NULL AND "ui_action_receipts"."settled_at" IS NOT NULL)
+      ))
+);
+--> statement-breakpoint
+CREATE UNIQUE INDEX IF NOT EXISTS `ui_action_receipts_instance_request_uq` ON `ui_action_receipts` (`instance_id`,`request_id`);--> statement-breakpoint
+CREATE INDEX IF NOT EXISTS `ui_action_receipts_instance_id_idx` ON `ui_action_receipts` (`instance_id`);--> statement-breakpoint
+CREATE INDEX IF NOT EXISTS `ui_action_receipts_requested_at_idx` ON `ui_action_receipts` (`requested_at`);

package/dist/migrations/0015_panoramic_gorilla_man.sql

@@ -0,0 +1,71 @@
+CREATE TABLE IF NOT EXISTS `project_criteria` (
+	`id` text PRIMARY KEY NOT NULL,
+	`project_id` text NOT NULL,
+	`position` integer NOT NULL,
+	`statement` text NOT NULL,
+	`verify_status` text DEFAULT 'pending' NOT NULL,
+	`verified_at` text,
+	`evidence_json` text DEFAULT '[]' NOT NULL,
+	`created_at` text NOT NULL,
+	`updated_at` text NOT NULL,
+	FOREIGN KEY (`project_id`) REFERENCES `projects`(`id`) ON UPDATE no action ON DELETE cascade,
+	CONSTRAINT "project_criteria_id_ck" CHECK("project_criteria"."id" GLOB 'pjc_*'),
+	CONSTRAINT "project_criteria_verify_status_ck" CHECK("project_criteria"."verify_status" IN ('pending', 'verifying', 'passed', 'failed')),
+	CONSTRAINT "project_criteria_evidence_json_ck" CHECK(json_valid("project_criteria"."evidence_json") AND json_type("project_criteria"."evidence_json") = 'array')
+);
+--> statement-breakpoint
+CREATE UNIQUE INDEX IF NOT EXISTS `project_criteria_project_position_uq` ON `project_criteria` (`project_id`,`position`);--> statement-breakpoint
+CREATE TABLE IF NOT EXISTS `project_events` (
+	`id` text PRIMARY KEY NOT NULL,
+	`project_id` text NOT NULL,
+	`seq` integer NOT NULL,
+	`actor_type` text NOT NULL,
+	`actor_id` text,
+	`type` text NOT NULL,
+	`title` text NOT NULL,
+	`summary` text,
+	`payload_json` text DEFAULT '{}' NOT NULL,
+	`created_at` text NOT NULL,
+	FOREIGN KEY (`project_id`) REFERENCES `projects`(`id`) ON UPDATE no action ON DELETE restrict,
+	CONSTRAINT "project_events_id_ck" CHECK("project_events"."id" GLOB 'pje_*'),
+	CONSTRAINT "project_events_actor_type_ck" CHECK("project_events"."actor_type" IN ('user', 'project_manager', 'system')),
+	CONSTRAINT "project_events_payload_json_ck" CHECK(json_valid("project_events"."payload_json") AND json_type("project_events"."payload_json") = 'object')
+);
+--> statement-breakpoint
+CREATE UNIQUE INDEX IF NOT EXISTS `project_events_project_seq_uq` ON `project_events` (`project_id`,`seq`);--> statement-breakpoint
+CREATE TABLE IF NOT EXISTS `projects` (
+	`id` text PRIMARY KEY NOT NULL,
+	`workspace_id` text NOT NULL,
+	`name` text NOT NULL,
+	`outcome` text NOT NULL,
+	`due_date` text,
+	`scene` text DEFAULT 'planning' NOT NULL,
+	`stages_json` text NOT NULL,
+	`stage_index` integer NOT NULL,
+	`created_at` text NOT NULL,
+	`updated_at` text NOT NULL,
+	`accepted_at` text,
+	`archived_at` text,
+	CONSTRAINT "projects_id_ck" CHECK("projects"."id" GLOB 'prj_*'),
+	CONSTRAINT "projects_scene_ck" CHECK("projects"."scene" IN ('planning', 'plan_review', 'running', 'human_wait', 'limit_wait', 'failed_stop', 'analyzing_feedback', 'replanned', 'awaiting_review', 'accepted')),
+	CONSTRAINT "projects_stages_json_ck" CHECK(json_valid("projects"."stages_json") AND json_type("projects"."stages_json") = 'array'),
+	CONSTRAINT "projects_stage_index_ck" CHECK("projects"."stage_index" >= 1)
+);
+--> statement-breakpoint
+CREATE TRIGGER IF NOT EXISTS project_events_no_update
+BEFORE UPDATE ON project_events
+BEGIN
+  SELECT RAISE(ABORT, 'project_events is append-only');
+END;
+--> statement-breakpoint
+CREATE TRIGGER IF NOT EXISTS project_events_no_delete
+BEFORE DELETE ON project_events
+BEGIN
+  SELECT RAISE(ABORT, 'project_events is append-only');
+END;
+--> statement-breakpoint
+UPDATE tasks
+SET project_id = NULL
+WHERE id = 'task_1773657200590_gu3z335oy'
+  AND project_id = '9c899c8b05f8d8d8d1df6d904c0a7fa8e5c95f1cb81602423c1e508f8b77d1dc'
+  AND workspace_id = '9c899c8b05f8d8d8d1df6d904c0a7fa8e5c95f1cb81602423c1e508f8b77d1dc';

package/dist/migrations/0016_fuzzy_hemingway.sql

@@ -0,0 +1,14 @@
+CREATE TABLE IF NOT EXISTS `task_log_events` (
+	`id` integer PRIMARY KEY NOT NULL,
+	`task_id` text NOT NULL,
+	`seq` integer NOT NULL,
+	`timestamp` text NOT NULL,
+	`level` text NOT NULL,
+	`message` text NOT NULL,
+	FOREIGN KEY (`task_id`) REFERENCES `tasks`(`id`) ON UPDATE no action ON DELETE cascade
+);
+--> statement-breakpoint
+CREATE UNIQUE INDEX IF NOT EXISTS `task_log_events_task_seq_uq` ON `task_log_events` (`task_id`,`seq`);--> statement-breakpoint
+ALTER TABLE `tasks` ADD `log_storage` text DEFAULT 'blob' NOT NULL CONSTRAINT "tasks_log_storage_ck" CHECK("tasks"."log_storage" IN ('blob', 'events'));--> statement-breakpoint
+ALTER TABLE `tasks` ADD `last_log_seq` integer DEFAULT 0 NOT NULL;--> statement-breakpoint
+ALTER TABLE `tasks` ADD `log_revision` integer DEFAULT 0 NOT NULL;