pi-factory-gate 1.0.0

package/src/tools/workflows.ts

@@ -0,0 +1,130 @@
+import { Type } from "typebox";
+import type { ExtensionContext } from "@earendil-works/pi-coding-agent";
+import { loadConfig } from "../config";
+import { factoryApi } from "../helpers";
+import type { WorkflowInfo } from "../types";
+
+// ─── List Workflows ────────────────────────────────────────────────────────────
+
+export const listWorkflowsTool = {
+  name: "factory_list_workflows" as const,
+  label: "List Workflow Templates",
+  description:
+    "List available workflow templates in the factory. Workflows are predefined chains of agent jobs.",
+  parameters: Type.Object({}),
+  async execute(_id: string, _p: any, _s: any, _u: any, ctx: ExtensionContext) {
+    const config = loadConfig(ctx.cwd);
+
+    // Try the workflow-templates endpoint first (DB-backed), then fall back to discovery
+    const r = await factoryApi<{ templates?: Array<{ name: string; title: string; description?: string }> }>(
+      config,
+      "/workflows/templates",
+    );
+
+    if (r.ok && r.data?.templates && r.data.templates.length > 0) {
+      const templates = r.data.templates;
+      const lines = [
+        `📋 Workflow Templates (${templates.length})`,
+        "",
+      ];
+      for (const t of templates) {
+        lines.push(`   📝 ${t.title || t.name}`);
+        lines.push(`        id: ${t.name}`);
+        if (t.description) lines.push(`        ${t.description.slice(0, 120)}`);
+      }
+      return {
+        content: [{ type: "text", text: lines.join("\n") }],
+        details: { count: templates.length, source: "templates" },
+      };
+    }
+
+    // Fall back to workflow discovery (disk-based .md files)
+    const r2 = await factoryApi<{ workflows: WorkflowInfo[] }>(config, "/workflows");
+
+    if (!r2.ok || !r2.data) {
+      return {
+        content: [{ type: "text", text: `❌ Failed to list workflows: ${r2.error || "unknown"}` }],
+        isError: true,
+        details: {},
+      };
+    }
+
+    const workflows = r2.data.workflows || [];
+    if (workflows.length === 0) {
+      return {
+        content: [{ type: "text", text: "No workflow templates found." }],
+        details: { count: 0 },
+      };
+    }
+
+    const lines = [`📋 Workflow Templates (${workflows.length})`, ""];
+    for (const w of workflows) {
+      lines.push(`   📝 ${w.name}`);
+      lines.push(`        path: ${w.path}`);
+      if (w.description) lines.push(`        ${w.description.slice(0, 120)}`);
+    }
+
+    return {
+      content: [{ type: "text", text: lines.join("\n") }],
+      details: { count: workflows.length, source: "discovery" },
+    };
+  },
+};
+
+// ─── Run Workflow ──────────────────────────────────────────────────────────────
+
+export const runWorkflowTool = {
+  name: "factory_run_workflow" as const,
+  label: "Run Workflow Template",
+  description:
+    "Execute a workflow template on the factory. This creates a job that runs the workflow steps.",
+  parameters: Type.Object({
+    template: Type.String({ description: "Workflow template name or ID to run" }),
+    environment: Type.Optional(Type.String({ description: "Named environment to run in" })),
+    repo: Type.Optional(Type.String({ description: "Direct repo URL (overrides environment)" })),
+    branch: Type.Optional(Type.String({ description: "Branch to run on (default: main)" })),
+    confirm: Type.Optional(Type.Boolean({ description: "Must be true to confirm execution" })),
+  }),
+  async execute(_id: string, params: any, _s: any, _u: any, ctx: ExtensionContext) {
+    const config = loadConfig(ctx.cwd);
+
+    // Try the new workflow-scheduler endpoint first: POST /workflows/run with template+params
+    const body: Record<string, unknown> = { template: params.template };
+    if (params.environment) body.environment = params.environment;
+    if (params.repo) body.repo = params.repo;
+    if (params.branch) body.branch = params.branch;
+
+    const r = await factoryApi<{ jobId: string; workflow?: string; status: string }>(
+      config,
+      "/workflows/run",
+      "POST",
+      body,
+    );
+
+    if (!r.ok) {
+      return {
+        content: [{ type: "text", text: `❌ Failed to run workflow: ${r.error || "unknown"}` }],
+        isError: true,
+        details: {},
+      };
+    }
+
+    const { jobId, status: jobStatus } = r.data!;
+    return {
+      content: [
+        {
+          type: "text",
+          text: [
+            `🔄 Workflow "${params.template}" started`,
+            `   Job ID: ${jobId}`,
+            `   Status: ${jobStatus}`,
+            "",
+            `Track progress: factory_get_job(id="${jobId}")`,
+            `Stream output:   factory_stream_job(id="${jobId}")`,
+          ].join("\n"),
+        },
+      ],
+      details: { jobId, workflow: params.template, status: jobStatus },
+    };
+  },
+};

package/src/types.ts

@@ -0,0 +1,120 @@
+/**
+ * pi-factory-gate — Types
+ *
+ * Shared types for factory-gate configuration and API responses.
+ */
+
+// ── Factory Config ────────────────────────────────────────────────────────────
+
+export interface FactoryConfig {
+  /** Base URL of the wrok.in orchestrator (e.g. http://orchestrator:3001) */
+  orchestratorUrl: string;
+  /** Default environment name for job dispatch when none specified */
+  defaultEnvironment?: string;
+  /** Default page limit for list operations */
+  defaultLimit: number;
+  /** Timeout in ms for API calls */
+  requestTimeout: number;
+  /** Max lines for job log output */
+  maxLogLines: number;
+}
+
+export const DEFAULT_CONFIG: FactoryConfig = {
+  orchestratorUrl: "http://localhost:3001",
+  defaultLimit: 20,
+  requestTimeout: 15000,
+  maxLogLines: 500,
+};
+
+// ── API Response Types ────────────────────────────────────────────────────────
+
+export interface AgentInfo {
+  name: string;
+  description: string;
+  tools: string[];
+  model: string;
+  systemPrompt?: string;
+  enabled: boolean;
+  source: "user" | "project" | "env";
+  resolvedFrom?: string;
+  isOverride?: boolean;
+  extends?: string;
+}
+
+export interface AgentDetail extends AgentInfo {
+  resolvedFrom: string;
+  isOverride: boolean;
+  extends?: string;
+}
+
+export interface JobInfo {
+  id: string;
+  task: {
+    mode: "single" | "parallel" | "chain";
+    agent?: string;
+    task?: string;
+    steps?: Array<{ agent: string; task: string }>;
+    tasks?: Array<{ agent: string; task: string }>;
+  };
+  status: "pending" | "running" | "completed" | "failed" | "partial";
+  createdAt: number;
+  startedAt?: number;
+  completedAt?: number;
+  result?: unknown;
+  workerId?: string;
+  environment?: string;
+  workflowName?: string;
+  repo?: string;
+  branch?: string;
+}
+
+export interface EnvironmentInfo {
+  name: string;
+  repo: string;
+  baseBranch: string;
+  currentBranch?: string;
+  featureBranch?: string;
+  status: "empty" | "cloning" | "ready" | "error";
+  lastCommit?: string;
+  error?: string;
+  description?: string;
+  createdAt: number;
+}
+
+export interface WorkerInfo {
+  id: string;
+  host: string;
+  port: number;
+  status: "idle" | "busy" | "offline";
+  currentJobId?: string;
+  completedJobs: number;
+  lastHeartbeat: number;
+  environment?: string;
+}
+
+export interface WorkflowInfo {
+  name: string;
+  path: string;
+  description?: string;
+}
+
+export interface SystemEvent {
+  id: string;
+  ts: number;
+  type: string;
+  message: string;
+  details?: string;
+}
+
+export interface FactoryStatus {
+  service: string;
+  id: string;
+  status: string;
+}
+
+// ── Job Streaming ─────────────────────────────────────────────────────────────
+
+export interface StreamEvent {
+  job?: JobInfo;
+  error?: string;
+}