agent-composer 0.1.14 → 0.2.0

package/dist/util/dispatchHint.d.ts

@@ -0,0 +1,35 @@
+export type Tier = "cheap" | "premium";
+export type Reasoning = "none" | "low" | "high";
+export type PromptSize = "lite" | "full";
+export interface DispatchSignals {
+    promptChars: number;
+    estOutputTokens: number;
+    hasCode: boolean;
+    hasFileRef: boolean;
+    hasDestructive: boolean;
+    complexityScore: number;
+    isReviewWithInlineDiff: boolean;
+}
+export interface DispatchHint {
+    tier: Tier;
+    reasoning: Reasoning;
+    promptSize: PromptSize;
+    recommendDispatch: boolean;
+    rationale: string;
+    signals: DispatchSignals;
+}
+export interface ClassifyInput {
+    prompt: string;
+    subagentType?: string;
+    description?: string;
+}
+export interface WorkerPromptParts {
+    objective: string;
+    files?: string[];
+    constraints?: string[];
+    acceptance?: string[];
+    brief?: string;
+}
+export declare function classifyDispatch(input: ClassifyInput): DispatchHint;
+export declare function neutralDispatchHint(): DispatchHint;
+export declare function buildWorkerPrompt(hint: DispatchHint, parts: WorkerPromptParts): string;

package/dist/util/dispatchHint.js

@@ -0,0 +1,179 @@
+import { z } from "zod";
+const ClassifyInputSchema = z.object({
+    prompt: z.string(),
+    subagentType: z.string().optional(),
+    description: z.string().optional(),
+});
+const WorkerPromptPartsSchema = z.object({
+    objective: z.string().min(1),
+    files: z.array(z.string()).optional(),
+    constraints: z.array(z.string()).optional(),
+    acceptance: z.array(z.string()).optional(),
+    brief: z.string().optional(),
+});
+const CODE_KEYWORD = /\b(?:function|class|const|let|import|export|def)\b|=>/;
+const FILE_REF = /(\.[a-z0-9]{1,5}\b|src\/|tests\/|lib\/|app\/)[A-Za-z0-9._/-]*(:\d+)?/i;
+const DESTRUCTIVE = /(?:\brm\s+-rf\b|\bdrop\s+table\b|\bdelete\s+from\b|\btruncate\b|\breset\s+--hard\b|--force\b|\bdestroy\b)/i;
+const SENSITIVE = /security|auth|crypto|payment/i;
+const REVIEW = /\b(review|audit)\b/i;
+const DIFF_OR_CODE_BLOCK = /```|^diff --git |^@@ |^(?:---|\+\+\+) /m;
+const HIGH_COMPLEXITY_TERMS = [
+    /\brefactor(?:ing|s|ed)?\b/i,
+    /\bmigrat(?:e|es|ed|ing|ion|ions)\b/i,
+    /\barchitecture\b/i,
+    /\bredesign(?:ing|s|ed)?\b/i,
+    /\bmulti[- ]file\b/i,
+    /\bend[- ]to[- ]end\b/i,
+    /\bschema\b/i,
+    /\bconcurrency\b/i,
+    /\brewrite(?:s|ing|n)?\b/i,
+];
+const LOW_COMPLEXITY_TERMS = [
+    /\btypo\b/i,
+    /\brename(?:s|d|ing)?\b/i,
+    /\bformat(?:s|ted|ting)?\b/i,
+    /\bcomment(?:s|ed|ing)?\b/i,
+    /\bbump(?:s|ed|ing)?\b/i,
+    /\bone[- ]line\b/i,
+    /\btrivial\b/i,
+];
+export function classifyDispatch(input) {
+    const validated = ClassifyInputSchema.parse(input);
+    const prompt = validated.prompt;
+    const description = validated.description ?? "";
+    const promptChars = prompt.length;
+    const hasCode = detectCode(prompt);
+    const hasFileRef = FILE_REF.test(prompt);
+    const hasDestructive = DESTRUCTIVE.test(prompt);
+    const complexityScore = computeComplexityScore(prompt, {
+        hasCode,
+        hasFileRef,
+    });
+    const estOutputTokens = Math.round((promptChars / 4) * (1 + complexityScore * 2)) +
+        (hasCode ? 200 : 0);
+    const isReviewWithInlineDiff = REVIEW.test(`${description}\n${prompt}`) && DIFF_OR_CODE_BLOCK.test(prompt);
+    let recommendDispatch = estOutputTokens > 500 || (hasFileRef && complexityScore > 0.3);
+    if (isReviewWithInlineDiff && estOutputTokens <= 600) {
+        recommendDispatch = false;
+    }
+    if (hasDestructive && promptChars < 200) {
+        recommendDispatch = false;
+    }
+    const sensitive = SENSITIVE.test(`${description}\n${prompt}`);
+    const tier = complexityScore >= 0.6 || promptChars > 2000 || sensitive
+        ? "premium"
+        : "cheap";
+    const reasoning = complexityScore >= 0.6 ? "high" : complexityScore >= 0.25 ? "low" : "none";
+    const promptSize = complexityScore >= 0.4 || (hasFileRef && estOutputTokens > 800)
+        ? "full"
+        : "lite";
+    const signals = {
+        promptChars,
+        estOutputTokens,
+        hasCode,
+        hasFileRef,
+        hasDestructive,
+        complexityScore,
+        isReviewWithInlineDiff,
+    };
+    return {
+        tier,
+        reasoning,
+        promptSize,
+        recommendDispatch,
+        rationale: rationaleFor({ recommendDispatch, signals, sensitive }),
+        signals,
+    };
+}
+export function neutralDispatchHint() {
+    return classifyDispatch({ prompt: "" });
+}
+export function buildWorkerPrompt(hint, parts) {
+    const validated = WorkerPromptPartsSchema.parse(parts);
+    const sections = [formatBlock("Objective", validated.objective)];
+    const files = nonEmptyItems(validated.files ?? []);
+    if (files.length > 0)
+        sections.push(formatList("Files", files));
+    if (hint.promptSize === "full") {
+        const constraints = nonEmptyItems(validated.constraints ?? []);
+        const acceptance = nonEmptyItems(validated.acceptance ?? []);
+        const brief = validated.brief ?? "";
+        if (constraints.length > 0)
+            sections.push(formatList("Constraints", constraints));
+        if (acceptance.length > 0)
+            sections.push(formatList("Acceptance", acceptance));
+        if (brief.trim().length > 0)
+            sections.push(formatBlock("Brief", brief));
+    }
+    return sections.join("\n\n");
+}
+function detectCode(prompt) {
+    if (/```/.test(prompt))
+        return true;
+    if (hasIndentedBlock(prompt))
+        return true;
+    const matchCount = Array.from(prompt.matchAll(new RegExp(CODE_KEYWORD.source, "g"))).length;
+    if (matchCount === 0)
+        return false;
+    const wordCount = prompt.match(/\b[\w-]+\b/g)?.length ?? 1;
+    const density = matchCount / Math.max(1, wordCount);
+    return matchCount >= 2 || density >= 0.02;
+}
+function hasIndentedBlock(prompt) {
+    for (const line of prompt.split(/\r?\n/)) {
+        if (/^(?: {4,}|\t)\S/.test(line)) {
+            return true;
+        }
+    }
+    return false;
+}
+function computeComplexityScore(prompt, signals) {
+    let score = 0;
+    for (const term of HIGH_COMPLEXITY_TERMS) {
+        if (term.test(prompt))
+            score += 0.3;
+    }
+    for (const term of LOW_COMPLEXITY_TERMS) {
+        if (term.test(prompt))
+            score -= 0.2;
+    }
+    if (signals.hasCode)
+        score += 0.15;
+    if (signals.hasFileRef)
+        score += 0.1;
+    if (prompt.length > 1200)
+        score += 0.2;
+    return roundScore(clamp(score, 0, 1));
+}
+function rationaleFor(input) {
+    const { recommendDispatch, signals, sensitive } = input;
+    if (signals.hasDestructive && signals.promptChars < 200) {
+        return `No dispatch: destructive tiny prompt mirrors guard deny at ${signals.promptChars} chars.`;
+    }
+    if (signals.isReviewWithInlineDiff && signals.estOutputTokens <= 600) {
+        return `No dispatch: inline review carve-out keeps ${signals.estOutputTokens} estimated tokens local.`;
+    }
+    if (recommendDispatch) {
+        return `Dispatch: estimated ${signals.estOutputTokens} tokens with complexity ${signals.complexityScore} and fileRef=${signals.hasFileRef}.`;
+    }
+    if (sensitive) {
+        return `No dispatch: sensitive keyword selects premium tier while estimate stays ${signals.estOutputTokens} tokens.`;
+    }
+    return `No dispatch: estimated ${signals.estOutputTokens} tokens, complexity ${signals.complexityScore}, fileRef=${signals.hasFileRef}.`;
+}
+function nonEmptyItems(items) {
+    return items.filter((item) => item.trim().length > 0);
+}
+function formatBlock(label, body) {
+    return `${label}:\n${body}`;
+}
+function formatList(label, items) {
+    return `${label}:\n${items.map((item) => `- ${item}`).join("\n")}`;
+}
+function clamp(value, min, max) {
+    return Math.min(max, Math.max(min, value));
+}
+function roundScore(value) {
+    return Math.round(value * 100) / 100;
+}
+//# sourceMappingURL=dispatchHint.js.map

package/dist/util/dispatchHint.js.map

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

package/dist/util/handoff.d.ts

@@ -0,0 +1,58 @@
+import { z } from "zod";
+export declare const HANDOFF_DIR = ".composer/handoffs";
+export declare const HANDOFF_VERSION = 1;
+export declare const HandoffArtifactSchema: z.ZodObject<{
+    kind: z.ZodEnum<{
+        research: "research";
+        code: "code";
+        review: "review";
+        test: "test";
+        note: "note";
+    }>;
+    summary: z.ZodString;
+    path: z.ZodOptional<z.ZodString>;
+    source: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export declare const HandoffPacketSchema: z.ZodObject<{
+    version: z.ZodLiteral<1>;
+    runId: z.ZodString;
+    createdAt: z.ZodString;
+    updatedAt: z.ZodString;
+    objective: z.ZodString;
+    contextSummary: z.ZodOptional<z.ZodString>;
+    constraints: z.ZodArray<z.ZodString>;
+    relevantFiles: z.ZodArray<z.ZodString>;
+    acceptanceCriteria: z.ZodArray<z.ZodString>;
+    decisions: z.ZodArray<z.ZodString>;
+    openQuestions: z.ZodArray<z.ZodString>;
+    artifacts: z.ZodArray<z.ZodObject<{
+        kind: z.ZodEnum<{
+            research: "research";
+            code: "code";
+            review: "review";
+            test: "test";
+            note: "note";
+        }>;
+        summary: z.ZodString;
+        path: z.ZodOptional<z.ZodString>;
+        source: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    briefPath: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type HandoffArtifact = z.infer<typeof HandoffArtifactSchema>;
+export type HandoffPacket = z.infer<typeof HandoffPacketSchema>;
+export interface NewHandoffPacketInput {
+    objective: string;
+    contextSummary?: string;
+    constraints?: string[];
+    relevantFiles?: string[];
+    acceptanceCriteria?: string[];
+    decisions?: string[];
+    openQuestions?: string[];
+    artifacts?: HandoffArtifact[];
+    briefPath?: string;
+}
+export declare function newHandoffPacket(input: NewHandoffPacketInput): HandoffPacket;
+export declare function writeHandoffPacket(packet: HandoffPacket, dir?: string): string;
+export declare function readHandoffPacket(handoffPath: string, root?: string): HandoffPacket;
+export declare function formatHandoffForPrompt(packet: HandoffPacket): string;

package/dist/util/handoff.js

@@ -0,0 +1,107 @@
+import { randomUUID } from "node:crypto";
+import { mkdirSync, readFileSync, realpathSync, writeFileSync } from "node:fs";
+import { resolve } from "node:path";
+import { z } from "zod";
+export const HANDOFF_DIR = ".composer/handoffs";
+export const HANDOFF_VERSION = 1;
+export const HandoffArtifactSchema = 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(),
+});
+export const HandoffPacketSchema = z.object({
+    version: z.literal(HANDOFF_VERSION),
+    runId: z.string().uuid(),
+    createdAt: z.string().datetime(),
+    updatedAt: z.string().datetime(),
+    objective: z.string().min(1),
+    contextSummary: z.string().min(1).optional(),
+    constraints: z.array(z.string().min(1)),
+    relevantFiles: z.array(z.string().min(1)),
+    acceptanceCriteria: z.array(z.string().min(1)),
+    decisions: z.array(z.string().min(1)),
+    openQuestions: z.array(z.string().min(1)),
+    artifacts: z.array(HandoffArtifactSchema),
+    briefPath: z.string().min(1).optional(),
+});
+export function newHandoffPacket(input) {
+    const now = new Date().toISOString();
+    return HandoffPacketSchema.parse({
+        version: HANDOFF_VERSION,
+        runId: randomUUID(),
+        createdAt: now,
+        updatedAt: now,
+        objective: input.objective,
+        contextSummary: input.contextSummary,
+        constraints: input.constraints ?? [],
+        relevantFiles: input.relevantFiles ?? [],
+        acceptanceCriteria: input.acceptanceCriteria ?? [],
+        decisions: input.decisions ?? [],
+        openQuestions: input.openQuestions ?? [],
+        artifacts: input.artifacts ?? [],
+        briefPath: input.briefPath,
+    });
+}
+export function writeHandoffPacket(packet, dir = HANDOFF_DIR) {
+    const validated = HandoffPacketSchema.parse(packet);
+    const absDir = resolve(dir);
+    mkdirSync(absDir, { recursive: true });
+    const filePath = resolve(absDir, `${validated.runId}.json`);
+    writeFileSync(filePath, `${JSON.stringify(validated, null, 2)}\n`, "utf8");
+    return filePath;
+}
+export function readHandoffPacket(handoffPath, root = process.cwd()) {
+    const absRoot = resolve(root);
+    const absHandoffDir = resolve(absRoot, HANDOFF_DIR);
+    const absPath = resolve(absRoot, handoffPath);
+    if (!isInside(absHandoffDir, absPath)) {
+        throw new Error(`handoffPath must resolve under ${HANDOFF_DIR}; got ${handoffPath}`);
+    }
+    const realHandoffDir = realpathSync(absHandoffDir);
+    const realPath = realpathSync(absPath);
+    if (!isInside(realHandoffDir, realPath)) {
+        throw new Error(`handoffPath must resolve under ${HANDOFF_DIR}; got ${handoffPath}`);
+    }
+    const raw = readFileSync(realPath, "utf8");
+    return HandoffPacketSchema.parse(JSON.parse(raw));
+}
+export function formatHandoffForPrompt(packet) {
+    const lines = [
+        "Shared handoff:",
+        `- runId: ${packet.runId}`,
+        `- objective: ${packet.objective}`,
+    ];
+    if (packet.contextSummary)
+        lines.push(`- context: ${packet.contextSummary}`);
+    pushList(lines, "constraints", packet.constraints);
+    pushList(lines, "relevantFiles", packet.relevantFiles);
+    pushList(lines, "acceptanceCriteria", packet.acceptanceCriteria);
+    pushList(lines, "decisions", packet.decisions);
+    pushList(lines, "openQuestions", packet.openQuestions);
+    if (packet.briefPath)
+        lines.push(`- briefPath: ${packet.briefPath}`);
+    if (packet.artifacts.length > 0) {
+        lines.push("- artifacts:");
+        for (const artifact of packet.artifacts) {
+            const source = artifact.source ? ` (${artifact.source})` : "";
+            const path = artifact.path ? ` [${artifact.path}]` : "";
+            lines.push(`  - ${artifact.kind}${source}${path}: ${artifact.summary}`);
+        }
+    }
+    return lines.join("\n");
+}
+function pushList(lines, label, values) {
+    if (values.length === 0)
+        return;
+    lines.push(`- ${label}:`);
+    for (const value of values) {
+        lines.push(`  - ${value}`);
+    }
+}
+function isInside(parent, child) {
+    const normalizedParent = parent.endsWith("/") ? parent : `${parent}/`;
+    const normalizedChild = child.endsWith("/") ? child : child;
+    return normalizedChild === parent || normalizedChild.startsWith(normalizedParent);
+}
+//# sourceMappingURL=handoff.js.map

package/dist/util/handoff.js.map

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

package/dist/util/projectToolResult.d.ts

@@ -0,0 +1,13 @@
+export interface ProjectOptions {
+    maxChars?: number;
+    headChars?: number;
+    tailChars?: number;
+}
+export interface ProjectResult {
+    text: string;
+    projected: boolean;
+    originalChars: number;
+    keptChars: number;
+    kind: "json" | "diff" | "log" | "generic";
+}
+export declare function projectToolResult(input: string, opts?: ProjectOptions): ProjectResult;

package/dist/util/projectToolResult.js

@@ -0,0 +1,169 @@
+const DEFAULT_MAX_CHARS = 16_000;
+const PROJECTED_MARKER = /(?:^|\n)… \[elided \d+ chars \/ \d+ lines\] …(?:\n|$)/;
+const JSON_PREFIX = "[projected JSON:";
+const LOG_LINE = /^(?:\s*(?:PASS\b|FAIL\b|✓|✗|Error\b)|[^:\n]+:\d+:\d+\b|\s+at [^\n]+:\d+(?::\d+)?\b)/;
+export function projectToolResult(input, opts = {}) {
+    if (typeof input !== "string") {
+        throw new Error("projectToolResult: input must be a string");
+    }
+    const options = normalizeOptions(opts);
+    const kind = detectKind(input);
+    if (input.length === 0 || input.length <= options.maxChars || isAlreadyProjected(input)) {
+        return {
+            text: input,
+            projected: false,
+            originalChars: input.length,
+            keptChars: input.length,
+            kind,
+        };
+    }
+    const text = kind === "json"
+        ? projectJson(input, options.maxChars)
+        : projectText(input, options.headChars, options.tailChars);
+    return {
+        text,
+        projected: true,
+        originalChars: input.length,
+        keptChars: text.length,
+        kind,
+    };
+}
+function normalizeOptions(opts) {
+    const maxChars = normalizeLimit("maxChars", opts.maxChars, DEFAULT_MAX_CHARS);
+    const defaultHeadChars = Math.round(maxChars * 0.6);
+    const defaultTailChars = Math.round(maxChars * 0.25);
+    const headChars = normalizeLimit("headChars", opts.headChars, defaultHeadChars, true);
+    const tailChars = normalizeLimit("tailChars", opts.tailChars, defaultTailChars, true);
+    return { maxChars, headChars, tailChars };
+}
+function normalizeLimit(name, value, fallback, allowZero = false) {
+    const raw = value ?? fallback;
+    if (raw === Number.POSITIVE_INFINITY)
+        return Number.MAX_SAFE_INTEGER;
+    if (!Number.isFinite(raw)) {
+        throw new Error(`projectToolResult: ${name} must be a finite number`);
+    }
+    const rounded = Math.round(raw);
+    if (rounded < 0 || (!allowZero && rounded === 0)) {
+        const expectation = allowZero ? "non-negative" : "positive";
+        throw new Error(`projectToolResult: ${name} must be ${expectation}`);
+    }
+    return rounded;
+}
+function isAlreadyProjected(input) {
+    return input.startsWith(JSON_PREFIX) || PROJECTED_MARKER.test(input);
+}
+function detectKind(input) {
+    const trimmed = input.trim();
+    if (trimmed.length > 0 && (trimmed.startsWith("{") || trimmed.startsWith("["))) {
+        try {
+            JSON.parse(trimmed);
+            return "json";
+        }
+        catch {
+            // Invalid JSON still falls through to text heuristics.
+        }
+    }
+    if (looksLikeDiff(input))
+        return "diff";
+    if (looksLikeLog(input))
+        return "log";
+    return "generic";
+}
+function looksLikeDiff(input) {
+    if (/^diff --git /m.test(input) || /^@@ /m.test(input))
+        return true;
+    const plusMinusLines = input
+        .split("\n")
+        .filter((line) => /^[+-]/.test(line)).length;
+    return plusMinusLines >= 6;
+}
+function looksLikeLog(input) {
+    return input.split("\n").some((line) => LOG_LINE.test(line));
+}
+function projectText(input, headChars, tailChars) {
+    const collapsed = collapseRepeatedLines(input);
+    const head = collapsed.slice(0, headChars);
+    const tailStart = tailChars === 0
+        ? collapsed.length
+        : Math.max(head.length, collapsed.length - tailChars);
+    const middle = collapsed.slice(head.length, tailStart);
+    const tail = collapsed.slice(tailStart);
+    const marker = `\n… [elided ${middle.length} chars / ${countLines(middle)} lines] …\n`;
+    return `${head}${marker}${tail}`;
+}
+function collapseRepeatedLines(input) {
+    const lines = input.split("\n");
+    const collapsed = [];
+    for (let index = 0; index < lines.length;) {
+        const line = lines[index] ?? "";
+        let count = 1;
+        while (index + count < lines.length && lines[index + count] === line) {
+            count++;
+        }
+        collapsed.push(count > 3 ? `${line} … (×${count})` : lines.slice(index, index + count).join("\n"));
+        index += count;
+    }
+    return collapsed.join("\n");
+}
+function countLines(input) {
+    if (input.length === 0)
+        return 0;
+    return input.split("\n").length;
+}
+function projectJson(input, maxChars) {
+    const parsed = JSON.parse(input.trim());
+    const summary = summarizeJson(parsed);
+    const sample = JSON.stringify(sampleJson(parsed), null, 2) ?? "";
+    const prefix = `${JSON_PREFIX} ${summary}]\n`;
+    if (prefix.length >= maxChars) {
+        return `${prefix.slice(0, Math.max(0, maxChars - 1))}…`;
+    }
+    const remaining = maxChars - prefix.length;
+    return `${prefix}${truncate(sample, remaining)}`;
+}
+function summarizeJson(value, depth = 0) {
+    if (value === null)
+        return "null";
+    if (Array.isArray(value)) {
+        if (value.length === 0)
+            return "array(length=0)";
+        if (depth >= 3)
+            return `array(length=${value.length})`;
+        return `array(length=${value.length}, sample=${summarizeJson(value[0], depth + 1)})`;
+    }
+    if (typeof value === "object") {
+        const entries = Object.entries(value);
+        if (entries.length === 0)
+            return "object{}";
+        if (depth >= 3)
+            return `object(keys=${entries.length})`;
+        const visibleEntries = entries.slice(0, 8).map(([key, entryValue]) => `${key}:${summarizeJson(entryValue, depth + 1)}`);
+        const hidden = entries.length - visibleEntries.length;
+        const suffix = hidden > 0 ? `,…+${hidden} keys` : "";
+        return `object{${visibleEntries.join(",")}${suffix}}`;
+    }
+    return typeof value;
+}
+function sampleJson(value, depth = 0) {
+    if (value === null || typeof value !== "object")
+        return value;
+    if (depth >= 3)
+        return Array.isArray(value) ? [] : {};
+    if (Array.isArray(value)) {
+        return value.length > 0 ? [sampleJson(value[0], depth + 1)] : [];
+    }
+    return Object.fromEntries(Object.entries(value)
+        .slice(0, 8)
+        .map(([key, entryValue]) => [key, sampleJson(entryValue, depth + 1)]));
+}
+function truncate(input, maxChars) {
+    if (maxChars <= 0)
+        return "";
+    if (input.length <= maxChars)
+        return input;
+    if (maxChars === 1)
+        return "…";
+    return `${input.slice(0, maxChars - 1)}…`;
+}
+//# sourceMappingURL=projectToolResult.js.map

package/dist/util/projectToolResult.js.map

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

package/package.json

@@ -1,8 +1,8 @@
 {
   "name": "agent-composer",
-  "version": "0.1.14",
+  "version": "0.2.0",
   "type": "module",
-  "description": "Multi-agent orchestration MCP server. Claude orchestrates; GLM and agy do the work.",
+  "description": "Multi-agent orchestration MCP server. Claude orchestrates; GLM, Codex, and agy do the work.",
   "bin": {
     "agent-composer": "./dist/index.js"
   },
@@ -32,6 +32,7 @@
     "test:hooks": "bash tests/hooks/run.sh",
     "test:scripts": "bash tests/scripts/run.sh",
     "test:all": "npm run test && npm run test:hooks && npm run test:scripts",
+    "eval:routes": "tsx evals/scripts/route-compare.ts",
     "usage": "npx -y ccusage daily",
     "schema:lint": "ajv compile --strict=true -c ajv-formats -s composer.config.schema.json && ajv validate --strict=false -c ajv-formats -s composer.config.schema.json -d composer.config.json && ajv compile --strict=true -s plugin.schema.json && ajv validate --strict=true -s plugin.schema.json -d 'plugin/*/plugin.json'",
     "prepublishOnly": "npm run lint && npm run test && npm run build && npm run schema:lint"

package/plugin/composer-mastermind/README.md

@@ -1,18 +1,22 @@
 # composer-mastermind
 
-> Multi-agent orchestrator plugin for Claude Code. Claude orchestrates; GLM and agy execute.
+> Multi-agent orchestrator plugin for Claude Code. Claude orchestrates; GLM, Codex, and agy execute. Claude Code CLI is available as a premium review escalation.
 
 ## What it is
 
-Composer-mastermind is a Claude Code plugin that turns the main session into a coordinator. The orchestrator never writes code, runs bash, or edits files directly — instead it dispatches work through three subagents wired to the `agent-composer` MCP server:
+Composer-mastermind is a Claude Code plugin that turns the main session into a coordinator. The orchestrator never writes code, runs bash, or edits files directly — instead it dispatches work through subagents and direct apply tools wired to the `agent-composer` MCP server:
 
 | Subagent | Tool | Role |
 |---|---|---|
-| `coder` | `mcp__composer__composer_code` | Writes code via GLM (Anthropic-compatible endpoint) |
-| `researcher` | `mcp__composer__composer_research` | Docs lookup + research via `agy` CLI (Gemini) |
+| direct | `mcp__composer__composer_handoff_create` | Writes shared context packets for multi-provider work |
+| direct | `mcp__composer__composer_code_cli` | Default coding path; CLI executor applies code directly from the MCP server root; configure as Codex or agy |
+| direct | `mcp__composer__composer_code_chain` | GLM-authored fallback; server applies complete-file blocks deterministically |
+| `coder` | `mcp__composer__composer_code` | Patch-only legacy path via GLM (Anthropic-compatible endpoint) |
+| `researcher` | `mcp__composer__composer_research` | Docs lookup + web research via Codex CLI search in read-only mode |
 | `reviewer` | `mcp__composer__composer_review` | Code review via `agy` CLI |
+| `reviewer-claude` | `mcp__composer__composer_review_claude` | Premium Claude second-opinion review for explicit/risky cases |
 
-The orchestrator's allowed-tool surface is enforced by `boundary_guard.sh` — `Edit`, `Write`, `Bash`, `NotebookEdit` are denied; only the three composer MCP tools plus `Read`/`Glob` pass.
+The orchestrator's allowed-tool surface is enforced by `boundary_guard.sh` — `Edit`, `Update`, `Write`, `Bash`, `NotebookEdit` are denied; composer MCP tools plus `Read`/`Glob` pass.
 
 ## What's inside
 
@@ -23,7 +27,8 @@ composer-mastermind/
 ├── agents/                                  # haiku-wrapped subagent defs
 │   ├── coder.md
 │   ├── researcher.md
-│   └── reviewer.md
+│   ├── reviewer.md
+│   └── reviewer-claude.md
 ├── commands/
 │   └── evolve.md                            # /evolve slash command (GEPA loop)
 └── hooks/