@pixelbyte-software/pixcode 1.54.11 → 1.55.0

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

@@ -1,201 +0,0 @@
-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 { submitA2ATask } from '@/modules/orchestration/a2a/task-dispatcher.js';
-import type { TaskState } from '@/modules/orchestration/a2a/types.js';
-import type { WorkflowNodeRun, WorkflowRun } from '@/modules/orchestration/workflows/workflow.types.js';
-
-function newId(prefix: string): string {
-  return `${prefix}_${Math.random().toString(36).slice(2, 10)}`;
-}
-
-const TERMINAL_A2A_STATES: TaskState[] = ['completed', 'canceled', 'failed'];
-
-function uniqueStrings(values: Array<string | undefined>): string[] {
-  return [...new Set(values.filter((value): value is string => Boolean(value?.trim())))]
-    .sort((a, b) => a.localeCompare(b));
-}
-
-function readRecord(value: unknown): Record<string, unknown> | undefined {
-  return value && typeof value === 'object' ? value as Record<string, unknown> : undefined;
-}
-
-function readString(value: unknown): string | undefined {
-  return typeof value === 'string' && value.trim() ? value.trim() : undefined;
-}
-
-function changedFilesFromNode(node: WorkflowNodeRun): string[] {
-  const files: string[] = [];
-  if (node.handoffArtifact?.changedFiles) {
-    files.push(...node.handoffArtifact.changedFiles);
-  }
-  for (const artifact of node.artifacts ?? []) {
-    const data = readRecord(artifact.data);
-    const metadata = readRecord(artifact.metadata);
-    files.push(
-      ...[readString(data?.path), readString(data?.file), readString(metadata?.path), readString(metadata?.file)]
-        .filter((value): value is string => Boolean(value)),
-    );
-    for (const key of ['files', 'changedFiles']) {
-      const value = data?.[key] ?? metadata?.[key];
-      if (Array.isArray(value)) {
-        files.push(...value.map((entry) => readString(entry)).filter((entry): entry is string => Boolean(entry)));
-      }
-    }
-  }
-  return uniqueStrings(files);
-}
-
-function changedFilesFromWorkflowRun(run: WorkflowRun): string[] {
-  return uniqueStrings(run.nodeRuns.flatMap((node) => changedFilesFromNode(node)));
-}
-
-function workflowRunState(run: WorkflowRun): OrchestrationTask['state'] {
-  if (run.status === 'completed') return 'done';
-  if (run.status === 'failed') return 'failed';
-  if (run.status === 'canceled') return 'canceled';
-  return 'in_progress';
-}
-
-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,
-      acceptanceCriteria: input.acceptanceCriteria,
-      changedFiles: input.changedFiles,
-      state: 'todo',
-      createdAt: now,
-      updatedAt: now,
-    };
-    this.store.set(task);
-    return task;
-  }
-
-  async dispatch(taskId: string, input: DispatchOrchestrationTaskInput): Promise<OrchestrationTask> {
-    const task = this.store.get(taskId);
-    if (!task) throw new Error('TASK_NOT_FOUND');
-
-    const a2aTask = await submitA2ATask({
-      adapterId: input.adapterId,
-      message: {
-        messageId: newId('msg'),
-        role: 'user',
-        parts: [{ kind: 'text', text: `${task.title}\n\n${task.description ?? ''}` }],
-      },
-      metadata: {
-        isolation: input.isolation ?? 'worktree',
-        model: input.model,
-        permissionMode: input.permissionMode,
-        workspace: {
-          kind: input.isolation ?? 'worktree',
-          projectPath: input.projectPath,
-        },
-        orchestrationTaskId: task.id,
-      },
-    });
-
-    task.a2aTaskId = a2aTask.id;
-    task.adapterId = input.adapterId;
-    task.adapterSelector = input.adapterId;
-    task.workspaceKind = input.isolation ?? 'worktree';
-    task.workspacePath = input.projectPath;
-    task.state = 'in_progress';
-    task.updatedAt = Date.now();
-    this.store.set(task);
-    return task;
-  }
-
-  linkWorkflowRun(taskId: string, run: WorkflowRun): OrchestrationTask | undefined {
-    const task = this.store.get(taskId);
-    if (!task) return undefined;
-    task.workflowRunIds = uniqueStrings([...(task.workflowRunIds ?? []), run.id]);
-    task.state = workflowRunState(run);
-    task.updatedAt = Date.now();
-    this.store.set(task);
-    return task;
-  }
-
-  updateFromWorkflowRun(run: WorkflowRun): OrchestrationTask | undefined {
-    const metadata = run.metadata ?? {};
-    const taskId = readString(metadata.orchestrationTaskId);
-    const task = taskId ? this.store.get(taskId) : undefined;
-    if (!task) return undefined;
-
-    const changedFiles = changedFilesFromWorkflowRun(run);
-    task.workflowRunIds = uniqueStrings([...(task.workflowRunIds ?? []), run.id]);
-    task.changedFiles = uniqueStrings([...(task.changedFiles ?? []), ...changedFiles]);
-    task.state = workflowRunState(run);
-    task.acceptanceCriteria = [
-      ...(task.acceptanceCriteria ?? []).filter((criterion) => criterion.id !== `run-${run.id}`),
-      {
-        id: `run-${run.id}`,
-        label: `Workflow ${run.workflowId} ${run.status}`,
-        status: run.status === 'completed' ? 'passed' : run.status === 'failed' || run.status === 'canceled' ? 'failed' : 'pending',
-        source: 'workflow',
-      },
-    ];
-    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);
-
-    });
-  }
-
-  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

@@ -1,40 +0,0 @@
-export type OrchestrationTaskState = 'todo' | 'in_progress' | 'in_review' | 'done' | 'failed' | 'canceled';
-
-export interface OrchestrationTask {
-  id: string;
-  a2aTaskId?: string;
-  workflowRunIds?: string[];
-  projectId: string;
-  title: string;
-  description?: string;
-  state: OrchestrationTaskState;
-  acceptanceCriteria?: Array<{
-    id: string;
-    label: string;
-    status: 'pending' | 'passed' | 'failed';
-    source: 'workflow' | 'agent';
-  }>;
-  changedFiles?: string[];
-  adapterId?: string;
-  adapterSelector?: string;
-  workspaceKind?: 'host' | 'worktree' | 'docker';
-  workspacePath?: string;
-  createdAt: number;
-  updatedAt: number;
-}
-
-export interface CreateOrchestrationTaskInput {
-  projectId: string;
-  title: string;
-  description?: string;
-  acceptanceCriteria?: OrchestrationTask['acceptanceCriteria'];
-  changedFiles?: string[];
-}
-
-export interface DispatchOrchestrationTaskInput {
-  adapterId: string;
-  isolation?: 'host' | 'worktree' | 'docker';
-  projectPath?: string;
-  model?: string;
-  permissionMode?: string;
-}

package/server/modules/orchestration/tasks/task-run-graph.ts

@@ -1,155 +0,0 @@
-import type { WorkflowNodeRun, WorkflowRun } from '@/modules/orchestration/workflows/workflow.types.js';
-import { workflowStore } from '@/modules/orchestration/workflows/workflow-store.js';
-import { orchestrationTaskService } from '@/modules/orchestration/tasks/orchestration-task.service.js';
-import type { OrchestrationTask } from '@/modules/orchestration/tasks/orchestration-task.types.js';
-
-export const PIXCODE_TASK_RUN_GRAPH_PROTOCOL = 'pixcode.task-run-graph.v1';
-
-export type TaskRunGraphCriterionStatus = 'pending' | 'passed' | 'failed';
-
-export interface TaskRunGraphCriterion {
-  id: string;
-  label: string;
-  status: TaskRunGraphCriterionStatus;
-  source: 'workflow' | 'agent';
-}
-
-export interface TaskRunGraphRunSummary {
-  id: string;
-  workflowId: string;
-  status: WorkflowRun['status'];
-  startedAt: number;
-  finishedAt?: number;
-  orchestrationTaskId?: string;
-  changedFiles: string[];
-}
-
-export interface TaskRunGraph {
-  protocol: typeof PIXCODE_TASK_RUN_GRAPH_PROTOCOL;
-  projectId: string;
-  orchestrationTaskId?: string;
-  workflowRuns: TaskRunGraphRunSummary[];
-  changedFiles: string[];
-  acceptanceCriteria: TaskRunGraphCriterion[];
-  status: {
-    totalRuns: number;
-    completedRuns: number;
-    failedRuns: number;
-    passedCriteria: number;
-    failedCriteria: number;
-  };
-}
-
-function readString(value: unknown): string | undefined {
-  return typeof value === 'string' && value.trim() ? value.trim() : undefined;
-}
-
-function readRecord(value: unknown): Record<string, unknown> | undefined {
-  return value && typeof value === 'object' ? value as Record<string, unknown> : undefined;
-}
-
-function uniqueStrings(values: Array<string | undefined>): string[] {
-  return [...new Set(values.filter((value): value is string => Boolean(value?.trim())))]
-    .sort((a, b) => a.localeCompare(b));
-}
-
-function metadataOrchestrationTaskId(run: WorkflowRun): string | undefined {
-  return readString(run.metadata?.orchestrationTaskId)
-    ?? readString(readRecord(run.metadata?.taskGraph)?.orchestrationTaskId);
-}
-
-function artifactChangedFiles(node: WorkflowNodeRun): string[] {
-  const files: string[] = [];
-
-  if (node.handoffArtifact?.changedFiles) {
-    files.push(...node.handoffArtifact.changedFiles);
-  }
-
-  for (const artifact of node.artifacts ?? []) {
-    const data = readRecord(artifact.data);
-    const metadata = readRecord(artifact.metadata);
-    const candidates = [
-      readString(metadata?.path),
-      readString(metadata?.file),
-      readString(data?.path),
-      readString(data?.file),
-    ];
-    files.push(...candidates.filter((value): value is string => Boolean(value)));
-
-    for (const key of ['files', 'changedFiles']) {
-      const value = data?.[key] ?? metadata?.[key];
-      if (Array.isArray(value)) {
-        files.push(...value.map((entry) => readString(entry)).filter((entry): entry is string => Boolean(entry)));
-      }
-    }
-  }
-
-  return uniqueStrings(files);
-}
-
-export function changedFilesFromWorkflowRun(run: WorkflowRun): string[] {
-  return uniqueStrings(run.nodeRuns.flatMap((node) => artifactChangedFiles(node)));
-}
-
-function workflowRunMatchesTask(run: WorkflowRun, task: OrchestrationTask | undefined): boolean {
-  const runOrchestrationTaskId = metadataOrchestrationTaskId(run);
-  if (task?.id && runOrchestrationTaskId === task.id) return true;
-  if (task?.workflowRunIds?.includes(run.id)) return true;
-  return false;
-}
-
-function runSummary(run: WorkflowRun): TaskRunGraphRunSummary {
-  return {
-    id: run.id,
-    workflowId: run.workflowId,
-    status: run.status,
-    startedAt: run.startedAt,
-    finishedAt: run.finishedAt,
-    orchestrationTaskId: metadataOrchestrationTaskId(run),
-    changedFiles: changedFilesFromWorkflowRun(run),
-  };
-}
-
-export function buildTaskRunGraph({
-  projectId,
-  orchestrationTaskId,
-}: {
-  projectId: string;
-  orchestrationTaskId?: string;
-}): TaskRunGraph {
-  const orchestrationTask = orchestrationTaskId ? orchestrationTaskService.get(orchestrationTaskId) : undefined;
-  const workflowRuns = workflowStore
-    .listRuns()
-    .filter((run) => workflowRunMatchesTask(run, orchestrationTask))
-    .map(runSummary);
-  const workflowCriteria: TaskRunGraphCriterion[] = workflowRuns.map((run) => ({
-    id: `run-${run.id}`,
-    label: `Workflow ${run.workflowId} ${run.status}`,
-    status: run.status === 'completed' ? 'passed' : run.status === 'failed' || run.status === 'canceled' ? 'failed' : 'pending',
-    source: 'workflow',
-  }));
-  const acceptanceCriteria = [
-    ...(orchestrationTask?.acceptanceCriteria ?? []),
-    ...workflowCriteria,
-  ];
-  const changedFiles = uniqueStrings([
-    ...(orchestrationTask?.changedFiles ?? []),
-    ...workflowRuns.flatMap((run) => run.changedFiles),
-  ]);
-
-  return {
-    protocol: PIXCODE_TASK_RUN_GRAPH_PROTOCOL,
-    projectId,
-    orchestrationTaskId: orchestrationTask?.id,
-    workflowRuns,
-    changedFiles,
-    acceptanceCriteria,
-    status: {
-      totalRuns: workflowRuns.length,
-      completedRuns: workflowRuns.filter((run) => run.status === 'completed').length,
-      failedRuns: workflowRuns.filter((run) => run.status === 'failed' || run.status === 'canceled').length,
-      passedCriteria: acceptanceCriteria.filter((criterion) => criterion.status === 'passed').length,
-      failedCriteria: acceptanceCriteria.filter((criterion) => criterion.status === 'failed').length,
-    },
-  };
-}

package/server/modules/orchestration/workflows/approval-queue.ts

@@ -1,106 +0,0 @@
-import type { WorkflowRun } from '@/modules/orchestration/workflows/workflow.types.js';
-import { workflowStore } from '@/modules/orchestration/workflows/workflow-store.js';
-
-export type ApprovalDecisionSource = 'ui' | 'telegram' | 'api';
-
-export type ApprovalQueueItem = Record<string, unknown> & {
-  id: string;
-  runId: string;
-  workflowId: string;
-  status: string;
-  requestedAt?: number;
-};
-
-function readRunApprovals(run: WorkflowRun): Array<Record<string, unknown>> {
-  const approvals = run.metadata?.pendingPermissionApprovals;
-  return Array.isArray(approvals)
-    ? approvals.filter((approval): approval is Record<string, unknown> => Boolean(approval && typeof approval === 'object'))
-    : [];
-}
-
-function normalizeApproval(run: WorkflowRun, approval: Record<string, unknown>): ApprovalQueueItem | null {
-  const id = typeof approval.id === 'string' && approval.id.trim() ? approval.id : null;
-  if (!id) return null;
-
-  return {
-    ...approval,
-    id,
-    runId: run.id,
-    workflowId: run.workflowId,
-    status: typeof approval.status === 'string' ? approval.status : 'pending',
-    requestedAt: typeof approval.requestedAt === 'number' ? approval.requestedAt : run.startedAt,
-  };
-}
-
-export function listPendingApprovals(options: {
-  projectId?: string;
-  includeResolved?: boolean;
-} = {}): ApprovalQueueItem[] {
-  const items: ApprovalQueueItem[] = [];
-  for (const run of workflowStore.listRuns()) {
-    if (options.projectId && run.metadata?.projectId !== options.projectId) continue;
-    for (const approval of readRunApprovals(run)) {
-      const item = normalizeApproval(run, approval);
-      if (!item) continue;
-      if (!options.includeResolved && item.status !== 'pending') continue;
-      items.push(item);
-    }
-  }
-
-  return items.sort((a, b) => Number(b.requestedAt ?? 0) - Number(a.requestedAt ?? 0));
-}
-
-export function resolvePermissionApproval({
-  approvalId,
-  allow,
-  source = 'api',
-  resolvedBy,
-  message,
-}: {
-  approvalId: string;
-  allow: boolean;
-  source?: ApprovalDecisionSource; // source: 'ui' | 'telegram' | 'api'
-  resolvedBy?: string | number | null;
-  message?: string;
-}): {
-  runId: string;
-  pendingApprovals: ApprovalQueueItem[];
-  approvalHistory: ApprovalQueueItem[];
-} | null {
-  for (const run of workflowStore.listRuns()) {
-    const approvals = readRunApprovals(run);
-    let changed = false;
-    const nextApprovals = approvals.map((approval) => {
-      if (approval.id !== approvalId) return approval;
-      changed = true;
-      return {
-        ...approval,
-        status: allow ? 'allowed' : 'denied',
-        resolvedAt: Date.now(),
-        resolvedBy: resolvedBy ?? null,
-        decisionSource: source,
-        resolutionMessage: typeof message === 'string' && message.trim() ? message.trim() : undefined,
-      };
-    });
-
-    if (!changed) continue;
-
-    run.metadata = {
-      ...run.metadata,
-      pendingPermissionApprovals: nextApprovals,
-    };
-    workflowStore.setRun(run);
-
-    const queueItems = nextApprovals
-      .map((approval) => normalizeApproval(run, approval))
-      .filter((approval): approval is ApprovalQueueItem => Boolean(approval));
-
-    return {
-      runId: run.id,
-      pendingApprovals: queueItems.filter((approval) => approval.status === 'pending'),
-      approvalHistory: queueItems.filter((approval) => approval.status !== 'pending'),
-    };
-  }
-
-  return null;
-}

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

@@ -1,127 +0,0 @@
-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',
-      },
-    ],
-  },
-];