@evalops/maestro 0.10.50 → 0.10.51

package/dist/agent/snapshot-store.js

@@ -0,0 +1,195 @@
+import { createHash } from "node:crypto";
+import { existsSync, lstatSync, mkdirSync, readFileSync, readdirSync, realpathSync, rmSync, rmdirSync, } from "node:fs";
+import { basename, dirname, isAbsolute, join, relative, resolve, } from "node:path";
+import { PATHS } from "../config/constants.js";
+import { defaultRuntimeEnv } from "../runtime/env.js";
+import { writeTextFileAtomic } from "../utils/fs.js";
+const SNAPSHOT_SHA256_PATTERN = /^(?:sha256:)?[a-f0-9]{64}$/iu;
+export function getSnapshotBlobRoot(rootDir) {
+    return (rootDir ??
+        defaultRuntimeEnv().snapshotBlobDir ??
+        join(PATHS.MAESTRO_HOME, "snapshots", "blobs"));
+}
+export function sha256Content(content) {
+    return createHash("sha256").update(content).digest("hex");
+}
+export class SnapshotBlobStore {
+    constructor(config = {}) {
+        this.rootDir = getSnapshotBlobRoot(config.rootDir);
+    }
+    put(content) {
+        const buffer = Buffer.isBuffer(content)
+            ? content
+            : Buffer.from(content, "utf-8");
+        const contentSha256 = sha256Content(buffer);
+        const path = this.getPath(contentSha256);
+        if (!existsSync(path)) {
+            writeBlobFileAtomic(path, buffer);
+        }
+        return { contentSha256, size: buffer.byteLength };
+    }
+    get(contentSha256) {
+        const path = this.getPath(contentSha256);
+        if (!existsSync(path)) {
+            throw new Error(`snapshot blob not found: ${contentSha256}`);
+        }
+        return readFileSync(path);
+    }
+    has(contentSha256) {
+        return existsSync(this.getPath(contentSha256));
+    }
+    getPath(contentSha256) {
+        const clean = normalizeSnapshotContentSha256(contentSha256);
+        return join(this.rootDir, clean.slice(0, 2), clean);
+    }
+}
+export function executeRewindPlan(options) {
+    const store = options.store ?? new SnapshotBlobStore();
+    const restored = [];
+    const deleted = [];
+    let bytesRestored = 0;
+    const workspaceRoot = realpathSync(resolve(options.workspaceDir));
+    const preparedOps = options.plan.ops.map((op) => {
+        const workspacePath = resolveWorkspacePlanPath(workspaceRoot, op.path);
+        if (op.kind === "delete") {
+            return { kind: "delete", path: op.path, workspacePath };
+        }
+        return {
+            kind: "restore",
+            path: op.path,
+            workspacePath,
+            content: readRestoreBlob(op, store),
+            size: op.size,
+        };
+    });
+    const plannedDeletePaths = new Set(preparedOps.flatMap((op) => op.kind === "delete" ? [op.workspacePath] : []));
+    preflightBlockingRestoreDirectories(preparedOps, plannedDeletePaths);
+    for (const op of preparedOps) {
+        if (op.kind === "delete") {
+            if (!options.dryRun) {
+                rmSync(op.workspacePath, { force: true, recursive: false });
+            }
+            deleted.push(op.path);
+            continue;
+        }
+        if (!options.dryRun) {
+            pruneBlockingRestoreDirectory(op.workspacePath);
+            writeBlobFileAtomic(op.workspacePath, op.content);
+        }
+        restored.push(op.path);
+        bytesRestored += op.size;
+    }
+    return {
+        targetIndex: options.plan.targetIndex,
+        fromIndex: options.plan.fromIndex,
+        restored,
+        deleted,
+        bytesRestored,
+        dryRun: options.dryRun === true,
+    };
+}
+function resolveWorkspacePlanPath(workspaceRoot, opPath) {
+    if (!opPath || isAbsolute(opPath)) {
+        throw new Error(`rewind plan path must be relative: ${opPath}`);
+    }
+    if (isParentDirectoryRelPath(opPath)) {
+        throw new Error(`rewind plan path escapes workspace: ${opPath}`);
+    }
+    const resolvedPath = resolve(workspaceRoot, opPath);
+    const rel = relative(workspaceRoot, resolvedPath);
+    if (!rel || isParentDirectoryRelPath(rel) || isAbsolute(rel)) {
+        throw new Error(`rewind plan path escapes workspace: ${opPath}`);
+    }
+    const workspaceRealRoot = realpathSync(workspaceRoot);
+    const parentRealPath = resolveRealPath(dirname(resolvedPath));
+    const parentRel = relative(workspaceRealRoot, parentRealPath);
+    if ((parentRealPath !== workspaceRealRoot && !parentRel) ||
+        isParentDirectoryRelPath(parentRel) ||
+        isAbsolute(parentRel)) {
+        throw new Error(`rewind plan path escapes workspace: ${opPath}`);
+    }
+    return resolvedPath;
+}
+function isParentDirectoryRelPath(relPath) {
+    return (relPath === ".." || relPath.startsWith("../") || relPath.startsWith("..\\"));
+}
+function resolveRealPath(path) {
+    const suffix = [];
+    let current = path;
+    while (true) {
+        if (existsSync(current)) {
+            const realBase = realpathSync(current);
+            return suffix.length === 0
+                ? realBase
+                : join(realBase, ...suffix.reverse());
+        }
+        const parent = dirname(current);
+        if (parent === current) {
+            return path;
+        }
+        suffix.push(basename(current));
+        current = parent;
+    }
+}
+function preflightBlockingRestoreDirectories(ops, plannedDeletePaths) {
+    for (const op of ops) {
+        if (op.kind !== "restore")
+            continue;
+        assertRestoreDirectoryPrunable(op.workspacePath, op.path, plannedDeletePaths);
+    }
+}
+function assertRestoreDirectoryPrunable(path, planPath, plannedDeletePaths) {
+    if (!existsSync(path))
+        return;
+    const stat = lstatSync(path);
+    if (!stat.isDirectory())
+        return;
+    for (const entry of readdirSync(path, { withFileTypes: true })) {
+        const childPath = join(path, entry.name);
+        if (plannedDeletePaths.has(childPath))
+            continue;
+        if (entry.isDirectory()) {
+            assertRestoreDirectoryPrunable(childPath, planPath, plannedDeletePaths);
+            continue;
+        }
+        throw new Error(`rewind restore target is blocked by unplanned workspace entry: ${planPath}`);
+    }
+}
+function pruneBlockingRestoreDirectory(path) {
+    if (!existsSync(path))
+        return;
+    const stat = lstatSync(path);
+    if (!stat.isDirectory())
+        return;
+    for (const entry of readdirSync(path, { withFileTypes: true })) {
+        const childPath = join(path, entry.name);
+        if (entry.isDirectory())
+            pruneBlockingRestoreDirectory(childPath);
+    }
+    rmdirSync(path);
+}
+function readRestoreBlob(op, store) {
+    const expectedSha256 = normalizeSnapshotContentSha256(op.contentSha256);
+    const content = store.get(op.contentSha256);
+    if (content.byteLength !== op.size) {
+        throw new Error(`snapshot blob size mismatch for ${op.path}: expected ${op.size}, got ${content.byteLength}`);
+    }
+    const actualSha256 = sha256Content(content);
+    if (actualSha256 !== expectedSha256) {
+        throw new Error(`snapshot blob hash mismatch for ${op.path}: expected ${expectedSha256}, got ${actualSha256}`);
+    }
+    return content;
+}
+function normalizeSnapshotContentSha256(contentSha256) {
+    if (!SNAPSHOT_SHA256_PATTERN.test(contentSha256)) {
+        throw new Error(`invalid snapshot blob sha256: ${contentSha256}`);
+    }
+    return contentSha256.replace(/^sha256:/iu, "").toLowerCase();
+}
+function writeBlobFileAtomic(path, content) {
+    mkdirSync(dirname(path), { recursive: true });
+    writeTextFileAtomic(path, content.toString("binary"), {
+        encoding: "binary",
+    });
+}
+//# sourceMappingURL=snapshot-store.js.map

package/dist/agent/snapshot-store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"snapshot-store.js","sourceRoot":"","sources":["../../src/agent/snapshot-store.ts"],"names":[],"mappings":"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","sourcesContent":["import { createHash } from \"node:crypto\";\nimport {\n\texistsSync,\n\tlstatSync,\n\tmkdirSync,\n\treadFileSync,\n\treaddirSync,\n\trealpathSync,\n\trmSync,\n\trmdirSync,\n} from \"node:fs\";\nimport {\n\tbasename,\n\tdirname,\n\tisAbsolute,\n\tjoin,\n\trelative,\n\tresolve,\n} from \"node:path\";\nimport { PATHS } from \"../config/constants.js\";\nimport { defaultRuntimeEnv } from \"../runtime/env.js\";\nimport { writeTextFileAtomic } from \"../utils/fs.js\";\nimport type { RewindPlan, RewindRestoreOp } from \"./snapshot-rewind-plan.js\";\n\nconst SNAPSHOT_SHA256_PATTERN = /^(?:sha256:)?[a-f0-9]{64}$/iu;\n\nexport interface SnapshotBlobStoreConfig {\n\trootDir?: string;\n}\n\nexport interface RewindExecutionResult {\n\ttargetIndex: number;\n\tfromIndex: number;\n\trestored: string[];\n\tdeleted: string[];\n\tbytesRestored: number;\n\tdryRun: boolean;\n}\n\ntype PreparedRewindOp =\n\t| {\n\t\t\tkind: \"delete\";\n\t\t\tpath: string;\n\t\t\tworkspacePath: string;\n\t  }\n\t| {\n\t\t\tkind: \"restore\";\n\t\t\tpath: string;\n\t\t\tworkspacePath: string;\n\t\t\tcontent: Buffer;\n\t\t\tsize: number;\n\t  };\n\nexport function getSnapshotBlobRoot(rootDir?: string): string {\n\treturn (\n\t\trootDir ??\n\t\tdefaultRuntimeEnv().snapshotBlobDir ??\n\t\tjoin(PATHS.MAESTRO_HOME, \"snapshots\", \"blobs\")\n\t);\n}\n\nexport function sha256Content(content: string | Buffer): string {\n\treturn createHash(\"sha256\").update(content).digest(\"hex\");\n}\n\nexport class SnapshotBlobStore {\n\tprivate readonly rootDir: string;\n\n\tconstructor(config: SnapshotBlobStoreConfig = {}) {\n\t\tthis.rootDir = getSnapshotBlobRoot(config.rootDir);\n\t}\n\n\tput(content: string | Buffer): { contentSha256: string; size: number } {\n\t\tconst buffer = Buffer.isBuffer(content)\n\t\t\t? content\n\t\t\t: Buffer.from(content, \"utf-8\");\n\t\tconst contentSha256 = sha256Content(buffer);\n\t\tconst path = this.getPath(contentSha256);\n\t\tif (!existsSync(path)) {\n\t\t\twriteBlobFileAtomic(path, buffer);\n\t\t}\n\t\treturn { contentSha256, size: buffer.byteLength };\n\t}\n\n\tget(contentSha256: string): Buffer {\n\t\tconst path = this.getPath(contentSha256);\n\t\tif (!existsSync(path)) {\n\t\t\tthrow new Error(`snapshot blob not found: ${contentSha256}`);\n\t\t}\n\t\treturn readFileSync(path);\n\t}\n\n\thas(contentSha256: string): boolean {\n\t\treturn existsSync(this.getPath(contentSha256));\n\t}\n\n\tgetPath(contentSha256: string): string {\n\t\tconst clean = normalizeSnapshotContentSha256(contentSha256);\n\t\treturn join(this.rootDir, clean.slice(0, 2), clean);\n\t}\n}\n\nexport function executeRewindPlan(options: {\n\tplan: RewindPlan;\n\tworkspaceDir: string;\n\tstore?: SnapshotBlobStore;\n\tdryRun?: boolean;\n}): RewindExecutionResult {\n\tconst store = options.store ?? new SnapshotBlobStore();\n\tconst restored: string[] = [];\n\tconst deleted: string[] = [];\n\tlet bytesRestored = 0;\n\tconst workspaceRoot = realpathSync(resolve(options.workspaceDir));\n\tconst preparedOps = options.plan.ops.map((op): PreparedRewindOp => {\n\t\tconst workspacePath = resolveWorkspacePlanPath(workspaceRoot, op.path);\n\t\tif (op.kind === \"delete\") {\n\t\t\treturn { kind: \"delete\", path: op.path, workspacePath };\n\t\t}\n\t\treturn {\n\t\t\tkind: \"restore\",\n\t\t\tpath: op.path,\n\t\t\tworkspacePath,\n\t\t\tcontent: readRestoreBlob(op, store),\n\t\t\tsize: op.size,\n\t\t};\n\t});\n\tconst plannedDeletePaths = new Set(\n\t\tpreparedOps.flatMap((op) =>\n\t\t\top.kind === \"delete\" ? [op.workspacePath] : [],\n\t\t),\n\t);\n\tpreflightBlockingRestoreDirectories(preparedOps, plannedDeletePaths);\n\tfor (const op of preparedOps) {\n\t\tif (op.kind === \"delete\") {\n\t\t\tif (!options.dryRun) {\n\t\t\t\trmSync(op.workspacePath, { force: true, recursive: false });\n\t\t\t}\n\t\t\tdeleted.push(op.path);\n\t\t\tcontinue;\n\t\t}\n\t\tif (!options.dryRun) {\n\t\t\tpruneBlockingRestoreDirectory(op.workspacePath);\n\t\t\twriteBlobFileAtomic(op.workspacePath, op.content);\n\t\t}\n\t\trestored.push(op.path);\n\t\tbytesRestored += op.size;\n\t}\n\treturn {\n\t\ttargetIndex: options.plan.targetIndex,\n\t\tfromIndex: options.plan.fromIndex,\n\t\trestored,\n\t\tdeleted,\n\t\tbytesRestored,\n\t\tdryRun: options.dryRun === true,\n\t};\n}\n\nfunction resolveWorkspacePlanPath(\n\tworkspaceRoot: string,\n\topPath: string,\n): string {\n\tif (!opPath || isAbsolute(opPath)) {\n\t\tthrow new Error(`rewind plan path must be relative: ${opPath}`);\n\t}\n\tif (isParentDirectoryRelPath(opPath)) {\n\t\tthrow new Error(`rewind plan path escapes workspace: ${opPath}`);\n\t}\n\tconst resolvedPath = resolve(workspaceRoot, opPath);\n\tconst rel = relative(workspaceRoot, resolvedPath);\n\tif (!rel || isParentDirectoryRelPath(rel) || isAbsolute(rel)) {\n\t\tthrow new Error(`rewind plan path escapes workspace: ${opPath}`);\n\t}\n\tconst workspaceRealRoot = realpathSync(workspaceRoot);\n\tconst parentRealPath = resolveRealPath(dirname(resolvedPath));\n\tconst parentRel = relative(workspaceRealRoot, parentRealPath);\n\tif (\n\t\t(parentRealPath !== workspaceRealRoot && !parentRel) ||\n\t\tisParentDirectoryRelPath(parentRel) ||\n\t\tisAbsolute(parentRel)\n\t) {\n\t\tthrow new Error(`rewind plan path escapes workspace: ${opPath}`);\n\t}\n\treturn resolvedPath;\n}\n\nfunction isParentDirectoryRelPath(relPath: string): boolean {\n\treturn (\n\t\trelPath === \"..\" || relPath.startsWith(\"../\") || relPath.startsWith(\"..\\\\\")\n\t);\n}\n\nfunction resolveRealPath(path: string): string {\n\tconst suffix: string[] = [];\n\tlet current = path;\n\twhile (true) {\n\t\tif (existsSync(current)) {\n\t\t\tconst realBase = realpathSync(current);\n\t\t\treturn suffix.length === 0\n\t\t\t\t? realBase\n\t\t\t\t: join(realBase, ...suffix.reverse());\n\t\t}\n\t\tconst parent = dirname(current);\n\t\tif (parent === current) {\n\t\t\treturn path;\n\t\t}\n\t\tsuffix.push(basename(current));\n\t\tcurrent = parent;\n\t}\n}\n\nfunction preflightBlockingRestoreDirectories(\n\tops: readonly PreparedRewindOp[],\n\tplannedDeletePaths: ReadonlySet<string>,\n): void {\n\tfor (const op of ops) {\n\t\tif (op.kind !== \"restore\") continue;\n\t\tassertRestoreDirectoryPrunable(\n\t\t\top.workspacePath,\n\t\t\top.path,\n\t\t\tplannedDeletePaths,\n\t\t);\n\t}\n}\n\nfunction assertRestoreDirectoryPrunable(\n\tpath: string,\n\tplanPath: string,\n\tplannedDeletePaths: ReadonlySet<string>,\n): void {\n\tif (!existsSync(path)) return;\n\tconst stat = lstatSync(path);\n\tif (!stat.isDirectory()) return;\n\tfor (const entry of readdirSync(path, { withFileTypes: true })) {\n\t\tconst childPath = join(path, entry.name);\n\t\tif (plannedDeletePaths.has(childPath)) continue;\n\t\tif (entry.isDirectory()) {\n\t\t\tassertRestoreDirectoryPrunable(childPath, planPath, plannedDeletePaths);\n\t\t\tcontinue;\n\t\t}\n\t\tthrow new Error(\n\t\t\t`rewind restore target is blocked by unplanned workspace entry: ${planPath}`,\n\t\t);\n\t}\n}\n\nfunction pruneBlockingRestoreDirectory(path: string): void {\n\tif (!existsSync(path)) return;\n\tconst stat = lstatSync(path);\n\tif (!stat.isDirectory()) return;\n\tfor (const entry of readdirSync(path, { withFileTypes: true })) {\n\t\tconst childPath = join(path, entry.name);\n\t\tif (entry.isDirectory()) pruneBlockingRestoreDirectory(childPath);\n\t}\n\trmdirSync(path);\n}\n\nfunction readRestoreBlob(\n\top: RewindRestoreOp,\n\tstore: SnapshotBlobStore,\n): Buffer {\n\tconst expectedSha256 = normalizeSnapshotContentSha256(op.contentSha256);\n\tconst content = store.get(op.contentSha256);\n\tif (content.byteLength !== op.size) {\n\t\tthrow new Error(\n\t\t\t`snapshot blob size mismatch for ${op.path}: expected ${op.size}, got ${content.byteLength}`,\n\t\t);\n\t}\n\tconst actualSha256 = sha256Content(content);\n\tif (actualSha256 !== expectedSha256) {\n\t\tthrow new Error(\n\t\t\t`snapshot blob hash mismatch for ${op.path}: expected ${expectedSha256}, got ${actualSha256}`,\n\t\t);\n\t}\n\treturn content;\n}\n\nfunction normalizeSnapshotContentSha256(contentSha256: string): string {\n\tif (!SNAPSHOT_SHA256_PATTERN.test(contentSha256)) {\n\t\tthrow new Error(`invalid snapshot blob sha256: ${contentSha256}`);\n\t}\n\treturn contentSha256.replace(/^sha256:/iu, \"\").toLowerCase();\n}\n\nfunction writeBlobFileAtomic(path: string, content: Buffer): void {\n\tmkdirSync(dirname(path), { recursive: true });\n\twriteTextFileAtomic(path, content.toString(\"binary\"), {\n\t\tencoding: \"binary\",\n\t});\n}\n"]}

package/dist/agent/specialist-profiles.d.ts

@@ -0,0 +1,36 @@
+export type SpecialistProfileScope = "project" | "user";
+export interface SpecialistProfile {
+    name: string;
+    description?: string;
+    prompt: string;
+    tools?: string[];
+    model?: string;
+    scope: SpecialistProfileScope;
+    path: string;
+    createdAt?: string;
+    updatedAt?: string;
+}
+export declare function normalizeSpecialistProfileName(name: string): string;
+export declare function getSpecialistProfileDir(scope: SpecialistProfileScope, workspaceDir?: string): string;
+export declare function getSpecialistProfilePath(name: string, scope: SpecialistProfileScope, workspaceDir?: string): string;
+export declare function createSpecialistProfile(options: {
+    name: string;
+    description?: string;
+    prompt: string;
+    tools?: string[];
+    model?: string;
+    scope?: SpecialistProfileScope;
+    workspaceDir?: string;
+    now?: string;
+    overwrite?: boolean;
+}): SpecialistProfile;
+export declare function readSpecialistProfile(path: string, scope: SpecialistProfileScope): SpecialistProfile;
+export declare function listSpecialistProfiles(workspaceDir?: string): SpecialistProfile[];
+export declare function resolveSpecialistProfile(name: string, workspaceDir?: string): SpecialistProfile | null;
+export declare function deleteSpecialistProfile(options: {
+    name: string;
+    scope?: SpecialistProfileScope;
+    workspaceDir?: string;
+}): boolean;
+export declare function applySpecialistProfileToPrompt(prompt: string, profile: SpecialistProfile | null | undefined): string;
+//# sourceMappingURL=specialist-profiles.d.ts.map

package/dist/agent/specialist-profiles.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"specialist-profiles.d.ts","sourceRoot":"","sources":["../../src/agent/specialist-profiles.ts"],"names":[],"mappings":"AAeA,MAAM,MAAM,sBAAsB,GAAG,SAAS,GAAG,MAAM,CAAC;AAExD,MAAM,WAAW,iBAAiB;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,sBAAsB,CAAC;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,wBAAgB,8BAA8B,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAYnE;AAED,wBAAgB,uBAAuB,CACtC,KAAK,EAAE,sBAAsB,EAC7B,YAAY,SAAgB,GAC1B,MAAM,CAIR;AAED,wBAAgB,wBAAwB,CACvC,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,sBAAsB,EAC7B,YAAY,SAAgB,GAC1B,MAAM,CAKR;AAED,wBAAgB,uBAAuB,CAAC,OAAO,EAAE;IAChD,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,sBAAsB,CAAC;IAC/B,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,SAAS,CAAC,EAAE,OAAO,CAAC;CACpB,GAAG,iBAAiB,CAmCpB;AAED,wBAAgB,qBAAqB,CACpC,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,sBAAsB,GAC3B,iBAAiB,CAkCnB;AAED,wBAAgB,sBAAsB,CACrC,YAAY,SAAgB,GAC1B,iBAAiB,EAAE,CAsBrB;AAED,wBAAgB,wBAAwB,CACvC,IAAI,EAAE,MAAM,EACZ,YAAY,SAAgB,GAC1B,iBAAiB,GAAG,IAAI,CAO1B;AAED,wBAAgB,uBAAuB,CAAC,OAAO,EAAE;IAChD,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,sBAAsB,CAAC;IAC/B,YAAY,CAAC,EAAE,MAAM,CAAC;CACtB,GAAG,OAAO,CAUV;AAED,wBAAgB,8BAA8B,CAC7C,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,iBAAiB,GAAG,IAAI,GAAG,SAAS,GAC3C,MAAM,CAaR"}

package/dist/agent/specialist-profiles.js

@@ -0,0 +1,159 @@
+import { existsSync, mkdirSync, readFileSync, readdirSync, unlinkSync, } from "node:fs";
+import { basename, join } from "node:path";
+import YAML from "yaml";
+import { PATHS } from "../config/constants.js";
+import { writeTextFileAtomic } from "../utils/fs.js";
+import { createLogger } from "../utils/logger.js";
+const logger = createLogger("agent:specialist-profiles");
+export function normalizeSpecialistProfileName(name) {
+    const normalized = name
+        .trim()
+        .toLowerCase()
+        .replace(/[^a-z0-9-]+/g, "-");
+    const stripped = normalized.replace(/^-+|-+$/g, "");
+    if (!stripped || stripped.length > 64) {
+        throw new Error("profile name must be 1-64 lowercase letters, numbers, or hyphens");
+    }
+    return stripped;
+}
+export function getSpecialistProfileDir(scope, workspaceDir = process.cwd()) {
+    return scope === "project"
+        ? join(workspaceDir, ".maestro", "agent-profiles")
+        : join(PATHS.MAESTRO_HOME, "agent-profiles");
+}
+export function getSpecialistProfilePath(name, scope, workspaceDir = process.cwd()) {
+    return join(getSpecialistProfileDir(scope, workspaceDir), `${normalizeSpecialistProfileName(name)}.md`);
+}
+export function createSpecialistProfile(options) {
+    const scope = options.scope ?? "project";
+    const name = normalizeSpecialistProfileName(options.name);
+    const path = getSpecialistProfilePath(name, scope, options.workspaceDir);
+    if (existsSync(path) && !options.overwrite) {
+        throw new Error(`specialist profile already exists: ${name}`);
+    }
+    const now = options.now ?? new Date().toISOString();
+    const prompt = options.prompt.trim();
+    if (!prompt) {
+        throw new Error("profile prompt is required");
+    }
+    mkdirSync(getSpecialistProfileDir(scope, options.workspaceDir), {
+        recursive: true,
+    });
+    const frontmatter = YAML.stringify({
+        name,
+        description: options.description,
+        tools: options.tools,
+        model: options.model,
+        createdAt: now,
+        updatedAt: now,
+    });
+    writeTextFileAtomic(path, `---\n${frontmatter}---\n\n${prompt}\n`);
+    return {
+        name,
+        description: options.description,
+        prompt,
+        tools: options.tools,
+        model: options.model,
+        scope,
+        path,
+        createdAt: now,
+        updatedAt: now,
+    };
+}
+export function readSpecialistProfile(path, scope) {
+    const content = readFileSync(path, "utf-8");
+    const parsed = parseProfileMarkdown(content);
+    const name = typeof parsed.metadata.name === "string"
+        ? normalizeSpecialistProfileName(parsed.metadata.name)
+        : normalizeSpecialistProfileName(basename(path, ".md"));
+    return {
+        name,
+        description: typeof parsed.metadata.description === "string"
+            ? parsed.metadata.description
+            : undefined,
+        prompt: parsed.body.trim(),
+        tools: Array.isArray(parsed.metadata.tools)
+            ? parsed.metadata.tools.filter((tool) => typeof tool === "string")
+            : undefined,
+        model: typeof parsed.metadata.model === "string"
+            ? parsed.metadata.model
+            : undefined,
+        scope,
+        path,
+        createdAt: typeof parsed.metadata.createdAt === "string"
+            ? parsed.metadata.createdAt
+            : undefined,
+        updatedAt: typeof parsed.metadata.updatedAt === "string"
+            ? parsed.metadata.updatedAt
+            : undefined,
+    };
+}
+export function listSpecialistProfiles(workspaceDir = process.cwd()) {
+    const byName = new Map();
+    for (const scope of ["user", "project"]) {
+        const dir = getSpecialistProfileDir(scope, workspaceDir);
+        if (!existsSync(dir))
+            continue;
+        for (const entry of readdirSync(dir, { withFileTypes: true })) {
+            if (!entry.isFile() || !entry.name.endsWith(".md"))
+                continue;
+            try {
+                const profile = readSpecialistProfile(join(dir, entry.name), scope);
+                byName.set(profile.name, profile);
+            }
+            catch (error) {
+                logger.debug("Failed to read specialist profile", {
+                    file: entry.name,
+                    scope,
+                    error,
+                });
+            }
+        }
+    }
+    return [...byName.values()].sort((left, right) => left.name.localeCompare(right.name));
+}
+export function resolveSpecialistProfile(name, workspaceDir = process.cwd()) {
+    const normalized = normalizeSpecialistProfileName(name);
+    return (listSpecialistProfiles(workspaceDir).find((profile) => profile.name === normalized) ?? null);
+}
+export function deleteSpecialistProfile(options) {
+    const scope = options.scope ?? "project";
+    const path = getSpecialistProfilePath(options.name, scope, options.workspaceDir);
+    if (!existsSync(path))
+        return false;
+    unlinkSync(path);
+    return true;
+}
+export function applySpecialistProfileToPrompt(prompt, profile) {
+    if (!profile)
+        return prompt;
+    return [
+        `Specialist profile: ${profile.name}`,
+        profile.description ? `Description: ${profile.description}` : "",
+        "Profile instructions:",
+        profile.prompt,
+        "",
+        "Assigned task:",
+        prompt,
+    ]
+        .filter(Boolean)
+        .join("\n");
+}
+function parseProfileMarkdown(content) {
+    if (!content.startsWith("---\n")) {
+        return { metadata: {}, body: content };
+    }
+    const end = content.indexOf("\n---", 4);
+    if (end === -1)
+        return { metadata: {}, body: content };
+    const frontmatter = content.slice(4, end);
+    const body = content.slice(end + 4).replace(/^\r?\n/u, "");
+    const metadata = YAML.parse(frontmatter);
+    return {
+        metadata: metadata && typeof metadata === "object"
+            ? metadata
+            : {},
+        body,
+    };
+}
+//# sourceMappingURL=specialist-profiles.js.map

package/dist/agent/specialist-profiles.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"specialist-profiles.js","sourceRoot":"","sources":["../../src/agent/specialist-profiles.ts"],"names":[],"mappings":"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","sourcesContent":["import {\n\texistsSync,\n\tmkdirSync,\n\treadFileSync,\n\treaddirSync,\n\tunlinkSync,\n} from \"node:fs\";\nimport { basename, join } from \"node:path\";\nimport YAML from \"yaml\";\nimport { PATHS } from \"../config/constants.js\";\nimport { writeTextFileAtomic } from \"../utils/fs.js\";\nimport { createLogger } from \"../utils/logger.js\";\n\nconst logger = createLogger(\"agent:specialist-profiles\");\n\nexport type SpecialistProfileScope = \"project\" | \"user\";\n\nexport interface SpecialistProfile {\n\tname: string;\n\tdescription?: string;\n\tprompt: string;\n\ttools?: string[];\n\tmodel?: string;\n\tscope: SpecialistProfileScope;\n\tpath: string;\n\tcreatedAt?: string;\n\tupdatedAt?: string;\n}\n\nexport function normalizeSpecialistProfileName(name: string): string {\n\tconst normalized = name\n\t\t.trim()\n\t\t.toLowerCase()\n\t\t.replace(/[^a-z0-9-]+/g, \"-\");\n\tconst stripped = normalized.replace(/^-+|-+$/g, \"\");\n\tif (!stripped || stripped.length > 64) {\n\t\tthrow new Error(\n\t\t\t\"profile name must be 1-64 lowercase letters, numbers, or hyphens\",\n\t\t);\n\t}\n\treturn stripped;\n}\n\nexport function getSpecialistProfileDir(\n\tscope: SpecialistProfileScope,\n\tworkspaceDir = process.cwd(),\n): string {\n\treturn scope === \"project\"\n\t\t? join(workspaceDir, \".maestro\", \"agent-profiles\")\n\t\t: join(PATHS.MAESTRO_HOME, \"agent-profiles\");\n}\n\nexport function getSpecialistProfilePath(\n\tname: string,\n\tscope: SpecialistProfileScope,\n\tworkspaceDir = process.cwd(),\n): string {\n\treturn join(\n\t\tgetSpecialistProfileDir(scope, workspaceDir),\n\t\t`${normalizeSpecialistProfileName(name)}.md`,\n\t);\n}\n\nexport function createSpecialistProfile(options: {\n\tname: string;\n\tdescription?: string;\n\tprompt: string;\n\ttools?: string[];\n\tmodel?: string;\n\tscope?: SpecialistProfileScope;\n\tworkspaceDir?: string;\n\tnow?: string;\n\toverwrite?: boolean;\n}): SpecialistProfile {\n\tconst scope = options.scope ?? \"project\";\n\tconst name = normalizeSpecialistProfileName(options.name);\n\tconst path = getSpecialistProfilePath(name, scope, options.workspaceDir);\n\tif (existsSync(path) && !options.overwrite) {\n\t\tthrow new Error(`specialist profile already exists: ${name}`);\n\t}\n\tconst now = options.now ?? new Date().toISOString();\n\tconst prompt = options.prompt.trim();\n\tif (!prompt) {\n\t\tthrow new Error(\"profile prompt is required\");\n\t}\n\tmkdirSync(getSpecialistProfileDir(scope, options.workspaceDir), {\n\t\trecursive: true,\n\t});\n\tconst frontmatter = YAML.stringify({\n\t\tname,\n\t\tdescription: options.description,\n\t\ttools: options.tools,\n\t\tmodel: options.model,\n\t\tcreatedAt: now,\n\t\tupdatedAt: now,\n\t});\n\twriteTextFileAtomic(path, `---\\n${frontmatter}---\\n\\n${prompt}\\n`);\n\treturn {\n\t\tname,\n\t\tdescription: options.description,\n\t\tprompt,\n\t\ttools: options.tools,\n\t\tmodel: options.model,\n\t\tscope,\n\t\tpath,\n\t\tcreatedAt: now,\n\t\tupdatedAt: now,\n\t};\n}\n\nexport function readSpecialistProfile(\n\tpath: string,\n\tscope: SpecialistProfileScope,\n): SpecialistProfile {\n\tconst content = readFileSync(path, \"utf-8\");\n\tconst parsed = parseProfileMarkdown(content);\n\tconst name =\n\t\ttypeof parsed.metadata.name === \"string\"\n\t\t\t? normalizeSpecialistProfileName(parsed.metadata.name)\n\t\t\t: normalizeSpecialistProfileName(basename(path, \".md\"));\n\treturn {\n\t\tname,\n\t\tdescription:\n\t\t\ttypeof parsed.metadata.description === \"string\"\n\t\t\t\t? parsed.metadata.description\n\t\t\t\t: undefined,\n\t\tprompt: parsed.body.trim(),\n\t\ttools: Array.isArray(parsed.metadata.tools)\n\t\t\t? parsed.metadata.tools.filter(\n\t\t\t\t\t(tool): tool is string => typeof tool === \"string\",\n\t\t\t\t)\n\t\t\t: undefined,\n\t\tmodel:\n\t\t\ttypeof parsed.metadata.model === \"string\"\n\t\t\t\t? parsed.metadata.model\n\t\t\t\t: undefined,\n\t\tscope,\n\t\tpath,\n\t\tcreatedAt:\n\t\t\ttypeof parsed.metadata.createdAt === \"string\"\n\t\t\t\t? parsed.metadata.createdAt\n\t\t\t\t: undefined,\n\t\tupdatedAt:\n\t\t\ttypeof parsed.metadata.updatedAt === \"string\"\n\t\t\t\t? parsed.metadata.updatedAt\n\t\t\t\t: undefined,\n\t};\n}\n\nexport function listSpecialistProfiles(\n\tworkspaceDir = process.cwd(),\n): SpecialistProfile[] {\n\tconst byName = new Map<string, SpecialistProfile>();\n\tfor (const scope of [\"user\", \"project\"] as const) {\n\t\tconst dir = getSpecialistProfileDir(scope, workspaceDir);\n\t\tif (!existsSync(dir)) continue;\n\t\tfor (const entry of readdirSync(dir, { withFileTypes: true })) {\n\t\t\tif (!entry.isFile() || !entry.name.endsWith(\".md\")) continue;\n\t\t\ttry {\n\t\t\t\tconst profile = readSpecialistProfile(join(dir, entry.name), scope);\n\t\t\t\tbyName.set(profile.name, profile);\n\t\t\t} catch (error) {\n\t\t\t\tlogger.debug(\"Failed to read specialist profile\", {\n\t\t\t\t\tfile: entry.name,\n\t\t\t\t\tscope,\n\t\t\t\t\terror,\n\t\t\t\t});\n\t\t\t}\n\t\t}\n\t}\n\treturn [...byName.values()].sort((left, right) =>\n\t\tleft.name.localeCompare(right.name),\n\t);\n}\n\nexport function resolveSpecialistProfile(\n\tname: string,\n\tworkspaceDir = process.cwd(),\n): SpecialistProfile | null {\n\tconst normalized = normalizeSpecialistProfileName(name);\n\treturn (\n\t\tlistSpecialistProfiles(workspaceDir).find(\n\t\t\t(profile) => profile.name === normalized,\n\t\t) ?? null\n\t);\n}\n\nexport function deleteSpecialistProfile(options: {\n\tname: string;\n\tscope?: SpecialistProfileScope;\n\tworkspaceDir?: string;\n}): boolean {\n\tconst scope = options.scope ?? \"project\";\n\tconst path = getSpecialistProfilePath(\n\t\toptions.name,\n\t\tscope,\n\t\toptions.workspaceDir,\n\t);\n\tif (!existsSync(path)) return false;\n\tunlinkSync(path);\n\treturn true;\n}\n\nexport function applySpecialistProfileToPrompt(\n\tprompt: string,\n\tprofile: SpecialistProfile | null | undefined,\n): string {\n\tif (!profile) return prompt;\n\treturn [\n\t\t`Specialist profile: ${profile.name}`,\n\t\tprofile.description ? `Description: ${profile.description}` : \"\",\n\t\t\"Profile instructions:\",\n\t\tprofile.prompt,\n\t\t\"\",\n\t\t\"Assigned task:\",\n\t\tprompt,\n\t]\n\t\t.filter(Boolean)\n\t\t.join(\"\\n\");\n}\n\nfunction parseProfileMarkdown(content: string): {\n\tmetadata: Record<string, unknown>;\n\tbody: string;\n} {\n\tif (!content.startsWith(\"---\\n\")) {\n\t\treturn { metadata: {}, body: content };\n\t}\n\tconst end = content.indexOf(\"\\n---\", 4);\n\tif (end === -1) return { metadata: {}, body: content };\n\tconst frontmatter = content.slice(4, end);\n\tconst body = content.slice(end + 4).replace(/^\\r?\\n/u, \"\");\n\tconst metadata = YAML.parse(frontmatter);\n\treturn {\n\t\tmetadata:\n\t\t\tmetadata && typeof metadata === \"object\"\n\t\t\t\t? (metadata as Record<string, unknown>)\n\t\t\t\t: {},\n\t\tbody,\n\t};\n}\n"]}

package/dist/agent/subagent-specs.d.ts

@@ -8,13 +8,14 @@
  * - coder: Full coding capabilities
  * - reviewer: Read-only with web access for reviewing code
  * - researcher: Web search and fetch focused
+ * - browser-qa: Browser-based product QA with screenshots and repro evidence
  *
  * Inspired by Amp's subagentSpec/subagentType system.
  */
 /**
  * Available subagent types.
  */
-export type SubagentType = "explorer" | "planner" | "coder" | "reviewer" | "researcher" | "minimal" | "custom";
+export type SubagentType = "explorer" | "planner" | "coder" | "reviewer" | "test-runner" | "researcher" | "browser-qa" | "minimal" | "custom";
 /**
  * Tool categories for easier specification.
  */
@@ -27,6 +28,8 @@ export declare const TOOL_CATEGORIES: {
     readonly shell: readonly ["bash", "background_tasks"];
     /** Web and external tools */
     readonly web: readonly ["websearch", "webfetch", "codesearch"];
+    /** Browser/product QA tools */
+    readonly browser: readonly ["agent_browser", "browser_open", "browser_snapshot", "browser_click", "browser_fill", "browser_type", "browser_screenshot", "browser_console", "browser_record", "read_page", "search_page", "find_on_page", "extract_links", "wait_for_selector", "click_element", "type_text", "scroll_page", "select_element", "navigate_to", "open_links_in_tabs", "highlight_element", "browser_operator", "mouse_action", "pointer_action", "keyboard_action", "extract_table_data", "capture_network", "capture_console_errors", "collect_diagnostics", "extract_document", "capture_screenshot", "native_click", "native_type", "native_press", "native_key_down", "native_key_up"];
     /** Interactive tools */
     readonly interactive: readonly ["ask_user", "todo"];
     /** GitHub tools */

package/dist/agent/subagent-specs.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"subagent-specs.d.ts","sourceRoot":"","sources":["../../src/agent/subagent-specs.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAOH;;GAEG;AACH,MAAM,MAAM,YAAY,GACrB,UAAU,GACV,SAAS,GACT,OAAO,GACP,UAAU,GACV,YAAY,GACZ,SAAS,GACT,QAAQ,CAAC;AAEZ;;GAEG;AACH,eAAO,MAAM,eAAe;IAC3B,kCAAkC;;IAUlC,8BAA8B;;IAE9B,sBAAsB;;IAEtB,6BAA6B;;IAE7B,wBAAwB;;IAExB,mBAAmB;;IAEnB,qBAAqB;;CAEZ,CAAC;AAeX;;GAEG;AACH,MAAM,WAAW,YAAY;IAC5B,mBAAmB;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,+CAA+C;IAC/C,WAAW,EAAE,MAAM,CAAC;IACpB,yCAAyC;IACzC,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,0DAA0D;IAC1D,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IACvB,uDAAuD;IACvD,QAAQ,EAAE,OAAO,CAAC;IAClB,wCAAwC;IACxC,YAAY,EAAE,OAAO,CAAC;IACtB,4CAA4C;IAC5C,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,8DAA8D;IAC9D,mBAAmB,CAAC,EAAE,OAAO,CAAC;CAC9B;AAED;;GAEG;AACH,eAAO,MAAM,cAAc,EAAE,MAAM,CAAC,YAAY,EAAE,YAAY,CA6E7D,CAAC;AAEF;;GAEG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,YAAY,GAAG,YAAY,CAEhE;AAED;;GAEG;AACH,wBAAgB,aAAa,CAC5B,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,YAAY,EAClB,UAAU,CAAC,EAAE,OAAO,CAAC,YAAY,CAAC,GAChC,OAAO,CAeT;AAED;;GAEG;AACH,wBAAgB,eAAe,CAC9B,IAAI,EAAE,YAAY,EAClB,UAAU,CAAC,EAAE,OAAO,CAAC,YAAY,CAAC,GAChC,MAAM,EAAE,CAgBV;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,CAAC,SAAS;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,EAChE,KAAK,EAAE,CAAC,EAAE,EACV,IAAI,EAAE,YAAY,EAClB,UAAU,CAAC,EAAE,OAAO,CAAC,YAAY,CAAC,GAChC,CAAC,EAAE,CAOL;AAOD;;GAEG;AACH,wBAAgB,sBAAsB,IAAI,YAAY,CAErD;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,YAAY,GAAG,IAAI,CAG/D;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,YAAY,GAAG,IAAI,CAMtE;AAED;;GAEG;AACH,wBAAgB,sBAAsB,IAAI,YAAY,CAMrD;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,YAAY,GAAG,MAAM,CAGhE;AAED;;GAEG;AACH,wBAAgB,mBAAmB,IAAI,KAAK,CAAC;IAC5C,IAAI,EAAE,YAAY,CAAC;IACnB,IAAI,EAAE,YAAY,CAAC;CACnB,CAAC,CAOD;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAC/B,QAAQ,EAAE,YAAY,EACtB,SAAS,EAAE,OAAO,CAAC,YAAY,CAAC,GAC9B,YAAY,CAOd;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,OAAO,CAAC,YAAY,CAAC,GAAG,MAAM,EAAE,CAYlE"}
+{"version":3,"file":"subagent-specs.d.ts","sourceRoot":"","sources":["../../src/agent/subagent-specs.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAQH;;GAEG;AACH,MAAM,MAAM,YAAY,GACrB,UAAU,GACV,SAAS,GACT,OAAO,GACP,UAAU,GACV,aAAa,GACb,YAAY,GACZ,YAAY,GACZ,SAAS,GACT,QAAQ,CAAC;AAWZ;;GAEG;AACH,eAAO,MAAM,eAAe;IAC3B,kCAAkC;;IAUlC,8BAA8B;;IAE9B,sBAAsB;;IAEtB,6BAA6B;;IAE7B,+BAA+B;;IAuC/B,wBAAwB;;IAExB,mBAAmB;;IAEnB,qBAAqB;;CAEZ,CAAC;AAeX;;GAEG;AACH,MAAM,WAAW,YAAY;IAC5B,mBAAmB;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,+CAA+C;IAC/C,WAAW,EAAE,MAAM,CAAC;IACpB,yCAAyC;IACzC,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,0DAA0D;IAC1D,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IACvB,uDAAuD;IACvD,QAAQ,EAAE,OAAO,CAAC;IAClB,wCAAwC;IACxC,YAAY,EAAE,OAAO,CAAC;IACtB,4CAA4C;IAC5C,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,8DAA8D;IAC9D,mBAAmB,CAAC,EAAE,OAAO,CAAC;CAC9B;AAED;;GAEG;AACH,eAAO,MAAM,cAAc,EAAE,MAAM,CAAC,YAAY,EAAE,YAAY,CAwG7D,CAAC;AAEF;;GAEG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,YAAY,GAAG,YAAY,CAEhE;AAED;;GAEG;AACH,wBAAgB,aAAa,CAC5B,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,YAAY,EAClB,UAAU,CAAC,EAAE,OAAO,CAAC,YAAY,CAAC,GAChC,OAAO,CAeT;AAED;;GAEG;AACH,wBAAgB,eAAe,CAC9B,IAAI,EAAE,YAAY,EAClB,UAAU,CAAC,EAAE,OAAO,CAAC,YAAY,CAAC,GAChC,MAAM,EAAE,CAgBV;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,CAAC,SAAS;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,EAChE,KAAK,EAAE,CAAC,EAAE,EACV,IAAI,EAAE,YAAY,EAClB,UAAU,CAAC,EAAE,OAAO,CAAC,YAAY,CAAC,GAChC,CAAC,EAAE,CAOL;AAOD;;GAEG;AACH,wBAAgB,sBAAsB,IAAI,YAAY,CAErD;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,YAAY,GAAG,IAAI,CAG/D;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,YAAY,GAAG,IAAI,CAQtE;AAED;;GAEG;AACH,wBAAgB,sBAAsB,IAAI,YAAY,CAErD;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,YAAY,GAAG,MAAM,CAGhE;AAED;;GAEG;AACH,wBAAgB,mBAAmB,IAAI,KAAK,CAAC;IAC5C,IAAI,EAAE,YAAY,CAAC;IACnB,IAAI,EAAE,YAAY,CAAC;CACnB,CAAC,CAOD;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAC/B,QAAQ,EAAE,YAAY,EACtB,SAAS,EAAE,OAAO,CAAC,YAAY,CAAC,GAC9B,YAAY,CAOd;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,OAAO,CAAC,YAAY,CAAC,GAAG,MAAM,EAAE,CAYlE"}

package/dist/agent/subagent-specs.js

@@ -8,12 +8,22 @@
  * - coder: Full coding capabilities
  * - reviewer: Read-only with web access for reviewing code
  * - researcher: Web search and fetch focused
+ * - browser-qa: Browser-based product QA with screenshots and repro evidence
  *
  * Inspired by Amp's subagentSpec/subagentType system.
  */
+import { codexSubagentLaneForType } from "../codex/subagent-dispatch-table.js";
 import { createLogger } from "../utils/logger.js";
 import { normalizeToolNameForSafety } from "../utils/safety-normalization.js";
 const logger = createLogger("agent:subagent-specs");
+const CODEX_LANE_SUBAGENT_TYPES = {
+    "code-writer": "coder",
+    "code-review": "reviewer",
+    "test-runner": "test-runner",
+    "browser-qa": "browser-qa",
+    "repo-explorer": "explorer",
+    "release-shepherd": "coder",
+};
 /**
  * Tool categories for easier specification.
  */
@@ -34,6 +44,45 @@ export const TOOL_CATEGORIES = {
     shell: ["bash", "background_tasks"],
     /** Web and external tools */
     web: ["websearch", "webfetch", "codesearch"],
+    /** Browser/product QA tools */
+    browser: [
+        "agent_browser",
+        "browser_open",
+        "browser_snapshot",
+        "browser_click",
+        "browser_fill",
+        "browser_type",
+        "browser_screenshot",
+        "browser_console",
+        "browser_record",
+        "read_page",
+        "search_page",
+        "find_on_page",
+        "extract_links",
+        "wait_for_selector",
+        "click_element",
+        "type_text",
+        "scroll_page",
+        "select_element",
+        "navigate_to",
+        "open_links_in_tabs",
+        "highlight_element",
+        "browser_operator",
+        "mouse_action",
+        "pointer_action",
+        "keyboard_action",
+        "extract_table_data",
+        "capture_network",
+        "capture_console_errors",
+        "collect_diagnostics",
+        "extract_document",
+        "capture_screenshot",
+        "native_click",
+        "native_type",
+        "native_press",
+        "native_key_down",
+        "native_key_up",
+    ],
     /** Interactive tools */
     interactive: ["ask_user", "todo"],
     /** GitHub tools */
@@ -92,6 +141,18 @@ export const SUBAGENT_SPECS = {
         maxToolCallsPerTurn: 15,
         requireConfirmation: false,
     },
+    "test-runner": {
+        displayName: "Test Runner",
+        description: "Test execution mode - can run checks and inspect results",
+        allowedTools: [
+            ...toolsFromCategories("read", "shell", "interactive"),
+            "webfetch",
+        ],
+        allowMcp: false,
+        allowToolbox: false,
+        maxToolCallsPerTurn: 20,
+        requireConfirmation: false,
+    },
     researcher: {
         displayName: "Researcher",
         description: "Research mode - focused on web search and analysis",
@@ -101,6 +162,20 @@ export const SUBAGENT_SPECS = {
         maxToolCallsPerTurn: 20,
         requireConfirmation: false,
     },
+    "browser-qa": {
+        displayName: "Browser QA",
+        description: "Product QA mode - explores web surfaces and captures repro evidence",
+        allowedTools: [
+            ...toolsFromCategories("read", "web", "browser"),
+            "bash",
+            "ask_user",
+            "todo",
+        ],
+        allowMcp: true,
+        allowToolbox: true,
+        maxToolCallsPerTurn: 25,
+        requireConfirmation: false,
+    },
     minimal: {
         displayName: "Minimal",
         description: "Minimal capabilities - only basic read operations",
@@ -189,20 +264,18 @@ export function setCurrentSubagentType(type) {
  */
 export function parseSubagentType(typeStr) {
     const normalized = normalizeToolNameForSafety(typeStr);
-    if (normalized in SUBAGENT_SPECS) {
-        return normalized;
+    const hyphenated = normalized.replace(/_/g, "-");
+    if (hyphenated in SUBAGENT_SPECS) {
+        return hyphenated;
     }
-    return null;
+    const lane = codexSubagentLaneForType(typeStr);
+    return lane ? (CODEX_LANE_SUBAGENT_TYPES[lane.laneId] ?? null) : null;
 }
 /**
  * Get subagent type from environment variable.
  */
 export function getSubagentTypeFromEnv() {
-    const envType = process.env.MAESTRO_SUBAGENT_TYPE?.toLowerCase();
-    if (envType && envType in SUBAGENT_SPECS) {
-        return envType;
-    }
-    return "coder";
+    return parseSubagentType(process.env.MAESTRO_SUBAGENT_TYPE ?? "") ?? "coder";
 }
 /**
  * Format subagent type for display.