@developerz.ai/aitm 0.0.0

package/dist/state/schema.d.ts

@@ -0,0 +1,88 @@
+import { z } from 'zod';
+export declare const PrGroupStatusSchema: z.ZodEnum<{
+    pending: "pending";
+    "in-progress": "in-progress";
+    "awaiting-pr": "awaiting-pr";
+    merged: "merged";
+    blocked: "blocked";
+}>;
+export type PrGroupStatus = z.infer<typeof PrGroupStatusSchema>;
+export declare const PrGroupSchema: z.ZodObject<{
+    id: z.ZodString;
+    title: z.ZodString;
+    tasks: z.ZodArray<z.ZodString>;
+    dependsOn: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    branch: z.ZodNullable<z.ZodString>;
+    pr: z.ZodNullable<z.ZodNumber>;
+    status: z.ZodEnum<{
+        pending: "pending";
+        "in-progress": "in-progress";
+        "awaiting-pr": "awaiting-pr";
+        merged: "merged";
+        blocked: "blocked";
+    }>;
+}, z.core.$strip>;
+export type PrGroup = z.infer<typeof PrGroupSchema>;
+export declare const RunStatusSchema: z.ZodEnum<{
+    success: "success";
+    "awaiting-pr": "awaiting-pr";
+    blocked: "blocked";
+    planning: "planning";
+    working: "working";
+    reviewing: "reviewing";
+    failed: "failed";
+}>;
+export type RunStatus = z.infer<typeof RunStatusSchema>;
+export declare const RunStateSchema: z.ZodObject<{
+    status: z.ZodEnum<{
+        success: "success";
+        "awaiting-pr": "awaiting-pr";
+        blocked: "blocked";
+        planning: "planning";
+        working: "working";
+        reviewing: "reviewing";
+        failed: "failed";
+    }>;
+    prGroups: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        title: z.ZodString;
+        tasks: z.ZodArray<z.ZodString>;
+        dependsOn: z.ZodDefault<z.ZodArray<z.ZodString>>;
+        branch: z.ZodNullable<z.ZodString>;
+        pr: z.ZodNullable<z.ZodNumber>;
+        status: z.ZodEnum<{
+            pending: "pending";
+            "in-progress": "in-progress";
+            "awaiting-pr": "awaiting-pr";
+            merged: "merged";
+            blocked: "blocked";
+        }>;
+    }, z.core.$strip>>;
+    currentGroupIndex: z.ZodNumber;
+    currentTaskIndex: z.ZodNumber;
+    sessionCount: z.ZodNumber;
+    currentPr: z.ZodNullable<z.ZodNumber>;
+    runId: z.ZodString;
+    provider: z.ZodLiteral<"openrouter">;
+    model: z.ZodString;
+    agentConfigFile: z.ZodEnum<{
+        custom: "custom";
+        "CLAUDE.md": "CLAUDE.md";
+        "AGENTS.md": "AGENTS.md";
+    }>;
+    createdAt: z.ZodString;
+    updatedAt: z.ZodString;
+    options: z.ZodObject<{
+        autoMerge: z.ZodBoolean;
+        maxPrs: z.ZodNumber;
+        maxSessions: z.ZodNullable<z.ZodNumber>;
+        mergeMethod: z.ZodEnum<{
+            squash: "squash";
+            merge: "merge";
+            rebase: "rebase";
+        }>;
+        stylePath: z.ZodNullable<z.ZodString>;
+        concurrency: z.ZodNumber;
+    }, z.core.$strip>;
+}, z.core.$strip>;
+export type RunState = z.infer<typeof RunStateSchema>;

package/dist/state/schema.js

@@ -0,0 +1,53 @@
+// docs/state.md §"state.json schema" and §"PrGroup sub-schema"
+// Source of truth for run-state shape. Extended with PrGroup.dependsOn to support DAG planning.
+import { z } from 'zod';
+export const PrGroupStatusSchema = z.enum([
+    'pending',
+    'in-progress',
+    'awaiting-pr',
+    'merged',
+    'blocked',
+]);
+export const PrGroupSchema = z.object({
+    id: z.string(),
+    title: z.string(),
+    tasks: z.array(z.string()),
+    // Group ids that must be merged before this group is runnable.
+    // Empty array means the group is in the initial ready set. See src/plan/plan-graph.ts.
+    dependsOn: z.array(z.string()).default([]),
+    branch: z.string().nullable(),
+    pr: z.number().int().positive().nullable(),
+    status: PrGroupStatusSchema,
+});
+export const RunStatusSchema = z.enum([
+    'planning',
+    'working',
+    'awaiting-pr',
+    'reviewing',
+    'blocked',
+    'success',
+    'failed',
+]);
+export const RunStateSchema = z.object({
+    status: RunStatusSchema,
+    prGroups: z.array(PrGroupSchema),
+    currentGroupIndex: z.number().int().nonnegative(),
+    currentTaskIndex: z.number().int().nonnegative(),
+    sessionCount: z.number().int().nonnegative(),
+    currentPr: z.number().int().positive().nullable(),
+    runId: z.string(),
+    provider: z.literal('openrouter'),
+    model: z.string(),
+    agentConfigFile: z.enum(['CLAUDE.md', 'AGENTS.md', 'custom']),
+    createdAt: z.string(),
+    updatedAt: z.string(),
+    options: z.object({
+        autoMerge: z.boolean(),
+        maxPrs: z.number().int().positive(),
+        maxSessions: z.number().int().positive().nullable(),
+        mergeMethod: z.enum(['squash', 'merge', 'rebase']),
+        stylePath: z.string().nullable(),
+        concurrency: z.number().int().positive(),
+    }),
+});
+//# sourceMappingURL=schema.js.map

package/dist/state/schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.js","sourceRoot":"","sources":["../../src/state/schema.ts"],"names":[],"mappings":"AAAA,+DAA+D;AAC/D,gGAAgG;AAEhG,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,CAAC,IAAI,CAAC;IACxC,SAAS;IACT,aAAa;IACb,aAAa;IACb,QAAQ;IACR,SAAS;CACV,CAAC,CAAC;AAGH,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,CAAC,MAAM,CAAC;IACpC,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE;IACd,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE;IACjB,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;IAC1B,+DAA+D;IAC/D,uFAAuF;IACvF,SAAS,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC;IAC1C,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC7B,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE;IAC1C,MAAM,EAAE,mBAAmB;CAC5B,CAAC,CAAC;AAGH,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,CAAC,IAAI,CAAC;IACpC,UAAU;IACV,SAAS;IACT,aAAa;IACb,WAAW;IACX,SAAS;IACT,SAAS;IACT,QAAQ;CACT,CAAC,CAAC;AAGH,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,CAAC,MAAM,CAAC;IACrC,MAAM,EAAE,eAAe;IACvB,QAAQ,EAAE,CAAC,CAAC,KAAK,CAAC,aAAa,CAAC;IAChC,iBAAiB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE;IACjD,gBAAgB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE;IAChD,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE;IAC5C,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE;IACjD,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE;IACjB,QAAQ,EAAE,CAAC,CAAC,OAAO,CAAC,YAAY,CAAC;IACjC,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE;IACjB,eAAe,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,WAAW,EAAE,WAAW,EAAE,QAAQ,CAAC,CAAC;IAC7D,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE;IACrB,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE;IACrB,OAAO,EAAE,CAAC,CAAC,MAAM,CAAC;QAChB,SAAS,EAAE,CAAC,CAAC,OAAO,EAAE;QACtB,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE;QACnC,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE;QACnD,WAAW,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE,OAAO,EAAE,QAAQ,CAAC,CAAC;QAClD,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;QAChC,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE;KACzC,CAAC;CACH,CAAC,CAAC"}

package/dist/state/state-store.d.ts

@@ -0,0 +1,16 @@
+import { type RunState } from './schema.ts';
+export declare class StateStore {
+    private readonly stateDir;
+    private updateChain;
+    constructor(stateDir: string);
+    init(initial: RunState): Promise<void>;
+    read(): Promise<RunState>;
+    update(mutator: (s: RunState) => RunState): Promise<RunState>;
+    writeGoal(goal: string, criteria?: string): Promise<void>;
+    writePlan(plan: string): Promise<void>;
+    appendProgress(entry: string): Promise<void>;
+    writeContext(summary: string): Promise<void>;
+    readContext(): Promise<string | null>;
+    cleanupOnSuccess(): Promise<void>;
+    private path;
+}

package/dist/state/state-store.js

@@ -0,0 +1,129 @@
+// docs/state.md
+// Only module that reads or writes .ai-task-master/. Atomic writes via temp file + fsync + rename.
+import { appendFile, mkdir, readdir, readFile, rm } from 'node:fs/promises';
+import { join } from 'node:path';
+import { ZodError } from 'zod';
+import { atomicWrite } from "../fs/atomic-write.js";
+import { RunStateSchema } from "./schema.js";
+const STATE_FILE = 'state.json';
+const GOAL_FILE = 'goal.txt';
+const CRITERIA_FILE = 'criteria.txt';
+const PLAN_FILE = 'plan.md';
+const PROGRESS_FILE = 'progress.md';
+const CONTEXT_FILE = 'context.md';
+const LOGS_DIR = 'logs';
+export class StateStore {
+    stateDir;
+    // Chained promise serializes concurrent update() calls so they observe linear semantics.
+    // Each caller awaits the prior in-flight update before its read → mutate → write runs,
+    // preventing lost updates when callers race via Promise.all.
+    updateChain = Promise.resolve();
+    constructor(stateDir) {
+        this.stateDir = stateDir;
+    }
+    async init(initial) {
+        const validated = RunStateSchema.parse(initial);
+        await mkdir(this.stateDir, { recursive: true });
+        await mkdir(join(this.stateDir, LOGS_DIR), { recursive: true });
+        await atomicWrite(this.path(STATE_FILE), `${JSON.stringify(validated, null, 2)}\n`);
+    }
+    async read() {
+        const path = this.path(STATE_FILE);
+        const raw = await readFile(path, 'utf8');
+        let parsed;
+        try {
+            parsed = JSON.parse(raw);
+        }
+        catch (err) {
+            const msg = err instanceof Error ? err.message : String(err);
+            throw new Error(`${path}: invalid JSON — ${msg}`);
+        }
+        return parseState(parsed, path);
+    }
+    async update(mutator) {
+        const next = this.updateChain.then(async () => {
+            const current = await this.read();
+            const draft = mutator(current);
+            const updated = { ...draft, updatedAt: new Date().toISOString() };
+            const validated = parseState(updated, this.path(STATE_FILE));
+            await atomicWrite(this.path(STATE_FILE), `${JSON.stringify(validated, null, 2)}\n`);
+            return validated;
+        });
+        // Swallow rejection on the chain so a failed update doesn't poison subsequent callers.
+        // The original `next` promise still rejects for the caller that owns this update.
+        this.updateChain = next.catch(() => undefined);
+        return next;
+    }
+    async writeGoal(goal, criteria) {
+        await mkdir(this.stateDir, { recursive: true });
+        await atomicWrite(this.path(GOAL_FILE), ensureTrailingNewline(goal));
+        if (criteria !== undefined) {
+            await atomicWrite(this.path(CRITERIA_FILE), ensureTrailingNewline(criteria));
+        }
+    }
+    async writePlan(plan) {
+        await mkdir(this.stateDir, { recursive: true });
+        await atomicWrite(this.path(PLAN_FILE), ensureTrailingNewline(plan));
+    }
+    async appendProgress(entry) {
+        await mkdir(this.stateDir, { recursive: true });
+        await appendFile(this.path(PROGRESS_FILE), ensureTrailingNewline(entry));
+    }
+    async writeContext(summary) {
+        await mkdir(this.stateDir, { recursive: true });
+        await atomicWrite(this.path(CONTEXT_FILE), ensureTrailingNewline(summary));
+    }
+    async readContext() {
+        try {
+            return await readFile(this.path(CONTEXT_FILE), 'utf8');
+        }
+        catch (err) {
+            if (isNotFound(err))
+                return null;
+            throw err;
+        }
+    }
+    async cleanupOnSuccess() {
+        let entries;
+        try {
+            entries = await readdir(this.stateDir);
+        }
+        catch (err) {
+            if (isNotFound(err))
+                return;
+            throw err;
+        }
+        for (const entry of entries) {
+            if (entry === LOGS_DIR)
+                continue;
+            await rm(this.path(entry), { recursive: true, force: true });
+        }
+    }
+    path(name) {
+        return join(this.stateDir, name);
+    }
+}
+function parseState(value, path) {
+    try {
+        return RunStateSchema.parse(value);
+    }
+    catch (err) {
+        if (err instanceof ZodError) {
+            throw new Error(`${path}: ${formatZodError(err)}`);
+        }
+        throw err;
+    }
+}
+function ensureTrailingNewline(s) {
+    return s.endsWith('\n') ? s : `${s}\n`;
+}
+function isNotFound(err) {
+    return (typeof err === 'object' &&
+        err !== null &&
+        'code' in err &&
+        err.code === 'ENOENT');
+}
+function formatZodError(err) {
+    return err.issues.map((i) => `${i.path.join('.') || '<root>'}: ${i.message}`).join('; ');
+}
+//# sourceMappingURL=state-store.js.map

package/dist/state/state-store.js.map

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

package/dist/subagents/factory.d.ts

@@ -0,0 +1,8 @@
+import type { LanguageModel, ToolSet } from 'ai';
+export type SubagentInit<TTools extends ToolSet = ToolSet> = {
+    model: LanguageModel;
+    tools: TTools;
+    systemPrompt: string;
+    maxSteps?: number;
+};
+export type SubagentFactory<TInit, TAgent> = (init: TInit) => TAgent;

package/dist/subagents/factory.js

@@ -0,0 +1,10 @@
+// docs/subagents.md §"SRP + tested" — every subagent is a pure factory:
+//   (model, tools, systemPrompt) -> Agent
+// SDK reference: docs/vendor/ai-sdk/chunk-04.md §"ToolLoopAgent" (note: CLAUDE.md
+// still says experimental_Agent — that is the legacy AI SDK 5 name; v6 ships ToolLoopAgent).
+//
+// The ToolLoopAgent wrapper (`createSubagent`) and the system-prompt composer
+// (`composeSystemPrompt`) now live in @developerz.ai/ai-claude-compat; the concrete factories
+// (planner.ts/worker.ts/reviewer.ts) call createSubagent with their own tools + output type.
+export {};
+//# sourceMappingURL=factory.js.map

package/dist/subagents/factory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"factory.js","sourceRoot":"","sources":["../../src/subagents/factory.ts"],"names":[],"mappings":"AAAA,wEAAwE;AACxE,0CAA0C;AAC1C,kFAAkF;AAClF,6FAA6F;AAC7F,EAAE;AACF,8EAA8E;AAC9E,8FAA8F;AAC9F,6FAA6F"}

package/dist/subagents/planner.d.ts

@@ -0,0 +1,31 @@
+import type { GlobInput, GlobOutput, GrepInput, GrepOutput, ReadFileInput, ReadFileOutput } from '@developerz.ai/ai-claude-compat';
+import { type DeepPartial, Output, type Tool, type ToolLoopAgent } from 'ai';
+import { type Plan } from '../plan/schema.ts';
+import type { SubagentInit } from './factory.ts';
+type PlannerOutput = Output.Output<Plan, DeepPartial<Plan>, never>;
+export type PlannerAgent = ToolLoopAgent<never, PlannerTools, PlannerOutput>;
+export type PlannerTools = {
+    readFile: Tool<ReadFileInput, ReadFileOutput>;
+    grep: Tool<GrepInput, GrepOutput>;
+    glob: Tool<GlobInput, GlobOutput>;
+};
+export type PlannerInput = {
+    goal: string;
+    criteria?: string;
+    styleContents: string;
+    maxPrs: number;
+};
+export type PlannerResult = {
+    kind: 'ok';
+    plan: Plan;
+} | {
+    kind: 'blocked';
+    reason: string;
+} | {
+    kind: 'error';
+    error: string;
+};
+export declare const PLANNER_SYSTEM_PREFIX: string;
+export declare function createPlannerAgent(init: SubagentInit<PlannerTools>): PlannerAgent;
+export declare function runPlanner(agent: PlannerAgent, input: PlannerInput): Promise<PlannerResult>;
+export {};

package/dist/subagents/planner.js

@@ -0,0 +1,83 @@
+// docs/subagents.md (Planner row), docs/task-groups.md, docs/agent-config-detection.md
+// Goal + repo survey → ordered PR groups (DAG) with Zod-validated output.
+// SDK reference: docs/vendor/ai-sdk/chunk-09.md §"Subagents" + chunk-05.md §"Generating Structured Data".
+import { createSubagent } from '@developerz.ai/ai-claude-compat';
+import { Output } from 'ai';
+import { PlanSchema } from "../plan/schema.js";
+// Inlined per CLAUDE.md "no premature abstraction". The Orchestrator builds the
+// caller-side system prompt as `styleContents + PLANNER_SYSTEM_PREFIX` so the
+// agent inherits the repo's house style alongside its role.
+export const PLANNER_SYSTEM_PREFIX = [
+    '',
+    'You are the Planner subagent. You receive a goal and an optional acceptance criteria.',
+    'You output a directed-acyclic plan of PR groups: each group is one cohesive pull request,',
+    'roughly 300 lines of code, that can be reviewed independently. Use read-only repo tools',
+    '(readFile, glob, grep) to ground the plan in the actual code before emitting it.',
+    '',
+    'Rules:',
+    '- Emit at most maxPrs groups. If the work is larger, fold the tail into the last group.',
+    '- Each group has a stable id (slug), a one-line title, an ordered list of tasks,',
+    '  and a dependsOn list of earlier group ids. dependsOn is empty for the root(s).',
+    '- Prefer parallelizable siblings over a single linear chain.',
+    '- Do not invent files. Do not propose work outside the repo.',
+    '',
+    'Return JSON that matches the Plan schema exactly.',
+].join('\n');
+export function createPlannerAgent(init) {
+    return createSubagent({
+        model: init.model,
+        tools: init.tools,
+        systemPrompt: init.systemPrompt,
+        output: plannerOutput(),
+        ...(init.maxSteps !== undefined ? { maxSteps: init.maxSteps } : {}),
+    }, 20);
+}
+export async function runPlanner(agent, input) {
+    if (!Number.isInteger(input.maxPrs) || input.maxPrs < 1) {
+        return { kind: 'error', error: `maxPrs must be a positive integer, received ${input.maxPrs}` };
+    }
+    try {
+        const result = await agent.generate({ prompt: buildUserPrompt(input) });
+        const raw = result.experimental_output;
+        if (!raw.groups || raw.groups.length === 0) {
+            return { kind: 'blocked', reason: 'planner returned an empty group list' };
+        }
+        return { kind: 'ok', plan: capGroups(raw, input.maxPrs) };
+    }
+    catch (err) {
+        return { kind: 'error', error: err instanceof Error ? err.message : String(err) };
+    }
+}
+function plannerOutput() {
+    return Output.object({ schema: PlanSchema, name: 'Plan' });
+}
+function buildUserPrompt(input) {
+    const lines = [`Goal: ${input.goal}`];
+    if (input.criteria?.trim()) {
+        lines.push(`Acceptance criteria: ${input.criteria}`);
+    }
+    lines.push(`maxPrs: ${input.maxPrs}`);
+    lines.push('Survey the repo with the read-only tools, then emit the Plan JSON.');
+    return lines.join('\n');
+}
+// Truncate to maxPrs groups; fold any overflow into a single remainder task on
+// the last kept group so no work is silently dropped.
+function capGroups(plan, maxPrs) {
+    if (plan.groups.length <= maxPrs)
+        return plan;
+    const kept = plan.groups.slice(0, maxPrs);
+    const overflow = plan.groups.slice(maxPrs);
+    const lastKept = kept[maxPrs - 1];
+    if (!lastKept)
+        return plan;
+    const remainder = {
+        description: `remainder: ${overflow.map(summarizeGroup).join('; ')}`,
+    };
+    const merged = { ...lastKept, tasks: [...lastKept.tasks, remainder] };
+    const newGroups = [...kept.slice(0, maxPrs - 1), merged];
+    return { ...plan, groups: newGroups };
+}
+function summarizeGroup(g) {
+    return `${g.id} (${g.tasks.length} tasks)`;
+}
+//# sourceMappingURL=planner.js.map

package/dist/subagents/planner.js.map

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

package/dist/subagents/reviewer.d.ts

@@ -0,0 +1,60 @@
+import { type DeepPartial, Output, type Tool, type ToolLoopAgent } from 'ai';
+import { z } from 'zod';
+import type { ReviewThread } from '../github/schema.ts';
+import type { SubagentInit } from './factory.ts';
+import type { WorkerTools } from './worker.ts';
+export type GithubToolInput = {
+    action: 'replyToThread' | 'resolveThread';
+    threadId: string;
+    body?: string | undefined;
+};
+export type GithubToolOutput = {
+    ok: boolean;
+};
+export type ReviewerTools = WorkerTools & {
+    github: Tool<GithubToolInput, GithubToolOutput>;
+};
+export declare const ThreadResolutionOutputSchema: z.ZodObject<{
+    kind: z.ZodEnum<{
+        fixed: "fixed";
+        replied: "replied";
+        wontfix: "wontfix";
+    }>;
+    commitMessage: z.ZodOptional<z.ZodString>;
+    reason: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type ThreadResolutionOutput = z.infer<typeof ThreadResolutionOutputSchema>;
+type ReviewerAgentOutput = Output.Output<ThreadResolutionOutput, DeepPartial<ThreadResolutionOutput>, never>;
+export type ReviewerAgent = ToolLoopAgent<never, ReviewerTools, ReviewerAgentOutput>;
+export type ReviewerInput = {
+    pr: number;
+    threads: ReviewThread[];
+    worktreePath: string;
+    styleContents: string;
+};
+export type ThreadResolution = {
+    threadId: string;
+    kind: 'fixed';
+    commitSha: string;
+} | {
+    threadId: string;
+    kind: 'replied';
+} | {
+    threadId: string;
+    kind: 'wontfix';
+    reason: string;
+};
+export type ReviewerResult = {
+    kind: 'ok';
+    resolutions: ThreadResolution[];
+} | {
+    kind: 'blocked';
+    reason: string;
+} | {
+    kind: 'error';
+    error: string;
+};
+export declare const REVIEWER_SYSTEM_PREFIX: string;
+export declare function createReviewerAgent(init: SubagentInit<ReviewerTools>): ReviewerAgent;
+export declare function runReviewer(agent: ReviewerAgent, input: ReviewerInput): Promise<ReviewerResult>;
+export {};