@hham21/circe 0.4.0

package/dist/presets/fullstack.js

@@ -0,0 +1,118 @@
+import { Agent } from "../agent.js";
+import { QAReportSchema, hasQAPassed } from "../handoff.js";
+import { Pipeline } from "../orchestration/pipeline.js";
+import { Loop } from "../orchestration/loop.js";
+import { Contract } from "../orchestration/contract.js";
+import { PLAYWRIGHT_MCP_SERVER } from "../utils.js";
+const DEFAULT_MAX_BUILD_ROUNDS = 3;
+const DEFAULT_PASS_THRESHOLD = 7;
+const DEFAULT_CONTRACT_ROUNDS = 2;
+const DEFAULT_EVALUATION_CRITERIA = {
+    design_quality: 0.3,
+    functionality: 0.4,
+    code_quality: 0.2,
+    originality: 0.1,
+};
+function formatCriteriaDescription(criteria) {
+    return Object.entries(criteria)
+        .map(([criterion, weight]) => `${criterion} (weight ${weight})`)
+        .join(", ");
+}
+function createPlannerAgent() {
+    return new Agent({
+        name: "planner",
+        prompt: `You are a senior product designer. Given a user's app idea, expand it into a detailed product specification.
+
+Output a JSON object with this structure:
+{
+  "appName": "kebab-case-name",
+  "features": [{"name": "...", "description": "..."}],
+  "techStack": {"frontend": "React + Vite", "backend": "FastAPI", "database": "SQLite"},
+  "designDirection": "..."
+}
+
+Be ambitious — include 10-15 features. Think about AI integration opportunities.
+The tech stack is always: React + Vite (port 5173) frontend, FastAPI (port 8000) backend, SQLite database.`,
+    });
+}
+function createContractProposerAgent() {
+    return new Agent({
+        name: "contract-proposer",
+        prompt: `You are a senior full-stack engineer. Given a product spec, propose a detailed build contract.
+Include: feature implementation order, testable acceptance criteria for each feature, architecture decisions.
+Output as a structured proposal that a reviewer can evaluate.`,
+    });
+}
+function createContractReviewerAgent() {
+    return new Agent({
+        name: "contract-reviewer",
+        prompt: `You are a senior QA engineer reviewing a build contract.
+Check that every feature has testable acceptance criteria.
+Check that the architecture is sound.
+Output JSON: {"accepted": true/false, "feedback": "..."}`,
+    });
+}
+function createGeneratorAgent() {
+    return new Agent({
+        name: "generator",
+        prompt: `You are a senior full-stack engineer. Build the application according to the spec.
+
+Tech stack: React + Vite (port 5173), FastAPI (port 8000), SQLite.
+
+If this is the first round, you receive a ProductSpec — build from scratch.
+If this is a subsequent round, you receive a QAReport with feedback — fix the issues.
+
+Always:
+- Create all files in the current working directory
+- Start dev servers (Vite on 5173, FastAPI on 8000)
+- Write progress to _status.md
+- Use relative paths only`,
+        continueSession: true,
+    });
+}
+function createEvaluatorAgent(criteriaDescription, passThreshold) {
+    return new Agent({
+        name: "evaluator",
+        prompt: `You are a strict QA engineer. Test the running application thoroughly.
+
+The app should be running at http://localhost:5173 (frontend) and http://localhost:8000 (backend).
+
+Test by:
+1. Making API calls with curl/fetch
+2. Using Playwright MCP to navigate and interact with the UI
+3. Checking for errors in console and network
+
+Score each criterion (1-10): ${criteriaDescription}
+Fail if ANY criterion is below ${passThreshold}/10.
+
+Output JSON:
+{
+  "passed": true/false,
+  "scores": {"criterion": score, ...},
+  "feedback": ["specific issue 1", "specific issue 2"]
+}`,
+        tools: ["Read", "Bash", "Glob", "Grep"],
+        mcpServers: {
+            playwright: PLAYWRIGHT_MCP_SERVER,
+        },
+        outputSchema: QAReportSchema,
+    });
+}
+export function fullstackApp(options) {
+    const maxRounds = options?.maxRounds ?? DEFAULT_MAX_BUILD_ROUNDS;
+    const passThreshold = options?.passThreshold ?? DEFAULT_PASS_THRESHOLD;
+    const criteria = options?.evaluatorCriteria ?? DEFAULT_EVALUATION_CRITERIA;
+    const criteriaDescription = formatCriteriaDescription(criteria);
+    const contractProposer = createContractProposerAgent();
+    const contractReviewer = createContractReviewerAgent();
+    const evaluator = createEvaluatorAgent(criteriaDescription, passThreshold);
+    const contract = new Contract(contractProposer, contractReviewer, {
+        maxRounds: DEFAULT_CONTRACT_ROUNDS,
+    });
+    const buildLoop = new Loop(createGeneratorAgent(), evaluator, {
+        maxRounds,
+        stopWhen: hasQAPassed,
+    });
+    return new Pipeline(createPlannerAgent(), contract, buildLoop);
+}
+//# sourceMappingURL=fullstack.js.map

package/dist/presets/fullstack.js.map

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

package/dist/presets/index.d.ts

@@ -0,0 +1,2 @@
+export { fullstackApp } from "./fullstack.js";
+export { frontendDesign } from "./frontend.js";

package/dist/presets/index.js

@@ -0,0 +1,3 @@
+export { fullstackApp } from "./fullstack.js";
+export { frontendDesign } from "./frontend.js";
+//# sourceMappingURL=index.js.map

package/dist/presets/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/presets/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC"}

package/dist/session/index.d.ts

@@ -0,0 +1 @@
+export { SessionManager, type Session } from "./manager.js";

package/dist/session/index.js

@@ -0,0 +1,2 @@
+export { SessionManager } from "./manager.js";
+//# sourceMappingURL=index.js.map

package/dist/session/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/session/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAgB,MAAM,cAAc,CAAC"}

package/dist/session/manager.d.ts

@@ -0,0 +1,17 @@
+export interface Session {
+    id: string;
+    workflow: string;
+    input: string;
+    status: string;
+    createdAt: string;
+    updatedAt: string;
+}
+export declare class SessionManager {
+    private dir;
+    constructor(baseDir: string);
+    create(workflow: string, input: string): Session;
+    list(): Session[];
+    get(sessionId: string): Session;
+    updateStatus(sessionId: string, status: string): void;
+    private save;
+}

package/dist/session/manager.js

@@ -0,0 +1,50 @@
+import { existsSync, mkdirSync, readFileSync, readdirSync, writeFileSync } from "node:fs";
+import { join } from "node:path";
+import { randomUUID } from "node:crypto";
+export class SessionManager {
+    dir;
+    constructor(baseDir) {
+        this.dir = join(baseDir, "sessions");
+        if (!existsSync(this.dir)) {
+            mkdirSync(this.dir, { recursive: true });
+        }
+    }
+    create(workflow, input) {
+        const now = new Date().toISOString();
+        const session = {
+            id: randomUUID().slice(0, 8),
+            workflow,
+            input,
+            status: "running",
+            createdAt: now,
+            updatedAt: now,
+        };
+        this.save(session);
+        return session;
+    }
+    list() {
+        if (!existsSync(this.dir))
+            return [];
+        const files = readdirSync(this.dir).filter((f) => f.endsWith(".json"));
+        return files
+            .map((f) => JSON.parse(readFileSync(join(this.dir, f), "utf-8")))
+            .sort((a, b) => b.createdAt.localeCompare(a.createdAt));
+    }
+    get(sessionId) {
+        const path = join(this.dir, `${sessionId}.json`);
+        if (!existsSync(path)) {
+            throw new Error(`Session not found: ${sessionId}`);
+        }
+        return JSON.parse(readFileSync(path, "utf-8"));
+    }
+    updateStatus(sessionId, status) {
+        const session = this.get(sessionId);
+        session.status = status;
+        session.updatedAt = new Date().toISOString();
+        this.save(session);
+    }
+    save(session) {
+        writeFileSync(join(this.dir, `${session.id}.json`), JSON.stringify(session, null, 2));
+    }
+}
+//# sourceMappingURL=manager.js.map

package/dist/session/manager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"manager.js","sourceRoot":"","sources":["../../src/session/manager.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,YAAY,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAC1F,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAWzC,MAAM,OAAO,cAAc;IACjB,GAAG,CAAS;IAEpB,YAAY,OAAe;QACzB,IAAI,CAAC,GAAG,GAAG,IAAI,CAAC,OAAO,EAAE,UAAU,CAAC,CAAC;QACrC,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;YAC1B,SAAS,CAAC,IAAI,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAC3C,CAAC;IACH,CAAC;IAED,MAAM,CAAC,QAAgB,EAAE,KAAa;QACpC,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;QACrC,MAAM,OAAO,GAAY;YACvB,EAAE,EAAE,UAAU,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC;YAC5B,QAAQ;YACR,KAAK;YACL,MAAM,EAAE,SAAS;YACjB,SAAS,EAAE,GAAG;YACd,SAAS,EAAE,GAAG;SACf,CAAC;QACF,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACnB,OAAO,OAAO,CAAC;IACjB,CAAC;IAED,IAAI;QACF,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,GAAG,CAAC;YAAE,OAAO,EAAE,CAAC;QACrC,MAAM,KAAK,GAAG,WAAW,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC;QACvE,OAAO,KAAK;aACT,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC,EAAE,OAAO,CAAC,CAAY,CAAC;aAC3E,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,aAAa,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC;IAC5D,CAAC;IAED,GAAG,CAAC,SAAiB;QACnB,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS,OAAO,CAAC,CAAC;QACjD,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;YACtB,MAAM,IAAI,KAAK,CAAC,sBAAsB,SAAS,EAAE,CAAC,CAAC;QACrD,CAAC;QACD,OAAO,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC;IACjD,CAAC;IAED,YAAY,CAAC,SAAiB,EAAE,MAAc;QAC5C,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;QACpC,OAAO,CAAC,MAAM,GAAG,MAAM,CAAC;QACxB,OAAO,CAAC,SAAS,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;QAC7C,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IACrB,CAAC;IAEO,IAAI,CAAC,OAAgB;QAC3B,aAAa,CACX,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,OAAO,CAAC,EAAE,OAAO,CAAC,EACpC,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,CACjC,CAAC;IACJ,CAAC;CACF"}

package/dist/tools/custom.d.ts

@@ -0,0 +1,5 @@
+export interface CirceToolFn extends Function {
+    _circeTool: boolean;
+    _circeToolName: string;
+}
+export declare function tool<T extends (...args: any[]) => any>(fn: T): T & CirceToolFn;

package/dist/tools/custom.js

@@ -0,0 +1,7 @@
+export function tool(fn) {
+    const wrapper = ((...args) => fn(...args));
+    wrapper._circeTool = true;
+    wrapper._circeToolName = fn.name;
+    return wrapper;
+}
+//# sourceMappingURL=custom.js.map

package/dist/tools/custom.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"custom.js","sourceRoot":"","sources":["../../src/tools/custom.ts"],"names":[],"mappings":"AAKA,MAAM,UAAU,IAAI,CAAoC,EAAK;IAC3D,MAAM,OAAO,GAAG,CAAC,CAAC,GAAG,IAAW,EAAE,EAAE,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,CAAoB,CAAC;IACrE,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC;IAC1B,OAAO,CAAC,cAAc,GAAG,EAAE,CAAC,IAAI,CAAC;IACjC,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/dist/tools/index.d.ts

@@ -0,0 +1 @@
+export { SkillRegistry, type SkillInfo } from "./skills.js";

package/dist/tools/index.js

@@ -0,0 +1,2 @@
+export { SkillRegistry } from "./skills.js";
+//# sourceMappingURL=index.js.map

package/dist/tools/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAkB,MAAM,aAAa,CAAC"}

package/dist/tools/skills.d.ts

@@ -0,0 +1,18 @@
+export interface SkillInfo {
+    name: string;
+    description: string;
+    source: string;
+}
+export declare class SkillRegistry {
+    private dirs;
+    constructor(dirs: string[]);
+    listSkills(): SkillInfo[];
+    getSkillInfo(name: string): SkillInfo | null;
+    getSkill(name: string): string | null;
+    validateSkills(names: string[]): void;
+    promptSummary(names: string[]): string;
+    private collectSkillsFromDir;
+    private buildSkillFilePath;
+    private readSkillInfoFromDir;
+    private parseFrontmatter;
+}

package/dist/tools/skills.js

@@ -0,0 +1,99 @@
+import { readdirSync, readFileSync, existsSync } from "node:fs";
+import { join } from "node:path";
+const SKILL_FILENAME = "SKILL.md";
+export class SkillRegistry {
+    dirs;
+    constructor(dirs) {
+        this.dirs = dirs;
+    }
+    listSkills() {
+        const visitedNames = new Set();
+        const skills = [];
+        for (const dir of this.dirs) {
+            this.collectSkillsFromDir(dir, visitedNames, skills);
+        }
+        return skills;
+    }
+    getSkillInfo(name) {
+        for (const dir of this.dirs) {
+            const skill = this.readSkillInfoFromDir(dir, name);
+            if (skill)
+                return skill;
+        }
+        return null;
+    }
+    getSkill(name) {
+        for (const dir of this.dirs) {
+            const skillFilePath = this.buildSkillFilePath(dir, name);
+            if (!existsSync(skillFilePath))
+                continue;
+            return readFileSync(skillFilePath, "utf-8");
+        }
+        return null;
+    }
+    validateSkills(names) {
+        const missingSkills = names.filter((name) => this.getSkillInfo(name) === null);
+        if (missingSkills.length > 0) {
+            throw new Error(`Required skill(s) not found: ${missingSkills.join(", ")}`);
+        }
+    }
+    promptSummary(names) {
+        const summaryLines = names
+            .map((name) => this.getSkillInfo(name))
+            .filter((info) => info !== null)
+            .map((info) => `- ${info.name}: ${info.description}`);
+        if (summaryLines.length === 0)
+            return "";
+        return `Available skills (call mcp__circe-skills__use_skill to load full methodology):\n${summaryLines.join("\n")}`;
+    }
+    collectSkillsFromDir(dir, visitedNames, skills) {
+        if (!existsSync(dir))
+            return;
+        const entries = readdirSync(dir, { withFileTypes: true });
+        for (const entry of entries) {
+            if (!entry.isDirectory())
+                continue;
+            if (visitedNames.has(entry.name))
+                continue;
+            const skill = this.readSkillInfoFromDir(dir, entry.name);
+            if (skill) {
+                visitedNames.add(entry.name);
+                skills.push(skill);
+            }
+        }
+    }
+    buildSkillFilePath(dir, skillName) {
+        return join(dir, skillName, SKILL_FILENAME);
+    }
+    readSkillInfoFromDir(dir, skillName) {
+        const skillFilePath = this.buildSkillFilePath(dir, skillName);
+        if (!existsSync(skillFilePath))
+            return null;
+        const content = readFileSync(skillFilePath, "utf-8");
+        const frontmatter = this.parseFrontmatter(content);
+        if (!frontmatter.name)
+            return null;
+        return {
+            name: frontmatter.name,
+            description: frontmatter.description ?? "",
+            source: dir,
+        };
+    }
+    parseFrontmatter(text) {
+        const match = text.match(/^---\s*\n([\s\S]*?)\n---/);
+        if (!match)
+            return {};
+        const frontmatterBody = match[1];
+        const result = {};
+        for (const line of frontmatterBody.split("\n")) {
+            const colonIndex = line.indexOf(":");
+            if (colonIndex === -1)
+                continue;
+            const key = line.slice(0, colonIndex).trim();
+            const value = line.slice(colonIndex + 1).trim();
+            result[key] = value;
+        }
+        return result;
+    }
+}
+//# sourceMappingURL=skills.js.map

package/dist/tools/skills.js.map

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

package/dist/types.d.ts

@@ -0,0 +1,36 @@
+import { z } from "zod";
+export type MetricsSnapshot = {
+    cost: number;
+    inputTokens: number;
+    outputTokens: number;
+};
+export interface Runnable<TIn = unknown, TOut = unknown> {
+    name?: string;
+    lastMetrics?: MetricsSnapshot | null;
+    run(input: TIn): Promise<TOut>;
+}
+export declare const RunContextSchema: z.ZodObject<{
+    workDir: z.ZodString;
+    sessionId: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+    model: z.ZodDefault<z.ZodString>;
+    verbose: z.ZodDefault<z.ZodBoolean>;
+}, "strip", z.ZodTypeAny, {
+    workDir: string;
+    sessionId: string | null;
+    model: string;
+    verbose: boolean;
+}, {
+    workDir: string;
+    sessionId?: string | null | undefined;
+    model?: string | undefined;
+    verbose?: boolean | undefined;
+}>;
+export type RunContext = z.infer<typeof RunContextSchema>;
+export declare const RunContext: {
+    parse: (data: unknown) => {
+        workDir: string;
+        sessionId: string | null;
+        model: string;
+        verbose: boolean;
+    };
+};

package/dist/types.js

@@ -0,0 +1,12 @@
+import { z } from "zod";
+const DEFAULT_MODEL = "claude-opus-4-6";
+export const RunContextSchema = z.object({
+    workDir: z.string(),
+    sessionId: z.string().nullable().default(null),
+    model: z.string().default(DEFAULT_MODEL),
+    verbose: z.boolean().default(false),
+});
+export const RunContext = {
+    parse: (data) => RunContextSchema.parse(data),
+};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAUxB,MAAM,aAAa,GAAG,iBAAiB,CAAC;AAExC,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,CAAC,MAAM,CAAC;IACvC,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE;IACnB,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC;IAC9C,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC,aAAa,CAAC;IACxC,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC;CACpC,CAAC,CAAC;AAIH,MAAM,CAAC,MAAM,UAAU,GAAG;IACxB,KAAK,EAAE,CAAC,IAAa,EAAE,EAAE,CAAC,gBAAgB,CAAC,KAAK,CAAC,IAAI,CAAC;CACvD,CAAC"}

package/dist/utils.d.ts

@@ -0,0 +1,24 @@
+import type { Runnable } from "./types.js";
+export declare function circeHome(): string;
+export declare const PLAYWRIGHT_MCP_SERVER: {
+    readonly command: "npx";
+    readonly args: readonly ["@playwright/mcp@latest"];
+};
+/**
+ * Extract the first JSON string from text.
+ * Checks for fenced code blocks first, then bare JSON objects.
+ * Returns the raw JSON string (not parsed).
+ */
+export declare function findJsonString(text: string): string | null;
+/**
+ * Parse a variadic constructor signature where the last arg may be an options object.
+ * Used by Pipeline, Parallel, and Loop.
+ */
+export declare function parseTrailingOptions<T>(args: any[]): {
+    agents: Runnable[];
+    options: T;
+};
+import type { MetricsSnapshot } from "./types.js";
+export type MetricsAccumulator = MetricsSnapshot;
+export declare function createMetrics(): MetricsAccumulator;
+export declare function accumulateMetrics(acc: MetricsAccumulator, metrics: MetricsSnapshot | null | undefined): void;

package/dist/utils.js

@@ -0,0 +1,85 @@
+import { join } from "node:path";
+export function circeHome() {
+    return process.env.CIRCE_HOME ?? join(process.env.HOME, ".circe");
+}
+export const PLAYWRIGHT_MCP_SERVER = { command: "npx", args: ["@playwright/mcp@latest"] };
+const FENCED_CODE_BLOCK_PATTERN = /```(?:json)?\s*\n([\s\S]*?)\n```/;
+/**
+ * Extract the first JSON string from text.
+ * Checks for fenced code blocks first, then bare JSON objects.
+ * Returns the raw JSON string (not parsed).
+ */
+export function findJsonString(text) {
+    const codeBlockMatch = text.match(FENCED_CODE_BLOCK_PATTERN);
+    if (codeBlockMatch) {
+        return codeBlockMatch[1].trim();
+    }
+    const start = text.indexOf("{");
+    if (start !== -1) {
+        const extracted = extractBalancedBraces(text, start);
+        if (extracted)
+            return extracted;
+    }
+    return null;
+}
+function extractBalancedBraces(text, start) {
+    let depth = 0;
+    let inString = false;
+    let escape = false;
+    for (let i = start; i < text.length; i++) {
+        const char = text[i];
+        if (escape) {
+            escape = false;
+            continue;
+        }
+        if (char === "\\") {
+            escape = true;
+            continue;
+        }
+        if (char === '"') {
+            inString = !inString;
+            continue;
+        }
+        if (inString)
+            continue;
+        if (char === "{")
+            depth++;
+        if (char === "}") {
+            depth--;
+            if (depth === 0)
+                return text.slice(start, i + 1);
+        }
+    }
+    return null;
+}
+/**
+ * Parse a variadic constructor signature where the last arg may be an options object.
+ * Used by Pipeline, Parallel, and Loop.
+ */
+export function parseTrailingOptions(args) {
+    if (args.length === 0) {
+        return { agents: [], options: {} };
+    }
+    const last = args[args.length - 1];
+    if (last && !isRunnable(last)) {
+        return {
+            agents: args.slice(0, -1),
+            options: last,
+        };
+    }
+    return { agents: args, options: {} };
+}
+function isRunnable(value) {
+    return value != null && typeof value === "object" && "run" in value;
+}
+export function createMetrics() {
+    return { cost: 0, inputTokens: 0, outputTokens: 0 };
+}
+export function accumulateMetrics(acc, metrics) {
+    if (!metrics)
+        return;
+    acc.cost += metrics.cost;
+    acc.inputTokens += metrics.inputTokens;
+    acc.outputTokens += metrics.outputTokens;
+}
+//# sourceMappingURL=utils.js.map

package/dist/utils.js.map

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

package/package.json

@@ -0,0 +1,49 @@
+{
+  "name": "@hham21/circe",
+  "version": "0.4.0",
+  "description": "GAN-style multi-agent framework for application generation using Claude Agent SDK",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "bin": {
+    "circe": "dist/cli/index.js"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/hham21/circe.git"
+  },
+  "keywords": [
+    "claude",
+    "agent",
+    "multi-agent",
+    "gan",
+    "orchestration",
+    "ai",
+    "anthropic"
+  ],
+  "license": "MIT",
+  "homepage": "https://github.com/hham21/circe#readme",
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "lint": "tsc --noEmit",
+    "lint:examples": "tsc -p tsconfig.examples.json"
+  },
+  "dependencies": {
+    "@anthropic-ai/claude-agent-sdk": "^0.1.0",
+    "chalk": "^5.4.0",
+    "commander": "^13.0.0",
+    "zod": "^3.23.0",
+    "zod-to-json-schema": "^3.25.2"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "typescript": "^5.7.0",
+    "vitest": "^3.0.0"
+  },
+  "engines": {
+    "node": ">=22.0.0"
+  }
+}