@pixelbyte-software/pixcode 1.51.2 → 1.51.4

package/server/modules/orchestration/workflows/workflow.types.ts

@@ -1,111 +1,111 @@
-import type { WorkflowContextPacket } from '@/modules/orchestration/workflows/context-packet.js';
-import type { WorkflowFallbackTrigger } from '@/modules/orchestration/workflows/workflow-fallback-policy.js';
-import type { WorkflowHandoffArtifact } from '@/modules/orchestration/workflows/handoff-artifact.js';
-import type {
-  PermissionDecision,
-  PermissionPolicy,
-} from '@/modules/orchestration/security/permission-policy.js';
-
-export type WorkflowRunStatus = 'queued' | 'running' | 'completed' | 'failed' | 'canceled';
-export type WorkflowNodeStatus = WorkflowRunStatus | 'skipped';
-
-export interface WorkflowNode {
-  id: string;
-  adapterId: string;
-  prompt: string;
-  inputs: string[];
-  output: 'message' | 'artifact' | 'both';
-  onFail: 'abort' | 'continue' | 'retry';
-  stage?: string;
-  agentInstanceId?: string;
-  agentLabel?: string;
-  assignment?: string;
-  model?: string;
-  permissionMode?: string;
-  permissionPolicy?: PermissionPolicy;
-  permissionDecisions?: PermissionDecision[];
-  toolsSettings?: Record<string, unknown>;
-  isolation?: 'host' | 'worktree' | 'docker';
-  timeoutMs?: number;
-  internal?: boolean;
-  fallbackTrigger?: WorkflowFallbackTrigger;
-  fallbackSourceNodeId?: string;
-}
-
-export interface Workflow {
-  id: string;
-  name: string;
-  description?: string;
-  trigger: 'manual' | 'on-task-create' | 'on-pr-open';
-  nodes: WorkflowNode[];
-  isBuiltin?: boolean;
-}
-
-export interface WorkflowNodeRun {
-  nodeId: string;
-  adapterId?: string;
-  agentInstanceId?: string;
-  agentLabel?: string;
-  assignment?: string;
-  promptPreview?: string;
-  model?: string;
-  permissionMode?: string;
-  permissionPolicy?: PermissionPolicy;
-  permissionDecisions?: PermissionDecision[];
-  timeoutMs?: number;
-  stage?: string;
-  internal?: boolean;
-  fallbackTrigger?: WorkflowFallbackTrigger;
-  fallbackSourceNodeId?: string;
-  status: WorkflowNodeStatus;
-  hermesTaskId?: string;
-  startedAt?: number;
-  finishedAt?: number;
-  error?: string;
-  outputText?: string;
-  contextPacket?: WorkflowContextPacket;
-  handoffArtifact?: WorkflowHandoffArtifact;
-  messages?: Array<{
-    role: string;
-    text: string;
-    createdAt?: number;
-  }>;
-  artifacts?: Array<{
-    type: string;
-    text?: string;
-    data?: Record<string, unknown>;
-    metadata?: Record<string, unknown>;
-  }>;
-}
-
-export interface WorkflowRun {
-  id: string;
-  workflowId: string;
-  contextId: string;
-  status: WorkflowRunStatus;
-  nodeRuns: WorkflowNodeRun[];
-  input?: string;
-  startedAt: number;
-  finishedAt?: number;
-  metadata?: Record<string, unknown>;
-}
-
-export interface WorkflowTraceEvent {
-  id: string;
-  type: 'run' | 'node' | 'provider' | 'message' | 'artifact' | 'file' | 'error' | 'permission_policy';
-  severity: 'info' | 'warning' | 'error';
-  status: WorkflowRunStatus | WorkflowNodeStatus | 'submitted';
-  timestamp: number;
-  durationMs?: number;
-  actor: string;
-  title: string;
-  titleKey?: string;
-  summary?: string;
-  detail?: string;
-  nodeId?: string;
-  adapterId?: string;
-  agentInstanceId?: string;
-  agentLabel?: string;
-  model?: string;
-  metadata?: Record<string, unknown>;
-}
+import type { WorkflowContextPacket } from '@/modules/orchestration/workflows/context-packet.js';
+import type { WorkflowFallbackTrigger } from '@/modules/orchestration/workflows/workflow-fallback-policy.js';
+import type { WorkflowHandoffArtifact } from '@/modules/orchestration/workflows/handoff-artifact.js';
+import type {
+  PermissionDecision,
+  PermissionPolicy,
+} from '@/modules/orchestration/security/permission-policy.js';
+
+export type WorkflowRunStatus = 'queued' | 'running' | 'completed' | 'failed' | 'canceled';
+export type WorkflowNodeStatus = WorkflowRunStatus | 'skipped';
+
+export interface WorkflowNode {
+  id: string;
+  adapterId: string;
+  prompt: string;
+  inputs: string[];
+  output: 'message' | 'artifact' | 'both';
+  onFail: 'abort' | 'continue' | 'retry';
+  stage?: string;
+  agentInstanceId?: string;
+  agentLabel?: string;
+  assignment?: string;
+  model?: string;
+  permissionMode?: string;
+  permissionPolicy?: PermissionPolicy;
+  permissionDecisions?: PermissionDecision[];
+  toolsSettings?: Record<string, unknown>;
+  isolation?: 'host' | 'worktree' | 'docker';
+  timeoutMs?: number;
+  internal?: boolean;
+  fallbackTrigger?: WorkflowFallbackTrigger;
+  fallbackSourceNodeId?: string;
+}
+
+export interface Workflow {
+  id: string;
+  name: string;
+  description?: string;
+  trigger: 'manual' | 'on-task-create' | 'on-pr-open';
+  nodes: WorkflowNode[];
+  isBuiltin?: boolean;
+}
+
+export interface WorkflowNodeRun {
+  nodeId: string;
+  adapterId?: string;
+  agentInstanceId?: string;
+  agentLabel?: string;
+  assignment?: string;
+  promptPreview?: string;
+  model?: string;
+  permissionMode?: string;
+  permissionPolicy?: PermissionPolicy;
+  permissionDecisions?: PermissionDecision[];
+  timeoutMs?: number;
+  stage?: string;
+  internal?: boolean;
+  fallbackTrigger?: WorkflowFallbackTrigger;
+  fallbackSourceNodeId?: string;
+  status: WorkflowNodeStatus;
+  hermesTaskId?: string;
+  startedAt?: number;
+  finishedAt?: number;
+  error?: string;
+  outputText?: string;
+  contextPacket?: WorkflowContextPacket;
+  handoffArtifact?: WorkflowHandoffArtifact;
+  messages?: Array<{
+    role: string;
+    text: string;
+    createdAt?: number;
+  }>;
+  artifacts?: Array<{
+    type: string;
+    text?: string;
+    data?: Record<string, unknown>;
+    metadata?: Record<string, unknown>;
+  }>;
+}
+
+export interface WorkflowRun {
+  id: string;
+  workflowId: string;
+  contextId: string;
+  status: WorkflowRunStatus;
+  nodeRuns: WorkflowNodeRun[];
+  input?: string;
+  startedAt: number;
+  finishedAt?: number;
+  metadata?: Record<string, unknown>;
+}
+
+export interface WorkflowTraceEvent {
+  id: string;
+  type: 'run' | 'node' | 'provider' | 'message' | 'artifact' | 'file' | 'error' | 'permission_policy';
+  severity: 'info' | 'warning' | 'error';
+  status: WorkflowRunStatus | WorkflowNodeStatus | 'submitted';
+  timestamp: number;
+  durationMs?: number;
+  actor: string;
+  title: string;
+  titleKey?: string;
+  summary?: string;
+  detail?: string;
+  nodeId?: string;
+  adapterId?: string;
+  agentInstanceId?: string;
+  agentLabel?: string;
+  model?: string;
+  metadata?: Record<string, unknown>;
+}

package/server/modules/orchestration/workflows/workspace-target.ts

@@ -1,122 +1,122 @@
-import { readFileSync } from 'node:fs';
-import { dirname, resolve } from 'node:path';
-import { fileURLToPath } from 'node:url';
-
-export type WorkspaceTargetKind = 'selected_project' | 'pixcode_app' | 'custom';
-
-export type ResolvedWorkspaceTarget = {
-  kind: WorkspaceTargetKind;
-  label: string;
-  projectPath: string;
-  selectedProjectPath?: string;
-  selectedProjectName?: string;
-  appRoot: string;
-};
-
-const pixcodePackageName = '@pixelbyte-software/pixcode';
-
-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 readTargetKind(value: unknown): WorkspaceTargetKind | undefined {
-  return value === 'selected_project' || value === 'pixcode_app' || value === 'custom'
-    ? value
-    : undefined;
-}
-
-export function findPixcodeAppRoot(): string {
-  let currentDir = dirname(fileURLToPath(import.meta.url));
-
-  for (let depth = 0; depth < 10; depth += 1) {
-    try {
-      const packagePath = resolve(currentDir, 'package.json');
-      const pkg = JSON.parse(readFileSync(packagePath, 'utf8')) as { name?: string };
-      if (pkg.name === pixcodePackageName) {
-        return currentDir;
-      }
-    } catch {
-      // Walk upward until the Pixcode package root is found.
-    }
-
-    const parent = dirname(currentDir);
-    if (parent === currentDir) break;
-    currentDir = parent;
-  }
-
-  return process.cwd();
-}
-
-export function resolveWorkflowWorkspace(metadata?: Record<string, unknown>): ResolvedWorkspaceTarget {
-  const target = readRecord(metadata?.workspaceTarget);
-  const appRoot = findPixcodeAppRoot();
-  const selectedProjectPath = readString(metadata?.selectedProjectPath) ?? readString(metadata?.projectPath);
-  const selectedProjectName = readString(metadata?.projectName) ?? readString(metadata?.projectId);
-  const kind = readTargetKind(target?.kind) ?? 'selected_project';
-  const customPath = readString(target?.projectPath);
-
-  if (kind === 'pixcode_app') {
-    return {
-      kind,
-      label: 'Pixcode app',
-      projectPath: appRoot,
-      selectedProjectPath,
-      selectedProjectName,
-      appRoot,
-    };
-  }
-
-  if (kind === 'custom') {
-    return {
-      kind,
-      label: readString(target?.label) ?? 'Custom workspace',
-      projectPath: customPath ?? selectedProjectPath ?? appRoot,
-      selectedProjectPath,
-      selectedProjectName,
-      appRoot,
-    };
-  }
-
-  return {
-    kind: 'selected_project',
-    label: selectedProjectName ?? 'Selected project',
-    projectPath: selectedProjectPath ?? appRoot,
-    selectedProjectPath,
-    selectedProjectName,
-    appRoot,
-  };
-}
-
-export function workspaceTargetMetadata(target: ResolvedWorkspaceTarget): Record<string, unknown> {
-  return {
-    kind: target.kind,
-    label: target.label,
-    projectPath: target.projectPath,
-    selectedProjectPath: target.selectedProjectPath,
-    selectedProjectName: target.selectedProjectName,
-    appRoot: target.appRoot,
-  };
-}
-
-export function workspaceContextPrompt(target: ResolvedWorkspaceTarget): string {
-  return [
-    'Pixcode orchestration execution context:',
-    `- Target workspace: ${target.label}`,
-    `- Working directory for this agent: ${target.projectPath}`,
-    target.selectedProjectName ? `- Selected UI project: ${target.selectedProjectName}` : '',
-    target.selectedProjectPath ? `- Selected UI project path: ${target.selectedProjectPath}` : '',
-    `- Pixcode app root: ${target.appRoot}`,
-    '',
-    'Rules:',
-    '- Treat the working directory above as the authoritative project/application for this task.',
-    '- Do not guess another repository path unless the user explicitly asks for it.',
-    '- Do not access parent directories, sibling projects, or broad external globs outside the working directory unless the user explicitly asks.',
-    '- If the user asks to analyze or modify Pixcode/orchestration itself, the target workspace must be the Pixcode app root.',
-    '- Before running package-manager commands, inspect the package files in the working directory.',
-    '- If a tool reports a permission denial, summarize the limitation and continue from the provided context instead of retrying the same external path.',
-  ].filter(Boolean).join('\n');
-}
+import { readFileSync } from 'node:fs';
+import { dirname, resolve } from 'node:path';
+import { fileURLToPath } from 'node:url';
+
+export type WorkspaceTargetKind = 'selected_project' | 'pixcode_app' | 'custom';
+
+export type ResolvedWorkspaceTarget = {
+  kind: WorkspaceTargetKind;
+  label: string;
+  projectPath: string;
+  selectedProjectPath?: string;
+  selectedProjectName?: string;
+  appRoot: string;
+};
+
+const pixcodePackageName = '@pixelbyte-software/pixcode';
+
+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 readTargetKind(value: unknown): WorkspaceTargetKind | undefined {
+  return value === 'selected_project' || value === 'pixcode_app' || value === 'custom'
+    ? value
+    : undefined;
+}
+
+export function findPixcodeAppRoot(): string {
+  let currentDir = dirname(fileURLToPath(import.meta.url));
+
+  for (let depth = 0; depth < 10; depth += 1) {
+    try {
+      const packagePath = resolve(currentDir, 'package.json');
+      const pkg = JSON.parse(readFileSync(packagePath, 'utf8')) as { name?: string };
+      if (pkg.name === pixcodePackageName) {
+        return currentDir;
+      }
+    } catch {
+      // Walk upward until the Pixcode package root is found.
+    }
+
+    const parent = dirname(currentDir);
+    if (parent === currentDir) break;
+    currentDir = parent;
+  }
+
+  return process.cwd();
+}
+
+export function resolveWorkflowWorkspace(metadata?: Record<string, unknown>): ResolvedWorkspaceTarget {
+  const target = readRecord(metadata?.workspaceTarget);
+  const appRoot = findPixcodeAppRoot();
+  const selectedProjectPath = readString(metadata?.selectedProjectPath) ?? readString(metadata?.projectPath);
+  const selectedProjectName = readString(metadata?.projectName) ?? readString(metadata?.projectId);
+  const kind = readTargetKind(target?.kind) ?? 'selected_project';
+  const customPath = readString(target?.projectPath);
+
+  if (kind === 'pixcode_app') {
+    return {
+      kind,
+      label: 'Pixcode app',
+      projectPath: appRoot,
+      selectedProjectPath,
+      selectedProjectName,
+      appRoot,
+    };
+  }
+
+  if (kind === 'custom') {
+    return {
+      kind,
+      label: readString(target?.label) ?? 'Custom workspace',
+      projectPath: customPath ?? selectedProjectPath ?? appRoot,
+      selectedProjectPath,
+      selectedProjectName,
+      appRoot,
+    };
+  }
+
+  return {
+    kind: 'selected_project',
+    label: selectedProjectName ?? 'Selected project',
+    projectPath: selectedProjectPath ?? appRoot,
+    selectedProjectPath,
+    selectedProjectName,
+    appRoot,
+  };
+}
+
+export function workspaceTargetMetadata(target: ResolvedWorkspaceTarget): Record<string, unknown> {
+  return {
+    kind: target.kind,
+    label: target.label,
+    projectPath: target.projectPath,
+    selectedProjectPath: target.selectedProjectPath,
+    selectedProjectName: target.selectedProjectName,
+    appRoot: target.appRoot,
+  };
+}
+
+export function workspaceContextPrompt(target: ResolvedWorkspaceTarget): string {
+  return [
+    'Pixcode orchestration execution context:',
+    `- Target workspace: ${target.label}`,
+    `- Working directory for this agent: ${target.projectPath}`,
+    target.selectedProjectName ? `- Selected UI project: ${target.selectedProjectName}` : '',
+    target.selectedProjectPath ? `- Selected UI project path: ${target.selectedProjectPath}` : '',
+    `- Pixcode app root: ${target.appRoot}`,
+    '',
+    'Rules:',
+    '- Treat the working directory above as the authoritative project/application for this task.',
+    '- Do not guess another repository path unless the user explicitly asks for it.',
+    '- Do not access parent directories, sibling projects, or broad external globs outside the working directory unless the user explicitly asks.',
+    '- If the user asks to analyze or modify Pixcode/orchestration itself, the target workspace must be the Pixcode app root.',
+    '- Before running package-manager commands, inspect the package files in the working directory.',
+    '- If a tool reports a permission denial, summarize the limitation and continue from the provided context instead of retrying the same external path.',
+  ].filter(Boolean).join('\n');
+}