@sapiom/harness 0.8.9 → 0.10.0

package/dist/core/workspace-watcher.js

@@ -28,23 +28,66 @@
  * The fallback walk is async (fs/promises) to avoid blocking the event loop
  * on a wide cwd — the poll interval is longer than the watch debounce,
  * so a filesystem event via the watcher is still the fast path.
+ *
+ * Both walks run core/agent-project-discovery.ts's shared bounded traversal, so
+ * "which directories a scan of this root covers" has one definition here and in
+ * the workflow registry. The fingerprint's budget is deliberately the tighter of
+ * the two — see AGENT_PROJECT_WATCH_MAX_NODES.
  */
 import * as fs from "node:fs";
-import * as fsp from "node:fs/promises";
 import * as path from "node:path";
-import { AGENT_PROJECT_SCAN_MAX_DEPTH, inspectAgentProjectMarker, inspectAgentProjectMarkerSync, isAgentProjectScanIgnoredDir, } from "./agent-project-discovery.js";
+import { AGENT_PROJECT_WATCH_MAX_NODES, AgentProjectScanBudget, inspectAgentProjectMarker, inspectAgentProjectMarkerSync, isAgentProjectScanIgnoredDir, walkAgentProjectTree, walkAgentProjectTreeAsync, } from "./agent-project-discovery.js";
 const DEBOUNCE_MS = 250;
 /** Longer than the watch debounce — the watcher path is the fast signal;
  *  the poll is just a backstop for platforms without recursive fs.watch. */
 const POLL_INTERVAL_MS = 2000;
 const UNREADABLE_FINGERPRINT = "<unreadable>";
-function isConfirmedMissing(error) {
-    const code = error.code;
-    return code === "ENOENT" || code === "ENOTDIR";
-}
+/** Sentinel for "the node budget stopped this walk at depth N" — see
+ *  addTruncatedFingerprint. */
+const TRUNCATED_FINGERPRINT = "<truncated>";
 function addUnreadableFingerprint(fingerprints, dir) {
     fingerprints.push(`${dir}\0${UNREADABLE_FINGERPRINT}`);
 }
+/** A fresh watch budget — tighter than a registry scan's, because this walk is
+ *  synchronous and re-runs on the debounce after every save. */
+function watchBudget() {
+    return new AgentProjectScanBudget({ maxNodes: AGENT_PROJECT_WATCH_MAX_NODES });
+}
+/**
+ * One sentinel, keyed by root and the depth the node budget cut at, when a walk
+ * did not cover the whole tree.
+ *
+ * It is one entry rather than one per unvisited directory for two reasons: the
+ * unvisited frontier can be tens of thousands of directories on a real root,
+ * and the cut depth is the only thing about it that is *stable*. The walk is
+ * breadth-first over sorted entries, so the cut lands in the same place on
+ * every pass over an unchanged tree, and the fingerprint stays put instead of
+ * flapping and rescanning the workspace forever.
+ */
+function addTruncatedFingerprint(fingerprints, root, budget) {
+    if (!budget.truncated)
+        return;
+    fingerprints.push(`${root}\0${TRUNCATED_FINGERPRINT}@${budget.truncatedAtDepth}`);
+}
+/**
+ * Classifies one directory for the fingerprint, shared by the sync and async
+ * walks so they cannot disagree. Returns what the walk should do next.
+ */
+function fingerprintDirectory(markerDirs, dir, markerResult) {
+    if (markerResult.status === "valid") {
+        markerDirs.push(`${dir}\0${JSON.stringify(markerResult.marker)}`);
+        return "stop";
+    }
+    // Preserve "temporarily unreadable" as a distinct state. If it collapsed
+    // to the same fingerprint as an absent/invalid project, a quick
+    // unreadable -> invalid transition could be swallowed by the debounce and
+    // leave a stale workflow in the registry until some later filesystem event.
+    if (markerResult.status === "unreadable") {
+        addUnreadableFingerprint(markerDirs, dir);
+        return "stop";
+    }
+    return "descend";
+}
 function firstSegmentIgnored(relPath) {
     for (const segment of relPath.split(path.sep)) {
         if (segment && isAgentProjectScanIgnoredDir(segment))
@@ -54,90 +97,45 @@ function firstSegmentIgnored(relPath) {
 }
 /**
  * Fingerprint of the set of workflow-marker directories under `root` (sorted,
- * bounded depth, ignored subtrees skipped), plus opaque sentinels for subtrees
- * that are temporarily unreadable. Changes when a workflow is added, removed,
- * renamed, or crosses that unreadable boundary — not when unrelated readable
+ * bounded by depth AND by directories visited, ignored subtrees skipped), plus
+ * opaque sentinels for subtrees that are temporarily unreadable or that the
+ * node budget kept the walk out of. Changes when a workflow is added, removed,
+ * renamed, or crosses one of those boundaries — not when unrelated readable
  * files are edited. Exported for direct testing.
  *
- * The synchronous form is retained for callers that need an immediate
- * baseline at construction time (before async I/O is possible). The
- * polling fallback uses the async form to avoid blocking the event loop on
- * a wide directory tree.
+ * The synchronous form remains for the session watcher, whose constructor
+ * requires an immediate baseline. Project-graph watchers use the async form
+ * for startup, native-event checks, and polling so a wide Project never walks
+ * synchronously on the server loop.
+ *
+ * `budget` is injectable so a benchmark can read the directories visited off
+ * the same object the walk spends, and so a test can force truncation. Pass the
+ * SAME limits to both forms: the two produce identical fingerprints on one tree
+ * only when their bounds match, and SessionWorkspaceWatcher compares a sync
+ * baseline against an async poll result.
  */
-export function snapshotWorkspaceWorkflows(root) {
+export function snapshotWorkspaceWorkflows(root, budget = watchBudget()) {
     const markerDirs = [];
-    const walk = (dir, depth) => {
-        if (depth > AGENT_PROJECT_SCAN_MAX_DEPTH)
-            return;
-        // Preserve "temporarily unreadable" as a distinct state. If it collapsed
-        // to the same fingerprint as an absent/invalid project, a quick
-        // unreadable -> invalid transition could be swallowed by the debounce and
-        // leave a stale workflow in the registry until some later filesystem event.
-        const markerResult = inspectAgentProjectMarkerSync(dir);
-        if (markerResult.status === "valid") {
-            markerDirs.push(`${dir}\0${JSON.stringify(markerResult.marker)}`);
-            return;
-        }
-        if (markerResult.status === "unreadable") {
-            addUnreadableFingerprint(markerDirs, dir);
-            return;
-        }
-        let entries;
-        try {
-            entries = fs.readdirSync(dir, { withFileTypes: true });
-        }
-        catch (error) {
-            if (!isConfirmedMissing(error)) {
-                addUnreadableFingerprint(markerDirs, dir);
-            }
-            return;
-        }
-        for (const entry of entries) {
-            if (!entry.isDirectory() || isAgentProjectScanIgnoredDir(entry.name))
-                continue;
-            walk(path.join(dir, entry.name), depth + 1);
-        }
-    };
-    walk(root, 0);
+    walkAgentProjectTree(root, {
+        onDirectory: (dir) => fingerprintDirectory(markerDirs, dir, inspectAgentProjectMarkerSync(dir)),
+        onUnreadable: (dir) => addUnreadableFingerprint(markerDirs, dir),
+    }, budget);
+    addTruncatedFingerprint(markerDirs, path.resolve(root), budget);
     return markerDirs.sort().join("|");
 }
 /**
- * Async variant used by the polling fallback — yields between directories so
- * a wide workspace can't stutter the event loop on platforms without recursive
- * fs.watch. Produces the same fingerprint as the sync version. Exported for
- * direct testing.
+ * Async variant for graph watcher baselines/event checks and polling
+ * fallbacks — yields between directories so a wide workspace cannot stutter
+ * the event loop. Produces the same fingerprint as the sync version. Exported
+ * for direct testing.
  */
-export async function snapshotWorkspaceWorkflowsAsync(root) {
+export async function snapshotWorkspaceWorkflowsAsync(root, budget = watchBudget()) {
     const markerDirs = [];
-    const walk = async (dir, depth) => {
-        if (depth > AGENT_PROJECT_SCAN_MAX_DEPTH)
-            return;
-        const markerResult = await inspectAgentProjectMarker(dir);
-        if (markerResult.status === "valid") {
-            markerDirs.push(`${dir}\0${JSON.stringify(markerResult.marker)}`);
-            return;
-        }
-        if (markerResult.status === "unreadable") {
-            addUnreadableFingerprint(markerDirs, dir);
-            return;
-        }
-        let entries;
-        try {
-            entries = await fsp.readdir(dir, { withFileTypes: true });
-        }
-        catch (error) {
-            if (!isConfirmedMissing(error)) {
-                addUnreadableFingerprint(markerDirs, dir);
-            }
-            return;
-        }
-        for (const entry of entries) {
-            if (!entry.isDirectory() || isAgentProjectScanIgnoredDir(entry.name))
-                continue;
-            await walk(path.join(dir, entry.name), depth + 1);
-        }
-    };
-    await walk(root, 0);
+    await walkAgentProjectTreeAsync(root, {
+        onDirectory: async (dir) => fingerprintDirectory(markerDirs, dir, await inspectAgentProjectMarker(dir)),
+        onUnreadable: (dir) => addUnreadableFingerprint(markerDirs, dir),
+    }, budget);
+    addTruncatedFingerprint(markerDirs, path.resolve(root), budget);
     return markerDirs.sort().join("|");
 }
 /** One session's workspace watcher. */

package/dist/core/workspace-watcher.js.map

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

package/dist/index.d.ts

@@ -3,6 +3,7 @@
  * interface; this export exists so other packages can reuse the contract.
  */
 export * from "./shared/types.js";
+export type { WorkspaceScopeSummary } from "./shared/system-graph.js";
 export { AGENT_STUDIO_PRODUCT_NAME } from "./shared/branding.js";
 export { HarnessError, UnknownSessionError, SessionNotReadyError, SessionNotResumeableError, SessionAlreadyLiveError, AdapterNotFoundError, ExternalHarnessError, SpawnTargetError, } from "./core/errors.js";
 export { listHarnessAdapters, getHarnessAdapter, createHarnessAdapterRegistry, UnknownHarnessAdapterError, } from "./core/adapters/registry.js";

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,cAAc,mBAAmB,CAAC;AAClC,OAAO,EAAE,yBAAyB,EAAE,MAAM,sBAAsB,CAAC;AACjE,OAAO,EACL,YAAY,EACZ,mBAAmB,EACnB,oBAAoB,EACpB,yBAAyB,EACzB,uBAAuB,EACvB,oBAAoB,EACpB,oBAAoB,EACpB,gBAAgB,GACjB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EACL,mBAAmB,EACnB,iBAAiB,EACjB,4BAA4B,EAC5B,0BAA0B,GAC3B,MAAM,6BAA6B,CAAC;AACrC,YAAY,EACV,kBAAkB,EAClB,gBAAgB,EAChB,kBAAkB,EAClB,0BAA0B,EAC1B,0BAA0B,GAC3B,MAAM,4BAA4B,CAAC;AAUpC,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,YAAY,EAAE,aAAa,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AAC7E,OAAO,EACL,SAAS,EACT,kBAAkB,EAClB,sBAAsB,EACtB,qBAAqB,GACtB,MAAM,iBAAiB,CAAC;AACzB,YAAY,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AACpD,OAAO,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC;AACpD,YAAY,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AACrD,OAAO,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAC3D,OAAO,EAAE,2BAA2B,EAAE,MAAM,2BAA2B,CAAC;AAGxE,OAAO,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAC5D,YAAY,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAI1D,OAAO,EAAE,uBAAuB,EAAE,MAAM,gCAAgC,CAAC;AACzE,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,cAAc,mBAAmB,CAAC;AAClC,YAAY,EAAE,qBAAqB,EAAE,MAAM,0BAA0B,CAAC;AACtE,OAAO,EAAE,yBAAyB,EAAE,MAAM,sBAAsB,CAAC;AACjE,OAAO,EACL,YAAY,EACZ,mBAAmB,EACnB,oBAAoB,EACpB,yBAAyB,EACzB,uBAAuB,EACvB,oBAAoB,EACpB,oBAAoB,EACpB,gBAAgB,GACjB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EACL,mBAAmB,EACnB,iBAAiB,EACjB,4BAA4B,EAC5B,0BAA0B,GAC3B,MAAM,6BAA6B,CAAC;AACrC,YAAY,EACV,kBAAkB,EAClB,gBAAgB,EAChB,kBAAkB,EAClB,0BAA0B,EAC1B,0BAA0B,GAC3B,MAAM,4BAA4B,CAAC;AAUpC,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,YAAY,EAAE,aAAa,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AAC7E,OAAO,EACL,SAAS,EACT,kBAAkB,EAClB,sBAAsB,EACtB,qBAAqB,GACtB,MAAM,iBAAiB,CAAC;AACzB,YAAY,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AACpD,OAAO,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC;AACpD,YAAY,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AACrD,OAAO,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAC3D,OAAO,EAAE,2BAA2B,EAAE,MAAM,2BAA2B,CAAC;AAGxE,OAAO,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAC5D,YAAY,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAI1D,OAAO,EAAE,uBAAuB,EAAE,MAAM,gCAAgC,CAAC;AACzE,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,cAAc,mBAAmB,CAAC;AAClC,OAAO,EAAE,yBAAyB,EAAE,MAAM,sBAAsB,CAAC;AACjE,OAAO,EACL,YAAY,EACZ,mBAAmB,EACnB,oBAAoB,EACpB,yBAAyB,EACzB,uBAAuB,EACvB,oBAAoB,EACpB,oBAAoB,EACpB,gBAAgB,GACjB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EACL,mBAAmB,EACnB,iBAAiB,EACjB,4BAA4B,EAC5B,0BAA0B,GAC3B,MAAM,6BAA6B,CAAC;AASrC,8EAA8E;AAC9E,+EAA+E;AAC/E,kFAAkF;AAClF,mFAAmF;AACnF,6EAA6E;AAC7E,8EAA8E;AAC9E,+EAA+E;AAC/E,iEAAiE;AACjE,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAEhD,OAAO,EACL,SAAS,EACT,kBAAkB,EAClB,sBAAsB,EACtB,qBAAqB,GACtB,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC;AAEpD,OAAO,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAC3D,OAAO,EAAE,2BAA2B,EAAE,MAAM,2BAA2B,CAAC;AACxE,6EAA6E;AAC7E,8EAA8E;AAC9E,OAAO,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAE5D,+EAA+E;AAC/E,+EAA+E;AAC/E,gFAAgF;AAChF,OAAO,EAAE,uBAAuB,EAAE,MAAM,gCAAgC,CAAC;AACzE,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,cAAc,mBAAmB,CAAC;AAElC,OAAO,EAAE,yBAAyB,EAAE,MAAM,sBAAsB,CAAC;AACjE,OAAO,EACL,YAAY,EACZ,mBAAmB,EACnB,oBAAoB,EACpB,yBAAyB,EACzB,uBAAuB,EACvB,oBAAoB,EACpB,oBAAoB,EACpB,gBAAgB,GACjB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EACL,mBAAmB,EACnB,iBAAiB,EACjB,4BAA4B,EAC5B,0BAA0B,GAC3B,MAAM,6BAA6B,CAAC;AASrC,8EAA8E;AAC9E,+EAA+E;AAC/E,kFAAkF;AAClF,mFAAmF;AACnF,6EAA6E;AAC7E,8EAA8E;AAC9E,+EAA+E;AAC/E,iEAAiE;AACjE,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAEhD,OAAO,EACL,SAAS,EACT,kBAAkB,EAClB,sBAAsB,EACtB,qBAAqB,GACtB,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC;AAEpD,OAAO,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAC3D,OAAO,EAAE,2BAA2B,EAAE,MAAM,2BAA2B,CAAC;AACxE,6EAA6E;AAC7E,8EAA8E;AAC9E,OAAO,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAE5D,+EAA+E;AAC/E,+EAA+E;AAC/E,gFAAgF;AAChF,OAAO,EAAE,uBAAuB,EAAE,MAAM,gCAAgC,CAAC;AACzE,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/server/agent-move.d.ts

@@ -0,0 +1,134 @@
+import { type Router as ExpressRouter } from "express";
+/** What actually performed the move — reported back so a caller (and the test)
+ *  can see which branch ran. */
+export type MoveKind = "git" | "rename";
+export interface AgentMoveResponse {
+    ok: true;
+    /** False for the silent no-op: `to` resolved to `from`, nothing happened. */
+    moved: boolean;
+    from: string;
+    to: string;
+    kind: MoveKind | null;
+}
+export interface AgentMoveDeps {
+    /**
+     * The registered agent at this absolute path, or null. Only a registered
+     * agent may be moved: the rail can only drag rows it renders, and the rows
+     * it renders come from this same cache.
+     */
+    resolveAgent: (agentPath: string) => {
+        name: string;
+        path: string;
+    } | null;
+    /**
+     * Every directory an agent may be dropped INTO: the project roots the studio
+     * knows about, plus the branching directories the Project axis renders
+     * between a root and an agent. `moveTargetDirs` below derives exactly that
+     * set from the two things the server already holds, so "a directory the rail
+     * can show" and "a directory this route will move into" are one list.
+     */
+    listMoveTargetDirs: () => string[] | Promise<string[]>;
+    /**
+     * Applied AFTER a successful move, before the response. The integrator's job:
+     * remap live session cwds that sat inside the moved tree, prune the registry
+     * of the path that no longer exists, rescan the destination, and broadcast
+     * `workflows.changed` so the rail re-derives the tree from the new path.
+     */
+    onMoved: (from: string, to: string) => Promise<void>;
+}
+/** Whether `child` IS `parent` or sits beneath it, on segment boundaries — so
+ *  `…/ads-v2` is never read as a child of `…/ads`. Node-side twin of the
+ *  browser's `paths.isWithinDir`; `path.relative` does the normalizing. */
+export declare function isWithinDir(parent: string, child: string): boolean;
+/**
+ * Every directory the Project axis can offer as a drop target, derived from the
+ * only two things the server holds: the roots the studio knows about and the
+ * agents the registry has found.
+ *
+ * This mirrors `web/src/lib/project-tree.ts` exactly, because it has to. That
+ * module tries each root, keeps the agents beneath it, and renders the path
+ * segments between them as directory rows; a row that exists there is a row a
+ * drag can land on, and nothing else is. So: each root, plus each directory
+ * between a root and an agent inside it.
+ *
+ * KNOWN GAP, deliberately: the rail also shows `pendingCwds` — a folder chosen
+ * for an agent that is still being created — and the server has no such list.
+ * Dropping into a project that exists only mid-creation is refused with the
+ * "directory the studio doesn't show" message until the folder lands in
+ * `recentDirs`, which is the next thing that happens to it. Refusing a rare
+ * drop is the right side to fail on for a route that renames user code.
+ */
+export declare function moveTargetDirs(roots: readonly string[], agentPaths: readonly string[]): string[];
+/**
+ * The path `p` becomes once `from` has moved to `to` — unchanged when `p` is
+ * not inside `from`.
+ *
+ * Everything under the moved directory travels with it, so a nested agent and a
+ * SESSION whose cwd sat inside the tree are remapped by the same rule. Without
+ * this a session keeps pointing at a directory that no longer exists.
+ */
+export declare function remapUnder(p: string, from: string, to: string): string;
+/**
+ * Rewrites every live session that sat inside the moved tree, IN PLACE, and
+ * returns how many changed.
+ *
+ * A function rather than a loop at the wiring site because this is the criterion
+ * "sessions whose cwd sat inside the moved directory follow it", and a rule that
+ * lives inside a route's callback cannot be tested. On disk the session's own
+ * process cwd follows the directory automatically (a cwd is an inode, not a
+ * string), so what has to be corrected is the RECORD — the path the studio shows,
+ * files under, and reboots the session at. Left stale, the session's project row
+ * points at a directory that no longer exists.
+ *
+ * `boundWorkflowPath` travels the same way: the binding names the agent's
+ * directory, and the agent just moved.
+ *
+ * In place, because the session manager owns these objects and hands out live
+ * references — `setBoundWorkflowPath` mutates them the same way.
+ */
+export declare function remapSessions(sessions: Array<{
+    cwd: string;
+    boundWorkflowPath?: string | null;
+}>, from: string, to: string): number;
+/**
+ * Whether git TRACKS anything inside `dir`.
+ *
+ * `ls-files` rather than `rev-parse --is-inside-work-tree`: a directory can sit
+ * inside a repo and be entirely gitignored (a scratch agent under a checkout's
+ * `tmp/`), and `git mv` refuses those. "Inside a repo" is the wrong question;
+ * "does git know about these files" is the one that predicts whether `git mv`
+ * can do the job. No repo at all, or git not installed, reads as untracked.
+ */
+export declare function isGitTracked(dir: string): Promise<boolean>;
+/**
+ * Moves the directory, preferring the tracked path.
+ *
+ * A `git mv` failure falls THROUGH to the plain rename rather than failing the
+ * request: the commonest reason is a destination outside this work tree (moving
+ * an agent out of a checkout is a legitimate move), and the untracked branch
+ * would have done exactly this anyway. What must never happen is a move that
+ * half-succeeds, and neither branch can do that — both are single operations.
+ */
+export declare function performMove(from: string, to: string): Promise<MoveKind>;
+/**
+ * The route's OWN refusal, from the filesystem rather than from a path list —
+ * a message when the move must not happen, null when it may.
+ *
+ * Ordered so the most specific truth wins: a destination inside the source is
+ * the move that destroys the thing being moved (`mv a a/b` relocates the
+ * destination along with the source and leaves nothing behind), and it is worth
+ * saying so rather than reporting whatever `stat` happens to find there.
+ */
+export declare function refuseMoveOnDisk(from: string, to: string): Promise<string | null>;
+/**
+ * POST /api/agents/move  { from, to } -> AgentMoveResponse
+ *
+ * 400 — a malformed or unregistered `from`, or a `to` that asks for a rename.
+ * 409 — a refusal, with the reason in `error` so the rail can show it verbatim:
+ * a destination inside the source, a destination the studio doesn't show, or
+ * anything `stat` finds already sitting there. 200 with `moved: false` — `to`
+ * resolved to `from`: the user let go somewhere harmless, and the SILENT no-op
+ * is a success, not a complaint.
+ */
+export declare function createAgentMoveRouter(deps: AgentMoveDeps): ExpressRouter;
+//# sourceMappingURL=agent-move.d.ts.map

package/dist/server/agent-move.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-move.d.ts","sourceRoot":"","sources":["../../src/server/agent-move.ts"],"names":[],"mappings":"AAgDA,OAAO,EAAU,KAAK,MAAM,IAAI,aAAa,EAAE,MAAM,SAAS,CAAC;AAI/D;gCACgC;AAChC,MAAM,MAAM,QAAQ,GAAG,KAAK,GAAG,QAAQ,CAAC;AAExC,MAAM,WAAW,iBAAiB;IAChC,EAAE,EAAE,IAAI,CAAC;IACT,6EAA6E;IAC7E,KAAK,EAAE,OAAO,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,QAAQ,GAAG,IAAI,CAAC;CACvB;AAED,MAAM,WAAW,aAAa;IAC5B;;;;OAIG;IACH,YAAY,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;IAC3E;;;;;;OAMG;IACH,kBAAkB,EAAE,MAAM,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IACvD;;;;;OAKG;IACH,OAAO,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CACtD;AAED;;2EAE2E;AAC3E,wBAAgB,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAGlE;AAgBD;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,cAAc,CAC5B,KAAK,EAAE,SAAS,MAAM,EAAE,EACxB,UAAU,EAAE,SAAS,MAAM,EAAE,GAC5B,MAAM,EAAE,CAwBV;AAED;;;;;;;GAOG;AACH,wBAAgB,UAAU,CAAC,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,MAAM,CAItE;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,aAAa,CAC3B,QAAQ,EAAE,KAAK,CAAC;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,iBAAiB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,CAAC,EACnE,IAAI,EAAE,MAAM,EACZ,EAAE,EAAE,MAAM,GACT,MAAM,CAcR;AAcD;;;;;;;;GAQG;AACH,wBAAsB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAGhE;AAED;;;;;;;;GAQG;AACH,wBAAsB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC,CAO7E;AAED;;;;;;;;GAQG;AACH,wBAAsB,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CA8BvF;AAED;;;;;;;;;GASG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,aAAa,GAAG,aAAa,CAiGxE"}