@duetso/agent 0.1.33 → 0.1.35

package/dist/src/cli/run.js

@@ -0,0 +1,273 @@
+import { createInterface } from "node:readline/promises";
+import { shimDuetApiKeyToAiGateway } from "../model-resolution/duet-gateway.js";
+import { maybeAutoSyncDefaultSkills } from "../lib/sync-skills.js";
+import { describeModelResolution, resolveCliMemoryModel, resolveCliModel, } from "../model-resolution/resolver.js";
+import { SessionManager } from "../session/session-manager.js";
+import { runTui } from "../tui/app.js";
+import { DEFAULT_RESUME_HISTORY_LINES, printRunHelp } from "./help.js";
+import { resumeCommand } from "./resume-hint.js";
+import { fail, isInteractive, loadCliEnvFiles, parseResumeHistoryLines } from "./shared.js";
+import { getNewVersionNotice } from "./version-check.js";
+/**
+ * Decide whether to render the interactive TUI vs JSONL events.
+ *
+ * Supplying a prompt argument selects JSONL so one-shot runs have a stable
+ * machine-readable contract by default; an explicit `--json` always wins.
+ */
+export function shouldUseTui(input) {
+    return input.interactive && !input.jsonOutput && !input.prompt;
+}
+/**
+ * Build the {@link TurnRunnerConfig} the CLI hands to the SessionManager,
+ * along with the resolutions used to render model provenance lines.
+ */
+export function buildCliTurnConfig(input, dotenvKeys) {
+    const modelResolution = resolveCliModel(input.modelName, dotenvKeys);
+    const memoryModelResolution = resolveCliMemoryModel(input.memoryModelName, dotenvKeys);
+    return {
+        config: {
+            model: modelResolution.modelName,
+            memoryModel: memoryModelResolution.modelName,
+            ...(input.disableDurableMemory ? { memoryDbPath: false } : {}),
+            cwd: input.workDir,
+            ...(input.systemInstructions ? { systemInstructions: input.systemInstructions } : {}),
+            ...(input.systemPromptFiles ? { systemPromptFiles: input.systemPromptFiles } : {}),
+        },
+        modelResolution,
+        memoryModelResolution,
+    };
+}
+/**
+ * Default `duet` invocation: parse flags, load env files, build the config,
+ * decide TUI vs JSON output, then drive the SessionManager through one
+ * session. Prints a resume hint at the end whether the session terminated
+ * cleanly or not.
+ */
+export async function runRunCommand(args, pkg) {
+    let modelName;
+    let memoryModelName;
+    let workDir = process.cwd();
+    let resumeSessionId;
+    let systemInstructions;
+    let systemPromptFiles;
+    let resumeHistoryLines = DEFAULT_RESUME_HISTORY_LINES;
+    let resumeHistoryLinesExplicit = false;
+    let jsonOutput = false;
+    let envFilePath;
+    let disableDurableMemory = false;
+    const promptParts = [];
+    const interactive = isInteractive();
+    for (let i = 0; i < args.length; i++) {
+        switch (args[i]) {
+            case "--model":
+            case "-m":
+                if (!args[i + 1] || args[i + 1]?.startsWith("-"))
+                    fail(`Missing value for ${args[i]}`);
+                modelName = args[++i];
+                break;
+            case "--memory-model":
+                if (!args[i + 1] || args[i + 1]?.startsWith("-"))
+                    fail(`Missing value for ${args[i]}`);
+                memoryModelName = args[++i];
+                break;
+            case "--no-memory":
+                disableDurableMemory = true;
+                break;
+            case "--workdir":
+            case "-w":
+                if (!args[i + 1] || args[i + 1]?.startsWith("-"))
+                    fail(`Missing value for ${args[i]}`);
+                workDir = args[++i];
+                break;
+            case "--resume":
+            case "-r":
+                if (!args[i + 1] || args[i + 1]?.startsWith("-"))
+                    fail(`Missing value for ${args[i]}`);
+                resumeSessionId = args[++i];
+                break;
+            case "--resume-history-lines":
+                if (!args[i + 1] || args[i + 1]?.startsWith("-"))
+                    fail(`Missing value for ${args[i]}`);
+                try {
+                    resumeHistoryLines = parseResumeHistoryLines(args[++i], args[i - 1]);
+                }
+                catch (error) {
+                    fail(error instanceof Error ? error.message : String(error));
+                }
+                resumeHistoryLinesExplicit = true;
+                break;
+            case "--system-prompt":
+                if (!args[i + 1] || args[i + 1]?.startsWith("-"))
+                    fail(`Missing value for ${args[i]}`);
+                systemInstructions = args[++i];
+                break;
+            case "--system-prompt-file":
+                if (!args[i + 1] || args[i + 1]?.startsWith("-"))
+                    fail(`Missing value for ${args[i]}`);
+                systemPromptFiles = [...(systemPromptFiles ?? []), args[++i]];
+                break;
+            case "--no-system-prompt-files":
+                systemPromptFiles = [];
+                break;
+            case "--json":
+                jsonOutput = true;
+                break;
+            case "--env-file":
+                if (!args[i + 1] || args[i + 1]?.startsWith("-"))
+                    fail(`Missing value for ${args[i]}`);
+                envFilePath = args[++i];
+                break;
+            case "--version":
+            case "-v":
+                console.log(pkg.version);
+                process.exit(0);
+            // eslint-disable-next-line no-fallthrough
+            case "--help":
+            case "-h":
+                printRunHelp(pkg.name);
+                process.exit(0);
+            // eslint-disable-next-line no-fallthrough
+            default:
+                if (args[i]?.startsWith("-")) {
+                    fail(`Unknown option: ${args[i]}`);
+                }
+                promptParts.push(args[i]);
+        }
+    }
+    let prompt = promptParts.join(" ");
+    // Read from stdin if no prompt is provided
+    if (!prompt && !interactive) {
+        const chunks = [];
+        for await (const chunk of process.stdin) {
+            chunks.push(chunk);
+        }
+        prompt = Buffer.concat(chunks).toString("utf-8").trim();
+    }
+    if (!prompt && jsonOutput && interactive) {
+        prompt = await readInteractivePrompt();
+    }
+    if (!prompt && !resumeSessionId && !interactive) {
+        console.error("Usage: duet <prompt>");
+        console.error('  e.g., duet "build a todo app"');
+        process.exit(1);
+    }
+    const dotenvKeys = loadCliEnvFiles(workDir, envFilePath);
+    shimDuetApiKeyToAiGateway();
+    // Refresh the gateway-managed default skills when the user has previously
+    // opted in via `duet login` (i.e. `~/.duet/.skills-hash` exists). Logging
+    // in with --skip-skill-sync leaves no hash, so this stays a no-op until
+    // the user explicitly syncs at least once. The conditional GET hits 304
+    // in steady state, so the cost is one cheap round-trip.
+    if (process.env.DUET_API_KEY) {
+        await maybeAutoSyncDefaultSkills({ apiKey: process.env.DUET_API_KEY });
+    }
+    const { config, modelResolution, memoryModelResolution } = buildCliTurnConfig({
+        ...(modelName ? { modelName } : {}),
+        ...(memoryModelName ? { memoryModelName } : {}),
+        disableDurableMemory,
+        workDir,
+        ...(systemInstructions ? { systemInstructions } : {}),
+        ...(systemPromptFiles ? { systemPromptFiles } : {}),
+    }, dotenvKeys);
+    modelName = modelResolution.modelName;
+    memoryModelName = memoryModelResolution.modelName;
+    const useTui = shouldUseTui({ interactive, jsonOutput, prompt });
+    const useJson = !useTui;
+    const newVersionNotice = await getNewVersionNotice(pkg.name, pkg.version);
+    if (useJson) {
+        if (newVersionNotice)
+            process.stderr.write(`${newVersionNotice}\n`);
+        process.stderr.write(`Model: ${modelName}\n`);
+        process.stderr.write(`Source: ${describeModelResolution(modelResolution)}\n`);
+        process.stderr.write(`Memory model: ${memoryModelName}\n`);
+        process.stderr.write(`Memory source: ${describeModelResolution(memoryModelResolution)}\n`);
+    }
+    const manager = new SessionManager(config);
+    manager.subscribe(({ event }) => {
+        if (useJson) {
+            process.stdout.write(`${JSON.stringify(event)}\n`);
+        }
+    });
+    try {
+        const session = resumeSessionId
+            ? manager.resume(resumeSessionId)
+            : manager.create({
+                ...(config.mode ? { mode: config.mode } : {}),
+                ...(useTui || !prompt ? {} : { prompt }),
+            });
+        let resumedHistory;
+        if (resumeSessionId) {
+            // Force-load the persisted state.json so setup hands the resumed
+            // state to the runner and any TUI history replays before new turns.
+            await session.hydrate();
+            if (!session.getState()) {
+                throw new Error(`Unknown session: ${resumeSessionId}`);
+            }
+            // Setup runs against the hydrated state; manager.create() already
+            // dispatched setup for fresh sessions.
+            await session.start();
+            resumedHistory = session.getState()?.agent.messages;
+        }
+        if (prompt && resumeSessionId) {
+            await session.prompt({ message: prompt });
+            await session.waitForTerminal();
+        }
+        else if (prompt && !resumeSessionId) {
+            await session.waitForTerminal();
+        }
+        if (useTui) {
+            await runTui({
+                session,
+                ...(resumedHistory ? { history: resumedHistory } : {}),
+                resumeHistoryLines,
+                modelName,
+                modelSource: describeModelResolution(modelResolution),
+                memoryModelName,
+                memoryModelSource: describeModelResolution(memoryModelResolution),
+                workDir,
+                sessionId: session.id,
+                packageVersion: pkg.version,
+                ...(newVersionNotice ? { newVersionNotice } : {}),
+            });
+        }
+        process.stderr.write(`To resume this session:\n${resumeCommand(session.id, {
+            ...(modelName ? { modelName } : {}),
+            ...(memoryModelName ? { memoryModelName } : {}),
+            workDir,
+            disableDurableMemory,
+            ...(systemInstructions ? { systemInstructions } : {}),
+            ...(systemPromptFiles ? { systemPromptFiles } : {}),
+            ...(envFilePath ? { envFilePath } : {}),
+            ...(resumeHistoryLinesExplicit ? { resumeHistoryLines } : {}),
+        })}\n`);
+    }
+    catch (err) {
+        console.error(`Fatal: ${err.message}`);
+        process.exitCode = 1;
+    }
+    finally {
+        await manager.dispose();
+    }
+}
+/**
+ * Read a single prompt from stdin when --json is set in an interactive
+ * terminal and no prompt was supplied via argv. Loops until the user
+ * provides non-empty input.
+ */
+async function readInteractivePrompt() {
+    const rl = createInterface({
+        input: process.stdin,
+        output: process.stderr,
+    });
+    try {
+        let prompt = "";
+        while (!prompt) {
+            prompt = (await rl.question("> ")).trim();
+        }
+        return prompt;
+    }
+    finally {
+        rl.close();
+    }
+}
+//# sourceMappingURL=run.js.map

package/dist/src/cli/run.js.map

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

package/dist/src/cli/shared.d.ts

@@ -0,0 +1,55 @@
+/** Default location of the shared duet env file shown in CLI help text. */
+export declare const DEFAULT_DUET_ENV_FILE = "~/.duet/.env";
+/**
+ * Provider API keys recognized by `duet env --keys`. Order is the order
+ * we prompt the user; first match wins for inferred-default model resolution.
+ */
+export declare const SUPPORTED_API_KEYS: readonly ["DUET_API_KEY", "ANTHROPIC_API_KEY", "AI_GATEWAY_API_KEY", "OPENROUTER_API_KEY", "OPENAI_API_KEY"];
+/**
+ * Print a fatal error and exit with code 1. Used by every CLI subcommand for
+ * unrecoverable user-input errors so the message format stays consistent.
+ */
+export declare function fail(message: string): never;
+/**
+ * Resolve a path that may use `~` for the home directory and may be relative
+ * to a base directory other than the cwd. Used everywhere the CLI accepts a
+ * filesystem path argument (env files, system-prompt files, workdir).
+ */
+export declare function resolveUserPath(path: string, baseDir?: string): string;
+/** Resolved absolute path of the shared duet env file. */
+export declare function defaultDuetEnvFilePath(): string;
+/**
+ * Ordered list of env files the CLI loads on startup. The cwd-local `.env`
+ * is loaded first so workspace-specific overrides win; the shared duet env
+ * file fills in the user-global defaults.
+ */
+export declare function cliEnvFilePaths(workDir: string, envFilePath?: string): string[];
+/**
+ * Load the env files from {@link cliEnvFilePaths} into `process.env` and
+ * return the set of keys that came from those files. The returned set lets
+ * model resolution distinguish keys we loaded from keys the user already
+ * exported in their shell.
+ */
+export declare function loadCliEnvFiles(workDir: string, envFilePath?: string): Set<string>;
+/** Reject negative or non-numeric values for `--resume-history-lines`. */
+export declare function parseResumeHistoryLines(value: string, optionName?: string): number;
+/** True when stdin or stdout is a TTY (heuristic for interactive sessions). */
+export declare function isInteractive(): boolean;
+/** True when an existing path resolves to a regular file. */
+export declare function fileExists(path: string): Promise<boolean>;
+/**
+ * Merge the given key/value pairs into the env file at `target`, creating
+ * the directory tree if needed and preserving any keys that are not being
+ * updated. Values are quoted only when needed so the file remains diffable.
+ */
+export declare function mergeEnvEntries(target: string, entries: Map<string, string>): Promise<void>;
+/** Serialize a key/value map as the text payload of a dotenv file. */
+export declare function formatEnvEntries(entries: Map<string, string>): string;
+/**
+ * Quote a string so it round-trips through a POSIX shell. Used to render
+ * resume hints and dry-run upgrade commands the user can copy verbatim.
+ */
+export declare function shellQuote(value: string): string;
+/** Strip a leading `v` from a semver-ish string and return the bare numbers. */
+export declare function normalizePackageVersion(version: string): string;
+//# sourceMappingURL=shared.d.ts.map

package/dist/src/cli/shared.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shared.d.ts","sourceRoot":"","sources":["../../../src/cli/shared.ts"],"names":[],"mappings":"AAKA,2EAA2E;AAC3E,eAAO,MAAM,qBAAqB,iBAAiB,CAAC;AAEpD;;;GAGG;AACH,eAAO,MAAM,kBAAkB,8GAMrB,CAAC;AAEX;;;GAGG;AACH,wBAAgB,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,KAAK,CAG3C;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,SAAgB,GAAG,MAAM,CAI7E;AAED,0DAA0D;AAC1D,wBAAgB,sBAAsB,IAAI,MAAM,CAE/C;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAK/E;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,GAAG,CAAC,MAAM,CAAC,CASlF;AAED,0EAA0E;AAC1E,wBAAgB,uBAAuB,CACrC,KAAK,EAAE,MAAM,EACb,UAAU,SAA2B,GACpC,MAAM,CAKR;AAED,+EAA+E;AAC/E,wBAAgB,aAAa,IAAI,OAAO,CAEvC;AAED,6DAA6D;AAC7D,wBAAsB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAM/D;AAED;;;;GAIG;AACH,wBAAsB,eAAe,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAQjG;AAED,sEAAsE;AACtE,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,MAAM,CAErE;AAOD;;;GAGG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAGhD;AAED,gFAAgF;AAChF,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAE/D"}

package/dist/src/cli/shared.js

@@ -0,0 +1,125 @@
+import { mkdir, readFile, stat, writeFile } from "node:fs/promises";
+import { homedir } from "node:os";
+import { dirname, isAbsolute, join, resolve } from "node:path";
+import dotenv from "dotenv";
+/** Default location of the shared duet env file shown in CLI help text. */
+export const DEFAULT_DUET_ENV_FILE = "~/.duet/.env";
+/**
+ * Provider API keys recognized by `duet env --keys`. Order is the order
+ * we prompt the user; first match wins for inferred-default model resolution.
+ */
+export const SUPPORTED_API_KEYS = [
+    "DUET_API_KEY",
+    "ANTHROPIC_API_KEY",
+    "AI_GATEWAY_API_KEY",
+    "OPENROUTER_API_KEY",
+    "OPENAI_API_KEY",
+];
+/**
+ * Print a fatal error and exit with code 1. Used by every CLI subcommand for
+ * unrecoverable user-input errors so the message format stays consistent.
+ */
+export function fail(message) {
+    console.error(`Fatal: ${message}`);
+    process.exit(1);
+}
+/**
+ * Resolve a path that may use `~` for the home directory and may be relative
+ * to a base directory other than the cwd. Used everywhere the CLI accepts a
+ * filesystem path argument (env files, system-prompt files, workdir).
+ */
+export function resolveUserPath(path, baseDir = process.cwd()) {
+    if (path === "~")
+        return homedir();
+    if (path.startsWith("~/"))
+        return join(homedir(), path.slice(2));
+    return isAbsolute(path) ? path : resolve(baseDir, path);
+}
+/** Resolved absolute path of the shared duet env file. */
+export function defaultDuetEnvFilePath() {
+    return resolveUserPath(DEFAULT_DUET_ENV_FILE);
+}
+/**
+ * Ordered list of env files the CLI loads on startup. The cwd-local `.env`
+ * is loaded first so workspace-specific overrides win; the shared duet env
+ * file fills in the user-global defaults.
+ */
+export function cliEnvFilePaths(workDir, envFilePath) {
+    return [
+        join(workDir, ".env"),
+        envFilePath ? resolveUserPath(envFilePath, workDir) : defaultDuetEnvFilePath(),
+    ];
+}
+/**
+ * Load the env files from {@link cliEnvFilePaths} into `process.env` and
+ * return the set of keys that came from those files. The returned set lets
+ * model resolution distinguish keys we loaded from keys the user already
+ * exported in their shell.
+ */
+export function loadCliEnvFiles(workDir, envFilePath) {
+    const dotenvKeys = new Set();
+    for (const path of cliEnvFilePaths(workDir, envFilePath)) {
+        const result = dotenv.config({ path, quiet: true });
+        for (const key of Object.keys(result.parsed ?? {})) {
+            dotenvKeys.add(key);
+        }
+    }
+    return dotenvKeys;
+}
+/** Reject negative or non-numeric values for `--resume-history-lines`. */
+export function parseResumeHistoryLines(value, optionName = "--resume-history-lines") {
+    if (!/^\d+$/.test(value)) {
+        throw new Error(`${optionName} must be a non-negative integer`);
+    }
+    return Number(value);
+}
+/** True when stdin or stdout is a TTY (heuristic for interactive sessions). */
+export function isInteractive() {
+    return Boolean(process.stdin.isTTY ?? process.stdout.isTTY);
+}
+/** True when an existing path resolves to a regular file. */
+export async function fileExists(path) {
+    try {
+        return (await stat(path)).isFile();
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Merge the given key/value pairs into the env file at `target`, creating
+ * the directory tree if needed and preserving any keys that are not being
+ * updated. Values are quoted only when needed so the file remains diffable.
+ */
+export async function mergeEnvEntries(target, entries) {
+    await mkdir(dirname(target), { recursive: true });
+    const existingText = (await fileExists(target)) ? await readFile(target, "utf8") : "";
+    const merged = new Map(Object.entries(existingText ? dotenv.parse(existingText) : {}));
+    for (const [key, value] of entries) {
+        merged.set(key, value);
+    }
+    await writeFile(target, formatEnvEntries(merged));
+}
+/** Serialize a key/value map as the text payload of a dotenv file. */
+export function formatEnvEntries(entries) {
+    return Array.from(entries, ([key, value]) => `${key}=${dotenvQuote(value)}`).join("\n") + "\n";
+}
+function dotenvQuote(value) {
+    if (/^[A-Za-z0-9_./:@+-]+$/.test(value))
+        return value;
+    return JSON.stringify(value);
+}
+/**
+ * Quote a string so it round-trips through a POSIX shell. Used to render
+ * resume hints and dry-run upgrade commands the user can copy verbatim.
+ */
+export function shellQuote(value) {
+    if (/^[A-Za-z0-9_./:=+-]+$/.test(value))
+        return value;
+    return `'${value.replace(/'/g, "'\\''")}'`;
+}
+/** Strip a leading `v` from a semver-ish string and return the bare numbers. */
+export function normalizePackageVersion(version) {
+    return version.replace(/^v/, "");
+}
+//# sourceMappingURL=shared.js.map

package/dist/src/cli/shared.js.map

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

package/dist/src/cli/skills.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Run `duet skills` — print installed skills as JSON.
+ *
+ * Each entry includes name, description, absolute path, and resolved scope
+ * ("user" | "project" | "temporary"). Skill collisions are reported on
+ * stderr without changing exit status so scripts that rely on JSON output
+ * stay parseable.
+ */
+export declare function runSkillsCommand(args: string[]): void;
+//# sourceMappingURL=skills.d.ts.map

package/dist/src/cli/skills.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skills.d.ts","sourceRoot":"","sources":["../../../src/cli/skills.ts"],"names":[],"mappings":"AAIA;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,IAAI,CA+BrD"}

package/dist/src/cli/skills.js

@@ -0,0 +1,42 @@
+import { discoverInstalledSkills, resolveSkillScope } from "../turn-runner/skills.js";
+import { printSkillsHelp } from "./help.js";
+import { fail } from "./shared.js";
+/**
+ * Run `duet skills` — print installed skills as JSON.
+ *
+ * Each entry includes name, description, absolute path, and resolved scope
+ * ("user" | "project" | "temporary"). Skill collisions are reported on
+ * stderr without changing exit status so scripts that rely on JSON output
+ * stay parseable.
+ */
+export function runSkillsCommand(args) {
+    let workDir = process.cwd();
+    for (let i = 0; i < args.length; i++) {
+        switch (args[i]) {
+            case "--workdir":
+            case "-w":
+                if (!args[i + 1] || args[i + 1]?.startsWith("-"))
+                    fail(`Missing value for ${args[i]}`);
+                workDir = args[++i];
+                break;
+            case "--help":
+            case "-h":
+                printSkillsHelp();
+                return;
+            default:
+                fail(`Unknown skills option: ${args[i]}`);
+        }
+    }
+    const { skills, collisions } = discoverInstalledSkills(workDir);
+    const output = skills.map((skill) => ({
+        name: skill.name,
+        description: skill.description,
+        path: skill.baseDir,
+        scope: resolveSkillScope(skill, workDir),
+    }));
+    process.stdout.write(`${JSON.stringify(output, null, 2)}\n`);
+    for (const collision of collisions) {
+        process.stderr.write(`[skill collision] "${collision.name}": kept ${collision.winnerPath}, ignored ${collision.loserPath}\n`);
+    }
+}
+//# sourceMappingURL=skills.js.map

package/dist/src/cli/skills.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"skills.js","sourceRoot":"","sources":["../../../src/cli/skills.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,uBAAuB,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AACtF,OAAO,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AAC5C,OAAO,EAAE,IAAI,EAAE,MAAM,aAAa,CAAC;AAEnC;;;;;;;GAOG;AACH,MAAM,UAAU,gBAAgB,CAAC,IAAc;IAC7C,IAAI,OAAO,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC;IAC5B,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACrC,QAAQ,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;YAChB,KAAK,WAAW,CAAC;YACjB,KAAK,IAAI;gBACP,IAAI,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,EAAE,UAAU,CAAC,GAAG,CAAC;oBAAE,IAAI,CAAC,qBAAqB,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;gBACvF,OAAO,GAAG,IAAI,CAAC,EAAE,CAAC,CAAE,CAAC;gBACrB,MAAM;YACR,KAAK,QAAQ,CAAC;YACd,KAAK,IAAI;gBACP,eAAe,EAAE,CAAC;gBAClB,OAAO;YACT;gBACE,IAAI,CAAC,0BAA0B,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;QAC9C,CAAC;IACH,CAAC;IAED,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,GAAG,uBAAuB,CAAC,OAAO,CAAC,CAAC;IAChE,MAAM,MAAM,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;QACpC,IAAI,EAAE,KAAK,CAAC,IAAI;QAChB,WAAW,EAAE,KAAK,CAAC,WAAW;QAC9B,IAAI,EAAE,KAAK,CAAC,OAAO;QACnB,KAAK,EAAE,iBAAiB,CAAC,KAAK,EAAE,OAAO,CAAC;KACzC,CAAC,CAAC,CAAC;IACJ,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC;IAC7D,KAAK,MAAM,SAAS,IAAI,UAAU,EAAE,CAAC;QACnC,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,sBAAsB,SAAS,CAAC,IAAI,WAAW,SAAS,CAAC,UAAU,aAAa,SAAS,CAAC,SAAS,IAAI,CACxG,CAAC;IACJ,CAAC;AACH,CAAC"}

package/dist/src/cli/upgrade.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Run `duet upgrade`.
+ *
+ * Resolves the target version (npm latest unless --version overrides),
+ * builds the right global-install command for the detected manager,
+ * prints it under --dry-run, and otherwise spawns it inheriting stdio.
+ */
+export declare function runUpgradeCommand(args: string[], packageName: string): Promise<void>;
+//# sourceMappingURL=upgrade.d.ts.map

package/dist/src/cli/upgrade.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"upgrade.d.ts","sourceRoot":"","sources":["../../../src/cli/upgrade.ts"],"names":[],"mappings":"AAWA;;;;;;GAMG;AACH,wBAAsB,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAwC1F"}

package/dist/src/cli/upgrade.js

@@ -0,0 +1,52 @@
+import { detectPackageManager, globalUpgradeCommand, parsePackageManager, runCommand, } from "./package-manager.js";
+import { fail, normalizePackageVersion, shellQuote } from "./shared.js";
+import { fetchLatestPackageVersion } from "./version-check.js";
+import { printUpgradeHelp } from "./help.js";
+/**
+ * Run `duet upgrade`.
+ *
+ * Resolves the target version (npm latest unless --version overrides),
+ * builds the right global-install command for the detected manager,
+ * prints it under --dry-run, and otherwise spawns it inheriting stdio.
+ */
+export async function runUpgradeCommand(args, packageName) {
+    let packageManager = detectPackageManager();
+    let dryRun = false;
+    let targetVersion;
+    for (let i = 0; i < args.length; i++) {
+        switch (args[i]) {
+            case "--manager":
+                if (!args[i + 1] || args[i + 1]?.startsWith("-"))
+                    fail(`Missing value for ${args[i]}`);
+                packageManager = parsePackageManager(args[++i]);
+                break;
+            case "--dry-run":
+                dryRun = true;
+                break;
+            case "--version":
+                if (!args[i + 1] || args[i + 1]?.startsWith("-"))
+                    fail(`Missing value for ${args[i]}`);
+                targetVersion = normalizePackageVersion(args[++i]);
+                break;
+            case "--help":
+            case "-h":
+                printUpgradeHelp(packageName);
+                return;
+            default:
+                fail(`Unknown upgrade option: ${args[i]}`);
+        }
+    }
+    targetVersion ??= await fetchLatestPackageVersion(packageName);
+    if (!targetVersion) {
+        fail(`Could not resolve latest ${packageName} version from npm`);
+    }
+    const command = globalUpgradeCommand(packageManager, packageName, targetVersion);
+    const commandText = command.map(shellQuote).join(" ");
+    if (dryRun) {
+        console.log(commandText);
+        return;
+    }
+    console.error(`Upgrading ${packageName} to ${targetVersion} with ${packageManager}...`);
+    await runCommand(command[0], command.slice(1));
+}
+//# sourceMappingURL=upgrade.js.map

package/dist/src/cli/upgrade.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"upgrade.js","sourceRoot":"","sources":["../../../src/cli/upgrade.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,oBAAoB,EACpB,oBAAoB,EAEpB,mBAAmB,EACnB,UAAU,GACX,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,IAAI,EAAE,uBAAuB,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACxE,OAAO,EAAE,yBAAyB,EAAE,MAAM,oBAAoB,CAAC;AAC/D,OAAO,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC;AAE7C;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,iBAAiB,CAAC,IAAc,EAAE,WAAmB;IACzE,IAAI,cAAc,GAAmB,oBAAoB,EAAE,CAAC;IAC5D,IAAI,MAAM,GAAG,KAAK,CAAC;IACnB,IAAI,aAAiC,CAAC;IAEtC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACrC,QAAQ,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;YAChB,KAAK,WAAW;gBACd,IAAI,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,EAAE,UAAU,CAAC,GAAG,CAAC;oBAAE,IAAI,CAAC,qBAAqB,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;gBACvF,cAAc,GAAG,mBAAmB,CAAC,IAAI,CAAC,EAAE,CAAC,CAAE,CAAC,CAAC;gBACjD,MAAM;YACR,KAAK,WAAW;gBACd,MAAM,GAAG,IAAI,CAAC;gBACd,MAAM;YACR,KAAK,WAAW;gBACd,IAAI,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,EAAE,UAAU,CAAC,GAAG,CAAC;oBAAE,IAAI,CAAC,qBAAqB,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;gBACvF,aAAa,GAAG,uBAAuB,CAAC,IAAI,CAAC,EAAE,CAAC,CAAE,CAAC,CAAC;gBACpD,MAAM;YACR,KAAK,QAAQ,CAAC;YACd,KAAK,IAAI;gBACP,gBAAgB,CAAC,WAAW,CAAC,CAAC;gBAC9B,OAAO;YACT;gBACE,IAAI,CAAC,2BAA2B,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;QAC/C,CAAC;IACH,CAAC;IAED,aAAa,KAAK,MAAM,yBAAyB,CAAC,WAAW,CAAC,CAAC;IAC/D,IAAI,CAAC,aAAa,EAAE,CAAC;QACnB,IAAI,CAAC,4BAA4B,WAAW,mBAAmB,CAAC,CAAC;IACnE,CAAC;IACD,MAAM,OAAO,GAAG,oBAAoB,CAAC,cAAc,EAAE,WAAW,EAAE,aAAa,CAAC,CAAC;IACjF,MAAM,WAAW,GAAG,OAAO,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACtD,IAAI,MAAM,EAAE,CAAC;QACX,OAAO,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;QACzB,OAAO;IACT,CAAC;IAED,OAAO,CAAC,KAAK,CAAC,aAAa,WAAW,OAAO,aAAa,SAAS,cAAc,KAAK,CAAC,CAAC;IACxF,MAAM,UAAU,CAAC,OAAO,CAAC,CAAC,CAAE,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;AAClD,CAAC"}

package/dist/src/cli/version-check.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Compare two semver-ish strings. Returns -1, 0, or 1 like Array.sort.
+ *
+ * Pre-release ordering follows the simple rule "release wins over pre-release",
+ * which is enough for the upgrade-notice path; full SemVer 2.0 ordering is
+ * not required here because we only compare published npm versions.
+ */
+export declare function compareSemverVersions(left: string, right: string): number;
+/**
+ * Fetch the `latest` dist-tag for a package from the npm registry.
+ * Returns undefined on any failure so callers can no-op silently.
+ */
+export declare function fetchLatestPackageVersion(packageName: string): Promise<string | undefined>;
+/** Format the "Update available" notice we print at startup. */
+export declare function formatNewVersionNotice(packageName: string, currentVersion: string, latestVersion: string): string;
+/**
+ * Resolve the upgrade notice for `packageName@currentVersion`. Returns
+ * undefined when the user is already on the latest version or the registry
+ * lookup failed; callers print whatever string comes back.
+ */
+export declare function getNewVersionNotice(packageName: string, currentVersion: string): Promise<string | undefined>;
+//# sourceMappingURL=version-check.d.ts.map

package/dist/src/cli/version-check.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"version-check.d.ts","sourceRoot":"","sources":["../../../src/cli/version-check.ts"],"names":[],"mappings":"AAMA;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAWzE;AAcD;;;GAGG;AACH,wBAAsB,yBAAyB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAehG;AAED,gEAAgE;AAChE,wBAAgB,sBAAsB,CACpC,WAAW,EAAE,MAAM,EACnB,cAAc,EAAE,MAAM,EACtB,aAAa,EAAE,MAAM,GACpB,MAAM,CAER;AAED;;;;GAIG;AACH,wBAAsB,mBAAmB,CACvC,WAAW,EAAE,MAAM,EACnB,cAAc,EAAE,MAAM,GACrB,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAS7B"}