@adamancyzhang/claude-orchestrator 0.1.0 → 0.2.1

package/dist/models/schemas.d.ts

@@ -0,0 +1,308 @@
+import { z } from "zod";
+export declare const InstanceStatus: z.ZodEnum<["idle", "busy", "blocked"]>;
+export type InstanceStatus = z.infer<typeof InstanceStatus>;
+export declare const InstanceRole: z.ZodEnum<["architect", "developer", "tester", "general"]>;
+export type InstanceRole = z.infer<typeof InstanceRole>;
+export declare const TaskStatus: z.ZodEnum<["pending", "claimed", "completed"]>;
+export type TaskStatus = z.infer<typeof TaskStatus>;
+export declare const TaskPriority: z.ZodNumber;
+export type TaskPriority = z.infer<typeof TaskPriority>;
+export declare const TaskPriorityName: Record<number, string>;
+export declare const MessageType: z.ZodEnum<["direct", "broadcast", "help"]>;
+export type MessageType = z.infer<typeof MessageType>;
+export declare const InstanceSchema: z.ZodObject<{
+    id: z.ZodString;
+    name: z.ZodString;
+    role: z.ZodDefault<z.ZodEnum<["architect", "developer", "tester", "general"]>>;
+    status: z.ZodDefault<z.ZodEnum<["idle", "busy", "blocked"]>>;
+    current_task_id: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+    connected_since: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    status: "idle" | "busy" | "blocked";
+    id: string;
+    name: string;
+    role: "architect" | "developer" | "tester" | "general";
+    current_task_id: string | null;
+    connected_since: string;
+}, {
+    id: string;
+    name: string;
+    connected_since: string;
+    status?: "idle" | "busy" | "blocked" | undefined;
+    role?: "architect" | "developer" | "tester" | "general" | undefined;
+    current_task_id?: string | null | undefined;
+}>;
+export type Instance = z.infer<typeof InstanceSchema>;
+export declare const TaskSchema: z.ZodObject<{
+    id: z.ZodDefault<z.ZodString>;
+    title: z.ZodString;
+    description: z.ZodDefault<z.ZodString>;
+    priority: z.ZodDefault<z.ZodNumber>;
+    status: z.ZodDefault<z.ZodEnum<["pending", "claimed", "completed"]>>;
+    created_by: z.ZodDefault<z.ZodString>;
+    assigned_to: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+    created_at: z.ZodString;
+    claimed_at: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+    completed_at: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+    claimed_by: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+    result: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+}, "strip", z.ZodTypeAny, {
+    status: "pending" | "claimed" | "completed";
+    id: string;
+    title: string;
+    description: string;
+    priority: number;
+    created_by: string;
+    assigned_to: string | null;
+    created_at: string;
+    claimed_at: string | null;
+    completed_at: string | null;
+    claimed_by: string | null;
+    result: string | null;
+}, {
+    title: string;
+    created_at: string;
+    status?: "pending" | "claimed" | "completed" | undefined;
+    id?: string | undefined;
+    description?: string | undefined;
+    priority?: number | undefined;
+    created_by?: string | undefined;
+    assigned_to?: string | null | undefined;
+    claimed_at?: string | null | undefined;
+    completed_at?: string | null | undefined;
+    claimed_by?: string | null | undefined;
+    result?: string | null | undefined;
+}>;
+export type Task = z.infer<typeof TaskSchema>;
+export declare const MessageSchema: z.ZodObject<{
+    id: z.ZodDefault<z.ZodString>;
+    type: z.ZodDefault<z.ZodEnum<["direct", "broadcast", "help"]>>;
+    from_instance: z.ZodDefault<z.ZodString>;
+    from_name: z.ZodDefault<z.ZodString>;
+    to_instance: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+    content: z.ZodString;
+    created_at: z.ZodString;
+    read: z.ZodDefault<z.ZodBoolean>;
+}, "strip", z.ZodTypeAny, {
+    type: "direct" | "broadcast" | "help";
+    id: string;
+    created_at: string;
+    from_instance: string;
+    from_name: string;
+    to_instance: string | null;
+    content: string;
+    read: boolean;
+}, {
+    created_at: string;
+    content: string;
+    type?: "direct" | "broadcast" | "help" | undefined;
+    id?: string | undefined;
+    from_instance?: string | undefined;
+    from_name?: string | undefined;
+    to_instance?: string | null | undefined;
+    read?: boolean | undefined;
+}>;
+export type Message = z.infer<typeof MessageSchema>;
+export declare const ContextEntrySchema: z.ZodObject<{
+    key: z.ZodString;
+    value: z.ZodString;
+    updated_by: z.ZodDefault<z.ZodString>;
+    updated_at: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    value: string;
+    key: string;
+    updated_by: string;
+    updated_at: string;
+}, {
+    value: string;
+    key: string;
+    updated_at: string;
+    updated_by?: string | undefined;
+}>;
+export type ContextEntry = z.infer<typeof ContextEntrySchema>;
+export declare function createInstance(overrides: {
+    id?: string;
+    name: string;
+    role?: InstanceRole;
+}): Instance;
+export declare function createTask(overrides: {
+    title: string;
+    description?: string;
+    priority?: number;
+    created_by?: string;
+    assigned_to?: string | null;
+}): Task;
+export declare function createMessage(overrides: {
+    type?: MessageType;
+    from_instance: string;
+    from_name: string;
+    to_instance: string;
+    content: string;
+}): Message;
+export declare function createContextEntry(overrides: {
+    key: string;
+    value: string;
+    updated_by?: string;
+}): ContextEntry;
+export declare const RegisterInstanceInput: z.ZodObject<{
+    name: z.ZodString;
+    role: z.ZodDefault<z.ZodEnum<["architect", "developer", "tester", "general"]>>;
+    instance_id: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    name: string;
+    role: "architect" | "developer" | "tester" | "general";
+    instance_id?: string | undefined;
+}, {
+    name: string;
+    role?: "architect" | "developer" | "tester" | "general" | undefined;
+    instance_id?: string | undefined;
+}>;
+export declare const HeartbeatInput: z.ZodObject<{
+    instance_id: z.ZodString;
+    current_task: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    instance_id: string;
+    current_task?: string | undefined;
+}, {
+    instance_id: string;
+    current_task?: string | undefined;
+}>;
+export declare const PushTaskInput: z.ZodObject<{
+    title: z.ZodString;
+    description: z.ZodDefault<z.ZodString>;
+    priority: z.ZodDefault<z.ZodNumber>;
+    instance_id: z.ZodDefault<z.ZodString>;
+    assignee: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    title: string;
+    description: string;
+    priority: number;
+    instance_id: string;
+    assignee?: string | undefined;
+}, {
+    title: string;
+    description?: string | undefined;
+    priority?: number | undefined;
+    instance_id?: string | undefined;
+    assignee?: string | undefined;
+}>;
+export declare const ClaimTaskInput: z.ZodObject<{
+    instance_id: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    instance_id: string;
+}, {
+    instance_id: string;
+}>;
+export declare const CompleteTaskInput: z.ZodObject<{
+    instance_id: z.ZodString;
+    task_id: z.ZodString;
+    result: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    result: string;
+    instance_id: string;
+    task_id: string;
+}, {
+    result: string;
+    instance_id: string;
+    task_id: string;
+}>;
+export declare const ListTasksInput: z.ZodObject<{
+    status: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    status?: string | undefined;
+}, {
+    status?: string | undefined;
+}>;
+export declare const SendMessageInput: z.ZodObject<{
+    instance_id: z.ZodString;
+    content: z.ZodString;
+    to_instance: z.ZodOptional<z.ZodString>;
+    broadcast: z.ZodDefault<z.ZodBoolean>;
+}, "strip", z.ZodTypeAny, {
+    broadcast: boolean;
+    content: string;
+    instance_id: string;
+    to_instance?: string | undefined;
+}, {
+    content: string;
+    instance_id: string;
+    broadcast?: boolean | undefined;
+    to_instance?: string | undefined;
+}>;
+export declare const PollMessagesInput: z.ZodObject<{
+    instance_id: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    instance_id: string;
+}, {
+    instance_id: string;
+}>;
+export declare const WaitForMessageInput: z.ZodObject<{
+    instance_id: z.ZodString;
+    timeout_seconds: z.ZodDefault<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    instance_id: string;
+    timeout_seconds: number;
+}, {
+    instance_id: string;
+    timeout_seconds?: number | undefined;
+}>;
+export declare const MarkReadInput: z.ZodObject<{
+    instance_id: z.ZodString;
+    message_id: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    instance_id: string;
+    message_id: string;
+}, {
+    instance_id: string;
+    message_id: string;
+}>;
+export declare const DismissMessageInput: z.ZodObject<{
+    instance_id: z.ZodString;
+    message_id: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    instance_id: string;
+    message_id: string;
+}, {
+    instance_id: string;
+    message_id: string;
+}>;
+export declare const RequestHelpInput: z.ZodObject<{
+    instance_id: z.ZodString;
+    question: z.ZodString;
+    context: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    instance_id: string;
+    question: string;
+    context?: string | undefined;
+}, {
+    instance_id: string;
+    question: string;
+    context?: string | undefined;
+}>;
+export declare const SetContextInput: z.ZodObject<{
+    key: z.ZodString;
+    value: z.ZodString;
+    instance_id: z.ZodDefault<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    value: string;
+    key: string;
+    instance_id: string;
+}, {
+    value: string;
+    key: string;
+    instance_id?: string | undefined;
+}>;
+export declare const GetContextInput: z.ZodObject<{
+    key: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    key: string;
+}, {
+    key: string;
+}>;
+export declare const DeleteContextInput: z.ZodObject<{
+    key: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    key: string;
+}, {
+    key: string;
+}>;

package/dist/models/schemas.js

@@ -0,0 +1,167 @@
+import { z } from "zod";
+// ── Enums ──
+export const InstanceStatus = z.enum(["idle", "busy", "blocked"]);
+export const InstanceRole = z.enum(["architect", "developer", "tester", "general"]);
+export const TaskStatus = z.enum(["pending", "claimed", "completed"]);
+export const TaskPriority = z.number().int().min(0).max(2);
+export const TaskPriorityName = {
+    0: "HIGH",
+    1: "MEDIUM",
+    2: "LOW",
+};
+export const MessageType = z.enum(["direct", "broadcast", "help"]);
+// ── Data Models ──
+function utcNow() {
+    return new Date().toISOString();
+}
+export const InstanceSchema = z.object({
+    id: z.string(),
+    name: z.string(),
+    role: InstanceRole.default("general"),
+    status: InstanceStatus.default("idle"),
+    current_task_id: z.string().nullable().default(null),
+    connected_since: z.string(),
+});
+export const TaskSchema = z.object({
+    id: z.string().default(""),
+    title: z.string(),
+    description: z.string().default(""),
+    priority: TaskPriority.default(1),
+    status: TaskStatus.default("pending"),
+    created_by: z.string().default(""),
+    assigned_to: z.string().nullable().default(null),
+    created_at: z.string(),
+    claimed_at: z.string().nullable().default(null),
+    completed_at: z.string().nullable().default(null),
+    claimed_by: z.string().nullable().default(null),
+    result: z.string().nullable().default(null),
+});
+export const MessageSchema = z.object({
+    id: z.string().default(""),
+    type: MessageType.default("direct"),
+    from_instance: z.string().default(""),
+    from_name: z.string().default(""),
+    to_instance: z.string().nullable().default(null),
+    content: z.string(),
+    created_at: z.string(),
+    read: z.boolean().default(false),
+});
+export const ContextEntrySchema = z.object({
+    key: z.string(),
+    value: z.string(),
+    updated_by: z.string().default(""),
+    updated_at: z.string(),
+});
+// ── Factory helpers (mirrors Python Field(default_factory=...)) ──
+export function createInstance(overrides) {
+    return InstanceSchema.parse({
+        id: overrides.id ?? crypto.randomUUID().replace(/-/g, ""),
+        name: overrides.name,
+        role: overrides.role ?? "general",
+        status: "idle",
+        current_task_id: null,
+        connected_since: utcNow(),
+    });
+}
+export function createTask(overrides) {
+    return TaskSchema.parse({
+        id: "",
+        title: overrides.title,
+        description: overrides.description ?? "",
+        priority: overrides.priority ?? 1,
+        status: "pending",
+        created_by: overrides.created_by ?? "",
+        assigned_to: overrides.assigned_to ?? null,
+        created_at: utcNow(),
+        claimed_at: null,
+        completed_at: null,
+        claimed_by: null,
+        result: null,
+    });
+}
+export function createMessage(overrides) {
+    return MessageSchema.parse({
+        id: "",
+        type: overrides.type ?? "direct",
+        from_instance: overrides.from_instance,
+        from_name: overrides.from_name,
+        to_instance: overrides.to_instance,
+        content: overrides.content,
+        created_at: utcNow(),
+        read: false,
+    });
+}
+export function createContextEntry(overrides) {
+    return ContextEntrySchema.parse({
+        key: overrides.key,
+        value: overrides.value,
+        updated_by: overrides.updated_by ?? "",
+        updated_at: utcNow(),
+    });
+}
+// ── Tool input schemas ──
+export const RegisterInstanceInput = z.object({
+    name: z.string().min(1),
+    role: InstanceRole.default("general"),
+    instance_id: z.string().optional(),
+});
+export const HeartbeatInput = z.object({
+    instance_id: z.string(),
+    current_task: z.string().optional(),
+});
+export const PushTaskInput = z.object({
+    title: z.string().min(1),
+    description: z.string().default(""),
+    priority: TaskPriority.default(1),
+    instance_id: z.string().default(""),
+    assignee: z.string().optional(),
+});
+export const ClaimTaskInput = z.object({
+    instance_id: z.string(),
+});
+export const CompleteTaskInput = z.object({
+    instance_id: z.string(),
+    task_id: z.string(),
+    result: z.string(),
+});
+export const ListTasksInput = z.object({
+    status: z.string().optional(),
+});
+export const SendMessageInput = z.object({
+    instance_id: z.string(),
+    content: z.string().min(1),
+    to_instance: z.string().optional(),
+    broadcast: z.boolean().default(false),
+});
+export const PollMessagesInput = z.object({
+    instance_id: z.string(),
+});
+export const WaitForMessageInput = z.object({
+    instance_id: z.string(),
+    timeout_seconds: z.number().int().min(1).default(30),
+});
+export const MarkReadInput = z.object({
+    instance_id: z.string(),
+    message_id: z.string(),
+});
+export const DismissMessageInput = z.object({
+    instance_id: z.string(),
+    message_id: z.string(),
+});
+export const RequestHelpInput = z.object({
+    instance_id: z.string(),
+    question: z.string().min(1),
+    context: z.string().optional(),
+});
+export const SetContextInput = z.object({
+    key: z.string().min(1),
+    value: z.string(),
+    instance_id: z.string().default(""),
+});
+export const GetContextInput = z.object({
+    key: z.string(),
+});
+export const DeleteContextInput = z.object({
+    key: z.string(),
+});
+//# sourceMappingURL=schemas.js.map

package/dist/models/schemas.js.map

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

package/dist/modules/context-store.d.ts

@@ -0,0 +1,10 @@
+import { ZkClient } from "../zk/client.js";
+import { type ContextEntry } from "../models/schemas.js";
+export declare class ContextStore {
+    private zk;
+    constructor(zk: ZkClient);
+    set(key: string, value: string, updatedBy?: string): Promise<ContextEntry>;
+    get(key: string): Promise<string | null>;
+    delete(key: string): Promise<void>;
+    listKeys(): Promise<string[]>;
+}

package/dist/modules/context-store.js

@@ -0,0 +1,25 @@
+import { createContextEntry, } from "../models/schemas.js";
+export class ContextStore {
+    zk;
+    constructor(zk) {
+        this.zk = zk;
+    }
+    async set(key, value, updatedBy = "") {
+        const entry = createContextEntry({ key, value, updated_by: updatedBy });
+        await this.zk.setContext(key, entry);
+        return entry;
+    }
+    async get(key) {
+        const data = await this.zk.getContext(key);
+        if (!data)
+            return null;
+        return data.value ?? null;
+    }
+    async delete(key) {
+        await this.zk.deleteContext(key);
+    }
+    async listKeys() {
+        return this.zk.listContextKeys();
+    }
+}
+//# sourceMappingURL=context-store.js.map

package/dist/modules/context-store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context-store.js","sourceRoot":"","sources":["../../src/modules/context-store.ts"],"names":[],"mappings":"AACA,OAAO,EACL,kBAAkB,GAEnB,MAAM,sBAAsB,CAAC;AAE9B,MAAM,OAAO,YAAY;IACH;IAApB,YAAoB,EAAY;QAAZ,OAAE,GAAF,EAAE,CAAU;IAAG,CAAC;IAEpC,KAAK,CAAC,GAAG,CACP,GAAW,EACX,KAAa,EACb,YAAoB,EAAE;QAEtB,MAAM,KAAK,GAAG,kBAAkB,CAAC,EAAE,GAAG,EAAE,KAAK,EAAE,UAAU,EAAE,SAAS,EAAE,CAAC,CAAC;QACxE,MAAM,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,GAAG,EAAE,KAA2C,CAAC,CAAC;QAC3E,OAAO,KAAK,CAAC;IACf,CAAC;IAED,KAAK,CAAC,GAAG,CAAC,GAAW;QACnB,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC;QAC3C,IAAI,CAAC,IAAI;YAAE,OAAO,IAAI,CAAC;QACvB,OAAQ,IAAI,CAAC,KAAgB,IAAI,IAAI,CAAC;IACxC,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,GAAW;QACtB,MAAM,IAAI,CAAC,EAAE,CAAC,aAAa,CAAC,GAAG,CAAC,CAAC;IACnC,CAAC;IAED,KAAK,CAAC,QAAQ;QACZ,OAAO,IAAI,CAAC,EAAE,CAAC,eAAe,EAAE,CAAC;IACnC,CAAC;CACF"}

package/dist/modules/message-router.d.ts

@@ -0,0 +1,12 @@
+import { ZkClient } from "../zk/client.js";
+import { type Message } from "../models/schemas.js";
+export declare class MessageRouter {
+    private zk;
+    constructor(zk: ZkClient);
+    send(fromInstance: string, fromName: string, content: string, toInstance?: string, broadcast?: boolean): Promise<Message[]>;
+    poll(instanceId: string): Promise<Message[]>;
+    waitForMessage(instanceId: string, timeoutSeconds?: number): Promise<Message[]>;
+    markRead(instanceId: string, messageId: string): Promise<void>;
+    dismissMessage(instanceId: string, messageId: string): Promise<void>;
+    requestHelp(fromInstance: string, fromName: string, question: string, ctx?: string): Promise<Message[]>;
+}

package/dist/modules/message-router.js

@@ -0,0 +1,94 @@
+import { MessageSchema, createMessage, } from "../models/schemas.js";
+function utcNow() {
+    return new Date().toISOString();
+}
+export class MessageRouter {
+    zk;
+    constructor(zk) {
+        this.zk = zk;
+    }
+    async send(fromInstance, fromName, content, toInstance, broadcast = false) {
+        const messages = [];
+        const msgType = broadcast ? "broadcast" : "direct";
+        let targets;
+        if (broadcast) {
+            const instances = await this.zk.listInstances();
+            targets = instances
+                .map((i) => i.id)
+                .filter((id) => id !== fromInstance);
+        }
+        else if (toInstance) {
+            targets = [toInstance];
+        }
+        else {
+            throw new Error("Must specify to_instance or broadcast=true");
+        }
+        for (const targetId of targets) {
+            const msg = createMessage({
+                type: msgType,
+                from_instance: fromInstance,
+                from_name: fromName,
+                to_instance: targetId,
+                content,
+            });
+            const msgId = await this.zk.createMessage(targetId, msg);
+            msg.id = msgId;
+            messages.push(msg);
+        }
+        return messages;
+    }
+    async poll(instanceId) {
+        const raw = await this.zk.listMessages(instanceId);
+        const messages = [];
+        for (const [msgId, data] of raw) {
+            data.id = msgId;
+            const msg = MessageSchema.parse(data);
+            if (!msg.read) {
+                msg.read = true;
+                await this.zk.updateMessage(instanceId, msgId, msg);
+            }
+            messages.push(msg);
+        }
+        return messages;
+    }
+    async waitForMessage(instanceId, timeoutSeconds = 30) {
+        // First check if there are already messages
+        const existing = await this.poll(instanceId);
+        if (existing.length > 0)
+            return existing;
+        return new Promise((resolve) => {
+            const timer = setTimeout(() => resolve([]), timeoutSeconds * 1000);
+            this.zk.watchMessageDir(instanceId, async () => {
+                clearTimeout(timer);
+                const msgs = await this.poll(instanceId);
+                resolve(msgs);
+            });
+        });
+    }
+    async markRead(instanceId, messageId) {
+        const data = await this.zk.getMessage(instanceId, messageId);
+        if (!data) {
+            throw new Error(`Message ${messageId} not found for instance ${instanceId}`);
+        }
+        data.read = true;
+        await this.zk.updateMessage(instanceId, messageId, data);
+    }
+    async dismissMessage(instanceId, messageId) {
+        await this.zk.deleteMessage(instanceId, messageId);
+    }
+    async requestHelp(fromInstance, fromName, question, ctx) {
+        let content = question;
+        if (ctx) {
+            content = `${question}\n\nContext:\n${ctx}`;
+        }
+        // Set message type to "help" by modifying after creation
+        const messages = await this.send(fromInstance, fromName, content, undefined, true);
+        // Update type to "help" for each message
+        for (const msg of messages) {
+            msg.type = "help";
+            await this.zk.updateMessage(msg.to_instance, msg.id, msg);
+        }
+        return messages;
+    }
+}
+//# sourceMappingURL=message-router.js.map

package/dist/modules/message-router.js.map

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

package/dist/modules/registry.d.ts

@@ -0,0 +1,11 @@
+import { ZkClient } from "../zk/client.js";
+import { type Instance } from "../models/schemas.js";
+export declare class InstanceRegistry {
+    private zk;
+    constructor(zk: ZkClient);
+    register(name: string, role?: string, instanceId?: string): Promise<Instance>;
+    heartbeat(instanceId: string, currentTask?: string): Promise<void>;
+    get(instanceId: string): Promise<Instance | null>;
+    listAll(): Promise<Instance[]>;
+    unregister(instanceId: string): Promise<void>;
+}