@crewx/sdk 0.9.0-rc.30 → 0.9.0-rc.32

package/dist/schema/agent-suggestions.d.ts

@@ -0,0 +1,199 @@
+export declare const agent_suggestions: import("drizzle-orm/sqlite-core").SQLiteTableWithColumns<{
+    name: "agent_suggestions";
+    schema: undefined;
+    columns: {
+        id: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+            name: "id";
+            tableName: "agent_suggestions";
+            dataType: "string";
+            columnType: "SQLiteText";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: true;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {
+            length: number | undefined;
+        }>;
+        workspace_id: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+            name: "workspace_id";
+            tableName: "agent_suggestions";
+            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;
+        }>;
+        agent_id: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+            name: "agent_id";
+            tableName: "agent_suggestions";
+            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;
+        }>;
+        task_id: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+            name: "task_id";
+            tableName: "agent_suggestions";
+            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;
+        }>;
+        type: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+            name: "type";
+            tableName: "agent_suggestions";
+            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;
+        }>;
+        status: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+            name: "status";
+            tableName: "agent_suggestions";
+            dataType: "string";
+            columnType: "SQLiteText";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: true;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {
+            length: number | undefined;
+        }>;
+        payload: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+            name: "payload";
+            tableName: "agent_suggestions";
+            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;
+        }>;
+        applied_commit_sha: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+            name: "applied_commit_sha";
+            tableName: "agent_suggestions";
+            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;
+        }>;
+        created_at: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+            name: "created_at";
+            tableName: "agent_suggestions";
+            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;
+        }>;
+        updated_at: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+            name: "updated_at";
+            tableName: "agent_suggestions";
+            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";
+}>;
+export type AgentSuggestion = typeof agent_suggestions.$inferSelect;
+export type NewAgentSuggestion = typeof agent_suggestions.$inferInsert;

package/dist/schema/index.d.ts

@@ -7,3 +7,5 @@ export * from './thread-boxes.js';
 export * from './request-logs.js';
 export * from './usage-limit-snapshots.js';
 export * from './usage-reports.js';
+export * from './notifications.js';
+export * from './agent-suggestions.js';

package/dist/schema/notifications.d.ts

@@ -0,0 +1,303 @@
+export declare const notifications: import("drizzle-orm/sqlite-core").SQLiteTableWithColumns<{
+    name: "notifications";
+    schema: undefined;
+    columns: {
+        id: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+            name: "id";
+            tableName: "notifications";
+            dataType: "string";
+            columnType: "SQLiteText";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: true;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {
+            length: number | undefined;
+        }>;
+        workspace_id: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+            name: "workspace_id";
+            tableName: "notifications";
+            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;
+        }>;
+        agent_id: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+            name: "agent_id";
+            tableName: "notifications";
+            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;
+        }>;
+        task_id: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+            name: "task_id";
+            tableName: "notifications";
+            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;
+        }>;
+        thread_id: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+            name: "thread_id";
+            tableName: "notifications";
+            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;
+        }>;
+        source: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+            name: "source";
+            tableName: "notifications";
+            dataType: "string";
+            columnType: "SQLiteText";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: true;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {
+            length: number | undefined;
+        }>;
+        level: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+            name: "level";
+            tableName: "notifications";
+            dataType: "string";
+            columnType: "SQLiteText";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: true;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {
+            length: number | undefined;
+        }>;
+        title: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+            name: "title";
+            tableName: "notifications";
+            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;
+        }>;
+        body: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+            name: "body";
+            tableName: "notifications";
+            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;
+        }>;
+        target_user_id: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+            name: "target_user_id";
+            tableName: "notifications";
+            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;
+        }>;
+        created_at: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+            name: "created_at";
+            tableName: "notifications";
+            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;
+        }>;
+        metadata: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+            name: "metadata";
+            tableName: "notifications";
+            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;
+        }>;
+    };
+    dialect: "sqlite";
+}>;
+export declare const notification_reads: import("drizzle-orm/sqlite-core").SQLiteTableWithColumns<{
+    name: "notification_reads";
+    schema: undefined;
+    columns: {
+        notification_id: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+            name: "notification_id";
+            tableName: "notification_reads";
+            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;
+        }>;
+        user_id: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+            name: "user_id";
+            tableName: "notification_reads";
+            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;
+        }>;
+        read_at: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+            name: "read_at";
+            tableName: "notification_reads";
+            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";
+}>;
+export type Notification = typeof notifications.$inferSelect;
+export type NewNotification = typeof notifications.$inferInsert;
+export type NotificationRead = typeof notification_reads.$inferSelect;
+export type NewNotificationRead = typeof notification_reads.$inferInsert;

package/dist/types/index.d.ts

@@ -397,6 +397,13 @@ export interface GuideRule {
     say: string;
     once?: boolean;
 }
+export declare const SettingsSchema: z.ZodObject<{
+    bin_resolution: z.ZodOptional<z.ZodEnum<["global_first", "local_first"]>>;
+}, "strip", z.ZodUnknown, z.objectOutputType<{
+    bin_resolution: z.ZodOptional<z.ZodEnum<["global_first", "local_first"]>>;
+}, z.ZodUnknown, "strip">, z.objectInputType<{
+    bin_resolution: z.ZodOptional<z.ZodEnum<["global_first", "local_first"]>>;
+}, z.ZodUnknown, "strip">>;
 export declare const CrewxProjectConfigSchema: z.ZodObject<{
     agents: z.ZodOptional<z.ZodArray<z.ZodObject<{
         id: z.ZodString;
@@ -685,7 +692,13 @@ export declare const CrewxProjectConfigSchema: z.ZodObject<{
         }>>;
     }, z.ZodUnknown, "strip">>, "many">>;
     hooks: z.ZodOptional<z.ZodArray<z.ZodUnknown, "many">>;
-    settings: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    settings: z.ZodOptional<z.ZodObject<{
+        bin_resolution: z.ZodOptional<z.ZodEnum<["global_first", "local_first"]>>;
+    }, "strip", z.ZodUnknown, z.objectOutputType<{
+        bin_resolution: z.ZodOptional<z.ZodEnum<["global_first", "local_first"]>>;
+    }, z.ZodUnknown, "strip">, z.objectInputType<{
+        bin_resolution: z.ZodOptional<z.ZodEnum<["global_first", "local_first"]>>;
+    }, z.ZodUnknown, "strip">>>;
     skills: z.ZodOptional<z.ZodUnknown>;
     layouts: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
     documents: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
@@ -977,7 +990,13 @@ export declare const CrewxProjectConfigSchema: z.ZodObject<{
         }>>;
     }, z.ZodUnknown, "strip">>, "many">>;
     hooks: z.ZodOptional<z.ZodArray<z.ZodUnknown, "many">>;
-    settings: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    settings: z.ZodOptional<z.ZodObject<{
+        bin_resolution: z.ZodOptional<z.ZodEnum<["global_first", "local_first"]>>;
+    }, "strip", z.ZodUnknown, z.objectOutputType<{
+        bin_resolution: z.ZodOptional<z.ZodEnum<["global_first", "local_first"]>>;
+    }, z.ZodUnknown, "strip">, z.objectInputType<{
+        bin_resolution: z.ZodOptional<z.ZodEnum<["global_first", "local_first"]>>;
+    }, z.ZodUnknown, "strip">>>;
     skills: z.ZodOptional<z.ZodUnknown>;
     layouts: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
     documents: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
@@ -1269,7 +1288,13 @@ export declare const CrewxProjectConfigSchema: z.ZodObject<{
         }>>;
     }, z.ZodUnknown, "strip">>, "many">>;
     hooks: z.ZodOptional<z.ZodArray<z.ZodUnknown, "many">>;
-    settings: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    settings: z.ZodOptional<z.ZodObject<{
+        bin_resolution: z.ZodOptional<z.ZodEnum<["global_first", "local_first"]>>;
+    }, "strip", z.ZodUnknown, z.objectOutputType<{
+        bin_resolution: z.ZodOptional<z.ZodEnum<["global_first", "local_first"]>>;
+    }, z.ZodUnknown, "strip">, z.objectInputType<{
+        bin_resolution: z.ZodOptional<z.ZodEnum<["global_first", "local_first"]>>;
+    }, z.ZodUnknown, "strip">>>;
     skills: z.ZodOptional<z.ZodUnknown>;
     layouts: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
     documents: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;

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

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

package/templates/agents/default.yaml

@@ -128,6 +128,26 @@ layouts:
           </cli_options>
           {{/if}}
         </session>
+
+        <delegation_lifecycle>
+          You are running as a SINGLE-SHOT CLI process (print mode). There is no next turn:
+          - The moment you emit your final answer, this process exits and every child
+            process it spawned — including backgrounded Bash commands — is killed (SIGTERM).
+          - Harness messages like "running in the background" or "you will be notified
+            when it completes" are NOT true in this mode. That notification will never
+            arrive; trusting it silently kills the delegated work.
+
+          Rules for delegation and long-running commands:
+          - Run delegations (npx crewx q / npx crewx x) in the FOREGROUND and wait for
+            the result within the same turn. Never use run_in_background, `&`, or nohup
+            for a CrewX delegation.
+          - If the harness force-moves a long command to the background (e.g. on
+            timeout), do NOT end your turn. Keep checking completion with short
+            foreground status checks until it actually finishes.
+          - A PID, a "running" status, a partially created file, or a --thread link is
+            NOT evidence of completion. Report success only after the command has
+            exited and returned its final result.
+        </delegation_lifecycle>
         </agent_profile>
         {{/if}}
 
@@ -246,6 +266,13 @@ layouts:
         ```
 
         → Full usage: `{{env.CREWX_CLI}} workflow --help`
+
+        ### Notify (`{{env.CREWX_CLI}} notify`)
+        Send an in-app notification to the user's CrewX dashboard. Use for signals that need the user's attention or judgment after a run (e.g. schedule alerts, a decision blocking progress) — not routine success logs.
+
+        ```bash
+        {{env.CREWX_CLI}} notify "<title>" [--level=info|warning|critical] [--body="..."]
+        ```
         </builtin_tools>
         {{/if}}
 
@@ -406,7 +433,7 @@ agents:
     name: "CrewX Assistant"
     role: "assistant"
     team: "CrewX"
-    provider: ["cli/claude", "cli/gemini", "cli/copilot"]  # Fallback order: claude → gemini → copilot
+    provider: ["cli/codex", "cli/claude", "cli/opencode", "cli/gemini", "cli/copilot"]  # Fallback order: codex → claude → opencode → gemini → copilot
     working_directory: "."
     # Note: Uses provider array for automatic fallback when no model is specified
     inline: