agent-composer 0.3.1 → 0.4.1

package/dist/tools/goal.js

@@ -0,0 +1,159 @@
+import { z } from "zod";
+import { COMPOSER_GOAL_CLEAR, COMPOSER_GOAL_REPORT, COMPOSER_GOAL_START, COMPOSER_GOAL_STATUS, COMPOSER_GOAL_STEP, GOAL_CLEAR_DESCRIPTION, GOAL_REPORT_DESCRIPTION, GOAL_START_DESCRIPTION, GOAL_STEP_DESCRIPTION, GOAL_STATUS_DESCRIPTION, } from "../server/toolDescriptions.js";
+import { buildGoalReport, renderGoalReportMarkdown } from "../util/goalReport.js";
+import { clearGoal, isTerminal, readActiveGoal, readGoal, startGoal, stepGoal } from "../util/goal.js";
+export function registerGoalTools(ctx) {
+    const { server } = ctx;
+    server.registerTool(COMPOSER_GOAL_START, {
+        description: `${GOAL_START_DESCRIPTION} Use when storing objective/condition and check command strings as data only - the substrate never runs them.`,
+        inputSchema: {
+            objective: z.string().min(1),
+            condition: z.string().min(1),
+            checks: z.array(z.object({ name: z.string().min(1), command: z.string().min(1) })).optional(),
+            maxTurns: z.number().int().positive().optional(),
+            maxCost: z.number().nonnegative().optional(),
+            workflow: z.string().optional(),
+            mode: z.string().optional(),
+            risk: z.string().optional(),
+        },
+        annotations: {
+            title: "Composer Goal Start",
+            readOnlyHint: false,
+            destructiveHint: false,
+            idempotentHint: false,
+            openWorldHint: false,
+        },
+    }, async (input) => {
+        const record = startGoal(ctx.root, input);
+        const summary = {
+            goalId: record.goalId,
+            state: record.state,
+            turns: record.turns,
+            nextAction: { tool: "composer_route_decide", reason: "begin" },
+            checks: record.checks,
+        };
+        return { content: [{ type: "text", text: JSON.stringify(summary, null, 2) }] };
+    });
+    server.registerTool(COMPOSER_GOAL_STATUS, {
+        description: GOAL_STATUS_DESCRIPTION,
+        inputSchema: {
+            goalId: z.string().optional(),
+        },
+        annotations: {
+            title: "Composer Goal Status",
+            readOnlyHint: true,
+            destructiveHint: false,
+            idempotentHint: true,
+            openWorldHint: false,
+        },
+    }, async ({ goalId }) => {
+        const record = goalId ? readGoal(ctx.root, goalId) : readActiveGoal(ctx.root);
+        const summary = record
+            ? {
+                goalId: record.goalId,
+                state: record.state,
+                turns: record.turns,
+                maxTurns: record.maxTurns,
+                checks: record.checks,
+                lastAction: record.lastAction,
+                lastVerdict: record.lastVerdict,
+                lastReason: record.lastReason,
+            }
+            : { state: "none" };
+        return { content: [{ type: "text", text: JSON.stringify(summary, null, 2) }] };
+    });
+    server.registerTool(COMPOSER_GOAL_REPORT, {
+        description: GOAL_REPORT_DESCRIPTION,
+        inputSchema: {
+            goalId: z.string().optional(),
+            format: z.enum(["json", "markdown"]).default("json").optional(),
+            includeAudit: z.boolean().default(false).optional(),
+            auditLimit: z.number().int().nonnegative().default(100).optional(),
+            includeCommands: z.boolean().default(false).optional(),
+            includeAuditEvents: z.boolean().default(false).optional(),
+        },
+        annotations: {
+            title: "Composer Goal Report",
+            readOnlyHint: true,
+            destructiveHint: false,
+            idempotentHint: true,
+            openWorldHint: false,
+        },
+    }, async ({ goalId, format = "json", includeAudit = false, auditLimit = 100, includeCommands = false, includeAuditEvents = false, }) => {
+        const report = buildGoalReport(ctx.root, {
+            goalId,
+            includeAudit,
+            auditLimit,
+            includeCommands,
+            includeAuditEvents,
+        });
+        const text = format === "markdown"
+            ? renderGoalReportMarkdown(report, { includeCommands, includeAuditEvents })
+            : JSON.stringify(report, null, 2);
+        return { content: [{ type: "text", text }] };
+    });
+    server.registerTool(COMPOSER_GOAL_STEP, {
+        description: GOAL_STEP_DESCRIPTION,
+        inputSchema: {
+            goalId: z.string().optional(),
+            signals: z.object({
+                checkResults: z.array(z.object({
+                    name: z.string().min(1),
+                    passed: z.boolean(),
+                })).optional(),
+                conditionMet: z.boolean().optional(),
+                spentUsd: z.number().nonnegative().optional(),
+                failedAttempts: z.number().int().nonnegative().optional(),
+                stuck: z.boolean().optional(),
+                budgetExtension: z.object({
+                    maxTurns: z.number().int().positive().optional(),
+                    maxCost: z.number().nonnegative().optional(),
+                }).optional(),
+                testsPassed: z.boolean().optional(),
+                reviewVerdict: z.string().optional(),
+            }).optional(),
+        },
+        annotations: {
+            title: "Composer Goal Step",
+            readOnlyHint: false,
+            destructiveHint: false,
+            idempotentHint: false,
+            openWorldHint: false,
+        },
+    }, async (input) => {
+        const { record, nextAction } = stepGoal(ctx.root, input);
+        const summary = {
+            state: record.state,
+            turns: record.turns,
+            nextAction,
+            checks: record.checks,
+            lastReason: record.lastReason,
+        };
+        return { content: [{ type: "text", text: JSON.stringify(summary, null, 2) }] };
+    });
+    server.registerTool(COMPOSER_GOAL_CLEAR, {
+        description: GOAL_CLEAR_DESCRIPTION,
+        inputSchema: {
+            goalId: z.string().optional(),
+        },
+        annotations: {
+            title: "Composer Goal Clear",
+            readOnlyHint: false,
+            destructiveHint: false,
+            idempotentHint: true,
+            openWorldHint: false,
+        },
+    }, async ({ goalId }) => {
+        const prior = goalId ? readGoal(ctx.root, goalId) : readActiveGoal(ctx.root);
+        const record = clearGoal(ctx.root, goalId);
+        const summary = record
+            ? {
+                goalId: record.goalId,
+                state: record.state,
+                changed: prior !== null && !isTerminal(prior.state),
+            }
+            : { state: "none" };
+        return { content: [{ type: "text", text: JSON.stringify(summary, null, 2) }] };
+    });
+}
+//# sourceMappingURL=goal.js.map

package/dist/tools/goal.js.map

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

package/dist/tools/handoff.d.ts

@@ -0,0 +1,2 @@
+import type { ServerToolContext } from "./context.js";
+export declare function registerHandoffTools(ctx: ServerToolContext): void;

package/dist/tools/handoff.js

@@ -0,0 +1,57 @@
+import { z } from "zod";
+import path from "node:path";
+import { COMPOSER_HANDOFF_CREATE, HANDOFF_CREATE_DESCRIPTION, } from "../server/toolDescriptions.js";
+import { HANDOFF_DIR, newHandoffPacket, writeHandoffPacket, } from "../util/handoff.js";
+export function registerHandoffTools(ctx) {
+    const { server, root } = ctx;
+    server.registerTool(COMPOSER_HANDOFF_CREATE, {
+        description: HANDOFF_CREATE_DESCRIPTION,
+        inputSchema: {
+            objective: z.string().min(1),
+            contextSummary: z.string().optional(),
+            constraints: z.array(z.string().min(1)).optional(),
+            relevantFiles: z.array(z.string().min(1)).optional(),
+            acceptanceCriteria: z.array(z.string().min(1)).optional(),
+            decisions: z.array(z.string().min(1)).optional(),
+            openQuestions: z.array(z.string().min(1)).optional(),
+            artifacts: z
+                .array(z.object({
+                kind: z.enum(["research", "code", "review", "test", "note"]),
+                summary: z.string().min(1),
+                path: z.string().min(1).optional(),
+                source: z.string().min(1).optional(),
+            }))
+                .optional(),
+            briefPath: z.string().optional(),
+        },
+        annotations: {
+            title: "Composer Handoff Create",
+            readOnlyHint: false,
+            openWorldHint: false,
+            destructiveHint: false,
+            idempotentHint: false,
+        },
+    }, async ({ objective, contextSummary, constraints, relevantFiles, acceptanceCriteria, decisions, openQuestions, artifacts, briefPath, }) => {
+        const packet = newHandoffPacket({
+            objective,
+            contextSummary,
+            constraints,
+            relevantFiles,
+            acceptanceCriteria,
+            decisions,
+            openQuestions,
+            artifacts: artifacts,
+            briefPath,
+        });
+        const handoffPath = writeHandoffPacket(packet, path.resolve(root, HANDOFF_DIR));
+        const response = {
+            runId: packet.runId,
+            handoffPath,
+            objective: packet.objective,
+        };
+        return {
+            content: [{ type: "text", text: JSON.stringify(response, null, 2) }],
+        };
+    });
+}
+//# sourceMappingURL=handoff.js.map

package/dist/tools/handoff.js.map

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

package/dist/tools/oracle.d.ts

@@ -0,0 +1,2 @@
+import type { ServerToolContext } from "./context.js";
+export declare function registerOracleTools(ctx: ServerToolContext): void;

package/dist/tools/oracle.js

@@ -0,0 +1,248 @@
+import { z } from "zod";
+import fs from "node:fs";
+import path from "node:path";
+import { withProgress } from "../server/progress.js";
+import { contextWithHandoff } from "../server/handoffContext.js";
+import { COMPOSER_ORACLE_PLAN, COMPOSER_ORACLE_JOB_START, COMPOSER_ORACLE_JOB_RESULT, ORACLE_PLAN_DESCRIPTION, ORACLE_JOB_START_DESCRIPTION, ORACLE_JOB_RESULT_DESCRIPTION, } from "../server/toolDescriptions.js";
+import { newOracleJob, readLatestOracleJob, readOracleJob, updateOracleJob, writeOracleJob, } from "../util/oracleJob.js";
+import { acquireOracleLock } from "../util/oracleLock.js";
+import { DEFAULT_ANTHROPIC_TIMEOUT_MS } from "../providers/AnthropicCompatibleProvider.js";
+import { createDeadlineSignal } from "../util/asyncControl.js";
+import { pollJobResult } from "../util/jobPolling.js";
+const DEFAULT_BACKGROUND_JOB_TIMEOUT_MS = DEFAULT_ANTHROPIC_TIMEOUT_MS;
+export function registerOracleTools(ctx) {
+    const { server, registry, root } = ctx;
+    server.registerTool(COMPOSER_ORACLE_PLAN, {
+        description: ORACLE_PLAN_DESCRIPTION,
+        inputSchema: {
+            prompt: z.string().min(1),
+            mode: z
+                .enum([
+                "auto",
+                "quick",
+                "standard",
+                "deep",
+                "plan",
+                "review",
+                "debug",
+                "research",
+            ])
+                .optional(),
+            context: z.string().optional(),
+            handoffPath: z.string().optional(),
+        },
+        annotations: {
+            title: "Composer Oracle Plan (ChatGPT Pro)",
+            readOnlyHint: true,
+            openWorldHint: true,
+            destructiveHint: false,
+            idempotentHint: false,
+        },
+    }, async ({ prompt, mode, context, handoffPath }, extra) => {
+        ctx.refreshConfigIfChanged();
+        const provider = registry.getProviderForRole("oraclePlanner");
+        const cfgOracle = ctx.getActiveConfig()?.oracle;
+        const sessOracle = ctx.getSession().oracle;
+        const oracleCfg = {
+            defaultMode: sessOracle?.defaultMode ?? cfgOracle?.defaultMode,
+            requireExplicitTag: sessOracle?.requireExplicitTag ?? cfgOracle?.requireExplicitTag,
+        };
+        const resolvedMode = mode ?? oracleCfg?.defaultMode ?? "auto";
+        if (oracleCfg?.requireExplicitTag === true &&
+            resolvedMode === "auto" &&
+            !/\[oracle:(quick|standard|deep|plan|review|debug|research)\]/i.test(prompt)) {
+            throw new Error("composer_oracle_plan: oracle.requireExplicitTag is set — pass an explicit mode (quick|standard|deep|plan|review|debug|research) or tag the prompt with [oracle:<mode>].");
+        }
+        const effectivePrompt = resolvedMode !== "auto" ? `[oracle:${resolvedMode}] ${prompt}` : prompt;
+        const lock = acquireOracleLock(root, { label: "oracle_plan" });
+        emitOracleLockRecovery(lock.recovery);
+        if (!lock.acquired) {
+            throw new Error(`Oracle is busy: a run is already in progress (pid ${lock.holder.pid}` +
+                `${lock.holder.jobId ? `, job ${lock.holder.jobId}` : ""}). ` +
+                `Retry shortly, or use composer_oracle_job_start for a queued async run.`);
+        }
+        const toolSignal = createBoundedSignal(COMPOSER_ORACLE_PLAN, resolveRoleTimeoutMs(ctx.getActiveConfig()?.roles.oraclePlanner?.timeoutMs), extra.signal);
+        try {
+            const result = await withProgress(extra, COMPOSER_ORACLE_PLAN, (onProgress) => provider.execute({
+                prompt: effectivePrompt,
+                context: contextWithHandoff(root, context, handoffPath),
+                cwd: root,
+                onProgress,
+                signal: toolSignal.signal,
+            }), { tracker: ctx.activeRuns, providerLabel: provider.modelLabel, providerRole: "oraclePlanner" });
+            return { content: [{ type: "text", text: result.text }] };
+        }
+        finally {
+            toolSignal.cleanup();
+            lock.handle.release();
+        }
+    });
+    server.registerTool(COMPOSER_ORACLE_JOB_START, {
+        description: ORACLE_JOB_START_DESCRIPTION,
+        inputSchema: {
+            prompt: z.string().min(1),
+            mode: z.enum(["auto", "quick", "standard", "deep", "plan", "review", "debug", "research"]).optional(),
+            context: z.string().optional(),
+            handoffPath: z.string().optional(),
+        },
+        annotations: {
+            title: "Composer Oracle Job Start (async ChatGPT Pro)",
+            readOnlyHint: false,
+            openWorldHint: true,
+            destructiveHint: false,
+            idempotentHint: false,
+        },
+    }, async ({ prompt, mode, context, handoffPath }, extra) => {
+        ctx.refreshConfigIfChanged();
+        const cfgOracle = ctx.getActiveConfig()?.oracle;
+        const sessOracle = ctx.getSession().oracle;
+        const oracleCfg = {
+            defaultMode: sessOracle?.defaultMode ?? cfgOracle?.defaultMode,
+            requireExplicitTag: sessOracle?.requireExplicitTag ?? cfgOracle?.requireExplicitTag,
+        };
+        const resolvedMode = mode ?? oracleCfg?.defaultMode ?? "auto";
+        if (oracleCfg?.requireExplicitTag === true &&
+            resolvedMode === "auto" &&
+            !/\[oracle:(quick|standard|deep|plan|review|debug|research)\]/i.test(prompt)) {
+            throw new Error("composer_oracle_job_start: oracle.requireExplicitTag is set — pass an explicit mode (quick|standard|deep|plan|review|debug|research) or tag the prompt with [oracle:<mode>].");
+        }
+        const provider = registry.getProviderForRole("oraclePlanner");
+        const jobTimeoutMs = resolveRoleTimeoutMs(ctx.getActiveConfig()?.roles.oraclePlanner?.timeoutMs);
+        let job = newOracleJob(root, {
+            mode: resolvedMode,
+            promptPreview: prompt.slice(0, 200),
+            handoffPath,
+        });
+        const lock = acquireOracleLock(root, { jobId: job.jobId, label: "oracle_job_start" });
+        emitOracleLockRecovery(lock.recovery);
+        if (!lock.acquired) {
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: JSON.stringify({
+                            status: "rejected",
+                            reason: "an Oracle run is already in progress",
+                            runningJobId: lock.holder.jobId ?? null,
+                            holderPid: lock.holder.pid,
+                            hint: "poll composer_oracle_job_result, or retry once the current run finishes",
+                        }, null, 2),
+                    },
+                ],
+            };
+        }
+        try {
+            job = writeOracleJob(root, job);
+        }
+        catch (error) {
+            lock.handle.release();
+            throw error;
+        }
+        const effectivePrompt = resolvedMode !== "auto" ? `[oracle:${resolvedMode}] ${prompt}` : prompt;
+        const runner = async () => {
+            const jobSignal = createBoundedSignal("composer_oracle_job_start", jobTimeoutMs, extra.signal);
+            try {
+                const running = updateOracleJob(root, job, {
+                    status: "running",
+                    startedAt: new Date().toISOString(),
+                });
+                try {
+                    const result = await provider.execute({
+                        prompt: effectivePrompt,
+                        context: contextWithHandoff(root, context, handoffPath),
+                        cwd: root,
+                        signal: jobSignal.signal,
+                    });
+                    let answerMeta = {};
+                    try {
+                        const metaPath = path.join(root, ".composer", "oracle", "answers", ".last-plan-meta.json");
+                        if (fs.existsSync(metaPath)) {
+                            const meta = JSON.parse(fs.readFileSync(metaPath, "utf8"));
+                            if (typeof meta.answerPath === "string")
+                                answerMeta.answerPath = meta.answerPath;
+                            if (typeof meta.oracleSlug === "string")
+                                answerMeta.oracleSlug = meta.oracleSlug;
+                        }
+                    }
+                    catch {
+                        // best-effort: missing/unreadable sidecar just means no answerPath
+                    }
+                    updateOracleJob(root, running, {
+                        status: "succeeded",
+                        completedAt: new Date().toISOString(),
+                        answerText: result.text,
+                        ...answerMeta,
+                    });
+                }
+                catch (error) {
+                    updateOracleJob(root, running, {
+                        status: "failed",
+                        completedAt: new Date().toISOString(),
+                        error: error instanceof Error ? error.message : String(error),
+                    });
+                }
+            }
+            finally {
+                jobSignal.cleanup();
+                lock.handle.release();
+            }
+        };
+        void runner().catch(() => {
+            // The runner persists its own failures to the durable job record;
+            // this guard only prevents an unobserved promise rejection.
+        });
+        return { content: [{ type: "text", text: JSON.stringify(job, null, 2) }] };
+    });
+    server.registerTool(COMPOSER_ORACLE_JOB_RESULT, {
+        description: ORACLE_JOB_RESULT_DESCRIPTION,
+        inputSchema: {
+            jobId: z.string().uuid().optional(),
+            waitMs: z.number().int().min(0).max(600000).optional(),
+        },
+        annotations: {
+            title: "Composer Oracle Job Result",
+            readOnlyHint: true,
+            openWorldHint: false,
+            destructiveHint: false,
+            idempotentHint: true,
+        },
+    }, async ({ jobId, waitMs }, extra) => {
+        const read = () => (jobId ? readOracleJob(root, jobId) : readLatestOracleJob(root));
+        const job = await pollJobResult(read, {
+            waitMs,
+            signal: extra.signal,
+            label: COMPOSER_ORACLE_JOB_RESULT,
+        });
+        const response = job ?? {
+            found: false,
+            jobId: jobId ?? null,
+            message: jobId ? `No Oracle job found for ${jobId}.` : "No Oracle jobs found.",
+        };
+        return { content: [{ type: "text", text: JSON.stringify(response, null, 2) }] };
+    });
+}
+function emitOracleLockRecovery(recovery) {
+    if (!recovery)
+        return;
+    const payload = {
+        reason_code: recovery.reasonCode,
+        stage: recovery.stage,
+        elapsed_wall_ms: recovery.elapsedWallMs,
+        lock_age_ms: recovery.lockAgeMs,
+        holder_pid: recovery.holder.pid,
+        holder_job_id: recovery.holder.jobId ?? null,
+        holder_label: recovery.holder.label ?? null,
+    };
+    console.error(JSON.stringify(payload));
+}
+function resolveRoleTimeoutMs(configuredTimeoutMs) {
+    return typeof configuredTimeoutMs === "number" &&
+        Number.isFinite(configuredTimeoutMs) &&
+        configuredTimeoutMs > 0
+        ? configuredTimeoutMs
+        : DEFAULT_BACKGROUND_JOB_TIMEOUT_MS;
+}
+function createBoundedSignal(label, timeoutMs, callerSignal) {
+    return createDeadlineSignal(label, timeoutMs, callerSignal);
+}
+//# sourceMappingURL=oracle.js.map

package/dist/tools/oracle.js.map

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

package/dist/tools/research.d.ts

@@ -0,0 +1,2 @@
+import type { ServerToolContext } from "./context.js";
+export declare function registerResearchTools(ctx: ServerToolContext): void;

package/dist/tools/research.js

@@ -0,0 +1,51 @@
+import { z } from "zod";
+import { withProgress } from "../server/progress.js";
+import { contextWithHandoff } from "../server/handoffContext.js";
+import { COMPOSER_RESEARCH, RESEARCH_DESCRIPTION, } from "../server/toolDescriptions.js";
+import { createDeadlineSignal } from "../util/asyncControl.js";
+const DEFAULT_RESEARCHER_TIMEOUT_MS = 180_000;
+export function registerResearchTools(ctx) {
+    const { server, registry, root } = ctx;
+    server.registerTool(COMPOSER_RESEARCH, {
+        description: RESEARCH_DESCRIPTION,
+        inputSchema: {
+            prompt: z.string().min(1),
+            context: z.string().optional(),
+            handoffPath: z.string().optional(),
+        },
+        annotations: {
+            title: "Composer Research",
+            readOnlyHint: true,
+            openWorldHint: true,
+            destructiveHint: false,
+            idempotentHint: false,
+        },
+    }, async ({ prompt, context, handoffPath }, extra) => {
+        ctx.refreshConfigIfChanged();
+        const provider = registry.getProviderForRole("researcher");
+        const toolSignal = createBoundedSignal(COMPOSER_RESEARCH, resolveRoleTimeoutMs(ctx.getActiveConfig()?.roles.researcher?.timeoutMs, DEFAULT_RESEARCHER_TIMEOUT_MS), extra.signal);
+        try {
+            const result = await withProgress(extra, COMPOSER_RESEARCH, (onProgress) => provider.execute({
+                prompt,
+                context: contextWithHandoff(root, context, handoffPath),
+                onProgress,
+                signal: toolSignal.signal,
+            }), { tracker: ctx.activeRuns, providerLabel: provider.modelLabel, providerRole: "researcher" });
+            return { content: [{ type: "text", text: result.text }] };
+        }
+        finally {
+            toolSignal.cleanup();
+        }
+    });
+}
+function resolveRoleTimeoutMs(configuredTimeoutMs, fallbackMs) {
+    return typeof configuredTimeoutMs === "number" &&
+        Number.isFinite(configuredTimeoutMs) &&
+        configuredTimeoutMs > 0
+        ? configuredTimeoutMs
+        : fallbackMs;
+}
+function createBoundedSignal(label, timeoutMs, callerSignal) {
+    return createDeadlineSignal(label, timeoutMs, callerSignal);
+}
+//# sourceMappingURL=research.js.map

package/dist/tools/research.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"research.js","sourceRoot":"","sources":["../../src/tools/research.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AACrD,OAAO,EAAE,kBAAkB,EAAE,MAAM,6BAA6B,CAAC;AACjE,OAAO,EACL,iBAAiB,EACjB,oBAAoB,GACrB,MAAM,+BAA+B,CAAC;AACvC,OAAO,EAAE,oBAAoB,EAAE,MAAM,yBAAyB,CAAC;AAG/D,MAAM,6BAA6B,GAAG,OAAO,CAAC;AAE9C,MAAM,UAAU,qBAAqB,CAAC,GAAsB;IAC1D,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,IAAI,EAAE,GAAG,GAAG,CAAC;IAEvC,MAAM,CAAC,YAAY,CACjB,iBAAiB,EACjB;QACE,WAAW,EAAE,oBAAoB;QACjC,WAAW,EAAE;YACX,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;YACzB,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;YAC9B,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;SACnC;QACD,WAAW,EAAE;YACX,KAAK,EAAE,mBAAmB;YAC1B,YAAY,EAAE,IAAI;YAClB,aAAa,EAAE,IAAI;YACnB,eAAe,EAAE,KAAK;YACtB,cAAc,EAAE,KAAK;SACtB;KACF,EACD,KAAK,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,WAAW,EAAE,EAAE,KAAK,EAAE,EAAE;QAChD,GAAG,CAAC,sBAAsB,EAAE,CAAC;QAC7B,MAAM,QAAQ,GAAG,QAAQ,CAAC,kBAAkB,CAAC,YAAY,CAAC,CAAC;QAC3D,MAAM,UAAU,GAAG,mBAAmB,CACpC,iBAAiB,EACjB,oBAAoB,CAClB,GAAG,CAAC,eAAe,EAAE,EAAE,KAAK,CAAC,UAAU,EAAE,SAAS,EAClD,6BAA6B,CAC9B,EACD,KAAK,CAAC,MAAM,CACb,CAAC;QACF,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,YAAY,CAAC,KAAK,EAAE,iBAAiB,EAAE,CAAC,UAAU,EAAE,EAAE,CACzE,QAAQ,CAAC,OAAO,CAAC;gBACf,MAAM;gBACN,OAAO,EAAE,kBAAkB,CAAC,IAAI,EAAE,OAAO,EAAE,WAAW,CAAC;gBACvD,UAAU;gBACV,MAAM,EAAE,UAAU,CAAC,MAAM;aAC1B,CAAC,EACF,EAAE,OAAO,EAAE,GAAG,CAAC,UAAU,EAAE,aAAa,EAAE,QAAQ,CAAC,UAAU,EAAE,YAAY,EAAE,YAAY,EAAE,CAC5F,CAAC;YACF,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,CAAC,EAAE,CAAC;QAC5D,CAAC;gBAAS,CAAC;YACT,UAAU,CAAC,OAAO,EAAE,CAAC;QACvB,CAAC;IACH,CAAC,CACF,CAAC;AACJ,CAAC;AAED,SAAS,oBAAoB,CAAC,mBAA4B,EAAE,UAAkB;IAC5E,OAAO,OAAO,mBAAmB,KAAK,QAAQ;QAC5C,MAAM,CAAC,QAAQ,CAAC,mBAAmB,CAAC;QACpC,mBAAmB,GAAG,CAAC;QACvB,CAAC,CAAC,mBAAmB;QACrB,CAAC,CAAC,UAAU,CAAC;AACjB,CAAC;AAED,SAAS,mBAAmB,CAAC,KAAa,EAAE,SAAiB,EAAE,YAA0B;IAIvF,OAAO,oBAAoB,CAAC,KAAK,EAAE,SAAS,EAAE,YAAY,CAAC,CAAC;AAC9D,CAAC"}

package/dist/tools/review.d.ts

@@ -0,0 +1,2 @@
+import type { ServerToolContext } from "./context.js";
+export declare function registerReviewTools(ctx: ServerToolContext): void;