@crewx/sdk 0.9.0-rc.3 → 0.9.0-rc.31

package/dist/schema/usage-reports.d.ts

@@ -0,0 +1,252 @@
+export declare const usage_reports: import("drizzle-orm/sqlite-core").SQLiteTableWithColumns<{
+    name: "usage_reports";
+    schema: undefined;
+    columns: {
+        id: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+            name: "id";
+            tableName: "usage_reports";
+            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: "usage_reports";
+            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;
+        }>;
+        month: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+            name: "month";
+            tableName: "usage_reports";
+            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;
+        }>;
+        generated_at: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+            name: "generated_at";
+            tableName: "usage_reports";
+            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;
+        }>;
+        source_range: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+            name: "source_range";
+            tableName: "usage_reports";
+            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;
+        }>;
+        tier: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+            name: "tier";
+            tableName: "usage_reports";
+            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;
+        }>;
+        total_tokens: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+            name: "total_tokens";
+            tableName: "usage_reports";
+            dataType: "number";
+            columnType: "SQLiteInteger";
+            data: number;
+            driverParam: number;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        total_cost_usd: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+            name: "total_cost_usd";
+            tableName: "usage_reports";
+            dataType: "number";
+            columnType: "SQLiteReal";
+            data: number;
+            driverParam: number;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        payload: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+            name: "payload";
+            tableName: "usage_reports";
+            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;
+        }>;
+        payload_hash: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+            name: "payload_hash";
+            tableName: "usage_reports";
+            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;
+        }>;
+        signature: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+            name: "signature";
+            tableName: "usage_reports";
+            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;
+        }>;
+        signed_at: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+            name: "signed_at";
+            tableName: "usage_reports";
+            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;
+        }>;
+        issuer: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+            name: "issuer";
+            tableName: "usage_reports";
+            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 type UsageReport = typeof usage_reports.$inferSelect;
+export type NewUsageReport = typeof usage_reports.$inferInsert;

package/dist/testing/index.d.ts

@@ -9,3 +9,5 @@ export { createMockAudit } from './mock-audit';
 export type { MockAudit, AuditEvent } from './mock-audit';
 export { createMockRouter } from './mock-router';
 export type { MockRouter, RegisteredRoute } from './mock-router';
+export { clearPricingOverride as resetPricingOverride } from '../config/pricing.js';
+export { clearModelsOverride as resetModelsOverride } from '../provider/models.js';

package/dist/testing/index.js

@@ -1 +1 @@
-'use strict';function m(){let e=[];return {events:e,async log(t,r){e.push({event:t,payload:r});}}}function y(){let e={debug:[],info:[],warn:[],error:[]};return {entries:e,debug(t,r){e.debug.push({msg:t,meta:r});},info(t,r){e.info.push({msg:t,meta:r});},warn(t,r){e.warn.push({msg:t,meta:r});},error(t,r){e.error.push({msg:t,meta:r});}}}function h(){let e=200,t,r,n={},o={status(s){return e=s,o},set(s,i){return n[s]=i,o},send(s){return r=s,o},json(s){return t=s,o},end(){return o},getStatusCode:()=>e,getJsonBody:()=>t,getSentBody:()=>r,getHeaders:()=>({...n})};return o}function R(){let e=[];return {routes:e,registerRoute(r,n,o){e.push({path:r,handler:n,opts:o});},async simulate(r,n,o=Buffer.alloc(0),s={},i={},d={}){let c=e.find(f=>f.path===n);if(!c)return {status:404,body:{error:"Not found"},headers:{}};let p={method:r,url:n,headers:s,body:o,params:i,query:d},u=h();return await c.handler(p,u),{status:u.getStatusCode(),body:u.getJsonBody()??u.getSentBody(),headers:u.getHeaders()}}}}function M(e){let t=new Map,r=n=>n.startsWith(`${e}::`)?n:`${e}::${n}`;return {async get(n){let o=t.get(r(n));return o?o.value:void 0},async set(n,o){t.set(r(n),{value:o});},async delete(n){return t.delete(r(n))},async list(n){let o=n?r(n):`${e}::`,s=[];for(let i of t.keys())i.startsWith(o)&&s.push(i.slice(e.length+2));return s}}}function k(e){return M(e)}function l(){let e=new Map;return {blobs:e,async put(t,r,n){return e.set(t,{data:r,contentType:n}),t},async get(t){let r=e.get(t);return r?r.data:void 0},async delete(t){return e.delete(t)}}}function E(e){let t=e.instanceId??"mock-instance",r=m(),n=y(),o=R(),s=k(t),i=l(),d=[],c=[],p=[],u={run:async()=>({output:""}),...e.agentRunner},f=new AbortController,b=async a=>(d.push(a),{accepted:true}),x=async a=>(c.push(a),{accepted:true}),S=async(a,C)=>{p.push({messageId:a,patch:C});},w=async a=>({userId:a,displayName:a}),A=async()=>{},v=async()=>({messageId:"mock-proactive",sentAt:Date.now()});return {instanceId:t,installationId:e.installationId,config:e.config,capabilities:new Set(e.capabilities??[]),log:n,agentRunner:u,db:s,storage:i,audit:r,abortSignal:e.abortSignal??f.signal,httpRouter:o,router:o,inbound:b,emitEvent:x,updateMessage:S,resolveUser:w,respondSync:A,proactive:v,inboundCalls:d,emittedEvents:c,sentMessages:p}}exports.createMockAudit=m;exports.createMockContext=E;exports.createMockLogger=y;exports.createMockRouter=R;exports.createMockStorage=l;exports.createMockStore=k;
+'use strict';function m(){let e=[];return {events:e,async log(t,r){e.push({event:t,payload:r});}}}function f(){let e={debug:[],info:[],warn:[],error:[]};return {entries:e,debug(t,r){e.debug.push({msg:t,meta:r});},info(t,r){e.info.push({msg:t,meta:r});},warn(t,r){e.warn.push({msg:t,meta:r});},error(t,r){e.error.push({msg:t,meta:r});}}}function w(){let e=200,t,r,n={},o={status(i){return e=i,o},set(i,d){return n[i]=d,o},send(i){return r=i,o},json(i){return t=i,o},end(){return o},getStatusCode:()=>e,getJsonBody:()=>t,getSentBody:()=>r,getHeaders:()=>({...n})};return o}function h(){let e=[];return {routes:e,registerRoute(r,n,o){e.push({path:r,handler:n,opts:o});},async simulate(r,n,o=Buffer.alloc(0),i={},d={},g={}){let c=e.find(l=>l.path===n);if(!c)return {status:404,body:{error:"Not found"},headers:{}};let p={method:r,url:n,headers:i,body:o,params:d,query:g},u=w();return await c.handler(p,u),{status:u.getStatusCode(),body:u.getJsonBody()??u.getSentBody(),headers:u.getHeaders()}}}}function M(e){let t=new Map,r=n=>n.startsWith(`${e}::`)?n:`${e}::${n}`;return {async get(n){let o=t.get(r(n));return o?o.value:void 0},async set(n,o){t.set(r(n),{value:o});},async delete(n){return t.delete(r(n))},async list(n){let o=n?r(n):`${e}::`,i=[];for(let d of t.keys())d.startsWith(o)&&i.push(d.slice(e.length+2));return i}}}function y(e){return M(e)}function x(){let e=new Map;return {blobs:e,async put(t,r,n){return e.set(t,{data:r,contentType:n}),t},async get(t){let r=e.get(t);return r?r.data:void 0},async delete(t){return e.delete(t)}}}function A(e){let t=e.instanceId??"mock-instance",r=m(),n=f(),o=h(),i=y(t),d=x(),g=[],c=[],p=[],u={run:async()=>({output:""}),...e.agentRunner},l=new AbortController,P=async s=>(g.push(s),{accepted:true}),v=async s=>(c.push(s),{accepted:true}),C=async(s,O)=>{p.push({messageId:s,patch:O});},k=async s=>({userId:s,displayName:s}),E=async()=>{},b=async()=>({messageId:"mock-proactive",sentAt:Date.now()});return {instanceId:t,installationId:e.installationId,config:e.config,capabilities:new Set(e.capabilities??[]),log:n,agentRunner:u,db:i,storage:d,audit:r,abortSignal:e.abortSignal??l.signal,httpRouter:o,router:o,inbound:P,emitEvent:v,updateMessage:C,resolveUser:k,respondSync:E,proactive:b,inboundCalls:g,emittedEvents:c,sentMessages:p}}function L(){}var R={claude:{models:[{id:"claude-fable-5",name:"Claude Fable 5"},{id:"claude-sonnet-5",name:"Claude Sonnet 5"},{id:"claude-opus-4-8[1m]",name:"Claude Opus 4.8 (Extended)"},{id:"claude-opus-4-8",name:"Claude Opus 4.8"},{id:"claude-opus-4-7[1m]",name:"Claude Opus 4.7 (Extended)"},{id:"claude-opus-4-7",name:"Claude Opus 4.7"},{id:"claude-opus-4-6[1m]",name:"Claude Opus 4.6 (Extended)"},{id:"claude-opus-4-6",name:"Claude Opus 4.6"},{id:"claude-sonnet-4-6[1m]",name:"Claude Sonnet 4.6 (Extended)"},{id:"claude-sonnet-4-6",name:"Claude Sonnet 4.6"},{id:"claude-haiku-4-5",name:"Claude Haiku 4.5"}],modes:[{id:"default",name:"Default"},{id:"acceptEdits",name:"Accept Edits"},{id:"plan",name:"Plan"},{id:"auto",name:"Auto"},{id:"dontAsk",name:"Don't Ask"},{id:"bypassPermissions",name:"Bypass Permissions"}],effort:["low","medium","high"],modelOverrides:{"claude-fable-5":{effort:["low","medium","high","xhigh","max"],defaultEffort:"high"},"claude-sonnet-5":{effort:["low","medium","high","xhigh","max"],defaultEffort:"high"},"claude-opus-4-8[1m]":{effort:["low","medium","high","xhigh","max"],defaultEffort:"high"},"claude-opus-4-8":{effort:["low","medium","high","xhigh","max"],defaultEffort:"high"},"claude-opus-4-7[1m]":{effort:["low","medium","high","xhigh","max"],defaultEffort:"high"},"claude-opus-4-7":{effort:["low","medium","high","xhigh","max"],defaultEffort:"high"},"claude-opus-4-6[1m]":{effort:["low","medium","high","max"],defaultEffort:"high"},"claude-opus-4-6":{effort:["low","medium","high","max"],defaultEffort:"high"},"claude-sonnet-4-6[1m]":{effort:["low","medium","high","max"],defaultEffort:"high"},"claude-sonnet-4-6":{effort:["low","medium","high","max"],defaultEffort:"high"},"claude-haiku-4-5":{effort:[]}}},codex:{models:[{id:"gpt-5.6-sol",name:"GPT-5.6 Sol"},{id:"gpt-5.6-terra",name:"GPT-5.6 Terra"},{id:"gpt-5.6-luna",name:"GPT-5.6 Luna"},{id:"gpt-5.5",name:"GPT-5.5"},{id:"gpt-5.4",name:"GPT-5.4"},{id:"gpt-5.4-mini",name:"GPT-5.4 Mini"},{id:"gpt-5.3-codex",name:"GPT-5.3 Codex"},{id:"gpt-5.3-codex-spark",name:"GPT-5.3 Codex Spark"}],modes:[{id:"agent",name:"Agent"},{id:"read-only",name:"Read Only"},{id:"plan",name:"Plan"},{id:"agent-full-access",name:"Agent Full Access"},{id:"yolo",name:"YOLO"}],effort:["minimal","low","medium","high"],modelOverrides:{"gpt-5.6-sol":{effort:["none","low","medium","high","xhigh","max"],defaultEffort:"xhigh"},"gpt-5.6-terra":{effort:["none","low","medium","high","xhigh","max"],defaultEffort:"high"},"gpt-5.6-luna":{effort:["none","low","medium","high","xhigh","max"],defaultEffort:"high"},"gpt-5.5":{effort:["minimal","low","medium","high","xhigh"],defaultEffort:"high"}}},copilot:{models:[{id:"auto",name:"Auto"},{id:"claude-sonnet-5",name:"Claude Sonnet 5"},{id:"claude-sonnet-4-6",name:"Claude Sonnet 4.6"},{id:"gpt-5.5",name:"GPT-5.5"},{id:"gpt-5.4",name:"GPT-5.4"},{id:"gemini-3.1-pro",name:"Gemini 3.1 Pro"}],modes:[{id:"interactive",name:"Interactive"},{id:"plan",name:"Plan"},{id:"autopilot",name:"Autopilot"}],effort:["none","low","medium","high","xhigh","max"],modelOverrides:{}},antigravity:{models:[{id:"Gemini 3.5 Flash (Medium)",name:"Gemini 3.5 Flash (Medium)"},{id:"Gemini 3.5 Flash (High)",name:"Gemini 3.5 Flash (High)"},{id:"Gemini 3.5 Flash (Low)",name:"Gemini 3.5 Flash (Low)"},{id:"Gemini 3.1 Pro (Low)",name:"Gemini 3.1 Pro (Low)"},{id:"Gemini 3.1 Pro (High)",name:"Gemini 3.1 Pro (High)"},{id:"Claude Sonnet 4.6 (Thinking)",name:"Claude Sonnet 4.6 (Thinking)"},{id:"Claude Opus 4.6 (Thinking)",name:"Claude Opus 4.6 (Thinking)"},{id:"GPT-OSS 120B (Medium)",name:"GPT-OSS 120B (Medium)"}],modes:[],effort:[],modelOverrides:{}}};Object.fromEntries(Object.entries(R).map(([e,t])=>[e,t.models]));function G(){}exports.createMockAudit=m;exports.createMockContext=A;exports.createMockLogger=f;exports.createMockRouter=h;exports.createMockStorage=x;exports.createMockStore=y;exports.resetModelsOverride=G;exports.resetPricingOverride=L;

package/dist/types/index.d.ts

@@ -1299,6 +1299,7 @@ export interface CrewxOptions {
     };
     remoteFactory?: (configPath: string) => Promise<import('../facade/Crewx').Crewx>;
     includeBuiltIns?: boolean;
+    additionalArgsProvider?: import('../provider/bridge').AdditionalArgsProvider;
 }
 export interface QueryOptions {
     model?: string;
@@ -1306,6 +1307,9 @@ export interface QueryOptions {
     effort?: string;
     context?: string;
     metadata?: Record<string, unknown>;
+    overdrive?: boolean | {
+        mode?: 'count' | 'latch';
+    };
     threadId?: string;
     taskId?: string;
     platform?: Platform;
@@ -1343,6 +1347,9 @@ export interface ExecuteOptions {
     effort?: string;
     context?: string;
     metadata?: Record<string, unknown>;
+    overdrive?: boolean | {
+        mode?: 'count' | 'latch';
+    };
     threadId?: string;
     taskId?: string;
     platform?: Platform;

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';
 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.3",
+  "version": "0.9.0-rc.31",
   "license": "UNLICENSED",
   "engines": {
     "node": ">=20.19.0"
@@ -117,11 +117,12 @@
     "vitest": "3.2.4"
   },
   "scripts": {
+    "prebuild": "node scripts/generate-pricing.mjs && node scripts/generate-models.mjs",
     "build:cjs": "tsup --config tsup.cjs.js",
     "build:esm": "tsup --config tsup.esm.js",
     "build:browser": "tsup --config tsup.browser.js",
     "build:dts": "tsc -p tsconfig.dts.json",
-    "build": "pnpm run build:cjs && pnpm run build:esm && pnpm run build:browser && pnpm run build:dts && node scripts/copy-migrations.mjs",
+    "build": "pnpm run prebuild && pnpm run build:cjs && pnpm run build:esm && pnpm run build:browser && pnpm run build:dts && node scripts/copy-migrations.mjs",
     "db:generate": "cd ../.. && drizzle-kit generate --config drizzle.config.ts && node packages/sdk/scripts/post-generate.mjs",
     "db:check": "cd ../.. && drizzle-kit check --config drizzle.config.ts",
     "test": "vitest run --config ./vitest.config.ts",

package/templates/agents/default.yaml

@@ -46,6 +46,13 @@ layouts:
         </dispatched_from>
         {{/if}}
 
+        {{#if vars.crewx_workspace_path}}
+        <current_workspace>
+          <path>{{{vars.crewx_workspace_path}}}</path>
+          <note>This is the absolute path of the workspace you are currently running in.</note>
+        </current_workspace>
+        {{/if}}
+
         {{#if agentMetadata.specialties.length}}
         <specialties>
           {{#each agentMetadata.specialties}}
@@ -121,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}}
 
@@ -239,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}}