longer-agent 0.1.0

package/dist/model-selection.js

@@ -0,0 +1,181 @@
+import { hasOAuthTokens } from "./auth/openai-oauth.js";
+import { formatScopedModelName } from "./config.js";
+import { buildProviderPresetRawConfig, findProviderPreset, findProviderPresetModel, } from "./provider-presets.js";
+function readModelEntries(config) {
+    if (typeof config?.listModelEntries === "function") {
+        try {
+            const entries = config.listModelEntries();
+            if (Array.isArray(entries))
+                return entries;
+        }
+        catch {
+            // Fall through to compatibility mode.
+        }
+    }
+    const out = [];
+    for (const name of config?.modelNames ?? []) {
+        try {
+            const mc = config.getModel(name);
+            out.push({
+                name,
+                provider: String(mc.provider ?? ""),
+                model: String(mc.model ?? ""),
+                apiKeyRaw: String(mc.apiKey ?? ""),
+                hasResolvedApiKey: Boolean(mc.apiKey),
+            });
+        }
+        catch {
+            // Ignore invalid entries.
+        }
+    }
+    return out;
+}
+function hasEnvApiKey(envVar) {
+    if (!envVar)
+        return false;
+    const raw = process.env[envVar];
+    return typeof raw === "string" && raw.trim() !== "";
+}
+function getProviderKeySource(entries, provider) {
+    // Exact provider match in existing config entries.
+    const fromConfig = entries.find((entry) => entry.provider === provider
+        && entry.hasResolvedApiKey
+        && entry.apiKeyRaw.trim() !== "");
+    if (fromConfig)
+        return fromConfig.apiKeyRaw;
+    // Provider-specific env var — no cross-site fallback.
+    const preset = findProviderPreset(provider);
+    if (preset && hasEnvApiKey(preset.envVar))
+        return `\${${preset.envVar}}`;
+    if (provider === "openai-codex") {
+        try {
+            if (hasOAuthTokens())
+                return "oauth:openai-codex";
+        }
+        catch {
+            // Ignore auth lookup failures here.
+        }
+    }
+    return undefined;
+}
+function parseProviderModelTarget(target) {
+    const idx = target.indexOf(":");
+    if (idx <= 0 || idx >= target.length - 1)
+        return null;
+    return {
+        provider: target.slice(0, idx),
+        model: target.slice(idx + 1),
+    };
+}
+function runtimeModelName(provider, model) {
+    const slug = (s) => s
+        .toLowerCase()
+        .replace(/[^a-z0-9]+/g, "-")
+        .replace(/^-+|-+$/g, "");
+    return `runtime-${slug(provider)}-${slug(model)}`;
+}
+export function resolveModelSelection(session, target, apiKey) {
+    const config = session.config;
+    let selectedConfigName = target;
+    const knownNames = new Set(config?.modelNames ?? []);
+    if (knownNames.has(selectedConfigName)) {
+        const existing = config.getModel(selectedConfigName);
+        return {
+            selectedConfigName,
+            selectedHint: formatScopedModelName(existing.provider, existing.model),
+            modelProvider: existing.provider,
+            modelSelectionKey: existing.model,
+            modelId: existing.model,
+        };
+    }
+    const parsed = parseProviderModelTarget(target);
+    if (!parsed) {
+        throw new Error("Invalid model target. Use config name or provider:model (e.g. openai:gpt-5.4).");
+    }
+    const presetModel = findProviderPresetModel(parsed.provider, parsed.model);
+    const resolvedModel = presetModel?.id ?? parsed.model;
+    const selectionKey = presetModel?.key ?? parsed.model;
+    const presetRequiresDedicatedConfig = Boolean(presetModel && (presetModel.key !== presetModel.id
+        || presetModel.optionNote
+        || presetModel.config
+        || (presetModel.aliases && presetModel.aliases.length > 0)));
+    const entries = readModelEntries(config);
+    const exactEntries = entries.filter((entry) => entry.provider === parsed.provider && entry.model === resolvedModel);
+    const exactWithKey = exactEntries.find((entry) => entry.hasResolvedApiKey);
+    if (exactWithKey && !apiKey && !presetRequiresDedicatedConfig) {
+        selectedConfigName = exactWithKey.name;
+    }
+    else {
+        const keySource = (apiKey && apiKey.trim() !== "")
+            ? apiKey
+            : getProviderKeySource(entries, parsed.provider)
+                ?? (session.primaryAgent?.modelConfig?.provider === parsed.provider
+                    && session.primaryAgent?.modelConfig?.apiKey
+                    ? session.primaryAgent.modelConfig.apiKey
+                    : undefined);
+        if (!keySource) {
+            if (parsed.provider === "openai-codex") {
+                throw new Error("Not logged in to OpenAI (ChatGPT).\n" +
+                    "Run 'longeragent oauth' to log in with your ChatGPT account.");
+            }
+            const preset = findProviderPreset(parsed.provider);
+            const envHint = preset
+                ? `\nSet the environment variable:\n\n  export ${preset.envVar}=YOUR_API_KEY\n`
+                : "";
+            throw new Error(`Missing API key for provider '${parsed.provider}'${preset ? ` (${preset.name})` : ""}.` +
+                envHint +
+                `\nOr run 'longeragent init' to configure.` +
+                `\nTip: /model ${parsed.provider}:${parsed.model} key=YOUR_API_KEY (current session only)`);
+        }
+        if (typeof config?.upsertModelRaw !== "function") {
+            throw new Error("Runtime model creation is not supported by this config object.");
+        }
+        const runtimeName = runtimeModelName(parsed.provider, selectionKey);
+        config.upsertModelRaw(runtimeName, presetModel
+            ? buildProviderPresetRawConfig(parsed.provider, presetModel, keySource)
+            : {
+                provider: parsed.provider,
+                model: resolvedModel,
+                api_key: keySource,
+            });
+        selectedConfigName = runtimeName;
+    }
+    return {
+        selectedConfigName,
+        selectedHint: formatScopedModelName(parsed.provider, resolvedModel),
+        modelProvider: parsed.provider,
+        modelSelectionKey: selectionKey,
+        modelId: resolvedModel,
+    };
+}
+export function resolvePersistedModelSelection(session, selection) {
+    const configName = selection.modelConfigName?.trim();
+    let configResolutionError;
+    if (configName) {
+        try {
+            const existing = session.config.getModel(configName);
+            return {
+                selectedConfigName: configName,
+                selectedHint: formatScopedModelName(existing.provider, existing.model),
+                modelProvider: existing.provider,
+                modelSelectionKey: selection.modelSelectionKey?.trim() || existing.model,
+                modelId: existing.model,
+            };
+        }
+        catch (err) {
+            configResolutionError = err;
+        }
+    }
+    const provider = selection.modelProvider?.trim();
+    const selectionKey = selection.modelSelectionKey?.trim() || selection.modelId?.trim();
+    if (provider && selectionKey) {
+        return resolveModelSelection(session, `${provider}:${selectionKey}`);
+    }
+    if (configResolutionError) {
+        throw configResolutionError instanceof Error
+            ? configResolutionError
+            : new Error(String(configResolutionError));
+    }
+    throw new Error("Saved session is missing persisted model identity.");
+}
+//# sourceMappingURL=model-selection.js.map

package/dist/model-selection.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"model-selection.js","sourceRoot":"","sources":["../src/model-selection.ts"],"names":[],"mappings":"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"}

package/dist/network-retry.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Network error retry utilities.
+ *
+ * Provides detection of transient network errors, exponential backoff
+ * delay computation, and an abort-aware sleep helper.  Used by the
+ * session turn loop to automatically retry LLM API calls that fail
+ * due to network issues (ETIMEDOUT, ECONNRESET, 5xx, 429, etc.).
+ */
+/** Maximum number of network-error retries per turn. */
+export declare const MAX_NETWORK_RETRIES = 10;
+/**
+ * Determine whether `err` is a transient network error worth retrying.
+ *
+ * Handles three layers of errors:
+ * 1. SDK-wrapped errors (Anthropic / OpenAI `APIConnectionError`)
+ * 2. Raw Node.js errors with `.code` (ETIMEDOUT, ECONNRESET, …)
+ * 3. HTTP status codes (429 rate-limit, 5xx server errors)
+ *
+ * Uses duck-typing (constructor name) instead of `instanceof` to avoid
+ * importing both SDK packages.
+ */
+export declare function isRetryableNetworkError(err: unknown): boolean;
+/**
+ * Compute the backoff delay for a given retry attempt (0-indexed).
+ *
+ * Uses exponential backoff (base 1 s, factor 2) capped at 30 s,
+ * with 0–25 % random jitter to avoid thundering-herd effects.
+ *
+ * Progression: ~1 s, ~2 s, ~4 s, ~8 s, ~16 s, ~30 s, ~30 s, …
+ */
+export declare function computeRetryDelay(attempt: number): number;
+/**
+ * Sleep for `ms` milliseconds, aborting immediately if `signal` fires.
+ *
+ * If the signal is already aborted when called, rejects immediately.
+ */
+export declare function retrySleep(ms: number, signal?: AbortSignal): Promise<void>;
+//# sourceMappingURL=network-retry.d.ts.map

package/dist/network-retry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"network-retry.d.ts","sourceRoot":"","sources":["../src/network-retry.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAMH,wDAAwD;AACxD,eAAO,MAAM,mBAAmB,KAAK,CAAC;AAuCtC;;;;;;;;;;GAUG;AACH,wBAAgB,uBAAuB,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO,CAyC7D;AAMD;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAIzD;AAMD;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAgB1E"}

package/dist/network-retry.js

@@ -0,0 +1,140 @@
+/**
+ * Network error retry utilities.
+ *
+ * Provides detection of transient network errors, exponential backoff
+ * delay computation, and an abort-aware sleep helper.  Used by the
+ * session turn loop to automatically retry LLM API calls that fail
+ * due to network issues (ETIMEDOUT, ECONNRESET, 5xx, 429, etc.).
+ */
+// ------------------------------------------------------------------
+// Constants
+// ------------------------------------------------------------------
+/** Maximum number of network-error retries per turn. */
+export const MAX_NETWORK_RETRIES = 10;
+/** Node.js / undici error codes that indicate a transient network issue. */
+const RETRYABLE_CODES = new Set([
+    "ETIMEDOUT",
+    "ECONNRESET",
+    "ECONNREFUSED",
+    "ECONNABORTED",
+    "ENETUNREACH",
+    "EHOSTUNREACH",
+    "EPIPE",
+    "EAI_AGAIN",
+    "UND_ERR_SOCKET",
+    "UND_ERR_CONNECT_TIMEOUT",
+    "ERR_STREAM_PREMATURE_CLOSE",
+]);
+/** SDK wrapper class names that indicate a connection-level failure. */
+const CONNECTION_ERROR_NAMES = new Set([
+    "APIConnectionError",
+    "APIConnectionTimeoutError",
+]);
+/** Message substrings (lowercase) that suggest a transient network failure. */
+const RETRYABLE_MESSAGE_PATTERNS = [
+    "etimedout",
+    "econnreset",
+    "econnrefused",
+    "socket hang up",
+    "fetch failed",
+    "network",
+    "premature close",
+    "uND_ERR_SOCKET".toLowerCase(),
+];
+// ------------------------------------------------------------------
+// isRetryableNetworkError
+// ------------------------------------------------------------------
+/**
+ * Determine whether `err` is a transient network error worth retrying.
+ *
+ * Handles three layers of errors:
+ * 1. SDK-wrapped errors (Anthropic / OpenAI `APIConnectionError`)
+ * 2. Raw Node.js errors with `.code` (ETIMEDOUT, ECONNRESET, …)
+ * 3. HTTP status codes (429 rate-limit, 5xx server errors)
+ *
+ * Uses duck-typing (constructor name) instead of `instanceof` to avoid
+ * importing both SDK packages.
+ */
+export function isRetryableNetworkError(err) {
+    if (!err || typeof err !== "object")
+        return false;
+    const e = err;
+    // -- Explicit exclusions --
+    if (e["name"] === "AbortError")
+        return false;
+    const status = e["status"];
+    if (typeof status === "number" && status >= 400 && status < 500 && status !== 408 && status !== 429) {
+        return false; // 400, 401, 403, 404, 422 etc. are not retryable
+    }
+    // -- SDK connection errors (duck-typed) --
+    const ctorName = err?.constructor?.name;
+    if (ctorName && CONNECTION_ERROR_NAMES.has(ctorName))
+        return true;
+    // -- Node.js / undici error codes --
+    const code = e["code"];
+    if (typeof code === "string" && RETRYABLE_CODES.has(code))
+        return true;
+    // -- HTTP status-based retries --
+    if (typeof status === "number") {
+        if (status === 408 || status === 429)
+            return true;
+        if (status >= 500)
+            return true;
+    }
+    // -- Message-based fallback --
+    const msg = String(err).toLowerCase();
+    for (const pattern of RETRYABLE_MESSAGE_PATTERNS) {
+        if (msg.includes(pattern))
+            return true;
+    }
+    // Also check .cause for wrapped errors
+    const cause = e["cause"];
+    if (cause && typeof cause === "object") {
+        const causeCode = cause["code"];
+        if (typeof causeCode === "string" && RETRYABLE_CODES.has(causeCode))
+            return true;
+    }
+    return false;
+}
+// ------------------------------------------------------------------
+// computeRetryDelay
+// ------------------------------------------------------------------
+/**
+ * Compute the backoff delay for a given retry attempt (0-indexed).
+ *
+ * Uses exponential backoff (base 1 s, factor 2) capped at 30 s,
+ * with 0–25 % random jitter to avoid thundering-herd effects.
+ *
+ * Progression: ~1 s, ~2 s, ~4 s, ~8 s, ~16 s, ~30 s, ~30 s, …
+ */
+export function computeRetryDelay(attempt) {
+    const baseDelay = Math.min(1000 * Math.pow(2, attempt), 30_000);
+    const jitter = baseDelay * 0.25 * Math.random();
+    return Math.round(baseDelay + jitter);
+}
+// ------------------------------------------------------------------
+// retrySleep
+// ------------------------------------------------------------------
+/**
+ * Sleep for `ms` milliseconds, aborting immediately if `signal` fires.
+ *
+ * If the signal is already aborted when called, rejects immediately.
+ */
+export function retrySleep(ms, signal) {
+    return new Promise((resolve, reject) => {
+        if (signal?.aborted) {
+            reject(new DOMException("The operation was aborted.", "AbortError"));
+            return;
+        }
+        const timer = setTimeout(() => {
+            signal?.removeEventListener("abort", onAbort);
+            resolve();
+        }, ms);
+        const onAbort = () => {
+            clearTimeout(timer);
+            reject(new DOMException("The operation was aborted.", "AbortError"));
+        };
+        signal?.addEventListener("abort", onAbort, { once: true });
+    });
+}
+//# sourceMappingURL=network-retry.js.map

package/dist/network-retry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"network-retry.js","sourceRoot":"","sources":["../src/network-retry.ts"],"names":[],"mappings":"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"}

package/dist/persistence.d.ts

@@ -0,0 +1,104 @@
+/**
+ * Session persistence — log-native session storage on disk.
+ *
+ * Storage layout:
+ *
+ *   <base_dir>/
+ *   └── projects/
+ *       ├── <project_slug>/           # <dir_name>_<sha256[:6]>
+ *       │   ├── project.json
+ *       │   ├── 20260212_143052_chat/
+ *       │   │   ├── log.json
+ *       │   │   └── artifacts/
+ *       │   └── ...
+ *       └── general/                  # sessions without a project path
+ */
+import { LogIdAllocator, type LogEntry } from "./log-entry.js";
+export declare class SessionStore {
+    private _projectPath;
+    private _projectSlug;
+    private _preferredBaseDir;
+    private _activeBaseDir;
+    private _projectDir;
+    private _sessionDir;
+    constructor(opts?: {
+        projectPath?: string;
+        baseDir?: string;
+    });
+    private _candidateBaseDirs;
+    private _ensureProjectMetadata;
+    private _globalPreferenceBaseDirs;
+    private _globalPreferencesPath;
+    private static _createUniqueSessionDir;
+    createSession(): string;
+    /** Clear the current session directory (used by /new to defer creation). */
+    clearSession(): void;
+    loadGlobalPreferences(): GlobalTuiPreferences;
+    saveGlobalPreferences(preferences: GlobalTuiPreferences): void;
+    listSessions(): Array<{
+        path: string;
+        created: string;
+        summary: string;
+        turns: number;
+    }>;
+    get projectDir(): string;
+    get artifactsDir(): string | undefined;
+    get sessionDir(): string | undefined;
+    set sessionDir(value: string);
+}
+export interface LogSessionMeta {
+    version: number;
+    sessionId: string;
+    createdAt: string;
+    updatedAt: string;
+    projectPath: string;
+    modelConfigName: string;
+    modelProvider?: string;
+    modelSelectionKey?: string;
+    modelId?: string;
+    summary: string;
+    turnCount: number;
+    compactCount: number;
+    thinkingLevel: string;
+    cacheHitEnabled: boolean;
+    activePlanFile?: string;
+}
+export interface GlobalTuiPreferences {
+    version: number;
+    modelConfigName?: string;
+    modelProvider?: string;
+    modelSelectionKey?: string;
+    modelId?: string;
+    thinkingLevel: string;
+    cacheHitEnabled: boolean;
+    accentColor?: string;
+    disabledSkills?: string[];
+}
+export declare function createGlobalTuiPreferences(partial?: Partial<GlobalTuiPreferences>): GlobalTuiPreferences;
+export declare function createLogSessionMeta(partial?: Partial<LogSessionMeta>): LogSessionMeta;
+export declare function saveLog(dir: string, meta: LogSessionMeta, entries: LogEntry[]): void;
+export interface LoadLogResult {
+    meta: LogSessionMeta;
+    entries: LogEntry[];
+    idAllocator: LogIdAllocator;
+}
+export declare function loadLog(dir: string): LoadLogResult;
+export interface LogRepairResult {
+    entries: LogEntry[];
+    repaired: boolean;
+    warnings: string[];
+}
+export declare function validateAndRepairLog(entries: LogEntry[]): LogRepairResult;
+export declare function archiveWindow(dir: string, windowIndex: number, entries: LogEntry[], windowStartIdx: number, windowEndIdx: number): void;
+export declare function loadArchive(dir: string, windowIndex: number): Array<{
+    id: string;
+    content: unknown;
+}>;
+/**
+ * Restore archived content back into entries (in-memory only).
+ */
+export declare function restoreArchiveToEntries(entries: LogEntry[], archived: Array<{
+    id: string;
+    content: unknown;
+}>): void;
+//# sourceMappingURL=persistence.d.ts.map

package/dist/persistence.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"persistence.d.ts","sourceRoot":"","sources":["../src/persistence.ts"],"names":[],"mappings":"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"}