agent-composer 0.3.1 → 0.4.1

package/dist/tools/code.js

@@ -0,0 +1,160 @@
+import { z } from "zod";
+import { withProgress } from "../server/progress.js";
+import { contextWithHandoff } from "../server/handoffContext.js";
+import { applyFileBlocks, resolveProjectDir } from "../util/applyFileBlocks.js";
+import { createDeadlineSignal } from "../util/asyncControl.js";
+import { COMPOSER_CODE, COMPOSER_CODE_CHAIN, COMPOSER_CODE_CLI, CODE_DESCRIPTION, CODE_CHAIN_DESCRIPTION, CODE_CLI_DESCRIPTION, } from "../server/toolDescriptions.js";
+const DEFAULT_CODER_TIMEOUT_MS = 300_000;
+const DEFAULT_CODER_CLI_TIMEOUT_MS = 240_000;
+export function registerCodeTools(ctx) {
+    const { server, registry, root } = ctx;
+    server.registerTool(COMPOSER_CODE, {
+        description: CODE_DESCRIPTION,
+        inputSchema: {
+            prompt: z.string().min(1),
+            context: z.string().optional(),
+            handoffPath: z.string().optional(),
+        },
+        annotations: {
+            title: "Composer Code",
+            readOnlyHint: false,
+            openWorldHint: false,
+            destructiveHint: false,
+            idempotentHint: false,
+        },
+    }, async ({ prompt, context, handoffPath }, extra) => {
+        ctx.refreshConfigIfChanged();
+        const provider = registry.getProviderForRole("coder");
+        const toolSignal = createBoundedSignal(COMPOSER_CODE, resolveRoleTimeoutMs(ctx.getActiveConfig()?.roles.coder?.timeoutMs, DEFAULT_CODER_TIMEOUT_MS), extra.signal);
+        try {
+            const result = await withProgress(extra, COMPOSER_CODE, (onProgress) => provider.execute({
+                prompt,
+                context: contextWithHandoff(root, context, handoffPath),
+                onProgress,
+                signal: toolSignal.signal,
+            }), { tracker: ctx.activeRuns, providerLabel: provider.modelLabel, providerRole: "coder" });
+            return { content: [{ type: "text", text: result.text }] };
+        }
+        finally {
+            toolSignal.cleanup();
+        }
+    });
+    server.registerTool(COMPOSER_CODE_CHAIN, {
+        description: CODE_CHAIN_DESCRIPTION,
+        inputSchema: {
+            prompt: z.string().min(1),
+            context: z.string().optional(),
+            handoffPath: z.string().optional(),
+            projectDir: z.string().optional(),
+        },
+        annotations: {
+            title: "Composer Code (GLM author -> CLI apply)",
+            readOnlyHint: false,
+            openWorldHint: false,
+            destructiveHint: true,
+            idempotentHint: false,
+        },
+    }, async ({ prompt, context, handoffPath, projectDir }, extra) => {
+        ctx.refreshConfigIfChanged();
+        const targetRoot = resolveProjectDir(projectDir, root);
+        // Stage 1: GLM authors the code off-CC (returns full file contents).
+        const gen = registry.getProviderForRole("coder");
+        const genPrompt = prompt +
+            `\n\nTARGET PROJECT DIR: ${targetRoot}. All FILE paths must be relative to this directory.` +
+            "\n\nOUTPUT FORMAT: give the COMPLETE contents of every file to " +
+            "create or modify. For each file, write a line `FILE: <relative/path>` " +
+            "followed by a fenced code block with the full file content. Use " +
+            "four-backtick fences when file content may contain triple-backtick " +
+            "blocks. No " +
+            "abbreviations, no placeholders, no commentary outside the blocks.";
+        const genSignal = createBoundedSignal(COMPOSER_CODE_CHAIN, resolveRoleTimeoutMs(ctx.getActiveConfig()?.roles.coder?.timeoutMs, DEFAULT_CODER_TIMEOUT_MS), extra.signal);
+        let authored;
+        try {
+            authored = await withProgress(extra, COMPOSER_CODE_CHAIN, (onProgress) => gen.execute({
+                prompt: genPrompt,
+                context: contextWithHandoff(root, context, handoffPath),
+                cwd: targetRoot,
+                onProgress,
+                signal: genSignal.signal,
+            }), { tracker: ctx.activeRuns, providerLabel: gen.modelLabel, providerRole: "coder" });
+        }
+        finally {
+            genSignal.cleanup();
+        }
+        // Stage 2: server applies GLM's FILE: blocks deterministically (off-CC,
+        // no LLM transcription step — an executor cannot fabricate the apply).
+        const { files } = applyFileBlocks(authored.text, targetRoot);
+        const changed = files.filter((file) => file.status === "changed");
+        if (changed.length === 0) {
+            throw new Error(`composer_code_chain: apply produced no changes — check projectDir (server cwd is ${process.cwd()}, target was ${targetRoot}); nothing was modified`);
+        }
+        const summary = `GLM authored + applied off-CC in projectDir ${targetRoot}. ` +
+            `Changed ${changed.length}/${files.length} file(s): ` +
+            files.map((file) => `${file.path}=${file.status}`).join(", ") + ".";
+        return { content: [{ type: "text", text: summary }] };
+    });
+    server.registerTool(COMPOSER_CODE_CLI, {
+        description: CODE_CLI_DESCRIPTION,
+        inputSchema: {
+            prompt: z.string().min(1),
+            context: z.string().optional(),
+            handoffPath: z.string().optional(),
+            projectDir: z.string().optional(),
+            profile: z.string().min(1).optional(),
+        },
+        annotations: {
+            title: "Composer Code (CLI apply)",
+            readOnlyHint: false,
+            openWorldHint: false,
+            destructiveHint: true,
+            idempotentHint: false,
+        },
+    }, async ({ prompt, context, handoffPath, projectDir, profile }, extra) => {
+        ctx.refreshConfigIfChanged();
+        const targetRoot = resolveProjectDir(projectDir, root);
+        const profiles = ctx.getActiveConfig()?.codexProfiles;
+        const effectiveProfile = profile ?? ctx.getSession().profile;
+        let profileModel;
+        let profileReasoning;
+        let profileSandbox;
+        if (effectiveProfile !== undefined) {
+            const prof = profiles?.[effectiveProfile];
+            if (!prof) {
+                throw new Error(`composer_code_cli: unknown profile "${effectiveProfile}" — define it under codexProfiles in composer.config.json.`);
+            }
+            profileModel = prof.model;
+            profileReasoning = prof.reasoningEffort;
+            profileSandbox = prof.sandbox;
+        }
+        const provider = registry.getProviderForRole("coderCli");
+        const toolSignal = createBoundedSignal(COMPOSER_CODE_CLI, resolveRoleTimeoutMs(ctx.getActiveConfig()?.roles.coderCli?.timeoutMs, DEFAULT_CODER_CLI_TIMEOUT_MS), extra.signal);
+        try {
+            const result = await withProgress(extra, COMPOSER_CODE_CLI, (onProgress) => provider.execute({
+                prompt,
+                context: contextWithHandoff(root, context, handoffPath),
+                cwd: root,
+                projectDir: projectDir === undefined ? undefined : targetRoot,
+                model: profileModel,
+                reasoningEffort: profileReasoning,
+                sandbox: profileSandbox,
+                onProgress,
+                signal: toolSignal.signal,
+            }), { tracker: ctx.activeRuns, providerLabel: provider.modelLabel, providerRole: "coderCli" });
+            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=code.js.map

package/dist/tools/code.js.map

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

package/dist/tools/codexLifecycle.d.ts

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

package/dist/tools/codexLifecycle.js

@@ -0,0 +1,206 @@
+import { z } from "zod";
+import { withProgress } from "../server/progress.js";
+import { resolveProjectDir } from "../util/applyFileBlocks.js";
+import { COMPOSER_CODEX_LIFECYCLE_DECIDE, COMPOSER_CODEX_LIFECYCLE_RUN, COMPOSER_CODEX_LIFECYCLE_RESULT, CODEX_LIFECYCLE_DECIDE_DESCRIPTION, CODEX_LIFECYCLE_RUN_DESCRIPTION, CODEX_LIFECYCLE_RESULT_DESCRIPTION, } from "../server/toolDescriptions.js";
+import { decideCodexLifecycle, resolveCodexLifecycle, } from "../util/codexLifecycle.js";
+import { newCodexLifecycleJob, readCodexLifecycleJob, readLatestCodexLifecycleJob, updateCodexLifecycleJob, writeCodexLifecycleJob, } from "../util/codexLifecycleJob.js";
+import { runCodexLifecycleJob } from "../server/codexLifecycleRunner.js";
+export function registerCodexLifecycleTools(ctx) {
+    const { server, registry, root } = ctx;
+    server.registerTool(COMPOSER_CODEX_LIFECYCLE_DECIDE, {
+        description: CODEX_LIFECYCLE_DECIDE_DESCRIPTION,
+        inputSchema: {
+            event: z.enum([
+                "postResearch",
+                "postPlan",
+                "postCodeApply",
+                "postTestFailure",
+                "afterFailedAttempts",
+                "preCommit",
+                "stopWarm",
+            ]),
+            signals: z
+                .object({
+                expectedOutputTokens: z.number().int().min(0).optional(),
+                changedFiles: z.number().int().min(0).optional(),
+                diffLines: z.number().int().min(0).optional(),
+                failedAttempts: z.number().int().min(0).optional(),
+                failingTests: z.boolean().optional(),
+                touchesSecurity: z.boolean().optional(),
+                touchesInfra: z.boolean().optional(),
+                userRequestedCodex: z.boolean().optional(),
+                hasHandoff: z.boolean().optional(),
+                isTrivial: z.boolean().optional(),
+                isDestructive: z.boolean().optional(),
+                risk: z.enum(["low", "medium", "high", "critical"]).optional(),
+            })
+                .strict()
+                .optional(),
+        },
+        annotations: {
+            title: "Composer Codex Lifecycle Decide",
+            readOnlyHint: true,
+            openWorldHint: false,
+            destructiveHint: false,
+            idempotentHint: true,
+        },
+    }, async ({ event, signals }) => {
+        const result = decideCodexLifecycle(ctx.getActiveConfig()?.codexLifecycle, event, signals);
+        return {
+            content: [{ type: "text", text: JSON.stringify(result, null, 2) }],
+        };
+    });
+    server.registerTool(COMPOSER_CODEX_LIFECYCLE_RUN, {
+        description: CODEX_LIFECYCLE_RUN_DESCRIPTION,
+        inputSchema: {
+            event: z.enum([
+                "postResearch",
+                "postPlan",
+                "postCodeApply",
+                "postTestFailure",
+                "afterFailedAttempts",
+                "preCommit",
+                "stopWarm",
+            ]),
+            prompt: z.string().min(1),
+            context: z.string().optional(),
+            handoffPath: z.string().optional(),
+            objective: z.string().optional(),
+            execution: z.enum(["foreground", "background"]).optional(),
+            confirmed: z.boolean().optional(),
+            projectDir: z.string().optional(),
+            signals: z
+                .object({
+                expectedOutputTokens: z.number().int().min(0).optional(),
+                changedFiles: z.number().int().min(0).optional(),
+                diffLines: z.number().int().min(0).optional(),
+                failedAttempts: z.number().int().min(0).optional(),
+                failingTests: z.boolean().optional(),
+                touchesSecurity: z.boolean().optional(),
+                touchesInfra: z.boolean().optional(),
+                userRequestedCodex: z.boolean().optional(),
+                hasHandoff: z.boolean().optional(),
+                isTrivial: z.boolean().optional(),
+                isDestructive: z.boolean().optional(),
+                risk: z.enum(["low", "medium", "high", "critical"]).optional(),
+            })
+                .strict()
+                .optional(),
+        },
+        annotations: {
+            title: "Composer Codex Lifecycle Run",
+            readOnlyHint: false,
+            openWorldHint: true,
+            destructiveHint: false,
+            idempotentHint: false,
+        },
+    }, async ({ event, prompt, context, handoffPath, objective, execution, confirmed, projectDir, signals }, extra) => {
+        ctx.refreshConfigIfChanged();
+        const lifecycleConfig = ctx.getActiveConfig()?.codexLifecycle;
+        const resolvedLifecycle = resolveCodexLifecycle(lifecycleConfig);
+        const policyDecision = decideCodexLifecycle(lifecycleConfig, event, signals);
+        const decision = confirmed === true && policyDecision.action === "ask"
+            ? {
+                ...policyDecision,
+                action: "run",
+                reasons: [...policyDecision.reasons, "user confirmed Codex lifecycle ask"],
+            }
+            : policyDecision;
+        const selectedExecution = execution ?? decision.execution;
+        let job = newCodexLifecycleJob(root, {
+            event,
+            decision,
+            execution: selectedExecution,
+            handoffPath,
+            objective,
+        });
+        job = writeCodexLifecycleJob(root, job);
+        if (decision.action !== "run") {
+            job = updateCodexLifecycleJob(root, job, {
+                status: "skipped",
+                completedAt: new Date().toISOString(),
+                resultText: `Lifecycle policy returned ${decision.action}; Codex was not run.`,
+            });
+            return {
+                content: [{ type: "text", text: JSON.stringify(job, null, 2) }],
+            };
+        }
+        let targetRoot;
+        try {
+            targetRoot = projectDir === undefined ? undefined : resolveProjectDir(projectDir, root);
+        }
+        catch (error) {
+            job = updateCodexLifecycleJob(root, job, {
+                status: "failed",
+                completedAt: new Date().toISOString(),
+                error: error instanceof Error ? error.message : String(error),
+            });
+            return {
+                content: [{ type: "text", text: JSON.stringify(job, null, 2) }],
+            };
+        }
+        const runner = (onProgress) => runCodexLifecycleJob({
+            root,
+            registry,
+            job,
+            prompt,
+            context,
+            handoffPath,
+            projectDir: targetRoot,
+            signal: selectedExecution === "foreground" ? extra.signal : undefined,
+            fallback: resolvedLifecycle.fallback,
+            maxTotalMs: resolvedLifecycle.totalWallClockMs,
+            roleTimeoutMs: Object.fromEntries(Object.entries(ctx.getActiveConfig()?.roles ?? {}).map(([role, config]) => [
+                role,
+                config.timeoutMs,
+            ])),
+            onProgress,
+        });
+        if (selectedExecution === "background") {
+            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) }],
+            };
+        }
+        const provider = registry.getProviderForRole("coderCli");
+        const completed = await withProgress(extra, COMPOSER_CODEX_LIFECYCLE_RUN, runner, {
+            tracker: ctx.activeRuns,
+            providerLabel: provider.modelLabel,
+            providerRole: "coderCli",
+        });
+        return {
+            content: [{ type: "text", text: JSON.stringify(completed, null, 2) }],
+        };
+    });
+    server.registerTool(COMPOSER_CODEX_LIFECYCLE_RESULT, {
+        description: CODEX_LIFECYCLE_RESULT_DESCRIPTION,
+        inputSchema: {
+            jobId: z.string().uuid().optional(),
+        },
+        annotations: {
+            title: "Composer Codex Lifecycle Result",
+            readOnlyHint: true,
+            openWorldHint: false,
+            destructiveHint: false,
+            idempotentHint: true,
+        },
+    }, async ({ jobId }) => {
+        const job = jobId
+            ? readCodexLifecycleJob(root, jobId)
+            : readLatestCodexLifecycleJob(root);
+        const response = job ?? {
+            found: false,
+            jobId: jobId ?? null,
+            message: jobId
+                ? `No Codex lifecycle result found for ${jobId}.`
+                : "No Codex lifecycle results found.",
+        };
+        return {
+            content: [{ type: "text", text: JSON.stringify(response, null, 2) }],
+        };
+    });
+}
+//# sourceMappingURL=codexLifecycle.js.map

package/dist/tools/codexLifecycle.js.map

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

package/dist/tools/config.d.ts

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

package/dist/tools/config.js

@@ -0,0 +1,183 @@
+import { z } from "zod";
+import fs from "node:fs";
+import { COMPOSER_CONFIG_GET, COMPOSER_CONFIG_SET, CONFIG_GET_DESCRIPTION, CONFIG_SET_DESCRIPTION, } from "../server/toolDescriptions.js";
+import { resolveComposerConfigTarget, applyComposerConfigPatch, assertSafeConfigWriteTarget, writeConfigFileAtomically, isGlobalComposerConfigPath, } from "../server/configMutation.js";
+import { parseConfig } from "../config/loader.js";
+import { modePatch } from "../config/modes.js";
+export function registerConfigTools(ctx) {
+    const { server, root } = ctx;
+    server.registerTool(COMPOSER_CONFIG_GET, {
+        description: CONFIG_GET_DESCRIPTION,
+        inputSchema: {
+            scope: z.enum(["active", "project", "global"]).optional(),
+        },
+        annotations: {
+            title: "Composer Config Get",
+            readOnlyHint: true,
+            openWorldHint: false,
+            destructiveHint: false,
+            idempotentHint: true,
+        },
+    }, async ({ scope }) => {
+        const target = resolveComposerConfigTarget(root, ctx.options.configPath, scope ?? "active");
+        const response = fs.existsSync(target.path)
+            ? {
+                ...target,
+                exists: true,
+                config: parseConfig(JSON.parse(fs.readFileSync(target.path, "utf8"))),
+            }
+            : {
+                ...target,
+                exists: false,
+                config: null,
+            };
+        return {
+            content: [{ type: "text", text: JSON.stringify(response, null, 2) }],
+        };
+    });
+    server.registerTool(COMPOSER_CONFIG_SET, {
+        description: CONFIG_SET_DESCRIPTION,
+        inputSchema: {
+            scope: z.enum(["active", "project", "global"]).optional(),
+            dryRun: z.boolean().optional(),
+            codexLifecycle: z
+                .object({
+                enabled: z.boolean().optional(),
+                mode: z.enum(["ask", "auto"]).optional(),
+                execution: z.enum(["foreground", "background"]).optional(),
+                model: z.string().min(1).optional(),
+                triggers: z
+                    .object({
+                    postResearch: z.boolean().optional(),
+                    postPlan: z.boolean().optional(),
+                    postCodeApply: z.boolean().optional(),
+                    postTestFailure: z.boolean().optional(),
+                    afterFailedAttempts: z.boolean().optional(),
+                    preCommit: z.boolean().optional(),
+                    stopWarm: z.boolean().optional(),
+                })
+                    .strict()
+                    .optional(),
+                thresholds: z
+                    .object({
+                    minScore: z.number().min(0).max(100).optional(),
+                    minExpectedOutputTokens: z.number().int().min(1).optional(),
+                    minChangedFiles: z.number().int().min(1).optional(),
+                    minDiffLines: z.number().int().min(1).optional(),
+                    failedAttempts: z.number().int().min(1).optional(),
+                })
+                    .strict()
+                    .optional(),
+                fallback: z
+                    .object({
+                    enabled: z.boolean().optional(),
+                    order: z
+                        .array(z.enum(["researcher", "coder", "reviewer", "reviewerClaude", "coderCli"]))
+                        .min(1)
+                        .optional(),
+                })
+                    .strict()
+                    .optional(),
+            })
+                .strict()
+                .optional(),
+            codexReview: z
+                .object({
+                enabled: z.boolean().optional(),
+                mode: z.enum(["ask", "auto"]).optional(),
+                execution: z.enum(["foreground", "background"]).optional(),
+                scope: z.enum(["auto", "working-tree", "branch"]).optional(),
+                base: z.string().min(1).optional(),
+                model: z.string().min(1).optional(),
+                triggers: z
+                    .object({
+                    preCommit: z.boolean().optional(),
+                    postPlan: z.boolean().optional(),
+                })
+                    .strict()
+                    .optional(),
+                preCommitHook: z
+                    .object({
+                    enabled: z.boolean().optional(),
+                    blockOnSeverity: z.enum(["critical", "high", "medium", "low"]).optional(),
+                    timeoutMs: z.number().int().min(1).optional(),
+                    failClosed: z.boolean().optional(),
+                })
+                    .strict()
+                    .optional(),
+                warmCache: z
+                    .object({
+                    enabled: z.boolean().optional(),
+                    maxAgeMinutes: z.number().int().min(1).optional(),
+                    timeoutMs: z.number().int().min(1).optional(),
+                })
+                    .strict()
+                    .optional(),
+                notify: z
+                    .object({
+                    desktop: z.boolean().optional(),
+                })
+                    .strict()
+                    .optional(),
+            })
+                .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(),
+            mode: z.enum(["fast", "balanced", "strict"]).optional(),
+        },
+        annotations: {
+            title: "Composer Config Set",
+            readOnlyHint: false,
+            openWorldHint: false,
+            destructiveHint: false,
+            idempotentHint: true,
+        },
+    }, async ({ scope, dryRun, codexLifecycle, codexReview, oracle, mode }) => {
+        const requestedScope = scope ?? "active";
+        const target = resolveComposerConfigTarget(root, ctx.options.configPath, requestedScope);
+        if (requestedScope === "active" && isGlobalComposerConfigPath(target.path)) {
+            throw new Error('Active Composer config resolves to the user-global config; use scope:"global" explicitly to mutate it.');
+        }
+        if (!fs.existsSync(target.path)) {
+            throw new Error(`Composer config target does not exist: ${target.path}`);
+        }
+        const beforeRaw = fs.readFileSync(target.path, "utf8");
+        const before = JSON.parse(beforeRaw);
+        const preset = mode ? modePatch(mode) : undefined;
+        const next = applyComposerConfigPatch(before, {
+            codexLifecycle: codexLifecycle ?? preset?.codexLifecycle,
+            codexReview: codexReview ?? preset?.codexReview,
+            oracle,
+        });
+        const parsed = parseConfig(next);
+        const nextRaw = `${JSON.stringify(parsed, null, 2)}\n`;
+        const changed = beforeRaw !== nextRaw;
+        const activeTarget = resolveComposerConfigTarget(root, ctx.options.configPath, "active");
+        if (!dryRun && changed) {
+            assertSafeConfigWriteTarget(root, target);
+            writeConfigFileAtomically(target.path, nextRaw);
+        }
+        if (!dryRun && target.path === activeTarget.path) {
+            ctx.setActiveConfig(parsed);
+        }
+        const response = {
+            ...target,
+            dryRun: dryRun === true,
+            changed,
+            config: parsed,
+        };
+        return {
+            content: [{ type: "text", text: JSON.stringify(response, null, 2) }],
+        };
+    });
+}
+//# sourceMappingURL=config.js.map

package/dist/tools/config.js.map

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

package/dist/tools/context.d.ts

@@ -0,0 +1,31 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import type { ProviderRegistry } from "../registry.js";
+import type { ComposerConfig } from "../config/schema.js";
+import type { ActiveRunTracker } from "../server/activeRuns.js";
+export interface ComposerServerOptions {
+    root?: string;
+    config?: ComposerConfig;
+    configPath?: string;
+}
+export interface SessionOverrides {
+    mode?: "fast" | "balanced" | "strict";
+    oracle?: {
+        enabled?: boolean;
+        defaultMode?: "auto" | "quick" | "standard" | "deep" | "plan" | "review" | "debug" | "research";
+        requireExplicitTag?: boolean;
+    };
+    profile?: string;
+}
+export interface ServerToolContext {
+    server: McpServer;
+    registry: ProviderRegistry;
+    root: string;
+    options: ComposerServerOptions;
+    getActiveConfig: () => ComposerConfig | undefined;
+    setActiveConfig: (config: ComposerConfig | undefined) => void;
+    refreshConfigIfChanged: () => void;
+    getSession: () => SessionOverrides;
+    setSession: (patch: Partial<SessionOverrides>) => SessionOverrides;
+    resetSession: () => void;
+    activeRuns: ActiveRunTracker;
+}

package/dist/tools/context.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=context.js.map

package/dist/tools/context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.js","sourceRoot":"","sources":["../../src/tools/context.ts"],"names":[],"mappings":""}

package/dist/tools/goal.d.ts

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