@askdkc/dsh-cli 0.12.3 → 0.13.0

package/lib/types/migrationPrefs.js

@@ -1,97 +0,0 @@
-/**
- * One-time local migrations (`~/.dsh-tui/migrations.json`), keyed by stable
- * migration id → ISO timestamp. Named keys (not a bare flag) so later
- * migrations can append entries without a format change. Best-effort like
- * every prefs file: a missing/corrupt file reads as "nothing applied yet",
- * and a failed write simply leaves the migration to retry on a later boot.
- */
-import { mkdirSync, readFileSync, writeFileSync } from 'node:fs';
-import { join } from 'node:path';
-import { DATA_DIR } from './utils/paths.js';
-const PREFS_DIR = DATA_DIR;
-const MIGRATIONS_FILE = 'migrations.json';
-/**
- * The fullscreen factory-default flip (schema + `cordis.patch.yml`, 0.9.x):
- * a `fullscreen: false` pinned in the settings user layer BEFORE the flip
- * keeps overriding the new default on every boot. The first boot past this
- * migration clears that stale explicit choice once — see
- * {@link planFullscreenFactoryMigration} for the decision table.
- */
-export const FULLSCREEN_FACTORY_MIGRATION = 'fullscreen-factory-default';
-/**
- * Read the applied-migration map.
- * @param dir - Prefs directory (injectable for tests).
- * @returns Parsed migration map; empty on any read/parse failure.
- */
-export function readAppliedMigrations(dir = PREFS_DIR) {
-    try {
-        const parsed = JSON.parse(readFileSync(join(dir, MIGRATIONS_FILE), 'utf8'));
-        if (parsed === null || typeof parsed !== 'object' || Array.isArray(parsed))
-            return {};
-        return parsed;
-    }
-    catch {
-        return {};
-    }
-}
-/**
- * Record a migration as applied (merge write — other keys are never dropped).
- * @param id - Migration id.
- * @param dir - Prefs directory (injectable for tests).
- * @returns True when the file was written, false on failure.
- */
-export function markMigrationApplied(id, dir = PREFS_DIR) {
-    try {
-        const current = readAppliedMigrations(dir);
-        mkdirSync(dir, { recursive: true });
-        writeFileSync(join(dir, MIGRATIONS_FILE), JSON.stringify({ ...current, [id]: new Date().toISOString() }, null, 2));
-        return true;
-    }
-    catch {
-        return false;
-    }
-}
-/**
- * Decide the migration step from the settings scope's RESOLVED fullscreen
- * value. The dsh-tui namespace declares no schema default and no `base`
- * layer for `fullscreen`, so a resolved `false` can only come from the user
- * layer — the pre-flip explicit choice this migration exists to clear:
- *  - `done`  — marker present: never touch the user layer again, so a
- *     `false` written AFTER the migration (a deliberate /settings choice)
- *     always stands;
- *  - `unset` — stale pre-flip explicit `false`: the caller clears it via a
- *     settings `unset` op and boots fullscreen regardless — the doc write
- *     is async and must not race the synchronous boot decision, so the
- *     caller shadows the stale value out of its first settings apply;
- *  - `mark`  — nothing to clear (unset or already `true`): record the
- *     marker now so a `false` set later is never mistaken for a stale one.
- */
-export function planFullscreenFactoryMigration(resolvedFullscreen, migrations) {
-    if (migrations[FULLSCREEN_FACTORY_MIGRATION] !== undefined)
-        return 'done';
-    return resolvedFullscreen === false ? 'unset' : 'mark';
-}
-/**
- * Persist the plan's side effects. For `unset` the marker lands only after
- * the doc write succeeds — a failed write stays unmarked and the next boot
- * retries (that boot already ran fullscreen off the shadowed value).
- * Never rejects.
- * @param plan - Decision from {@link planFullscreenFactoryMigration}.
- * @param options - `unset` thunk issuing the settings write; `dir` injects
- *   the prefs directory for tests.
- */
-export async function commitFullscreenFactoryMigration(plan, options) {
-    if (plan === 'done')
-        return;
-    if (plan === 'mark') {
-        markMigrationApplied(FULLSCREEN_FACTORY_MIGRATION, options.dir);
-        return;
-    }
-    try {
-        await options.unset();
-        markMigrationApplied(FULLSCREEN_FACTORY_MIGRATION, options.dir);
-    }
-    catch {
-        // Unmarked on purpose: retried next boot.
-    }
-}

package/node_modules/@askdkc/dsh-auth/lib/fresh-models.d.ts

@@ -1,59 +0,0 @@
-/**
- * Fresh OpenCode rosters on top of the installed pi-ai catalog.
- *
- * The installed catalog is the wire authority (per-model `api` protocol,
- * base URLs, compat): overlapping ids are served untouched. The checked-in
- * snapshot (`opencode-snapshot.generated.ts`, refreshed from models.dev plus
- * the live Zen `/v1/models` rosters) contributes only roster ids the
- * installed catalog lacks — each synthesized with per-model protocol
- * resolution, never a route-level default:
- *
- * - models.dev metadata (name, reasoning, modalities, limits, cost) plus the
- *   wire envelope (`api`, `baseUrl`, `compat`, thinking levels, image
- *   budgets) inherited from the nearest same-route catalog sibling;
- * - ids neither source describes are cloned wholesale from that sibling and
- *   keep working wherever the sibling does (provenance lives in the
- *   snapshot, not on the model object).
- *
- * The merge only ever adds: the result always covers the installed catalog,
- * so a stale snapshot delays additions but can never remove working models.
- *
- * @module dsh-auth/fresh-models
- */
-import type { PiAiProvider } from './pi-ai.js';
-/** One allowlisted models.dev entry (see scripts/sync-opencode-models.mjs). */
-export interface FreshModelEntry {
-    readonly id: string;
-    readonly name: string;
-    readonly reasoning?: boolean;
-    readonly attachment?: boolean;
-    readonly modalities: {
-        readonly input: readonly string[];
-    };
-    readonly limit: {
-        readonly context: number;
-        readonly output?: number;
-    };
-    readonly cost: {
-        readonly input: number;
-        readonly output: number;
-        readonly cache_read?: number;
-    };
-    readonly temperature?: boolean;
-    readonly reasoning_options?: {
-        readonly effort: readonly string[];
-    };
-}
-export type FreshRouteId = 'opencode' | 'opencode-go';
-/**
- * Union the snapshot roster onto one catalog provider. Installed models win
- * on conflict and classifier-roster ids stay on pi-ai's classifier path, so
- * the merged list always covers the installed catalog — a stale snapshot
- * delays additions but never removes a working model.
- * @param catalog - the installed pi-ai catalog provider for one route.
- * @param route - the route the snapshot section is keyed under.
- * @returns the catalog provider, or a shallow clone serving the union.
- */
-export declare function withFreshModels(catalog: PiAiProvider, route: FreshRouteId): PiAiProvider;
-/** Snapshot roster ids for one route, for smoke coverage. */
-export declare function freshRosterIds(route: FreshRouteId): readonly string[];

package/node_modules/@askdkc/dsh-auth/lib/fresh-models.js

@@ -1,246 +0,0 @@
-import { OPENCODE_SNAPSHOT } from './opencode-snapshot.generated.js';
-function record(value, what) {
-    if (typeof value !== 'object' || value === null || Array.isArray(value)) {
-        throw new Error(`dsh-auth: snapshot ${what} is not an object`);
-    }
-    return value;
-}
-function nonEmptyString(value) {
-    return typeof value === 'string' && value.length > 0 ? value : undefined;
-}
-function boundedStringList(value, what, max) {
-    if (!Array.isArray(value) || value.length > max || !value.every(item => typeof item === 'string')) {
-        throw new Error(`dsh-auth: snapshot ${what} is not a string list`);
-    }
-    const list = value;
-    if (new Set(list).size !== list.length)
-        throw new Error(`dsh-auth: snapshot ${what} has duplicates`);
-    return list;
-}
-function positiveInt(value) {
-    return typeof value === 'number' && Number.isInteger(value) && value > 0 ? value : undefined;
-}
-function nonnegativeNumber(value) {
-    return typeof value === 'number' && Number.isFinite(value) && value >= 0 ? value : undefined;
-}
-function parseEntry(route, key, value) {
-    const row = record(value, `${route}/${key}`);
-    if (row.id !== key)
-        throw new Error(`dsh-auth: snapshot ${route}/${key} names "${String(row.id)}"`);
-    const name = nonEmptyString(row.name);
-    if (name === undefined)
-        throw new Error(`dsh-auth: snapshot ${route}/${key} has no name`);
-    const modalities = record(row.modalities ?? fail(route, key, 'modalities'), `${route}/${key} modalities`).input;
-    if (!Array.isArray(modalities) || modalities.length === 0 || !modalities.every(m => typeof m === 'string')) {
-        throw new Error(`dsh-auth: snapshot ${route}/${key} has no input modalities`);
-    }
-    const limit = record(row.limit ?? fail(route, key, 'limit'), `${route}/${key} limit`);
-    const context = positiveInt(limit.context);
-    if (context === undefined)
-        throw new Error(`dsh-auth: snapshot ${route}/${key} has no context limit`);
-    const output = limit.output === undefined ? undefined : positiveInt(limit.output);
-    if (limit.output !== undefined && output === undefined) {
-        throw new Error(`dsh-auth: snapshot ${route}/${key} has a malformed output limit`);
-    }
-    const cost = record(row.cost ?? fail(route, key, 'cost'), `${route}/${key} cost`);
-    const input = nonnegativeNumber(cost.input);
-    const outputCost = nonnegativeNumber(cost.output);
-    if (input === undefined || outputCost === undefined) {
-        throw new Error(`dsh-auth: snapshot ${route}/${key} has no pricing`);
-    }
-    const cacheRead = cost.cache_read === undefined ? undefined : nonnegativeNumber(cost.cache_read);
-    if (cost.cache_read !== undefined && cacheRead === undefined) {
-        throw new Error(`dsh-auth: snapshot ${route}/${key} has malformed cache pricing`);
-    }
-    const entry = {
-        id: key,
-        name,
-        reasoning: typeof row.reasoning === 'boolean' ? row.reasoning : undefined,
-        attachment: typeof row.attachment === 'boolean' ? row.attachment : undefined,
-        temperature: typeof row.temperature === 'boolean' ? row.temperature : undefined,
-        reasoning_options: parseEffort(route, key, row.reasoning_options),
-        modalities: { input: modalities.slice() },
-        limit: output === undefined ? { context } : { context, output },
-        cost: cacheRead === undefined ? { input, output: outputCost } : { input, output: outputCost, cache_read: cacheRead },
-    };
-    return entry;
-}
-function parseEffort(route, key, value) {
-    if (value === undefined)
-        return undefined;
-    const options = record(value, `${route}/${key} reasoning options`).effort;
-    if (options === undefined)
-        return undefined;
-    if (!Array.isArray(options) || !options.every(v => typeof v === 'string')) {
-        throw new Error(`dsh-auth: snapshot ${route}/${key} has malformed effort values`);
-    }
-    return { effort: options.slice() };
-}
-function fail(route, key, what) {
-    throw new Error(`dsh-auth: snapshot ${route}/${key} has no ${what}`);
-}
-function parseRoute(route, value) {
-    const row = record(value, route);
-    const roster = boundedStringList(row.roster, `${route} roster`, 500);
-    if (roster.some(id => id.length === 0))
-        throw new Error(`dsh-auth: snapshot ${route} roster has an empty id`);
-    const entriesRaw = record(row.entries ?? {}, `${route} entries`);
-    const entries = {};
-    for (const key of Object.keys(entriesRaw))
-        entries[key] = parseEntry(route, key, entriesRaw[key]);
-    const fallback = boundedStringList(row.fallback ?? [], `${route} fallback`, 500);
-    return { roster, entries, fallback };
-}
-/** Validate the checked-in snapshot once; a malformed file is a boot error. */
-function parseSnapshotData(input) {
-    const root = record(input, 'root');
-    if (root.version !== 1)
-        throw new Error('dsh-auth: snapshot has an unsupported version');
-    if (nonEmptyString(root.generatedAt) === undefined)
-        throw new Error('dsh-auth: snapshot has no timestamp');
-    return {
-        version: 1,
-        generatedAt: root.generatedAt,
-        piAiVersion: nonEmptyString(root.piAiVersion) ?? 'unknown',
-        classifiers: boundedStringList(root.classifiers ?? [], 'classifiers', 500),
-        opencode: parseRoute('opencode', root.opencode),
-        'opencode-go': parseRoute('opencode-go', root['opencode-go']),
-    };
-}
-const SNAPSHOT = parseSnapshotData(OPENCODE_SNAPSHOT);
-/** Length of the id prefix two models share (`a-b` vs `a-c` share 2). */
-function sharedPrefixLength(a, b) {
-    const end = Math.min(a.length, b.length);
-    let length = 0;
-    while (length < end && a[length] === b[length])
-        length += 1;
-    return length;
-}
-/** Wire protocols, most universal first, for deterministic sibling choice. */
-function apiRank(api) {
-    if (api === 'openai-completions')
-        return 0;
-    if (api === 'openai-responses')
-        return 1;
-    if (api === 'anthropic-messages')
-        return 2;
-    if (api === 'google-generative-ai')
-        return 3;
-    return 4;
-}
-/**
- * Nearest same-route catalog sibling: longest shared id prefix wins, then
- * the most universal wire protocol, then alphabetical order. Documented
- * approximation, fully deterministic — the same snapshot and catalog always
- * resolve the same wire envelope.
- */
-function nearestSibling(catalog, id) {
-    let best = catalog[0];
-    if (best === undefined)
-        throw new Error('dsh-auth: installed catalog is empty');
-    for (const candidate of catalog) {
-        const prefix = sharedPrefixLength(candidate.id, id);
-        const bestPrefix = sharedPrefixLength(best.id, id);
-        if (prefix > bestPrefix
-            || (prefix === bestPrefix && apiRank(candidate.api) < apiRank(best.api))
-            || (prefix === bestPrefix && apiRank(candidate.api) === apiRank(best.api) && candidate.id < best.id)) {
-            best = candidate;
-        }
-    }
-    return best;
-}
-/** pi-ai thinking levels; `off` is always unsupported, the rest map to themselves. */
-const THINKING_LEVELS = ['minimal', 'low', 'medium', 'high', 'xhigh', 'max'];
-function thinkingLevels(effort, sibling) {
-    const siblingMap = (sibling.thinkingLevelMap ?? {});
-    const levels = new Set(effort);
-    // Only narrow the sibling envelope when every effort value it names fits
-    // inside it; otherwise the sibling map stands (documented approximation).
-    if (![...levels].every(level => Object.hasOwn(siblingMap, level)))
-        return sibling.thinkingLevelMap;
-    const map = { off: null };
-    for (const level of THINKING_LEVELS) {
-        if (!Object.hasOwn(siblingMap, level))
-            continue;
-        map[level] = levels.has(level) ? level : null;
-    }
-    return map;
-}
-/**
- * Resolve one snapshot roster id to a pi-shaped model: wire envelope from
- * the sibling, display metadata and capacity from models.dev. pi-ai drops
- * video/pdf/audio modalities (text/image only) and never discloses
- * cache-write pricing, so both are inherited or omitted — see field notes.
- */
-function synthesize(catalog, route, id, entry) {
-    const sibling = nearestSibling(catalog, id);
-    // Same-route sibling, so its provider id is already the route's own.
-    if (entry === undefined)
-        return { ...sibling, id, name: id };
-    const modalities = new Set(entry.modalities.input);
-    if (!modalities.has('text')) {
-        throw new Error(`dsh-auth: snapshot ${route}/${id} has no text modality`);
-    }
-    const compat = entry.temperature === false
-        ? { ...sibling.compat, supportsTemperature: false }
-        : sibling.compat;
-    const input = modalities.has('image') ? ['text', 'image'] : ['text'];
-    return {
-        ...sibling,
-        id,
-        name: entry.name,
-        reasoning: entry.reasoning ?? sibling.reasoning,
-        input: [...input],
-        cost: {
-            input: entry.cost.input,
-            output: entry.cost.output,
-            cacheRead: entry.cost.cache_read ?? sibling.cost.cacheRead ?? 0,
-            cacheWrite: sibling.cost.cacheWrite ?? 0,
-        },
-        contextWindow: entry.limit.context,
-        maxTokens: entry.limit.output ?? sibling.maxTokens,
-        compat,
-        thinkingLevelMap: entry.reasoning === false
-            ? undefined
-            : entry.reasoning_options === undefined
-                ? sibling.thinkingLevelMap
-                : thinkingLevels(entry.reasoning_options.effort, sibling),
-        type: 'chat',
-    };
-}
-/**
- * Union the snapshot roster onto one catalog provider. Installed models win
- * on conflict and classifier-roster ids stay on pi-ai's classifier path, so
- * the merged list always covers the installed catalog — a stale snapshot
- * delays additions but never removes a working model.
- * @param catalog - the installed pi-ai catalog provider for one route.
- * @param route - the route the snapshot section is keyed under.
- * @returns the catalog provider, or a shallow clone serving the union.
- */
-export function withFreshModels(catalog, route) {
-    const section = SNAPSHOT[route];
-    const installed = new Map(catalog.getModels().map(model => [model.id, model]));
-    const classifiers = new Set(SNAPSHOT.classifiers);
-    const catalogModels = catalog.getModels();
-    const extras = [];
-    for (const id of section.roster) {
-        if (installed.has(id) || classifiers.has(id))
-            continue;
-        const marker = section.fallback.includes(id);
-        const key = marker ? undefined : section.entries[id];
-        if (!marker && key === undefined) {
-            throw new Error(`dsh-auth: snapshot ${route}/${id} is on the roster but has neither metadata nor a fallback marker`);
-        }
-        extras.push(synthesize(catalogModels, route, id, key));
-    }
-    if (extras.length === 0)
-        return catalog;
-    return {
-        ...catalog,
-        getModels: () => [...catalog.getModels(), ...extras],
-    };
-}
-/** Snapshot roster ids for one route, for smoke coverage. */
-export function freshRosterIds(route) {
-    return SNAPSHOT[route].roster.slice();
-}