agent-composer 0.3.1 → 0.4.0

package/dist/tools/review.js

@@ -0,0 +1,233 @@
+import { z } from "zod";
+import { withProgress } from "../server/progress.js";
+import { contextWithHandoff } from "../server/handoffContext.js";
+import { computeReviewDiff } from "../util/reviewDiff.js";
+import { COMPOSER_REVIEW, COMPOSER_REVIEW_CLAUDE, COMPOSER_REVIEW_JOB_RESULT, COMPOSER_REVIEW_JOB_START, REVIEW_DESCRIPTION, REVIEW_CLAUDE_DESCRIPTION, REVIEW_JOB_RESULT_DESCRIPTION, REVIEW_JOB_START_DESCRIPTION, } from "../server/toolDescriptions.js";
+import { newReviewJob, readLatestReviewJob, readReviewJob, updateReviewJob, writeReviewJob, } from "../util/reviewJob.js";
+import { DEFAULT_ANTHROPIC_TIMEOUT_MS } from "../providers/AnthropicCompatibleProvider.js";
+import { createDeadlineSignal } from "../util/asyncControl.js";
+import { pollJobResult } from "../util/jobPolling.js";
+const REVIEW_SCOPE_SCHEMA = z.enum(["staged", "unstaged", "working-tree", "branch"]);
+const DEFAULT_BACKGROUND_JOB_TIMEOUT_MS = DEFAULT_ANTHROPIC_TIMEOUT_MS;
+export function registerReviewTools(ctx) {
+    const { server, registry, root } = ctx;
+    server.registerTool(COMPOSER_REVIEW, {
+        description: REVIEW_DESCRIPTION,
+        inputSchema: {
+            prompt: z.string().min(1),
+            diff: z.string().min(1).optional(),
+            handoffPath: z.string().optional(),
+            reviewScope: REVIEW_SCOPE_SCHEMA.optional(),
+            reviewFiles: z.array(z.string().min(1)).optional(),
+            base: z.string().min(1).optional(),
+        },
+        annotations: {
+            title: "Composer Review",
+            readOnlyHint: true,
+            openWorldHint: false,
+            destructiveHint: false,
+            idempotentHint: true,
+        },
+    }, async ({ prompt, diff, handoffPath, reviewScope, reviewFiles, base }, extra) => {
+        ctx.refreshConfigIfChanged();
+        const effectiveDiff = resolveReviewDiff(root, {
+            diff,
+            reviewScope,
+            reviewFiles,
+            base,
+            toolName: COMPOSER_REVIEW,
+        });
+        const provider = registry.getProviderForRole("reviewer");
+        const toolSignal = createBoundedSignal(COMPOSER_REVIEW, resolveRoleTimeoutMs(ctx.getActiveConfig()?.roles.reviewer?.timeoutMs), extra.signal);
+        try {
+            const result = await withProgress(extra, COMPOSER_REVIEW, (onProgress) => provider.execute({
+                prompt,
+                context: contextWithHandoff(root, effectiveDiff, handoffPath),
+                onProgress,
+                signal: toolSignal.signal,
+            }), { tracker: ctx.activeRuns, providerLabel: provider.modelLabel, providerRole: "reviewer" });
+            return { content: [{ type: "text", text: result.text }] };
+        }
+        finally {
+            toolSignal.cleanup();
+        }
+    });
+    server.registerTool(COMPOSER_REVIEW_CLAUDE, {
+        description: REVIEW_CLAUDE_DESCRIPTION,
+        inputSchema: {
+            prompt: z.string().min(1),
+            diff: z.string().min(1).optional(),
+            handoffPath: z.string().optional(),
+            reviewScope: REVIEW_SCOPE_SCHEMA.optional(),
+            reviewFiles: z.array(z.string().min(1)).optional(),
+            base: z.string().min(1).optional(),
+        },
+        annotations: {
+            title: "Composer Review (Claude Premium)",
+            readOnlyHint: true,
+            openWorldHint: false,
+            destructiveHint: false,
+            idempotentHint: true,
+        },
+    }, async ({ prompt, diff, handoffPath, reviewScope, reviewFiles, base }, extra) => {
+        ctx.refreshConfigIfChanged();
+        const effectiveDiff = resolveReviewDiff(root, {
+            diff,
+            reviewScope,
+            reviewFiles,
+            base,
+            toolName: COMPOSER_REVIEW_CLAUDE,
+        });
+        const provider = registry.getProviderForRole("reviewerClaude");
+        const toolSignal = createBoundedSignal(COMPOSER_REVIEW_CLAUDE, resolveRoleTimeoutMs(ctx.getActiveConfig()?.roles.reviewerClaude?.timeoutMs), extra.signal);
+        try {
+            const result = await withProgress(extra, COMPOSER_REVIEW_CLAUDE, (onProgress) => provider.execute({
+                prompt,
+                context: contextWithHandoff(root, effectiveDiff, handoffPath),
+                cwd: root,
+                onProgress,
+                signal: toolSignal.signal,
+            }), { tracker: ctx.activeRuns, providerLabel: provider.modelLabel, providerRole: "reviewerClaude" });
+            return { content: [{ type: "text", text: result.text }] };
+        }
+        finally {
+            toolSignal.cleanup();
+        }
+    });
+    server.registerTool(COMPOSER_REVIEW_JOB_START, {
+        description: REVIEW_JOB_START_DESCRIPTION,
+        inputSchema: {
+            prompt: z.string().min(1),
+            diff: z.string().min(1).optional(),
+            handoffPath: z.string().optional(),
+            reviewScope: REVIEW_SCOPE_SCHEMA.optional(),
+            reviewFiles: z.array(z.string().min(1)).optional(),
+            base: z.string().min(1).optional(),
+            claude: z.boolean().optional().default(false),
+        },
+        annotations: {
+            title: "Composer Review Job Start",
+            readOnlyHint: false,
+            openWorldHint: true,
+            destructiveHint: false,
+            idempotentHint: false,
+        },
+    }, async ({ prompt, diff, handoffPath, reviewScope, reviewFiles, base, claude }, extra) => {
+        ctx.refreshConfigIfChanged();
+        const effectiveDiff = resolveReviewDiff(root, {
+            diff,
+            reviewScope,
+            reviewFiles,
+            base,
+            toolName: COMPOSER_REVIEW_JOB_START,
+        });
+        const reviewRole = claude ? "reviewerClaude" : "reviewer";
+        const provider = registry.getProviderForRole(reviewRole);
+        const jobTimeoutMs = resolveRoleTimeoutMs(ctx.getActiveConfig()?.roles[reviewRole]?.timeoutMs);
+        let job = writeReviewJob(root, newReviewJob({
+            scope: reviewScope,
+            base,
+            reviewFiles,
+            promptPreview: prompt.slice(0, 200),
+            claude,
+        }));
+        const context = contextWithHandoff(root, effectiveDiff, handoffPath);
+        const runner = async () => {
+            const jobSignal = createBoundedSignal("composer_review_job_start", jobTimeoutMs, extra.signal);
+            try {
+                const running = updateReviewJob(root, job, {
+                    status: "running",
+                    startedAt: new Date().toISOString(),
+                });
+                try {
+                    const result = await provider.execute({
+                        prompt,
+                        context,
+                        cwd: root,
+                        signal: jobSignal.signal,
+                    });
+                    updateReviewJob(root, running, {
+                        status: "succeeded",
+                        completedAt: new Date().toISOString(),
+                        result: parseReviewResult(result.text),
+                    });
+                }
+                catch (error) {
+                    updateReviewJob(root, running, {
+                        status: "failed",
+                        completedAt: new Date().toISOString(),
+                        error: error instanceof Error ? error.message : String(error),
+                    });
+                }
+            }
+            finally {
+                jobSignal.cleanup();
+            }
+        };
+        void runner().catch(() => {
+            // The runner persists failures to the durable job record; this only
+            // prevents an unobserved promise rejection from escaping the server.
+        });
+        return { content: [{ type: "text", text: JSON.stringify(job, null, 2) }] };
+    });
+    server.registerTool(COMPOSER_REVIEW_JOB_RESULT, {
+        description: REVIEW_JOB_RESULT_DESCRIPTION,
+        inputSchema: {
+            jobId: z.string().uuid().optional(),
+            waitMs: z.number().int().min(0).max(600000).optional(),
+        },
+        annotations: {
+            title: "Composer Review Job Result",
+            readOnlyHint: true,
+            openWorldHint: false,
+            destructiveHint: false,
+            idempotentHint: true,
+        },
+    }, async ({ jobId, waitMs }, extra) => {
+        const read = () => (jobId ? readReviewJob(root, jobId) : readLatestReviewJob(root));
+        const job = await pollJobResult(read, {
+            waitMs,
+            signal: extra.signal,
+            label: COMPOSER_REVIEW_JOB_RESULT,
+        });
+        const response = job ?? {
+            found: false,
+            jobId: jobId ?? null,
+            message: jobId ? `No review job found for ${jobId}.` : "No review jobs found.",
+        };
+        return { content: [{ type: "text", text: JSON.stringify(response, null, 2) }] };
+    });
+}
+function resolveReviewDiff(root, input) {
+    const effectiveDiff = input.reviewScope !== undefined
+        ? computeReviewDiff(root, input.reviewScope, { base: input.base, files: input.reviewFiles })
+        : input.diff;
+    if (!effectiveDiff) {
+        throw new Error(`${input.toolName}: provide either \`diff\` or \`reviewScope\`.`);
+    }
+    return effectiveDiff;
+}
+function parseReviewResult(text) {
+    const verdict = firstMarkerValue(text, "VERDICT");
+    const summary = firstMarkerValue(text, "SUMMARY");
+    return {
+        ...(verdict ? { verdict } : {}),
+        ...(summary ? { summary } : {}),
+        text,
+    };
+}
+function firstMarkerValue(text, marker) {
+    const match = text.match(new RegExp(`^\\s*${marker}:\\s*(.+?)\\s*$`, "im"));
+    return match?.[1]?.trim();
+}
+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=review.js.map

package/dist/tools/review.js.map

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

package/dist/tools/route.d.ts

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

package/dist/tools/route.js

@@ -0,0 +1,69 @@
+import { z } from "zod";
+import { COMPOSER_ROUTE_DECIDE, ROUTE_DECIDE_DESCRIPTION } from "../server/toolDescriptions.js";
+import { classifyDispatch } from "../util/dispatchHint.js";
+export function registerRouteTools(ctx) {
+    const { server } = ctx;
+    server.registerTool(COMPOSER_ROUTE_DECIDE, {
+        description: ROUTE_DECIDE_DESCRIPTION,
+        inputSchema: {
+            prompt: z.string().min(1),
+            description: z.string().optional(),
+            subagentType: z.string().optional(),
+            format: z.enum(["compact", "full"]).optional(),
+        },
+        annotations: {
+            title: "Composer Route Decide",
+            readOnlyHint: true,
+            openWorldHint: false,
+            destructiveHint: false,
+            idempotentHint: true,
+        },
+    }, async ({ prompt, description, subagentType, format }) => {
+        const hint = classifyDispatch({ prompt, description, subagentType });
+        const isOracle = hint.route.target === "composer-oracle-plan" || hint.route.target === "composer-oracle-job-start";
+        const oracleEscalation = !isOracle && hint.signals.complexityScore >= 0.6
+            ? {
+                recommended: "composer-oracle-plan",
+                reason: "High complexity — consider the opt-in Oracle planning lane (tag [oracle:plan]).",
+            }
+            : null;
+        const recommendedNextTools = nextToolsFor(hint.route.target);
+        const statusLine = `route=${hint.route.target} class=${hint.route.taskClass} budget=${hint.contextBudget}`;
+        const full = format === "full";
+        const payload = full
+            ? { ...hint, oracleEscalation, recommendedNextTools, statusLine }
+            : {
+                target: hint.route.target,
+                taskClass: hint.route.taskClass,
+                contextBudget: hint.contextBudget,
+                confidence: hint.route.confidence,
+                requiresReview: hint.route.requiresReview,
+                recommendedNextTools,
+                statusLine,
+                ...(oracleEscalation ? { oracleEscalation } : {}),
+            };
+        return {
+            content: [{ type: "text", text: JSON.stringify(payload, null, 2) }],
+        };
+    });
+}
+function nextToolsFor(target) {
+    switch (target) {
+        case "composer-code-cli":
+            return ["composer_handoff_create", "composer_code_cli", "composer_review"];
+        case "composer-code-chain":
+            return ["composer_handoff_create", "composer_code_chain", "composer_review"];
+        case "task-researcher-coder":
+            return ["composer_research", "composer_handoff_create", "composer_code_cli", "composer_review"];
+        case "task-reviewer":
+        case "composer-review-claude":
+            return ["composer_review"];
+        case "composer-oracle-plan":
+            return ["composer_oracle_plan"];
+        case "composer-oracle-job-start":
+            return ["composer_oracle_job_start", "composer_oracle_job_result"];
+        default:
+            return [];
+    }
+}
+//# sourceMappingURL=route.js.map

package/dist/tools/route.js.map

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

package/dist/tools/session.d.ts

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

package/dist/tools/session.js

@@ -0,0 +1,37 @@
+import { z } from "zod";
+import { COMPOSER_SESSION_GET, COMPOSER_SESSION_SET, SESSION_GET_DESCRIPTION, SESSION_SET_DESCRIPTION } from "../server/toolDescriptions.js";
+export function registerSessionTools(ctx) {
+    const { server } = ctx;
+    server.registerTool(COMPOSER_SESSION_SET, {
+        description: SESSION_SET_DESCRIPTION,
+        inputSchema: {
+            clear: z.boolean().optional(),
+            mode: z.enum(["fast", "balanced", "strict"]).optional(),
+            oracle: z.object({
+                enabled: z.boolean().optional(),
+                defaultMode: z.enum(["auto", "quick", "standard", "deep", "plan", "review", "debug", "research"]).optional(),
+                requireExplicitTag: z.boolean().optional(),
+            }).strict().optional(),
+            profile: z.string().min(1).optional(),
+        },
+        annotations: { title: "Composer Session Set", readOnlyHint: false, openWorldHint: false, destructiveHint: false, idempotentHint: false },
+    }, async ({ clear, mode, oracle, profile }) => {
+        if (clear)
+            ctx.resetSession();
+        const patch = {};
+        if (mode !== undefined)
+            patch["mode"] = mode;
+        if (oracle !== undefined)
+            patch["oracle"] = oracle;
+        if (profile !== undefined)
+            patch["profile"] = profile;
+        const next = Object.keys(patch).length > 0 ? ctx.setSession(patch) : ctx.getSession();
+        return { content: [{ type: "text", text: JSON.stringify(next, null, 2) }] };
+    });
+    server.registerTool(COMPOSER_SESSION_GET, {
+        description: SESSION_GET_DESCRIPTION,
+        inputSchema: {},
+        annotations: { title: "Composer Session Get", readOnlyHint: true, openWorldHint: false, destructiveHint: false, idempotentHint: true },
+    }, async () => ({ content: [{ type: "text", text: JSON.stringify(ctx.getSession(), null, 2) }] }));
+}
+//# sourceMappingURL=session.js.map

package/dist/tools/session.js.map

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

package/dist/tools/status.d.ts

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

package/dist/tools/status.js

@@ -0,0 +1,34 @@
+import { buildStatus, statusEnvelope } from "../cli/status.js";
+import { COMPOSER_STATUS, STATUS_DESCRIPTION } from "../server/toolDescriptions.js";
+export function registerStatusTools(ctx) {
+    ctx.server.registerTool(COMPOSER_STATUS, {
+        description: STATUS_DESCRIPTION,
+        inputSchema: {},
+        annotations: {
+            title: "Composer Status",
+            readOnlyHint: true,
+            idempotentHint: true,
+            openWorldHint: false,
+            destructiveHint: false,
+        },
+    }, async () => {
+        const status = buildStatus(ctx.root);
+        const nowMs = Date.now();
+        status.active.foreground = ctx.activeRuns.list().map((r) => ({
+            tool: r.tool,
+            providerLabel: r.providerLabel,
+            providerRole: r.providerRole,
+            ageSeconds: Math.max(0, Math.floor((nowMs - Date.parse(r.startedAt)) / 1000)),
+        }));
+        const session = ctx.getSession();
+        const sv = Object.keys(session).length > 0 ? session : undefined;
+        const result = {
+            ...statusEnvelope(status, sv),
+            session: sv,
+        };
+        return {
+            content: [{ type: "text", text: JSON.stringify(result, null, 2) }],
+        };
+    });
+}
+//# sourceMappingURL=status.js.map

package/dist/tools/status.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"status.js","sourceRoot":"","sources":["../../src/tools/status.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAC/D,OAAO,EAAE,eAAe,EAAE,kBAAkB,EAAE,MAAM,+BAA+B,CAAC;AAEpF,MAAM,UAAU,mBAAmB,CAAC,GAAsB;IACxD,GAAG,CAAC,MAAM,CAAC,YAAY,CACrB,eAAe,EACf;QACE,WAAW,EAAE,kBAAkB;QAC/B,WAAW,EAAE,EAAE;QACf,WAAW,EAAE;YACX,KAAK,EAAE,iBAAiB;YACxB,YAAY,EAAE,IAAI;YAClB,cAAc,EAAE,IAAI;YACpB,aAAa,EAAE,KAAK;YACpB,eAAe,EAAE,KAAK;SACvB;KACF,EACD,KAAK,IAAI,EAAE;QACT,MAAM,MAAM,GAAG,WAAW,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QACrC,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QACzB,MAAM,CAAC,MAAM,CAAC,UAAU,GAAG,GAAG,CAAC,UAAU,CAAC,IAAI,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;YAC3D,IAAI,EAAE,CAAC,CAAC,IAAI;YACZ,aAAa,EAAE,CAAC,CAAC,aAAa;YAC9B,YAAY,EAAE,CAAC,CAAC,YAAY;YAC5B,UAAU,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC;SAC9E,CAAC,CAAC,CAAC;QACJ,MAAM,OAAO,GAAG,GAAG,CAAC,UAAU,EAAE,CAAC;QACjC,MAAM,EAAE,GAAG,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC;QACjE,MAAM,MAAM,GAAG;YACb,GAAG,cAAc,CAAC,MAAM,EAAE,EAAE,CAAC;YAC7B,OAAO,EAAE,EAAE;SACZ,CAAC;QACF,OAAO;YACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC;SAC5E,CAAC;IACJ,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/tools/workflow.d.ts

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

package/dist/tools/workflow.js

@@ -0,0 +1,27 @@
+import { z } from "zod";
+import { COMPOSER_WORKFLOW_PLAN, WORKFLOW_PLAN_DESCRIPTION } from "../server/toolDescriptions.js";
+import { planWorkflow } from "../util/workflowPlan.js";
+export function registerWorkflowTools(ctx) {
+    const { server } = ctx;
+    server.registerTool(COMPOSER_WORKFLOW_PLAN, {
+        description: WORKFLOW_PLAN_DESCRIPTION,
+        inputSchema: {
+            goal: z.string().min(1),
+            workflow: z.enum(["feature", "debug", "review", "research"]).optional(),
+            mode: z.enum(["fast", "balanced", "strict"]).optional(),
+            risk: z.enum(["low", "medium", "high"]).optional(),
+            needsCurrentDocs: z.boolean().optional(),
+        },
+        annotations: {
+            title: "Composer Workflow Plan",
+            readOnlyHint: true,
+            idempotentHint: true,
+            openWorldHint: false,
+            destructiveHint: false,
+        },
+    }, async (input) => {
+        const plan = planWorkflow({ ...input, mode: input.mode ?? ctx.getSession().mode });
+        return { content: [{ type: "text", text: JSON.stringify(plan, null, 2) }] };
+    });
+}
+//# sourceMappingURL=workflow.js.map

package/dist/tools/workflow.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflow.js","sourceRoot":"","sources":["../../src/tools/workflow.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,sBAAsB,EAAE,yBAAyB,EAAE,MAAM,+BAA+B,CAAC;AAClG,OAAO,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAGvD,MAAM,UAAU,qBAAqB,CAAC,GAAsB;IAC1D,MAAM,EAAE,MAAM,EAAE,GAAG,GAAG,CAAC;IAEvB,MAAM,CAAC,YAAY,CACjB,sBAAsB,EACtB;QACE,WAAW,EAAE,yBAAyB;QACtC,WAAW,EAAE;YACX,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;YACvB,QAAQ,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,OAAO,EAAE,QAAQ,EAAE,UAAU,CAAC,CAAC,CAAC,QAAQ,EAAE;YACvE,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,UAAU,EAAE,QAAQ,CAAC,CAAC,CAAC,QAAQ,EAAE;YACvD,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,QAAQ,EAAE,MAAM,CAAC,CAAC,CAAC,QAAQ,EAAE;YAClD,gBAAgB,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;SACzC;QACD,WAAW,EAAE;YACX,KAAK,EAAE,wBAAwB;YAC/B,YAAY,EAAE,IAAI;YAClB,cAAc,EAAE,IAAI;YACpB,aAAa,EAAE,KAAK;YACpB,eAAe,EAAE,KAAK;SACvB;KACF,EACD,KAAK,EAAE,KAAK,EAAE,EAAE;QACd,MAAM,IAAI,GAAG,YAAY,CAAC,EAAE,GAAG,KAAK,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,IAAI,GAAG,CAAC,UAAU,EAAE,CAAC,IAAI,EAAE,CAAC,CAAC;QACnF,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC;IAC9E,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/util/applyFileBlocks.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Deterministically apply GLM-authored output of the form
+ *   FILE: <relative/path>
+ *   ```lang
+ *   <content>
+ *   ```
+ * Writes each file under `root` (cwd/projectDir). Guards against path
+ * traversal, including symlink escapes through existing parent directories.
+ */
+export declare function applyFileBlocks(text: string, root: string): {
+    files: Array<{
+        path: string;
+        status: "changed" | "unchanged";
+    }>;
+    rejected: string[];
+};
+export declare function isPathInside(candidate: string, root: string): boolean;
+export declare function resolveProjectDir(projectDir: string | undefined, root: string): string;

package/dist/util/applyFileBlocks.js

@@ -0,0 +1,163 @@
+import fs from "node:fs";
+import path from "node:path";
+/**
+ * Deterministically apply GLM-authored output of the form
+ *   FILE: <relative/path>
+ *   ```lang
+ *   <content>
+ *   ```
+ * Writes each file under `root` (cwd/projectDir). Guards against path
+ * traversal, including symlink escapes through existing parent directories.
+ */
+export function applyFileBlocks(text, root) {
+    const projectRoot = fs.realpathSync(root);
+    const parsed = [];
+    const rejected = [];
+    const re = /^FILE:\s*(\S+)[^\n]*\r?\n(`{3,}|~{3,})[^\n]*\r?\n([\s\S]*?)^\2[ \t]*$(?=\r?\nFILE:\s|\s*$)/gm;
+    let m;
+    while ((m = re.exec(text)) !== null) {
+        const rel = (m[1] ?? "").trim();
+        const content = m[3] ?? "";
+        if (!rel)
+            continue;
+        const abs = path.resolve(projectRoot, rel);
+        if (!isPathInside(abs, projectRoot)) {
+            rejected.push(`${rel} (outside projectDir)`);
+            continue;
+        }
+        const nearestParent = nearestExistingParent(path.dirname(abs));
+        const parentReal = fs.realpathSync(nearestParent);
+        if (!isPathInside(parentReal, projectRoot)) {
+            rejected.push(`${rel} (parent resolves outside projectDir)`);
+            continue;
+        }
+        let leafStat;
+        try {
+            leafStat = fs.lstatSync(abs);
+        }
+        catch {
+            leafStat = undefined;
+        }
+        if (leafStat?.isSymbolicLink()) {
+            // A symlink leaf (including a DANGLING one) would be followed by
+            // writeFileSync and could escape projectDir. realpathSync throws on a
+            // dangling target, so reject unresolvable or escaping links.
+            let linkReal;
+            try {
+                linkReal = fs.realpathSync(abs);
+            }
+            catch {
+                linkReal = undefined;
+            }
+            if (linkReal === undefined || !isPathInside(linkReal, projectRoot)) {
+                rejected.push(`${rel} (symlink target resolves outside projectDir)`);
+                continue;
+            }
+        }
+        else if (leafStat !== undefined) {
+            const existingReal = fs.realpathSync(abs);
+            if (!isPathInside(existingReal, projectRoot)) {
+                rejected.push(`${rel} (file resolves outside projectDir)`);
+                continue;
+            }
+        }
+        parsed.push({ rel, abs, content });
+    }
+    if (rejected.length > 0) {
+        throw new Error(`composer_code_chain: refusing to apply paths outside projectDir ${projectRoot}: ${rejected.join(", ")}`);
+    }
+    // Two-phase apply so a mid-write failure cannot leave partial state:
+    // stage every CHANGED file to a sibling temp, then atomically rename all.
+    const statusByRel = new Map();
+    const pending = [];
+    try {
+        for (const { rel, abs, content } of parsed) {
+            const previous = fs.existsSync(abs) ? fs.readFileSync(abs, "utf8") : undefined;
+            if (previous === content) {
+                statusByRel.set(rel, "unchanged");
+                continue;
+            }
+            fs.mkdirSync(path.dirname(abs), { recursive: true });
+            const tmp = path.join(path.dirname(abs), `.composer-apply-${process.pid}-${pending.length}.tmp`);
+            fs.writeFileSync(tmp, content, "utf8");
+            pending.push({ abs, tmp });
+            statusByRel.set(rel, "changed");
+        }
+    }
+    catch (error) {
+        for (const { tmp } of pending)
+            fs.rmSync(tmp, { force: true });
+        throw error;
+    }
+    // Phase 2: rename staged temps into place, snapshotting each target's prior
+    // content first so a mid-phase failure can roll back to the original state.
+    const applied = [];
+    try {
+        for (const { abs, tmp } of pending) {
+            const existed = fs.existsSync(abs);
+            const original = existed ? fs.readFileSync(abs, "utf8") : null;
+            if (existed) {
+                // Preserve the target's mode (e.g. the +x bit on scripts/hooks) — the
+                // staged temp was created with the process default, so copy it over
+                // before the atomic replace.
+                try {
+                    fs.chmodSync(tmp, fs.statSync(abs).mode & 0o777);
+                }
+                catch {
+                    // best-effort mode preservation; never fail the apply over chmod
+                }
+            }
+            fs.renameSync(tmp, abs);
+            applied.push({ abs, original });
+        }
+    }
+    catch (error) {
+        // Roll back already-applied files (restore prior content, or remove files
+        // that did not previously exist), then clean up any remaining temps.
+        for (const done of applied.reverse()) {
+            try {
+                if (done.original === null) {
+                    fs.rmSync(done.abs, { force: true });
+                }
+                else {
+                    fs.writeFileSync(done.abs, done.original, "utf8");
+                }
+            }
+            catch {
+                // best-effort restore; nothing else we can safely do here
+            }
+        }
+        for (const { tmp } of pending)
+            fs.rmSync(tmp, { force: true });
+        throw error;
+    }
+    const files = parsed.map(({ rel }) => ({
+        path: rel,
+        status: statusByRel.get(rel) ?? "unchanged",
+    }));
+    return { files, rejected };
+}
+export function isPathInside(candidate, root) {
+    return candidate === root || candidate.startsWith(root + path.sep);
+}
+function nearestExistingParent(dir) {
+    let current = dir;
+    while (!fs.existsSync(current)) {
+        const parent = path.dirname(current);
+        if (parent === current)
+            return current;
+        current = parent;
+    }
+    return current;
+}
+export function resolveProjectDir(projectDir, root) {
+    const resolved = projectDir === undefined ? root : path.resolve(projectDir);
+    if (projectDir !== undefined && !path.isAbsolute(projectDir)) {
+        throw new Error(`projectDir must be an absolute path: ${projectDir}`);
+    }
+    if (!fs.existsSync(resolved) || !fs.statSync(resolved).isDirectory()) {
+        throw new Error(`projectDir must be an existing directory: ${resolved}`);
+    }
+    return fs.realpathSync(resolved);
+}
+//# sourceMappingURL=applyFileBlocks.js.map