@xenosystem/agent-sdk 0.8.12

package/dist/utils/index.d.cts

@@ -0,0 +1,245 @@
+type TextEncoding = "utf8" | "utf8-bom" | "utf16le" | "utf16be";
+type LineEnding = "LF" | "CRLF";
+interface TextFileContents {
+    content: string;
+    encoding: TextEncoding;
+    lineEnding: LineEnding;
+    sizeBytes: number;
+}
+declare function hasFile(filePath: string): boolean;
+declare function hasDir(dirPath: string): boolean;
+declare function readFileSafe(filePath: string, fallback?: string): string;
+declare function ensureDir(dirPath: string): Promise<void>;
+declare function writeAtomic(filePath: string, content: string | Buffer): Promise<void>;
+declare function appendLine(filePath: string, line: string): Promise<void>;
+declare function detectTextEncoding(buffer: Buffer): TextEncoding;
+declare function decodeTextBuffer(buffer: Buffer, encoding: TextEncoding): string;
+declare function encodeTextBuffer(content: string, encoding: TextEncoding): Buffer;
+declare function detectLineEnding(content: string): LineEnding;
+declare function normalizeLineEndings(content: string, lineEnding: LineEnding): string;
+declare function readTextFile(filePath: string): Promise<TextFileContents>;
+declare function writeTextFile(filePath: string, content: string, options?: {
+    encoding?: TextEncoding;
+    lineEnding?: LineEnding;
+}): Promise<void>;
+declare function detectPreferredLineEnding(baseDir: string): Promise<LineEnding>;
+declare function findSimilarFile(filePath: string): string | null;
+declare function readIfExists(filePath: string): Promise<string | null>;
+declare function existsSync(filePath: string): boolean;
+declare function listFiles(dir: string, pattern?: RegExp): Promise<string[]>;
+declare function listDirs(dir: string): Promise<string[]>;
+declare function deleteFile(filePath: string): Promise<void>;
+declare function deleteDir(dirPath: string): Promise<void>;
+declare function safeJsonParse<T>(str: string, fallback: T): T;
+declare function safeJsonStringify(obj: unknown, fallback?: string): string;
+declare function parseJsonLines<T>(content: string): T[];
+interface ParsedDocument<T = Record<string, unknown>> {
+    frontmatter: T;
+    content: string;
+}
+declare function parseDocument<T = Record<string, unknown>>(raw: string): ParsedDocument<T>;
+declare function stringifyDocument(frontmatter: Record<string, unknown>, content: string): string;
+declare function hasFrontmatter(raw: string): boolean;
+declare function isPathSafe(basePath: string, targetPath: string): boolean;
+declare function safeResolvePath(basePath: string, targetPath: string): string;
+declare const PLATFORM: NodeJS.Platform;
+declare const IS_WINDOWS: boolean;
+declare const IS_MAC: boolean;
+declare const IS_LINUX: boolean;
+declare const OS_VERSION: string;
+declare const HOME_DIR: string;
+declare function getConfigDir(): string;
+declare function getProjectConfigDir(cwd: string): string;
+declare function getShellName(): string;
+declare function isGitRepo(cwd: string): boolean;
+declare function validateRequired(params: Record<string, unknown>, required: string[]): string | null;
+declare function getString(params: Record<string, unknown>, key: string, defaultValue?: string): string;
+declare function getNumber(params: Record<string, unknown>, key: string, defaultValue?: number): number;
+declare function getBoolean(params: Record<string, unknown>, key: string, defaultValue?: boolean): boolean;
+declare function validateRegexPattern(pattern: string): string | null;
+declare function createSafeRegex(pattern: string, flags?: string, _timeoutMs?: number): RegExp;
+declare function safeRegexTest(regex: RegExp, text: string, _timeoutMs?: number): boolean;
+declare enum LogLevel {
+    DEBUG = 0,
+    INFO = 1,
+    WARN = 2,
+    ERROR = 3,
+    SILENT = 4
+}
+declare function setLogLevel(level: LogLevel): void;
+declare function getLogLevel(): LogLevel;
+declare function debug(msg: string, data?: unknown): void;
+declare function info(msg: string, data?: unknown): void;
+declare function warn(msg: string, data?: unknown): void;
+declare function error(msg: string, data?: unknown): void;
+interface RetryOptions {
+    maxRetries?: number;
+    baseDelayMs?: number;
+    maxDelayMs?: number;
+    jitterMs?: number;
+    signal?: AbortSignal;
+    onBeforeAttempt?: (attempt: number) => void;
+    shouldRetry?: (error: unknown, attempt: number) => boolean;
+    getDelayMs?: (error: unknown, attempt: number, defaultDelayMs: number) => number | null | undefined;
+    onAbort?: () => Error;
+}
+interface RetryErrorContext {
+    statusCode?: number;
+    retryAfterMs?: number;
+    requestId?: string;
+    cfRay?: string;
+}
+declare class ApiTransientError extends Error {
+    readonly statusCode?: number;
+    readonly body?: string;
+    readonly retryAfterMs?: number;
+    readonly requestId?: string;
+    readonly cfRay?: string;
+    constructor(message: string, context?: RetryErrorContext);
+}
+declare function getRetryErrorContext(error: unknown): RetryErrorContext;
+declare function isRetryableError(error: unknown): boolean;
+declare function withRetry<T>(fn: () => Promise<T>, options?: RetryOptions): Promise<T>;
+type TokenEstimator = (text: string, model: string) => number;
+type TokenAccountingSource = "exact" | "provider-reported" | "estimated";
+interface TokenAccountingResult {
+    tokens: number;
+    source: TokenAccountingSource;
+    adapterId: string;
+}
+interface TokenAccountingAdapter {
+    readonly id: string;
+    readonly source: Exclude<TokenAccountingSource, "provider-reported">;
+    countText(text: string, model: string): number;
+    countImage?(input: {
+        model: string;
+        detail?: "auto" | "low" | "high";
+    }): number;
+    safetyMarginRatio?(model: string): number;
+}
+declare const estimateTokensForModel: TokenEstimator;
+declare const conservativeTokenAccountingAdapter: TokenAccountingAdapter;
+declare function accountTextTokens(text: string, model: string, adapter?: TokenAccountingAdapter): TokenAccountingResult;
+declare function estimateTokens(text: string): number;
+declare function truncateToTokens(text: string, maxTokens: number): string;
+declare function fitsInBudget(text: string, budget: number): boolean;
+declare function remainingBudget(used: number, total: number): number;
+declare function calculateCost(model: string, inputTokens: number, outputTokens: number): number;
+declare function formatCost(cost: number): string;
+declare function copyTextToClipboard(text: string): void;
+declare function isBenchmarkMode(): boolean;
+declare function isBenchmarkLeakPath(filePath: string): boolean;
+declare function filterBenchmarkLeakPaths(paths: string[]): string[];
+declare function benchmarkLeakError(target: string): string;
+declare function commandMentionsBenchmarkLeak(command: string): boolean;
+declare function getBenchmarkReferenceOverwriteHint(command: string): string | null;
+interface ImageUrlBlock {
+    type: "image_url";
+    image_url: {
+        url: string;
+        detail?: "auto" | "low" | "high";
+    };
+}
+interface ResourceContentBlock {
+    type: "resource";
+    uri?: string;
+    mimeType?: string;
+    text?: string;
+    data?: string;
+}
+type ToolAssistantContentBlock = TextBlock | ImageUrlBlock | ResourceContentBlock;
+type ToolResultContent = string | ToolAssistantContentBlock[];
+type ToolOperationState = "registered" | "starting" | "running_foreground" | "running_background" | "waiting_for_input" | "stalled" | "verifying" | "completed" | "failed" | "timed_out" | "cancelled" | "orphaned";
+type ToolCompletionPolicy = "await" | "observe" | "detach";
+interface ExpectedOutputContract {
+    path: string;
+    kind?: "file" | "directory";
+    nonEmpty?: boolean;
+}
+interface ToolEvidence {
+    id: string;
+    kind: "artifact" | "process" | "verification";
+    status: "pending" | "verified" | "failed";
+    path?: string;
+    observedAt: string;
+    operationId: string;
+    detail?: Record<string, string | number | boolean | null>;
+}
+interface ToolOperationSnapshot {
+    schemaVersion: 1;
+    operationId: string;
+    turnId: string;
+    generation: number;
+    toolCallId: string;
+    toolName: string;
+    ownerSessionId?: string;
+    state: ToolOperationState;
+    terminal: boolean;
+    presentation: "foreground" | "background";
+    completionPolicy: ToolCompletionPolicy;
+    promotable: boolean;
+    processId?: string;
+    taskId?: string;
+    pid?: number;
+    commandFingerprint?: string;
+    outputPath?: string;
+    startedAt: string;
+    lastActivityAt: string;
+    deadlineAt?: string;
+    elapsedMs: number;
+    idleMs: number;
+    outputBytes: number;
+    nextOffset: number;
+    exitCode?: number | null;
+    completionReason?: string;
+    suggestedNextAction?: string;
+    expectedOutputs?: ExpectedOutputContract[];
+    evidence?: ToolEvidence[];
+}
+interface ToolResult {
+    success: boolean;
+    output: string;
+    error?: string;
+    errorCode?: string;
+    errorDetails?: Record<string, unknown>;
+    assistantContent?: ToolAssistantContentBlock[];
+    assistantOnlyContent?: ToolAssistantContentBlock[];
+    operation?: ToolOperationSnapshot;
+    evidence?: ToolEvidence[];
+    retryable?: boolean;
+}
+interface TextBlock {
+    type: "text";
+    text: string;
+}
+interface ToolResultBlock {
+    type: "tool_result";
+    tool_use_id: string;
+    content: string;
+    assistant_content?: ToolAssistantContentBlock[];
+    assistant_only_content?: ToolAssistantContentBlock[];
+    is_error?: boolean;
+    operation?: ToolOperationSnapshot;
+    evidence?: ToolEvidence[];
+    retryable?: boolean;
+}
+declare function toolAssistantContentToText(blocks: ToolAssistantContentBlock[]): string;
+declare function toolResultContentToText(content: ToolResultContent): string;
+declare function buildToolResultText(result: ToolResult): string;
+declare function getToolResultTransportContent(block: {
+    content: ToolResultContent;
+    assistant_content?: ToolAssistantContentBlock[];
+    assistant_only_content?: ToolAssistantContentBlock[];
+    operation?: ToolResult["operation"];
+    evidence?: ToolResult["evidence"];
+    retryable?: boolean;
+}): ToolResultContent;
+declare function hasNonTextToolResultContent(content: ToolResultContent): boolean;
+declare function toTransportAssistantBlocks(content: ToolResultContent): ToolAssistantContentBlock[];
+declare function buildToolResultBlock(toolUseId: string, result: ToolResult): ToolResultBlock;
+interface XenoAsciiControlCharacterPolicy {
+    allowTab?: boolean;
+    allowLineBreaks?: boolean;
+}
+declare function hasDisallowedAsciiControlCharacter(value: string, policy?: XenoAsciiControlCharacterPolicy): boolean;
+export { ApiTransientError, HOME_DIR, IS_LINUX, IS_MAC, IS_WINDOWS, type LineEnding, LogLevel, OS_VERSION, PLATFORM, type ParsedDocument, type RetryErrorContext, type RetryOptions, type TextEncoding, type TextFileContents, type TokenAccountingAdapter, type TokenAccountingResult, type TokenAccountingSource, type TokenEstimator, type XenoAsciiControlCharacterPolicy, accountTextTokens, appendLine, benchmarkLeakError, buildToolResultBlock, buildToolResultText, calculateCost, commandMentionsBenchmarkLeak, conservativeTokenAccountingAdapter, copyTextToClipboard, createSafeRegex, debug, decodeTextBuffer, deleteDir, deleteFile, detectLineEnding, detectPreferredLineEnding, detectTextEncoding, encodeTextBuffer, ensureDir, error, estimateTokens, estimateTokensForModel, existsSync, filterBenchmarkLeakPaths, findSimilarFile, fitsInBudget, formatCost, getBenchmarkReferenceOverwriteHint, getBoolean, getConfigDir, getLogLevel, getNumber, getProjectConfigDir, getRetryErrorContext, getShellName, getString, getToolResultTransportContent, hasDir, hasDisallowedAsciiControlCharacter, hasFile, hasFrontmatter, hasNonTextToolResultContent, info, isBenchmarkLeakPath, isBenchmarkMode, isGitRepo, isPathSafe, isRetryableError, listDirs, listFiles, normalizeLineEndings, parseDocument, parseJsonLines, readFileSafe, readIfExists, readTextFile, remainingBudget, safeJsonParse, safeJsonStringify, safeRegexTest, safeResolvePath, setLogLevel, stringifyDocument, toTransportAssistantBlocks, toolAssistantContentToText, toolResultContentToText, truncateToTokens, validateRegexPattern, validateRequired, warn, withRetry, writeAtomic, writeTextFile };

package/dist/utils/index.d.ts

@@ -0,0 +1,245 @@
+type TextEncoding = "utf8" | "utf8-bom" | "utf16le" | "utf16be";
+type LineEnding = "LF" | "CRLF";
+interface TextFileContents {
+    content: string;
+    encoding: TextEncoding;
+    lineEnding: LineEnding;
+    sizeBytes: number;
+}
+declare function hasFile(filePath: string): boolean;
+declare function hasDir(dirPath: string): boolean;
+declare function readFileSafe(filePath: string, fallback?: string): string;
+declare function ensureDir(dirPath: string): Promise<void>;
+declare function writeAtomic(filePath: string, content: string | Buffer): Promise<void>;
+declare function appendLine(filePath: string, line: string): Promise<void>;
+declare function detectTextEncoding(buffer: Buffer): TextEncoding;
+declare function decodeTextBuffer(buffer: Buffer, encoding: TextEncoding): string;
+declare function encodeTextBuffer(content: string, encoding: TextEncoding): Buffer;
+declare function detectLineEnding(content: string): LineEnding;
+declare function normalizeLineEndings(content: string, lineEnding: LineEnding): string;
+declare function readTextFile(filePath: string): Promise<TextFileContents>;
+declare function writeTextFile(filePath: string, content: string, options?: {
+    encoding?: TextEncoding;
+    lineEnding?: LineEnding;
+}): Promise<void>;
+declare function detectPreferredLineEnding(baseDir: string): Promise<LineEnding>;
+declare function findSimilarFile(filePath: string): string | null;
+declare function readIfExists(filePath: string): Promise<string | null>;
+declare function existsSync(filePath: string): boolean;
+declare function listFiles(dir: string, pattern?: RegExp): Promise<string[]>;
+declare function listDirs(dir: string): Promise<string[]>;
+declare function deleteFile(filePath: string): Promise<void>;
+declare function deleteDir(dirPath: string): Promise<void>;
+declare function safeJsonParse<T>(str: string, fallback: T): T;
+declare function safeJsonStringify(obj: unknown, fallback?: string): string;
+declare function parseJsonLines<T>(content: string): T[];
+interface ParsedDocument<T = Record<string, unknown>> {
+    frontmatter: T;
+    content: string;
+}
+declare function parseDocument<T = Record<string, unknown>>(raw: string): ParsedDocument<T>;
+declare function stringifyDocument(frontmatter: Record<string, unknown>, content: string): string;
+declare function hasFrontmatter(raw: string): boolean;
+declare function isPathSafe(basePath: string, targetPath: string): boolean;
+declare function safeResolvePath(basePath: string, targetPath: string): string;
+declare const PLATFORM: NodeJS.Platform;
+declare const IS_WINDOWS: boolean;
+declare const IS_MAC: boolean;
+declare const IS_LINUX: boolean;
+declare const OS_VERSION: string;
+declare const HOME_DIR: string;
+declare function getConfigDir(): string;
+declare function getProjectConfigDir(cwd: string): string;
+declare function getShellName(): string;
+declare function isGitRepo(cwd: string): boolean;
+declare function validateRequired(params: Record<string, unknown>, required: string[]): string | null;
+declare function getString(params: Record<string, unknown>, key: string, defaultValue?: string): string;
+declare function getNumber(params: Record<string, unknown>, key: string, defaultValue?: number): number;
+declare function getBoolean(params: Record<string, unknown>, key: string, defaultValue?: boolean): boolean;
+declare function validateRegexPattern(pattern: string): string | null;
+declare function createSafeRegex(pattern: string, flags?: string, _timeoutMs?: number): RegExp;
+declare function safeRegexTest(regex: RegExp, text: string, _timeoutMs?: number): boolean;
+declare enum LogLevel {
+    DEBUG = 0,
+    INFO = 1,
+    WARN = 2,
+    ERROR = 3,
+    SILENT = 4
+}
+declare function setLogLevel(level: LogLevel): void;
+declare function getLogLevel(): LogLevel;
+declare function debug(msg: string, data?: unknown): void;
+declare function info(msg: string, data?: unknown): void;
+declare function warn(msg: string, data?: unknown): void;
+declare function error(msg: string, data?: unknown): void;
+interface RetryOptions {
+    maxRetries?: number;
+    baseDelayMs?: number;
+    maxDelayMs?: number;
+    jitterMs?: number;
+    signal?: AbortSignal;
+    onBeforeAttempt?: (attempt: number) => void;
+    shouldRetry?: (error: unknown, attempt: number) => boolean;
+    getDelayMs?: (error: unknown, attempt: number, defaultDelayMs: number) => number | null | undefined;
+    onAbort?: () => Error;
+}
+interface RetryErrorContext {
+    statusCode?: number;
+    retryAfterMs?: number;
+    requestId?: string;
+    cfRay?: string;
+}
+declare class ApiTransientError extends Error {
+    readonly statusCode?: number;
+    readonly body?: string;
+    readonly retryAfterMs?: number;
+    readonly requestId?: string;
+    readonly cfRay?: string;
+    constructor(message: string, context?: RetryErrorContext);
+}
+declare function getRetryErrorContext(error: unknown): RetryErrorContext;
+declare function isRetryableError(error: unknown): boolean;
+declare function withRetry<T>(fn: () => Promise<T>, options?: RetryOptions): Promise<T>;
+type TokenEstimator = (text: string, model: string) => number;
+type TokenAccountingSource = "exact" | "provider-reported" | "estimated";
+interface TokenAccountingResult {
+    tokens: number;
+    source: TokenAccountingSource;
+    adapterId: string;
+}
+interface TokenAccountingAdapter {
+    readonly id: string;
+    readonly source: Exclude<TokenAccountingSource, "provider-reported">;
+    countText(text: string, model: string): number;
+    countImage?(input: {
+        model: string;
+        detail?: "auto" | "low" | "high";
+    }): number;
+    safetyMarginRatio?(model: string): number;
+}
+declare const estimateTokensForModel: TokenEstimator;
+declare const conservativeTokenAccountingAdapter: TokenAccountingAdapter;
+declare function accountTextTokens(text: string, model: string, adapter?: TokenAccountingAdapter): TokenAccountingResult;
+declare function estimateTokens(text: string): number;
+declare function truncateToTokens(text: string, maxTokens: number): string;
+declare function fitsInBudget(text: string, budget: number): boolean;
+declare function remainingBudget(used: number, total: number): number;
+declare function calculateCost(model: string, inputTokens: number, outputTokens: number): number;
+declare function formatCost(cost: number): string;
+declare function copyTextToClipboard(text: string): void;
+declare function isBenchmarkMode(): boolean;
+declare function isBenchmarkLeakPath(filePath: string): boolean;
+declare function filterBenchmarkLeakPaths(paths: string[]): string[];
+declare function benchmarkLeakError(target: string): string;
+declare function commandMentionsBenchmarkLeak(command: string): boolean;
+declare function getBenchmarkReferenceOverwriteHint(command: string): string | null;
+interface ImageUrlBlock {
+    type: "image_url";
+    image_url: {
+        url: string;
+        detail?: "auto" | "low" | "high";
+    };
+}
+interface ResourceContentBlock {
+    type: "resource";
+    uri?: string;
+    mimeType?: string;
+    text?: string;
+    data?: string;
+}
+type ToolAssistantContentBlock = TextBlock | ImageUrlBlock | ResourceContentBlock;
+type ToolResultContent = string | ToolAssistantContentBlock[];
+type ToolOperationState = "registered" | "starting" | "running_foreground" | "running_background" | "waiting_for_input" | "stalled" | "verifying" | "completed" | "failed" | "timed_out" | "cancelled" | "orphaned";
+type ToolCompletionPolicy = "await" | "observe" | "detach";
+interface ExpectedOutputContract {
+    path: string;
+    kind?: "file" | "directory";
+    nonEmpty?: boolean;
+}
+interface ToolEvidence {
+    id: string;
+    kind: "artifact" | "process" | "verification";
+    status: "pending" | "verified" | "failed";
+    path?: string;
+    observedAt: string;
+    operationId: string;
+    detail?: Record<string, string | number | boolean | null>;
+}
+interface ToolOperationSnapshot {
+    schemaVersion: 1;
+    operationId: string;
+    turnId: string;
+    generation: number;
+    toolCallId: string;
+    toolName: string;
+    ownerSessionId?: string;
+    state: ToolOperationState;
+    terminal: boolean;
+    presentation: "foreground" | "background";
+    completionPolicy: ToolCompletionPolicy;
+    promotable: boolean;
+    processId?: string;
+    taskId?: string;
+    pid?: number;
+    commandFingerprint?: string;
+    outputPath?: string;
+    startedAt: string;
+    lastActivityAt: string;
+    deadlineAt?: string;
+    elapsedMs: number;
+    idleMs: number;
+    outputBytes: number;
+    nextOffset: number;
+    exitCode?: number | null;
+    completionReason?: string;
+    suggestedNextAction?: string;
+    expectedOutputs?: ExpectedOutputContract[];
+    evidence?: ToolEvidence[];
+}
+interface ToolResult {
+    success: boolean;
+    output: string;
+    error?: string;
+    errorCode?: string;
+    errorDetails?: Record<string, unknown>;
+    assistantContent?: ToolAssistantContentBlock[];
+    assistantOnlyContent?: ToolAssistantContentBlock[];
+    operation?: ToolOperationSnapshot;
+    evidence?: ToolEvidence[];
+    retryable?: boolean;
+}
+interface TextBlock {
+    type: "text";
+    text: string;
+}
+interface ToolResultBlock {
+    type: "tool_result";
+    tool_use_id: string;
+    content: string;
+    assistant_content?: ToolAssistantContentBlock[];
+    assistant_only_content?: ToolAssistantContentBlock[];
+    is_error?: boolean;
+    operation?: ToolOperationSnapshot;
+    evidence?: ToolEvidence[];
+    retryable?: boolean;
+}
+declare function toolAssistantContentToText(blocks: ToolAssistantContentBlock[]): string;
+declare function toolResultContentToText(content: ToolResultContent): string;
+declare function buildToolResultText(result: ToolResult): string;
+declare function getToolResultTransportContent(block: {
+    content: ToolResultContent;
+    assistant_content?: ToolAssistantContentBlock[];
+    assistant_only_content?: ToolAssistantContentBlock[];
+    operation?: ToolResult["operation"];
+    evidence?: ToolResult["evidence"];
+    retryable?: boolean;
+}): ToolResultContent;
+declare function hasNonTextToolResultContent(content: ToolResultContent): boolean;
+declare function toTransportAssistantBlocks(content: ToolResultContent): ToolAssistantContentBlock[];
+declare function buildToolResultBlock(toolUseId: string, result: ToolResult): ToolResultBlock;
+interface XenoAsciiControlCharacterPolicy {
+    allowTab?: boolean;
+    allowLineBreaks?: boolean;
+}
+declare function hasDisallowedAsciiControlCharacter(value: string, policy?: XenoAsciiControlCharacterPolicy): boolean;
+export { ApiTransientError, HOME_DIR, IS_LINUX, IS_MAC, IS_WINDOWS, type LineEnding, LogLevel, OS_VERSION, PLATFORM, type ParsedDocument, type RetryErrorContext, type RetryOptions, type TextEncoding, type TextFileContents, type TokenAccountingAdapter, type TokenAccountingResult, type TokenAccountingSource, type TokenEstimator, type XenoAsciiControlCharacterPolicy, accountTextTokens, appendLine, benchmarkLeakError, buildToolResultBlock, buildToolResultText, calculateCost, commandMentionsBenchmarkLeak, conservativeTokenAccountingAdapter, copyTextToClipboard, createSafeRegex, debug, decodeTextBuffer, deleteDir, deleteFile, detectLineEnding, detectPreferredLineEnding, detectTextEncoding, encodeTextBuffer, ensureDir, error, estimateTokens, estimateTokensForModel, existsSync, filterBenchmarkLeakPaths, findSimilarFile, fitsInBudget, formatCost, getBenchmarkReferenceOverwriteHint, getBoolean, getConfigDir, getLogLevel, getNumber, getProjectConfigDir, getRetryErrorContext, getShellName, getString, getToolResultTransportContent, hasDir, hasDisallowedAsciiControlCharacter, hasFile, hasFrontmatter, hasNonTextToolResultContent, info, isBenchmarkLeakPath, isBenchmarkMode, isGitRepo, isPathSafe, isRetryableError, listDirs, listFiles, normalizeLineEndings, parseDocument, parseJsonLines, readFileSafe, readIfExists, readTextFile, remainingBudget, safeJsonParse, safeJsonStringify, safeRegexTest, safeResolvePath, setLogLevel, stringifyDocument, toTransportAssistantBlocks, toolAssistantContentToText, toolResultContentToText, truncateToTokens, validateRegexPattern, validateRequired, warn, withRetry, writeAtomic, writeTextFile };

package/dist/utils/index.js

@@ -0,0 +1,23 @@
+import{readdirSync as A,readFileSync as X}from"node:fs";import{existsSync as R,statSync as M}from"node:fs";import*as c from"node:fs/promises";import*as a from"node:path";function It(t){try{return R(t)&&M(t).isFile()}catch{return!1}}function Dt(t){try{return R(t)&&M(t).isDirectory()}catch{return!1}}function Ft(t,e=""){try{return X(t,"utf-8")}catch{return e}}async function C(t){await c.mkdir(t,{recursive:!0})}async function z(t,e){let n=a.dirname(t);await C(n);let r=Math.random().toString(36).substring(2,15),o=`${t}.tmp.${process.pid}.${r}`;try{await c.writeFile(o,e),await c.rename(o,t)}finally{try{await c.unlink(o)}catch{}}}async function Wt(t,e){let n=a.dirname(t);await C(n),await c.appendFile(t,e+`
+`,"utf-8")}function Y(t){return t.length>=3&&t[0]===239&&t[1]===187&&t[2]===191?"utf8-bom":t.length>=2&&t[0]===255&&t[1]===254?"utf16le":t.length>=2&&t[0]===254&&t[1]===255?"utf16be":"utf8"}function S(t){let e=Buffer.from(t);for(let n=0;n+1<e.length;n+=2){let r=e[n];e[n]=e[n+1],e[n+1]=r}return e}function G(t,e){switch(e){case"utf8-bom":return t.subarray(3).toString("utf8");case"utf16le":return t.subarray(2).toString("utf16le");case"utf16be":return S(t.subarray(2)).toString("utf16le");default:return t.toString("utf8")}}function U(t,e){switch(e){case"utf8-bom":return Buffer.concat([Buffer.from([239,187,191]),Buffer.from(t,"utf8")]);case"utf16le":return Buffer.concat([Buffer.from([255,254]),Buffer.from(t,"utf16le")]);case"utf16be":return Buffer.concat([Buffer.from([254,255]),S(Buffer.from(t,"utf16le"))]);default:return Buffer.from(t,"utf8")}}function K(t){return t.includes(`\r
+`)?"CRLF":"LF"}function Q(t,e){let n=t.replace(/\r\n/g,`
+`);return e==="CRLF"?n.replace(/\n/g,`\r
+`):n}async function Z(t){let e=await c.readFile(t),n=Y(e),r=G(e,n);return{content:r,encoding:n,lineEnding:K(r),sizeBytes:e.length}}async function jt(t,e,n){let r=Q(e,n?.lineEnding??"LF");await z(t,U(r,n?.encoding??"utf8"))}async function qt(t){let e=new Set,n=a.resolve(t);for(;!e.has(n);){e.add(n);try{let o=A(n,{withFileTypes:!0}).filter(i=>i.isFile()).map(i=>i.name).sort();for(let i of o){if(i.startsWith("."))continue;let s=a.extname(i).toLowerCase();if([".ts",".tsx",".js",".jsx",".json",".md",".txt",".yaml",".yml",".css",".html",".xml",".sh",".ps1"].includes(s))try{let u=a.join(n,i),l=await Z(u);if(l.content.length>0)return l.lineEnding}catch{}}}catch{}let r=a.dirname(n);if(r===n)break;n=r}return"LF"}function V(t,e,n){let r=[],o=[{dir:t,depth:0}],i=new Set;for(;o.length>0&&r.length<n;){let s=o.shift();if(!i.has(s.dir)){i.add(s.dir);try{let u=A(s.dir,{withFileTypes:!0});for(let l of u){let d=a.join(s.dir,l.name);if(l.isFile()){if(r.push(d),r.length>=n)break;continue}l.isDirectory()&&s.depth<e&&!l.name.startsWith(".")&&l.name!=="node_modules"&&o.push({dir:d,depth:s.depth+1})}}catch{}}}return r}function Ht(t){try{let e=a.dirname(t),n=a.basename(t,a.extname(t)).toLowerCase(),r=a.basename(t).toLowerCase(),i=[e,a.dirname(e)].flatMap(u=>V(u,2,500)),s=null;for(let u of i){let l=a.basename(u).toLowerCase(),d=a.basename(u,a.extname(u)).toLowerCase(),m=null;if(l===r?m=0:d===n?m=1:(l.includes(n)||n.includes(d))&&(m=2),m===null)continue;let E=a.relative(e,u).split(a.sep).length,k=m+E*.01;(!s||k<s.score)&&(s={filePath:u,score:k})}return s?.filePath??null}catch{}return null}async function Jt(t){try{return await c.readFile(t,"utf-8")}catch(e){if(e.code==="ENOENT")return null;throw e}}function Xt(t){return R(t)}async function zt(t,e){try{let r=(await c.readdir(t,{withFileTypes:!0})).filter(o=>o.isFile()).map(o=>a.join(t,o.name));return e&&(r=r.filter(o=>e.test(a.basename(o)))),r}catch(n){if(n.code==="ENOENT")return[];throw n}}async function Yt(t){try{return(await c.readdir(t,{withFileTypes:!0})).filter(n=>n.isDirectory()).map(n=>a.join(t,n.name))}catch(e){if(e.code==="ENOENT")return[];throw e}}async function Gt(t){try{await c.unlink(t)}catch(e){if(e.code!=="ENOENT")throw e}}async function Ut(t){try{await c.rm(t,{recursive:!0,force:!0})}catch(e){if(e.code!=="ENOENT")throw e}}function Qt(t,e){try{return JSON.parse(t)}catch{return e}}function Zt(t,e="{}"){try{return JSON.stringify(t)}catch{return e}}function Vt(t){let e=[];for(let n of t.split(`
+`)){let r=n.trim();if(r)try{e.push(JSON.parse(r))}catch{}}return e}function ee(t){let e=tt(t);return{frontmatter:e.frontmatter,content:e.content.trim()}}function ne(t,e){let n=Object.fromEntries(Object.entries(t).filter(([r,o])=>o!==void 0));return["---",v(n),"---","",e].join(`
+`)}function re(t){return t.trimStart().startsWith("---")}function tt(t){let e=t.replace(/^\uFEFF/,"");if(!e.startsWith("---"))return{frontmatter:{},content:t};let n=e.search(/\r?\n/);if(n<0||e.slice(0,n).trim()!=="---")return{frontmatter:{},content:t};let r=e.slice(n+(e[n]==="\r"?2:1)),o=r.match(/(?:^|\r?\n)---[ \t]*(?:\r?\n|$)/);if(!o||o.index===void 0)throw new Error("YAML frontmatter is not closed.");let i=r.slice(0,o.index),s=o[0],u=o.index+s.length;return{frontmatter:$(i),content:r.slice(u)}}function $(t){let e={},n=t.split(/\r?\n/);for(let r=0;r<n.length;r+=1){let o=n[r];if(!o.trim()||o.trimStart().startsWith("#"))continue;if(/^\s/.test(o))throw new Error(`Unexpected indentation at line ${r+1}.`);let i=nt(o,r+1);if(i.key==="<<")throw new Error("YAML merge keys are not supported.");if(i.value!==""){e[i.key]=N(i.value,r+1);continue}let s=et(n,r+1);e[i.key]=s.value,r=s.nextIndex-1}return e}function et(t,e){let n=[],r=e;for(;r<t.length;r+=1){let i=t[r];if(!i.trim()){n.push(i);continue}if(!/^\s/.test(i))break;n.push(i.replace(/^ {2}/,""))}let o=n.filter(i=>i.trim()&&!i.trimStart().startsWith("#"));return o.length===0?{value:{},nextIndex:r}:o.every(i=>i.trimStart().startsWith("- "))?{value:o.map((i,s)=>N(i.trimStart().slice(2),e+s+1)),nextIndex:r}:{value:$(n.join(`
+`)),nextIndex:r}}function nt(t,e){let n=t.indexOf(":");if(n<=0)throw new Error(`Invalid YAML line ${e}.`);let r=t.slice(0,n).trim(),o=t.slice(n+1).trim();if(!r)throw new Error(`Invalid YAML key at line ${e}.`);return{key:r,value:o}}function N(t,e){if(t==="")return"";if(t==="[]")return[];if(t==="{}")return{};if(t==="true")return!0;if(t==="false")return!1;if(t==="null"||t==="~")return null;if(/^-?\d+(?:\.\d+)?$/.test(t))return Number(t);if(t.startsWith('"'))return _(t,e);if(t.startsWith("'")){if(!t.endsWith("'"))throw new Error(`Unclosed quoted scalar at line ${e}.`);return t.slice(1,-1).replace(/''/g,"'")}if(t.startsWith("[")||t.startsWith("{"))return _(t,e);if(t.includes("[")||t.includes("]")||t.includes("{")||t.includes("}"))throw new Error(`Unsupported YAML scalar at line ${e}.`);return t}function _(t,e){try{return JSON.parse(t)}catch{throw new Error(`Invalid YAML scalar at line ${e}.`)}}function v(t,e=""){return Object.entries(t).map(([n,r])=>rt(n,r,e)).join(`
+`)}function rt(t,e,n){return Array.isArray(e)?`${n}${t}: ${JSON.stringify(e)}`:e&&typeof e=="object"?`${n}${t}:
+${v(e,`${n}  `)}`:`${n}${t}: ${JSON.stringify(e)}`}import*as f from"path";function ot(t,e){let n=f.resolve(t),r=f.resolve(t,e);return r===n?!0:n===f.parse(n).root?r.startsWith(n):r.startsWith(n+f.sep)}function ie(t,e){if(f.isAbsolute(e))return f.resolve(e);if(!ot(t,e))throw new Error(`PathSecurity: Path traversal attempt detected: ${e}`);return f.resolve(t,e)}import{homedir as it,platform as st,release as at}from"node:os";import{execSync as ut}from"node:child_process";import{resolve as L}from"node:path";var T=st(),ct=T==="win32",le=T==="darwin",fe=T==="linux",de=at(),lt=it();function pe(){return L(lt,".xeno-code")}function me(t){return L(t,".xeno-code")}function ge(){return ct?"powershell":process.env.SHELL?.split("/").pop()??"bash"}function he(t){try{return ut("git rev-parse --is-inside-work-tree",{cwd:t,stdio:"ignore"}),!0}catch{return!1}}function ye(t,e){for(let n of e)if(t[n]===void 0||t[n]===null||t[n]==="")return`Missing required parameter: ${n}`;return null}function we(t,e,n){let r=t[e];if(r==null){if(n!==void 0)return n;throw new Error(`Missing required parameter: ${e}`)}if(typeof r!="string")throw new Error(`Parameter ${e} must be a string, got ${typeof r}`);return r}function be(t,e,n){let r=t[e];if(r==null){if(n!==void 0)return n;throw new Error(`Missing required parameter: ${e}`)}if(typeof r!="number")throw new Error(`Parameter ${e} must be a number, got ${typeof r}`);if(isNaN(r))throw new Error(`Parameter ${e} is NaN`);return r}function Ee(t,e,n){let r=t[e];if(r==null){if(n!==void 0)return n;throw new Error(`Missing required parameter: ${e}`)}if(typeof r!="boolean")throw new Error(`Parameter ${e} must be a boolean, got ${typeof r}`);return r}function ft(t){if(t.length>5e3)return"Pattern too long (max 5000 characters)";let n=[/(\.\*){3,}/,/(\+\+|\*\*)/,/(.*\+.*\+.*\+)/];for(let r of n)if(r.test(t))return"Pattern contains potentially unsafe constructs that could cause excessive backtracking";return null}function Re(t,e,n=5e3){let r=ft(t);if(r)throw new Error(r);try{return new RegExp(t,e)}catch(o){let i=o instanceof Error?o.message:String(o);throw new Error(`Invalid regex pattern: ${i}`)}}function Te(t,e,n=1e3){if(e.length>1e5)throw new Error(`Input too large for safe regex test (${e.length} chars, max 100000)`);return t.test(e)}var dt=(i=>(i[i.DEBUG=0]="DEBUG",i[i.INFO=1]="INFO",i[i.WARN=2]="WARN",i[i.ERROR=3]="ERROR",i[i.SILENT=4]="SILENT",i))(dt||{}),g=1;function Ae(t){g=t}function Me(){return g}function p(){return new Date().toISOString()}function Ce(t,e){g<=0&&(e!==void 0?process.stderr.write(`[${p()}] DEBUG: ${t} ${h(e)}
+`):process.stderr.write(`[${p()}] DEBUG: ${t}
+`))}function Se(t,e){g<=1&&(e!==void 0?process.stderr.write(`[${p()}] INFO: ${t} ${h(e)}
+`):process.stderr.write(`[${p()}] INFO: ${t}
+`))}function _e(t,e){g<=2&&(e!==void 0?process.stderr.write(`[${p()}] WARN: ${t} ${h(e)}
+`):process.stderr.write(`[${p()}] WARN: ${t}
+`))}function $e(t,e){g<=3&&(e!==void 0?process.stderr.write(`[${p()}] ERROR: ${t} ${h(e)}
+`):process.stderr.write(`[${p()}] ERROR: ${t}
+`))}function h(t){if(t==null)return"";if(t instanceof Error)return t.message;if(typeof t=="string")return t;try{return JSON.stringify(t)}catch{return String(t)}}var w=class extends Error{statusCode;body;retryAfterMs;requestId;cfRay;constructor(e,n={}){super(e),this.name="ApiTransientError",this.statusCode=n.statusCode,this.retryAfterMs=n.retryAfterMs,this.requestId=n.requestId,this.cfRay=n.cfRay}},x={maxRetries:3,baseDelayMs:1e3,maxDelayMs:3e4,jitterMs:300};function y(t,e){let n=process.env[t],r=n?Number.parseInt(n,10):Number.NaN;return!Number.isFinite(r)||r<0?e:r}function pt(t={}){let e=Math.max(0,t.maxRetries??y("XENO_API_MAX_RETRIES",x.maxRetries)),n=Math.max(50,t.baseDelayMs??y("XENO_API_BASE_DELAY_MS",x.baseDelayMs)),r=Math.max(n,t.maxDelayMs??y("XENO_API_MAX_DELAY_MS",x.maxDelayMs)),o=Math.max(0,t.jitterMs??y("XENO_API_RETRY_JITTER_MS",x.jitterMs));return{maxRetries:e,baseDelayMs:n,maxDelayMs:r,jitterMs:o}}function mt(t,e,n){if(e.retryAfterMs&&e.retryAfterMs>0)return Math.min(e.retryAfterMs,n.maxDelayMs);let r=Math.min(n.baseDelayMs*Math.pow(2,t),n.maxDelayMs),o=Math.floor(Math.random()*n.jitterMs);return Math.min(r+o,n.maxDelayMs)}function B(t){let e=t.toLowerCase();return e.includes("rate limit")||e.includes("too many requests")||e.includes("429")}function gt(t){let e=t.toLowerCase();return e.includes("network")||e.includes("timeout")||e.includes("fetch failed")||e.includes("socket hang up")||e.includes("econnreset")||e.includes("eai_again")||e.includes("enotfound")||e.includes("econnrefused")||e.includes("tls")||e.includes("temporarily unavailable")}function O(t){if(t instanceof w)return{statusCode:t.statusCode,retryAfterMs:t.retryAfterMs,requestId:t.requestId,cfRay:t.cfRay};if(!(t instanceof Error))return{};let e=t;if(e.statusCode!==void 0||e.retryAfterMs!==void 0||e.requestId!==void 0||e.cfRay!==void 0)return{statusCode:e.statusCode,retryAfterMs:e.retryAfterMs,requestId:e.requestId,cfRay:e.cfRay};let n=t.message.toLowerCase();return B(n)?{statusCode:429}:{}}function ht(t){if(t&&typeof t=="object"&&"retryable"in t)return t.retryable===!0;if(t instanceof w){let{statusCode:e}=O(t);if(e)return e===429||e>=500||e===408||e===409||e===425}if(t instanceof Error){let e=t.name?.toLowerCase()??"";return e==="aborterror"||e==="agentinterruptederror"||t.message.toLowerCase().includes("aborted")||t.message.toLowerCase().includes("interrupted")?!1:t.message.includes("503")||t.message.includes("504")||t.message.includes("502")||t.message.includes("500")||t.message.includes("408")||t.message.includes("425")?!0:B(t.message)||gt(t.message.toLowerCase())}return!1}function xt(t){if(t.onAbort)return t.onAbort();let e=new Error("The operation was aborted");return e.name="AbortError",e}async function ve(t,e={}){let n=pt(e),r;for(let o=0;o<=n.maxRetries;o++)try{if(e.signal?.aborted)throw xt(e);return e.onBeforeAttempt?.(o),await t()}catch(i){if(r=i,!(e.shouldRetry?e.shouldRetry(i,o):ht(i))||o===n.maxRetries)throw i;let u=O(i),l=mt(o,u,n),d=e.getDelayMs?.(i,o,l),m=typeof d=="number"&&d>=0?d:l;await new Promise(E=>setTimeout(E,m))}throw r}var yt=(t,e)=>{if(!t)return 0;let n=e.toLowerCase(),r=n.includes("claude")?3.5:n.includes("gemini")?3.8:(/(^|[/_-])(gpt|o\d)/.test(n),4),o=[...t].filter(s=>s.codePointAt(0)>127).length,i=Math.ceil(t.length/r);return Math.max(1,i+Math.ceil(o*.35))},wt=Object.freeze({id:"xeno-conservative-v1",source:"estimated",countText:yt,countImage:({detail:t})=>t==="high"?2e3:t==="low"?512:1200,safetyMarginRatio:t=>{let e=t.toLowerCase();return e.includes("claude")?.12:e.includes("gemini")?.14:/(^|[/_-])(gpt|o\d)/.test(e)?.1:.18}});function Be(t,e,n=wt){return{tokens:Math.max(0,Math.ceil(n.countText(t,e))),source:n.source,adapterId:n.id}}function bt(t){return t?Math.ceil(t.length/4):0}function Oe(t,e){if(!t||e<=0)return"";let n=e*4;if(t.length<=n)return t;let r=t.slice(0,n),o=r.lastIndexOf(" ");return o>n*.8&&(r=r.slice(0,o)),r+"..."}function Pe(t,e){return bt(t)<=e}function Ie(t,e){return Math.max(0,e-t)}var Et={"claude-opus-4-6-thinking":{input:15,output:75},"claude-opus-4-6":{input:15,output:75},"claude-opus-4-5-thinking":{input:15,output:75},"claude-sonnet-4-6":{input:3,output:15},"claude-sonnet-4-5-thinking":{input:3,output:15},"claude-sonnet-4-5":{input:3,output:15},"gemini-2.5-flash":{input:.15,output:.6},"gemini-2.5-flash-lite":{input:.075,output:.3},"gemini-3-flash":{input:.15,output:.6},"gemini-3-pro-high":{input:1.25,output:5},"gpt-5":{input:5,output:15},"gpt-5-codex":{input:5,output:15},"gpt-5.1":{input:5,output:15},"gpt-5.1-codex":{input:5,output:15},"gpt-5.2":{input:5,output:15},"gpt-5.2-codex":{input:5,output:15},"kimi-k2":{input:.6,output:2.4},"kimi-k2-thinking":{input:.6,output:2.4},"kimi-k2.5":{input:.6,output:2.4}};function Fe(t,e,n){let r=Et[t];return r?e/1e6*r.input+n/1e6*r.output:0}function We(t){return t<=0?"$0.00":t<.001?"<$0.001":t<.01?`$${t.toFixed(4)}`:t<1?`$${t.toFixed(3)}`:`$${t.toFixed(2)}`}import{spawnSync as Rt}from"node:child_process";function He(t){let e=process.platform==="win32"?[{command:"clip.exe",args:[]}]:process.platform==="darwin"?[{command:"pbcopy",args:[]}]:[{command:"wl-copy",args:[]},{command:"xclip",args:["-selection","clipboard"]},{command:"xsel",args:["--clipboard","--input"]}],n=null;for(let r of e)try{let o=Rt(r.command,r.args,{input:t,encoding:"utf8"});if(o.error){n=o.error.message;continue}if(o.status===0)return;n=o.stderr||o.stdout||`exit ${o.status}`}catch(o){n=o instanceof Error?o.message:String(o)}throw new Error(`Clipboard copy failed${n?`: ${n}`:""}`)}function I(t){return t.replace(/\\/g,"/").toLowerCase()}var Tt=["golden","solution","answer","expected"],kt=["expected","golden","reference","answer","answers"],At=new Set([";","&&","||","|"]);function D(t){return I(t).replace(/^\.\/+/,"").split("/").map(e=>e.trim()).filter(e=>e.length>0)}function Mt(t){return Tt.some(e=>t.includes(e))}function P(t){return kt.some(e=>t.includes(e))}function F(t){return t.split("::",1)[0]?.split("?",1)[0]?.split("#",1)[0]??t}function b(t){let e=t.trim().replace(/^[({]+/,"").replace(/[),;]+$/,"");return(e.startsWith('"')&&e.endsWith('"')||e.startsWith("'")&&e.endsWith("'"))&&(e=e.slice(1,-1)),e}function Ct(t){return t.match(/"[^"]*"|'[^']*'|&&|\|\||[;|]|[^\s;|&]+/g)?.map(b).filter(e=>e.length>0)??[]}function W(t){let e=D(t),n=F(e.at(-1)??"");return P(n)||e.some(r=>P(r))}function j(t){let e=I(b(t));return!e||e==="/dev/null"||e.startsWith("/tmp/")||e.startsWith("tmp/")||e.startsWith("/var/tmp/")||e.startsWith("var/tmp/")?!1:e.startsWith("/app/")||e.startsWith("./")?!0:!e.startsWith("/")}function St(t){return/[\\/]/.test(t)||/\.[A-Za-z0-9]{1,8}$/.test(t)}function _t(t){let e=Ct(t);for(let n=0;n<e.length;n+=1){let r=e[n]?.toLowerCase();if(r!=="cp"&&r!=="mv"&&r!=="rsync"&&r!=="install")continue;let o=[];for(let s=n+1;s<e.length;s+=1){let u=e[s];if(!u||At.has(u))break;u!=="--"&&(u.startsWith("-")||o.push(u))}if(o.length<2)continue;let i=o.at(-1);if(j(i)){for(let s of o.slice(0,-1))if(St(s)&&W(s))return{sourcePath:s,destinationPath:i,operation:r}}}return null}function $t(t){let e=[/\bcat\s+(?:"([^"]+)"|'([^']+)'|([^\s;&|]+))\s*>\s*(?:"([^"]+)"|'([^']+)'|([^\s;&|]+))/i,/\bdd\b[\s\S]*?\bif=(?:"([^"]+)"|'([^']+)'|([^\s;&|]+))[\s\S]*?\bof=(?:"([^"]+)"|'([^']+)'|([^\s;&|]+))/i];for(let n of e){let r=t.match(n);if(!r)continue;let o=b(r[1]??r[2]??r[3]??""),i=b(r[4]??r[5]??r[6]??"");if(!(!o||!i)&&W(o)&&j(i))return{sourcePath:o,destinationPath:i,operation:n.source.startsWith("\\bdd")?"dd":"redirect"}}return null}function q(){return process.env.XENO_BENCHMARK_MODE?.trim().toLowerCase()==="terminal-bench"}function H(t){let e=D(t);if(e.includes("solution")||e.includes("xeno-audit")||e.includes(".xeno")&&e.includes("audit"))return!0;let n=F(e.at(-1)??"");return e.includes("tests")&&Mt(n)}function Xe(t){return q()?t.filter(e=>!H(e)):t}function ze(t){return`Benchmark safety: access to verifier answer or benchmark trace artifacts is blocked (${t}). Use task inputs and verifier logic, not golden, solution, or agent audit files.`}function Ye(t){return t.split(/[\s"'`;|&]+/).map(e=>e.trim()).filter(e=>e.length>0&&/[\\/]/.test(e)).some(e=>H(e))}function Ge(t){if(!q())return null;let e=_t(t)??$t(t);return e?["[xeno guidance]",`Benchmark safety blocked ${e.operation} from reference-like source ${e.sourcePath} to protected destination ${e.destinationPath}.`,"Do not copy expected, golden, reference, or answer files over task inputs or submission artifacts to make validation pass.","If a previous check polluted an input, restore/regenerate the original source input, then rerun the actual script or program under test."].join(`
+`):null}function Nt(t){return/^data:([^;,]+)[;,]/i.exec(t.trim())?.[1]}function vt(t){let e=[];for(let n of t){if(n.type==="text"){e.push(n.text);continue}if(n.type==="image_url"){e.push(`[image ${Nt(n.image_url.url)??"unknown"}]`);continue}let r=n.text??n.data;if(r&&r.trim().length>0){e.push(r);continue}let o=n.uri??n.mimeType??"resource";e.push(`[resource ${o}]`)}return e.join(`
+
+`).trim()}function J(t){let e=t.trim();return e.length>0?[{type:"text",text:e}]:[]}function Ke(t){return typeof t=="string"?t:vt(t)}function Lt(t){if(t.success)return t.output;let e=[`Error: ${t.error??"Tool execution failed"}`];return t.output.trim().length>0&&e.push(t.output),e.join(`
+`)}function Qe(t){let e=t.assistant_content&&t.assistant_content.length>0?t.assistant_content:typeof t.content=="string"?J(t.content):t.content,n=t.assistant_only_content??[],r=Bt(t),o=[...e,...n,...r?[r]:[]];return o.length>0?o:t.content}function Bt(t){let e=t.operation;if(!e)return null;let n=t.evidence??e.evidence??[],r=n.filter(i=>i.status==="verified").length,o=n.filter(i=>i.status==="failed").length;return{type:"text",text:["[xeno_operation]",`operation_id: ${e.operationId}`,`state: ${e.state}`,`terminal: ${e.terminal?"yes":"no"}`,`completion_policy: ${e.completionPolicy}`,e.taskId?`task_id: ${e.taskId}`:null,e.completionReason?`completion_reason: ${e.completionReason}`:null,`evidence: ${r} verified, ${o} failed`,t.retryable===void 0?null:`retryable: ${t.retryable?"yes":"no"}`,"[/xeno_operation]"].filter(i=>!!i).join(`
+`)}}function Ze(t){return Array.isArray(t)&&t.some(e=>e.type!=="text")}function Ve(t){return typeof t=="string"?J(t):t}function tn(t,e){return{type:"tool_result",tool_use_id:t,content:Lt(e),...e.assistantContent&&e.assistantContent.length>0?{assistant_content:e.assistantContent}:{},...e.assistantOnlyContent&&e.assistantOnlyContent.length>0?{assistant_only_content:e.assistantOnlyContent}:{},is_error:!e.success,...e.operation?{operation:e.operation}:{},...e.evidence&&e.evidence.length>0?{evidence:e.evidence}:{},...e.retryable!==void 0?{retryable:e.retryable}:{}}}function nn(t,e={}){for(let n of t){let r=n.codePointAt(0);if(r===127)return!0;if(!(r>31)&&!(r===9&&e.allowTab===!0)&&!((r===10||r===13)&&e.allowLineBreaks===!0))return!0}return!1}export{w as ApiTransientError,lt as HOME_DIR,fe as IS_LINUX,le as IS_MAC,ct as IS_WINDOWS,dt as LogLevel,de as OS_VERSION,T as PLATFORM,Be as accountTextTokens,Wt as appendLine,ze as benchmarkLeakError,tn as buildToolResultBlock,Lt as buildToolResultText,Fe as calculateCost,Ye as commandMentionsBenchmarkLeak,wt as conservativeTokenAccountingAdapter,He as copyTextToClipboard,Re as createSafeRegex,Ce as debug,G as decodeTextBuffer,Ut as deleteDir,Gt as deleteFile,K as detectLineEnding,qt as detectPreferredLineEnding,Y as detectTextEncoding,U as encodeTextBuffer,C as ensureDir,$e as error,bt as estimateTokens,yt as estimateTokensForModel,Xt as existsSync,Xe as filterBenchmarkLeakPaths,Ht as findSimilarFile,Pe as fitsInBudget,We as formatCost,Ge as getBenchmarkReferenceOverwriteHint,Ee as getBoolean,pe as getConfigDir,Me as getLogLevel,be as getNumber,me as getProjectConfigDir,O as getRetryErrorContext,ge as getShellName,we as getString,Qe as getToolResultTransportContent,Dt as hasDir,nn as hasDisallowedAsciiControlCharacter,It as hasFile,re as hasFrontmatter,Ze as hasNonTextToolResultContent,Se as info,H as isBenchmarkLeakPath,q as isBenchmarkMode,he as isGitRepo,ot as isPathSafe,ht as isRetryableError,Yt as listDirs,zt as listFiles,Q as normalizeLineEndings,ee as parseDocument,Vt as parseJsonLines,Ft as readFileSafe,Jt as readIfExists,Z as readTextFile,Ie as remainingBudget,Qt as safeJsonParse,Zt as safeJsonStringify,Te as safeRegexTest,ie as safeResolvePath,Ae as setLogLevel,ne as stringifyDocument,Ve as toTransportAssistantBlocks,vt as toolAssistantContentToText,Ke as toolResultContentToText,Oe as truncateToTokens,ft as validateRegexPattern,ye as validateRequired,_e as warn,ve as withRetry,z as writeAtomic,jt as writeTextFile};

package/dist/utils/metafile-cjs.json

@@ -0,0 +1 @@
+{"inputs":{"src/utils/fs.ts":{"bytes":10330,"imports":[{"path":"node:fs","kind":"import-statement","external":true},{"path":"node:fs","kind":"import-statement","external":true},{"path":"node:fs/promises","kind":"import-statement","external":true},{"path":"node:path","kind":"import-statement","external":true}],"format":"esm"},"src/utils/json.ts":{"bytes":842,"imports":[],"format":"esm"},"src/utils/yaml.ts":{"bytes":5668,"imports":[],"format":"esm"},"src/utils/path-security.ts":{"bytes":1024,"imports":[{"path":"path","kind":"import-statement","external":true}],"format":"esm"},"src/utils/platform.ts":{"bytes":1012,"imports":[{"path":"node:os","kind":"import-statement","external":true},{"path":"node:child_process","kind":"import-statement","external":true},{"path":"node:path","kind":"import-statement","external":true}],"format":"esm"},"src/utils/validation.ts":{"bytes":5519,"imports":[],"format":"esm"},"src/utils/logger.ts":{"bytes":3873,"imports":[],"format":"esm"},"src/utils/retry.ts":{"bytes":9294,"imports":[],"format":"esm"},"src/utils/tokens.ts":{"bytes":3306,"imports":[],"format":"esm"},"src/utils/cost.ts":{"bytes":1876,"imports":[],"format":"esm"},"src/utils/clipboard.ts":{"bytes":1196,"imports":[{"path":"node:child_process","kind":"import-statement","external":true}],"format":"esm"},"src/utils/benchmark-safety.ts":{"bytes":6703,"imports":[],"format":"esm"},"src/utils/tool-result-content.ts":{"bytes":4887,"imports":[],"format":"esm"},"src/utils/text-security.ts":{"bytes":833,"imports":[],"format":"esm"},"src/utils/index.ts":{"bytes":1490,"imports":[{"path":"src/utils/fs.ts","kind":"import-statement","original":"./fs.js"},{"path":"src/utils/json.ts","kind":"import-statement","original":"./json.js"},{"path":"src/utils/yaml.ts","kind":"import-statement","original":"./yaml.js"},{"path":"src/utils/path-security.ts","kind":"import-statement","original":"./path-security.js"},{"path":"src/utils/platform.ts","kind":"import-statement","original":"./platform.js"},{"path":"src/utils/validation.ts","kind":"import-statement","original":"./validation.js"},{"path":"src/utils/logger.ts","kind":"import-statement","original":"./logger.js"},{"path":"src/utils/retry.ts","kind":"import-statement","original":"./retry.js"},{"path":"src/utils/tokens.ts","kind":"import-statement","original":"./tokens.js"},{"path":"src/utils/cost.ts","kind":"import-statement","original":"./cost.js"},{"path":"src/utils/clipboard.ts","kind":"import-statement","original":"./clipboard.js"},{"path":"src/utils/benchmark-safety.ts","kind":"import-statement","original":"./benchmark-safety.js"},{"path":"src/utils/tool-result-content.ts","kind":"import-statement","original":"./tool-result-content.js"},{"path":"src/utils/text-security.ts","kind":"import-statement","original":"./text-security.js"}],"format":"esm"}},"outputs":{"dist/utils/index.cjs":{"imports":[{"path":"node:fs","kind":"require-call","external":true},{"path":"node:fs","kind":"require-call","external":true},{"path":"node:fs/promises","kind":"require-call","external":true},{"path":"node:path","kind":"require-call","external":true},{"path":"path","kind":"require-call","external":true},{"path":"node:os","kind":"require-call","external":true},{"path":"node:child_process","kind":"require-call","external":true},{"path":"node:path","kind":"require-call","external":true},{"path":"node:child_process","kind":"require-call","external":true}],"exports":[],"entryPoint":"src/utils/index.ts","inputs":{"src/utils/index.ts":{"bytesInOutput":1866},"src/utils/fs.ts":{"bytesInOutput":4051},"src/utils/json.ts":{"bytesInOutput":239},"src/utils/yaml.ts":{"bytesInOutput":2639},"src/utils/path-security.ts":{"bytesInOutput":313},"src/utils/platform.ts":{"bytesInOutput":483},"src/utils/validation.ts":{"bytesInOutput":1423},"src/utils/logger.ts":{"bytesInOutput":913},"src/utils/retry.ts":{"bytesInOutput":2918},"src/utils/tokens.ts":{"bytesInOutput":904},"src/utils/cost.ts":{"bytesInOutput":933},"src/utils/clipboard.ts":{"bytesInOutput":604},"src/utils/benchmark-safety.ts":{"bytesInOutput":3108},"src/utils/tool-result-content.ts":{"bytesInOutput":2072},"src/utils/text-security.ts":{"bytesInOutput":180}},"bytes":24527}}}

package/dist/utils/metafile-esm.json

@@ -0,0 +1 @@
+{"inputs":{"src/utils/fs.ts":{"bytes":10330,"imports":[{"path":"node:fs","kind":"import-statement","external":true},{"path":"node:fs","kind":"import-statement","external":true},{"path":"node:fs/promises","kind":"import-statement","external":true},{"path":"node:path","kind":"import-statement","external":true}],"format":"esm"},"src/utils/json.ts":{"bytes":842,"imports":[],"format":"esm"},"src/utils/yaml.ts":{"bytes":5668,"imports":[],"format":"esm"},"src/utils/path-security.ts":{"bytes":1024,"imports":[{"path":"path","kind":"import-statement","external":true}],"format":"esm"},"src/utils/platform.ts":{"bytes":1012,"imports":[{"path":"node:os","kind":"import-statement","external":true},{"path":"node:child_process","kind":"import-statement","external":true},{"path":"node:path","kind":"import-statement","external":true}],"format":"esm"},"src/utils/validation.ts":{"bytes":5519,"imports":[],"format":"esm"},"src/utils/logger.ts":{"bytes":3873,"imports":[],"format":"esm"},"src/utils/retry.ts":{"bytes":9294,"imports":[],"format":"esm"},"src/utils/tokens.ts":{"bytes":3306,"imports":[],"format":"esm"},"src/utils/cost.ts":{"bytes":1876,"imports":[],"format":"esm"},"src/utils/clipboard.ts":{"bytes":1196,"imports":[{"path":"node:child_process","kind":"import-statement","external":true}],"format":"esm"},"src/utils/benchmark-safety.ts":{"bytes":6703,"imports":[],"format":"esm"},"src/utils/tool-result-content.ts":{"bytes":4887,"imports":[],"format":"esm"},"src/utils/text-security.ts":{"bytes":833,"imports":[],"format":"esm"},"src/utils/index.ts":{"bytes":1490,"imports":[{"path":"src/utils/fs.ts","kind":"import-statement","original":"./fs.js"},{"path":"src/utils/json.ts","kind":"import-statement","original":"./json.js"},{"path":"src/utils/yaml.ts","kind":"import-statement","original":"./yaml.js"},{"path":"src/utils/path-security.ts","kind":"import-statement","original":"./path-security.js"},{"path":"src/utils/platform.ts","kind":"import-statement","original":"./platform.js"},{"path":"src/utils/validation.ts","kind":"import-statement","original":"./validation.js"},{"path":"src/utils/logger.ts","kind":"import-statement","original":"./logger.js"},{"path":"src/utils/retry.ts","kind":"import-statement","original":"./retry.js"},{"path":"src/utils/tokens.ts","kind":"import-statement","original":"./tokens.js"},{"path":"src/utils/cost.ts","kind":"import-statement","original":"./cost.js"},{"path":"src/utils/clipboard.ts","kind":"import-statement","original":"./clipboard.js"},{"path":"src/utils/benchmark-safety.ts","kind":"import-statement","original":"./benchmark-safety.js"},{"path":"src/utils/tool-result-content.ts","kind":"import-statement","original":"./tool-result-content.js"},{"path":"src/utils/text-security.ts","kind":"import-statement","original":"./text-security.js"}],"format":"esm"}},"outputs":{"dist/utils/index.js":{"imports":[{"path":"node:fs","kind":"import-statement","external":true},{"path":"node:fs","kind":"import-statement","external":true},{"path":"node:fs/promises","kind":"import-statement","external":true},{"path":"node:path","kind":"import-statement","external":true},{"path":"path","kind":"import-statement","external":true},{"path":"node:os","kind":"import-statement","external":true},{"path":"node:child_process","kind":"import-statement","external":true},{"path":"node:path","kind":"import-statement","external":true},{"path":"node:child_process","kind":"import-statement","external":true}],"exports":["ApiTransientError","HOME_DIR","IS_LINUX","IS_MAC","IS_WINDOWS","LogLevel","OS_VERSION","PLATFORM","accountTextTokens","appendLine","benchmarkLeakError","buildToolResultBlock","buildToolResultText","calculateCost","commandMentionsBenchmarkLeak","conservativeTokenAccountingAdapter","copyTextToClipboard","createSafeRegex","debug","decodeTextBuffer","deleteDir","deleteFile","detectLineEnding","detectPreferredLineEnding","detectTextEncoding","encodeTextBuffer","ensureDir","error","estimateTokens","estimateTokensForModel","existsSync","filterBenchmarkLeakPaths","findSimilarFile","fitsInBudget","formatCost","getBenchmarkReferenceOverwriteHint","getBoolean","getConfigDir","getLogLevel","getNumber","getProjectConfigDir","getRetryErrorContext","getShellName","getString","getToolResultTransportContent","hasDir","hasDisallowedAsciiControlCharacter","hasFile","hasFrontmatter","hasNonTextToolResultContent","info","isBenchmarkLeakPath","isBenchmarkMode","isGitRepo","isPathSafe","isRetryableError","listDirs","listFiles","normalizeLineEndings","parseDocument","parseJsonLines","readFileSafe","readIfExists","readTextFile","remainingBudget","safeJsonParse","safeJsonStringify","safeRegexTest","safeResolvePath","setLogLevel","stringifyDocument","toTransportAssistantBlocks","toolAssistantContentToText","toolResultContentToText","truncateToTokens","validateRegexPattern","validateRequired","warn","withRetry","writeAtomic","writeTextFile"],"entryPoint":"src/utils/index.ts","inputs":{"src/utils/fs.ts":{"bytesInOutput":3994},"src/utils/index.ts":{"bytesInOutput":0},"src/utils/json.ts":{"bytesInOutput":239},"src/utils/yaml.ts":{"bytesInOutput":2639},"src/utils/path-security.ts":{"bytesInOutput":311},"src/utils/platform.ts":{"bytesInOutput":491},"src/utils/validation.ts":{"bytesInOutput":1425},"src/utils/logger.ts":{"bytesInOutput":915},"src/utils/retry.ts":{"bytesInOutput":2918},"src/utils/tokens.ts":{"bytesInOutput":904},"src/utils/cost.ts":{"bytesInOutput":933},"src/utils/clipboard.ts":{"bytesInOutput":601},"src/utils/benchmark-safety.ts":{"bytesInOutput":3090},"src/utils/tool-result-content.ts":{"bytesInOutput":2069},"src/utils/text-security.ts":{"bytesInOutput":180}},"bytes":22467}}}

package/native/mxc/LICENSE.microsoft-mxc-sdk.md

@@ -0,0 +1,21 @@
+    MIT License
+
+    Copyright (c) Microsoft Corporation.
+
+    Permission is hereby granted, free of charge, to any person obtaining a copy
+    of this software and associated documentation files (the "Software"), to deal
+    in the Software without restriction, including without limitation the rights
+    to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+    copies of the Software, and to permit persons to whom the Software is
+    furnished to do so, subject to the following conditions:
+
+    The above copyright notice and this permission notice shall be included in all
+    copies or substantial portions of the Software.
+
+    THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+    IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+    FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+    AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+    LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+    OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+    SOFTWARE