@crewx/sdk 0.9.0-rc.20 → 0.9.0-rc.201

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

@@ -0,0 +1,95 @@
+export interface AppUiToolCall {
+    readonly name: string;
+    readonly arguments?: Readonly<Record<string, unknown>>;
+}
+export interface AppUiCallOptions {
+    readonly timeout?: number;
+    readonly resetTimeoutOnProgress?: boolean;
+    readonly onprogress?: (progress: AppUiProgress) => void;
+}
+export interface AppUiProgress {
+    readonly progress: number;
+    readonly total?: number;
+    readonly message?: string;
+}
+export interface AppUiToolResult {
+    readonly isError?: boolean;
+    readonly structuredContent?: Readonly<Record<string, unknown>>;
+}
+export interface AppUiToolCaller {
+    callServerTool(params: AppUiToolCall, options?: AppUiCallOptions): Promise<AppUiToolResult>;
+}
+export declare class CrewxAppToolError extends Error {
+    readonly code: string;
+    constructor(code: string, message?: string);
+}
+export interface AppUiShareResult {
+    readonly shareId: string;
+    readonly url: string;
+    readonly revision: number;
+    readonly status: 'active';
+    readonly viewer: 'app' | 'markdown';
+}
+export interface AppUiFileItem {
+    readonly ref: string;
+    readonly version: string;
+    readonly bytes: number;
+    readonly modifiedAt: string;
+}
+export interface AppUiFilesListResult {
+    readonly items: readonly AppUiFileItem[];
+    readonly next: string | null;
+}
+export interface AppUiFileReadResult {
+    readonly ref: string;
+    readonly text: string;
+    readonly version: string;
+}
+export interface AppUiFileWriteResult {
+    readonly ref: string;
+    readonly version: string;
+}
+export interface AppUiShareInput {
+    readonly ref: string;
+    readonly onprogress?: (progress: AppUiProgress) => void;
+}
+export interface AppUiListFilesInput {
+    readonly prefix?: string;
+    readonly after?: string;
+}
+export interface AppUiWriteFileInput {
+    readonly ref: string;
+    readonly text: string;
+    readonly expectedVersion: string | null;
+}
+export declare function share(app: AppUiToolCaller, input: AppUiShareInput): Promise<AppUiShareResult>;
+export declare function listFiles(app: AppUiToolCaller, input?: AppUiListFilesInput): Promise<AppUiFilesListResult>;
+export declare function readFile(app: AppUiToolCaller, input: {
+    readonly ref: string;
+}): Promise<AppUiFileReadResult>;
+export declare function writeFile(app: AppUiToolCaller, input: AppUiWriteFileInput): Promise<AppUiFileWriteResult>;
+export declare const CREWX_DOCUMENT_CHANGED: "ui/notifications/crewx-document-changed";
+export interface AppUiDocumentChanged {
+    readonly ref: string;
+    readonly version: string | null;
+}
+export interface AppUiNotification {
+    readonly method: string;
+    readonly params?: unknown;
+}
+export interface AppUiNotificationSource {
+    fallbackNotificationHandler?(notification: AppUiNotification): Promise<void>;
+}
+export interface AppUiCurrentDocumentParams {
+    readonly ref: string | null;
+    readonly dirty?: boolean;
+}
+export interface AppUiNotificationSender {
+    notification(notification: AppUiNotification): Promise<void>;
+}
+export declare const CREWX_CURRENT_DOCUMENT: "crewx/notifications/document";
+export declare function parseCrewxCurrentDocumentParams(value: unknown): AppUiCurrentDocumentParams | undefined;
+export declare function setCurrentDocument(app: AppUiNotificationSender, ref: string | null, options?: {
+    readonly dirty?: boolean;
+}): Promise<void>;
+export declare function onDocumentChanged(app: AppUiNotificationSource, handler: (params: AppUiDocumentChanged) => void): () => void;

package/dist/app-ui/index.js

@@ -0,0 +1 @@
+'use strict';var g={refCodePoints:200,refSegments:3},A=/^[\p{L}\p{N}][\p{L}\p{N}\p{M}_-]{0,99}$/u;function c(e){let n=e.normalize("NFC");if([...n].length>g.refCodePoints)return;let r=n.split("/");if(r.length>g.refSegments)return;let t=r[r.length-1];return t.endsWith(".md")&&[...r.slice(0,-1),t.slice(0,-3)].every(o=>A.test(o))?n:void 0}var s=class extends Error{code;constructor(n,r=n){super(r),this.name="CrewxAppToolError",this.code=n;}},U=1200*1e3;function O(e,n){return u(e,{name:"crewx_docs_share",arguments:{ref:n.ref}},{timeout:U,resetTimeoutOnProgress:true,onprogress:n.onprogress??(()=>{})})}function I(e,n={}){return u(e,{name:"crewx_files_list",arguments:{...n}})}function b(e,n){return u(e,{name:"crewx_files_read",arguments:{ref:n.ref}})}function L(e,n){return u(e,{name:"crewx_files_write",arguments:{ref:n.ref,text:n.text,expectedVersion:n.expectedVersion}})}var h="ui/notifications/crewx-document-changed",x="crewx/notifications/document";function C(e){if(!d(e)||Object.keys(e).some(o=>o!=="ref"&&o!=="dirty")||!Object.prototype.hasOwnProperty.call(e,"ref"))return;let n=e.ref,r;if(n===null)r=null;else if(typeof n=="string"){let o=c(n);if(o===void 0)return;r=o;}else return;let i=Object.prototype.hasOwnProperty.call(e,"dirty")?e.dirty:void 0;if(!(i!==void 0&&typeof i!="boolean"))return i===void 0?{ref:r}:{ref:r,dirty:i}}async function k(e,n,r){if(n!==null&&typeof n!="string")throw new s("INVALID_REF");let t=n===null?null:c(n);if(n!==null&&t===void 0)throw new s("INVALID_REF");let i=C({ref:t,...r?.dirty===void 0?{}:{dirty:r.dirty}});if(i===void 0)throw new s("INVALID_PARAMS");await e.notification({method:x,params:i});}var R=/^sha256:[0-9a-f]{64}$/,p=new WeakMap;function v(e,n){let r=p.get(e)??w(e),t=i=>n(i);return r.listeners.add(t),()=>{r.listeners.delete(t),r.listeners.size===0&&p.get(e)===r&&(p.delete(e),e.fallbackNotificationHandler===r.dispatch&&(e.fallbackNotificationHandler=r.previous));}}function w(e){let n=e.fallbackNotificationHandler,r=new Set,t=async o=>{if(o.method!==h){await n?.call(e,o);return}let l=E(o.params);if(l===void 0)return;let a;for(let m of [...r])try{m(l);}catch(y){a??={error:y};}if(a!==void 0)throw a.error},i={listeners:r,previous:n,dispatch:t};return p.set(e,i),e.fallbackNotificationHandler=t,i}function E(e){if(!d(e))return;let n=e.ref,r=e.version;if(!(typeof n!="string"||n.length===0)&&!(r!==null&&(typeof r!="string"||!R.test(r))))return {ref:n,version:r}}async function u(e,n,r){let t=r===void 0?await e.callServerTool(n):await e.callServerTool(n,r);if(t.isError===true){let i=t.structuredContent?.error,o=d(i)?i:void 0,l=typeof o?.code=="string"?o.code:"TOOL_ERROR",a=typeof o?.message=="string"?o.message:l;throw new s(l,a)}if(!d(t.structuredContent))throw new s("TOOL_RESULT_INVALID",`${n.name} returned no structured result`);return t.structuredContent}function d(e){return typeof e=="object"&&e!==null&&!Array.isArray(e)}exports.CREWX_CURRENT_DOCUMENT=x;exports.CREWX_DOCUMENT_CHANGED=h;exports.CrewxAppToolError=s;exports.listFiles=I;exports.onDocumentChanged=v;exports.parseCrewxCurrentDocumentParams=C;exports.readFile=b;exports.setCurrentDocument=k;exports.share=O;exports.writeFile=L;

package/dist/attachment-receive/index.d.ts

@@ -0,0 +1,76 @@
+export declare const RECEIVED_ID_RE: RegExp;
+export interface ReceiveLocation {
+    readonly anchor: string;
+    readonly root: string;
+}
+export interface ReceivedReceipt {
+    readonly id: string;
+    readonly sizeBytes: number;
+    readonly sha256: string;
+    readonly mode: '0600';
+    readonly createdAt: string;
+    readonly expiresAt: string;
+}
+export type ReceiveSource = Uint8Array | AsyncIterable<Uint8Array> | NodeJS.ReadableStream;
+export interface MaterializedFileRef {
+    readonly anchorDir: string;
+    readonly segments: readonly string[];
+}
+export interface MaterializedFileExpected {
+    readonly sizeBytes: number;
+    readonly sha256: string;
+}
+export interface MaterializedFileReceipt {
+    readonly sizeBytes: number;
+    readonly sha256: string;
+    readonly mode: number;
+    readonly verifiedAt: string;
+}
+export interface ReceiveRootLease {
+    release(): Promise<void>;
+}
+export interface ReceiveTempSweepReport {
+    readonly status: 'complete' | 'pending';
+    readonly removed: number;
+    readonly pendingRecent: number;
+    readonly pendingLive: number;
+    readonly pendingUnsafe: number;
+    readonly pendingUncertain: number;
+}
+export type AttachmentReceiveErrorCode = 'INVALID_INPUT' | 'TOO_LARGE' | 'SIZE_MISMATCH' | 'HASH_MISMATCH' | 'ROOT_UNSAFE' | 'ROOT_BUSY' | 'NOT_FOUND' | 'EXPIRED' | 'TAMPERED_CONTENT' | 'TAMPERED_MODE' | 'NOT_REGULAR_FILE' | 'SYMLINK' | 'WRONG_OWNER' | 'LINKED' | 'UNSUPPORTED' | 'IO_ERROR' | 'CLEANUP_INCOMPLETE';
+export declare class AttachmentReceiveError extends Error {
+    readonly code: AttachmentReceiveErrorCode;
+    readonly originalCode?: AttachmentReceiveErrorCode;
+    constructor(code: AttachmentReceiveErrorCode, originalCode?: AttachmentReceiveErrorCode);
+}
+export declare function receive(location: ReceiveLocation, source: ReceiveSource, options: {
+    readonly expectedSizeBytes: number;
+    readonly expectedSha256: string;
+    readonly maxBytes: number;
+    readonly ttlMs: number;
+    readonly now?: () => number;
+}): Promise<ReceivedReceipt>;
+export declare function inspectReceived(location: ReceiveLocation, expected: ReceivedReceipt, options?: {
+    readonly now?: () => number;
+}): Promise<ReceivedReceipt>;
+export declare function readVerifiedReceived(location: ReceiveLocation, expected: ReceivedReceipt, options?: {
+    readonly now?: () => number;
+}): Promise<Uint8Array>;
+export declare function verifyMaterializedFile(ref: MaterializedFileRef, expected: MaterializedFileExpected, options?: {
+    readonly now?: () => number;
+}): Promise<MaterializedFileReceipt>;
+export declare function acquireReceiveRootLease(location: ReceiveLocation): Promise<ReceiveRootLease>;
+export declare function removeReceived(location: ReceiveLocation, id: string): Promise<boolean>;
+export declare function listReceived(location: ReceiveLocation): Promise<readonly {
+    readonly id: string;
+    readonly mtimeMs: number;
+    readonly sizeBytes: number;
+}[]>;
+export declare function sweepReceiveTemp(location: ReceiveLocation, options: {
+    readonly olderThanMs: number;
+    readonly now?: () => number;
+}): Promise<number>;
+export declare function sweepReceiveTempDetailed(location: ReceiveLocation, options: {
+    readonly olderThanMs: number;
+    readonly now?: () => number;
+}): Promise<ReceiveTempSweepReport>;

package/dist/attachment-receive/index.js

@@ -0,0 +1,2 @@
+'use strict';var crypto=require('crypto'),fs=require('fs'),path=require('path'),child_process=require('child_process');require('os');var util=require('util');var v=class extends Error{code;constructor(t){super(t),this.name="AppFilesError",this.code=t;}};path.join("locks","files");var{link:Xe,mkdir:$e,open:Je,readFile:ae,unlink:H}=fs.promises,Ze=5,qe=50,Qe=1e3,et=2e3,tt="/bin/ps",nt={LC_ALL:"C",TZ:"UTC"},it=100,rt=19,ot=/^[A-Za-z]{3} ([A-Za-z]{3}) +(\d{1,2}) (\d{2}):(\d{2}):(\d{2}) (\d{4})$/,at=["Jan","Feb","Mar","Apr","May","Jun","Jul","Aug","Sep","Oct","Nov","Dec"],st=util.promisify(child_process.execFile),ge,X;async function he(e){let{lockDir:t,key:n}=e,i=path.join(t,ct(n)),o=Date.now()+e.waitMs,a=await Ae(t,{token:crypto.randomUUID(),pid:process.pid,startedAtMs:await Pe()}),s=new ie;try{let d=Ze;for(;;){if(await _e(a.staged,i))return {path:i,token:a.record.token};let c=await $(i);if(c!=="vanished"&&!(c!=="unreadable"&&await s.isDead(c)&&await ft(t,i,c,s))){if(Date.now()>=o)throw new v("FILE_BUSY");await Ot(d),d=Math.min(d*2,qe);}}}finally{await H(a.staged).catch(()=>{});}}async function se(e){await re(e.path,e.token);}function ct(e){return crypto.createHash("sha256").update(e,"utf8").digest("hex")}async function Ae(e,t){let n=path.join(e,`.${t.token}.tmp`);try{await $e(e,{recursive:!0}),await dt(n,JSON.stringify(t));}catch{throw await H(n).catch(()=>{}),new v("IO_ERROR")}return {record:t,staged:n}}async function dt(e,t){let n=await Je(e,"wx");try{await n.writeFile(t),await n.sync();}finally{await n.close();}}async function _e(e,t){try{return await Xe(e,t),!0}catch(n){if(n.code==="EEXIST")return  false;throw new v("IO_ERROR")}}async function $(e){let t;try{t=await ae(e,"utf8");}catch(n){return n.code==="ENOENT"?"vanished":"unreadable"}try{let n=JSON.parse(t);return ut(n)?n:"unreadable"}catch{return "unreadable"}}function ut(e){if(typeof e!="object"||e===null||Array.isArray(e))return  false;let t=e;return typeof t.token=="string"&&t.token.length>0&&typeof t.pid=="number"&&Number.isSafeInteger(t.pid)&&t.pid>0&&(t.startedAtMs===null||Number.isSafeInteger(t.startedAtMs))}async function lt(e){try{process.kill(e.pid,0);}catch(n){return n.code==="ESRCH"}if(e.startedAtMs===null)return  false;let t=await Le(e.pid);return t!==null&&t!==e.startedAtMs}var ie=class{constructor(t=lt,n=Date.now){this.check=t;this.now=n;}check;now;answers=new Map;async isDead(t){let n=this.now(),i=this.answers.get(t.token);if(i!==void 0&&n-i.at<Qe)return i.dead;let o=await this.check(t);return this.answers.set(t.token,{at:n,dead:o}),o}};async function ft(e,t,n,i){let o=`${t}.reclaim`,a=await Ae(e,{token:crypto.randomUUID(),pid:process.pid,startedAtMs:await Pe()});try{if(!await _e(a.staged,o)){let s=await $(o);return s!=="vanished"&&s!=="unreadable"&&await i.isDead(s)&&await re(o,s.token),!1}try{let s=await $(t);return typeof s!="object"||s.token!==n.token?!1:(await H(t).catch(()=>{}),!0)}finally{await re(o,a.record.token);}}finally{await H(a.staged).catch(()=>{});}}async function re(e,t){let n=await $(e);typeof n=="object"&&n.token===t&&await H(e).catch(()=>{});}function Pe(){return (X===void 0||X.pid!==process.pid)&&(X={pid:process.pid,startedAtMs:Le(process.pid)}),X.startedAtMs}async function Le(e){return process.platform==="linux"&&(ge??=await fs.promises.access("/proc/self/stat").then(()=>true,()=>false),ge)?mt(e):pt(e)}async function mt(e){try{let t=await ae(`/proc/${e}/stat`,"utf8"),n=t.slice(t.lastIndexOf(")")+2).split(" "),i=Number(n[rt]),o=await yt();return !Number.isSafeInteger(i)||o===void 0?null:o*1e3+i*1e3/it}catch{return null}}async function yt(){let e=(await ae("/proc/stat","utf8")).split(`
+`).find(n=>n.startsWith("btime ")),t=Number(e?.slice(6));return Number.isSafeInteger(t)?t:void 0}async function pt(e){try{let{stdout:t}=await st(tt,["-o","lstart=","-p",String(e)],{env:nt,encoding:"utf8",timeout:et});return wt(t.trim())}catch{return null}}function wt(e){let t=ot.exec(e);if(t===null)return null;let n=at.indexOf(t[1]);return n<0?null:Date.UTC(Number(t[6]),n,Number(t[2]),Number(t[3]),Number(t[4]),Number(t[5]))}function Ot(e){return new Promise(t=>setTimeout(t,e))}var xe=/^rcv_[0-9a-f]{32}$/,N=class extends Error{code;originalCode;constructor(t,n){super(t),this.name="AttachmentReceiveError",this.code=t,n!==void 0&&(this.originalCode=n);}},Q=100*1024*1024,me=365*24*60*60*1e3,ye=/^[0-9a-f]{64}$/,It=/^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}\.[a-z0-9]{1,10}$/,gt=/[/\\\x00-\x1F\x7F]/,bt=/^\.tmp-(\d+)-[0-9a-f]{32}$/,q=new Set,J=new Map,Tt=64*1024,k=448,A=384;function ce(e){return e==="removed"||e==="absent"}async function an(e,t,n){let i=_t(n),o=U(e);Ut(t),M();let a,s,d,c,u=false,m,f,y,E,C=false,B=async()=>m!==void 0?m:u?!a||!d||!c?m="failed":(m=await Fe(a,d,c),m):m="absent",S=async()=>E!==void 0?E:f?!a||!y?E="failed":(E=await Fe(a,f,y),E):E="absent";try{a=await F(o,!0);let z="";for(let R=0;R<3;R+=1){await l(a),d=path.join(a.root,`.tmp-${process.pid}-${crypto.randomBytes(16).toString("hex")}`);try{s=await fs.promises.open(d,fs.constants.O_CREAT|fs.constants.O_EXCL|fs.constants.O_WRONLY|fs.constants.O_NOFOLLOW,A),u=!0;break}catch(h){if(p(h)==="EEXIST")continue;throw p(h)==="ELOOP"&&r("SYMLINK"),h}}(!s||!d)&&r("IO_ERROR"),q.add(d);let g=await s.stat({bigint:!0});c=x(d,g),await s.chmod(A),g=await s.stat({bigint:!0}),le(g,!0),await j(d,c,"TAMPERED_CONTENT"),await l(a);let te=crypto.createHash("sha256"),V=0,We=t instanceof Uint8Array?Ct(t):t;try{for await(let R of We){R instanceof Uint8Array||r("INVALID_INPUT");let h=V+R.byteLength;if((!Number.isSafeInteger(h)||h>i.maxBytes)&&r("TOO_LARGE"),h>i.expectedSizeBytes&&r("SIZE_MISMATCH"),R.byteLength===0)continue;let D=new Uint8Array(R.byteLength);D.set(R),await l(a),te.update(D),await xt(s,D),V=h;}}catch(R){if(R instanceof N)throw R;r("IO_ERROR");}V!==i.expectedSizeBytes&&r("SIZE_MISMATCH");let Ee=te.digest("hex");Ee!==i.expectedSha256&&r("HASH_MISMATCH"),await s.sync(),g=await s.stat({bigint:!0}),le(g,!0),g.size!==BigInt(V)&&r("TAMPERED_CONTENT"),await j(d,c,"TAMPERED_CONTENT"),await l(a);let ne;for(let R=0;R<3;R+=1){await l(a),z=`rcv_${crypto.randomBytes(16).toString("hex")}`;let h=path.join(a.root,z);try{await fs.promises.link(d,h),ne=z,f=h,y=c;break}catch(D){if(p(D)==="EEXIST")continue;throw p(D)==="ELOOP"&&r("SYMLINK"),D}}(!ne||!f||!y)&&r("IO_ERROR");let je=await B();ce(je)||r("CLEANUP_INCOMPLETE"),await Ne(a),T(g.mode)!==A&&r("TAMPERED_MODE");let K={id:ne,sizeBytes:V,sha256:Ee,mode:"0600",createdAt:i.createdAt,expiresAt:i.expiresAt};K.mode!=="0600"&&r("TAMPERED_MODE");let Re=await Oe(a,K,!0,y);return (Re.sha256!==K.sha256||Re.mode!==A)&&r("TAMPERED_CONTENT"),C=!0,K}catch(z){let g=P(z);throw f&&!C&&await S(),u&&await B(),(f!==void 0&&!ce(E)||u&&!ce(m))&&g.code!=="ROOT_UNSAFE"&&g.code!=="UNSUPPORTED"&&g.code!=="CLEANUP_INCOMPLETE"?new N("CLEANUP_INCOMPLETE",g.code):g}finally{s&&await s.close().catch(()=>{}),d&&q.delete(d);}}async function sn(e,t,n={}){try{let i=Ce(t);G(n.now)>=i.expiresAtMs&&r("EXPIRED");let a=await F(U(e),!1);return await Oe(a,i,!1),Pt(i)}catch(i){throw P(i)}}async function cn(e,t,n={}){try{let i=Ce(t);G(n.now)>=i.expiresAtMs&&r("EXPIRED");let a=await F(U(e),!1),s=await Oe(a,i,!0);return s.bytes||r("TAMPERED_CONTENT"),s.bytes}catch(i){throw P(i)}}async function dn(e,t,n={}){try{let i=Lt(e),o=St(t),a=W(G(n?.now));M();let s=await Dt(i.anchorDir,i.segments.slice(0,-1)),d=path.join(s.path,i.segments[i.segments.length-1]),c=await Ve(d,o,!1,()=>L(s.pins),void 0,{size:"SIZE_MISMATCH",hash:"HASH_MISMATCH"});return {sizeBytes:c.sizeBytes,sha256:c.sha256,mode:c.mode,verifiedAt:a}}catch(i){throw P(i)}}async function un(e){let t;try{let n=U(e);M();let i=await F(n,!0);await l(i);try{t=await he({lockDir:i.root,key:`crewx:attachment-inbox:${i.root}`,waitMs:0});}catch(a){throw p(a)==="FILE_BUSY"&&r("ROOT_BUSY"),a}await l(i);let o=!1;return {async release(){if(!o)try{await se(t),o=!0;}catch(a){throw P(a)}}}}catch(n){throw t&&await se(t).catch(()=>{}),P(n)}}async function ln(e,t){try{pe(t);let n=U(e);M();let i;try{i=await F(n,!1);}catch(c){if(c instanceof N&&c.code==="NOT_FOUND")return !1;throw c}await l(i);let o=path.join(i.root,t),a=await w(o);if(!a)return !1;a.isSymbolicLink()&&r("SYMLINK"),a.isFile()||r("NOT_REGULAR_FILE");let s=await ee(o),d;try{d=await s.stat({bigint:!0}),le(d,!1),I(a,d)||r("TAMPERED_CONTENT"),await l(i),await j(o,x(o,d),"TAMPERED_CONTENT");}finally{await s.close().catch(()=>{});}await l(i),await j(o,x(o,d),"TAMPERED_CONTENT");try{await fs.promises.unlink(o);}catch(c){if(p(c)==="ENOENT")return !1;throw (p(c)==="EISDIR"||p(c)==="EPERM")&&r("NOT_REGULAR_FILE"),c}return await Ne(i),!0}catch(n){throw P(n)}}async function fn(e){try{M();let t;try{t=await F(U(e),!1);}catch(o){if(o instanceof N&&o.code==="NOT_FOUND")return [];throw o}await l(t);let n=await fs.promises.readdir(t.root);await l(t);let i=[];for(let o of n)if(!(o.length!==36||!xe.test(o)))try{await l(t);let a=path.join(t.root,o),s=await w(a);if(!s||s.isSymbolicLink()||!s.isFile())continue;let d=await ee(a);try{let c=await d.stat({bigint:!0});if(!vt(c)||!I(s,c))continue;await l(t);let u=await w(a),m=await d.stat({bigint:!0});if(!u||u.isSymbolicLink()||!u.isFile()||!I(u,m)||!we(c,m))continue;i.push({id:o,mtimeMs:Number(c.mtimeMs),sizeBytes:Number(c.size)});}finally{await d.close().catch(()=>{});}}catch(a){if(a instanceof N&&a.code==="ROOT_UNSAFE")throw a}return await l(t),i.sort((o,a)=>o.id<a.id?-1:o.id>a.id?1:0)}catch(t){throw P(t)}}async function mn(e,t){return (await ht(e,t)).removed}async function ht(e,t){let n=t?.olderThanMs;(!Number.isSafeInteger(n)||n<=0||n>me)&&r("INVALID_INPUT");let i=G(t.now);M();try{let o;try{o=await F(U(e),!1);}catch(f){if(f instanceof N&&f.code==="NOT_FOUND")return De(0,0,0,0,0);throw f}let a=await fs.promises.readdir(o.root),s=0,d=0,c=0,u=0,m=0;for(let f of a){let y=bt.exec(f);if(!y||y[0]!==f)continue;let E=Number(y[1]),C=path.join(o.root,f);if(!Number.isSafeInteger(E)||E<=0){m+=1;continue}let B=q.has(C)?"live":He(E);if(B==="live"){c+=1;continue}if(B==="uncertain"){m+=1;continue}let S=await At(o,C,E,n,i);S==="removed"?s+=1:S==="pendingRecent"?d+=1:S==="pendingLive"?c+=1:S==="pendingUnsafe"?u+=1:S==="pendingUncertain"&&(m+=1);}return s>0&&await Ne(o),De(s,d,c,u,m)}catch(o){throw P(o)}}function De(e,t,n,i,o){return {status:t+n+i+o===0?"complete":"pending",removed:e,pendingRecent:t,pendingLive:n,pendingUnsafe:i,pendingUncertain:o}}async function At(e,t,n,i,o){try{await l(e);let a=await w(t);if(!a)return await l(e),"absent";if(!Z(a))return "pendingUnsafe";let s=o-Number(a.mtimeMs);if(!Number.isFinite(s))return "pendingUncertain";if(s<=i)return "pendingRecent";let d=await ee(t);try{let c=await d.stat({bigint:!0});if(!Z(c))return "pendingUnsafe";if(!I(a,c))return "pendingUncertain";await l(e);let u=await w(t),m=await d.stat({bigint:!0});if(!u)return await l(e),"absent";if(u.isSymbolicLink()||!u.isFile())return "pendingUncertain";if(!Z(u)||!Z(m))return "pendingUnsafe";if(!I(a,u)||!I(u,m)||!we(c,m))return "pendingUncertain";if(q.has(t))return "pendingLive";let f=He(n);if(f==="live")return "pendingLive";if(f==="uncertain")return "pendingUncertain";await l(e),await j(t,x(t,c),"TAMPERED_CONTENT");try{await fs.promises.unlink(t);}catch(y){if(p(y)==="ENOENT"){await l(e);let E=await w(t);return await l(e),E?"pendingUncertain":"absent"}throw y}return "removed"}finally{await d.close().catch(()=>{});}}catch(a){if(a instanceof N&&(a.code==="ROOT_UNSAFE"||a.code==="UNSUPPORTED"))throw a;if(a instanceof N&&a.code==="NOT_FOUND"){await l(e);let s=await w(t);return await l(e),s?"pendingUncertain":"absent"}return "pendingUncertain"}}function _t(e){Y(e)||r("INVALID_INPUT");let t=e.expectedSizeBytes,n=e.expectedSha256,i=e.maxBytes,o=e.ttlMs;(!Number.isSafeInteger(t)||t<0)&&r("INVALID_INPUT"),(!Number.isSafeInteger(i)||i<=0||i>Q)&&r("INVALID_INPUT"),t>i&&r("TOO_LARGE"),(typeof n!="string"||n.length!==64||!ye.test(n))&&r("INVALID_INPUT"),(!Number.isSafeInteger(o)||o<=0||o>me)&&r("INVALID_INPUT");let a=G(e.now),s=a+o,d=W(a),c=W(s);return {expectedSizeBytes:t,expectedSha256:n,maxBytes:i,createdAt:d,expiresAt:c}}function Ce(e){Y(e)||r("INVALID_INPUT");let t;try{Object.getPrototypeOf(e)!==Object.prototype&&Object.getPrototypeOf(e)!==null&&r("INVALID_INPUT"),t=Object.keys(e).sort();}catch{r("INVALID_INPUT");}t.join(",")!=="createdAt,expiresAt,id,mode,sha256,sizeBytes"&&r("INVALID_INPUT");let n=e.id,i=e.sizeBytes,o=e.sha256,a=e.mode,s=e.createdAt,d=e.expiresAt;pe(n),(!Number.isSafeInteger(i)||i<0||i>Q)&&r("INVALID_INPUT"),(typeof o!="string"||o.length!==64||!ye.test(o))&&r("INVALID_INPUT"),a!=="0600"&&r("INVALID_INPUT"),(typeof s!="string"||typeof d!="string")&&r("INVALID_INPUT");let c=Ue(s),u=Ue(d);return (u<=c||u-c>me)&&r("INVALID_INPUT"),{id:n,sizeBytes:i,sha256:o,mode:a,createdAt:s,expiresAt:d,createdAtMs:c,expiresAtMs:u}}function Pt(e){return {id:e.id,sizeBytes:e.sizeBytes,sha256:e.sha256,mode:e.mode,createdAt:e.createdAt,expiresAt:e.expiresAt}}function pe(e){(typeof e!="string"||e.length!==36||!xe.test(e))&&r("INVALID_INPUT");}function Lt(e){Y(e)||r("INVALID_INPUT");let t,n;try{Object.getPrototypeOf(e)!==Object.prototype&&Object.getPrototypeOf(e)!==null&&r("INVALID_INPUT"),Object.keys(e).sort().join(",")!=="anchorDir,segments"&&r("INVALID_INPUT"),t=e.anchorDir,n=e.segments;}catch{r("INVALID_INPUT");}let i=de(t);(!Array.isArray(n)||n.length<1||n.length>6)&&r("INVALID_INPUT");let o=[];for(let a=0;a<n.length;a+=1){let s=n[a];(typeof s!="string"||s.length===0||s==="."||s===".."||gt.test(s))&&r("INVALID_INPUT"),o.push(s);}return It.test(o[o.length-1])||r("INVALID_INPUT"),{anchorDir:i,segments:o}}function St(e){Y(e)||r("INVALID_INPUT");let t,n;try{Object.getPrototypeOf(e)!==Object.prototype&&Object.getPrototypeOf(e)!==null&&r("INVALID_INPUT"),Object.keys(e).sort().join(",")!=="sha256,sizeBytes"&&r("INVALID_INPUT"),t=e.sizeBytes,n=e.sha256;}catch{r("INVALID_INPUT");}return (!Number.isSafeInteger(t)||t<0||t>Q)&&r("INVALID_INPUT"),(typeof n!="string"||!ye.test(n))&&r("INVALID_INPUT"),{sizeBytes:t,sha256:n}}function de(e){return (typeof e!="string"||!path.isAbsolute(e)||e.includes("\0"))&&r("INVALID_INPUT"),e.split(path.sep).some(t=>t==="."||t==="..")&&r("INVALID_INPUT"),path.resolve(e)}function U(e){Y(e)||r("INVALID_INPUT");let t=de(e.anchor),n=de(e.root),i=path.relative(t,n);return (!i||i===".."||i.startsWith(`..${path.sep}`)||path.isAbsolute(i))&&r("ROOT_UNSAFE"),{anchor:t,root:n}}async function Dt(e,t){let n=path.join(e,...t),i=Be(n),o=i.indexOf(e);o<0&&r("ROOT_UNSAFE");let a=[];for(let s=0;s<i.length;s+=1){let d=i[s],c=await w(d);c||r(s<=o?"ROOT_UNSAFE":"NOT_FOUND"),ue(c),a.push(x(d,c));}return await L(a),{path:n,pins:a}}function Ut(e){e instanceof Uint8Array||e!==null&&typeof e=="object"&&typeof e[Symbol.asyncIterator]=="function"||r("INVALID_INPUT");}function M(){(process.platform==="win32"||typeof process.getuid!="function"||typeof fs.constants.O_NOFOLLOW!="number"||fs.constants.O_NOFOLLOW===0||typeof fs.constants.O_NONBLOCK!="number"||fs.constants.O_NONBLOCK===0||typeof fs.constants.O_DIRECTORY!="number"||fs.constants.O_DIRECTORY===0)&&r("UNSUPPORTED");}function G(e){e!==void 0&&typeof e!="function"&&r("INVALID_INPUT");let t;try{t=e?e():Date.now();}catch{r("INVALID_INPUT");}return Number.isSafeInteger(t)||r("INVALID_INPUT"),W(t),t}function W(e){try{let t=new Date(e).toISOString();return Date.parse(t)!==e&&r("INVALID_INPUT"),t}catch{r("INVALID_INPUT");}}function Ue(e){typeof e!="string"&&r("INVALID_INPUT");let t=Date.parse(e);return (!Number.isSafeInteger(t)||W(t)!==e)&&r("INVALID_INPUT"),t}async function F(e,t){return M(),t?Mt(e.root,()=>Me(e,!0)):Me(e,false)}async function Me(e,t){let n=Be(e.root),i=n.indexOf(e.anchor);(i<0||i===n.length-1)&&r("ROOT_UNSAFE");let o=[],a;for(let d=0;d<n.length;d+=1){let c=n[d],u=await w(c);if(!u){(!t||d<=i)&&r(d<=i?"ROOT_UNSAFE":"NOT_FOUND"),await L(o,false);let f=false;try{await fs.promises.mkdir(c,{mode:k}),f=!0;}catch(y){if(p(y)!=="EEXIST")throw (p(y)==="ENOENT"||p(y)==="ENOTDIR")&&r("ROOT_UNSAFE"),y}u=await w(c),u||r("ROOT_UNSAFE"),ue(u),f&&(u=await Ft(c,u,o));}ue(u);let m=x(c,u);o.push(m),d===n.length-1&&(a=u);}a||r("ROOT_UNSAFE"),ze(a);let s={...e,pins:o};return await l(s),s}async function Mt(e,t){let n=J.get(e)??Promise.resolve(),i,o=new Promise(a=>{i=a;});J.set(e,o),await n;try{return await t()}finally{i(),J.get(e)===o&&J.delete(e);}}async function Ft(e,t,n){let i=BigInt(process.getuid());t.uid!==i&&r("ROOT_UNSAFE"),await L(n,false);let o=await w(e);(!o||o.isSymbolicLink()||!o.isDirectory()||!I(t,o))&&r("ROOT_UNSAFE");let a;try{try{a=await fs.promises.open(e,fs.constants.O_RDONLY|fs.constants.O_DIRECTORY|fs.constants.O_NOFOLLOW);}catch(d){if(p(d)!=="EACCES"&&p(d)!=="EPERM")throw d}if(a){let d=await a.stat({bigint:!0});(!d.isDirectory()||!I(t,d))&&r("ROOT_UNSAFE"),await L(n,!1),await a.chmod(k);let c=await a.stat({bigint:!0});(!I(t,c)||T(c.mode)!==k||c.uid!==i)&&r("ROOT_UNSAFE");}else {await L(n,!1);let d=await w(e);(!d||d.isSymbolicLink()||!d.isDirectory()||!I(t,d))&&r("ROOT_UNSAFE"),await fs.promises.chmod(e,k);}await L(n,!1);let s=await w(e);return (!s||s.isSymbolicLink()||!s.isDirectory()||!I(t,s))&&r("ROOT_UNSAFE"),(T(s.mode)!==k||s.uid!==i)&&r("ROOT_UNSAFE"),s}finally{a&&await a.close().catch(()=>{});}}function Be(e){let t=path.parse(e).root,n=e.slice(t.length).split(path.sep).filter(Boolean),i=[t],o=t;for(let a of n)o=path.join(o,a),i.push(o);return i}function ue(e){e.isSymbolicLink()&&r("ROOT_UNSAFE"),e.isDirectory()||r("ROOT_UNSAFE");}function ze(e){(e.uid!==BigInt(process.getuid())||T(e.mode)!==k)&&r("ROOT_UNSAFE");}async function l(e){await L(e.pins,true);}async function L(e,t=false){if(e.length!==0)for(let n=0;n<e.length;n+=1){let i=e[n],o=await w(i.path);(!o||o.isSymbolicLink()||!o.isDirectory())&&r("ROOT_UNSAFE"),(o.dev!==i.dev||o.ino!==i.ino)&&r("ROOT_UNSAFE"),t&&n===e.length-1&&ze(o);}}async function w(e){try{return await fs.promises.lstat(e,{bigint:!0})}catch(t){let n=p(t);if(n==="ENOENT"||n==="ENOTDIR")return;throw t}}async function j(e,t,n){let i=await w(e);(!i||i.isSymbolicLink()||!i.isFile())&&r(n),(i.dev!==t.dev||i.ino!==t.ino)&&r(n);}function x(e,t){return {path:e,dev:t.dev,ino:t.ino}}function I(e,t){return e.dev===t.dev&&e.ino===t.ino}function we(e,t){return e.dev===t.dev&&e.ino===t.ino&&e.mode===t.mode&&e.uid===t.uid&&e.nlink===t.nlink&&e.size===t.size&&e.mtimeNs===t.mtimeNs&&e.ctimeNs===t.ctimeNs}function T(e){return Number(e)&4095}function le(e,t){e.isFile()||r("NOT_REGULAR_FILE"),e.uid!==BigInt(process.getuid())&&r("WRONG_OWNER"),e.nlink!==1n&&!t&&r("LINKED"),t&&e.nlink!==1n&&r("LINKED"),t&&T(e.mode)!==A&&r("TAMPERED_MODE");}function vt(e){return e.isFile()&&e.uid===BigInt(process.getuid())&&e.nlink===1n&&T(e.mode)===A&&e.size<=BigInt(Q)}function Z(e){return e.isFile()&&e.uid===BigInt(process.getuid())&&e.nlink===1n&&T(e.mode)===A}async function ee(e){try{return await fs.promises.open(e,fs.constants.O_RDONLY|fs.constants.O_NOFOLLOW|fs.constants.O_NONBLOCK)}catch(t){throw p(t)==="ELOOP"&&r("SYMLINK"),p(t)==="ENOENT"&&r("NOT_FOUND"),t}}async function Oe(e,t,n,i){return pe(t.id),Ve(path.join(e.root,t.id),t,n,()=>l(e),i,{size:"TAMPERED_CONTENT",hash:"TAMPERED_CONTENT"})}async function Ve(e,t,n,i,o,a){await i();let s=await w(e);s||r("NOT_FOUND"),s.isSymbolicLink()&&r("SYMLINK"),s.isFile()||r("NOT_REGULAR_FILE"),s.uid!==BigInt(process.getuid())&&r("WRONG_OWNER"),s.nlink!==1n&&r("LINKED"),T(s.mode)!==A&&r("TAMPERED_MODE"),s.size!==BigInt(t.sizeBytes)&&r(a.size);let d=await ee(e);try{let c=await d.stat({bigint:!0});c.isFile()||r("NOT_REGULAR_FILE"),I(s,c)||r("TAMPERED_CONTENT"),o&&(c.dev!==o.dev||c.ino!==o.ino)&&r("TAMPERED_CONTENT"),c.uid!==BigInt(process.getuid())&&r("WRONG_OWNER"),c.nlink!==1n&&r("LINKED"),T(c.mode)!==A&&r("TAMPERED_MODE"),c.size!==BigInt(t.sizeBytes)&&r(a.size);let{sha256:u,bytes:m}=await kt(d,t.sizeBytes,n),f=await d.stat({bigint:!0}),y=await w(e);return await i(),(!y||y.isSymbolicLink()||!y.isFile())&&r("TAMPERED_CONTENT"),(!I(c,y)||!I(f,y))&&r("TAMPERED_CONTENT"),(T(f.mode)!==A||T(y.mode)!==A)&&r("TAMPERED_MODE"),f.uid!==BigInt(process.getuid())&&r("WRONG_OWNER"),f.nlink!==1n&&r("LINKED"),we(c,f)||r("TAMPERED_CONTENT"),f.size!==BigInt(t.sizeBytes)&&r(a.size),u!==t.sha256&&r(a.hash),{sha256:u,bytes:m,sizeBytes:Number(f.size),mode:T(f.mode)}}finally{await d.close().catch(()=>{});}}async function kt(e,t,n){let i=crypto.createHash("sha256"),o=n?new Uint8Array(t):void 0,a=0;for(;a<t;){let d=Math.min(Tt,t-a),c=new Uint8Array(d),u=0;for(;u<d;){let m=await e.read(c,u,d-u,a+u);m.bytesRead<=0&&r("TAMPERED_CONTENT"),u+=m.bytesRead;}i.update(c),o?.set(c,a),a+=d;}return {sha256:i.digest("hex"),bytes:o}}async function xt(e,t){let n=0;for(;n<t.length;){let i=await e.write(t,n,t.length-n,null);i.bytesWritten<=0&&r("IO_ERROR"),n+=i.bytesWritten;}}async function*Ct(e){yield e;}async function Fe(e,t,n){try{await l(e);let i=await w(t);if(!i)return await l(e),"absent";if(i.isSymbolicLink()||!i.isFile()||i.dev!==n.dev||i.ino!==n.ino)return "foreign";await l(e);let o=await w(t);if(!o)return await l(e),"absent";if(o.isSymbolicLink()||!o.isFile()||o.dev!==n.dev||o.ino!==n.ino)return "foreign";try{return await fs.promises.unlink(t),"removed"}catch(a){if(p(a)==="ENOENT"){await l(e);let s=await w(t);return await l(e),s?"foreign":"absent"}return "failed"}}catch{return "failed"}}async function Ne(e){await l(e);let t=await fs.promises.open(e.root,fs.constants.O_RDONLY|fs.constants.O_DIRECTORY|fs.constants.O_NOFOLLOW);try{let n=await t.stat({bigint:!0}),i=e.pins[e.pins.length-1];(!n.isDirectory()||n.dev!==i.dev||n.ino!==i.ino)&&r("ROOT_UNSAFE"),await l(e),await t.sync(),await l(e);}finally{await t.close().catch(()=>{});}}function He(e){try{return process.kill(e,0),"live"}catch(t){return p(t)==="ESRCH"?"dead":"uncertain"}}function Y(e){return typeof e=="object"&&e!==null&&!Array.isArray(e)}function p(e){return typeof e=="object"&&e!==null&&"code"in e?String(e.code):void 0}function P(e){return e instanceof N?e:p(e)==="ELOOP"?new N("SYMLINK"):p(e)==="ENOENT"?new N("NOT_FOUND"):new N("IO_ERROR")}function r(e){throw new N(e)}exports.AttachmentReceiveError=N;exports.RECEIVED_ID_RE=xe;exports.acquireReceiveRootLease=un;exports.inspectReceived=sn;exports.listReceived=fn;exports.readVerifiedReceived=cn;exports.receive=an;exports.removeReceived=ln;exports.sweepReceiveTemp=mn;exports.sweepReceiveTempDetailed=ht;exports.verifyMaterializedFile=dn;

package/dist/boxing/box.types.d.ts

@@ -43,11 +43,15 @@ export interface ThreadMessage {
     content: string;
     timestamp: string;
     metadata: Record<string, unknown> | null;
+    contentTruncated?: boolean;
+    originalTokens?: number;
+    includedTokens?: number;
 }
 export interface ContextBuildParams {
     maxTokens: number;
     hotzoneRatio: number;
     warmzoneRatio: number;
+    minGuaranteedPairs?: number;
 }
 export interface ContextBuildResponse {
     hot: ThreadMessage[];

package/dist/config/canonicalize-agent-options.d.ts

@@ -1,3 +1,4 @@
+export declare function normalizeClaudeMode(mode: string): string;
 export interface AgentOptionsLike {
     query?: unknown;
     execute?: unknown;
@@ -13,4 +14,5 @@ export interface CanonicalizeAgentOptionsResult {
     changed: boolean;
     removed: string[];
 }
+export declare function normalizeProviderMode(providerId: string, mode: string): string;
 export declare function canonicalizeAgentOptions(input: CanonicalizeAgentOptionsInput): CanonicalizeAgentOptionsResult;

package/dist/config/default-agent-models.d.ts

@@ -0,0 +1,11 @@
+import { type ProviderExecutionOptions } from './models.generated.js';
+export type DefaultAgentStage = {
+    model: string;
+    query: Pick<ProviderExecutionOptions, 'mode' | 'effort'>;
+    execute: Pick<ProviderExecutionOptions, 'mode' | 'effort'>;
+};
+export interface DefaultAgentProfile {
+    planner: DefaultAgentStage;
+    worker: DefaultAgentStage;
+}
+export declare function getDefaultAgentProfile(provider: string): DefaultAgentProfile | undefined;

package/dist/config/global-settings.d.ts

@@ -0,0 +1,33 @@
+import { mkdirSync, readFileSync, renameSync, statSync, writeFileSync } from 'fs';
+import type { LocalServerSettings } from '../local-server/types';
+export interface GlobalSettings {
+    cron?: {
+        auto_start?: boolean;
+        [key: string]: unknown;
+    };
+    ai_server?: LocalServerSettings;
+    [key: string]: unknown;
+}
+export type DeepPartial<T> = T extends object ? {
+    [K in keyof T]?: DeepPartial<T[K]>;
+} : T;
+export interface GlobalSettingsStore {
+    read(): GlobalSettings;
+    update(patch: DeepPartial<GlobalSettings>): GlobalSettings;
+    set(key: string, value: unknown): GlobalSettings;
+    remove(key: string): GlobalSettings;
+    readonly path: string;
+}
+interface GlobalSettingsFileSystem {
+    mkdirSync: typeof mkdirSync;
+    readFileSync: typeof readFileSync;
+    renameSync: typeof renameSync;
+    statSync: typeof statSync;
+    writeFileSync: typeof writeFileSync;
+}
+export interface CreateGlobalSettingsStoreOptions {
+    filePath?: string;
+    fileSystem?: Partial<GlobalSettingsFileSystem>;
+}
+export declare function createGlobalSettingsStore(opts?: CreateGlobalSettingsStoreOptions): GlobalSettingsStore;
+export {};

package/dist/config/migrate-grok-mode.d.ts

@@ -0,0 +1,6 @@
+export type GrokSandbox = 'workspace' | 'read-only' | 'off';
+export interface GrokNativeOptions {
+    alwaysApprove?: boolean;
+    sandbox?: GrokSandbox;
+}
+export declare function migrateGrokLegacyMode<T>(slot: T): T;

package/dist/config/model-compat.d.ts

@@ -0,0 +1,31 @@
+export declare const CLAUDE_OPUS_4_8_BASE_MODEL_ID: "claude-opus-4-8";
+export declare const CLAUDE_OPUS_4_8_LEGACY_MODEL_ID: "claude-opus-4-8[1m]";
+export declare const CLAUDE_MODEL_COMPATIBILITY_PAIRS: readonly [{
+    readonly baseModelId: "claude-opus-4-8";
+    readonly catalogModelId: "claude-opus-4-8[1m]";
+}, {
+    readonly baseModelId: "claude-opus-4-7";
+    readonly catalogModelId: "claude-opus-4-7[1m]";
+}, {
+    readonly baseModelId: "claude-opus-4-6";
+    readonly catalogModelId: "claude-opus-4-6[1m]";
+}, {
+    readonly baseModelId: "claude-sonnet-4-6";
+    readonly catalogModelId: "claude-sonnet-4-6[1m]";
+}];
+export declare function normalizeAntigravityMode(mode: string): string;
+export declare function resolveCatalogModelId(model: string): string;
+export declare const ANTIGRAVITY_MODEL_COMPATIBILITY: ReadonlyArray<{
+    legacyId: string;
+    model: string;
+    effort?: string;
+}>;
+export type AntigravityResolvedModel = {
+    model?: string;
+    effort?: string;
+};
+export declare function resolveAntigravityModel(model?: string): AntigravityResolvedModel;
+export declare function resolveProviderCatalogModel(providerId: string, model?: string): {
+    model?: string;
+    effort?: string;
+};

package/dist/config/models.generated.d.ts

@@ -1,7 +1,20 @@
+import type { ModelApiPricing } from './pricing.types.js';
+export declare const MODEL_TIERS: readonly ["flagship", "balanced", "speed"];
+export type ModelTier = (typeof MODEL_TIERS)[number];
+export declare const EFFORT_LEVELS: readonly ["none", "minimal", "low", "medium", "high", "xhigh", "max", "ultra"];
+export type EffortLevel = (typeof EFFORT_LEVELS)[number];
+export type KnownEffortLevel = EffortLevel;
+export declare const PROVIDER_ARGV_EFFORTS: Record<string, readonly string[]>;
+export declare const MODEL_CATALOG_VERSION = 38;
+export declare const MODEL_CATALOG_UPDATED = "2026-10-29T00:00:00Z";
 export interface ModelCatalogEntry {
     id: string;
     name: string;
     description?: string;
+    contextWindowTokens?: number;
+    tier?: ModelTier;
+    recommended?: boolean;
+    apiPricing?: ModelApiPricing;
 }
 export interface ProviderModeEntry {
     id: string;
@@ -12,11 +25,36 @@ export interface ProviderModelOverride {
     effort?: string[];
     defaultEffort?: string;
 }
+export type ProviderOptionSpec = {
+    key: string;
+    type: 'boolean';
+} | {
+    key: string;
+    type: 'enum';
+    values: string[];
+};
+export interface ProviderExecutionOptions {
+    mode: string;
+    effort: string;
+    providerOptions?: Record<string, unknown>;
+}
+export interface ProviderDefaultProfile {
+    model: string;
+    query: ProviderExecutionOptions;
+    execute: ProviderExecutionOptions;
+}
+export interface ProviderDefaults {
+    version: number;
+    providers: Record<string, ProviderDefaultProfile>;
+}
 export interface ProviderCatalogEntry {
     models: ModelCatalogEntry[];
+    suggestedModels?: ModelCatalogEntry[];
     modes: ProviderModeEntry[];
     effort: string[];
     modelOverrides: Record<string, ProviderModelOverride>;
+    providerOptions?: ProviderOptionSpec[];
 }
 export declare const PROVIDER_CATALOGS: Record<string, ProviderCatalogEntry>;
+export declare const PROVIDER_DEFAULTS: ProviderDefaults;
 export declare const PROVIDER_MODELS: Record<string, ModelCatalogEntry[]>;

package/dist/config/models.remote.d.ts

@@ -1,3 +1,4 @@
+export declare const MIN_REMOTE_CATALOG_VERSION = 20;
 export declare function initModelsRemote(opts?: {
     endpoint?: string;
     ttlMs?: number;

package/dist/config/overdrive.d.ts

@@ -3,6 +3,7 @@ export interface OverdriveProfile {
     model?: string;
     mode?: string;
     effort?: string;
+    providerOptions?: Record<string, unknown>;
 }
 export type OverdriveSignalInput = boolean | {
     mode?: 'count' | 'latch';
@@ -20,5 +21,11 @@ export interface OverdriveResolution {
     mode?: string;
     effort?: string;
     crossProvider: boolean;
+    providerOptions?: Record<string, unknown>;
 }
 export declare function resolveOverdrive(agentOptions: unknown, mode: 'query' | 'execute', baseProvider: string, signal: OverdriveSignal): OverdriveResolution;
+export interface ModeOverrideResolution {
+    provider?: string;
+    model?: string;
+}
+export declare function resolveModeOverride(agentOptions: unknown, mode: 'query' | 'execute'): ModeOverrideResolution;

package/dist/config/pricing.d.ts

@@ -1,9 +1,12 @@
-import type { ModelPricing } from './pricing.types.js';
-export type { ModelPricing } from './pricing.types.js';
-export { MODEL_PRICING } from './pricing.generated.js';
+import type { ModelApiPricing, ModelPricing } from './pricing.types.js';
+export type { ModelApiPricing, ModelPricing } from './pricing.types.js';
+export { MODEL_PRICING, UNPUBLISHED_MODEL_IDS } from './pricing.generated.js';
 export declare function setPricingOverride(models: Record<string, ModelPricing>): void;
 export declare function clearPricingOverride(): void;
+export declare function setApiPricingOverride(models: Record<string, ModelApiPricing>): void;
+export declare function clearApiPricingOverride(): void;
 export declare function normalizeModel(model: string): string;
+export declare function lookupApiPricing(model: string | null | undefined): ModelApiPricing | undefined;
 export declare function getPricing(model: string | null | undefined): ModelPricing;
 export declare function calculateCost(inputTokens: number, outputTokens: number, model: string | null | undefined, cachedInputTokens?: number, _date?: Date): number;
 export declare function resolveCost(costUsd: number | undefined, inputTokens: number | undefined, outputTokens: number | undefined, cachedInputTokens: number | undefined, model: string | null | undefined, date?: Date): number;

package/dist/config/pricing.generated.d.ts

@@ -1,2 +1,6 @@
 import type { ModelPricing } from './pricing.types.js';
 export declare const MODEL_PRICING: Record<string, ModelPricing>;
+export declare const MODEL_PRICING_VERSION = 38;
+export declare const MODEL_PRICING_UPDATED = "2026-10-29T00:00:00Z";
+export declare const UNPUBLISHED_MODEL_IDS: ReadonlySet<string>;
+export declare const CATALOG_MODEL_IDS: ReadonlySet<string>;

package/dist/config/pricing.types.d.ts

@@ -3,3 +3,7 @@ export interface ModelPricing {
     cachedInput: number;
     output: number;
 }
+export interface ModelApiPricing {
+    inputPerMillionTokensUsd: number;
+    outputPerMillionTokensUsd: number;
+}

package/dist/config/timeout.config.d.ts

@@ -1,5 +1,9 @@
 export interface TimeoutConfig {
     queryMs: number;
     executeMs: number;
+    idleMs: number;
 }
+export declare const DEFAULT_IDLE_MS: number;
+export declare const DEFAULT_RESUME_TIMEOUT_MS = 60000;
+export declare function parseIdleEnvOverride(env?: NodeJS.ProcessEnv): number | undefined;
 export declare function getProviderTimeoutConfig(env?: NodeJS.ProcessEnv): TimeoutConfig;

package/dist/config/wi-boards.d.ts

@@ -0,0 +1,19 @@
+import type { CrewxProjectConfig } from '../types';
+export declare const DEFAULT_WI_BOARD_ID = "default";
+export declare const ARCHIVE_WI_BOARD_ID = "archive";
+export declare const DEFAULT_WI_WORKFLOW_ID = "wi-default-flow";
+export declare const WI_PLAN_WORKFLOW_ID = "wi-plan-flow";
+export declare const WI_DEFAULT_FLOW_FILENAME = "wi-default-flow.yaml";
+export declare const WI_PLAN_FLOW_FILENAME = "wi-plan-flow.yaml";
+export declare const WI_BOARD_ID_PATTERN: RegExp;
+export declare function isReservedWiBoardId(id: string): boolean;
+export interface ResolvedWiBoard {
+    id: string;
+    name: string;
+    workflowId: string;
+    description?: string;
+    goalId?: string;
+    system: boolean;
+    readOnly: boolean;
+}
+export declare function resolveWiBoards(config: CrewxProjectConfig | undefined): ResolvedWiBoard[];

package/dist/context/GoalLoader.d.ts

@@ -1,2 +1,8 @@
 import type { IFsAdapter } from '../platform/IFsAdapter';
+export interface GoalFileContent {
+    file: string;
+    path: string;
+    content: string;
+}
+export declare function loadActiveGoalFiles(goalPath: string, fs?: IFsAdapter, filter?: boolean | string | string[]): Promise<GoalFileContent[]>;
 export declare function loadActiveGoals(goalPath: string, fs?: IFsAdapter, filter?: boolean | string | string[]): Promise<string>;

package/dist/context-budget/continuity.d.ts

@@ -0,0 +1,64 @@
+import type { ConversationHighlight, ConversationThreadState, HistoryLookupNotice, SemanticContinuityContext, TemplateMessage } from '../conversation/types.js';
+export declare const DEFAULT_PROTECTED_TURN_COUNT = 5;
+export declare const DEFAULT_HIGHLIGHT_BUDGET_PERCENT = 5;
+export declare const MAX_ACTIVE_HIGHLIGHTS = 12;
+export declare const MAX_ACTIVE_HIGHLIGHT_CHARS = 2000;
+export declare const MAX_THREAD_TITLE_CHARS = 200;
+export declare const MAX_THREAD_STATE_VALUE_CHARS = 64;
+export interface ConversationTurn {
+    taskId?: string;
+    messages: TemplateMessage[];
+    ordinal: number;
+}
+export interface GroupedConversationTurns {
+    turns: ConversationTurn[];
+    unpairedMessages: TemplateMessage[];
+    droppedMessages: TemplateMessage[];
+}
+export interface ConversationTurnSelection {
+    includedTurns: ConversationTurn[];
+    omittedTurns: ConversationTurn[];
+    protectedTurns: ConversationTurn[];
+    tokenCount: number;
+    protectedTokenCount: number;
+    overBudget: boolean;
+}
+export interface SelectConversationTurnsOptions {
+    turns: readonly ConversationTurn[];
+    maxTokenCount: number;
+    countTokens: (text: string) => number;
+    protectedTurnCount?: number;
+    materializeTurn?: (turn: ConversationTurn) => string;
+}
+export interface ConversationHighlightSelection {
+    includedHighlights: ConversationHighlight[];
+    omittedHighlights: ConversationHighlight[];
+    truncatedHighlights: number;
+    representedTaskIds: string[];
+    unrepresentedTaskIds: string[];
+    tokenCount: number;
+    budgetTokens: number;
+}
+export interface SelectConversationHighlightsOptions {
+    highlights: readonly ConversationHighlight[];
+    omittedTaskIds: readonly string[];
+    taskOrder: readonly string[];
+    maxTokenCount: number;
+    countTokens: (text: string) => number;
+    applySafetyCap?: boolean;
+}
+export declare function getConversationMessageTaskId(message: TemplateMessage): string | undefined;
+export declare function groupConversationTurns(messages: readonly TemplateMessage[]): GroupedConversationTurns;
+export declare function withoutDroppedAppCards(messages: readonly TemplateMessage[]): TemplateMessage[];
+export declare function materializeConversationTurn(turn: ConversationTurn, includeActivityLog?: boolean): string;
+export declare function selectConversationTurns(options: SelectConversationTurnsOptions): ConversationTurnSelection;
+export declare function buildThreadStateContext(state: ConversationThreadState | undefined): ConversationThreadState | undefined;
+export declare function selectConversationHighlights(options: SelectConversationHighlightsOptions): ConversationHighlightSelection;
+export interface BuildSemanticContinuityContextOptions {
+    highlights: readonly ConversationHighlight[];
+    omittedTaskIds: readonly string[];
+    representedTaskIds: readonly string[];
+    historyLookup?: HistoryLookupNotice;
+    applySafetyCap?: boolean;
+}
+export declare function buildSemanticContinuityContext(options: BuildSemanticContinuityContextOptions): SemanticContinuityContext;