@pixelbyte-software/pixcode 1.33.11 → 1.35.0

package/server/modules/orchestration/tasks/orchestration-task-store.ts

@@ -0,0 +1,45 @@
+import path from 'node:path';
+import os from 'node:os';
+
+import { JsonStore } from '@/database/json-store.js';
+import type { OrchestrationTask } from '@/modules/orchestration/tasks/orchestration-task.types.js';
+
+function defaultPath(): string {
+  return process.env.ORCHESTRATION_TASKS_PATH ??
+    path.join(os.homedir(), '.pixcode', 'orchestration-tasks.json');
+}
+
+export class OrchestrationTaskStore {
+  private store: JsonStore;
+
+  constructor(filePath = defaultPath()) {
+    this.store = new JsonStore(filePath, { orchestration_tasks: [] });
+  }
+
+  get(id: string): OrchestrationTask | undefined {
+    return this.store.findWhere('orchestration_tasks', (r: OrchestrationTask) => r.id === id) ?? undefined;
+  }
+
+  getByA2ATaskId(a2aTaskId: string): OrchestrationTask | undefined {
+    return this.store.findWhere('orchestration_tasks', (r: OrchestrationTask) => r.a2aTaskId === a2aTaskId) ?? undefined;
+  }
+
+  getByTaskMasterId(taskmasterId: string): OrchestrationTask | undefined {
+    return this.store.findWhere('orchestration_tasks', (r: OrchestrationTask) => r.taskmasterId === taskmasterId) ?? undefined;
+  }
+
+  list(projectId?: string): OrchestrationTask[] {
+    const tasks = this.store.filterWhere('orchestration_tasks', () => true) as OrchestrationTask[];
+    const sorted = tasks.sort((a, b) => b.createdAt - a.createdAt);
+    return projectId ? sorted.filter((task) => task.projectId === projectId) : sorted;
+  }
+
+  set(task: OrchestrationTask): void {
+    const existing = this.store.findWhere('orchestration_tasks', (r: OrchestrationTask) => r.id === task.id);
+    if (existing) {
+      this.store.updateWhere('orchestration_tasks', (r: OrchestrationTask) => r.id === task.id, task);
+    } else {
+      this.store.insert('orchestration_tasks', task, { autoId: false });
+    }
+  }
+}

package/server/modules/orchestration/tasks/orchestration-task.routes.ts

@@ -0,0 +1,73 @@
+import express, { type Router } from 'express';
+import { orchestrationTaskService } from '@/modules/orchestration/tasks/orchestration-task.service.js';
+
+export function createOrchestrationTaskRouter(): Router {
+  const router = express.Router();
+  router.use(express.json({ limit: '2mb' }));
+
+  router.get('/tasks', (req, res) => {
+    const projectId = typeof req.query.projectId === 'string' ? req.query.projectId : undefined;
+    res.json({ tasks: orchestrationTaskService.list(projectId) });
+  });
+
+  router.post('/tasks', (req, res) => {
+    const projectId = typeof req.body?.projectId === 'string' ? req.body.projectId : 'default';
+    const title = typeof req.body?.title === 'string' ? req.body.title.trim() : '';
+    const description = typeof req.body?.description === 'string' ? req.body.description : undefined;
+    const taskmasterId = typeof req.body?.taskmasterId === 'string' ? req.body.taskmasterId : undefined;
+
+    if (!title) {
+      res.status(400).json({ error: { code: 'TITLE_REQUIRED', message: 'title is required' } });
+      return;
+    }
+
+    const task = orchestrationTaskService.create({ projectId, title, description, taskmasterId });
+    res.status(201).json(task);
+  });
+
+  router.post('/tasks/import-taskmaster', (req, res) => {
+    const projectId = typeof req.body?.projectId === 'string' ? req.body.projectId : 'default';
+    const entries = Array.isArray(req.body?.tasks) ? req.body.tasks : [];
+    const imported = entries
+      .map((entry: unknown) => {
+        if (!entry || typeof entry !== 'object') return null;
+        const record = entry as Record<string, unknown>;
+        const taskmasterId = typeof record.id === 'string' ? record.id : undefined;
+        const title = typeof record.title === 'string' ? record.title : undefined;
+        const description = typeof record.description === 'string' ? record.description : undefined;
+        if (!taskmasterId || !title) return null;
+        return orchestrationTaskService.upsertFromTaskMaster({ projectId, title, description, taskmasterId });
+      })
+      .filter(Boolean);
+
+    res.json({ tasks: imported, count: imported.length });
+  });
+
+  router.post('/tasks/:id/dispatch', async (req, res) => {
+    try {
+      const adapterId = typeof req.body?.adapterId === 'string' ? req.body.adapterId : '';
+      const isolation = req.body?.isolation;
+      if (!adapterId) {
+        res.status(400).json({ error: { code: 'ADAPTER_REQUIRED', message: 'adapterId is required' } });
+        return;
+      }
+      const task = await orchestrationTaskService.dispatch(req.params.id, { adapterId, isolation });
+      res.json(task);
+    } catch (error) {
+      const message = error instanceof Error ? error.message : String(error);
+      const status = message === 'TASK_NOT_FOUND' ? 404 : 400;
+      res.status(status).json({ error: { code: 'DISPATCH_FAILED', message } });
+    }
+  });
+
+  router.post('/tasks/:id/cancel', (req, res) => {
+    try {
+      const task = orchestrationTaskService.cancel(req.params.id);
+      res.json(task);
+    } catch {
+      res.status(404).json({ error: { code: 'TASK_NOT_FOUND', message: req.params.id } });
+    }
+  });
+
+  return router;
+}

package/server/modules/orchestration/tasks/orchestration-task.service.ts

@@ -0,0 +1,145 @@
+import { OrchestrationTaskStore } from '@/modules/orchestration/tasks/orchestration-task-store.js';
+import type { CreateOrchestrationTaskInput, DispatchOrchestrationTaskInput, OrchestrationTask } from '@/modules/orchestration/tasks/orchestration-task.types.js';
+import { a2aBus } from '@/modules/orchestration/a2a/bus.js';
+import type { TaskState } from '@/modules/orchestration/a2a/types.js';
+
+function newId(prefix: string): string {
+  return `${prefix}_${Math.random().toString(36).slice(2, 10)}`;
+}
+
+const TERMINAL_A2A_STATES: TaskState[] = ['completed', 'canceled', 'failed'];
+
+class OrchestrationTaskService {
+  private store: OrchestrationTaskStore;
+
+  constructor(store?: OrchestrationTaskStore) {
+    this.store = store ?? new OrchestrationTaskStore();
+    this.watchA2ATerminalStates();
+  }
+
+  list(projectId?: string): OrchestrationTask[] {
+    return this.store.list(projectId);
+  }
+
+  get(id: string): OrchestrationTask | undefined {
+    return this.store.get(id);
+  }
+
+  create(input: CreateOrchestrationTaskInput): OrchestrationTask {
+    const now = Date.now();
+    const task: OrchestrationTask = {
+      id: newId('otask'),
+      projectId: input.projectId,
+      title: input.title,
+      description: input.description,
+      taskmasterId: input.taskmasterId,
+      state: 'todo',
+      createdAt: now,
+      updatedAt: now,
+    };
+    this.store.set(task);
+    return task;
+  }
+
+  upsertFromTaskMaster(input: CreateOrchestrationTaskInput): OrchestrationTask {
+    const existing = this.store.list(input.projectId).find((task) =>
+      task.taskmasterId === input.taskmasterId,
+    );
+    if (existing) {
+      existing.title = input.title;
+      existing.description = input.description;
+      existing.updatedAt = Date.now();
+      this.store.set(existing);
+      return existing;
+    }
+    return this.create(input);
+  }
+
+  async dispatch(taskId: string, input: DispatchOrchestrationTaskInput): Promise<OrchestrationTask> {
+    const task = this.store.get(taskId);
+    if (!task) throw new Error('TASK_NOT_FOUND');
+
+    const a2aResponse = await fetch(`http://127.0.0.1:${process.env.SERVER_PORT ?? '3001'}/a2a/tasks`, {
+      method: 'POST',
+      headers: { 'Content-Type': 'application/json' },
+      body: JSON.stringify({
+        adapterId: input.adapterId,
+        message: {
+          messageId: newId('msg'),
+          role: 'user',
+          parts: [{ kind: 'text', text: `${task.title}\n\n${task.description ?? ''}` }],
+        },
+        metadata: {
+          isolation: input.isolation ?? 'worktree',
+          orchestrationTaskId: task.id,
+          taskmasterId: task.taskmasterId,
+        },
+      }),
+    });
+
+    const body = await a2aResponse.json().catch(() => null) as { id?: string; error?: { message?: string } } | null;
+    if (!a2aResponse.ok || typeof body?.id !== 'string') {
+      throw new Error(body?.error?.message ?? 'DISPATCH_FAILED');
+    }
+
+    task.a2aTaskId = body.id;
+    task.adapterId = input.adapterId;
+    task.adapterSelector = input.adapterId;
+    task.workspaceKind = input.isolation ?? 'worktree';
+    task.state = 'in_progress';
+    task.updatedAt = Date.now();
+    this.store.set(task);
+    return task;
+  }
+
+  updateState(taskId: string, state: OrchestrationTask['state']): OrchestrationTask | undefined {
+    const task = this.store.get(taskId);
+    if (!task) return undefined;
+    task.state = state;
+    task.updatedAt = Date.now();
+    this.store.set(task);
+    return task;
+  }
+
+  private watchA2ATerminalStates(): void {
+    a2aBus.subscribeAll((event) => {
+      if (event.kind !== 'task-state') return;
+      if (!TERMINAL_A2A_STATES.includes(event.state)) return;
+
+      const orchTask = this.store.getByA2ATaskId(event.taskId);
+      if (!orchTask) return;
+      if (orchTask.state === 'done' || orchTask.state === 'failed' || orchTask.state === 'canceled') return;
+
+      const mapped = event.state === 'completed' ? 'done'
+        : event.state === 'failed' ? 'failed'
+        : 'canceled';
+
+      orchTask.state = mapped;
+      orchTask.updatedAt = Date.now();
+      this.store.set(orchTask);
+
+      if (orchTask.taskmasterId && mapped === 'done') {
+        this.syncTaskMasterStatus(orchTask.taskmasterId, 'done');
+      }
+    });
+  }
+
+  private syncTaskMasterStatus(taskmasterId: string, status: string): void {
+    const { spawn } = require('node:child_process') as typeof import('node:child_process');
+    spawn('task-master', ['set-status', '--id', taskmasterId, '--status', status], {
+      stdio: 'ignore',
+      detached: true,
+    }).unref();
+  }
+
+  cancel(taskId: string): OrchestrationTask {
+    const task = this.store.get(taskId);
+    if (!task) throw new Error('TASK_NOT_FOUND');
+    task.state = 'canceled';
+    task.updatedAt = Date.now();
+    this.store.set(task);
+    return task;
+  }
+}
+
+export const orchestrationTaskService = new OrchestrationTaskService();

package/server/modules/orchestration/tasks/orchestration-task.types.ts

@@ -0,0 +1,29 @@
+export type OrchestrationTaskState = 'todo' | 'in_progress' | 'in_review' | 'done' | 'failed' | 'canceled';
+
+export interface OrchestrationTask {
+  id: string;
+  a2aTaskId?: string;
+  taskmasterId?: string;
+  projectId: string;
+  title: string;
+  description?: string;
+  state: OrchestrationTaskState;
+  adapterId?: string;
+  adapterSelector?: string;
+  workspaceKind?: 'host' | 'worktree' | 'docker';
+  workspacePath?: string;
+  createdAt: number;
+  updatedAt: number;
+}
+
+export interface CreateOrchestrationTaskInput {
+  projectId: string;
+  title: string;
+  description?: string;
+  taskmasterId?: string;
+}
+
+export interface DispatchOrchestrationTaskInput {
+  adapterId: string;
+  isolation?: 'host' | 'worktree' | 'docker';
+}

package/server/modules/orchestration/workflows/built-in-workflows.ts

@@ -0,0 +1,127 @@
+import type { Workflow } from '@/modules/orchestration/workflows/workflow.types.js';
+
+export const builtInWorkflows: Workflow[] = [
+  {
+    id: 'agent_team',
+    name: 'Agent team',
+    description: 'A coordinator reads the goal and active CLI instances, assigns work, then collects the result.',
+    trigger: 'manual',
+    isBuiltin: true,
+    nodes: [],
+  },
+  {
+    id: 'multi_model_review',
+    name: 'Multi-model review',
+    description: 'Enabled CLI agents review the same goal separately, then one enabled agent aggregates the result.',
+    trigger: 'manual',
+    isBuiltin: true,
+    nodes: [
+      {
+        id: 'codex_review',
+        adapterId: 'codex',
+        prompt: 'Review the requested change for edge cases, regressions, and missing validation. Respond in the same language as the user request.',
+        inputs: [],
+        output: 'both',
+        onFail: 'continue',
+      },
+      {
+        id: 'gemini_review',
+        adapterId: 'gemini',
+        prompt: 'Review the requested change for security, scale, and user-experience risks. Respond in the same language as the user request.',
+        inputs: [],
+        output: 'both',
+        onFail: 'continue',
+      },
+      {
+        id: 'claude_review',
+        adapterId: 'claude-code',
+        prompt: 'Review the requested change for architecture and maintainability. Respond in the same language as the user request.',
+        inputs: [],
+        output: 'both',
+        onFail: 'continue',
+      },
+      {
+        id: 'aggregate',
+        adapterId: 'claude-code',
+        prompt: 'Aggregate the prior reviews into a concise prioritized report. Respond in the same language as the user request.',
+        inputs: ['codex_review', 'gemini_review', 'claude_review'],
+        output: 'message',
+        onFail: 'abort',
+      },
+    ],
+  },
+  {
+    id: 'sequential_handoff',
+    name: 'Sequential handoff',
+    description: 'Agents plan, implement, and review in order. Disabled CLI steps are skipped.',
+    trigger: 'manual',
+    isBuiltin: true,
+    nodes: [
+      {
+        id: 'architect',
+        adapterId: 'claude-code',
+        prompt: 'Create a concise, actionable implementation plan for the requested change. Respond in the same language as the user request.',
+        inputs: [],
+        output: 'message',
+        onFail: 'abort',
+      },
+      {
+        id: 'implement',
+        adapterId: 'codex',
+        prompt: 'Implement the requested change using the plan from the previous step. Summarize progress in the same language as the user request.',
+        inputs: ['architect'],
+        output: 'both',
+        onFail: 'abort',
+      },
+      {
+        id: 'review',
+        adapterId: 'gemini',
+        prompt: 'Review the implementation and call out any remaining issues. Respond in the same language as the user request.',
+        inputs: ['implement'],
+        output: 'message',
+        onFail: 'continue',
+      },
+    ],
+  },
+  {
+    id: 'adversarial_debate',
+    name: 'Decision debate',
+    description: 'Agents propose, critique, respond, and produce a final recommendation.',
+    trigger: 'manual',
+    isBuiltin: true,
+    nodes: [
+      {
+        id: 'proposal',
+        adapterId: 'claude-code',
+        prompt: 'Propose the best solution for the requested change. Respond in the same language as the user request.',
+        inputs: [],
+        output: 'message',
+        onFail: 'abort',
+      },
+      {
+        id: 'critique',
+        adapterId: 'codex',
+        prompt: 'Critique the proposal and offer a concrete alternative. Respond in the same language as the user request.',
+        inputs: ['proposal'],
+        output: 'message',
+        onFail: 'abort',
+      },
+      {
+        id: 'response',
+        adapterId: 'claude-code',
+        prompt: 'Respond to the critique and revise the approach if needed. Respond in the same language as the user request.',
+        inputs: ['critique'],
+        output: 'message',
+        onFail: 'abort',
+      },
+      {
+        id: 'judge',
+        adapterId: 'gemini',
+        prompt: 'Judge the debate and produce a final recommendation. Respond in the same language as the user request.',
+        inputs: ['response'],
+        output: 'message',
+        onFail: 'abort',
+      },
+    ],
+  },
+];