agent-composer 0.3.1 → 0.4.1

package/dist/server/configMutation.js

@@ -0,0 +1,121 @@
+import fs from "node:fs";
+import path from "node:path";
+import { globalConfigDir } from "../config/paths.js";
+import { isPathInside } from "../util/applyFileBlocks.js";
+import { ORACLE_PLANNER_ROLE } from "../config/oracleRole.js";
+export function resolveComposerConfigTarget(root, configuredPath, scope) {
+    if (scope === "project") {
+        return { scope, path: path.resolve(root, "composer.config.json") };
+    }
+    if (scope === "global") {
+        return { scope, path: path.join(globalConfigDir(), "composer.config.json") };
+    }
+    if (configuredPath && configuredPath.length > 0) {
+        const configuredTarget = path.isAbsolute(configuredPath)
+            ? configuredPath
+            : path.resolve(root, configuredPath);
+        if (fs.existsSync(configuredTarget)) {
+            return { scope, path: configuredTarget };
+        }
+        if (!path.isAbsolute(configuredPath)) {
+            const globalTarget = path.join(globalConfigDir(), configuredPath);
+            if (fs.existsSync(globalTarget)) {
+                return { scope, path: globalTarget };
+            }
+        }
+        return {
+            scope,
+            path: configuredTarget,
+        };
+    }
+    const projectPath = path.resolve(root, "composer.config.json");
+    if (fs.existsSync(projectPath))
+        return { scope, path: projectPath };
+    return { scope, path: path.join(globalConfigDir(), "composer.config.json") };
+}
+export function applyComposerConfigPatch(before, patch) {
+    const next = cloneJsonObject(before);
+    if (patch.codexLifecycle !== undefined) {
+        next["codexLifecycle"] = deepMergeRecords(readRecord(next["codexLifecycle"]), readRecord(patch.codexLifecycle));
+    }
+    if (patch.codexReview !== undefined) {
+        next["codexReview"] = deepMergeRecords(readRecord(next["codexReview"]), readRecord(patch.codexReview));
+    }
+    if (patch.oracle) {
+        if (patch.oracle.enabled !== undefined) {
+            const roles = readRecord(next["roles"]);
+            if (patch.oracle.enabled) {
+                if (!isRecord(roles["oraclePlanner"])) {
+                    roles["oraclePlanner"] = cloneJsonObject(ORACLE_PLANNER_ROLE);
+                }
+            }
+            else {
+                delete roles["oraclePlanner"];
+            }
+            next["roles"] = roles;
+        }
+        const behavior = {};
+        if (patch.oracle.defaultMode !== undefined)
+            behavior["defaultMode"] = patch.oracle.defaultMode;
+        if (patch.oracle.requireExplicitTag !== undefined)
+            behavior["requireExplicitTag"] = patch.oracle.requireExplicitTag;
+        if (Object.keys(behavior).length > 0) {
+            next["oracle"] = deepMergeRecords(readRecord(next["oracle"]), behavior);
+        }
+    }
+    return next;
+}
+export function assertSafeConfigWriteTarget(root, target) {
+    const stat = fs.lstatSync(target.path);
+    if (stat.isSymbolicLink()) {
+        throw new Error(`Composer config target must not be a symlink: ${target.path}`);
+    }
+    if (!stat.isFile()) {
+        throw new Error(`Composer config target must be a file: ${target.path}`);
+    }
+    if (target.scope === "project") {
+        const rootReal = fs.realpathSync(root);
+        const parentReal = fs.realpathSync(path.dirname(target.path));
+        if (!isPathInside(parentReal, rootReal)) {
+            throw new Error(`Composer project config target escapes project root: ${target.path}`);
+        }
+    }
+}
+export function writeConfigFileAtomically(filePath, content) {
+    const dir = path.dirname(filePath);
+    const tmp = path.join(dir, `.composer-config-${process.pid}-${Date.now()}.tmp`);
+    try {
+        fs.writeFileSync(tmp, content, { encoding: "utf8", mode: 0o600, flag: "wx" });
+        fs.renameSync(tmp, filePath);
+    }
+    catch (error) {
+        fs.rmSync(tmp, { force: true });
+        throw error;
+    }
+}
+export function isGlobalComposerConfigPath(filePath) {
+    return path.resolve(filePath) === path.join(globalConfigDir(), "composer.config.json");
+}
+export function cloneJsonObject(value) {
+    return JSON.parse(JSON.stringify(value));
+}
+export function readRecord(value) {
+    return isRecord(value) ? cloneJsonObject(value) : {};
+}
+export function deepMergeRecords(target, patch) {
+    const next = cloneJsonObject(target);
+    for (const [key, value] of Object.entries(patch)) {
+        if (value === undefined)
+            continue;
+        const existing = next[key];
+        next[key] =
+            isRecord(existing) && isRecord(value)
+                ? deepMergeRecords(existing, value)
+                : value;
+    }
+    return next;
+}
+export function isRecord(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+//# sourceMappingURL=configMutation.js.map

package/dist/server/configMutation.js.map

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

package/dist/server/handoffContext.d.ts

@@ -0,0 +1 @@
+export declare function contextWithHandoff(root: string, context?: string, handoffPath?: string): string | undefined;

package/dist/server/handoffContext.js

@@ -0,0 +1,12 @@
+import { formatHandoffForPrompt, readHandoffPacket } from "../util/handoff.js";
+export function contextWithHandoff(root, context, handoffPath) {
+    const blocks = [];
+    if (handoffPath) {
+        const handoff = readHandoffPacket(handoffPath, root);
+        blocks.push(formatHandoffForPrompt(handoff));
+    }
+    if (context)
+        blocks.push(context);
+    return blocks.length > 0 ? blocks.join("\n\n") : undefined;
+}
+//# sourceMappingURL=handoffContext.js.map

package/dist/server/handoffContext.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"handoffContext.js","sourceRoot":"","sources":["../../src/server/handoffContext.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,sBAAsB,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAE/E,MAAM,UAAU,kBAAkB,CAChC,IAAY,EACZ,OAAgB,EAChB,WAAoB;IAEpB,MAAM,MAAM,GAAa,EAAE,CAAC;IAC5B,IAAI,WAAW,EAAE,CAAC;QAChB,MAAM,OAAO,GAAG,iBAAiB,CAAC,WAAW,EAAE,IAAI,CAAC,CAAC;QACrD,MAAM,CAAC,IAAI,CAAC,sBAAsB,CAAC,OAAO,CAAC,CAAC,CAAC;IAC/C,CAAC;IACD,IAAI,OAAO;QAAE,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAClC,OAAO,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;AAC7D,CAAC"}

package/dist/server/progress.d.ts

@@ -0,0 +1,24 @@
+import type { ActiveRunTracker } from "./activeRuns.js";
+export type ProgressUpdate = {
+    phase?: string;
+    detail?: string;
+};
+export type ToolProgressExtra = {
+    _meta?: {
+        progressToken?: string | number;
+    };
+    signal?: AbortSignal;
+    sendNotification?: (notification: {
+        method: "notifications/progress";
+        params: {
+            progressToken: string | number;
+            progress: number;
+            message?: string;
+        };
+    }) => Promise<void>;
+};
+export declare function withProgress<T>(extra: ToolProgressExtra, label: string, work: (onProgress: (update: ProgressUpdate) => void) => Promise<T>, opts?: {
+    tracker?: ActiveRunTracker;
+    providerRole?: string;
+    providerLabel?: string;
+}): Promise<T>;

package/dist/server/progress.js

@@ -0,0 +1,109 @@
+export async function withProgress(extra, label, work, opts = {}) {
+    const reporter = createProgressReporter(extra, label, opts);
+    const runId = opts.tracker
+        ? opts.tracker.start({
+            tool: label,
+            providerRole: opts.providerRole,
+            providerLabel: opts.providerLabel,
+        })
+        : undefined;
+    await reporter.report("started");
+    try {
+        const result = await work(reporter.onProgress);
+        await reporter.report("completed");
+        return result;
+    }
+    catch (error) {
+        await reporter.report("failed");
+        throw error;
+    }
+    finally {
+        reporter.stop();
+        if (opts.tracker && runId !== undefined)
+            opts.tracker.finish(runId);
+    }
+}
+function createProgressReporter(extra, label, opts) {
+    const progressToken = extra._meta?.progressToken;
+    const startedAt = Date.now();
+    let progress = 0;
+    let active = true;
+    let phase = "working";
+    let detail;
+    let lastProgressUpdateAt = 0;
+    const report = async (state) => {
+        if (!active || progressToken === undefined || !extra.sendNotification) {
+            return;
+        }
+        const messagePhase = phaseForState(state) ?? phase;
+        progress += 1;
+        try {
+            await extra.sendNotification({
+                method: "notifications/progress",
+                params: {
+                    progressToken,
+                    progress,
+                    message: formatProgressMessage({
+                        label,
+                        provider: opts.providerLabel ?? opts.providerRole,
+                        elapsed: formatElapsed(Date.now() - startedAt),
+                        phase: messagePhase,
+                        detail,
+                    }),
+                },
+            });
+        }
+        catch {
+            // Progress is advisory; never fail the tool because a client ignores it.
+        }
+    };
+    const timer = progressToken !== undefined && extra.sendNotification
+        ? setInterval(() => {
+            void report();
+        }, 30_000)
+        : undefined;
+    return {
+        report,
+        onProgress: (update) => {
+            if (typeof update.phase === "string" && update.phase.trim()) {
+                phase = update.phase.trim();
+            }
+            if (typeof update.detail === "string") {
+                const trimmed = update.detail.trim();
+                detail = trimmed ? trimmed : undefined;
+            }
+            const now = Date.now();
+            if (now - lastProgressUpdateAt >= 1000) {
+                lastProgressUpdateAt = now;
+                void report();
+            }
+        },
+        stop: () => {
+            active = false;
+            if (timer)
+                clearInterval(timer);
+        },
+    };
+}
+function phaseForState(state) {
+    if (state === "started" || state === "completed" || state === "failed") {
+        return state;
+    }
+    return undefined;
+}
+function formatProgressMessage(input) {
+    return [
+        input.label,
+        input.provider,
+        input.elapsed,
+        input.phase,
+        input.detail,
+    ].filter((part) => typeof part === "string" && part.length > 0).join(" · ");
+}
+function formatElapsed(elapsedMs) {
+    const totalSeconds = Math.max(0, Math.floor(elapsedMs / 1000));
+    const minutes = Math.floor(totalSeconds / 60);
+    const seconds = totalSeconds % 60;
+    return minutes > 0 ? `${minutes}m ${seconds}s` : `${seconds}s`;
+}
+//# sourceMappingURL=progress.js.map

package/dist/server/progress.js.map

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

package/dist/server/toolDescriptions.d.ts

@@ -0,0 +1,60 @@
+export declare const COMPOSER_RESEARCH: "composer_research";
+export declare const COMPOSER_CODE: "composer_code";
+export declare const COMPOSER_REVIEW: "composer_review";
+export declare const COMPOSER_REVIEW_CLAUDE: "composer_review_claude";
+export declare const COMPOSER_REVIEW_JOB_START: "composer_review_job_start";
+export declare const COMPOSER_REVIEW_JOB_RESULT: "composer_review_job_result";
+export declare const COMPOSER_CODE_CLI: "composer_code_cli";
+export declare const COMPOSER_CODE_CHAIN: "composer_code_chain";
+export declare const COMPOSER_HANDOFF_CREATE: "composer_handoff_create";
+export declare const COMPOSER_CODEX_LIFECYCLE_DECIDE: "composer_codex_lifecycle_decide";
+export declare const COMPOSER_CODEX_LIFECYCLE_RUN: "composer_codex_lifecycle_run";
+export declare const COMPOSER_CODEX_LIFECYCLE_RESULT: "composer_codex_lifecycle_result";
+export declare const COMPOSER_CONFIG_GET: "composer_config_get";
+export declare const COMPOSER_CONFIG_SET: "composer_config_set";
+export declare const COMPOSER_ORACLE_PLAN: "composer_oracle_plan";
+export declare const COMPOSER_ORACLE_JOB_START: "composer_oracle_job_start";
+export declare const COMPOSER_ORACLE_JOB_RESULT: "composer_oracle_job_result";
+export declare const RESEARCH_DESCRIPTION: string;
+export declare const CODE_DESCRIPTION: string;
+export declare const CODE_CHAIN_DESCRIPTION: string;
+export declare const CODE_CLI_DESCRIPTION: string;
+export declare const REVIEW_DESCRIPTION: string;
+export declare const REVIEW_CLAUDE_DESCRIPTION: string;
+export declare const REVIEW_JOB_START_DESCRIPTION: string;
+export declare const REVIEW_JOB_RESULT_DESCRIPTION: string;
+export declare const HANDOFF_CREATE_DESCRIPTION: string;
+export declare const CODEX_LIFECYCLE_DECIDE_DESCRIPTION: string;
+export declare const CODEX_LIFECYCLE_RUN_DESCRIPTION: string;
+export declare const CODEX_LIFECYCLE_RESULT_DESCRIPTION: string;
+export declare const CONFIG_GET_DESCRIPTION: string;
+export declare const CONFIG_SET_DESCRIPTION: string;
+export declare const ORACLE_PLAN_DESCRIPTION: string;
+export declare const ORACLE_JOB_START_DESCRIPTION: string;
+export declare const ORACLE_JOB_RESULT_DESCRIPTION: string;
+export declare const COMPOSER_WORKFLOW_PLAN: "composer_workflow_plan";
+export declare const WORKFLOW_PLAN_DESCRIPTION: string;
+export declare const COMPOSER_ROUTE_DECIDE: "composer_route_decide";
+export declare const ROUTE_DECIDE_DESCRIPTION: string;
+export declare const COMPOSER_AUDIT_RECORD: "composer_audit_record";
+export declare const COMPOSER_AUDIT_READ: "composer_audit_read";
+export declare const AUDIT_RECORD_DESCRIPTION = "Append one event to Composer's durable per-project audit/route trail (route decisions, tool calls, reviews, test outcomes, corrections). Orchestrator-driven: call this to record what a dispatch actually did so route accuracy and outcomes are auditable. Pass a stable runId to group a feature's events.";
+export declare const AUDIT_READ_DESCRIPTION = "Read the recent Composer audit trail (optionally filtered by runId), as JSON or a markdown summary. Use to inspect what the last run/route/worker actually did, or to export a run report.";
+export declare const COMPOSER_SESSION_GET: "composer_session_get";
+export declare const COMPOSER_SESSION_SET: "composer_session_set";
+export declare const SESSION_SET_DESCRIPTION = "Set EPHEMERAL session overrides for this server process WITHOUT writing composer.config.json: mode (fast|balanced|strict), oracle ({enabled,defaultMode,requireExplicitTag}), and a default code_cli profile. Pass clear:true to reset. Overrides win over config for the lifetime of the process; nothing is persisted.";
+export declare const SESSION_GET_DESCRIPTION = "Read the current ephemeral session overrides (mode/oracle/profile) for this server process.";
+export declare const COMPOSER_AUDIT_SUMMARY: "composer_audit_summary";
+export declare const AUDIT_SUMMARY_DESCRIPTION = "Aggregate the Composer audit trail into counts by kind/status/route, review verdicts, test pass/fail, user corrections, and recent failures. Use to see route accuracy and outcome trends at a glance (evidence for /evolve).";
+export declare const COMPOSER_STATUS: "composer_status";
+export declare const STATUS_DESCRIPTION: string;
+export declare const COMPOSER_GOAL_START: "composer_goal_start";
+export declare const COMPOSER_GOAL_STATUS: "composer_goal_status";
+export declare const COMPOSER_GOAL_STEP: "composer_goal_step";
+export declare const COMPOSER_GOAL_CLEAR: "composer_goal_clear";
+export declare const COMPOSER_GOAL_REPORT: "composer_goal_report";
+export declare const GOAL_START_DESCRIPTION: string;
+export declare const GOAL_STATUS_DESCRIPTION = "Use when inspecting the active or named Composer goal. Read-only: returns state, turns, checks, and last action/verdict/reason without running checks or mutating goal state.";
+export declare const GOAL_STEP_DESCRIPTION = "Use when advancing a Composer goal. Consumes orchestrator-reported deterministic check results and returns the next recommended tool (advisory; executes nothing).";
+export declare const GOAL_CLEAR_DESCRIPTION = "Use when cancelling the active or named Composer goal. Marks the goal cancelled and leaves the project-local goal record for auditability.";
+export declare const GOAL_REPORT_DESCRIPTION = "Use when you need a read-only summary of a goal's state, checks, and recommended next action. Executes nothing and excludes raw check commands by default. Audit is opt-in with includeAudit, is recent project-wide activity rather than goal-scoped evidence, and raw audit events require includeAuditEvents.";

package/dist/server/toolDescriptions.js

@@ -0,0 +1,134 @@
+// C0.3 — locked MCP tool names. Referenced by subagent allowlists +
+// boundary_guard.sh; do not rename without a new ADR.
+export const COMPOSER_RESEARCH = "composer_research";
+export const COMPOSER_CODE = "composer_code";
+export const COMPOSER_REVIEW = "composer_review";
+export const COMPOSER_REVIEW_CLAUDE = "composer_review_claude";
+export const COMPOSER_REVIEW_JOB_START = "composer_review_job_start";
+export const COMPOSER_REVIEW_JOB_RESULT = "composer_review_job_result";
+export const COMPOSER_CODE_CLI = "composer_code_cli";
+export const COMPOSER_CODE_CHAIN = "composer_code_chain";
+export const COMPOSER_HANDOFF_CREATE = "composer_handoff_create";
+export const COMPOSER_CODEX_LIFECYCLE_DECIDE = "composer_codex_lifecycle_decide";
+export const COMPOSER_CODEX_LIFECYCLE_RUN = "composer_codex_lifecycle_run";
+export const COMPOSER_CODEX_LIFECYCLE_RESULT = "composer_codex_lifecycle_result";
+export const COMPOSER_CONFIG_GET = "composer_config_get";
+export const COMPOSER_CONFIG_SET = "composer_config_set";
+export const COMPOSER_ORACLE_PLAN = "composer_oracle_plan";
+export const COMPOSER_ORACLE_JOB_START = "composer_oracle_job_start";
+export const COMPOSER_ORACLE_JOB_RESULT = "composer_oracle_job_result";
+export const RESEARCH_DESCRIPTION = "Default off-CC research lane for documentation lookup, web search, " +
+    "current API shape, and external context. Returns a bounded summary; call " +
+    "directly unless raw upstream output needs separate subagent isolation.";
+export const CODE_DESCRIPTION = "LEGACY patch-only GLM authoring lane. Use only when you explicitly need " +
+    "GLM to return a diff/text WITHOUT applying files. For normal code writing, " +
+    "refactoring, debugging, and implementation, prefer composer_code_cli " +
+    "(default) or composer_code_chain (GLM complete-file fallback).";
+export const CODE_CHAIN_DESCRIPTION = "Preferred for substantial code: GLM AUTHORS the code (off-CC), then the " +
+    "Composer server APPLIES it to disk deterministically (off-CC), then gate it through " +
+    "composer_review. The orchestrator only calls this once and relays the " +
+    "summary — it never generates or writes code itself. Combines GLM code " +
+    "quality with off-CC application (keeps the main session lean). Returns a " +
+    "summary of files written.";
+export const CODE_CLI_DESCRIPTION = "Generate AND APPLY code changes directly to disk via the CLI executor " +
+    "(Codex/agy/Gemini), which runs in the server working directory and edits files " +
+    "itself. Returns ONLY a summary of what changed. Use this to offload BOTH " +
+    "generation and file-writing off the main session: the orchestrator does " +
+    "NOT call Edit/Write — the executor already applied the changes. Prefer " +
+    "this for multi-file or substantial edits to keep the main context lean.";
+export const REVIEW_DESCRIPTION = "Default off-CC review lane for diff critique and bug-finding before " +
+    "integration. Provide the diff inline and ask for repo-appropriate targeted " +
+    "checks. Returns a bounded summary; call directly unless raw output needs " +
+    "separate subagent isolation.";
+export const REVIEW_CLAUDE_DESCRIPTION = "Premium Claude review lane for high-risk diffs, security-sensitive changes, " +
+    "or when the user explicitly asks for Claude review. Keep composer_review " +
+    "as the default gate; call this directly as a second-opinion escalation.";
+export const REVIEW_JOB_START_DESCRIPTION = "Start a NON-BLOCKING Composer review job and return a jobId immediately. " +
+    "Use when routine review should not block the development loop. Accepts the " +
+    "same diff/reviewScope/base/reviewFiles prompt inputs as composer_review, " +
+    "persists durable job state under .composer/review-jobs, and runs the " +
+    "reviewer provider concurrently within the Composer server process. Poll " +
+    "composer_review_job_result with the jobId to retrieve the verdict.";
+export const REVIEW_JOB_RESULT_DESCRIPTION = "Read a durable Composer review job by jobId (or the latest when omitted). " +
+    "Returns status (queued|running|succeeded|failed) and, when succeeded, " +
+    "the review verdict, summary, and full text. Optional waitMs briefly blocks " +
+    "until the job reaches a terminal state or the wait elapses.";
+export const HANDOFF_CREATE_DESCRIPTION = "Create a shared, provider-neutral handoff packet under .composer/handoffs. " +
+    "Use this before multi-agent or multi-provider work so Codex, GLM, agy, " +
+    "and reviewers receive the same compact objective, constraints, files, " +
+    "decisions, and acceptance criteria without copying the full transcript.";
+export const CODEX_LIFECYCLE_DECIDE_DESCRIPTION = "Deterministically decide whether Codex should participate in a lifecycle " +
+    "step (plan, code-apply, test-failure, failed attempts, or passive warm " +
+    "checks). This is policy-only: it never invokes Codex and returns a compact " +
+    "JSON decision so Coco can skip, ask, or run within codexLifecycle config.";
+export const CODEX_LIFECYCLE_RUN_DESCRIPTION = "Run a Codex lifecycle companion pass and persist a durable result record. " +
+    "Foreground execution returns the result immediately; background execution " +
+    "returns a jobId/resultPath that composer_codex_lifecycle_result can read " +
+    "later. The companion pass is advisory and must not silently mutate files.";
+export const CODEX_LIFECYCLE_RESULT_DESCRIPTION = "Read a durable Codex lifecycle result by jobId, or the latest lifecycle " +
+    "result when jobId is omitted. Use this to bring background Codex output " +
+    "back into the main development loop.";
+export const CONFIG_GET_DESCRIPTION = "Read the active, project, or global Composer config path and validated " +
+    "config. Use this before changing Composer behavior from Claude Code.";
+export const CONFIG_SET_DESCRIPTION = "Safely update Composer config toggles from Claude Code. Supports Codex " +
+    "lifecycle, lifecycle fallback, and pre-commit review gate settings; validates " +
+    "the resulting composer.config.json before writing. " +
+    "Can also enable/disable the opt-in Oracle planning lane via oracle.enabled (adds/removes roles.oraclePlanner).";
+export const ORACLE_PLAN_DESCRIPTION = "Opt-in planning/review/debug lane backed by ChatGPT Pro through the " +
+    "Oracle browser (scripts/oracle-pro-safe.sh). Use for architecture, " +
+    "feature planning, migration design, hard root-cause debugging, or " +
+    "high-risk review when you want extended reasoning from ChatGPT Pro. " +
+    "The `mode` argument selects thinking depth (quick|standard|deep|plan|" +
+    "review|debug|research); omit or use auto to let the script classify. " +
+    "Returns a bounded summary; the full answer is saved under " +
+    ".composer/oracle/answers/. Advisory planning only — file edits still go " +
+    "through composer_code_cli.";
+export const ORACLE_JOB_START_DESCRIPTION = "Start a NON-BLOCKING ChatGPT Pro (Oracle) job and return a jobId " +
+    "immediately. Use for long deep-research or large architectural/review " +
+    "runs, or when the user explicitly says not to block. For normal " +
+    "planning that the next step depends on, prefer the synchronous " +
+    "composer_oracle_plan instead. Poll composer_oracle_job_result with the " +
+    "jobId to retrieve the answer. Advisory only — never edits files. Runs " +
+    "non-blocking WITHIN the Composer server process (server-lifetime), not an " +
+    "OS-detached worker — if the server restarts mid-run the job is reconciled " +
+    "to 'failed'.";
+export const ORACLE_JOB_RESULT_DESCRIPTION = "Read a durable Oracle job by jobId (or the latest when omitted). " +
+    "Returns status (queued|running|succeeded|failed) and, when succeeded, " +
+    "the bounded answer text. Optional waitMs briefly blocks until the job " +
+    "reaches a terminal state or the wait elapses.";
+export const COMPOSER_WORKFLOW_PLAN = "composer_workflow_plan";
+export const WORKFLOW_PLAN_DESCRIPTION = "Recommend (do NOT execute) an ordered Composer tool sequence for a goal. Returns the steps " +
+    "(handoff/research/oracle/code_cli/review/audit) tuned by workflow kind (feature|debug|review|research), " +
+    "mode (fast|balanced|strict), and risk. Use to plan the daily happy path without hiding the underlying tools.";
+export const COMPOSER_ROUTE_DECIDE = "composer_route_decide";
+export const ROUTE_DECIDE_DESCRIPTION = "Preview how Composer would route a task WITHOUT running anything. Returns the " +
+    "dispatch decision (route target, task class, tier, reasoning, recommended dispatch, " +
+    "estimated tokens, complexity) plus an optional Oracle escalation suggestion. Use this " +
+    "to decide which lane to call (composer_code_cli, composer_review, composer_research, " +
+    "composer_oracle_plan, …) before spending a worker call. Read-only; no side effects.";
+export const COMPOSER_AUDIT_RECORD = "composer_audit_record";
+export const COMPOSER_AUDIT_READ = "composer_audit_read";
+export const AUDIT_RECORD_DESCRIPTION = "Append one event to Composer's durable per-project audit/route trail (route decisions, tool calls, reviews, test outcomes, corrections). Orchestrator-driven: call this to record what a dispatch actually did so route accuracy and outcomes are auditable. Pass a stable runId to group a feature's events.";
+export const AUDIT_READ_DESCRIPTION = "Read the recent Composer audit trail (optionally filtered by runId), as JSON or a markdown summary. Use to inspect what the last run/route/worker actually did, or to export a run report.";
+export const COMPOSER_SESSION_GET = "composer_session_get";
+export const COMPOSER_SESSION_SET = "composer_session_set";
+export const SESSION_SET_DESCRIPTION = "Set EPHEMERAL session overrides for this server process WITHOUT writing composer.config.json: mode (fast|balanced|strict), oracle ({enabled,defaultMode,requireExplicitTag}), and a default code_cli profile. Pass clear:true to reset. Overrides win over config for the lifetime of the process; nothing is persisted.";
+export const SESSION_GET_DESCRIPTION = "Read the current ephemeral session overrides (mode/oracle/profile) for this server process.";
+export const COMPOSER_AUDIT_SUMMARY = "composer_audit_summary";
+export const AUDIT_SUMMARY_DESCRIPTION = "Aggregate the Composer audit trail into counts by kind/status/route, review verdicts, test pass/fail, user corrections, and recent failures. Use to see route accuracy and outcome trends at a glance (evidence for /evolve).";
+export const COMPOSER_STATUS = "composer_status";
+export const STATUS_DESCRIPTION = "Read a structured snapshot of Composer state: mode, integrations (review/lifecycle/oracle/git-hook/disabled), " +
+    "active Oracle/Codex jobs, latest audit event, live session overrides, and a recommended next action. " +
+    "Use to see what's happening without reading logs.";
+export const COMPOSER_GOAL_START = "composer_goal_start";
+export const COMPOSER_GOAL_STATUS = "composer_goal_status";
+export const COMPOSER_GOAL_STEP = "composer_goal_step";
+export const COMPOSER_GOAL_CLEAR = "composer_goal_clear";
+export const COMPOSER_GOAL_REPORT = "composer_goal_report";
+export const GOAL_START_DESCRIPTION = "Use when beginning a bounded Composer goal. Creates one active project-local goal under .composer/goals, " +
+    "stores immutable objective/condition plus optional deterministic checks and budgets, and returns the initial route decision.";
+export const GOAL_STATUS_DESCRIPTION = "Use when inspecting the active or named Composer goal. Read-only: returns state, turns, checks, and last action/verdict/reason without running checks or mutating goal state.";
+export const GOAL_STEP_DESCRIPTION = "Use when advancing a Composer goal. Consumes orchestrator-reported deterministic check results and returns the next recommended tool (advisory; executes nothing).";
+export const GOAL_CLEAR_DESCRIPTION = "Use when cancelling the active or named Composer goal. Marks the goal cancelled and leaves the project-local goal record for auditability.";
+export const GOAL_REPORT_DESCRIPTION = "Use when you need a read-only summary of a goal's state, checks, and recommended next action. Executes nothing and excludes raw check commands by default. Audit is opt-in with includeAudit, is recent project-wide activity rather than goal-scoped evidence, and raw audit events require includeAuditEvents.";
+//# sourceMappingURL=toolDescriptions.js.map

package/dist/server/toolDescriptions.js.map

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

package/dist/server.d.ts

@@ -1,29 +1,23 @@
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import fs from "node:fs";
 import type { ProviderRegistry } from "./registry.js";
-export declare const COMPOSER_RESEARCH: "composer_research";
-export declare const COMPOSER_CODE: "composer_code";
-export declare const COMPOSER_REVIEW: "composer_review";
-export declare const COMPOSER_REVIEW_CLAUDE: "composer_review_claude";
-export declare const COMPOSER_CODE_CLI: "composer_code_cli";
-export declare const COMPOSER_CODE_CHAIN: "composer_code_chain";
-export declare const COMPOSER_HANDOFF_CREATE: "composer_handoff_create";
-/**
- * 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 interface ComposerServerOptions {
-    root?: string;
+import type { ComposerConfig } from "./config/schema.js";
+import type { ComposerServerOptions } from "./tools/context.js";
+export { applyFileBlocks } from "./util/applyFileBlocks.js";
+export * from "./server/toolDescriptions.js";
+export type { ComposerServerOptions } from "./tools/context.js";
+export interface ConfigRefreshState {
+    lastConfigMtimeMs?: number;
 }
+export interface ConfigRefreshOptions {
+    configPath?: string;
+    registry: Pick<ProviderRegistry, "setConfig">;
+    getActiveConfig: () => ComposerConfig | undefined;
+    setActiveConfig: (config: ComposerConfig | undefined) => void;
+    state: ConfigRefreshState;
+    statSync?: (path: string) => Pick<fs.Stats, "mtimeMs">;
+    loadConfig?: (path: string) => ComposerConfig;
+    log?: (message: string) => void;
+}
+export declare function refreshConfigIfChanged({ configPath, registry, getActiveConfig, setActiveConfig, state, statSync, loadConfig, log, }: ConfigRefreshOptions): void;
 export declare function createComposerServer(registry: ProviderRegistry, options?: ComposerServerOptions): McpServer;