craftdriver 1.6.0 → 1.8.0

package/dist/cli/defaults.js

@@ -12,8 +12,55 @@
  * Never import these constants from `src/lib/*`. The agent-surface
  * defaults must stay out of the library hot path.
  */
+import crypto from 'crypto';
+import fs from 'fs';
 import os from 'os';
 import path from 'path';
+/**
+ * Root of the project the CLI is being run against: the nearest ancestor
+ * holding a `package.json` or `.git`, falling back to the working directory.
+ *
+ * Resolved through `realpath` so `/tmp` and `/private/tmp` — or any other
+ * symlinked path — do not key two daemons for the same project.
+ */
+export function projectRoot(cwd = process.cwd()) {
+    let dir;
+    try {
+        dir = fs.realpathSync(path.resolve(cwd));
+    }
+    catch {
+        return path.resolve(cwd);
+    }
+    const start = dir;
+    for (;;) {
+        if (fs.existsSync(path.join(dir, 'package.json')) ||
+            fs.existsSync(path.join(dir, '.git'))) {
+            return dir;
+        }
+        const parent = path.dirname(dir);
+        if (parent === dir)
+            return start;
+        dir = parent;
+    }
+}
+/**
+ * Per-project daemon directory.
+ *
+ * The socket used to be user-global, so a daemon started in project A served
+ * project B: same browser, same cookies, same refs, and artifacts written
+ * into whichever project happened to start it first. Keying the socket by
+ * project root fixes that at the transport, and — unlike a session namespace
+ * inside one shared daemon — it also stops project A's installed craftdriver
+ * version from serving project B.
+ *
+ * The directory name carries the project's basename purely so `lsof` and
+ * `ls ~/.craftdriver/projects` are readable; the hash is what disambiguates.
+ */
+export function daemonDir(root = projectRoot()) {
+    const hash = crypto.createHash('sha256').update(root).digest('hex').slice(0, 12);
+    const label = path.basename(root).replace(/[^A-Za-z0-9_-]/g, '-').slice(0, 32);
+    return path.join(os.homedir(), '.craftdriver', 'projects', `${label}-${hash}`);
+}
 export const AGENT_DEFAULT_TIMEOUT_MS = (() => {
     const raw = process.env.CRAFTDRIVER_AGENT_TIMEOUT;
     if (raw === undefined || raw === '')
@@ -23,20 +70,18 @@ export const AGENT_DEFAULT_TIMEOUT_MS = (() => {
 })();
 /** Default `--limit` for list-returning commands. */
 export const AGENT_DEFAULT_LIMIT = 20;
-/** Path to the daemon's Unix socket. */
+/** Path to this project's daemon socket. */
 export const DAEMON_SOCKET_PATH = (() => {
     const override = process.env.CRAFTDRIVER_SOCKET;
     if (override)
         return override;
-    return path.join(os.homedir(), '.craftdriver', 'sock');
+    return path.join(daemonDir(), 'sock');
 })();
 /** PID file written by the daemon so `daemon status/stop` can find it. */
 export const DAEMON_PID_PATH = (() => {
     const override = process.env.CRAFTDRIVER_PID;
     if (override)
         return override;
-    return path.join(os.homedir(), '.craftdriver', 'pid');
+    return path.join(daemonDir(), 'pid');
 })();
-/** Idle browser shutdown delay (ms) when daemon receives no requests. */
-export const DAEMON_IDLE_SHUTDOWN_MS = 0; // 0 = never auto-shutdown
 //# sourceMappingURL=defaults.js.map

package/dist/cli/defaults.js.map

@@ -1 +1 @@
-{"version":3,"file":"defaults.js","sourceRoot":"","sources":["../../src/cli/defaults.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AACH,OAAO,EAAE,MAAM,IAAI,CAAC;AACpB,OAAO,IAAI,MAAM,MAAM,CAAC;AAExB,MAAM,CAAC,MAAM,wBAAwB,GAAG,CAAC,GAAG,EAAE;IAC5C,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,yBAAyB,CAAC;IAClD,IAAI,GAAG,KAAK,SAAS,IAAI,GAAG,KAAK,EAAE;QAAE,OAAO,KAAK,CAAC;IAClD,MAAM,CAAC,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC;IACtB,OAAO,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC;AAClD,CAAC,CAAC,EAAE,CAAC;AAEL,qDAAqD;AACrD,MAAM,CAAC,MAAM,mBAAmB,GAAG,EAAE,CAAC;AAEtC,wCAAwC;AACxC,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,GAAG,EAAE;IACtC,MAAM,QAAQ,GAAG,OAAO,CAAC,GAAG,CAAC,kBAAkB,CAAC;IAChD,IAAI,QAAQ;QAAE,OAAO,QAAQ,CAAC;IAC9B,OAAO,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,EAAE,cAAc,EAAE,MAAM,CAAC,CAAC;AACzD,CAAC,CAAC,EAAE,CAAC;AAEL,0EAA0E;AAC1E,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,GAAG,EAAE;IACnC,MAAM,QAAQ,GAAG,OAAO,CAAC,GAAG,CAAC,eAAe,CAAC;IAC7C,IAAI,QAAQ;QAAE,OAAO,QAAQ,CAAC;IAC9B,OAAO,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,EAAE,cAAc,EAAE,KAAK,CAAC,CAAC;AACxD,CAAC,CAAC,EAAE,CAAC;AAEL,yEAAyE;AACzE,MAAM,CAAC,MAAM,uBAAuB,GAAG,CAAC,CAAC,CAAC,0BAA0B"}
+{"version":3,"file":"defaults.js","sourceRoot":"","sources":["../../src/cli/defaults.ts"],"names":[],"mappings":"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"}

package/dist/cli/dispatcher.d.ts

@@ -1,15 +1,6 @@
-/**
- * Command dispatcher — single source of truth for "what each CLI
- * command does to a Browser instance".
- *
- * Pure logic: takes a `cmd` name + `args` object, returns either a
- * JSON-serializable result or throws `CraftdriverError`. The daemon
- * and the ephemeral runner both call into this; an MCP server can
- * reuse it later (different response shape, same dispatch table).
- *
- * Side effects (browser launch / shutdown) live in the caller.
- */
 import { Browser, type LaunchOptions } from '../lib/browser.js';
+import { SnapshotTracker } from './snapshot.js';
+import type { SessionJournal } from './journal.js';
 /** Lazy-initialized browser handle shared by all commands in a session. */
 export interface BrowserHandle {
     /** Returns a connected browser, launching it on first call. */
@@ -23,6 +14,58 @@ export declare function createBrowserHandle(launch: () => Promise<Browser>): Bro
 export interface DispatchContext {
     handle: BrowserHandle;
     launchOptions: LaunchOptions;
+    /** Safe session identifier used for bounded, tool-owned artifact names. */
+    artifactName?: string;
+    /** Owns the one snapshot baseline and the ref-issuing document. */
+    tracker: SnapshotTracker;
+    /**
+     * Bounded console/network history. Attached when the browser is launched,
+     * so an event during the first navigation is still answerable afterwards.
+     * Optional so a fake dispatch context in a test need not build one.
+     */
+    journal?: SessionJournal;
+    /**
+     * The trace this session started, if any.
+     *
+     * The library owns whether a trace is running; this only remembers where it
+     * was told to write, which `Tracer` does not expose. Cleared on stop so the
+     * two cannot disagree about liveness — `browser.quit()` already aborts a
+     * running trace, so a dropped session leaves no dangling writer.
+     */
+    activeTrace?: {
+        name: string;
+        outDir: string;
+        startedAt: string;
+    } | null;
+    /**
+     * Network mocks this session installed.
+     *
+     * Tracked here because `NetworkInterceptor` keeps its intercept map private,
+     * so there is no public way to enumerate or cap what is active.
+     */
+    mocks?: Array<{
+        id: string;
+        pattern: string;
+        kind: 'mock' | 'block';
+        status?: number;
+    }>;
 }
+/**
+ * Drop everything that described the browser that just went away.
+ *
+ * All of this state is browser-owned: the ref registry lives in the page, the
+ * trace writer and the network intercepts die with the process, and the
+ * journal's listeners are bound to the old session. Keeping any of it across
+ * a `quit` made the session describe a browser that no longer existed —
+ * `trace status` reporting an aborted trace as running, `mock list` reporting
+ * intercepts that were gone, and the previous browser's console output
+ * appearing in the replacement's logs.
+ *
+ * Two counters deliberately survive, for the same reason: the ref high-water
+ * mark (numbers are never reissued) and the journal sequence (a cursor an
+ * agent still holds must not start matching new entries).
+ */
+export declare function resetBrowserOwnedState(ctx: DispatchContext): void;
+export declare function isMutating(cmd: string): boolean;
 export declare function dispatch(ctx: DispatchContext, cmd: string, args?: Record<string, unknown>): Promise<unknown>;
 //# sourceMappingURL=dispatcher.d.ts.map

package/dist/cli/dispatcher.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"dispatcher.d.ts","sourceRoot":"","sources":["../../src/cli/dispatcher.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,OAAO,EAAE,OAAO,EAAE,KAAK,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAMhE,2EAA2E;AAC3E,MAAM,WAAW,aAAa;IAC5B,+DAA+D;IAC/D,GAAG,IAAI,OAAO,CAAC,OAAO,CAAC,CAAC;IACxB,2EAA2E;IAC3E,IAAI,IAAI,OAAO,GAAG,IAAI,CAAC;IACvB,iDAAiD;IACjD,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACxB;AAED,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC,GAAG,aAAa,CAgBjF;AAiDD,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,aAAa,CAAC;IACtB,aAAa,EAAE,aAAa,CAAC;CAC9B;AAED,wBAAsB,QAAQ,CAC5B,GAAG,EAAE,eAAe,EACpB,GAAG,EAAE,MAAM,EACX,IAAI,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,GACjC,OAAO,CAAC,OAAO,CAAC,CA2TlB"}
+{"version":3,"file":"dispatcher.d.ts","sourceRoot":"","sources":["../../src/cli/dispatcher.ts"],"names":[],"mappings":"AAcA,OAAO,EAAE,OAAO,EAAE,KAAK,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAIhE,OAAO,EAKL,eAAe,EAChB,MAAM,eAAe,CAAC;AAEvB,OAAO,KAAK,EAAE,cAAc,EAAe,MAAM,cAAc,CAAC;AAehE,2EAA2E;AAC3E,MAAM,WAAW,aAAa;IAC5B,+DAA+D;IAC/D,GAAG,IAAI,OAAO,CAAC,OAAO,CAAC,CAAC;IACxB,2EAA2E;IAC3E,IAAI,IAAI,OAAO,GAAG,IAAI,CAAC;IACvB,iDAAiD;IACjD,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACxB;AAED,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC,GAAG,aAAa,CA+BjF;AAkJD,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,aAAa,CAAC;IACtB,aAAa,EAAE,aAAa,CAAC;IAC7B,2EAA2E;IAC3E,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,mEAAmE;IACnE,OAAO,EAAE,eAAe,CAAC;IACzB;;;;OAIG;IACH,OAAO,CAAC,EAAE,cAAc,CAAC;IACzB;;;;;;;OAOG;IACH,WAAW,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;IACzE;;;;;OAKG;IACH,KAAK,CAAC,EAAE,KAAK,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACzF;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,eAAe,GAAG,IAAI,CAMjE;AAkBD,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAE/C;AAiLD,wBAAsB,QAAQ,CAC5B,GAAG,EAAE,eAAe,EACpB,GAAG,EAAE,MAAM,EACX,IAAI,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,GACjC,OAAO,CAAC,OAAO,CAAC,CA86BlB"}