@hilbras/omninode 0.3.0 → 0.4.0

package/dist/index.d.ts

@@ -1,5 +1,33 @@
 import { z } from 'zod';
 
+/** Structured report format so reports can be processed programmatically (§16). */
+type Confidence = "low" | "medium" | "high";
+type FindingSeverity = "info" | "low" | "medium" | "high" | "critical";
+interface Finding {
+    id: string;
+    title: string;
+    detail: string;
+    severity?: FindingSeverity;
+    evidence?: string[];
+    /** File path or conceptual location the finding refers to. */
+    location?: string;
+    tags?: string[];
+}
+interface Report {
+    id: string;
+    taskId: string;
+    /** Agent name from the agent registry. */
+    agent: string;
+    /** Model id used, if known. */
+    model?: string;
+    summary: string;
+    findings: Finding[];
+    recommendations: string[];
+    confidence?: Confidence;
+    createdAt: string;
+    metadata?: Record<string, unknown>;
+}
+
 /** Role system: what an AI is supposed to do, independent of any provider (§11). */
 interface RoleDefinition {
     /** Slug identifier, e.g. "architecture-reviewer". */
@@ -19,6 +47,8 @@ interface RoleDefinition {
 
 type AgentIntegrationType = "native" | "process" | "custom";
 type AgentStatus = "registered" | "ready" | "running" | "busy" | "stopped" | "error";
+/** How the task payload reaches a process agent (§9). */
+type AgentInputMode = "stdin" | "arg" | "protocol";
 interface AgentConfig {
     name: string;
     integration: AgentIntegrationType;
@@ -27,6 +57,10 @@ interface AgentConfig {
     args?: string[];
     cwd?: string;
     env?: Record<string, string>;
+    /** How the task is delivered: prompt on stdin, as last argument, or the §21 JSON-lines protocol. */
+    inputMode?: AgentInputMode;
+    /** Per-task timeout in milliseconds; the process is killed when exceeded. */
+    timeoutMs?: number;
     /** Models (as "provider:model-id") this agent may use, if restricted. */
     allowedModels?: string[];
     metadata?: Record<string, unknown>;
@@ -57,6 +91,8 @@ interface AgentTaskOutput {
     rawOutput?: string;
     exitCode?: number;
     logs?: string[];
+    /** Structured reports extracted from protocol-mode runs (§16, §21). */
+    reports?: Report[];
     error?: string;
 }
 /** Contract every agent adapter implements (Phase 3+). */
@@ -215,34 +251,6 @@ interface PipelineRun {
     stepRuns: PipelineStepRun[];
 }
 
-/** Structured report format so reports can be processed programmatically (§16). */
-type Confidence = "low" | "medium" | "high";
-type FindingSeverity = "info" | "low" | "medium" | "high" | "critical";
-interface Finding {
-    id: string;
-    title: string;
-    detail: string;
-    severity?: FindingSeverity;
-    evidence?: string[];
-    /** File path or conceptual location the finding refers to. */
-    location?: string;
-    tags?: string[];
-}
-interface Report {
-    id: string;
-    taskId: string;
-    /** Agent name from the agent registry. */
-    agent: string;
-    /** Model id used, if known. */
-    model?: string;
-    summary: string;
-    findings: Finding[];
-    recommendations: string[];
-    confidence?: Confidence;
-    createdAt: string;
-    metadata?: Record<string, unknown>;
-}
-
 /** Agent ↔ OmniNode communication protocol (§21). */
 
 interface EnvelopeMeta {
@@ -495,15 +503,19 @@ declare const agentConfigSchema: z.ZodObject<{
     args: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
     cwd: z.ZodOptional<z.ZodString>;
     env: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+    input_mode: z.ZodDefault<z.ZodEnum<["stdin", "arg", "protocol"]>>;
+    timeout_ms: z.ZodOptional<z.ZodNumber>;
     metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
 }, "strict", z.ZodTypeAny, {
     name: string;
     type: "native" | "process" | "cli";
+    input_mode: "stdin" | "arg" | "protocol";
     metadata?: Record<string, unknown> | undefined;
     command?: string | undefined;
     args?: string[] | undefined;
     cwd?: string | undefined;
     env?: Record<string, string> | undefined;
+    timeout_ms?: number | undefined;
 }, {
     name: string;
     type?: "native" | "process" | "cli" | undefined;
@@ -512,6 +524,8 @@ declare const agentConfigSchema: z.ZodObject<{
     args?: string[] | undefined;
     cwd?: string | undefined;
     env?: Record<string, string> | undefined;
+    input_mode?: "stdin" | "arg" | "protocol" | undefined;
+    timeout_ms?: number | undefined;
 }>;
 declare const roleConfigSchema: z.ZodObject<{
     id: z.ZodString;
@@ -576,15 +590,19 @@ declare const projectConfigSchema: z.ZodObject<{
         args: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
         cwd: z.ZodOptional<z.ZodString>;
         env: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+        input_mode: z.ZodDefault<z.ZodEnum<["stdin", "arg", "protocol"]>>;
+        timeout_ms: z.ZodOptional<z.ZodNumber>;
         metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
     }, "strict", z.ZodTypeAny, {
         name: string;
         type: "native" | "process" | "cli";
+        input_mode: "stdin" | "arg" | "protocol";
         metadata?: Record<string, unknown> | undefined;
         command?: string | undefined;
         args?: string[] | undefined;
         cwd?: string | undefined;
         env?: Record<string, string> | undefined;
+        timeout_ms?: number | undefined;
     }, {
         name: string;
         type?: "native" | "process" | "cli" | undefined;
@@ -593,6 +611,8 @@ declare const projectConfigSchema: z.ZodObject<{
         args?: string[] | undefined;
         cwd?: string | undefined;
         env?: Record<string, string> | undefined;
+        input_mode?: "stdin" | "arg" | "protocol" | undefined;
+        timeout_ms?: number | undefined;
     }>, "many">>;
     roles: z.ZodDefault<z.ZodArray<z.ZodObject<{
         id: z.ZodString;
@@ -643,11 +663,13 @@ declare const projectConfigSchema: z.ZodObject<{
     agents: {
         name: string;
         type: "native" | "process" | "cli";
+        input_mode: "stdin" | "arg" | "protocol";
         metadata?: Record<string, unknown> | undefined;
         command?: string | undefined;
         args?: string[] | undefined;
         cwd?: string | undefined;
         env?: Record<string, string> | undefined;
+        timeout_ms?: number | undefined;
     }[];
     roles: {
         name: string;
@@ -681,6 +703,8 @@ declare const projectConfigSchema: z.ZodObject<{
         args?: string[] | undefined;
         cwd?: string | undefined;
         env?: Record<string, string> | undefined;
+        input_mode?: "stdin" | "arg" | "protocol" | undefined;
+        timeout_ms?: number | undefined;
     }[] | undefined;
     roles?: {
         name: string;
@@ -732,15 +756,19 @@ declare const appConfigSchema: z.ZodObject<{
             args: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
             cwd: z.ZodOptional<z.ZodString>;
             env: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+            input_mode: z.ZodDefault<z.ZodEnum<["stdin", "arg", "protocol"]>>;
+            timeout_ms: z.ZodOptional<z.ZodNumber>;
             metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
         }, "strict", z.ZodTypeAny, {
             name: string;
             type: "native" | "process" | "cli";
+            input_mode: "stdin" | "arg" | "protocol";
             metadata?: Record<string, unknown> | undefined;
             command?: string | undefined;
             args?: string[] | undefined;
             cwd?: string | undefined;
             env?: Record<string, string> | undefined;
+            timeout_ms?: number | undefined;
         }, {
             name: string;
             type?: "native" | "process" | "cli" | undefined;
@@ -749,6 +777,8 @@ declare const appConfigSchema: z.ZodObject<{
             args?: string[] | undefined;
             cwd?: string | undefined;
             env?: Record<string, string> | undefined;
+            input_mode?: "stdin" | "arg" | "protocol" | undefined;
+            timeout_ms?: number | undefined;
         }>, "many">>;
         roles: z.ZodDefault<z.ZodArray<z.ZodObject<{
             id: z.ZodString;
@@ -799,11 +829,13 @@ declare const appConfigSchema: z.ZodObject<{
         agents: {
             name: string;
             type: "native" | "process" | "cli";
+            input_mode: "stdin" | "arg" | "protocol";
             metadata?: Record<string, unknown> | undefined;
             command?: string | undefined;
             args?: string[] | undefined;
             cwd?: string | undefined;
             env?: Record<string, string> | undefined;
+            timeout_ms?: number | undefined;
         }[];
         roles: {
             name: string;
@@ -837,6 +869,8 @@ declare const appConfigSchema: z.ZodObject<{
             args?: string[] | undefined;
             cwd?: string | undefined;
             env?: Record<string, string> | undefined;
+            input_mode?: "stdin" | "arg" | "protocol" | undefined;
+            timeout_ms?: number | undefined;
         }[] | undefined;
         roles?: {
             name: string;
@@ -855,9 +889,9 @@ declare const appConfigSchema: z.ZodObject<{
     logging: z.ZodOptional<z.ZodObject<{
         level: z.ZodEnum<["debug", "info", "warn", "error"]>;
     }, "strict", z.ZodTypeAny, {
-        level: "error" | "info" | "debug" | "warn";
+        level: "info" | "error" | "debug" | "warn";
     }, {
-        level: "error" | "info" | "debug" | "warn";
+        level: "info" | "error" | "debug" | "warn";
     }>>;
 }, "strict", z.ZodTypeAny, {
     project: {
@@ -874,11 +908,13 @@ declare const appConfigSchema: z.ZodObject<{
         agents: {
             name: string;
             type: "native" | "process" | "cli";
+            input_mode: "stdin" | "arg" | "protocol";
             metadata?: Record<string, unknown> | undefined;
             command?: string | undefined;
             args?: string[] | undefined;
             cwd?: string | undefined;
             env?: Record<string, string> | undefined;
+            timeout_ms?: number | undefined;
         }[];
         roles: {
             name: string;
@@ -895,7 +931,7 @@ declare const appConfigSchema: z.ZodObject<{
         } | undefined;
     };
     logging?: {
-        level: "error" | "info" | "debug" | "warn";
+        level: "info" | "error" | "debug" | "warn";
     } | undefined;
 }, {
     project: {
@@ -917,6 +953,8 @@ declare const appConfigSchema: z.ZodObject<{
             args?: string[] | undefined;
             cwd?: string | undefined;
             env?: Record<string, string> | undefined;
+            input_mode?: "stdin" | "arg" | "protocol" | undefined;
+            timeout_ms?: number | undefined;
         }[] | undefined;
         roles?: {
             name: string;
@@ -933,7 +971,7 @@ declare const appConfigSchema: z.ZodObject<{
         } | undefined;
     };
     logging?: {
-        level: "error" | "info" | "debug" | "warn";
+        level: "info" | "error" | "debug" | "warn";
     } | undefined;
 }>;
 type ProviderConfigYaml = z.infer<typeof providerConfigSchema>;
@@ -1048,6 +1086,30 @@ declare class OmniHilbrasProvider extends OpenAICompatibleProvider {
     connect(registry?: ModelRegistry): Promise<OmniHilbrasConnectionResult>;
 }
 
-declare const OMNINODE_VERSION = "0.3.0";
+declare function composeTaskText(input: AgentTaskInput): string;
+declare class ProcessAgent implements IAgent {
+    readonly config: AgentConfig;
+    readonly info: AgentInfo;
+    private readonly log;
+    private readonly running;
+    constructor(config: AgentConfig, log?: Logger);
+    run(input: AgentTaskInput): Promise<AgentTaskOutput>;
+    /** Ask the agent to stop current work (SIGTERM). */
+    cancel(taskId: string): Promise<void>;
+    runningTaskIds(): string[];
+}
+
+declare function createAgent(config: AgentConfig): IAgent;
+
+/** Agent registry (§10): the set of agents connected to OmniNode. */
+
+declare class AgentRegistry {
+    private readonly agents;
+    register(agent: IAgent): void;
+    get(name: string): IAgent | undefined;
+    list(): IAgent[];
+}
+
+declare const OMNINODE_VERSION = "0.4.0";
 
-export { type AgentConfig, type AgentConfigYaml, AgentError, type AgentInfo, type AgentIntegrationType, type AgentStatus, type AgentTaskInput, type AgentTaskOutput, type AgentToNodeMessage, type AppConfig, type AppConfigYaml, type ChatMessage, type ChatRequest, type ChatResponse, type ChatRole, type ChatUsage, type Confidence, ConfigError, ConsoleLogSink, type DiscoveryResult, type EnvelopeMeta, type Finding, type FindingSeverity, type HttpRequestOptions, type HttpResponse, type IAgent, type IChatProvider, type IMemoryProvider, type IProvider, type LoadConfigOptions, type LogLevel, type LogSink, Logger, type LoggerOptions, type MemoryEntry, MemoryError, type MemoryQuery, type MemoryScope, type MessageEnvelope, type ModelCapabilities, type ModelFilter, type ModelInfo, ModelRegistry, type ModelStatus, type NodeToAgentMessage, OMNINODE_VERSION, OPENAI_COMPATIBLE_TYPES, type OmniHilbrasConnectionResult, OmniHilbrasProvider, OmniNodeError, type OmniNodeErrorCode, type OmniNodeErrorOptions, OpenAICompatibleProvider, type PipelineDefinition, PipelineError, type PipelineRun, type PipelineRunStatus, type PipelineStep, type PipelineStepCondition, type PipelineStepKind, type PipelineStepRun, type Project, type ProjectConfigYaml, ProtocolError, type ProviderConfig, type ProviderConfigYaml, ProviderError, type ProviderHealth, type ProviderStatus, type ProviderType, type Report, type RoleConfigYaml, type RoleDefinition, type Task, type TaskContext, TaskError, type TaskResult, type TaskStatus, type WritableLike, agentConfigSchema, appConfigSchema, authHeaders, createProvider, defaultProjectConfigYaml, expandEnvRefs, findConfigFile, isOmniNodeError, loadConfig, logger, projectConfigSchema, providerConfigSchema, registryKey, requestJson, resolveApiKey, roleConfigSchema };
+export { type AgentConfig, type AgentConfigYaml, AgentError, type AgentInfo, type AgentInputMode, type AgentIntegrationType, AgentRegistry, type AgentStatus, type AgentTaskInput, type AgentTaskOutput, type AgentToNodeMessage, type AppConfig, type AppConfigYaml, type ChatMessage, type ChatRequest, type ChatResponse, type ChatRole, type ChatUsage, type Confidence, ConfigError, ConsoleLogSink, type DiscoveryResult, type EnvelopeMeta, type Finding, type FindingSeverity, type HttpRequestOptions, type HttpResponse, type IAgent, type IChatProvider, type IMemoryProvider, type IProvider, type LoadConfigOptions, type LogLevel, type LogSink, Logger, type LoggerOptions, type MemoryEntry, MemoryError, type MemoryQuery, type MemoryScope, type MessageEnvelope, type ModelCapabilities, type ModelFilter, type ModelInfo, ModelRegistry, type ModelStatus, type NodeToAgentMessage, OMNINODE_VERSION, OPENAI_COMPATIBLE_TYPES, type OmniHilbrasConnectionResult, OmniHilbrasProvider, OmniNodeError, type OmniNodeErrorCode, type OmniNodeErrorOptions, OpenAICompatibleProvider, type PipelineDefinition, PipelineError, type PipelineRun, type PipelineRunStatus, type PipelineStep, type PipelineStepCondition, type PipelineStepKind, type PipelineStepRun, ProcessAgent, type Project, type ProjectConfigYaml, ProtocolError, type ProviderConfig, type ProviderConfigYaml, ProviderError, type ProviderHealth, type ProviderStatus, type ProviderType, type Report, type RoleConfigYaml, type RoleDefinition, type Task, type TaskContext, TaskError, type TaskResult, type TaskStatus, type WritableLike, agentConfigSchema, appConfigSchema, authHeaders, composeTaskText, createAgent, createProvider, defaultProjectConfigYaml, expandEnvRefs, findConfigFile, isOmniNodeError, loadConfig, logger, projectConfigSchema, providerConfigSchema, registryKey, requestJson, resolveApiKey, roleConfigSchema };

package/dist/index.js

@@ -123,6 +123,8 @@ var agentConfigSchema = z.object({
   args: z.array(z.string()).optional(),
   cwd: z.string().optional(),
   env: z.record(z.string()).optional(),
+  input_mode: z.enum(["stdin", "arg", "protocol"]).default("stdin"),
+  timeout_ms: z.number().int().positive().optional(),
   metadata: z.record(z.unknown()).optional()
 }).strict();
 var roleConfigSchema = z.object({
@@ -234,6 +236,8 @@ function toAgentConfig(raw) {
     args: raw.args,
     cwd: raw.cwd,
     env: raw.env,
+    inputMode: raw.input_mode,
+    timeoutMs: raw.timeout_ms,
     metadata: raw.metadata
   };
 }
@@ -591,10 +595,290 @@ var ModelRegistry = class {
   }
 };
 
+// src/agents/process/index.ts
+import { spawn } from "child_process";
+var DEFAULT_TIMEOUT_MS2 = 6e5;
+var KILL_GRACE_MS = 5e3;
+function composeTaskText(input) {
+  const sections = [`# Objective
+${input.objective}`];
+  if (input.role) {
+    const lines = ["# Role", `${input.role.name} (${input.role.id})`];
+    if (input.role.responsibilities.length > 0) {
+      lines.push("", "Responsibilities:", ...input.role.responsibilities.map((r) => `- ${r}`));
+    }
+    if (input.role.expectedOutputs.length > 0) {
+      lines.push("", "Expected outputs:", ...input.role.expectedOutputs.map((o) => `- ${o}`));
+    }
+    sections.push(lines.join("\n"));
+  }
+  if (input.context) sections.push(`# Context
+${input.context}`);
+  if (input.instruction) sections.push(`# Instruction
+${input.instruction}`);
+  return sections.join("\n\n");
+}
+function buildProtocolMessages(input, agentName) {
+  const meta = {
+    taskId: input.taskId,
+    agent: agentName,
+    timestamp: (/* @__PURE__ */ new Date()).toISOString()
+  };
+  const messages = [
+    { type: "TASK", payload: { taskId: input.taskId, objective: input.objective } }
+  ];
+  if (input.role) messages.push({ type: "ROLE", payload: input.role });
+  if (input.context) messages.push({ type: "CONTEXT", payload: { body: input.context } });
+  if (input.instruction) messages.push({ type: "INSTRUCTION", payload: { text: input.instruction } });
+  return messages.map((message) => JSON.stringify({ meta, message }));
+}
+var ProcessAgent = class {
+  config;
+  info;
+  log;
+  running = /* @__PURE__ */ new Map();
+  constructor(config, log = logger) {
+    if (!config.command) {
+      throw new AgentError("AGENT_NOT_FOUND", `Agent "${config.name}" has no command configured.`);
+    }
+    this.config = config;
+    this.log = log.child({ agent: config.name });
+    this.info = {
+      name: config.name,
+      integration: "process",
+      command: config.command,
+      cwd: config.cwd,
+      status: "ready",
+      capabilities: [config.inputMode ?? "stdin"]
+    };
+  }
+  async run(input) {
+    const command = this.config.command;
+    if (!command) {
+      throw new AgentError("AGENT_NOT_FOUND", `Agent "${this.config.name}" has no command configured.`);
+    }
+    const mode = this.config.inputMode ?? "stdin";
+    const timeoutMs = this.config.timeoutMs ?? DEFAULT_TIMEOUT_MS2;
+    return new Promise((resolve, reject) => {
+      const child = spawn(
+        command,
+        [...this.config.args ?? [], ...mode === "arg" ? [composeTaskText(input)] : []],
+        {
+          cwd: this.config.cwd,
+          env: { ...process.env, ...this.config.env },
+          stdio: ["pipe", "pipe", "pipe"]
+        }
+      );
+      this.running.set(input.taskId, child);
+      let stdout = "";
+      let stderr = "";
+      let timedOut = false;
+      let settled = false;
+      const timer = setTimeout(() => {
+        timedOut = true;
+        this.log.warn(`Task ${input.taskId} exceeded ${timeoutMs}ms \u2014 killing process.`);
+        child.kill("SIGTERM");
+        setTimeout(() => child.kill("SIGKILL"), KILL_GRACE_MS).unref();
+      }, timeoutMs);
+      const settle = (finish) => {
+        if (settled) return;
+        settled = true;
+        clearTimeout(timer);
+        this.running.delete(input.taskId);
+        finish();
+      };
+      child.stdout?.on("data", (chunk) => {
+        stdout += chunk.toString();
+      });
+      child.stderr?.on("data", (chunk) => {
+        stderr += chunk.toString();
+      });
+      child.stdin?.on("error", () => {
+      });
+      if (mode !== "arg") {
+        const payload = mode === "protocol" ? buildProtocolMessages(input, this.config.name).join("\n") + "\n" : composeTaskText(input) + "\n";
+        child.stdin?.write(payload);
+        child.stdin?.end();
+      }
+      child.on("error", (error) => {
+        settle(() => {
+          if (error.code === "ENOENT") {
+            reject(
+              new AgentError(
+                "AGENT_NOT_FOUND",
+                `Agent "${this.config.name}": command "${command}" was not found. Is it installed and on PATH?`,
+                { cause: error }
+              )
+            );
+            return;
+          }
+          reject(
+            new AgentError("AGENT_FAILED", `Agent "${this.config.name}" failed to start: ${error.message}.`, {
+              cause: error
+            })
+          );
+        });
+      });
+      child.on("close", (code, signal) => {
+        settle(() => {
+          if (timedOut) {
+            reject(
+              new AgentError(
+                "AGENT_TIMEOUT",
+                `Agent "${this.config.name}" timed out after ${timeoutMs}ms and was killed.`,
+                { details: { taskId: input.taskId, stdout: stdout.slice(0, 4e3), stderr: stderr.slice(0, 2e3) } }
+              )
+            );
+            return;
+          }
+          const logs = stderr.trim().length > 0 ? stderr.split("\n") : void 0;
+          if (mode === "protocol") {
+            try {
+              resolve(
+                interpretProtocolRun({
+                  input,
+                  agentName: this.config.name,
+                  stdout,
+                  exitCode: code,
+                  logs
+                })
+              );
+            } catch (error) {
+              reject(error);
+            }
+            return;
+          }
+          const trimmed = stdout.trim();
+          resolve({
+            taskId: input.taskId,
+            status: code === 0 ? "completed" : "failed",
+            summary: trimmed.length > 0 ? firstLine(trimmed) : void 0,
+            rawOutput: trimmed.length > 0 ? trimmed : void 0,
+            exitCode: code ?? void 0,
+            logs,
+            error: code === 0 ? void 0 : `Process exited with code ${code ?? "unknown"}${signal ? ` (signal: ${signal})` : ""}`
+          });
+        });
+      });
+    });
+  }
+  /** Ask the agent to stop current work (SIGTERM). */
+  async cancel(taskId) {
+    const child = this.running.get(taskId);
+    if (child) child.kill("SIGTERM");
+  }
+  runningTaskIds() {
+    return [...this.running.keys()];
+  }
+};
+function interpretProtocolRun({ input, agentName, stdout, exitCode, logs }) {
+  const reports = [];
+  let summary;
+  let error;
+  let sawProtocolMessage = false;
+  for (const line of stdout.split("\n")) {
+    const trimmed2 = line.trim();
+    if (trimmed2.length === 0) continue;
+    const message = parseAgentMessage(trimmed2);
+    if (!message) continue;
+    sawProtocolMessage = true;
+    if (message.type === "REPORT") {
+      const report = normalizeReport(message.payload, input.taskId, agentName, reports.length);
+      if (report) reports.push(report);
+    } else if (message.type === "COMPLETION") {
+      const payload = message.payload;
+      if (typeof payload?.summary === "string") summary = payload.summary;
+    } else if (message.type === "ERROR") {
+      const payload = message.payload;
+      const detail = typeof payload?.message === "string" ? payload.message : "unknown error";
+      const code = typeof payload?.code === "string" ? ` [${payload.code}]` : "";
+      error = `Agent error${code}: ${detail}`;
+    }
+  }
+  if (!sawProtocolMessage && exitCode === 0) {
+    throw new ProtocolError(
+      `Agent "${agentName}" produced no protocol messages on stdout (input mode "protocol").`,
+      { details: { taskId: input.taskId, stdout: stdout.slice(0, 2e3) } }
+    );
+  }
+  const trimmed = stdout.trim();
+  return {
+    taskId: input.taskId,
+    status: error !== void 0 || exitCode !== 0 ? "failed" : "completed",
+    summary: summary ?? reports[0]?.summary,
+    rawOutput: trimmed.length > 0 ? trimmed : void 0,
+    exitCode: exitCode ?? void 0,
+    logs,
+    reports: reports.length > 0 ? reports : void 0,
+    error: error ?? (exitCode !== 0 ? `Process exited with code ${exitCode ?? "unknown"}` : void 0)
+  };
+}
+function parseAgentMessage(line) {
+  try {
+    const parsed = JSON.parse(line);
+    if (typeof parsed.type === "string") {
+      return { type: parsed.type, payload: parsed.payload };
+    }
+    const inner = parsed.message;
+    if (inner && typeof inner.type === "string") {
+      return { type: inner.type, payload: inner.payload };
+    }
+  } catch {
+  }
+  return void 0;
+}
+function normalizeReport(payload, taskId, agentName, index) {
+  if (payload === null || typeof payload !== "object") return void 0;
+  const raw = payload;
+  if (typeof raw.summary !== "string") return void 0;
+  return {
+    id: typeof raw.id === "string" ? raw.id : `${taskId}-report-${index}`,
+    taskId: typeof raw.taskId === "string" ? raw.taskId : taskId,
+    agent: typeof raw.agent === "string" ? raw.agent : agentName,
+    summary: raw.summary,
+    findings: Array.isArray(raw.findings) ? raw.findings : [],
+    recommendations: Array.isArray(raw.recommendations) ? raw.recommendations : [],
+    createdAt: typeof raw.createdAt === "string" ? raw.createdAt : (/* @__PURE__ */ new Date()).toISOString()
+  };
+}
+function firstLine(text, maxLength = 200) {
+  const line = text.split("\n", 1)[0] ?? text;
+  return line.length > maxLength ? `${line.slice(0, maxLength)}\u2026` : line;
+}
+
+// src/agents/factory.ts
+function createAgent(config) {
+  if (config.integration === "process") {
+    return new ProcessAgent(config);
+  }
+  if (config.integration === "native") {
+    throw new OmniNodeError(
+      "NOT_IMPLEMENTED",
+      `Native agent adapters are planned for a later phase. Use input over stdin/stdout (type "cli") for "${config.name}" for now.`
+    );
+  }
+  throw new OmniNodeError("NOT_IMPLEMENTED", `Agent integration "${config.integration}" has no adapter yet.`);
+}
+
+// src/agents/registry.ts
+var AgentRegistry = class {
+  agents = /* @__PURE__ */ new Map();
+  register(agent) {
+    this.agents.set(agent.info.name, agent);
+  }
+  get(name) {
+    return this.agents.get(name);
+  }
+  list() {
+    return [...this.agents.values()].sort((a, b) => a.info.name.localeCompare(b.info.name));
+  }
+};
+
 // src/version.ts
-var OMNINODE_VERSION = "0.3.0";
+var OMNINODE_VERSION = "0.4.0";
 export {
   AgentError,
+  AgentRegistry,
   ConfigError,
   ConsoleLogSink,
   Logger,
@@ -606,12 +890,15 @@ export {
   OmniNodeError,
   OpenAICompatibleProvider,
   PipelineError,
+  ProcessAgent,
   ProtocolError,
   ProviderError,
   TaskError,
   agentConfigSchema,
   appConfigSchema,
   authHeaders,
+  composeTaskText,
+  createAgent,
   createProvider,
   defaultProjectConfigYaml,
   expandEnvRefs,