@sema-agent/core 1.279.0

package/dist/tools/worktree.js

@@ -0,0 +1,288 @@
+import { resolve } from "node:path";
+import { Type } from "typebox";
+import { defineTool } from "../core/tools.js";
+import { addWorktree, pruneWorktrees, WORKTREE_PARENT } from "../core/git-worktree-env.js";
+const ENTER_DESCRIPTION = "Use this tool ONLY when explicitly instructed to work in a worktree — either by the user directly, or by " +
+    "project instructions. This tool creates an isolated git worktree and switches the current session into it.\n" +
+    "\n" +
+    "## When to Use\n" +
+    "\n" +
+    '- The user explicitly says "worktree" (e.g., "start a worktree", "work in a worktree", "create a worktree", "use a worktree")\n' +
+    "- Project instructions direct you to work in a worktree for the current task\n" +
+    "\n" +
+    "## When NOT to Use\n" +
+    "\n" +
+    "- The user asks to create a branch, switch branches, or work on a different branch — use git commands instead\n" +
+    "- The user asks to fix a bug or work on a feature — use normal git workflow unless worktrees are explicitly " +
+    "requested by the user or project instructions\n" +
+    '- Never use this tool unless "worktree" is explicitly mentioned by the user or in project instructions\n' +
+    "\n" +
+    "## Behavior\n" +
+    "\n" +
+    `- Creates a detached worktree under \`${WORKTREE_PARENT}/\` in the repository root and switches the ` +
+    "session's working directory to it: subsequent Bash commands run there, and relative paths in " +
+    "Read/Edit/Write resolve against it.\n" +
+    '- `baseRef` picks the starting point: `"head"` (default) starts from the current local HEAD (unpushed ' +
+    'commits and current branch state present); `"fresh"` starts from the default branch tip ' +
+    "(origin's default branch when a remote exists, else local main/master).\n" +
+    "- Only one worktree session is tracked at a time: creating a NEW worktree (`name`) while one is active " +
+    "is refused — use ExitWorktree first (the unchanged worktree is removed; a changed one is kept and its " +
+    "path reported).\n" +
+    "- Pass `path` instead of `name` to switch the session into a worktree of this repository that already " +
+    "exists (it must appear in `git worktree list` and live under the task root). Switching with `path` also " +
+    "works while already in a worktree session — the previous worktree is left on disk, untouched, and only " +
+    "the new one is tracked for exit-time cleanup. ExitWorktree will not remove a worktree entered via `path`.\n" +
+    "- This is a working-directory switch, NOT a sandbox: file-access containment stays anchored at the " +
+    "original task root (the worktree lives under it), so paths outside the worktree but inside the task " +
+    "root remain reachable — do not rely on the worktree as an isolation boundary.\n" +
+    "- Requires a git repository — there is no VCS-agnostic fallback in this deployment.";
+const EXIT_DESCRIPTION = "Exit a worktree session created by EnterWorktree and return the session to the original working directory.\n" +
+    "\n" +
+    "## Scope\n" +
+    "\n" +
+    "This tool ONLY operates on worktrees created by EnterWorktree in this session. It will NOT touch:\n" +
+    "- Worktrees you created manually with `git worktree add`\n" +
+    "- Worktrees from a previous session (even if created by EnterWorktree then)\n" +
+    "- The directory you're in if EnterWorktree was never called\n" +
+    "\n" +
+    "If called outside an EnterWorktree session, the tool is a no-op: it reports that no worktree session is " +
+    "active and takes no action. Filesystem state is unchanged.\n" +
+    "\n" +
+    "## Behavior\n" +
+    "\n" +
+    "- Restores the session's working directory to where it was before EnterWorktree.\n" +
+    "- Default: if the worktree has NO changes (clean `git status`, no new commits), it is removed and " +
+    "pruned; if it HAS uncommitted files or new commits, it is KEPT on disk and its path reported so the " +
+    "work can be inspected or merged — nothing is discarded.\n" +
+    "- A worktree entered via EnterWorktree `path` (not created by it) is NEVER removed — exit only restores " +
+    "the working directory.\n" +
+    "- `keep: true` always keeps the worktree on disk, changed or not.\n" +
+    "- `discardChanges: true` removes the worktree even when it HAS uncommitted files or new commits — they " +
+    "are permanently discarded. Only set this when the work is confirmed disposable (a throwaway experiment, " +
+    "or the user asked to discard it); it cannot be combined with `keep: true`.\n" +
+    "- Once exited, EnterWorktree can be called again to create a fresh worktree.";
+const shq = (s) => `'${s.replace(/'/g, "'\\''")}'`;
+async function resolveBaseCommit(env, repoRoot, baseRef) {
+    const rev = async (ref) => {
+        const r = await env.exec(`git rev-parse --verify --quiet ${shq(`${ref}^{commit}`)}`, { cwd: repoRoot });
+        return r.ok && r.value.exitCode === 0 ? r.value.stdout.trim() : undefined;
+    };
+    if (baseRef === "head") {
+        const sha = await rev("HEAD");
+        return sha ? { sha, label: "HEAD" } : { error: "cannot resolve HEAD (empty repository with no commits?)" };
+    }
+    const sym = await env.exec("git symbolic-ref --quiet refs/remotes/origin/HEAD", { cwd: repoRoot });
+    if (sym.ok && sym.value.exitCode === 0) {
+        const branch = sym.value.stdout.trim().replace(/^refs\/remotes\//, "");
+        if (branch) {
+            const sha = await rev(branch);
+            if (sha)
+                return { sha, label: branch };
+        }
+    }
+    for (const candidate of ["main", "master"]) {
+        const sha = await rev(candidate);
+        if (sha)
+            return { sha, label: candidate };
+    }
+    const sha = await rev("HEAD");
+    return sha
+        ? { sha, label: "HEAD", note: " (no remote default branch or local main/master found — fell back to HEAD)" }
+        : { error: "cannot resolve a fresh base (no default branch and no HEAD)" };
+}
+export function createWorktreeTools(env, opts) {
+    const { repoRoot, cwdRef } = opts;
+    const session = opts.session ?? {};
+    const enter = defineTool({
+        name: "EnterWorktree",
+        description: ENTER_DESCRIPTION,
+        parameters: Type.Object({
+            name: Type.Optional(Type.String({
+                description: "Optional name for the new worktree (letters, digits, dots, underscores, dashes; other characters are sanitized). A random suffix is always appended. Generated if not provided. Mutually exclusive with `path`.",
+            })),
+            path: Type.Optional(Type.String({
+                description: "Path to an existing worktree of the current repository to switch into instead of creating a new one. Must appear in `git worktree list` for the current repo (and live under the task root). Mutually exclusive with `name`.",
+            })),
+            baseRef: Type.Optional(Type.Union([Type.Literal("fresh"), Type.Literal("head")], {
+                description: '"head" (default) bases the worktree on the current local HEAD; "fresh" bases it on the default branch tip (origin default branch, else local main/master).',
+            })),
+        }),
+        effect: "write",
+        execute: async (args) => {
+            const { name, path, baseRef } = args;
+            if (path !== undefined && name !== undefined) {
+                return "Error (EnterWorktree): `name` and `path` are mutually exclusive — `path` enters an existing worktree, `name` creates a new one.";
+            }
+            if (path !== undefined && baseRef !== undefined) {
+                return "Error (EnterWorktree): `baseRef` only applies when creating a new worktree — an existing worktree entered via `path` keeps whatever state it has.";
+            }
+            if (session.current && path === undefined) {
+                return (`Error (EnterWorktree): already in a worktree session (${session.current.worktreeDir}). ` +
+                    "Use ExitWorktree to leave it before creating a new worktree, or pass `path` to switch into an " +
+                    "existing worktree of this repository.");
+            }
+            const probe = await env.exec("git rev-parse --is-inside-work-tree", { cwd: repoRoot });
+            if (!probe.ok || probe.value.exitCode !== 0) {
+                const detail = probe.ok ? (probe.value.stderr || probe.value.stdout).trim().split("\n")[0] : String(probe.error);
+                return (`Error (EnterWorktree): the working directory ${repoRoot} is not a git repository` +
+                    `${detail ? ` (${detail})` : ""}. This deployment has no VCS-agnostic worktree extension point, ` +
+                    "so worktree isolation is unavailable here.");
+            }
+            if (path !== undefined) {
+                const candidate = resolve(cwdRef.current, path);
+                const top = await env.exec("git rev-parse --show-toplevel", { cwd: candidate });
+                if (!top.ok || top.value.exitCode !== 0) {
+                    return `Error (EnterWorktree): ${candidate} is not an accessible git worktree (cannot resolve its top-level directory).`;
+                }
+                const target = top.value.stdout.trim();
+                const list = await env.exec("git worktree list --porcelain", { cwd: repoRoot });
+                if (!list.ok || list.value.exitCode !== 0) {
+                    return "Error (EnterWorktree): could not read `git worktree list` for this repository.";
+                }
+                const registered = list.value.stdout
+                    .split("\n")
+                    .filter((l) => l.startsWith("worktree "))
+                    .map((l) => l.slice("worktree ".length).trim());
+                if (!registered.includes(target)) {
+                    return (`Error (EnterWorktree): ${target} is not a registered worktree of this repository ` +
+                        "(it does not appear in `git worktree list`).");
+                }
+                if (target === registered[0]) {
+                    return `Error (EnterWorktree): ${target} is the main working tree, not a linked worktree — nothing to enter.`;
+                }
+                if (target !== repoRoot && !target.startsWith(repoRoot.endsWith("/") ? repoRoot : `${repoRoot}/`)) {
+                    return (`Error (EnterWorktree): the worktree ${target} lives outside the task root ${repoRoot}; ` +
+                        "file containment stays anchored at the task root, so it cannot be entered from this session.");
+                }
+                const head = await env.exec("git rev-parse HEAD", { cwd: target });
+                if (!head.ok || head.value.exitCode !== 0) {
+                    return `Error (EnterWorktree): cannot resolve HEAD of the worktree ${target}.`;
+                }
+                const previous = session.current;
+                const originalCwd = previous ? previous.originalCwd : cwdRef.current;
+                session.current = { worktreeDir: target, originalCwd, baseSha: head.value.stdout.trim(), entered: true };
+                cwdRef.current = target;
+                return (`Switched into the existing worktree at ${target}${previous ? ` (the previous worktree at ${previous.worktreeDir} was left on disk, untouched)` : ""}. ` +
+                    "The session's working directory is now this worktree — subsequent commands and relative paths " +
+                    "operate there. Note this is a cwd switch, not a sandbox: file containment stays anchored at the " +
+                    "task root. ExitWorktree will restore the original directory but will NOT remove a worktree " +
+                    "entered via `path`.");
+            }
+            const base = await resolveBaseCommit(env, repoRoot, baseRef ?? "head");
+            if ("error" in base)
+                return `Error (EnterWorktree): ${base.error}.`;
+            let createdDir;
+            try {
+                const { worktreeDir } = await addWorktree(env, {
+                    repoRoot,
+                    sessionId: name ?? "worktree",
+                    commit: base.sha,
+                    rootEnvAt: (dir) => Object.create(env, {
+                        cwd: { value: dir, configurable: true },
+                        destroy: { value: undefined, writable: true, configurable: true },
+                    }),
+                });
+                createdDir = worktreeDir;
+            }
+            catch (e) {
+                return `Error (EnterWorktree): ${e instanceof Error ? e.message : String(e)}`;
+            }
+            session.current = {
+                worktreeDir: createdDir,
+                originalCwd: cwdRef.current,
+                baseSha: base.sha,
+            };
+            cwdRef.current = createdDir;
+            return (`Created worktree at ${createdDir} (base: ${base.label}${base.note ?? ""}). ` +
+                "The session's working directory is now the worktree — subsequent commands and relative paths " +
+                "operate there. Note this is a cwd switch, not a sandbox: file containment stays anchored at the " +
+                "task root, so the rest of the repository remains reachable. " +
+                "Use ExitWorktree to leave (an unchanged worktree is removed; a changed one is kept).");
+        },
+    });
+    const exit = defineTool({
+        name: "ExitWorktree",
+        description: EXIT_DESCRIPTION,
+        parameters: Type.Object({
+            keep: Type.Optional(Type.Boolean({
+                description: "true = always keep the worktree on disk. Default: keep only when it has uncommitted files or new commits; remove when unchanged.",
+            })),
+            discardChanges: Type.Optional(Type.Boolean({
+                description: "true = remove the worktree even when it has uncommitted files or new commits, permanently discarding them. Default false: a changed worktree is kept and its changes listed. Cannot be combined with `keep: true`.",
+            })),
+        }),
+        effect: "write",
+        execute: async (args) => {
+            const { keep, discardChanges } = args;
+            if (keep === true && discardChanges === true) {
+                return "Error (ExitWorktree): `keep: true` and `discardChanges: true` contradict each other — pick one.";
+            }
+            if (!session.current) {
+                return ("No-op: there is no active EnterWorktree session to exit. This tool only operates on the " +
+                    "worktree created by EnterWorktree in this session; no filesystem changes were made.");
+            }
+            const active = session.current;
+            session.current = undefined;
+            let restoredTo = active.originalCwd;
+            let restoreNote = "";
+            const origThere = await env.exists(active.originalCwd);
+            if (origThere.ok && !origThere.value) {
+                restoredTo = repoRoot;
+                restoreNote = ` (the original directory ${active.originalCwd} no longer exists — fell back to the repository root)`;
+            }
+            cwdRef.current = restoredTo;
+            if (active.entered) {
+                const discardNote = discardChanges === true ? " (`discardChanges` does not apply to a worktree this session did not create)" : "";
+                return (`Exited the worktree session; working directory restored to ${restoredTo}${restoreNote}. ` +
+                    `The worktree at ${active.worktreeDir} was entered via \`path\` (not created by this session) and ` +
+                    `was left on disk, untouched${discardNote}.`);
+            }
+            const wtThere = await env.exists(active.worktreeDir);
+            if (wtThere.ok && !wtThere.value) {
+                await pruneWorktrees(env, repoRoot).catch(() => undefined);
+                return (`Exited the worktree session; working directory restored to ${restoredTo}${restoreNote}. ` +
+                    `The worktree at ${active.worktreeDir} was already gone from disk (removed externally, not by this ` +
+                    "session — any uncommitted work in it is lost); stale git worktree metadata was pruned.");
+            }
+            let changed = true;
+            let changeDetail = "could not verify the worktree state — keeping it to be safe";
+            const status = await env.exec("git status --porcelain", { cwd: active.worktreeDir });
+            if (status.ok && status.value.exitCode === 0) {
+                const dirtyFiles = status.value.stdout.split("\n").filter((l) => l.trim() !== "").length;
+                const ahead = await env.exec(`git rev-list --count ${shq(`${active.baseSha}..HEAD`)}`, { cwd: active.worktreeDir });
+                const commits = ahead.ok && ahead.value.exitCode === 0 ? parseInt(ahead.value.stdout.trim(), 10) || 0 : -1;
+                if (commits >= 0) {
+                    changed = dirtyFiles > 0 || commits > 0;
+                    const parts = [];
+                    if (dirtyFiles > 0)
+                        parts.push(`${dirtyFiles} uncommitted ${dirtyFiles === 1 ? "file" : "files"}`);
+                    if (commits > 0)
+                        parts.push(`${commits} new ${commits === 1 ? "commit" : "commits"}`);
+                    changeDetail = parts.join(" and ");
+                }
+            }
+            if (keep === true || (changed && discardChanges !== true)) {
+                const why = keep === true ? "keep was requested" : `it has ${changeDetail}`;
+                return (`Exited the worktree session; working directory restored to ${restoredTo}${restoreNote}. ` +
+                    `The worktree was KEPT at ${active.worktreeDir} (${why}) — inspect or merge it there, and remove it ` +
+                    "later with `git worktree remove` if no longer needed.");
+            }
+            await env.exec(`git worktree remove --force ${shq(active.worktreeDir)}`, { cwd: repoRoot }).catch(() => undefined);
+            await pruneWorktrees(env, repoRoot).catch(() => undefined);
+            const stillThere = await env.exists(active.worktreeDir);
+            const detailForDiscard = changeDetail.startsWith("could not verify")
+                ? "changes that could not be enumerated"
+                : changeDetail;
+            const stateClause = changed ? `had ${detailForDiscard} (discarded — discardChanges was set)` : "had no changes";
+            if (stillThere.ok && stillThere.value) {
+                return (`Exited the worktree session; working directory restored to ${restoredTo}${restoreNote}. ` +
+                    `The worktree at ${active.worktreeDir} ${changed ? "was marked for discard" : "had no changes"} but could NOT be removed — it is still on disk; ` +
+                    "remove it manually with `git worktree remove --force` if no longer needed.");
+            }
+            return (`Exited the worktree session; working directory restored to ${restoredTo}${restoreNote}. ` +
+                `The worktree at ${active.worktreeDir} ${stateClause} and was removed.`);
+        },
+    });
+    return [enter, exit];
+}
+//# sourceMappingURL=worktree.js.map

package/dist/tools/worktree.js.map

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

package/package.json

@@ -0,0 +1,68 @@
+{
+  "name": "@sema-agent/core",
+  "version": "1.279.0",
+  "description": "Stateless, task-oriented AI agent core",
+  "type": "module",
+  "license": "BUSL-1.1",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/clayboby/sema-core.git"
+  },
+  "keywords": [
+    "ai",
+    "agent",
+    "llm",
+    "tools",
+    "mcp",
+    "openai-compatible",
+    "tidb",
+    "stateless"
+  ],
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "bin": {
+    "sema-tb": "dist/bin/sema-tb.js"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    },
+    "./bench": {
+      "types": "./dist/bench/metrics.d.ts",
+      "default": "./dist/bench/metrics.js"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "NOTICE.md",
+    "LICENSE"
+  ],
+  "engines": {
+    "node": ">=20.3.0"
+  },
+  "scripts": {
+    "build": "rm -rf dist && tsc -p tsconfig.build.json",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "smoke": "tsx src/examples/smoke.ts",
+    "eval": "tsx eval/run.ts",
+    "prepare": "npm run build",
+    "prepublishOnly": "npm run build && npm run test"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "1.29.0",
+    "typebox": "1.1.39"
+  },
+  "devDependencies": {
+    "@types/node": "22.10.2",
+    "@types/pg": "^8.20.0",
+    "pg": "^8.22.0",
+    "pg-mem": "^3.0.14",
+    "tsx": "4.19.2",
+    "typescript": "5.7.2",
+    "vitest": "^2.1.8"
+  }
+}