@pixelbyte-software/pixcode 1.51.2 → 1.51.3

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

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

package/server/modules/orchestration/workflows/context-packet.ts

@@ -1,186 +1,186 @@
-import type { ResolvedWorkspaceTarget } from '@/modules/orchestration/workflows/workspace-target.js';
-
-export const PIXCODE_CONTEXT_PROTOCOL = 'pixcode.context.v1' as const;
-export const MAX_CONTEXT_PACKET_TEXT_CHARS = 16_000;
-
-export interface WorkflowContextPacket {
-  protocol: typeof PIXCODE_CONTEXT_PROTOCOL;
-  originalUserRequest: string;
-  project: {
-    kind: string;
-    label: string;
-    selectedProjectName?: string;
-  };
-  task: {
-    workflowId: string;
-    workflowRunId: string;
-    nodeId: string;
-    stage?: string;
-    assignment?: string;
-    stepInstructions: string;
-  };
-  constraints: {
-    adapterId?: string;
-    agentLabel?: string;
-    model?: string;
-    permissionMode?: string;
-    isolation?: string;
-    toolsSettings?: Record<string, unknown>;
-  };
-  upstreamArtifacts: Array<{
-    type: 'upstream-context';
-    text: string;
-    sourceNodeIds: string[];
-  }>;
-  runState: {
-    status: string;
-    startedAt: number;
-    nodeCount: number;
-    completedNodeIds: string[];
-    runningNodeIds: string[];
-  };
-  compaction: {
-    maxChars: number;
-    originalChars: number;
-    compactedChars: number;
-    omittedChars: number;
-    wasCompacted: boolean;
-  };
-  createdAt: string;
-}
-
-type ContextPacketRun = {
-  id: string;
-  workflowId: string;
-  status: string;
-  input?: string;
-  startedAt: number;
-  nodeRuns: Array<{
-    nodeId: string;
-    status: string;
-  }>;
-};
-
-type ContextPacketNode = {
-  id: string;
-  adapterId?: string;
-  agentLabel?: string;
-  assignment?: string;
-  prompt: string;
-  stage?: string;
-  model?: string;
-  permissionMode?: string;
-  toolsSettings?: Record<string, unknown>;
-  isolation?: string;
-};
-
-export type BuildWorkflowContextPacketInput = {
-  run: ContextPacketRun;
-  node: ContextPacketNode;
-  workspaceTarget: ResolvedWorkspaceTarget;
-  inputContext: string;
-  inputNodeIds: string[];
-};
-
-function compactContextText(text: string): {
-  text: string;
-  originalChars: number;
-  compactedChars: number;
-  omittedChars: number;
-  wasCompacted: boolean;
-} {
-  const originalChars = text.length;
-  if (originalChars <= MAX_CONTEXT_PACKET_TEXT_CHARS) {
-    return {
-      text,
-      originalChars,
-      compactedChars: originalChars,
-      omittedChars: 0,
-      wasCompacted: false,
-    };
-  }
-
-  const edge = Math.floor(MAX_CONTEXT_PACKET_TEXT_CHARS / 2);
-  const omittedChars = originalChars - MAX_CONTEXT_PACKET_TEXT_CHARS;
-  const compacted = [
-    text.slice(0, edge),
-    `\n\n[...${omittedChars} characters omitted from upstream context packet...]\n\n`,
-    text.slice(-edge),
-  ].join('');
-
-  return {
-    text: compacted,
-    originalChars,
-    compactedChars: compacted.length,
-    omittedChars,
-    wasCompacted: true,
-  };
-}
-
-export function buildWorkflowContextPacket({
-  run,
-  node,
-  workspaceTarget,
-  inputContext,
-  inputNodeIds,
-}: BuildWorkflowContextPacketInput): WorkflowContextPacket {
-  const compacted = compactContextText(inputContext);
-  return {
-    protocol: PIXCODE_CONTEXT_PROTOCOL,
-    originalUserRequest: run.input?.trim() || '(No original user request was provided.)',
-    project: {
-      kind: workspaceTarget.kind,
-      label: workspaceTarget.label,
-      selectedProjectName: workspaceTarget.selectedProjectName,
-    },
-    task: {
-      workflowId: run.workflowId,
-      workflowRunId: run.id,
-      nodeId: node.id,
-      stage: node.stage,
-      assignment: node.assignment,
-      stepInstructions: node.prompt,
-    },
-    constraints: {
-      adapterId: node.adapterId,
-      agentLabel: node.agentLabel,
-      model: node.model,
-      permissionMode: node.permissionMode,
-      isolation: node.isolation,
-      toolsSettings: node.toolsSettings,
-    },
-    upstreamArtifacts: compacted.text
-      ? [{
-        type: 'upstream-context',
-        text: compacted.text,
-        sourceNodeIds: inputNodeIds,
-      }]
-      : [],
-    runState: {
-      status: run.status,
-      startedAt: run.startedAt,
-      nodeCount: run.nodeRuns.length,
-      completedNodeIds: run.nodeRuns
-        .filter((nodeRun) => nodeRun.status === 'completed')
-        .map((nodeRun) => nodeRun.nodeId),
-      runningNodeIds: run.nodeRuns
-        .filter((nodeRun) => nodeRun.status === 'running')
-        .map((nodeRun) => nodeRun.nodeId),
-    },
-    compaction: {
-      maxChars: MAX_CONTEXT_PACKET_TEXT_CHARS,
-      originalChars: compacted.originalChars,
-      compactedChars: compacted.compactedChars,
-      omittedChars: compacted.omittedChars,
-      wasCompacted: compacted.wasCompacted,
-    },
-    createdAt: new Date().toISOString(),
-  };
-}
-
-export function formatContextPacketForPrompt(packet: WorkflowContextPacket): string {
-  return [
-    `Pixcode standardized init context packet (${PIXCODE_CONTEXT_PROTOCOL}):`,
-    JSON.stringify(packet, null, 2),
-  ].join('\n');
-}
+import type { ResolvedWorkspaceTarget } from '@/modules/orchestration/workflows/workspace-target.js';
+
+export const PIXCODE_CONTEXT_PROTOCOL = 'pixcode.context.v1' as const;
+export const MAX_CONTEXT_PACKET_TEXT_CHARS = 16_000;
+
+export interface WorkflowContextPacket {
+  protocol: typeof PIXCODE_CONTEXT_PROTOCOL;
+  originalUserRequest: string;
+  project: {
+    kind: string;
+    label: string;
+    selectedProjectName?: string;
+  };
+  task: {
+    workflowId: string;
+    workflowRunId: string;
+    nodeId: string;
+    stage?: string;
+    assignment?: string;
+    stepInstructions: string;
+  };
+  constraints: {
+    adapterId?: string;
+    agentLabel?: string;
+    model?: string;
+    permissionMode?: string;
+    isolation?: string;
+    toolsSettings?: Record<string, unknown>;
+  };
+  upstreamArtifacts: Array<{
+    type: 'upstream-context';
+    text: string;
+    sourceNodeIds: string[];
+  }>;
+  runState: {
+    status: string;
+    startedAt: number;
+    nodeCount: number;
+    completedNodeIds: string[];
+    runningNodeIds: string[];
+  };
+  compaction: {
+    maxChars: number;
+    originalChars: number;
+    compactedChars: number;
+    omittedChars: number;
+    wasCompacted: boolean;
+  };
+  createdAt: string;
+}
+
+type ContextPacketRun = {
+  id: string;
+  workflowId: string;
+  status: string;
+  input?: string;
+  startedAt: number;
+  nodeRuns: Array<{
+    nodeId: string;
+    status: string;
+  }>;
+};
+
+type ContextPacketNode = {
+  id: string;
+  adapterId?: string;
+  agentLabel?: string;
+  assignment?: string;
+  prompt: string;
+  stage?: string;
+  model?: string;
+  permissionMode?: string;
+  toolsSettings?: Record<string, unknown>;
+  isolation?: string;
+};
+
+export type BuildWorkflowContextPacketInput = {
+  run: ContextPacketRun;
+  node: ContextPacketNode;
+  workspaceTarget: ResolvedWorkspaceTarget;
+  inputContext: string;
+  inputNodeIds: string[];
+};
+
+function compactContextText(text: string): {
+  text: string;
+  originalChars: number;
+  compactedChars: number;
+  omittedChars: number;
+  wasCompacted: boolean;
+} {
+  const originalChars = text.length;
+  if (originalChars <= MAX_CONTEXT_PACKET_TEXT_CHARS) {
+    return {
+      text,
+      originalChars,
+      compactedChars: originalChars,
+      omittedChars: 0,
+      wasCompacted: false,
+    };
+  }
+
+  const edge = Math.floor(MAX_CONTEXT_PACKET_TEXT_CHARS / 2);
+  const omittedChars = originalChars - MAX_CONTEXT_PACKET_TEXT_CHARS;
+  const compacted = [
+    text.slice(0, edge),
+    `\n\n[...${omittedChars} characters omitted from upstream context packet...]\n\n`,
+    text.slice(-edge),
+  ].join('');
+
+  return {
+    text: compacted,
+    originalChars,
+    compactedChars: compacted.length,
+    omittedChars,
+    wasCompacted: true,
+  };
+}
+
+export function buildWorkflowContextPacket({
+  run,
+  node,
+  workspaceTarget,
+  inputContext,
+  inputNodeIds,
+}: BuildWorkflowContextPacketInput): WorkflowContextPacket {
+  const compacted = compactContextText(inputContext);
+  return {
+    protocol: PIXCODE_CONTEXT_PROTOCOL,
+    originalUserRequest: run.input?.trim() || '(No original user request was provided.)',
+    project: {
+      kind: workspaceTarget.kind,
+      label: workspaceTarget.label,
+      selectedProjectName: workspaceTarget.selectedProjectName,
+    },
+    task: {
+      workflowId: run.workflowId,
+      workflowRunId: run.id,
+      nodeId: node.id,
+      stage: node.stage,
+      assignment: node.assignment,
+      stepInstructions: node.prompt,
+    },
+    constraints: {
+      adapterId: node.adapterId,
+      agentLabel: node.agentLabel,
+      model: node.model,
+      permissionMode: node.permissionMode,
+      isolation: node.isolation,
+      toolsSettings: node.toolsSettings,
+    },
+    upstreamArtifacts: compacted.text
+      ? [{
+        type: 'upstream-context',
+        text: compacted.text,
+        sourceNodeIds: inputNodeIds,
+      }]
+      : [],
+    runState: {
+      status: run.status,
+      startedAt: run.startedAt,
+      nodeCount: run.nodeRuns.length,
+      completedNodeIds: run.nodeRuns
+        .filter((nodeRun) => nodeRun.status === 'completed')
+        .map((nodeRun) => nodeRun.nodeId),
+      runningNodeIds: run.nodeRuns
+        .filter((nodeRun) => nodeRun.status === 'running')
+        .map((nodeRun) => nodeRun.nodeId),
+    },
+    compaction: {
+      maxChars: MAX_CONTEXT_PACKET_TEXT_CHARS,
+      originalChars: compacted.originalChars,
+      compactedChars: compacted.compactedChars,
+      omittedChars: compacted.omittedChars,
+      wasCompacted: compacted.wasCompacted,
+    },
+    createdAt: new Date().toISOString(),
+  };
+}
+
+export function formatContextPacketForPrompt(packet: WorkflowContextPacket): string {
+  return [
+    `Pixcode standardized init context packet (${PIXCODE_CONTEXT_PROTOCOL}):`,
+    JSON.stringify(packet, null, 2),
+  ].join('\n');
+}