aicodeman 1.41.0 → 1.42.0

package/dist/web/routes/worktree-routes.js

@@ -0,0 +1,220 @@
+/**
+ * @fileoverview Git worktrees of a local case (src/git-worktrees.ts holds the rules):
+ *
+ *   GET    /api/cases/:name/worktrees             the case repository's worktrees, which of them
+ *                                                 Codeman manages, and the live sessions in each
+ *   POST   /api/cases/:name/worktrees             create `<case>/.claude/worktrees/<name>` on a
+ *                                                 new branch (`{ name, branch?, base? }`)
+ *   DELETE /api/cases/:name/worktrees/:worktree   `git worktree remove` WITHOUT --force, refused
+ *                                                 while a live session runs inside; optional
+ *                                                 `?deleteBranch=true` is `git branch -d`
+ *
+ * A session starts in a worktree through the EXISTING create paths, never a new spawn path here:
+ * `POST /api/quick-start` with `worktree: <name>` (validated against this module's rules), or
+ * `POST /api/sessions` with the worktree path as `workingDir`.
+ *
+ * The case is resolved the way quick-start resolves it: an owned remote or Docker case is refused
+ * with a 400 (git must never run on the host over a Docker workspace, and a remote case's folder
+ * is on another machine); a linked case resolves for admins only in multi-user mode; anything else
+ * is the caller's own case space, confined with `isWorkingDirAllowed`. The case folder is probed
+ * BOUNDED (#516): a case on a network mount that stopped answering is a 422, never a 404.
+ *
+ * Statuses are set explicitly from the error code, so the route answers the same with or without
+ * the server's envelope hook.
+ */
+import { ApiErrorCode, createErrorResponse, httpStatusForErrorCode } from '../../types.js';
+import { readDockerCases } from '../../docker-hosts.js';
+import { readRemoteCases } from '../../remote-hosts.js';
+import { dataPath, getDataDir } from '../../config/instance.js';
+import { isMultiUserMode } from '../../config/multiuser.js';
+import { listClis } from '../../config/cli-registry/registry.js';
+import { agentSkillDir } from '../../hooks-config.js';
+import { describeUnknownPath, probePathKind } from '../../utils/index.js';
+import { createCaseWorktree, isPathWithin, listCaseWorktrees, managedWorktreesDir, removeCaseWorktree, resolveCaseRepository, respellUnder, worktreeNameError, } from '../../git-worktrees.js';
+import { CreateWorktreeSchema, RemoveWorktreeQuerySchema } from '../schemas.js';
+import { canAccessOwned, getAuthUser, isAdmin, isWorkingDirAllowed, parseBody, readJsonConfig, resolveCasesDir, validatePathWithinBase, } from '../route-helpers.js';
+const SAFE_CASE_NAME = /^[a-zA-Z0-9_-]+$/;
+/** Host paths of every Docker case workspace: git never runs for a case at or inside one. */
+const defaultDockerWorkspaces = async () => (await readDockerCases(getDataDir()).catch(() => [])).map((c) => c.hostWorkspacePath).filter(Boolean);
+/**
+ * Every workspace skills folder a session of some registry CLI gets Codeman's agent skill in
+ * (`capabilities.agentSkillDir`), read from the registry at call time as data, never by CLI id.
+ */
+const registryAgentSkillDirs = () => {
+    const dirs = new Set();
+    for (const cli of listClis()) {
+        const dir = agentSkillDir(cli.capabilities);
+        if (dir)
+            dirs.add(dir);
+    }
+    return [...dirs];
+};
+function failWith(reply, code, message) {
+    reply.code(httpStatusForErrorCode(code));
+    return createErrorResponse(code, message);
+}
+function failFrom(reply, failure) {
+    return failWith(reply, ApiErrorCode[failure.code], failure.message);
+}
+/**
+ * The LOCAL folder of case `name` for this caller, or the refusal. Mirrors quick-start's
+ * resolution (remote, then Docker, then linked, then the caller's case space) so a name means
+ * the same case here as it does to the Run button.
+ */
+async function resolveLocalCaseFolder(req, name) {
+    if (!SAFE_CASE_NAME.test(name)) {
+        return { ok: false, code: ApiErrorCode.INVALID_INPUT, message: 'Invalid case name' };
+    }
+    const user = getAuthUser(req);
+    const configDir = getDataDir();
+    // Ownership folded into the match, as quick-start does: a foreign same-named remote/Docker
+    // case falls through to the caller's own local case instead of shadowing it.
+    if ((await readRemoteCases(configDir)).some((c) => c.name === name && canAccessOwned(user, c.owner))) {
+        return {
+            ok: false,
+            code: ApiErrorCode.INVALID_INPUT,
+            message: 'Worktrees are not available for remote (SSH) cases: the repository is on another machine.',
+        };
+    }
+    if ((await readDockerCases(configDir)).some((c) => c.name === name && canAccessOwned(user, c.owner))) {
+        return {
+            ok: false,
+            code: ApiErrorCode.INVALID_INPUT,
+            message: 'Worktrees are not available for Docker cases: a container can write to the workspace, and git would run its hooks and filters on this machine.',
+        };
+    }
+    const linkedCases = await readJsonConfig(dataPath('linked-cases.json'), 'linked cases', {});
+    // Linked cases carry no owner: only admins resolve them in multi-user mode.
+    const linked = !isMultiUserMode() || isAdmin(req) ? linkedCases[name] : undefined;
+    const casePath = linked || validatePathWithinBase(name, resolveCasesDir(user));
+    if (!casePath)
+        return { ok: false, code: ApiErrorCode.INVALID_INPUT, message: 'Invalid case path' };
+    if (!isWorkingDirAllowed(user, casePath)) {
+        return { ok: false, code: ApiErrorCode.FORBIDDEN, message: 'case path is outside your workspace' };
+    }
+    const kind = await probePathKind(casePath, { pastCap: true });
+    if (kind === 'unknown') {
+        return {
+            ok: false,
+            code: ApiErrorCode.OPERATION_FAILED,
+            message: describeUnknownPath('Case folder', casePath, { pastCap: true }),
+        };
+    }
+    if (kind === 'absent')
+        return { ok: false, code: ApiErrorCode.NOT_FOUND, message: `Case "${name}" not found` };
+    if (kind !== 'directory')
+        return { ok: false, code: ApiErrorCode.INVALID_INPUT, message: 'Case path is not a folder' };
+    return { ok: true, casePath };
+}
+/**
+ * Live local sessions, with the folder each runs in as the case's repository spells it
+ * (`respellUnder`: a folder named through the case's own path, which can run through a symlink,
+ * is moved onto the repository's real top level, where git lists the worktrees). Remote sessions
+ * have no local folder.
+ */
+function liveLocalSessions(ctx, casePath, repoRoot) {
+    const out = [];
+    for (const session of ctx.sessions.values()) {
+        if (session.remote || !session.workingDir || !session.workingDir.startsWith('/'))
+            continue;
+        const dir = respellUnder(session.workingDir, casePath, repoRoot);
+        out.push({ id: session.id, name: session.name, owner: session.owner, dir });
+    }
+    return out;
+}
+export function registerWorktreeRoutes(app, ctx, deps = {}) {
+    const dockerWorkspaces = deps.dockerWorkspaces ?? defaultDockerWorkspaces;
+    /**
+     * Case folder → its repository, or the refusal already rendered. `casePath` is the folder as
+     * the case resolves it (possibly through a symlink); `repo.repoRoot` is its real path.
+     */
+    async function caseRepository(req, reply, name) {
+        const folder = await resolveLocalCaseFolder(req, name);
+        if (!folder.ok)
+            return { ok: false, fail: failWith(reply, folder.code, folder.message) };
+        const dockerRoots = await dockerWorkspaces();
+        const repo = await resolveCaseRepository(folder.casePath, { git: deps.git, dockerWorkspaces: dockerRoots });
+        if (!repo.ok)
+            return { ok: false, fail: failFrom(reply, repo) };
+        return { ok: true, repo: repo.repo, casePath: folder.casePath, dockerRoots };
+    }
+    app.get('/api/cases/:name/worktrees', async (req, reply) => {
+        const { name } = req.params;
+        const resolved = await caseRepository(req, reply, name);
+        if (!resolved.ok)
+            return resolved.fail;
+        const { repo, casePath } = resolved;
+        const listed = await listCaseWorktrees(repo, { git: deps.git });
+        if (!listed.ok)
+            return failFrom(reply, listed);
+        // Each live session belongs to the DEEPEST worktree holding its folder, so a session in a
+        // managed worktree is not also counted against the main checkout that contains it.
+        const user = getAuthUser(req);
+        const rows = listed.worktrees.map((wt) => ({ ...wt, sessionCount: 0, sessions: [] }));
+        for (const session of liveLocalSessions(ctx, casePath, repo.repoRoot)) {
+            let best;
+            for (const row of rows) {
+                if (!isPathWithin(session.dir, row.path))
+                    continue;
+                if (!best || row.path.length > best.path.length)
+                    best = row;
+            }
+            if (!best)
+                continue;
+            best.sessionCount += 1;
+            if (canAccessOwned(user, session.owner))
+                best.sessions.push({ id: session.id, name: session.name });
+        }
+        return {
+            success: true,
+            data: {
+                caseName: name,
+                repoRoot: repo.repoRoot,
+                worktreesDir: managedWorktreesDir(repo.repoRoot),
+                worktrees: rows,
+                truncated: listed.truncated,
+            },
+        };
+    });
+    app.post('/api/cases/:name/worktrees', async (req, reply) => {
+        const { name } = req.params;
+        const body = parseBody(CreateWorktreeSchema, req.body);
+        const nameError = worktreeNameError(body.name);
+        if (nameError)
+            return failWith(reply, ApiErrorCode.INVALID_INPUT, nameError);
+        const resolved = await caseRepository(req, reply, name);
+        if (!resolved.ok)
+            return resolved.fail;
+        const created = await createCaseWorktree(resolved.repo, body, {
+            git: deps.git,
+            agentSkillDirs: registryAgentSkillDirs(),
+        });
+        if (!created.ok)
+            return failFrom(reply, created);
+        reply.code(201);
+        return { success: true, data: { worktree: created.worktree } };
+    });
+    app.delete('/api/cases/:name/worktrees/:worktree', async (req, reply) => {
+        const { name, worktree } = req.params;
+        const query = parseBody(RemoveWorktreeQuerySchema, req.query ?? {});
+        const nameError = worktreeNameError(worktree);
+        if (nameError)
+            return failWith(reply, ApiErrorCode.INVALID_INPUT, nameError);
+        const resolved = await caseRepository(req, reply, name);
+        if (!resolved.ok)
+            return resolved.fail;
+        const removed = await removeCaseWorktree(resolved.repo, {
+            name: worktree,
+            deleteBranch: query.deleteBranch === 'true' || query.deleteBranch === '1',
+            // Any owner's session blocks: removing the folder under a running agent is the damage
+            // this refusal exists to prevent, whoever started it.
+            isInUse: (path) => liveLocalSessions(ctx, resolved.casePath, resolved.repo.repoRoot).some((s) => isPathWithin(s.dir, path)),
+        }, 
+        // The worktree folder itself must not be (or hold) a Docker case workspace either.
+        { git: deps.git, dockerWorkspaces: resolved.dockerRoots });
+        if (!removed.ok)
+            return failFrom(reply, removed);
+        return { success: true, data: { removed: removed.removed } };
+    });
+}
+//# sourceMappingURL=worktree-routes.js.map

package/dist/web/routes/worktree-routes.js.map

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

package/dist/web/schemas.d.ts

@@ -46,6 +46,15 @@ export declare const FileWriteSchema: z.ZodObject<{
     }>>;
     force: z.ZodOptional<z.ZodBoolean>;
 }, z.core.$strict>;
+/**
+ * Body validation for `POST /api/sessions/:id/html-view` (render a local HTML file
+ * as a sandboxed page). `path` is absolute or relative to the session workspace;
+ * the extension, containment, guard and broad-root checks are the route's
+ * (html-view-routes.ts), after parsing.
+ */
+export declare const HtmlViewOpenSchema: z.ZodObject<{
+    path: z.ZodString;
+}, z.core.$strict>;
 /**
  * The run-mode ids the API currently accepts: every ENABLED registry entry.
  *
@@ -87,6 +96,7 @@ export declare const CreateSessionSchema: z.ZodObject<{
     mode: z.ZodOptional<z.ZodType<SessionMode, unknown, z.core.$ZodTypeInternals<SessionMode, unknown>>>;
     name: z.ZodOptional<z.ZodString>;
     parentSessionId: z.ZodOptional<z.ZodString>;
+    tabGroupId: z.ZodOptional<z.ZodString>;
     envOverrides: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
     effort: z.ZodOptional<z.ZodEnum<{
         low: "low";
@@ -230,6 +240,23 @@ export declare const StatusTelemetrySchema: z.ZodObject<{
         model: z.ZodOptional<z.ZodNullable<z.ZodObject<{
             display_name: z.ZodOptional<z.ZodNullable<z.ZodString>>;
         }, z.core.$strip>>>;
+        prompt_cache: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+            warm: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;
+            caching_observed: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;
+            ttl: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            expires_at: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+            requests: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+            misses: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+            expected_rebuilds: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+            hit_ratio: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+            cache_write_tokens: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+            miss_recache_tokens: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+            last_miss_at: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+            recache_tokens_if_cold: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+            last_miss_cause: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+                causes: z.ZodPreprocess<z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodUnknown>>>>;
+            }, z.core.$strip>>>;
+        }, z.core.$strip>>>;
     }, z.core.$strip>>>;
 }, z.core.$strip>;
 /**
@@ -260,6 +287,21 @@ export declare const CloneCaseSchema: z.ZodObject<{
 export declare const ClonePreflightSchema: z.ZodObject<{
     repository: z.ZodString;
 }, z.core.$strip>;
+/** Schema for POST /api/cases/:name/worktrees: a new worktree on a new branch. */
+export declare const CreateWorktreeSchema: z.ZodObject<{
+    name: z.ZodString;
+    branch: z.ZodOptional<z.ZodString>;
+    base: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+/** Query of DELETE /api/cases/:name/worktrees/:worktree. */
+export declare const RemoveWorktreeQuerySchema: z.ZodObject<{
+    deleteBranch: z.ZodOptional<z.ZodEnum<{
+        0: "0";
+        false: "false";
+        1: "1";
+        true: "true";
+    }>>;
+}, z.core.$strip>;
 export declare const RemoteHostSchema: z.ZodObject<{
     id: z.ZodString;
     label: z.ZodString;
@@ -399,6 +441,8 @@ export declare const QuickStartSchema: z.ZodObject<{
     caseName: z.ZodOptional<z.ZodString>;
     sessionName: z.ZodOptional<z.ZodString>;
     parentSessionId: z.ZodOptional<z.ZodString>;
+    tabGroupId: z.ZodOptional<z.ZodString>;
+    worktree: z.ZodOptional<z.ZodString>;
     modelOverride: z.ZodOptional<z.ZodString>;
     mode: z.ZodOptional<z.ZodType<SessionMode, unknown, z.core.$ZodTypeInternals<SessionMode, unknown>>>;
     openCodeConfig: z.ZodOptional<z.ZodObject<{
@@ -648,6 +692,7 @@ export declare const SettingsUpdateSchema: z.ZodObject<{
     claudeVoiceEnabled: z.ZodOptional<z.ZodBoolean>;
     approvalsInboxEnabled: z.ZodOptional<z.ZodBoolean>;
     autoNameSessions: z.ZodOptional<z.ZodBoolean>;
+    spawnedTabsFollowParent: z.ZodOptional<z.ZodBoolean>;
     readMyMindEnabled: z.ZodOptional<z.ZodBoolean>;
     customModelEndpointsEnabled: z.ZodOptional<z.ZodBoolean>;
     cliManagementEnabled: z.ZodOptional<z.ZodBoolean>;

package/dist/web/schemas.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"schemas.d.ts","sourceRoot":"","sources":["../../src/web/schemas.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"schemas.d.ts","sourceRoot":"","sources":["../../src/web/schemas.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAiBxB,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAK/C,sFAAsF;AACtF,wBAAgB,iBAAiB,CAAC,CAAC,EAAE,MAAM,GAAG,OAAO,CAuBpD;AA4BD,yEAAyE;AACzE,eAAO,MAAM,2BAA2B;;;;;;;iBAQtC,CAAC;AAEH,0EAA0E;AAC1E,eAAO,MAAM,4BAA4B;;;;;;;iBAQvC,CAAC;AAEH;;;;;;;GAOG;AACH,eAAO,MAAM,eAAe;;;;;;;;;kBAcjB,CAAC;AAEZ;;;;;GAKG;AACH,eAAO,MAAM,kBAAkB;;kBAUpB,CAAC;AAEZ;;;;;GAKG;AACH,wBAAgB,cAAc,IAAI,MAAM,EAAE,CAEzC;AAkVD;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,4BAA4B;;;kBAe9B,CAAC;AAEZ;;;;;;;;;GASG;AACH,eAAO,MAAM,sBAAsB;;kBAQxB,CAAC;AAsBZ,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBA4D9B,CAAC;AAEH;;;GAGG;AACH,eAAO,MAAM,eAAe;;iBAE1B,CAAC;AAEH;;;GAGG;AACH,eAAO,MAAM,YAAY;;;;;;;;;iBAKvB,CAAC;AAwBH,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBA0DhC,CAAC;AAIH;;;GAGG;AACH,eAAO,MAAM,gBAAgB;;;;iBAY3B,CAAC;AAEH;;;;;;;GAOG;AACH,eAAO,MAAM,eAAe;;;;;;iBAU1B,CAAC;AAEH,8FAA8F;AAC9F,eAAO,MAAM,oBAAoB;;iBAE/B,CAAC;AAeH,kFAAkF;AAClF,eAAO,MAAM,oBAAoB;;;;iBAM/B,CAAC;AAEH,4DAA4D;AAC5D,eAAO,MAAM,yBAAyB;;;;;;;iBAGpC,CAAC;AA+BH,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;iBAgF3B,CAAC;AAEH,eAAO,MAAM,oBAAoB;;;;iBAS/B,CAAC;AAiCH,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAsD3B,CAAC;AAEH,eAAO,MAAM,oBAAoB;;;;;;iBA2B/B,CAAC;AAEH;;;;;;;;GAQG;AACH,eAAO,MAAM,qBAAqB;;;;;;iBAuBhC,CAAC;AAEH,mFAAmF;AACnF,eAAO,MAAM,0BAA0B;;;;iBAerC,CAAC;AAEH,gFAAgF;AAChF,eAAO,MAAM,kBAAkB;;;;iBAa7B,CAAC;AAEH,eAAO,MAAM,kBAAkB;;;;;iBAE7B,CAAC;AAEH,eAAO,MAAM,kBAAkB;;;;iBAe7B,CAAC;AAKH,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;iBA8BlC,CAAC;AAIH;;;GAGG;AACH,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAqE3B,CAAC;AAIH;;;GAGG;AACH,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;iBAqB1B,CAAC;AAEH;;;;GAIG;AACH,eAAO,MAAM,oBAAoB;;;;;;;;;kBAMtB,CAAC;AAEZ;;;GAGG;AACH,eAAO,MAAM,iBAAiB;;kBAInB,CAAC;AAEZ;;;;;GAKG;AACH,eAAO,MAAM,uBAAuB;;;kBAKzB,CAAC;AAIZ;;;GAGG;AACH,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;;;;iBA2B9B,CAAC;AAEH;;;GAGG;AACH,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAOpB,CAAC;AAeZ;;;;;;;GAOG;AACH,eAAO,MAAM,0BAA0B;;kBAI5B,CAAC;AAEZ,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBA2U7B,CAAC;AAEL;;GAEG;AACH,eAAO,MAAM,2BAA2B;;;;;;;iBA4BtC,CAAC;AAEH;;;;;;;;;;;;;;;;;GAiBG;AACH,eAAO,MAAM,sBAAsB;;;;;;;;;iBASjC,CAAC;AAEH;;;;;;;;GAQG;AACH,eAAO,MAAM,4BAA4B;;;;;;;;;;;;;iBAOvC,CAAC;AAIH,iCAAiC;AACjC,eAAO,MAAM,iBAAiB;;iBAE5B,CAAC;AAEH,kCAAkC;AAClC,eAAO,MAAM,kBAAkB;;iBAE7B,CAAC;AAEH,0CAA0C;AAC1C,eAAO,MAAM,iBAAiB;;;;;;;;iBAQ5B,CAAC;AAEH,6CAA6C;AAC7C,eAAO,MAAM,mBAAmB;;iBAE9B,CAAC;AAEH,gDAAgD;AAChD,eAAO,MAAM,sBAAsB;;iBAEjC,CAAC;AAEH,wCAAwC;AACxC,eAAO,MAAM,eAAe;;;iBAG1B,CAAC;AAEH,0CAA0C;AAC1C,eAAO,MAAM,iBAAiB;;;;iBAI5B,CAAC;AAEH,yCAAyC;AACzC,eAAO,MAAM,gBAAgB;;iBAE3B,CAAC;AAEH,iFAAiF;AACjF,eAAO,MAAM,gBAAgB;;iBAE3B,CAAC;AAEH,2CAA2C;AAC3C,eAAO,MAAM,kBAAkB;;iBAE7B,CAAC;AAEH,4CAA4C;AAC5C,eAAO,MAAM,mBAAmB;;iBAE9B,CAAC;AAEH,oBAAoB;AACpB,eAAO,MAAM,cAAc;;;;iBAIzB,CAAC;AAEH,0BAA0B;AAC1B,eAAO,MAAM,kBAAkB;;;;iBAI7B,CAAC;AA4DH,iDAAiD;AACjD,eAAO,MAAM,aAAa;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAA+C,CAAC;AAE1E,+CAA+C;AAC/C,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAA8B,CAAC;AAE/D,qCAAqC;AACrC,eAAO,MAAM,oBAAoB;;iBAAqC,CAAC;AAEvE,2BAA2B;AAC3B,eAAO,MAAM,cAAc;;;iBAGzB,CAAC;AAEH,2BAA2B;AAC3B,eAAO,MAAM,eAAe;;iBAE1B,CAAC;AAEH,8EAA8E;AAC9E,eAAO,MAAM,wBAAwB;;iBAKnC,CAAC;AAEH,4BAA4B;AAC5B,eAAO,MAAM,mBAAmB;;iBAE9B,CAAC;AAEH,8BAA8B;AAC9B,eAAO,MAAM,kBAAkB;;;;;;;iBAG7B,CAAC;AAEH,uCAAuC;AACvC,eAAO,MAAM,0BAA0B;;;iBAGrC,CAAC;AAEH,uCAAuC;AACvC,eAAO,MAAM,gBAAgB;;iBAE3B,CAAC;AAEH,gDAAgD;AAChD,eAAO,MAAM,oBAAoB;;;;;;;;;;iBAI/B,CAAC;AAEH,kDAAkD;AAClD,eAAO,MAAM,iBAAiB;;;;;;;;;;iBAM5B,CAAC;AAEH,uCAAuC;AACvC,eAAO,MAAM,cAAc;;;;;;;;iBAIzB,CAAC;AAEH,sCAAsC;AACtC,eAAO,MAAM,uBAAuB,wCAAoC,CAAC;AAEzE,sCAAsC;AACtC,eAAO,MAAM,0BAA0B;;;iBAKvB,CAAC;AAEjB,gCAAgC;AAChC,eAAO,MAAM,uBAAuB,uCAAmC,CAAC;AAExE,yCAAyC;AACzC,eAAO,MAAM,sBAAsB;;iBAOjC,CAAC;AAEH,iDAAiD;AACjD,eAAO,MAAM,wBAAwB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAGnC,CAAC;AAEH,4CAA4C;AAC5C,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAG9B,CAAC;AAIH,+BAA+B;AAC/B,eAAO,MAAM,mBAAmB;;;;;;;;iBAY9B,CAAC;AAEH,kCAAkC;AAClC,eAAO,MAAM,2BAA2B;;iBAEtC,CAAC;AAEH;;;;GAIG;AACH,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;kBAOrB,CAAC;AAIZ,iCAAiC;AACjC,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;iBAwB/B,CAAC;AAIH,mCAAmC;AACnC,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;;;;iBAelC,CAAC;AAEH,oCAAoC;AACpC,eAAO,MAAM,wBAAwB;;iBAEnC,CAAC;AAIH,iEAAiE;AACjE,eAAO,MAAM,mBAAmB,uCAAwC,CAAC;AAEzE;;;;;;;GAOG;AACH,eAAO,MAAM,iBAAiB;;;;iBAiB5B,CAAC;AA6CH,yBAAyB;AACzB,eAAO,MAAM,mBAAmB;;;;;;;;;;;;iBAAoB,CAAC;AAErD,+CAA+C;AAC/C,eAAO,MAAM,mBAAmB;;;;;;;;;;;;iBAA8B,CAAC;AAE/D,2FAA2F;AAC3F,eAAO,MAAM,kBAAkB;;iBAAsC,CAAC;AAOtE,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;iBAqBhC,CAAC;AAcH,2IAA2I;AAC3I,eAAO,MAAM,eAAe;;iBAAqC,CAAC;AAElE;;;;;;;GAOG;AACH,eAAO,MAAM,oBAAoB;;;;;;;iBAQ/B,CAAC;AAEH,+FAA+F;AAC/F,eAAO,MAAM,0BAA0B;;;;;;;;mBAsBrC,CAAC"}

package/dist/web/schemas.js

@@ -111,6 +111,23 @@ export const FileWriteSchema = z
     force: z.boolean().optional(),
 })
     .strict();
+/**
+ * Body validation for `POST /api/sessions/:id/html-view` (render a local HTML file
+ * as a sandboxed page). `path` is absolute or relative to the session workspace;
+ * the extension, containment, guard and broad-root checks are the route's
+ * (html-view-routes.ts), after parsing.
+ */
+export const HtmlViewOpenSchema = z
+    .object({
+    path: z
+        .string({ error: 'Missing path parameter' })
+        .min(1, 'Missing path parameter')
+        .max(4096)
+        .refine((p) => !p.includes('\0') && !p.includes('\n') && !p.includes('\r'), {
+        message: 'Invalid path',
+    }),
+})
+    .strict();
 /**
  * The run-mode ids the API currently accepts: every ENABLED registry entry.
  *
@@ -489,12 +506,22 @@ export const DeepSeekWebStartSchema = z
  * spawn, and this is never an ownership or permission signal.
  */
 const parentSessionIdSchema = z.string().max(100).optional();
+/**
+ * Tab group the new session should be placed in (the group's "New session"
+ * action). Advisory like parentSessionId: the layout service looks the id up in
+ * the creating owner's own layout and ignores one it cannot find, so a stale or
+ * foreign id never fails a spawn. A malformed value (null, empty, over-long) is
+ * still a 400, because only the browser sends it.
+ */
+const tabGroupIdSchema = z.string().min(1).max(100).optional();
 export const CreateSessionSchema = z.object({
     workingDir: safePathSchema.optional(),
     mode: sessionModeSchema().optional(),
     name: z.string().max(100).optional(),
     /** Session that spawned this one — see parentSessionIdSchema. */
     parentSessionId: parentSessionIdSchema,
+    /** Tab group to place the new session in: see tabGroupIdSchema. */
+    tabGroupId: tabGroupIdSchema,
     envOverrides: safeEnvOverridesSchema,
     /** Claude CLI effort level (soft default via --settings, switchable in-session via /effort) */
     effort: effortLevelSchema,
@@ -605,6 +632,43 @@ export const StatusTelemetrySchema = z.object({
             .nullish(),
         cost: z.object({ total_cost_usd: z.number().nullish() }).nullish(),
         model: z.object({ display_name: z.string().max(100).nullish() }).nullish(),
+        // Main-conversation prompt-cache statistics (Claude Code v2.1.251+). Every documented
+        // scalar field is listed nullish: `expires_at`/`hit_ratio`/`last_miss_at`/
+        // `recache_tokens_if_cold` are all documented as possibly null, and the object gains
+        // fields over CLI versions, so a stricter shape would 400 the whole post and blank the
+        // footer (the recurring .optional()/null trap). Causes stay `unknown` (the parser keeps
+        // the strings); `last_miss_cause`'s extra numeric keys and the `miss_causes` record are
+        // stripped by Zod unread, which keeps the stored object bounded — a hostile localhost
+        // payload cannot bloat state, since only the normalized subset below is ever stored.
+        prompt_cache: z
+            .object({
+            warm: z.boolean().nullish(),
+            caching_observed: z.boolean().nullish(),
+            // No length cap: a future TTL longer than today's `5m`/`1h` must not 400 the whole
+            // post and blank the footer. parsePromptCache discards any TTL it does not know, so
+            // the stored value stays bounded to those two regardless.
+            ttl: z.string().nullish(),
+            expires_at: z.number().nullish(),
+            requests: z.number().nullish(),
+            misses: z.number().nullish(),
+            expected_rebuilds: z.number().nullish(),
+            hit_ratio: z.number().nullish(),
+            cache_write_tokens: z.number().nullish(),
+            miss_recache_tokens: z.number().nullish(),
+            last_miss_at: z.number().nullish(),
+            recache_tokens_if_cold: z.number().nullish(),
+            // Keep the first 20 causes instead of 400-ing the whole post (which also drops the
+            // footer, the plan chip and the model report it carries) when Claude Code reports more. The
+            // preprocess slices BEFORE the array validates, so an over-long array costs one bounded
+            // slice, never per-element validation across every entry (parsePromptCache then keeps
+            // the string ones among those 20).
+            last_miss_cause: z
+                .object({
+                causes: z.preprocess((v) => (Array.isArray(v) ? v.slice(0, 20) : v), z.array(z.unknown()).nullish()),
+            })
+                .nullish(),
+        })
+            .nullish(),
     })
         .nullish(),
 });
@@ -649,6 +713,30 @@ export const CloneCaseSchema = z.object({
 export const ClonePreflightSchema = z.object({
     repository: z.string().min(1).max(2048),
 });
+// ========== Git worktrees of a case (src/git-worktrees.ts) ==========
+/**
+ * A worktree name: one segment of letters, digits, `.`, `_`, `-`, starting with a letter or
+ * digit, at most 64 characters (Claude Code's own `--worktree` limit). The finer rules (no `..`,
+ * no trailing `.lock`) are `worktreeNameError()`, which every route applies after this.
+ */
+const worktreeNameSchema = z
+    .string()
+    .min(1)
+    .max(64)
+    .regex(/^[A-Za-z0-9][A-Za-z0-9._-]*$/, 'Invalid worktree name. Use letters, digits, ".", "_" and "-".');
+/** Schema for POST /api/cases/:name/worktrees: a new worktree on a new branch. */
+export const CreateWorktreeSchema = z.object({
+    name: worktreeNameSchema,
+    /** New branch name; default `worktree-<name>`, Claude Code's convention. */
+    branch: z.string().min(1).max(200).optional(),
+    /** Start point (branch, tag or commit); default the case's current HEAD. */
+    base: z.string().min(1).max(200).optional(),
+});
+/** Query of DELETE /api/cases/:name/worktrees/:worktree. */
+export const RemoveWorktreeQuerySchema = z.object({
+    /** Also `git branch -d` the worktree's branch (never `-D`). */
+    deleteBranch: z.enum(['true', 'false', '1', '0']).optional(),
+});
 const RemoteCommandOverridesSchema = z
     .object({
     shell: z.string().min(1).max(300).optional(),
@@ -999,6 +1087,15 @@ export const QuickStartSchema = z.object({
     sessionName: z.string().max(128).optional(),
     /** Session that spawned this one — see parentSessionIdSchema. */
     parentSessionId: parentSessionIdSchema,
+    /** Tab group to place the new session in: see tabGroupIdSchema. */
+    tabGroupId: tabGroupIdSchema,
+    /**
+     * Start the session in this git worktree of the case (`<case>/.claude/worktrees/<worktree>`,
+     * created through POST /api/cases/:name/worktrees) instead of the case folder. Local cases
+     * only: refused (400) for remote and Docker cases. The worktree must be a registered worktree
+     * of the case's repository; it is never created here.
+     */
+    worktree: worktreeNameSchema.optional(),
     /** Model override written to <case>/.claude/settings.local.json (e.g. "opus[1m]").
      *  Empty string clears. Applied for local AND docker cases (the docker workspace is
      *  a real host dir, so the settings file crosses the bind mount); rejected for
@@ -1252,6 +1349,14 @@ export const SettingsUpdateSchema = z
      * broadcast and /api/search, which is the user's choice to make.
      */
     autoNameSessions: z.boolean().optional(),
+    /**
+     * Spawned tabs follow their parent: a session created by another one keeps
+     * following its parent's tab (into its group, moving with it) until moved by
+     * hand. SYNCED, default OFF, because the server does the placement:
+     * TabLayoutService.sessionCreated() reads it at every creation, and with it
+     * off the child lands after its parent once and is hand-placed from then on.
+     */
+    spawnedTabsFollowParent: z.boolean().optional(),
     /**
      * Read My Mind (docs/readmymind-plan.md): capture the user's submitted
      * prompts into per-case intent profiles. SYNCED, default OFF (opt-in: