@namzu/cli 35.0.0 → 36.0.0

package/dist/browser/control.js

@@ -1,140 +0,0 @@
-/**
- * The interactive session's browser: one `BrowserHost` the tools are built
- * over, whose profile the operator can switch without rebuilding them.
- *
- * `createBrowserTools(host)` reads `host` on every call, so the host handed
- * to it here is a delegate over the real `PlaywrightBrowserHost`. Switching
- * profile (`/browser profile <name>`) disposes the current host (which
- * closes its browser, unless `keepOpen`) and builds the next one; neither
- * launches anything until the model's first browser call.
- *
- * Constructing a `PlaywrightBrowserHost` detects the engine (file probes and
- * `wslinfo`, a few milliseconds) and starts nothing, which is why the
- * session can build one at boot.
- */
-/** `@namzu/browser` profile names, restated so this file needs no runtime import to check one. */
-export const BROWSER_PROFILE_NAME_PATTERN = /^[a-z0-9]+(?:-[a-z0-9]+)*$/;
-export function isBrowserProfileName(name) {
-    return name.length <= 64 && BROWSER_PROFILE_NAME_PATTERN.test(name);
-}
-export function createBrowserControl(Host, options) {
-    const ownSites = options.sites ?? { '*': 'ask' };
-    let sites = ownSites;
-    const build = (profile) => new Host({
-        profile,
-        mode: options.mode ?? 'interactive',
-        sites,
-        ...(options.engine ? { engine: options.engine } : {}),
-        ...(options.headless ? { headless: options.headless } : {}),
-        ...(options.keepOpen ? { keepOpen: true } : {}),
-        ...(options.home ? { home: options.home } : {}),
-    });
-    let current = build(options.profile ?? 'default');
-    let disposed = false;
-    const host = {
-        id: 'namzu-browser',
-        get capabilities() {
-            return current.capabilities;
-        },
-        observe(action, callOptions) {
-            return current.observe(action, callOptions);
-        },
-        act(action, callOptions) {
-            return current.act(action, callOptions);
-        },
-        describeRef(ref) {
-            return current.describeRef(ref);
-        },
-        session() {
-            return current.session();
-        },
-        async initialize() {
-            // Nothing: the browser starts on the first call that needs it.
-        },
-        async dispose() {
-            await control.dispose();
-        },
-    };
-    const control = {
-        host,
-        status() {
-            const plan = current.plan;
-            return {
-                profile: current.profile,
-                engine: current.capabilities.engine,
-                browser: plan.browser,
-                headless: current.capabilities.headless,
-                running: current.running,
-                ...(current.capabilities.unavailableReason !== undefined
-                    ? { unavailableReason: current.capabilities.unavailableReason }
-                    : {}),
-                warnings: current.warnings,
-                sites,
-                keepOpen: options.keepOpen === true,
-            };
-        },
-        async switchProfile(name) {
-            if (!isBrowserProfileName(name)) {
-                throw new Error(`"${name}" is not a profile name: use lowercase letters, digits and single hyphens, at most 64 characters.`);
-            }
-            if (disposed)
-                throw new Error('The browser of this session is closed.');
-            const previous = current;
-            current = build(name);
-            await previous.dispose();
-            return control.status();
-        },
-        async release() {
-            if (disposed)
-                return;
-            const previous = current;
-            current = build(previous.profile);
-            await previous.dispose();
-        },
-        async runAs(run) {
-            if (!isBrowserProfileName(run.profile)) {
-                throw new Error(`"${run.profile}" is not a profile name.`);
-            }
-            if (disposed)
-                throw new Error('The browser of this session is closed.');
-            const previous = current;
-            const ownProfile = previous.profile;
-            sites = run.sites;
-            current = build(run.profile);
-            await previous.dispose();
-            let restored = false;
-            return async () => {
-                if (restored || disposed)
-                    return;
-                restored = true;
-                const used = current;
-                sites = ownSites;
-                current = build(ownProfile);
-                await used.dispose();
-            };
-        },
-        async dispose() {
-            if (disposed)
-                return;
-            disposed = true;
-            await current.dispose();
-        },
-    };
-    return control;
-}
-/** The status as `/browser` prints it. */
-export function describeBrowserStatus(status) {
-    const sites = Object.entries(status.sites)
-        .map(([site, level]) => `${site} ${level}`)
-        .join(' · ');
-    const rows = [
-        `Browser: ${status.engine} (${status.browser}) · ${status.headless ? 'no window' : 'visible window'} · ${status.running ? 'running' : 'not started'}`,
-        `Profile: ${status.profile}${status.keepOpen ? ' · stays open after the session' : ''}`,
-        `Sites: ${sites}`,
-        ...(status.unavailableReason ? [`Unavailable: ${status.unavailableReason}`] : []),
-        ...status.warnings.map((warning) => `Note: ${warning}`),
-        'Sign in once with `namzu browser login <profile> <url>`; switch with /browser profile <name>.',
-    ];
-    return rows.join('\n');
-}
-//# sourceMappingURL=control.js.map

package/dist/browser/control.js.map

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

package/dist/browser/describe.js

@@ -1,27 +0,0 @@
-/**
- * An engine plan in words, for `namzu doctor`, `namzu browser status` and
- * `/browser`. Types only from `@namzu/browser`: describing a plan must not
- * load Playwright.
- */
-const BROWSER_NAMES = {
-    chrome: 'Google Chrome',
-    msedge: 'Microsoft Edge',
-    chromium: "Playwright's Chromium",
-};
-export function browserName(browser) {
-    return BROWSER_NAMES[browser] ?? browser;
-}
-/** `windows-cdp`, `local-chrome`, …: the engine as the tools and the logs name it. */
-export function engineLabel(plan) {
-    return plan.engine === 'local' ? `local-${plan.browser}` : plan.engine;
-}
-/** One line: which browser, where, and whether it shows a window. */
-export function describeBrowserPlan(plan) {
-    const window = plan.headless ? 'no window (headless)' : 'a visible window';
-    if (plan.engine === 'windows-cdp') {
-        return `${engineLabel(plan)}: ${browserName(plan.browser)} on Windows (${plan.windowsExecutable}), driven from WSL through the PowerShell bridge (${plan.networkingMode} networking), ${window}`;
-    }
-    const where = plan.platform === 'wsl' ? 'inside WSL' : `on ${plan.platform}`;
-    return `${engineLabel(plan)}: ${browserName(plan.browser)} ${where}, ${window}`;
-}
-//# sourceMappingURL=describe.js.map

package/dist/browser/describe.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"describe.js","sourceRoot":"","sources":["../../src/browser/describe.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,MAAM,aAAa,GAA2B;IAC7C,MAAM,EAAE,eAAe;IACvB,MAAM,EAAE,gBAAgB;IACxB,QAAQ,EAAE,uBAAuB;CACjC,CAAA;AAED,MAAM,UAAU,WAAW,CAAC,OAAe;IAC1C,OAAO,aAAa,CAAC,OAAO,CAAC,IAAI,OAAO,CAAA;AACzC,CAAC;AAED,sFAAsF;AACtF,MAAM,UAAU,WAAW,CAAC,IAAuB;IAClD,OAAO,IAAI,CAAC,MAAM,KAAK,OAAO,CAAC,CAAC,CAAC,SAAS,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAA;AACvE,CAAC;AAED,qEAAqE;AACrE,MAAM,UAAU,mBAAmB,CAAC,IAAuB;IAC1D,MAAM,MAAM,GAAG,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,sBAAsB,CAAC,CAAC,CAAC,kBAAkB,CAAA;IAC1E,IAAI,IAAI,CAAC,MAAM,KAAK,aAAa,EAAE,CAAC;QACnC,OAAO,GAAG,WAAW,CAAC,IAAI,CAAC,KAAK,WAAW,CAAC,IAAI,CAAC,OAAO,CAAC,gBAAgB,IAAI,CAAC,iBAAiB,qDAAqD,IAAI,CAAC,cAAc,iBAAiB,MAAM,EAAE,CAAA;IACjM,CAAC;IACD,MAAM,KAAK,GAAG,IAAI,CAAC,QAAQ,KAAK,KAAK,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,MAAM,IAAI,CAAC,QAAQ,EAAE,CAAA;IAC5E,OAAO,GAAG,WAAW,CAAC,IAAI,CAAC,KAAK,WAAW,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,KAAK,KAAK,MAAM,EAAE,CAAA;AAChF,CAAC"}

package/dist/checkpoints/store.js

@@ -1,192 +0,0 @@
-/**
- * File checkpoints: the state of every file the model changed, before it
- * changed it, per turn — so `/restore N` puts the working tree back to
- * where it was before turn N.
- *
- * Not git. A checkpoint is taken by the tool wrapper immediately before an
- * `edit` or `write` runs, whatever the repository's state, and it records
- * absence too, so a file the model created is removed on restore. Kept per
- * session in its `<session-id>/file-history/` directory and dropped when the session
- * closes: a checkpoint outlives a turn, not a session — the conversation
- * can be forked and resumed, and its files are the working tree's.
- */
-import { mkdir, readFile, rm, unlink, writeFile } from 'node:fs/promises';
-import { dirname, isAbsolute, join, relative, resolve, sep } from 'node:path';
-/** Files larger than this are not snapshotted; the transcript says so. */
-export const CHECKPOINT_MAX_BYTES = 8 * 1024 * 1024;
-const LABEL_CHARS = 72;
-export class FileCheckpointStore {
-    root;
-    cwd;
-    turns = [];
-    current;
-    skipped = new Set();
-    /** Every `file-history/` a blob was written under, so closing drops them all. */
-    roots = new Set();
-    constructor(
-    /**
-     * Where blobs go: the session's `file-history/` (`SessionPaths.fileHistory`).
-     * A function is read at each turn's first snapshot, so a store that
-     * outlives a conversation switch (`/resume`, `/new`) writes into the
-     * conversation the turn belongs to, not the one the process started in.
-     */
-    root, 
-    /** Only files under here are checkpointed. */
-    cwd) {
-        this.root = root;
-        this.cwd = cwd;
-    }
-    currentRoot() {
-        return typeof this.root === 'function' ? this.root() : this.root;
-    }
-    /** The next tool write belongs to this turn. Returns its index. */
-    beginTurn(label) {
-        const index = this.turns.length + 1;
-        this.current = {
-            index,
-            label: firstLine(label).slice(0, LABEL_CHARS),
-            startedAt: Date.now(),
-            entries: [],
-        };
-        this.turns.push(this.current);
-        return index;
-    }
-    /** Whether a host path is one this store would checkpoint. */
-    covers(hostPath) {
-        const rel = relative(this.cwd, resolve(this.cwd, hostPath));
-        return rel.length > 0 && !rel.startsWith('..') && !isAbsolute(rel);
-    }
-    /**
-     * Record the file's current content before it changes. Once per path
-     * per turn: the first snapshot is the pre-turn state, and a second edit
-     * to the same file within a turn must not overwrite it.
-     */
-    async snapshot(hostPath) {
-        const turn = this.current ?? this.turnForStrayWrite();
-        const path = resolve(this.cwd, hostPath);
-        if (!this.covers(path))
-            return 'outside';
-        if (turn.entries.some((e) => e.path === path))
-            return 'already';
-        let content;
-        try {
-            content = await readFile(path);
-        }
-        catch (err) {
-            if (err.code === 'ENOENT')
-                content = null;
-            else
-                throw err;
-        }
-        if (content !== null && content.byteLength > CHECKPOINT_MAX_BYTES) {
-            this.skipped.add(path);
-            return 'too-large';
-        }
-        let blob = null;
-        if (content !== null) {
-            const dir = turn.dir ?? join(this.currentRoot(), String(turn.index));
-            turn.dir = dir;
-            this.roots.add(dirname(dir));
-            await mkdir(dir, { recursive: true });
-            blob = join(dir, `${turn.entries.length}.blob`);
-            await writeFile(blob, content);
-        }
-        turn.entries.push({ path, blob });
-        return 'recorded';
-    }
-    /** Turns that changed at least one file. */
-    list() {
-        return this.turns
-            .filter((t) => t.entries.length > 0)
-            .map((t) => ({
-            index: t.index,
-            label: t.label,
-            startedAt: t.startedAt,
-            files: t.entries.map((e) => e.path),
-        }));
-    }
-    /** Paths that were too large to checkpoint, so a restore cannot bring them back. */
-    skippedPaths() {
-        return [...this.skipped];
-    }
-    /**
-     * Put every file back to its state before turn `index`, undoing that
-     * turn and every later one. Later turns are applied first, so a file
-     * touched in several turns ends at its oldest recorded state.
-     */
-    async restore(index) {
-        const target = this.turns.find((t) => t.index === index);
-        if (!target || !this.turns.some((t) => t.index >= index && t.entries.length > 0)) {
-            throw new Error(`No checkpoint for turn ${index}.`);
-        }
-        const restored = new Set();
-        const removed = new Set();
-        for (const turn of [...this.turns].filter((t) => t.index >= index).reverse()) {
-            for (const entry of turn.entries) {
-                if (entry.blob === null) {
-                    await unlink(entry.path).catch((err) => {
-                        if (err.code !== 'ENOENT')
-                            throw err;
-                    });
-                    removed.add(entry.path);
-                    restored.delete(entry.path);
-                }
-                else {
-                    await mkdir(dirname(entry.path), { recursive: true });
-                    await writeFile(entry.path, await readFile(entry.blob));
-                    restored.add(entry.path);
-                    removed.delete(entry.path);
-                }
-            }
-        }
-        // The undone turns are gone: their snapshots describe a state the
-        // tree no longer builds on.
-        const dropped = this.turns.splice(this.turns.findIndex((t) => t.index === index));
-        for (const turn of dropped) {
-            if (turn.dir)
-                await rm(turn.dir, { recursive: true, force: true });
-        }
-        this.current = undefined;
-        return { turn: index, restored: [...restored], removed: [...removed] };
-    }
-    /** Drop every blob. The session is over. */
-    async close() {
-        for (const root of new Set([...this.roots, this.currentRoot()])) {
-            await rm(root, { recursive: true, force: true });
-        }
-    }
-    /** A write outside any turn — a host command, say — gets a turn of its own. */
-    turnForStrayWrite() {
-        this.beginTurn('(outside a turn)');
-        return this.current;
-    }
-}
-function firstLine(text) {
-    const line = text.split('\n').find((l) => l.trim().length > 0) ?? '';
-    return line.trim();
-}
-/** What `/restore` prints with no argument. */
-export function renderCheckpoints(turns, cwd) {
-    if (turns.length === 0)
-        return 'No checkpoints: no file has been changed by a tool this session.';
-    const lines = ['Checkpoints (files as they were before each turn):'];
-    for (const turn of turns) {
-        lines.push(`  ${turn.index}. ${turn.label || '(no prompt)'}`);
-        for (const file of turn.files)
-            lines.push(`       ${relative(cwd, file) || file}`);
-    }
-    lines.push('', '/restore N puts every file back to before turn N, undoing N and every later turn.');
-    return lines.join('\n');
-}
-/** What `/restore N` prints. */
-export function renderRestore(report, cwd) {
-    const rel = (p) => relative(cwd, p) || p;
-    const lines = [`Restored the tree to before turn ${report.turn}.`];
-    for (const p of report.restored)
-        lines.push(`  restored ${rel(p)}`);
-    for (const p of report.removed)
-        lines.push(`  removed  ${rel(p)}`);
-    return lines.join('\n');
-}
-export { sep as PATH_SEPARATOR };
-//# sourceMappingURL=store.js.map

package/dist/checkpoints/store.js.map

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

package/dist/checkpoints/wrap.js

@@ -1,37 +0,0 @@
-/**
- * The file tools, with a checkpoint taken before each write.
- *
- * Wrapping `execute` rather than hooking `pre_tool_use`: a hook needs the
- * plugin lifecycle manager, which a session without plugins or hooks does
- * not build, and a checkpoint must not depend on which other features are
- * on. The wrapper reads the file the tool is about to change, records it,
- * and then runs the tool untouched.
- */
-/** Tools whose `path` names a file they will change. */
-export const CHECKPOINTED_TOOLS = ['edit', 'write'];
-function pathOf(input) {
-    if (input === null || typeof input !== 'object')
-        return undefined;
-    const path = input.path;
-    return typeof path === 'string' && path.length > 0 ? path : undefined;
-}
-export function withCheckpoints(tool, store) {
-    return {
-        ...tool,
-        execute: async (input, context) => {
-            const path = pathOf(input);
-            if (path !== undefined) {
-                try {
-                    await store.snapshot(path);
-                }
-                catch (err) {
-                    // A checkpoint that cannot be taken must not stop the edit;
-                    // it is a safety net under the work, not a gate on it.
-                    context.log('warn', `checkpoint skipped for ${path}: ${err instanceof Error ? err.message : String(err)}`);
-                }
-            }
-            return tool.execute(input, context);
-        },
-    };
-}
-//# sourceMappingURL=wrap.js.map

package/dist/checkpoints/wrap.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"wrap.js","sourceRoot":"","sources":["../../src/checkpoints/wrap.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAMH,wDAAwD;AACxD,MAAM,CAAC,MAAM,kBAAkB,GAAsB,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;AAEtE,SAAS,MAAM,CAAC,KAAc;IAC7B,IAAI,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,SAAS,CAAA;IACjE,MAAM,IAAI,GAAI,KAA4B,CAAC,IAAI,CAAA;IAC/C,OAAO,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,CAAA;AACtE,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,IAAoB,EAAE,KAA0B;IAC/E,OAAO;QACN,GAAG,IAAI;QACP,OAAO,EAAE,KAAK,EAAE,KAAc,EAAE,OAAoB,EAAuB,EAAE;YAC5E,MAAM,IAAI,GAAG,MAAM,CAAC,KAAK,CAAC,CAAA;YAC1B,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;gBACxB,IAAI,CAAC;oBACJ,MAAM,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAA;gBAC3B,CAAC;gBAAC,OAAO,GAAG,EAAE,CAAC;oBACd,4DAA4D;oBAC5D,uDAAuD;oBACvD,OAAO,CAAC,GAAG,CACV,MAAM,EACN,0BAA0B,IAAI,KAAK,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CACrF,CAAA;gBACF,CAAC;YACF,CAAC;YACD,OAAO,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,OAAO,CAAC,CAAA;QACpC,CAAC;KACD,CAAA;AACF,CAAC"}