@crewx/sdk 0.9.0-rc.7 → 0.9.0-rc.70

package/README.md

@@ -128,7 +128,7 @@ const result = await crewx.query('assistant', 'Translate to Korean', {
 });
 ```
 
-> **Note**: `'@assistant'` 형태도 동작합니다 (CLI 호환). SDK에서는 bare id가 권장됩니다.
+> **Note**: The `'@assistant'` form also works (CLI-compatible). The SDK recommends using the bare id.
 
 **Returns**: [`QueryResult`](#queryresult)
 

package/dist/activity-log/builder.d.ts

@@ -1,3 +1,10 @@
+export interface ActivityLogRenderedEntry {
+    entry: ActivityEntry;
+    newestIndex: number;
+    bodyLimitChars: number;
+    bodyCharsShown: number | null;
+    originalBodyChars: number | null;
+}
 export declare function checkStale(tool: string, input: string | null, taskCompletedAt?: string | null): 'ok' | 'stale' | 'unknown';
 export interface ActivityEntry {
     tool: string;
@@ -6,18 +13,60 @@ export interface ActivityEntry {
     status: 'ok' | 'stale' | 'unknown';
     reusable: boolean;
 }
-export interface ActivityLogResult {
+export type CountTokens = (text: string) => number;
+export type ActivityLogOmissionReason = 'token_cap' | 'repository_limit';
+export interface ActivityLogOmission {
+    reason: ActivityLogOmissionReason;
+    count: number;
+    message: string;
+}
+export interface ActivityLogTaskResult {
+    taskId: string;
+    taskDistance: number;
+    tokenCap: number;
+    tokenCount: number;
+    includedEntries: number;
+    omittedEntries: number;
+    totalEntries: number;
+    omissions: ActivityLogOmission[];
+    entries: ActivityLogRenderedEntry[];
+    activityLog: string;
+}
+export interface ActivityLogByTaskResult {
     threadId: string;
     agentId: string;
     lookback: number;
-    entries: ActivityEntry[];
-    totalEntries: number;
-    truncated: boolean;
+    activityLogTokenBudget: number;
+    baseEntryChars: number;
+    tasks: ActivityLogTaskResult[];
+    activityLogByTask: Map<string, string>;
+}
+export interface BuildActivityLogByTaskBudgetOptions {
+    threadId: string;
+    agentId: string;
+    lookback: number;
+    maxEntryChars?: number;
+    activityLogTokenBudget: number;
+    countTokens: CountTokens;
+    repositoryEntryLimit?: number;
 }
-export declare function buildActivityLogByTask(opts: {
+export interface BuildActivityLogByTaskOptions {
     threadId: string;
     agentId: string;
     lookback: number;
     maxEntryChars?: number;
     decayRate?: number;
-}): Map<string, string>;
+    activityLogTokenBudget?: number;
+    countTokens?: CountTokens;
+    repositoryEntryLimit?: number;
+}
+export interface ActivityLogResult {
+    threadId: string;
+    agentId: string;
+    lookback: number;
+    entries: ActivityEntry[];
+    totalEntries: number;
+    truncated: boolean;
+}
+export declare function buildActivityLogByTaskResult(opts: BuildActivityLogByTaskBudgetOptions): ActivityLogByTaskResult;
+export declare function buildActivityLogByTask(opts: BuildActivityLogByTaskOptions): Map<string, string>;

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

@@ -0,0 +1,17 @@
+export declare function normalizeClaudeMode(mode: string): string;
+export interface AgentOptionsLike {
+    query?: unknown;
+    execute?: unknown;
+    [key: string]: unknown;
+}
+export interface CanonicalizeAgentOptionsInput {
+    provider?: string;
+    model?: string;
+    options: unknown;
+}
+export interface CanonicalizeAgentOptionsResult {
+    options: unknown;
+    changed: boolean;
+    removed: string[];
+}
+export declare function canonicalizeAgentOptions(input: CanonicalizeAgentOptionsInput): CanonicalizeAgentOptionsResult;

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,16 @@
+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 MODEL_CATALOG_VERSION = 20;
+export declare const MODEL_CATALOG_UPDATED = "2026-08-19T00: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 +21,35 @@ 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[];
     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 getCostMultiplier(model: string | null | undefined, date?: Date): number;
-export declare function calculateCost(inputTokens: number, outputTokens: number, model: string | null | undefined, cachedInputTokens?: number, date?: Date): number;
+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 = 20;
+export declare const MODEL_PRICING_UPDATED = "2026-08-19T00: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

@@ -2,14 +2,8 @@ export interface ModelPricing {
     input: number;
     cachedInput: number;
     output: number;
-    metadata?: {
-        billing?: {
-            peakMultiplier: number;
-            offPeakMultiplier: number;
-            peakHoursUtc?: {
-                start: number;
-                end: number;
-            };
-        };
-    };
+}
+export interface ModelApiPricing {
+    inputPerMillionTokensUsd: number;
+    outputPerMillionTokensUsd: number;
 }

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

@@ -1,5 +1,8 @@
 export interface TimeoutConfig {
     queryMs: number;
     executeMs: number;
+    idleMs: number;
 }
+export declare const DEFAULT_IDLE_MS: number;
+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-budget/index.d.ts

@@ -0,0 +1,105 @@
+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 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;
+    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 {};

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/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

@@ -24,6 +24,7 @@ export interface TemplateMessage {
     isAssistant: boolean;
     timestamp?: number;
     metadata?: Record<string, unknown>;
+    activity_log?: string;
     files?: Array<{
         name: string;
         size?: number;

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 d=require('path'),crypto=require('crypto'),fs=require('fs'),os=require('os'),child_process=require('child_process'),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 d__namespace=/*#__PURE__*/_interopNamespace(d);var D=(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 f=class extends Error{code;constructor(t,n){super(`${t}: ${n}`),this.code=t,this.name="ShortcutError";}};var X={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);}},G=os.homedir;function _(e){return typeof e!="string"?void 0:e.trim()||void 0}function N(e){return _(e)?.toLowerCase()??""}function v(e){try{return fs.statSync(e).isFile()}catch{return  false}}function Le(e,t){if(e===t)return  true;let n=d__namespace.default.relative(e,t);return n!==""&&!n.startsWith("..")&&!d__namespace.default.isAbsolute(n)}function ke(e,t){if(d__namespace.default.basename(e)!==".bin")return  false;let n=d__namespace.default.dirname(e);if(d__namespace.default.basename(n)!=="node_modules")return  false;let r=d__namespace.default.dirname(n);return Le(r,t)}function U(e,t={}){if(e.includes("/")||e.includes("\\")||d__namespace.default.isAbsolute(e))return e;let n=t.platform??process.platform,r=t.env??process.env,i=d__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??"",s=n==="win32"?";":":",a=o.split(s).map(u=>u.trim()).filter(Boolean),c=d__namespace.default.extname(e).length>0,h=r.PATHEXT??r.Pathext??process.env.PATHEXT??process.env.Pathext??".EXE;.CMD;.BAT;.COM",m=n==="win32"?c?[""]:h.split(";").map(u=>u.trim()).filter(Boolean).map(u=>u.startsWith(".")?u:`.${u}`):[""];for(let u of a){let p=d__namespace.default.resolve(i,u);if(!(l&&ke(p,i)))for(let w of m){let y=N(w),g=w.toUpperCase();for(let k of [w,y,g]){let H=d__namespace.default.join(p,`${e}${k}`);if(v(H))return H}}}return e}function _e(e){if(!v(e))return null;try{let t=fs.readFileSync(e,"utf8"),n=d__namespace.default.dirname(e),r=[];for(let s of t.matchAll(/"([^"\r\n]*)"/g)){let h=(s[1]??"").match(/%~?dp0%?\s*[\\/]*(.*)$/i)?.[1]?.trim();if(!h)continue;let m=h.replace(/[\\/]+/g,d__namespace.default.sep).replace(/^[\\/]+/,""),u=d__namespace.default.resolve(n,m);v(u)&&r.push(u);}let i=[],l=new Map;for(let s of t.matchAll(/SET\s+"(\w+)=%~?dp0%?[\\/]?([^"]+)"/gi)){let a=s[1].toUpperCase(),c=s[2].trim().replace(/[\\/]+/g,d__namespace.default.sep).replace(/^[\\/]+/,"");l.set(a,d__namespace.default.resolve(n,c));}for(let s of t.split(/\r?\n/))if(s.includes("%*"))for(let a of s.matchAll(/"%(\w+)%"/g)){let c=l.get(a[1].toUpperCase());c&&v(c)&&i.push(c);}let o=s=>s.find(a=>{let c=N(d__namespace.default.basename(a));return c!=="node.exe"&&c!=="node"})??null;return o(i)??o(r)}catch{return null}}function Ne(e,t){if(typeof t=="string")return _(t)||null;if(!t||typeof t!="object")return null;if(e){let n=t[e],r=typeof n=="string"?_(n):void 0;if(r)return r}for(let n of Object.values(t)){let r=typeof n=="string"?_(n):void 0;if(r)return r}return null}function Oe(e,t){if(!t)return null;let n=d__namespace.default.dirname(e),r=[d__namespace.default.resolve(n,"..",t),d__namespace.default.resolve(n,"node_modules",t)];for(let i of r){let l=d__namespace.default.join(i,"package.json");if(v(l))try{let o=JSON.parse(fs.readFileSync(l,"utf8")),s=Ne(t,o.bin);if(!s)continue;let a=d__namespace.default.resolve(i,s);if(v(a))return a}catch{}}return null}function be(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:U(e.command,{cwd:i,env:n,platform:t,resolution:l}),leadingArgv:[],resolution:"direct"};let o=U(e.command,{cwd:i,env:n,platform:t,resolution:l}),s=N(d__namespace.default.extname(o));if(s===".js"||s===".cjs"||s===".mjs")return {command:r,leadingArgv:[o],resolution:"node-entrypoint",windowsHide:true};if(s===".cmd"||s===".bat"){let a=_e(o)??Oe(o,e.packageName);return a?N(d__namespace.default.extname(a))===".exe"?{command:a,leadingArgv:[],resolution:"exe-entrypoint",windowsHide:true}:{command:r,leadingArgv:[a],resolution:"node-entrypoint",windowsHide:true}:{command:o,leadingArgv:[],resolution:"unresolved-wrapper"}}return {command:o,leadingArgv:[],resolution:"direct"}}function Ae(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(`${d__namespace.default.basename(e.candidate.command)} wrapper resolved, but no executable/Node entrypoint could be resolved without shell execution.`)}function J(e){let t=be(e);return Ae({candidate:t})}function K(e,t){return {command:e.command,argv:[...e.leadingArgv,...t],resolution:e.resolution,shell:e.shell,windowsHide:e.windowsHide}}var z=3e4;function De(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 Q=(e,t,n={})=>new Promise((r,i)=>{let l=n.env??process.env,o=process.platform,s;try{let p=J({command:e,platform:o,env:l,cwd:n.cwd,allowShellFallback:!1});s=K(p,t);}catch(p){i(p instanceof Error?p:new Error(String(p)));return}let a=child_process.spawn(s.command,s.argv,{cwd:n.cwd,env:l,shell:s.shell,windowsHide:s.windowsHide??true,detached:o!=="win32"}),c="",h="",m=false,u=setTimeout(()=>{m||(m=true,De(a),i(new Error(`Command timed out after ${n.timeoutMs??z}ms: ${e} ${t.join(" ")}`)));},n.timeoutMs??z);a.stdout?.on("data",p=>{c+=p.toString();}),a.stderr?.on("data",p=>{h+=p.toString();}),a.on("error",p=>{m||(m=true,clearTimeout(u),i(p));}),a.on("close",p=>{m||(m=true,clearTimeout(u),r({code:p??0,stdout:c,stderr:h}));});});function Fe(){try{return (typeof D=="function"?D:module$1.createRequire(__filename)).resolve("@crewx/sdk/package.json")}catch{return null}}function Me(){let e=[Fe(),d.join(__dirname,"../../package.json"),d.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 Z=Me();var P=d__namespace.win32;function W(e){return P.join(e,".crewx")}function te(e){return P.join(W(e),"shortcut.json")}function ne(e){return P.join(W(e),"launcher.json")}function re(e){return P.join(W(e),"bin","crewx-launcher.cmd")}function oe(e){return P.join(e,"CrewX.lnk")}function T(e,t){return P.normalize(e).toLowerCase()===P.normalize(t).toLowerCase()}var Be="[Console]::OutputEncoding = [System.Text.Encoding]::UTF8; [Environment]::GetFolderPath('DesktopDirectory')";async function se(e){try{let n=await e.run("powershell",["-NoProfile","-NonInteractive","-Command",Be],{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:P.join(t,"Desktop"),source:"fallback"}:null}function F(e,t){let n=P.resolve(t,"node_modules",".bin").toLowerCase();return e.split(";").filter(r=>r?P.resolve(r).toLowerCase()!==n:true).join(";")}function ie(e){return e?/\\Program Files( \(x86\))?\\/i.test(e)&&/crewx/i.test(e):false}function $e(e,t){let n=a=>{let[c,...h]=a.split("-"),m=h.join("-")||void 0;return {parts:(c??"").split(".").map(p=>Number.parseInt(p,10)||0),pre:m}},r=n(e),i=n(t),l=Math.max(r.parts.length,i.parts.length);for(let a=0;a<l;a++){let c=r.parts[a]??0,h=i.parts[a]??0;if(c!==h)return c<h?-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),s=Number.parseInt(i.pre.match(/(\d+)$/)?.[1]??"",10);return !Number.isNaN(o)&&!Number.isNaN(s)&&o!==s?o<s?-1:1:r.pre<i.pre?-1:r.pre>i.pre?1:0}function C(e,t){return $e(e,t)<0}var ce=d__namespace.win32,le=1;function ue(e,t){if(!e.existsSync(t))return null;try{let n=JSON.parse(e.readFileSync(t));return {schema:n.schema??le,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 O(e,t,n){let r={schema:le,...n,updatedAt:new Date().toISOString()};e.mkdirSync(ce.dirname(t)),e.writeFileSync(t,JSON.stringify(r,null,2));}function b(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 de(e,t,n){e.mkdirSync(ce.dirname(t)),e.writeFileSync(t,JSON.stringify(n,null,2));}var He=d__namespace.win32,x=1;function Ve(e){return e.replace(/%/g,"%%")}function Xe(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=${Ve(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 fe(e){let t=b(e.fs,e.launcherManifestPath),n=!!t&&t.schema>=x&&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=Xe({bakedBinPath:e.bakedBinPath});try{e.fs.mkdirSync(He.dirname(e.wrapperPath)),e.fs.writeFileSync(e.wrapperPath,l),de(e.fs,e.launcherManifestPath,{schema:x,binPath:e.bakedBinPath,updatedAt:new Date().toISOString()});}catch(o){throw o instanceof f?o:new f("WRITE_DENIED",`Could not write launcher wrapper: ${o instanceof Error?o.message:String(o)}`)}return {wrapperPath:e.wrapperPath,wrote:true,schema:x}}var Ge=["$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("; "),Ue=["[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 he(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",Ge],{env:t});}catch(r){throw new f("POWERSHELL_UNAVAILABLE",`Could not run PowerShell: ${r instanceof Error?r.message:String(r)}`)}if(n.code!==0)throw new f("POWERSHELL_UNAVAILABLE",`Failed to create desktop shortcut: ${n.stderr||n.stdout}`)}function me(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 ge(e){try{let t={...e.env,CREWX_LNK_PATH:e.shortcutPath},n=await e.run("powershell",["-NoProfile","-NonInteractive","-Command",Ue],{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 B=d__namespace.win32;async function I(e){let t=F(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 a=await e.run("npm",["prefix","-g"],{env:n});a.code===0&&(o=a.stdout.trim()||void 0);}catch{}let s=o?B.join(o,"crewx.cmd"):void 0;return {installed:true,version:l.version,binPath:s,prefix:o}}var je=/EACCES|EPERM|EROFS/,Je=/ENOTFOUND|ETIMEDOUT|ECONNREFUSED|network|registry/i,Ke=/^\d+\.\d+\.\d+/;function ze(e){return !!e&&e!=="0.0.0"&&Ke.test(e)}var M=10*6e4;async function Se(e){if(!ze(e.targetVersion))throw new f("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&&!C(e.currentInfo.version,e.targetVersion))return {info:e.currentInfo};let t=F(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:M});}catch(o){throw new f("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(je.test(l)){e.onProgress?.({phase:"global-install",message:"Permission denied \u2014 retrying with a user-scoped npm prefix"});let o=e.env.LOCALAPPDATA||B.join(e.env.USERPROFILE??"","AppData","Local"),s={...n,npm_config_prefix:B.join(o,"crewx","npm")},a;try{a=await e.run("npm",["install","-g",r,"--no-audit","--no-fund"],{env:s,timeoutMs:M});}catch(c){throw new f("NPM_PERMISSION_DENIED",`Retry with user-scoped prefix failed: ${c instanceof Error?c.message:String(c)}`)}if(a.code===0)return {info:await I({env:s,cwd:e.cwd,run:e.run})};throw new f("NPM_PERMISSION_DENIED",`npm install -g failed after user-scoped prefix retry: ${a.stderr||a.stdout}`)}if(Je.test(l)){if(!e.installRoot)throw new f("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:M});}catch(s){throw new f("GLOBAL_INSTALL_FAILED",`Offline install failed: ${s instanceof Error?s.message:String(s)}`)}if(o.code===0)return {info:await I({env:n,cwd:e.cwd,run:e.run})};throw new f("GLOBAL_INSTALL_FAILED",`Offline install failed: ${o.stderr||o.stdout}`)}throw new f("GLOBAL_INSTALL_FAILED",l.trim()||`npm install -g ${r} failed`)}function Qe(e){return e.run??Q}function Ye(e){return e.fs??X}async function A(e){let t=e.platform??process.platform,n=e.env??process.env,r=e.homedir??G,i=Qe(e),l=Ye(e),o=e.runningVersion??Z,s=e.cwd??process.cwd(),a=r(),c=te(a),h=ne(a),m=re(a),u=null;t==="win32"&&(u=await se({env:n,homedir:r,run:i}));let p=u?oe(u.dir):null;return {platform:t,env:n,homedir:r,run:i,fs:l,runningVersion:o,cwd:s,installRoot:e.installRoot,shortcutManifestPath:c,launcherManifestPath:h,wrapperPath:m,desktop:u,shortcutPath:p}}function Pe(e){return e?d__namespace.win32.normalize(e).toLowerCase().endsWith(`${d__namespace.win32.sep}bin${d__namespace.win32.sep}crewx.ico`):false}function $(e,t){let n=e.readBinaryFileSync;if(n)try{return crypto.createHash("sha256").update(n(t)).digest("hex")}catch{return}}async function Ze(e){try{await e.run("ie4uinit.exe",["-show"],{env:e.env});}catch{}}async function E(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=ue(e.fs,e.shortcutManifestPath),r=b(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,s=false,a,c;if(!l)o=n?.declined?"declined":"not-installed";else {let h=!!n?.owned&&!!e.shortcutPath&&n.shortcutPath===e.shortcutPath,m=false,u=e.shortcutPath?await ge({run:e.run,env:e.env,shortcutPath:e.shortcutPath}):null;if(h||(u&&T(u.targetPath,e.wrapperPath)?h=true:u&&ie(u.targetPath)&&(m=true)),m)o="foreign",t.push("NSIS_PRESENT: an NSIS-installed CrewX shortcut was detected");else if(!h)o="foreign";else if(n?.version&&C(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 p=!r||r.schema<x||!e.fs.existsSync(e.wrapperPath);if(u){let w=me(u.iconLocation);if(!(!!w&&e.fs.existsSync(w)))s=true;else {a=w;let g=Ee(i,e.fs);g?T(w,g)?(c=$(e.fs,w),s=!c||n?.iconHash!==c):s=true:Pe(w)?(c=$(e.fs,w),s=!c||n?.iconHash!==c):s=true;}}o=p||s?"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:s,iconPath:a,iconHash:c}}function Ee(e,t){if(!e?.installed||!e.prefix)return;let n=d__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 et(e={}){let t=await A(e),n=await E(t);return R(n)}async function tt(e={}){let t=await A(e);e.onProgress?.({phase:"detect",message:"Checking current shortcut status"});let n=await E(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(g=>g.startsWith("NSIS_PRESENT")))throw new f("NSIS_PRESENT",`An NSIS-installed CrewX shortcut was detected at ${r.shortcutPath}`);if(!e.force)throw new f("FOREIGN_SHORTCUT",`An existing shortcut at ${r.shortcutPath} is not managed by CrewX`)}if(!t.desktop||!t.shortcutPath)throw new f("NO_DESKTOP_DIR","Could not resolve the Windows Desktop directory");let i=false,l=false,o=r.globalCrewx,s=[],a=n.manifest?.iconHash,c=false;if(!!o?.installed&&!!o.version&&C(o.version,t.runningVersion)||!o?.installed&&r.state!=="installed"){let g=await Se({env:t.env,cwd:t.cwd,run:t.run,targetVersion:t.runningVersion,currentInfo:o??void 0,installRoot:t.installRoot,onProgress:e.onProgress});o=g.info,l=g.info.installed,i=true,l||s.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"}),fe({fs:t.fs,wrapperPath:t.wrapperPath,launcherManifestPath:t.launcherManifestPath,bakedBinPath:o?.binPath}).wrote&&(i=true),!((r.state==="installed"||r.state==="stale")&&!n.iconStale)){let g=Ee(o,t.fs)??(n.iconPath&&Pe(n.iconPath)&&t.fs.existsSync(n.iconPath)?n.iconPath:void 0);if(n.iconStale&&!g)throw new f("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 he({run:t.run,env:t.env,shortcutPath:t.shortcutPath,targetPath:t.wrapperPath,iconPath:g}),i=true,c=n.iconStale;let k=g?$(t.fs,g):void 0;k&&(a=k);}i&&O(t.fs,t.shortcutManifestPath,{shortcutPath:t.shortcutPath,version:t.runningVersion,owned:true,declined:false,desktopSource:t.desktop.source,iconHash:a}),c&&await Ze(t);let w=await E(t),y=R(w);return {...y,errors:[...y.errors,...s],changed:i,installedGlobal:l}}async function nt(e={}){let t=await A(e),n=await E(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{}O(t.fs,t.shortcutManifestPath,{shortcutPath:void 0,version:n.manifest?.version,owned:false,declined:true,desktopSource:void 0,iconHash:void 0});let i=await E(t);return R(i)}async function rt(e={}){let t=await A(e),n=await E(t),r=R(n);if(!r.supported)return r;O(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 E(t);return R(i)}exports.ShortcutError=f;exports.dismissShortcutNotice=rt;exports.getShortcutStatus=et;exports.installShortcut=tt;exports.uninstallShortcut=nt;

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;