@adamancyzhang/claude-orchestrator 0.3.0 → 0.3.2

package/dist/executor/runner.d.ts

@@ -0,0 +1,19 @@
+export declare class ClaudeRunner {
+    private command;
+    private cacheDir;
+    private leaderInstanceId;
+    private workDir;
+    private logger;
+    private resolvedCache;
+    constructor(command: string, cacheDir: string, leaderInstanceId: string, workDir: string);
+    private dateDir;
+    ensureDir(dir: string): void;
+    taskDocPath(taskId: string): string;
+    logPath(uniqueKey: string): string;
+    resultPath(uniqueKey: string): string;
+    evalLogPath(uniqueKey: string): string;
+    evalResultPath(uniqueKey: string): string;
+    run(prompt: string, logPath: string): Promise<{
+        code: number;
+    }>;
+}

package/dist/executor/runner.js

@@ -0,0 +1,59 @@
+import * as fs from "node:fs";
+import path from "node:path";
+import { execWithTee } from "../utils/exec.js";
+import { expandHomeDir } from "../config.js";
+import { Logger } from "../utils/logger.js";
+export class ClaudeRunner {
+    command;
+    cacheDir;
+    leaderInstanceId;
+    workDir;
+    logger = new Logger("ClaudeRunner");
+    resolvedCache;
+    constructor(command, cacheDir, leaderInstanceId, workDir) {
+        this.command = command;
+        this.cacheDir = cacheDir;
+        this.leaderInstanceId = leaderInstanceId;
+        this.workDir = workDir;
+        this.resolvedCache = expandHomeDir(path.join(this.cacheDir, this.leaderInstanceId));
+    }
+    dateDir() {
+        return new Date().toISOString().slice(0, 10);
+    }
+    ensureDir(dir) {
+        fs.mkdirSync(dir, { recursive: true });
+    }
+    taskDocPath(taskId) {
+        const dir = path.join(this.resolvedCache, "tasks", this.dateDir());
+        this.ensureDir(dir);
+        return path.join(dir, `${taskId}.md`);
+    }
+    logPath(uniqueKey) {
+        const dir = path.join(this.resolvedCache, "logs", this.dateDir());
+        this.ensureDir(dir);
+        return path.join(dir, `${uniqueKey}.log`);
+    }
+    resultPath(uniqueKey) {
+        const dir = path.join(this.resolvedCache, "results", this.dateDir());
+        this.ensureDir(dir);
+        return path.join(dir, `${uniqueKey}-result.md`);
+    }
+    evalLogPath(uniqueKey) {
+        const dir = path.join(this.resolvedCache, "eval", this.dateDir());
+        this.ensureDir(dir);
+        return path.join(dir, `${uniqueKey}-eval.log`);
+    }
+    evalResultPath(uniqueKey) {
+        const dir = path.join(this.resolvedCache, "eval", this.dateDir());
+        this.ensureDir(dir);
+        return path.join(dir, `${uniqueKey}-eval-result.md`);
+    }
+    async run(prompt, logPath) {
+        if (Logger.isDebug()) {
+            this.logger.debug(`Prompt (${prompt.length} chars):\n${prompt.slice(0, 1000)}${prompt.length > 1000 ? "\n... (truncated)" : ""}`);
+            this.logger.debug(`Log: ${logPath}`);
+        }
+        return execWithTee(this.command, prompt, logPath, this.workDir);
+    }
+}
+//# sourceMappingURL=runner.js.map

package/dist/executor/runner.js.map

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

package/dist/executor/template.d.ts

@@ -0,0 +1,12 @@
+declare const LINK_TEMPLATES: string[];
+export declare class TemplateEngine {
+    private agentsDir;
+    private templates;
+    private logger;
+    constructor(agentsDir: string);
+    loadAll(): Promise<void>;
+    get(link: string): string | undefined;
+    loadFile(filename: string): Promise<string>;
+    render(template: string, vars: Record<string, string>): string;
+}
+export { LINK_TEMPLATES };

package/dist/executor/template.js

@@ -0,0 +1,42 @@
+import * as fs from "node:fs";
+import path from "node:path";
+import { Logger } from "../utils/logger.js";
+const LINK_TEMPLATES = ["plan", "build", "verify", "review", "accept", "decompose"];
+export class TemplateEngine {
+    agentsDir;
+    templates = {};
+    logger = new Logger("TemplateEngine");
+    constructor(agentsDir) {
+        this.agentsDir = agentsDir;
+    }
+    async loadAll() {
+        for (const link of LINK_TEMPLATES) {
+            try {
+                this.templates[link] = await fs.promises.readFile(path.join(this.agentsDir, `worker-${link}.md`), "utf-8");
+            }
+            catch {
+                this.templates[link] = `You are a Worker.\n\n## Task\n\n{{content}}`;
+            }
+        }
+    }
+    get(link) {
+        return this.templates[link];
+    }
+    async loadFile(filename) {
+        try {
+            return await fs.promises.readFile(path.join(this.agentsDir, filename), "utf-8");
+        }
+        catch {
+            throw new Error(`Template ${filename} not found in ${this.agentsDir}`);
+        }
+    }
+    render(template, vars) {
+        let result = template;
+        for (const [key, value] of Object.entries(vars)) {
+            result = result.replace(new RegExp(`\\{\\{${key}\\}\\}`, "g"), value);
+        }
+        return result;
+    }
+}
+export { LINK_TEMPLATES };
+//# sourceMappingURL=template.js.map

package/dist/executor/template.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"template.js","sourceRoot":"","sources":["../../src/executor/template.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,SAAS,CAAC;AAC9B,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAE5C,MAAM,cAAc,GAAG,CAAC,MAAM,EAAE,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,QAAQ,EAAE,WAAW,CAAC,CAAC;AAEpF,MAAM,OAAO,cAAc;IAIL;IAHZ,SAAS,GAA2B,EAAE,CAAC;IACvC,MAAM,GAAG,IAAI,MAAM,CAAC,gBAAgB,CAAC,CAAC;IAE9C,YAAoB,SAAiB;QAAjB,cAAS,GAAT,SAAS,CAAQ;IAAG,CAAC;IAEzC,KAAK,CAAC,OAAO;QACX,KAAK,MAAM,IAAI,IAAI,cAAc,EAAE,CAAC;YAClC,IAAI,CAAC;gBACH,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,QAAQ,CAC/C,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,UAAU,IAAI,KAAK,CAAC,EAAE,OAAO,CACxD,CAAC;YACJ,CAAC;YAAC,MAAM,CAAC;gBACP,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,GAAG,6CAA6C,CAAC;YACvE,CAAC;QACH,CAAC;IACH,CAAC;IAED,GAAG,CAAC,IAAY;QACd,OAAO,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;IAC9B,CAAC;IAED,KAAK,CAAC,QAAQ,CAAC,QAAgB;QAC7B,IAAI,CAAC;YACH,OAAO,MAAM,EAAE,CAAC,QAAQ,CAAC,QAAQ,CAC/B,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,QAAQ,CAAC,EAAE,OAAO,CAC7C,CAAC;QACJ,CAAC;QAAC,MAAM,CAAC;YACP,MAAM,IAAI,KAAK,CAAC,YAAY,QAAQ,iBAAiB,IAAI,CAAC,SAAS,EAAE,CAAC,CAAC;QACzE,CAAC;IACH,CAAC;IAED,MAAM,CAAC,QAAgB,EAAE,IAA4B;QACnD,IAAI,MAAM,GAAG,QAAQ,CAAC;QACtB,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;YAChD,MAAM,GAAG,MAAM,CAAC,OAAO,CAAC,IAAI,MAAM,CAAC,SAAS,GAAG,QAAQ,EAAE,GAAG,CAAC,EAAE,KAAK,CAAC,CAAC;QACxE,CAAC;QACD,OAAO,MAAM,CAAC;IAChB,CAAC;CACF;AAED,OAAO,EAAE,cAAc,EAAE,CAAC"}

package/dist/hooks/engine.d.ts

@@ -0,0 +1,22 @@
+export interface HookContext {
+    instanceId: string;
+    instanceName: string;
+    instanceRole: string;
+    messageId: string;
+    messageType: string;
+    messageContent: string;
+    fromInstance: string;
+    fromName: string;
+    toInstance: string;
+    workDir: string;
+    link: string | null;
+    logPath?: string;
+    exitCode?: number;
+}
+export type HookEvent = "leader_message_start" | "leader_message_end" | "worker_message_start" | "worker_message_end";
+export declare class HookEngine {
+    private hooks;
+    load(config: Partial<Record<HookEvent, string | null>>): void;
+    fire(event: HookEvent, ctx: HookContext): void;
+    get registered(): HookEvent[];
+}

package/dist/hooks/engine.js

@@ -0,0 +1,50 @@
+import { spawn } from "node:child_process";
+import { Logger } from "../utils/logger.js";
+const logger = new Logger("HookEngine");
+export class HookEngine {
+    hooks = new Map();
+    load(config) {
+        for (const [event, script] of Object.entries(config)) {
+            if (script) {
+                this.hooks.set(event, script);
+            }
+            else {
+                this.hooks.delete(event);
+            }
+        }
+    }
+    fire(event, ctx) {
+        const script = this.hooks.get(event);
+        if (!script)
+            return;
+        const env = {
+            CO_HOOK_EVENT: event,
+            CO_INSTANCE_ID: ctx.instanceId,
+            CO_INSTANCE_NAME: ctx.instanceName,
+            CO_INSTANCE_ROLE: ctx.instanceRole,
+            CO_MESSAGE_ID: ctx.messageId,
+            CO_MESSAGE_TYPE: ctx.messageType,
+            CO_MESSAGE_CONTENT: ctx.messageContent,
+            CO_FROM_INSTANCE: ctx.fromInstance,
+            CO_FROM_NAME: ctx.fromName,
+            CO_TO_INSTANCE: ctx.toInstance,
+            CO_WORK_DIR: ctx.workDir,
+            CO_LINK: ctx.link ?? "",
+            CO_LOG_PATH: ctx.logPath ?? "",
+            CO_EXIT_CODE: ctx.exitCode?.toString() ?? "",
+        };
+        const child = spawn("sh", ["-c", script], {
+            env: { ...process.env, ...env },
+            stdio: "ignore",
+            detached: true,
+        });
+        child.on("error", (err) => {
+            logger.error(`${event} hook failed`, err);
+        });
+        child.unref();
+    }
+    get registered() {
+        return Array.from(this.hooks.keys());
+    }
+}
+//# sourceMappingURL=engine.js.map

package/dist/hooks/engine.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"engine.js","sourceRoot":"","sources":["../../src/hooks/engine.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAC3C,OAAO,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAE5C,MAAM,MAAM,GAAG,IAAI,MAAM,CAAC,YAAY,CAAC,CAAC;AAoBxC,MAAM,OAAO,UAAU;IACb,KAAK,GAAG,IAAI,GAAG,EAAqB,CAAC;IAE7C,IAAI,CAAC,MAAiD;QACpD,KAAK,MAAM,CAAC,KAAK,EAAE,MAAM,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;YACrD,IAAI,MAAM,EAAE,CAAC;gBACX,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,KAAkB,EAAE,MAAM,CAAC,CAAC;YAC7C,CAAC;iBAAM,CAAC;gBACN,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,KAAkB,CAAC,CAAC;YACxC,CAAC;QACH,CAAC;IACH,CAAC;IAED,IAAI,CAAC,KAAgB,EAAE,GAAgB;QACrC,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;QACrC,IAAI,CAAC,MAAM;YAAE,OAAO;QAEpB,MAAM,GAAG,GAA2B;YAClC,aAAa,EAAE,KAAK;YACpB,cAAc,EAAE,GAAG,CAAC,UAAU;YAC9B,gBAAgB,EAAE,GAAG,CAAC,YAAY;YAClC,gBAAgB,EAAE,GAAG,CAAC,YAAY;YAClC,aAAa,EAAE,GAAG,CAAC,SAAS;YAC5B,eAAe,EAAE,GAAG,CAAC,WAAW;YAChC,kBAAkB,EAAE,GAAG,CAAC,cAAc;YACtC,gBAAgB,EAAE,GAAG,CAAC,YAAY;YAClC,YAAY,EAAE,GAAG,CAAC,QAAQ;YAC1B,cAAc,EAAE,GAAG,CAAC,UAAU;YAC9B,WAAW,EAAE,GAAG,CAAC,OAAO;YACxB,OAAO,EAAE,GAAG,CAAC,IAAI,IAAI,EAAE;YACvB,WAAW,EAAE,GAAG,CAAC,OAAO,IAAI,EAAE;YAC9B,YAAY,EAAE,GAAG,CAAC,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE;SAC7C,CAAC;QAEF,MAAM,KAAK,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC,IAAI,EAAE,MAAM,CAAC,EAAE;YACxC,GAAG,EAAE,EAAE,GAAG,OAAO,CAAC,GAAG,EAAE,GAAG,GAAG,EAAE;YAC/B,KAAK,EAAE,QAAQ;YACf,QAAQ,EAAE,IAAI;SACf,CAAC,CAAC;QAEH,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,GAAG,EAAE,EAAE;YACxB,MAAM,CAAC,KAAK,CAAC,GAAG,KAAK,cAAc,EAAE,GAAG,CAAC,CAAC;QAC5C,CAAC,CAAC,CAAC;QAEH,KAAK,CAAC,KAAK,EAAE,CAAC;IAChB,CAAC;IAED,IAAI,UAAU;QACZ,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC;IACvC,CAAC;CACF"}