@crewx/sdk 0.9.0-rc.9 → 0.9.0-rc.91

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

@@ -0,0 +1,140 @@
+export declare const DEFAULT_INPUT_BUDGET_PERCENT = 60;
+export declare const MIN_INPUT_BUDGET_PERCENT = 30;
+export declare const MAX_INPUT_BUDGET_PERCENT = 80;
+export declare const INPUT_BUDGET_TOKENIZER_ENCODING = "o200k_base";
+export declare const FRESH_PROVIDER_INITIAL_INPUT_SEPARATOR = "\n\n---\n\n";
+export declare const FRESH_PROVIDER_INITIAL_INPUT_FRAMING = "system_prompt\\n\\n---\\n\\nmessage";
+export declare const RESUME_PROVIDER_INITIAL_INPUT_FRAMING = "message";
+export type InputBudgetUnresolvedReason = 'invalid_input_budget_percent' | 'provider_catalog_unavailable' | 'model_not_found' | 'context_window_tokens_unavailable';
+export type TokenizerFallbackReason = 'vendor_tokenizer_unavailable';
+export interface ResolveInputBudgetOptions {
+    provider: string;
+    model: string;
+    inputBudgetPercent?: number;
+}
+export interface TokenizerOptions {
+    provider?: string;
+    model?: string;
+}
+export interface TokenizerMetadata {
+    provider: string;
+    model: string;
+    encoding: typeof INPUT_BUDGET_TOKENIZER_ENCODING;
+    exact: boolean;
+    fallbackReason?: TokenizerFallbackReason;
+}
+export interface ResolvedInputBudget {
+    resolved: true;
+    requestedProvider: string;
+    provider: string;
+    model: string;
+    contextWindowTokens: number;
+    inputBudgetPercent: number;
+    inputBudgetTokens: number;
+    tokenizer: TokenizerMetadata;
+}
+export interface UnresolvedInputBudget {
+    resolved: false;
+    requestedProvider: string;
+    provider: string;
+    model: string;
+    reason: InputBudgetUnresolvedReason;
+    inputBudgetPercent?: number;
+    tokenizer: TokenizerMetadata;
+}
+export type ResolveInputBudgetResult = ResolvedInputBudget | UnresolvedInputBudget;
+export type ContextBudgetPhase = 'fresh' | 'resume';
+export type ProviderInitialInputFraming = typeof FRESH_PROVIDER_INITIAL_INPUT_FRAMING | typeof RESUME_PROVIDER_INITIAL_INPUT_FRAMING;
+export interface ContextBudgetLayoutCapability {
+    layoutId: string;
+    supportsSemanticContinuity: boolean;
+    slot: string | null;
+    requiredForOmittedTurns: boolean;
+    warning?: string;
+}
+export interface ContextBudgetActivityDegradation {
+    taskId: string;
+    taskDistance: number;
+    action: 'reduced' | 'omitted';
+}
+export type ContextBudgetAssemblyErrorCode = 'INPUT_BUDGET_EXCEEDED' | 'CONTINUITY_SLOT_REQUIRED';
+export declare class ContextBudgetLayoutError extends Error {
+    readonly layoutId: string;
+    readonly omittedTurnCount: number;
+    readonly code: "CONTINUITY_SLOT_REQUIRED";
+    constructor(message: string, layoutId: string, omittedTurnCount: number);
+}
+export interface ContextBudgetManifest {
+    phase: ContextBudgetPhase;
+    initialInputFraming: ProviderInitialInputFraming;
+    resolved: boolean;
+    reason?: InputBudgetUnresolvedReason;
+    requestedProvider: string;
+    requestedModel: string | null;
+    effectiveProvider: string;
+    effectiveModel: string | null;
+    contextWindowTokens: number | null;
+    inputBudgetPercent: number | null;
+    inputBudgetTokens: number | null;
+    tokenizer: TokenizerMetadata;
+    initialTokenCount: number | null;
+    finalTokenCount: number | null;
+    activityLogTokenCount: number | null;
+    activityIncludedEntries: number | null;
+    activityOmittedEntries: number | null;
+    activityRemovedForBudget: boolean;
+    activityNewestTaskTokenCap: number | null;
+    historyOriginalMessages: number;
+    historyIncludedMessages: number;
+    historyOmittedMessages: number;
+    turnOriginal: number;
+    turnIncluded: number;
+    turnOmitted: number;
+    highlightOriginal: number;
+    highlightIncluded: number;
+    highlightOmitted: number;
+    highlightTruncated: number;
+    representedOmittedTurns: number;
+    unrepresentedOmittedTurns: number;
+    activityDegraded: boolean;
+    activityIncludedTasks: number;
+    activityOmittedTasks: number;
+    activityDegradation: ContextBudgetActivityDegradation[];
+    highlightLookupFailed: boolean;
+    layoutCapability: ContextBudgetLayoutCapability;
+    overBudget: boolean;
+}
+export interface TokenCountResult {
+    tokenCount: number;
+    tokenizer: TokenizerMetadata;
+}
+export interface TokenCounter {
+    metadata: TokenizerMetadata;
+    countTokens(text: string): number;
+}
+export interface FreshProviderInitialInput {
+    systemPrompt?: string | null;
+    message: string;
+}
+type PieceCacheEventType = 'hit' | 'miss' | 'evict' | 'full_encode';
+interface PieceCacheEvent {
+    type: PieceCacheEventType;
+    piece?: string;
+    tokenCount?: number;
+    reason?: 'special_token';
+}
+type PieceCacheObserver = (event: PieceCacheEvent) => void;
+interface TokenCounterInternalOptions {
+    pieceCacheMaxEntries?: number;
+    observePieceCache?: PieceCacheObserver;
+}
+export declare function normalizeInputBudgetProvider(provider: string): string;
+export declare function resolveTokenizerMetadata(options?: TokenizerOptions): TokenizerMetadata;
+export declare function countTokens(text: string, options?: TokenizerOptions): TokenCountResult;
+export declare function renderFreshProviderInitialInput(input: FreshProviderInitialInput): string;
+export declare function countFreshProviderInitialInput(input: FreshProviderInitialInput, count: (text: string) => number): number;
+export declare function createTokenCounter(options?: TokenizerOptions): TokenCounter;
+export declare function __createTokenCounterForTest(options?: TokenizerOptions, internalOptions?: TokenCounterInternalOptions): TokenCounter;
+export declare function resolveInputBudget(options: ResolveInputBudgetOptions): ResolveInputBudgetResult;
+export { DEFAULT_HIGHLIGHT_BUDGET_PERCENT, DEFAULT_PROTECTED_TURN_COUNT, MAX_ACTIVE_HIGHLIGHT_CHARS, MAX_ACTIVE_HIGHLIGHTS, MAX_THREAD_STATE_VALUE_CHARS, MAX_THREAD_TITLE_CHARS, buildSemanticContinuityContext, buildThreadStateContext, getConversationMessageTaskId, groupConversationTurns, materializeConversationTurn, selectConversationHighlights, selectConversationTurns, } from './continuity.js';
+export type { BuildSemanticContinuityContextOptions, ConversationHighlightSelection, ConversationTurn, ConversationTurnSelection, GroupedConversationTurns, SelectConversationHighlightsOptions, SelectConversationTurnsOptions, } from './continuity.js';

package/dist/conversation/index.d.ts

@@ -1,3 +1,3 @@
 export * from './types.js';
 export { toTaskReader } from './to-task-reader.js';
-export { toTemplateMessages } from './to-template-messages.js';
+export { LEGACY_UI_CARD_SAFE_SUMMARY, sanitizeLegacyUiCardText, sanitizeTemplateMessages, toTemplateMessages, } from './to-template-messages.js';

package/dist/conversation/sqlite-provider.d.ts

@@ -1,8 +1,9 @@
-import type { ConversationThread, FetchHistoryOptions, IConversationHistoryProvider, Platform } from './types';
+import type { ConversationHighlight, ConversationThread, ConversationThreadState, FetchHistoryOptions, IConversationHistoryProvider, Platform } from './types';
 export declare class SqliteConversationProvider implements IConversationHistoryProvider {
     private readonly dbPath;
     constructor(dbPath?: string);
     private getThreadRepo;
+    private getThreadHistoryRepo;
     updateThread(id: string, patch: {
         title?: string;
     }): void;
@@ -10,6 +11,8 @@ export declare class SqliteConversationProvider implements IConversationHistoryP
         created: boolean;
     }>;
     fetchHistory(threadId: string, options?: FetchHistoryOptions): Promise<ConversationThread>;
+    fetchThreadState(threadId: string): Promise<ConversationThreadState | undefined>;
+    fetchHighlights(threadId: string): Promise<ConversationHighlight[] | undefined>;
     saveUserMessage(threadId: string, text: string, _userId?: string, _metadata?: Record<string, unknown>): Promise<{
         id: string;
         firstMessage: boolean;
@@ -19,5 +22,6 @@ export declare class SqliteConversationProvider implements IConversationHistoryP
     }>;
     close(): void;
     private normalizeStatus;
+    private readActiveHighlights;
     private rowsToMessages;
 }

package/dist/conversation/to-template-messages.d.ts

@@ -1,2 +1,9 @@
 import type { ConversationThread, TemplateMessage } from './types';
+import type { UiAgentContextProjection } from '../ui-instance/types.js';
+export declare const LEGACY_UI_CARD_SAFE_SUMMARY = "[workflow card omitted from AI context]";
+export declare const V2_UI_INSTANCE_SAFE_SUMMARY = "[workflow UI instance omitted from AI context]";
+export declare function sanitizeUiInstanceReferenceText(text: string): string;
+export declare function sanitizeLegacyUiCardText(text: string): string;
+export declare function sanitizeTemplateMessages(messages: readonly TemplateMessage[]): TemplateMessage[];
+export declare function appendUiProjections(messages: readonly TemplateMessage[], projections: readonly UiAgentContextProjection[] | undefined): TemplateMessage[];
 export declare function toTemplateMessages(thread: ConversationThread): TemplateMessage[];

package/dist/conversation/types.d.ts

@@ -4,13 +4,50 @@ export interface ConversationMessage {
     text: string;
     isAssistant: boolean;
     timestamp: number;
+    taskId?: string;
     metadata?: Record<string, unknown>;
 }
 export type Platform = 'cli' | 'web' | 'api' | 'mcp' | `channel/${string}`;
+export interface ConversationHighlight {
+    id: string;
+    text: string;
+    kind?: string;
+    source?: string;
+    coversFromTaskId?: string;
+    coversToTaskId?: string;
+    covers_from_task_id?: string;
+    covers_to_task_id?: string;
+    createdAt?: number | string;
+    created_at?: number | string;
+}
+export interface SemanticContinuityContext {
+    highlights: ConversationHighlight[];
+    truncatedHighlights?: number;
+    omittedTurns: {
+        count: number;
+        represented: number;
+        unrepresented: number;
+        taskIds: string[];
+    };
+    rendered?: string;
+}
+export type ConversationSemanticContinuityContext = SemanticContinuityContext;
+export interface ConversationThreadStateValue {
+    code: string;
+    name: string;
+}
+export interface ConversationThreadState {
+    title?: string;
+    priority?: ConversationThreadStateValue;
+    state?: ConversationThreadStateValue;
+    rendered?: string;
+}
+export type ThreadStateContext = ConversationThreadState;
 export interface ConversationThread {
     threadId: string;
     platform: Platform;
     messages: ConversationMessage[];
+    highlights?: ConversationHighlight[];
     metadata?: {
         title?: string;
         firstMessage?: string;
@@ -20,10 +57,13 @@ export interface ConversationThread {
     };
 }
 export interface TemplateMessage {
+    id?: string;
     text: string;
     isAssistant: boolean;
+    taskId?: string;
     timestamp?: number;
     metadata?: Record<string, unknown>;
+    activity_log?: string;
     files?: Array<{
         name: string;
         size?: number;
@@ -33,6 +73,7 @@ export interface TemplateMessage {
 export interface FetchHistoryOptions {
     limit?: number;
     maxContextLength?: number;
+    includeHighlights?: boolean;
     currentTraceId?: string;
 }
 export interface IConversationHistoryProvider {
@@ -40,6 +81,8 @@ export interface IConversationHistoryProvider {
         created: boolean;
     }>;
     fetchHistory(threadId: string, options?: FetchHistoryOptions): Promise<ConversationThread>;
+    fetchThreadState?(threadId: string): Promise<ConversationThreadState | undefined>;
+    fetchHighlights?(threadId: string): Promise<ConversationHighlight[] | undefined>;
     saveUserMessage(threadId: string, text: string, userId?: string, metadata?: Record<string, unknown>): Promise<{
         id: string;
         firstMessage: boolean;

package/dist/desktop/command-runner.d.ts

@@ -0,0 +1,4 @@
+import { type ChildProcess } from 'node:child_process';
+import type { CommandRunner } from './types';
+export declare function killProcessTree(child: ChildProcess): void;
+export declare const defaultCommandRunner: CommandRunner;

package/dist/desktop/default-adapters.d.ts

@@ -0,0 +1,4 @@
+import { homedir } from 'node:os';
+import type { ShortcutFsLike } from './types';
+export declare const nodeShortcutFs: ShortcutFsLike;
+export declare const osHomedir: typeof homedir;

package/dist/desktop/global-install.d.ts

@@ -0,0 +1,19 @@
+import type { CommandRunner, GlobalCrewxInfo, ShortcutProgressEvent } from './types';
+export interface DetectGlobalCrewxOptions {
+    env: NodeJS.ProcessEnv;
+    cwd: string;
+    run: CommandRunner;
+}
+export declare function detectGlobalCrewx(opts: DetectGlobalCrewxOptions): Promise<GlobalCrewxInfo>;
+export interface EnsureGlobalCrewxOptions {
+    env: NodeJS.ProcessEnv;
+    cwd: string;
+    run: CommandRunner;
+    targetVersion: string;
+    currentInfo?: GlobalCrewxInfo;
+    installRoot?: string;
+    onProgress?: (event: ShortcutProgressEvent) => void;
+}
+export declare function ensureGlobalCrewx(opts: EnsureGlobalCrewxOptions): Promise<{
+    info: GlobalCrewxInfo;
+}>;

package/dist/desktop/index.d.ts

@@ -0,0 +1,2 @@
+export { getShortcutStatus, installShortcut, uninstallShortcut, dismissShortcutNotice, } from './install';
+export { ShortcutError, type ShortcutState, type DesktopSource, type GlobalCrewxInfo, type ShortcutStatus, type ShortcutInstallResult, type ShortcutProgressPhase, type ShortcutProgressEvent, type ShortcutEnvOptions, type InstallShortcutOptions, type ShortcutErrorCode, type CommandResult, type CommandRunner, type CommandRunOptions, type ShortcutFsLike, } from './types';

package/dist/desktop/index.js

@@ -0,0 +1,3 @@
+'use strict';var f=require('path'),crypto=require('crypto'),fs=require('fs'),os=require('os'),child_process=require('child_process'),string_decoder=require('string_decoder'),module$1=require('module');function _interopNamespace(e){if(e&&e.__esModule)return e;var n=Object.create(null);if(e){Object.keys(e).forEach(function(k){if(k!=='default'){var d=Object.getOwnPropertyDescriptor(e,k);Object.defineProperty(n,k,d.get?d:{enumerable:true,get:function(){return e[k]}});}})}n.default=e;return Object.freeze(n)}var f__namespace=/*#__PURE__*/_interopNamespace(f);var B=(e=>typeof require<"u"?require:typeof Proxy<"u"?new Proxy(e,{get:(t,n)=>(typeof require<"u"?require:t)[n]}):e)(function(e){if(typeof require<"u")return require.apply(this,arguments);throw Error('Dynamic require of "'+e+'" is not supported')});var h=class extends Error{code;constructor(t,n){super(`${t}: ${n}`),this.code=t,this.name="ShortcutError";}};var z={existsSync:e=>fs.existsSync(e),readFileSync:e=>fs.readFileSync(e,"utf8"),readBinaryFileSync:e=>new Uint8Array(fs.readFileSync(e)),writeFileSync:(e,t)=>fs.writeFileSync(e,t,"utf8"),mkdirSync:e=>{fs.mkdirSync(e,{recursive:true});},unlinkSync:e=>{fs.unlinkSync(e);}},q=os.homedir;function N(e){return typeof e!="string"?void 0:e.trim()||void 0}function O(e){return N(e)?.toLowerCase()??""}function b(e){try{return fs.statSync(e).isFile()}catch{return  false}}function Me(e,t){if(e===t)return  true;let n=f__namespace.default.relative(e,t);return n!==""&&!n.startsWith("..")&&!f__namespace.default.isAbsolute(n)}function $e(e,t){if(f__namespace.default.basename(e)!==".bin")return  false;let n=f__namespace.default.dirname(e);if(f__namespace.default.basename(n)!=="node_modules")return  false;let r=f__namespace.default.dirname(n);return Me(r,t)}function Y(e,t={}){if(e.includes("/")||e.includes("\\")||f__namespace.default.isAbsolute(e))return e;let n=t.platform??process.platform,r=t.env??process.env,i=f__namespace.default.resolve(t.cwd??process.cwd()),l=(t.resolution??"global_first")==="global_first",o=r.PATH??r.Path??process.env.PATH??process.env.Path??"",a=n==="win32"?";":":",s=o.split(a).map(u=>u.trim()).filter(Boolean),c=f__namespace.default.extname(e).length>0,d=r.PATHEXT??r.Pathext??process.env.PATHEXT??process.env.Pathext??".EXE;.CMD;.BAT;.COM",p=n==="win32"?c?[""]:d.split(";").map(u=>u.trim()).filter(Boolean).map(u=>u.startsWith(".")?u:`.${u}`):[""];for(let u of s){let S=f__namespace.default.resolve(i,u);if(!(l&&$e(S,i)))for(let w of p){let v=O(w),m=w.toUpperCase();for(let g of [w,v,m]){let y=f__namespace.default.join(S,`${e}${g}`);if(b(y))return y}}}return e}function He(e){if(!b(e))return null;try{let t=fs.readFileSync(e,"utf8"),n=f__namespace.default.dirname(e),r=[];for(let a of t.matchAll(/"([^"\r\n]*)"/g)){let d=(a[1]??"").match(/%~?dp0%?\s*[\\/]*(.*)$/i)?.[1]?.trim();if(!d)continue;let p=d.replace(/[\\/]+/g,f__namespace.default.sep).replace(/^[\\/]+/,""),u=f__namespace.default.resolve(n,p);b(u)&&r.push(u);}let i=[],l=new Map;for(let a of t.matchAll(/SET\s+"(\w+)=%~?dp0%?[\\/]?([^"]+)"/gi)){let s=a[1].toUpperCase(),c=a[2].trim().replace(/[\\/]+/g,f__namespace.default.sep).replace(/^[\\/]+/,"");l.set(s,f__namespace.default.resolve(n,c));}for(let a of t.split(/\r?\n/))if(a.includes("%*"))for(let s of a.matchAll(/"%(\w+)%"/g)){let c=l.get(s[1].toUpperCase());c&&b(c)&&i.push(c);}let o=a=>a.find(s=>{let c=O(f__namespace.default.basename(s));return c!=="node.exe"&&c!=="node"})??null;return o(i)??o(r)}catch{return null}}function Ve(e,t){if(typeof t=="string")return N(t)||null;if(!t||typeof t!="object")return null;if(e){let n=t[e],r=typeof n=="string"?N(n):void 0;if(r)return r}for(let n of Object.values(t)){let r=typeof n=="string"?N(n):void 0;if(r)return r}return null}function Ue(e,t){if(!t)return null;let n=f__namespace.default.dirname(e),r=[f__namespace.default.resolve(n,"..",t),f__namespace.default.resolve(n,"node_modules",t)];for(let i of r){let l=f__namespace.default.join(i,"package.json");if(b(l))try{let o=JSON.parse(fs.readFileSync(l,"utf8")),a=Ve(t,o.bin);if(!a)continue;let s=f__namespace.default.resolve(i,a);if(b(s))return s}catch{}}return null}function Xe(e){let t=e.platform??process.platform,n=e.env??process.env,r=e.execPath??process.execPath,i=e.cwd,l=e.resolution;if(t!=="win32")return {command:Y(e.command,{cwd:i,env:n,platform:t,resolution:l}),leadingArgv:[],resolution:"direct"};let o=Y(e.command,{cwd:i,env:n,platform:t,resolution:l}),a=O(f__namespace.default.extname(o));if(a===".js"||a===".cjs"||a===".mjs")return {command:r,leadingArgv:[o],resolution:"node-entrypoint",windowsHide:true};if(a===".cmd"||a===".bat"){let s=He(o)??Ue(o,e.packageName);return s?O(f__namespace.default.extname(s))===".exe"?{command:s,leadingArgv:[],resolution:"exe-entrypoint",windowsHide:true}:{command:r,leadingArgv:[s],resolution:"node-entrypoint",windowsHide:true}:{command:o,leadingArgv:[],resolution:"unresolved-wrapper"}}return {command:o,leadingArgv:[],resolution:"direct"}}function Ge(e){if(e.candidate.resolution!=="unresolved-wrapper")return {command:e.candidate.command,leadingArgv:e.candidate.leadingArgv,resolution:e.candidate.resolution,windowsHide:e.candidate.windowsHide};throw new Error(`${f__namespace.default.basename(e.candidate.command)} wrapper resolved, but no executable/Node entrypoint could be resolved without shell execution.`)}function Z(e){let t=Xe(e);return Ge({candidate:t})}function ee(e,t){return {command:e.command,argv:[...e.leadingArgv,...t],resolution:e.resolution,shell:e.shell,windowsHide:e.windowsHide}}var A="\uFFFD",M=8,ne=1e3,je=new Map([[437,"ibm437"],[720,"ibm720"],[737,"ibm737"],[775,"ibm775"],[850,"ibm850"],[852,"ibm852"],[855,"ibm855"],[857,"ibm857"],[858,"ibm858"],[862,"ibm862"],[864,"ibm864"],[932,"shift_jis"],[936,"gb18030"],[949,"euc-kr"],[950,"big5"],[866,"ibm866"],[869,"ibm869"],[1250,"windows-1250"],[1251,"windows-1251"],[1252,"windows-1252"],[1253,"windows-1253"],[1254,"windows-1254"],[1255,"windows-1255"],[1256,"windows-1256"],[1257,"windows-1257"],[1258,"windows-1258"]]),D;function H(e){let t=0;for(let n of e)n===A&&(t+=1);return t}function $(e,t){return H(t)<H(e)?t:e}function Ke(e){let t=e.match(/(?:^|[^0-9])([0-9]{1,5})(?![0-9])/);if(!t)return null;let n=Number(t[1]);return Number.isInteger(n)&&n>0&&n<=65535?n:null}function ze(e){if(e!==65001)return je.get(e)}function qe(e){let t=ze(e);if(!t)return null;try{return new TextDecoder(t)}catch{return null}}function Ye(){return new Promise(e=>{let t=false,n,r=i=>{t||(t=true,n&&clearTimeout(n),e(i));};n=setTimeout(()=>r(null),ne),n.unref();try{child_process.execFile("chcp.com",[],{encoding:"ascii",timeout:ne,windowsHide:!0},(l,o)=>{if(l){r(null);return}r(Ke(String(o)));}).once("error",()=>r(null));}catch{r(null);}})}function ie(){return process.platform!=="win32"?Promise.resolve(null):(D||(D=Ye(),D.then(e=>{},()=>{})),D)}function Qe(){process.platform==="win32"&&ie();}function oe(e,t){if(t.length>=M)return t.subarray(t.length-M);let n=M-t.length,r=e.length>n?e.subarray(e.length-n):e;return Buffer.concat([r,t])}var k=class{platform;detectCodePage;utf8Decoder=new string_decoder.StringDecoder("utf8");codePage;fallbackDecoder;replayTail=Buffer.alloc(0);pendingUtf8="";pendingFallback="";pendingBytes=Buffer.alloc(0);queue=Promise.resolve();ended=false;constructor(t={}){this.platform=t.platform??process.platform,this.detectCodePage=t.detectCodePage??ie,this.codePage=t.codePage;}write(t){let n=Buffer.from(t);return this.enqueue(()=>this.decodeChunk(n))}end(){return this.enqueue(()=>this.finish())}enqueue(t){let n=this.queue.then(t);return this.queue=n.then(()=>{},()=>{}),n}clearPendingCandidate(){this.pendingUtf8="",this.pendingFallback="",this.pendingBytes=Buffer.alloc(0);}async resolveCodePage(){if(this.codePage!==void 0)return this.codePage;try{this.codePage=await this.detectCodePage();}catch{this.codePage=null;}return this.codePage}async getFallbackDecoder(){if(this.fallbackDecoder!==void 0)return this.fallbackDecoder;let t=await this.resolveCodePage();return this.fallbackDecoder=t===null?null:qe(t),this.fallbackDecoder}async decodeChunk(t){if(this.ended)return "";let n=this.utf8Decoder.write(t),r=n.includes(A);if(r&&(this.utf8Decoder=new string_decoder.StringDecoder("utf8")),this.platform!=="win32")return n;if(this.fallbackDecoder){let s=this.fallbackDecoder.decode(t,{stream:true}),c=oe(this.pendingBytes,t);if(r){let d=this.pendingUtf8+n,p=this.pendingFallback+s;return this.clearPendingCandidate(),$(d,p)}if(H(s)>0){let d=this.pendingUtf8+n;return this.clearPendingCandidate(),this.fallbackDecoder=void 0,this.replayTail=c,d}if(this.pendingUtf8||this.pendingFallback){if(this.pendingUtf8+=n,this.pendingFallback+=s,this.pendingBytes=c,n.length===0||s.length===0)return "";let d=this.pendingUtf8;return this.clearPendingCandidate(),d}return n.length===0&&s.length>0?(this.pendingUtf8=n,this.pendingFallback=s,this.pendingBytes=c,""):n}let i=this.replayTail;if(this.fallbackDecoder===void 0&&(this.replayTail=oe(this.replayTail,t)),!r)return n;let l=this.fallbackDecoder===void 0,o=await this.getFallbackDecoder();if(!o)return this.replayTail=Buffer.alloc(0),n;l&&i.length>0&&o.decode(i,{stream:true}),this.replayTail=Buffer.alloc(0);let a=o.decode(t,{stream:true});return $(n,a)}async finish(){if(this.ended)return "";this.ended=true;let t=this.utf8Decoder.end();if(this.platform!=="win32")return t;if(this.fallbackDecoder===void 0&&t.includes(A)){let l=await this.getFallbackDecoder();l&&this.replayTail.length>0&&(l.decode(this.replayTail,{stream:true}),this.replayTail=Buffer.alloc(0));}let n=this.pendingUtf8+t,r=this.fallbackDecoder?.decode()??"",i=this.pendingFallback+r;return this.clearPendingCandidate(),n.includes(A)?$(n,i):n}};Qe();var se=3e4;function Ze(e){if(typeof e.pid!="number"){e.kill();return}if(process.platform==="win32"){child_process.spawn("taskkill",["/pid",String(e.pid),"/t","/f"],{windowsHide:true}).on("error",()=>{});return}try{process.kill(-e.pid,"SIGKILL");}catch{e.kill("SIGKILL");}}var ce=(e,t,n={})=>new Promise((r,i)=>{let l=n.env??process.env,o=process.platform,a;try{let g=Z({command:e,platform:o,env:l,cwd:n.cwd,allowShellFallback:!1});a=ee(g,t);}catch(g){i(g instanceof Error?g:new Error(String(g)));return}let s=child_process.spawn(a.command,a.argv,{cwd:n.cwd,env:l,shell:a.shell,windowsHide:a.windowsHide??true,detached:o!=="win32"}),c="",d="",p=false,u=new k({platform:o}),S=new k({platform:o}),w=Promise.resolve(),v=Promise.resolve(),m=setTimeout(()=>{p||(p=true,Ze(s),i(new Error(`Command timed out after ${n.timeoutMs??se}ms: ${e} ${t.join(" ")}`)));},n.timeoutMs??se);s.stdout?.on("data",g=>{w=w.then(async()=>{c+=await u.write(g);});}),s.stderr?.on("data",g=>{v=v.then(async()=>{d+=await S.write(g);});}),s.on("error",g=>{p||(p=true,clearTimeout(m),i(g));}),s.on("close",g=>{p||(async()=>{await Promise.all([w,v]);let[y,Oe]=await Promise.all([u.end(),S.end()]);p||(c+=y,d+=Oe,p=true,clearTimeout(m),r({code:g??0,stdout:c,stderr:d}));})().catch(y=>{p||(p=true,clearTimeout(m),i(y instanceof Error?y:new Error(String(y))));});});});function nt(){try{return (typeof B=="function"?B:module$1.createRequire(__filename)).resolve("@crewx/sdk/package.json")}catch{return null}}function rt(){let e=[nt(),f.join(__dirname,"../../package.json"),f.join(__dirname,"../../../package.json")].filter(t=>!!t);for(let t of e)try{let n=JSON.parse(fs.readFileSync(t,"utf8"));if(n.name==="@crewx/sdk"&&n.version)return n.version}catch{}return "0.0.0"}var ue=rt();var E=f__namespace.win32;function V(e){return E.join(e,".crewx")}function fe(e){return E.join(V(e),"shortcut.json")}function pe(e){return E.join(V(e),"launcher.json")}function he(e){return E.join(V(e),"bin","crewx-launcher.cmd")}function me(e){return E.join(e,"CrewX.lnk")}function U(e,t){return E.normalize(e).toLowerCase()===E.normalize(t).toLowerCase()}var ot="[Console]::OutputEncoding = [System.Text.Encoding]::UTF8; [Environment]::GetFolderPath('DesktopDirectory')";async function ge(e){try{let n=await e.run("powershell",["-NoProfile","-NonInteractive","-Command",ot],{env:e.env}),r=n.stdout.trim();if(n.code===0&&r)return {dir:r,source:"known-folder"}}catch{}let t=e.env.USERPROFILE||e.env.Userprofile||e.homedir();return t?{dir:E.join(t,"Desktop"),source:"fallback"}:null}function X(e,t){let n=E.resolve(t,"node_modules",".bin").toLowerCase();return e.split(";").filter(r=>r?E.resolve(r).toLowerCase()!==n:true).join(";")}function we(e){return e?/\\Program Files( \(x86\))?\\/i.test(e)&&/crewx/i.test(e):false}function it(e,t){let n=s=>{let[c,...d]=s.split("-"),p=d.join("-")||void 0;return {parts:(c??"").split(".").map(S=>Number.parseInt(S,10)||0),pre:p}},r=n(e),i=n(t),l=Math.max(r.parts.length,i.parts.length);for(let s=0;s<l;s++){let c=r.parts[s]??0,d=i.parts[s]??0;if(c!==d)return c<d?-1:1}if(r.pre===i.pre)return 0;if(!r.pre&&i.pre)return 1;if(r.pre&&!i.pre)return  -1;let o=Number.parseInt(r.pre.match(/(\d+)$/)?.[1]??"",10),a=Number.parseInt(i.pre.match(/(\d+)$/)?.[1]??"",10);return !Number.isNaN(o)&&!Number.isNaN(a)&&o!==a?o<a?-1:1:r.pre<i.pre?-1:r.pre>i.pre?1:0}function x(e,t){return it(e,t)<0}var Pe=f__namespace.win32,Ee=1;function ve(e,t){if(!e.existsSync(t))return null;try{let n=JSON.parse(e.readFileSync(t));return {schema:n.schema??Ee,shortcutPath:n.shortcutPath,version:n.version,iconHash:typeof n.iconHash=="string"?n.iconHash:void 0,owned:!!n.owned,declined:!!n.declined,desktopSource:n.desktopSource,updatedAt:n.updatedAt}}catch{return null}}function T(e,t,n){let r={schema:Ee,...n,updatedAt:new Date().toISOString()};e.mkdirSync(Pe.dirname(t)),e.writeFileSync(t,JSON.stringify(r,null,2));}function W(e,t){if(!e.existsSync(t))return null;try{let n=JSON.parse(e.readFileSync(t));return {schema:n.schema??0,binPath:n.binPath,updatedAt:n.updatedAt}}catch{return null}}function ye(e,t,n){e.mkdirSync(Pe.dirname(t)),e.writeFileSync(t,JSON.stringify(n,null,2));}var st=f__namespace.win32,_=1;function at(e){return e.replace(/%/g,"%%")}function ct(e){return ["@echo off","setlocal DisableDelayedExpansion","chcp 65001 >nul","",'set "CREWX_WORKDIR=%USERPROFILE%\\crewx"','if not exist "%CREWX_WORKDIR%" mkdir "%CREWX_WORKDIR%" >nul 2>nul','cd /d "%CREWX_WORKDIR%"',"",'set "CREWX_PORT_EFFECTIVE=%CREWX_PORT%"','if "%CREWX_PORT_EFFECTIVE%"=="" set "CREWX_PORT_EFFECTIVE=8150"','set "CREWX_HEALTH_URL=http://127.0.0.1:%CREWX_PORT_EFFECTIVE%/api/v1/health"','set "CREWX_ORIGIN_URL=http://127.0.0.1:%CREWX_PORT_EFFECTIVE%/"',"",e.bakedBinPath?`set "CREWX_FALLBACK_BIN=${at(e.bakedBinPath)}"`:'set "CREWX_FALLBACK_BIN="','set "CREWX_RESOLVED_BIN=%CREWX_BIN%"','if "%CREWX_RESOLVED_BIN%"=="" set "CREWX_RESOLVED_BIN=%CREWX_FALLBACK_BIN%"','if "%CREWX_RESOLVED_BIN%"=="" (',`  for /f "delims=" %%I in ('where crewx 2^>nul') do (`,'    if not defined CREWX_RESOLVED_BIN set "CREWX_RESOLVED_BIN=%%I"',"  )",")","",'powershell -NoProfile -NonInteractive -Command "try { $r = Invoke-WebRequest -Uri $env:CREWX_HEALTH_URL -TimeoutSec 1 -UseBasicParsing; if ($r.StatusCode -eq 200) { exit 0 } else { exit 1 } } catch { exit 1 }"',"if %ERRORLEVEL% EQU 0 (",'  start "" "%CREWX_ORIGIN_URL%"',"  exit /b 0",")","",'if "%CREWX_RESOLVED_BIN%"=="" (',"  echo CrewX executable not found. Please reinstall the desktop shortcut.","  pause","  exit /b 1",")","",'start "CrewX" /min "%CREWX_RESOLVED_BIN%"',""].join(`\r
+`)}function Re(e){let t=W(e.fs,e.launcherManifestPath),n=!!t&&t.schema>=_&&e.fs.existsSync(e.wrapperPath),r=n&&!t.binPath&&!!e.bakedBinPath;if(n&&!r)return {wrapperPath:e.wrapperPath,wrote:false,schema:t.schema};let l=ct({bakedBinPath:e.bakedBinPath});try{e.fs.mkdirSync(st.dirname(e.wrapperPath)),e.fs.writeFileSync(e.wrapperPath,l),ye(e.fs,e.launcherManifestPath,{schema:_,binPath:e.bakedBinPath,updatedAt:new Date().toISOString()});}catch(o){throw o instanceof h?o:new h("WRITE_DENIED",`Could not write launcher wrapper: ${o instanceof Error?o.message:String(o)}`)}return {wrapperPath:e.wrapperPath,wrote:true,schema:_}}var lt=["$ws = New-Object -ComObject WScript.Shell","$sc = $ws.CreateShortcut($env:CREWX_LNK_PATH)","$sc.TargetPath = $env:CREWX_LNK_TARGET","if ($env:CREWX_LNK_WORKDIR) { $sc.WorkingDirectory = $env:CREWX_LNK_WORKDIR }","$sc.WindowStyle = 7","if ($env:CREWX_LNK_ICON) { $sc.IconLocation = $env:CREWX_LNK_ICON }","$sc.Save()"].join("; "),ut=["[Console]::OutputEncoding = [System.Text.Encoding]::UTF8","$ws = New-Object -ComObject WScript.Shell","$sc = $ws.CreateShortcut($env:CREWX_LNK_PATH)","[PSCustomObject]@{ TargetPath = $sc.TargetPath; WorkingDirectory = $sc.WorkingDirectory; IconLocation = $sc.IconLocation } | ConvertTo-Json -Compress"].join("; ");async function be(e){let t={...e.env,CREWX_LNK_PATH:e.shortcutPath,CREWX_LNK_TARGET:e.targetPath,CREWX_LNK_WORKDIR:e.workingDirectory??"",CREWX_LNK_ICON:e.iconPath??""},n;try{n=await e.run("powershell",["-NoProfile","-NonInteractive","-Command",lt],{env:t});}catch(r){throw new h("POWERSHELL_UNAVAILABLE",`Could not run PowerShell: ${r instanceof Error?r.message:String(r)}`)}if(n.code!==0)throw new h("POWERSHELL_UNAVAILABLE",`Failed to create desktop shortcut: ${n.stderr||n.stdout}`)}function ke(e){let t=e.trim(),n=t.lastIndexOf(",");return n!==-1&&/^-?\d+$/.test(t.slice(n+1).trim())&&(t=t.slice(0,n).trim()),t.length>=2&&t.startsWith('"')&&t.endsWith('"')&&(t=t.slice(1,-1).trim()),t}async function xe(e){try{let t={...e.env,CREWX_LNK_PATH:e.shortcutPath},n=await e.run("powershell",["-NoProfile","-NonInteractive","-Command",ut],{env:t});if(n.code!==0||!n.stdout.trim())return null;let r=JSON.parse(n.stdout.trim());return {targetPath:r.TargetPath??"",workingDirectory:r.WorkingDirectory??"",iconLocation:r.IconLocation??""}}catch{return null}}var J=f__namespace.win32;async function I(e){let t=X(e.env.PATH??e.env.Path??"",e.cwd),n={...e.env,PATH:t,Path:t},r;try{r=await e.run("npm",["list","-g","crewx","--depth=0","--json"],{env:n});}catch{return {installed:false}}let i;try{i=JSON.parse(r.stdout||"{}");}catch{return {installed:false}}let l=i.dependencies?.crewx;if(!l?.version)return {installed:false};let o;try{let s=await e.run("npm",["prefix","-g"],{env:n});s.code===0&&(o=s.stdout.trim()||void 0);}catch{}let a=o?J.join(o,"crewx.cmd"):void 0;return {installed:true,version:l.version,binPath:a,prefix:o}}var dt=/EACCES|EPERM|EROFS/,ft=/ENOTFOUND|ETIMEDOUT|ECONNREFUSED|network|registry/i,pt=/^\d+\.\d+\.\d+/;function ht(e){return !!e&&e!=="0.0.0"&&pt.test(e)}var G=10*6e4;async function Ie(e){if(!ht(e.targetVersion))throw new h("GLOBAL_INSTALL_FAILED",`RUNNING_VERSION_UNKNOWN: cannot reliably determine the running crewx version to install (got ${JSON.stringify(e.targetVersion)}); refusing to fall back to crewx@latest`);if(e.currentInfo?.installed&&e.currentInfo.version&&!x(e.currentInfo.version,e.targetVersion))return {info:e.currentInfo};let t=X(e.env.PATH??e.env.Path??"",e.cwd),n={...e.env,PATH:t,Path:t},r=`crewx@${e.targetVersion}`;e.onProgress?.({phase:"global-install",message:`Installing crewx globally (npm install -g ${r})`});let i;try{i=await e.run("npm",["install","-g",r,"--no-audit","--no-fund"],{env:n,timeoutMs:G});}catch(o){throw new h("NPM_UNAVAILABLE",`Could not run npm: ${o instanceof Error?o.message:String(o)}`)}if(i.code===0)return {info:await I({env:n,cwd:e.cwd,run:e.run})};let l=`${i.stdout}
+${i.stderr}`;if(dt.test(l)){e.onProgress?.({phase:"global-install",message:"Permission denied \u2014 retrying with a user-scoped npm prefix"});let o=e.env.LOCALAPPDATA||J.join(e.env.USERPROFILE??"","AppData","Local"),a={...n,npm_config_prefix:J.join(o,"crewx","npm")},s;try{s=await e.run("npm",["install","-g",r,"--no-audit","--no-fund"],{env:a,timeoutMs:G});}catch(c){throw new h("NPM_PERMISSION_DENIED",`Retry with user-scoped prefix failed: ${c instanceof Error?c.message:String(c)}`)}if(s.code===0)return {info:await I({env:a,cwd:e.cwd,run:e.run})};throw new h("NPM_PERMISSION_DENIED",`npm install -g failed after user-scoped prefix retry: ${s.stderr||s.stdout}`)}if(ft.test(l)){if(!e.installRoot)throw new h("OFFLINE_NO_SOURCE","The npm registry is unreachable and no local installRoot was provided for an offline install");e.onProgress?.({phase:"global-install",message:`Registry unreachable \u2014 installing offline from ${e.installRoot}`});let o;try{o=await e.run("npm",["install","-g",e.installRoot,"--offline","--no-audit","--no-fund"],{env:n,timeoutMs:G});}catch(a){throw new h("GLOBAL_INSTALL_FAILED",`Offline install failed: ${a instanceof Error?a.message:String(a)}`)}if(o.code===0)return {info:await I({env:n,cwd:e.cwd,run:e.run})};throw new h("GLOBAL_INSTALL_FAILED",`Offline install failed: ${o.stderr||o.stdout}`)}throw new h("GLOBAL_INSTALL_FAILED",l.trim()||`npm install -g ${r} failed`)}function gt(e){return e.run??ce}function wt(e){return e.fs??z}async function F(e){let t=e.platform??process.platform,n=e.env??process.env,r=e.homedir??q,i=gt(e),l=wt(e),o=e.runningVersion??ue,a=e.cwd??process.cwd(),s=r(),c=fe(s),d=pe(s),p=he(s),u=null;t==="win32"&&(u=await ge({env:n,homedir:r,run:i}));let S=u?me(u.dir):null;return {platform:t,env:n,homedir:r,run:i,fs:l,runningVersion:o,cwd:a,installRoot:e.installRoot,shortcutManifestPath:c,launcherManifestPath:d,wrapperPath:p,desktop:u,shortcutPath:S}}function Le(e){return e?f__namespace.win32.normalize(e).toLowerCase().endsWith(`${f__namespace.win32.sep}bin${f__namespace.win32.sep}crewx.ico`):false}function j(e,t){let n=e.readBinaryFileSync;if(n)try{return crypto.createHash("sha256").update(n(t)).digest("hex")}catch{return}}async function St(e){try{await e.run("ie4uinit.exe",["-show"],{env:e.env});}catch{}}async function C(e){if(e.platform!=="win32")return {supported:false,state:"unsupported",globalCrewx:null,runningVersion:e.runningVersion,errors:[],manifest:null,iconStale:false};let t=[];e.desktop||t.push("NO_DESKTOP_DIR: could not resolve the Windows Desktop directory");let n=ve(e.fs,e.shortcutManifestPath),r=W(e.fs,e.launcherManifestPath),i=await I({env:e.env,cwd:e.cwd,run:e.run}),l=e.shortcutPath?e.fs.existsSync(e.shortcutPath):false,o,a=false,s,c;if(!l)o=n?.declined?"declined":"not-installed";else {let d=!!n?.owned&&!!e.shortcutPath&&n.shortcutPath===e.shortcutPath,p=false,u=e.shortcutPath?await xe({run:e.run,env:e.env,shortcutPath:e.shortcutPath}):null;if(d||(u&&U(u.targetPath,e.wrapperPath)?d=true:u&&we(u.targetPath)&&(p=true)),p)o="foreign",t.push("NSIS_PRESENT: an NSIS-installed CrewX shortcut was detected");else if(!d)o="foreign";else if(n?.version&&x(e.runningVersion,n.version))o="superseded",t.push(`SUPERSEDED: running version ${e.runningVersion} is older than the installed shortcut's version ${n.version}; refusing to modify it`);else {let S=!r||r.schema<_||!e.fs.existsSync(e.wrapperPath);if(u){let w=ke(u.iconLocation);if(!(!!w&&e.fs.existsSync(w)))a=true;else {s=w;let m=Ne(i,e.fs);m?U(w,m)?(c=j(e.fs,w),a=!c||n?.iconHash!==c):a=true:Le(w)?(c=j(e.fs,w),a=!c||n?.iconHash!==c):a=true;}}o=S||a?"stale":"installed";}}return {supported:true,state:o,shortcutPath:e.shortcutPath??void 0,desktopDir:e.desktop?.dir,desktopSource:e.desktop?.source,wrapperPath:e.wrapperPath,wrapperSchema:r?.schema,globalCrewx:i.installed?i:{installed:false},runningVersion:e.runningVersion,errors:t,manifest:n,iconStale:a,iconPath:s,iconHash:c}}function Ne(e,t){if(!e?.installed||!e.prefix)return;let n=f__namespace.win32.join(e.prefix,"node_modules","crewx","bin","crewx.ico");return t.existsSync(n)?n:void 0}function R(e){let{manifest:t,iconStale:n,iconPath:r,iconHash:i,...l}=e;return l}async function Pt(e={}){let t=await F(e),n=await C(t);return R(n)}async function Et(e={}){let t=await F(e);e.onProgress?.({phase:"detect",message:"Checking current shortcut status"});let n=await C(t),r=R(n);if(!r.supported)return {...r,changed:false,installedGlobal:false};if(r.state==="superseded")return {...r,changed:false,installedGlobal:false};if(r.state==="foreign"){if(n.errors.some(m=>m.startsWith("NSIS_PRESENT")))throw new h("NSIS_PRESENT",`An NSIS-installed CrewX shortcut was detected at ${r.shortcutPath}`);if(!e.force)throw new h("FOREIGN_SHORTCUT",`An existing shortcut at ${r.shortcutPath} is not managed by CrewX`)}if(!t.desktop||!t.shortcutPath)throw new h("NO_DESKTOP_DIR","Could not resolve the Windows Desktop directory");let i=false,l=false,o=r.globalCrewx,a=[],s=n.manifest?.iconHash,c=false;if(!!o?.installed&&!!o.version&&x(o.version,t.runningVersion)||!o?.installed&&r.state!=="installed"){let m=await Ie({env:t.env,cwd:t.cwd,run:t.run,targetVersion:t.runningVersion,currentInfo:o??void 0,installRoot:t.installRoot,onProgress:e.onProgress});o=m.info,l=m.info.installed,i=true,l||a.push(`GLOBAL_INSTALL_UNCONFIRMED: npm install -g crewx@${t.runningVersion} exited successfully but a follow-up check could not confirm the global install`);}if(e.onProgress?.({phase:"wrapper",message:"Ensuring launcher wrapper"}),Re({fs:t.fs,wrapperPath:t.wrapperPath,launcherManifestPath:t.launcherManifestPath,bakedBinPath:o?.binPath}).wrote&&(i=true),!((r.state==="installed"||r.state==="stale")&&!n.iconStale)){let m=Ne(o,t.fs)??(n.iconPath&&Le(n.iconPath)&&t.fs.existsSync(n.iconPath)?n.iconPath:void 0);if(n.iconStale&&!m)throw new h("ICON_UNAVAILABLE",`Could not locate the global CrewX icon (bin\\crewx.ico) to repair the desktop shortcut at ${t.shortcutPath}; the existing shortcut was left untouched`);e.onProgress?.({phase:"lnk",message:"Creating desktop shortcut"}),await be({run:t.run,env:t.env,shortcutPath:t.shortcutPath,targetPath:t.wrapperPath,iconPath:m}),i=true,c=n.iconStale;let g=m?j(t.fs,m):void 0;g&&(s=g);}i&&T(t.fs,t.shortcutManifestPath,{shortcutPath:t.shortcutPath,version:t.runningVersion,owned:true,declined:false,desktopSource:t.desktop.source,iconHash:s}),c&&await St(t);let w=await C(t),v=R(w);return {...v,errors:[...v.errors,...a],changed:i,installedGlobal:l}}async function vt(e={}){let t=await F(e),n=await C(t),r=R(n);if(!r.supported)return r;if((r.state==="installed"||r.state==="stale")&&t.shortcutPath)try{t.fs.unlinkSync(t.shortcutPath);}catch{}T(t.fs,t.shortcutManifestPath,{shortcutPath:void 0,version:n.manifest?.version,owned:false,declined:true,desktopSource:void 0,iconHash:void 0});let i=await C(t);return R(i)}async function yt(e={}){let t=await F(e),n=await C(t),r=R(n);if(!r.supported)return r;T(t.fs,t.shortcutManifestPath,{shortcutPath:n.manifest?.shortcutPath,version:n.manifest?.version,owned:n.manifest?.owned??false,declined:true,desktopSource:n.manifest?.desktopSource,iconHash:n.manifest?.iconHash});let i=await C(t);return R(i)}exports.ShortcutError=h;exports.dismissShortcutNotice=yt;exports.getShortcutStatus=Pt;exports.installShortcut=Et;exports.uninstallShortcut=vt;

package/dist/desktop/install.d.ts

@@ -0,0 +1,5 @@
+import { type InstallShortcutOptions, type ShortcutEnvOptions, type ShortcutInstallResult, type ShortcutStatus } from './types';
+export declare function getShortcutStatus(options?: ShortcutEnvOptions): Promise<ShortcutStatus>;
+export declare function installShortcut(options?: InstallShortcutOptions): Promise<ShortcutInstallResult>;
+export declare function uninstallShortcut(options?: ShortcutEnvOptions): Promise<ShortcutStatus>;
+export declare function dismissShortcutNotice(options?: ShortcutEnvOptions): Promise<ShortcutStatus>;

package/dist/desktop/lnk.d.ts

@@ -0,0 +1,22 @@
+import type { CommandRunner } from './types';
+export interface WriteLnkOptions {
+    run: CommandRunner;
+    env: NodeJS.ProcessEnv;
+    shortcutPath: string;
+    targetPath: string;
+    workingDirectory?: string;
+    iconPath?: string;
+}
+export declare function writeLnk(opts: WriteLnkOptions): Promise<void>;
+export interface LnkInfo {
+    targetPath: string;
+    workingDirectory: string;
+    iconLocation: string;
+}
+export interface ReadLnkOptions {
+    run: CommandRunner;
+    env: NodeJS.ProcessEnv;
+    shortcutPath: string;
+}
+export declare function normalizeIconLocation(raw: string): string;
+export declare function readLnkTarget(opts: ReadLnkOptions): Promise<LnkInfo | null>;

package/dist/desktop/manifest.d.ts

@@ -0,0 +1,21 @@
+import type { DesktopSource, ShortcutFsLike } from './types';
+export declare const MANIFEST_SCHEMA_VERSION = 1;
+export interface ShortcutManifest {
+    schema: number;
+    shortcutPath?: string;
+    version?: string;
+    iconHash?: string;
+    owned: boolean;
+    declined: boolean;
+    desktopSource?: DesktopSource;
+    updatedAt?: string;
+}
+export interface LauncherManifest {
+    schema: number;
+    binPath?: string;
+    updatedAt?: string;
+}
+export declare function readShortcutManifest(fs: ShortcutFsLike, manifestPath: string): ShortcutManifest | null;
+export declare function writeShortcutManifest(fs: ShortcutFsLike, manifestPath: string, data: Omit<ShortcutManifest, 'schema' | 'updatedAt'>): void;
+export declare function readLauncherManifest(fs: ShortcutFsLike, manifestPath: string): LauncherManifest | null;
+export declare function writeLauncherManifest(fs: ShortcutFsLike, manifestPath: string, data: LauncherManifest): void;

package/dist/desktop/types.d.ts

@@ -0,0 +1,67 @@
+export type ShortcutState = 'unsupported' | 'not-installed' | 'installed' | 'stale' | 'foreign' | 'superseded' | 'declined';
+export type DesktopSource = 'known-folder' | 'fallback';
+export interface GlobalCrewxInfo {
+    installed: boolean;
+    version?: string;
+    binPath?: string;
+    prefix?: string;
+}
+export interface ShortcutStatus {
+    supported: boolean;
+    state: ShortcutState;
+    shortcutPath?: string;
+    desktopDir?: string;
+    desktopSource?: DesktopSource;
+    wrapperPath?: string;
+    wrapperSchema?: number;
+    globalCrewx: GlobalCrewxInfo | null;
+    runningVersion: string;
+    errors: string[];
+}
+export interface ShortcutInstallResult extends ShortcutStatus {
+    changed: boolean;
+    installedGlobal: boolean;
+}
+export type ShortcutProgressPhase = 'detect' | 'global-install' | 'wrapper' | 'lnk';
+export interface ShortcutProgressEvent {
+    phase: ShortcutProgressPhase;
+    message: string;
+}
+export interface CommandResult {
+    code: number;
+    stdout: string;
+    stderr: string;
+}
+export interface CommandRunOptions {
+    env?: NodeJS.ProcessEnv;
+    cwd?: string;
+    timeoutMs?: number;
+}
+export type CommandRunner = (command: string, args: string[], opts?: CommandRunOptions) => Promise<CommandResult>;
+export interface ShortcutFsLike {
+    existsSync(path: string): boolean;
+    readFileSync(path: string): string;
+    readBinaryFileSync?: (path: string) => Uint8Array;
+    writeFileSync(path: string, data: string): void;
+    mkdirSync(path: string): void;
+    unlinkSync(path: string): void;
+}
+export interface ShortcutEnvOptions {
+    platform?: NodeJS.Platform;
+    env?: NodeJS.ProcessEnv;
+    homedir?: () => string;
+    run?: CommandRunner;
+    fs?: ShortcutFsLike;
+    runningVersion?: string;
+    cwd?: string;
+}
+export interface InstallShortcutOptions extends ShortcutEnvOptions {
+    force?: boolean;
+    onProgress?: (event: ShortcutProgressEvent) => void;
+    installRoot?: string;
+}
+export type ShortcutErrorCode = 'NOT_WINDOWS' | 'NO_DESKTOP_DIR' | 'NPM_UNAVAILABLE' | 'NPM_PERMISSION_DENIED' | 'OFFLINE_NO_SOURCE' | 'GLOBAL_INSTALL_FAILED' | 'POWERSHELL_UNAVAILABLE' | 'WRITE_DENIED' | 'FOREIGN_SHORTCUT' | 'NSIS_PRESENT' | 'ICON_UNAVAILABLE';
+export declare class ShortcutError extends Error {
+    readonly code: ShortcutErrorCode;
+    constructor(code: ShortcutErrorCode, message: string);
+}

package/dist/desktop/version.d.ts

@@ -0,0 +1 @@
+export declare const SDK_VERSION: string;

package/dist/desktop/windows-paths.d.ts

@@ -0,0 +1,21 @@
+import type { CommandRunner, DesktopSource } from './types';
+export declare function crewxHomeDir(homedir: string): string;
+export declare function shortcutManifestPath(homedir: string): string;
+export declare function launcherManifestPath(homedir: string): string;
+export declare function wrapperPath(homedir: string): string;
+export declare function shortcutLnkPath(desktopDir: string): string;
+export declare function samePath(a: string, b: string): boolean;
+export interface ResolveDesktopDirOptions {
+    env: NodeJS.ProcessEnv;
+    homedir: () => string;
+    run: CommandRunner;
+}
+export interface ResolvedDesktopDir {
+    dir: string;
+    source: DesktopSource;
+}
+export declare function resolveDesktopDir(opts: ResolveDesktopDirOptions): Promise<ResolvedDesktopDir | null>;
+export declare function filterWorkspaceLocalBin(pathValue: string, cwd: string): string;
+export declare function looksLikeNsisInstall(targetPath: string): boolean;
+export declare function compareVersions(a: string, b: string): -1 | 0 | 1;
+export declare function isOlderVersion(a: string, b: string): boolean;

package/dist/desktop/wrapper.d.ts

@@ -0,0 +1,18 @@
+import type { ShortcutFsLike } from './types';
+export declare const WRAPPER_SCHEMA_VERSION = 1;
+export interface BuildWrapperScriptOptions {
+    bakedBinPath?: string;
+}
+export declare function buildWrapperScript(opts: BuildWrapperScriptOptions): string;
+export interface EnsureWrapperOptions {
+    fs: ShortcutFsLike;
+    wrapperPath: string;
+    launcherManifestPath: string;
+    bakedBinPath?: string;
+}
+export interface EnsureWrapperResult {
+    wrapperPath: string;
+    wrote: boolean;
+    schema: number;
+}
+export declare function ensureWrapper(opts: EnsureWrapperOptions): EnsureWrapperResult;

package/dist/esm/account/index.js

@@ -0,0 +1 @@
+import {randomUUID}from'crypto';import*as D from'fs';import {existsSync,readFileSync,mkdirSync,writeFileSync,chmodSync,renameSync,unlinkSync}from'fs';import*as w from'path';import {join,dirname}from'path';import*as I from'os';var s=class extends Error{code;kind;status;constructor(e,n,r,o){super(o??`Account authentication request failed (${e})`),this.name="AccountAuthError",this.code=e,this.kind=n,this.status=r;}};var p=class extends Error{code="LOGIN_REQUIRED";constructor(){super("Login required \u2014 please log in again"),this.name="LoginRequiredError";}},d=class extends Error{code;constructor(e,n){super(n),this.name="SessionManagerError",this.code=e;}},u=class extends Error{code;constructor(e,n="auth.json is invalid \u2014 please log in again"){super(n),this.name="AuthJsonValidationError",this.code=e;}},c=class extends s{constructor(e){let n=e.startsWith("ACCOUNT_BASE_URL")?"CREWX_ACCOUNT_BASE_URL":e.startsWith("ACCOUNT_ISSUER")?"CREWX_ACCOUNT_ISSUER":"CREWX_MARKETPLACE_URL";super(e,"configuration",void 0,`${n} is missing or invalid \u2014 configure it and try again`),this.name="AccountConfigurationError";}};var b="CREWX_ACCOUNT_BASE_URL",L="CREWX_ACCOUNT_ISSUER",P="CREWX_MARKETPLACE_URL";function V(t,e,n,r=false){let o=t?.trim();if(!o)throw new c(e);try{let i=new URL(o);if(i.protocol!=="http:"&&i.protocol!=="https:"||i.username.length>0||i.password.length>0||i.hostname.length===0||i.search.length>0||i.hash.length>0||r&&i.pathname!=="/")throw new Error("invalid URL")}catch{throw new c(n)}return o.replace(/\/+$/,"")}function k(t=process.env){return V(t[b],"ACCOUNT_BASE_URL_MISSING","ACCOUNT_BASE_URL_INVALID",true)}function Y(t=process.env){return V(t[P],"MARKETPLACE_URL_MISSING","MARKETPLACE_URL_INVALID")}function C(t=process.env){let e=t[L]?.trim();if(!e)throw new c("ACCOUNT_ISSUER_MISSING");try{let n=new URL(e);if(n.protocol!=="http:"&&n.protocol!=="https:"||n.username.length>0||n.password.length>0||n.hostname.length===0||n.search.length>0||n.hash.length>0)throw new Error("invalid issuer")}catch{throw new c("ACCOUNT_ISSUER_INVALID")}return e}function R(t,e){return `${t.replace(/\/+$/,"")}/${e.replace(/^\/+/,"")}`}function J(){if(process.env.CREWX_HOME)try{return D.realpathSync(process.env.CREWX_HOME)}catch{return w.join(I.homedir(),".crewx")}return process.platform!=="win32"&&process.env.XDG_CONFIG_HOME?w.join(process.env.XDG_CONFIG_HOME,"crewx"):w.join(I.homedir(),".crewx")}var B="auth.json",v=2,G=["version","sub","email","access_token","refresh_token","expires_at","updated_at"];function h(t="auth.json is invalid \u2014 please log in again"){throw new u("AUTH_JSON_INVALID",t)}function oe(){throw new u("AUTH_JSON_LEGACY","auth.json uses an unsupported legacy format \u2014 please log in again")}function se(t){return typeof t=="object"&&t!==null&&!Array.isArray(t)}function ie(t){try{return A(t),!0}catch{return  false}}function A(t){if(!se(t))return h();if(t.version===1)return oe();if(t.version!==v)return h();let e=Object.keys(t);if(e.length!==G.length||e.some(r=>!G.includes(r))||typeof t.sub!="string"||t.sub.length===0||typeof t.email!="string"||t.email.length===0||typeof t.access_token!="string"||t.access_token.length===0||typeof t.refresh_token!="string"||t.refresh_token.length===0)return h();let n=t.expires_at;return typeof n!="number"||!Number.isSafeInteger(n)||n<0||typeof t.updated_at!="string"||t.updated_at.length===0||Number.isNaN(Date.parse(t.updated_at))?h():{version:v,sub:t.sub,email:t.email,access_token:t.access_token,refresh_token:t.refresh_token,expires_at:n,updated_at:t.updated_at}}function K(t){let e;try{e=JSON.parse(t);}catch{return h()}return A(e)}function q(t){return t??join(J(),B)}var f=class{configuredPath;constructor(e={}){this.configuredPath=typeof e=="string"?e:e.filePath;}path(){return q(this.configuredPath)}read(){let e=this.path();if(!existsSync(e))return null;try{return K(readFileSync(e,"utf8"))}catch(n){throw n instanceof u?n:new u("AUTH_JSON_INVALID")}}write(e){let n=A(e),r=this.path(),o=dirname(r);mkdirSync(o,{recursive:true,mode:448});let i=`${r}.tmp.${process.pid}.${randomUUID()}`;try{writeFileSync(i,JSON.stringify(n,null,2),{encoding:"utf8",mode:384}),chmodSync(i,384),renameSync(i,r),chmodSync(r,384);}catch{try{existsSync(i)&&unlinkSync(i);}catch{}throw new Error("Could not persist auth.json securely")}}clear(){let e=this.path();try{existsSync(e)&&unlinkSync(e);}catch{throw new Error("Could not clear auth.json")}}};function ce(t){let e=new f({filePath:t}).read();if(!e)throw new p;return e}function ae(t,e){new f({filePath:e}).write(t);}function ue(t){new f({filePath:t}).clear();}var W="/auth/v1/oauth/device/code",X="/auth/v1/oauth/token",$="/auth/v1/oauth/revoke",T="crewx-cli",m="urn:ietf:params:oauth:grant-type:device_code";function a(t){return typeof t=="string"&&t.trim().length>0}function S(t){return typeof t=="object"&&t!==null&&!Array.isArray(t)?t:null}function he(t){let e=S(t),n=e?.error??e?.code;if(typeof n=="string")return n.toLowerCase();let r=S(n),o=r?.code??r?.error;return typeof o=="string"?o.toLowerCase():void 0}function pe(t){let e=S(t);if(!e||!a(e.device_code)||!a(e.user_code)||!a(e.verification_uri))throw new s("AUTH_RESPONSE_INVALID","protocol");let n=e.expires_in,r=e.interval;if(typeof n!="number"||!Number.isSafeInteger(n)||n<=0)throw new s("AUTH_RESPONSE_INVALID","protocol");if(e.verification_uri_complete!==void 0&&!a(e.verification_uri_complete))throw new s("AUTH_RESPONSE_INVALID","protocol");if(r!==void 0&&(typeof r!="number"||!Number.isSafeInteger(r)||r<0))throw new s("AUTH_RESPONSE_INVALID","protocol");let o={device_code:e.device_code,user_code:e.user_code,verification_uri:e.verification_uri,expires_in:n};return e.verification_uri_complete!==void 0&&(o.verification_uri_complete=e.verification_uri_complete),r!==void 0&&(o.interval=r),o}function de(t){let e=S(t),n=S(e?.account),r=e?.expires_in;if(!e||!a(e.access_token)||!a(e.refresh_token)||typeof r!="number"||!Number.isSafeInteger(r)||r<=0||!n||!a(n.sub)||!a(n.email))throw new s("AUTH_RESPONSE_INVALID","protocol");let o={access_token:e.access_token,refresh_token:e.refresh_token,expires_in:r,account:{sub:n.sub,email:n.email}};return typeof e.token_type=="string"&&e.token_type.length>0&&(o.token_type=e.token_type),typeof e.scope=="string"&&e.scope.length>0&&(o.scope=e.scope),o}var E=class{configuredBaseUrl;fetchImpl;timeoutMs;constructor(e={}){let n=typeof e=="string"?{baseUrl:e}:e;this.configuredBaseUrl=n.baseUrl===void 0?void 0:fe(n.baseUrl),this.fetchImpl=n.fetch??n.fetchImpl,this.timeoutMs=n.timeoutMs??1e4;}baseUrl(){return this.configuredBaseUrl!==void 0?this.configuredBaseUrl:k()}signal(e){if(!(e<=0||typeof AbortSignal>"u"||typeof AbortSignal.timeout!="function"))return AbortSignal.timeout(e)}async request(e,n,r,o={}){let i=R(this.baseUrl(),e),x=this.fetchImpl??globalThis.fetch;if(typeof x!="function")throw new s("AUTH_NETWORK_ERROR","network");let l;try{l=await x(i,{...n,signal:n.signal??this.signal(o.timeoutMs??this.timeoutMs)});}catch{throw new s("AUTH_NETWORK_ERROR","network")}if(o.parseBody===false){if(!l.ok)throw j(l.status,null,r);return}let y=null;try{y=await l.json();}catch{y=null;}if(!l.ok)throw j(l.status,y,r);return y}async requestDeviceCode(){let e=new URLSearchParams;e.set("client_id",T);let n=await this.request(W,{method:"POST",headers:{"Content-Type":"application/x-www-form-urlencoded"},body:e.toString()});return pe(n)}async requestToken(e){Ae(e);let n=new URLSearchParams;n.set("grant_type",e.grant_type),n.set("client_id",T),e.grant_type===m?n.set("device_code",e.device_code):n.set("refresh_token",e.refresh_token);let r=await this.request(X,{method:"POST",headers:{"Content-Type":"application/x-www-form-urlencoded"},body:n.toString()},e);return de(r)}async exchangeDeviceCode(e){return this.requestToken({grant_type:m,device_code:e})}async refreshToken(e){return this.requestToken({grant_type:"refresh_token",refresh_token:e})}async deviceCode(){return this.requestDeviceCode()}async getDeviceCode(){return this.requestDeviceCode()}async token(e){return this.requestToken(e)}async getToken(e){return this.requestToken(e)}async refresh(e){return this.refreshToken(e)}async refreshAccessToken(e){return this.refreshToken(e)}async revokeToken(e){if(!a(e))throw new s("AUTH_INPUT_INVALID","protocol");let n=new URLSearchParams;n.set("token",e),n.set("token_type_hint","refresh_token"),n.set("client_id",T),await this.request($,{method:"POST",headers:{"Content-Type":"application/x-www-form-urlencoded"},body:n.toString()},void 0,{parseBody:false,timeoutMs:3e3});}async revoke(e){return this.revokeToken(e)}};function fe(t){if(typeof t!="string"||!t.trim())throw new c("ACCOUNT_BASE_URL_MISSING");try{let e=new URL(t.trim());if(e.protocol!=="http:"&&e.protocol!=="https:"||e.username.length>0||e.password.length>0||e.hostname.length===0||e.pathname!=="/"||e.search.length>0||e.hash.length>0)throw new Error("invalid URL")}catch{throw new c("ACCOUNT_BASE_URL_INVALID")}return t.trim().replace(/\/+$/,"")}function Ae(t){if(!t||t.grant_type!==m&&t.grant_type!=="refresh_token"||t.grant_type===m&&!a(t.device_code)||t.grant_type==="refresh_token"&&!a(t.refresh_token))throw new s("AUTH_INPUT_INVALID","protocol")}function j(t,e,n){let r=he(e);if(t>=500)return new s("AUTH_SERVER_ERROR","server",t);if(n?.grant_type==="refresh_token"&&(r==="invalid_grant"||t===401))return new s("INVALID_REFRESH_TOKEN","invalid_refresh",t);if(n?.grant_type===m){if(r==="authorization_pending")return new s("AUTHORIZATION_PENDING","pending",t);if(r==="slow_down")return new s("SLOW_DOWN","pending",t);if(r==="access_denied")return new s("ACCESS_DENIED","denied",t);if(r==="expired_token")return new s("EXPIRED_TOKEN","expired",t)}return new s("AUTH_HTTP_ERROR","http",t)}var U=class{client;store;refreshSkewSeconds;now;nowSecondsOverride;refreshPromise=null;constructor(e={},n){let r=_e(e)?e:void 0,o=r?{}:e;this.client=r??o.client??o.authClient??new E,this.store=o.store??o.storage??n??new f,this.refreshSkewSeconds=o.refreshSkewSeconds??60,this.now=o.now??(()=>Date.now()),this.nowSecondsOverride=o.nowSeconds;}getSession(){return this.readSession()}isLoggedIn(){return this.readSession()!==null}async getAccessToken(){let e=this.requireSession();return e.expires_at>this.epochSeconds()+this.refreshSkewSeconds?e.access_token:(await this.refreshSession(e)).access_token}async getValidAccessToken(){return this.getAccessToken()}async getToken(){return this.getAccessToken()}async refresh(){return this.refreshSession(this.requireSession())}async loginWithDeviceCode(e){let n=await this.client.exchangeDeviceCode(e);return this.persistTokenResponse(n)}async login(e){return this.loginWithDeviceCode(e)}async setSession(e){return this.persistTokenResponse(e)}clear(){this.store.clear();}async withAccessToken(e){return e(await this.getAccessToken())}readSession(){try{let e=this.store.read();if(e===null)return null;let n=A(e);return F(n.access_token,n.sub),n}catch(e){throw e instanceof u?new p:e}}requireSession(){let e=this.readSession();if(!e)throw new p;return e}epochSeconds(){return this.nowSecondsOverride?.()??Math.floor(this.now()/1e3)}refreshSession(e){if(this.refreshPromise)return this.refreshPromise;let n;return n=this.performRefresh(e).finally(()=>{this.refreshPromise===n&&(this.refreshPromise=null);}),this.refreshPromise=n,n}async performRefresh(e){try{let n=await this.client.refreshToken(e.refresh_token);return this.persistTokenResponse(n,e.sub)}catch(n){throw le(n)?(this.store.clear(),new p):n}}persistTokenResponse(e,n){let r=e?.account;if(!e||typeof e.access_token!="string"||e.access_token.length===0||typeof e.refresh_token!="string"||e.refresh_token.length===0||!Number.isSafeInteger(e.expires_in)||e.expires_in<=0||!r||typeof r.sub!="string"||r.sub.length===0||typeof r.email!="string"||r.email.length===0)throw new d("AUTH_RESPONSE_INVALID","Account token response is malformed");if(n!==void 0&&r.sub!==n)throw new d("ACCOUNT_SUB_MISMATCH","Account subject changed during token refresh \u2014 please log in again");F(e.access_token,r.sub);let o=A({version:2,sub:r.sub,email:r.email,access_token:e.access_token,refresh_token:e.refresh_token,expires_at:this.epochSeconds()+e.expires_in,updated_at:new Date(this.now()).toISOString()});return this.store.write(o),o}};function le(t){return t instanceof s?t.kind==="invalid_refresh":typeof t=="object"&&t!==null&&(t.kind==="invalid_refresh"||t.code==="INVALID_REFRESH_TOKEN")}function _e(t){return typeof t.exchangeDeviceCode=="function"&&typeof t.refreshToken=="function"}function F(t,e){let n=C(),r=ge(t);if(r.iss!==n)throw new d("ACCOUNT_ISSUER_MISMATCH","Access token issuer does not match the configured account issuer \u2014 please log in again");if(r.sub!==e)throw new d("ACCOUNT_SUB_MISMATCH","Access token subject does not match the account session \u2014 please log in again")}function ge(t){if(typeof t!="string")throw O();let e=t.split(".");if(e.length!==3||e.some(n=>!/^[A-Za-z0-9_-]+$/.test(n)))throw O();try{let n=JSON.parse(Buffer.from(e[1],"base64url").toString("utf8"));if(typeof n!="object"||n===null||Array.isArray(n)||typeof n.iss!="string"||n.iss.length===0||typeof n.sub!="string"||n.sub.length===0)throw new Error("missing identity claims");return {iss:n.iss,sub:n.sub}}catch{throw O()}}function O(){return new d("ACCESS_TOKEN_INVALID","Access token identity could not be verified \u2014 please log in again")}export{b as ACCOUNT_BASE_URL_ENV,L as ACCOUNT_ISSUER_ENV,B as AUTH_JSON_FILENAME,v as AUTH_JSON_VERSION,s as AccountAuthError,c as AccountConfigurationError,E as AuthClient,s as AuthClientError,s as AuthError,f as AuthJsonStore,u as AuthJsonValidationError,m as DEVICE_CODE_GRANT_TYPE,W as DEVICE_CODE_PATH,p as LoginRequiredError,P as MARKETPLACE_URL_ENV,T as OAUTH_CLIENT_ID,$ as REVOKE_PATH,U as SessionManager,d as SessionManagerError,X as TOKEN_PATH,R as appendEndpoint,q as authJsonPath,ue as clearAuthJson,ie as isAuthJsonV2,K as parseAuthJson,ce as readAuthJson,k as resolveAccountBaseUrl,C as resolveAccountIssuer,Y as resolveMarketplaceUrl,A as validateAuthJson,ae as writeAuthJson};