@hilbras/omninode 0.4.0 → 0.5.0

package/dist/index.d.ts

@@ -184,6 +184,7 @@ interface ModelInfo {
 }
 
 /** Task system: every operation becomes a Task (§13). */
+
 type TaskStatus = "created" | "queued" | "running" | "waiting" | "completed" | "failed" | "cancelled";
 interface TaskContext {
     project?: string;
@@ -198,6 +199,8 @@ interface TaskResult {
     summary?: string;
     artifacts?: string[];
     reportId?: string;
+    /** Structured reports produced by protocol-mode agents (Phase 6 builds on this). */
+    reports?: Report[];
     error?: string;
     finishedAt?: string;
 }
@@ -397,7 +400,7 @@ interface IChatProvider extends IProvider {
 }
 
 /** Typed error hierarchy shared across the whole codebase (§4.1 — error model). */
-type OmniNodeErrorCode = "CONFIG_NOT_FOUND" | "CONFIG_INVALID" | "PROVIDER_NOT_FOUND" | "PROVIDER_UNAVAILABLE" | "PROVIDER_AUTH_FAILED" | "MODEL_NOT_FOUND" | "AGENT_NOT_FOUND" | "AGENT_FAILED" | "AGENT_TIMEOUT" | "TASK_INVALID" | "TASK_FAILED" | "PIPELINE_INVALID" | "PIPELINE_FAILED" | "PROTOCOL_VIOLATION" | "MEMORY_UNAVAILABLE" | "NOT_IMPLEMENTED" | "CLI_USAGE" | "INTERNAL";
+type OmniNodeErrorCode = "CONFIG_NOT_FOUND" | "CONFIG_INVALID" | "PROVIDER_NOT_FOUND" | "PROVIDER_UNAVAILABLE" | "PROVIDER_AUTH_FAILED" | "MODEL_NOT_FOUND" | "AGENT_NOT_FOUND" | "AGENT_FAILED" | "AGENT_TIMEOUT" | "TASK_INVALID" | "TASK_NOT_FOUND" | "TASK_FAILED" | "PIPELINE_INVALID" | "PIPELINE_FAILED" | "PROTOCOL_VIOLATION" | "MEMORY_UNAVAILABLE" | "NOT_IMPLEMENTED" | "CLI_USAGE" | "INTERNAL";
 interface OmniNodeErrorOptions {
     cause?: unknown;
     details?: Record<string, unknown>;
@@ -417,7 +420,7 @@ declare class AgentError extends OmniNodeError {
     constructor(code: "AGENT_NOT_FOUND" | "AGENT_FAILED" | "AGENT_TIMEOUT", message: string, options?: OmniNodeErrorOptions);
 }
 declare class TaskError extends OmniNodeError {
-    constructor(code: "TASK_INVALID" | "TASK_FAILED", message: string, options?: OmniNodeErrorOptions);
+    constructor(code: "TASK_INVALID" | "TASK_NOT_FOUND" | "TASK_FAILED", message: string, options?: OmniNodeErrorOptions);
 }
 declare class PipelineError extends OmniNodeError {
     constructor(code: "PIPELINE_INVALID" | "PIPELINE_FAILED", message: string, options?: OmniNodeErrorOptions);
@@ -1099,8 +1102,6 @@ declare class ProcessAgent implements IAgent {
     runningTaskIds(): string[];
 }
 
-declare function createAgent(config: AgentConfig): IAgent;
-
 /** Agent registry (§10): the set of agents connected to OmniNode. */
 
 declare class AgentRegistry {
@@ -1110,6 +1111,79 @@ declare class AgentRegistry {
     list(): IAgent[];
 }
 
+/**
+ * Agent factory (§9–§10): builds adapter instances from configuration.
+ * "cli" agent configs are mapped to the process integration by the loader.
+ */
+
+declare function createAgent(config: AgentConfig): IAgent;
+/** Builds an agent registry from the project configuration, skipping agents that fail to construct. */
+declare function buildAgentRegistry(config: AppConfig, log?: Logger): AgentRegistry;
+
+/** Role registry (§11): the set of roles available for task assignment. */
+
+declare class RoleRegistry {
+    private readonly roles;
+    register(role: RoleDefinition): void;
+    registerAll(roles: RoleDefinition[]): void;
+    get(id: string): RoleDefinition | undefined;
+    list(): RoleDefinition[];
+}
+/** Builds a role registry from the project configuration. */
+declare function buildRoleRegistry(config: AppConfig): RoleRegistry;
+
+interface TaskStoreFilter {
+    status?: TaskStatus;
+    project?: string;
+}
+interface TaskStore {
+    save(task: Task): Promise<void>;
+    get(id: string): Promise<Task | undefined>;
+    list(filter?: TaskStoreFilter): Promise<Task[]>;
+}
+declare class FileTaskStore implements TaskStore {
+    private readonly filePath;
+    constructor(directory?: string);
+    save(task: Task): Promise<void>;
+    get(id: string): Promise<Task | undefined>;
+    list(filter?: TaskStoreFilter): Promise<Task[]>;
+    private load;
+    private write;
+}
+
+interface CreateTaskInput {
+    objective: string;
+    project?: string;
+    role?: string;
+    agent?: string;
+    context?: TaskContext;
+}
+interface TaskEngineOptions {
+    agents: AgentRegistry;
+    roles: RoleRegistry;
+    store: TaskStore;
+    log?: Logger;
+}
+declare class TaskEngine {
+    private readonly options;
+    private readonly log;
+    constructor(options: TaskEngineOptions);
+    get store(): TaskStore;
+    create(input: CreateTaskInput): Promise<Task>;
+    queue(id: string): Promise<Task>;
+    /** Runs the task through its assigned agent and records the result. */
+    run(id: string): Promise<Task>;
+    cancel(id: string): Promise<Task>;
+    get(id: string): Promise<Task | undefined>;
+    list(filter?: TaskStoreFilter): Promise<Task[]>;
+    private mustGet;
+    private transition;
+}
+
+/** Assembles a TaskEngine from the project configuration (local-first defaults). */
+
+declare function createTaskEngine(config: AppConfig, log?: Logger, directory?: string): TaskEngine;
+
 declare const OMNINODE_VERSION = "0.4.0";
 
-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 };
+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 CreateTaskInput, type DiscoveryResult, type EnvelopeMeta, FileTaskStore, 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, RoleRegistry, type Task, type TaskContext, TaskEngine, type TaskEngineOptions, TaskError, type TaskResult, type TaskStatus, type TaskStore, type TaskStoreFilter, type WritableLike, agentConfigSchema, appConfigSchema, authHeaders, buildAgentRegistry, buildRoleRegistry, composeTaskText, createAgent, createProvider, createTaskEngine, defaultProjectConfigYaml, expandEnvRefs, findConfigFile, isOmniNodeError, loadConfig, logger, projectConfigSchema, providerConfigSchema, registryKey, requestJson, resolveApiKey, roleConfigSchema };

package/dist/index.js

@@ -846,6 +846,20 @@ function firstLine(text, maxLength = 200) {
   return line.length > maxLength ? `${line.slice(0, maxLength)}\u2026` : line;
 }
 
+// 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/agents/factory.ts
 function createAgent(config) {
   if (config.integration === "process") {
@@ -859,20 +873,233 @@ function createAgent(config) {
   }
   throw new OmniNodeError("NOT_IMPLEMENTED", `Agent integration "${config.integration}" has no adapter yet.`);
 }
+function buildAgentRegistry(config, log = logger) {
+  const registry = new AgentRegistry();
+  for (const agentConfig of config.project.agents) {
+    try {
+      registry.register(createAgent(agentConfig));
+    } catch (error) {
+      log.warn(
+        `Skipping agent "${agentConfig.name}": ${error instanceof Error ? error.message : String(error)}`
+      );
+    }
+  }
+  return registry;
+}
 
-// src/agents/registry.ts
-var AgentRegistry = class {
-  agents = /* @__PURE__ */ new Map();
-  register(agent) {
-    this.agents.set(agent.info.name, agent);
+// src/roles/index.ts
+var RoleRegistry = class {
+  roles = /* @__PURE__ */ new Map();
+  register(role) {
+    this.roles.set(role.id, role);
   }
-  get(name) {
-    return this.agents.get(name);
+  registerAll(roles) {
+    for (const role of roles) this.register(role);
+  }
+  get(id) {
+    return this.roles.get(id);
   }
   list() {
-    return [...this.agents.values()].sort((a, b) => a.info.name.localeCompare(b.info.name));
+    return [...this.roles.values()].sort((a, b) => a.id.localeCompare(b.id));
+  }
+};
+function buildRoleRegistry(config) {
+  const registry = new RoleRegistry();
+  registry.registerAll(config.project.roles);
+  return registry;
+}
+
+// src/tasks/store.ts
+import { mkdir, readFile, rename, writeFile } from "fs/promises";
+import { dirname } from "path";
+var FileTaskStore = class {
+  filePath;
+  constructor(directory = `${process.cwd()}/.omninode`) {
+    this.filePath = `${directory}/tasks.json`;
+  }
+  async save(task) {
+    const tasks = await this.load();
+    const index = tasks.findIndex((t) => t.id === task.id);
+    if (index >= 0) tasks[index] = task;
+    else tasks.push(task);
+    await this.write(tasks);
+  }
+  async get(id) {
+    const tasks = await this.load();
+    return tasks.find((t) => t.id === id);
+  }
+  async list(filter = {}) {
+    const tasks = await this.load();
+    return tasks.filter((task) => filter.status ? task.status === filter.status : true).filter((task) => filter.project ? task.project === filter.project : true).sort((a, b) => a.createdAt.localeCompare(b.createdAt));
+  }
+  async load() {
+    try {
+      const raw = await readFile(this.filePath, "utf8");
+      const parsed = JSON.parse(raw);
+      return Array.isArray(parsed) ? parsed : [];
+    } catch {
+      return [];
+    }
   }
+  async write(tasks) {
+    const tmp = `${this.filePath}.tmp`;
+    await mkdir(dirname(this.filePath), { recursive: true });
+    await writeFile(tmp, `${JSON.stringify(tasks, null, 2)}
+`, "utf8");
+    await rename(tmp, this.filePath);
+  }
+};
+
+// src/tasks/engine.ts
+import { randomBytes } from "crypto";
+var ALLOWED_TRANSITIONS = {
+  created: ["queued", "running", "cancelled"],
+  queued: ["running", "cancelled"],
+  running: ["completed", "failed", "cancelled"],
+  waiting: ["running", "cancelled"],
+  completed: [],
+  failed: [],
+  cancelled: []
 };
+var TaskEngine = class {
+  constructor(options) {
+    this.options = options;
+    this.log = (options.log ?? logger).child({ component: "tasks" });
+  }
+  options;
+  log;
+  get store() {
+    return this.options.store;
+  }
+  async create(input) {
+    if (!input.objective || input.objective.trim().length === 0) {
+      throw new TaskError("TASK_INVALID", "Task objective must not be empty.");
+    }
+    if (input.role && !this.options.roles.get(input.role)) {
+      throw new TaskError(
+        "TASK_INVALID",
+        `Role "${input.role}" is not defined. Add it under project.roles in omninode.yaml.`
+      );
+    }
+    if (input.agent && !this.options.agents.get(input.agent)) {
+      throw new TaskError(
+        "TASK_INVALID",
+        `Agent "${input.agent}" is not registered. Add it with \`omninode agent add\`.`
+      );
+    }
+    const now = (/* @__PURE__ */ new Date()).toISOString();
+    const task = {
+      id: generateTaskId(),
+      objective: input.objective.trim(),
+      status: "created",
+      createdAt: now,
+      updatedAt: now,
+      ...input.project !== void 0 ? { project: input.project } : {},
+      ...input.role !== void 0 ? { role: input.role } : {},
+      ...input.agent !== void 0 ? { agent: input.agent } : {},
+      ...input.context !== void 0 ? { context: input.context } : {}
+    };
+    await this.options.store.save(task);
+    this.log.info(`Created task ${task.id}.`);
+    return task;
+  }
+  async queue(id) {
+    const task = await this.mustGet(id);
+    return this.transition(task, "queued");
+  }
+  /** Runs the task through its assigned agent and records the result. */
+  async run(id) {
+    const task = await this.mustGet(id);
+    if (task.status !== "created" && task.status !== "queued") {
+      throw new TaskError("TASK_INVALID", `Task ${id} is "${task.status}" and cannot be run.`);
+    }
+    if (!task.agent) {
+      throw new TaskError("TASK_INVALID", `Task ${id} has no agent assigned. Re-create it with --agent.`);
+    }
+    const agent = this.options.agents.get(task.agent);
+    if (!agent) {
+      throw new TaskError("TASK_INVALID", `Agent "${task.agent}" is not registered anymore.`);
+    }
+    const role = task.role ? this.options.roles.get(task.role) : void 0;
+    const running = await this.transition(task, "running");
+    this.log.info(`Running task ${task.id} on agent "${task.agent}".`);
+    let output;
+    try {
+      output = await agent.run({
+        taskId: running.id,
+        objective: running.objective,
+        ...role ? { role } : {},
+        ...running.context?.background ? { context: running.context.background } : {}
+      });
+    } catch (error) {
+      const message = error instanceof Error ? error.message : String(error);
+      this.log.error(`Task ${task.id} failed: ${message}`);
+      return this.transition(running, "failed", {
+        result: { error: message, finishedAt: (/* @__PURE__ */ new Date()).toISOString() }
+      });
+    }
+    const result = {
+      ...output.summary !== void 0 ? { summary: output.summary } : {},
+      ...output.reports !== void 0 && output.reports.length > 0 ? { reports: output.reports } : {},
+      ...output.error !== void 0 ? { error: output.error } : {},
+      finishedAt: (/* @__PURE__ */ new Date()).toISOString()
+    };
+    const finalStatus = output.status === "completed" ? "completed" : "failed";
+    this.log.info(`Task ${task.id} finished: ${finalStatus}.`);
+    return this.transition(running, finalStatus, { result });
+  }
+  async cancel(id) {
+    const task = await this.mustGet(id);
+    if (!ALLOWED_TRANSITIONS[task.status].includes("cancelled")) {
+      throw new TaskError("TASK_INVALID", `Task ${id} is "${task.status}" and cannot be cancelled.`);
+    }
+    if (task.agent) {
+      const agent = this.options.agents.get(task.agent);
+      await agent?.cancel?.(task.id);
+    }
+    return this.transition(task, "cancelled");
+  }
+  async get(id) {
+    return this.options.store.get(id);
+  }
+  async list(filter) {
+    return this.options.store.list(filter);
+  }
+  async mustGet(id) {
+    const task = await this.options.store.get(id);
+    if (!task) {
+      throw new TaskError("TASK_NOT_FOUND", `Task "${id}" does not exist in this project's task store.`);
+    }
+    return task;
+  }
+  async transition(task, to, extra = {}) {
+    const allowed = ALLOWED_TRANSITIONS[task.status] ?? [];
+    if (!allowed.includes(to)) {
+      throw new TaskError("TASK_INVALID", `Task ${task.id} cannot move from "${task.status}" to "${to}".`);
+    }
+    const updated = {
+      ...task,
+      status: to,
+      updatedAt: (/* @__PURE__ */ new Date()).toISOString(),
+      ...extra.result !== void 0 ? { result: { ...task.result, ...extra.result } } : {}
+    };
+    await this.options.store.save(updated);
+    return updated;
+  }
+};
+function generateTaskId() {
+  return `task-${Date.now().toString(36)}-${randomBytes(3).toString("hex")}`;
+}
+
+// src/tasks/engine-factory.ts
+function createTaskEngine(config, log = logger, directory) {
+  return new TaskEngine({
+    agents: buildAgentRegistry(config, log),
+    roles: buildRoleRegistry(config),
+    store: new FileTaskStore(directory),
+    log
+  });
+}
 
 // src/version.ts
 var OMNINODE_VERSION = "0.4.0";
@@ -881,6 +1108,7 @@ export {
   AgentRegistry,
   ConfigError,
   ConsoleLogSink,
+  FileTaskStore,
   Logger,
   MemoryError,
   ModelRegistry,
@@ -893,13 +1121,18 @@ export {
   ProcessAgent,
   ProtocolError,
   ProviderError,
+  RoleRegistry,
+  TaskEngine,
   TaskError,
   agentConfigSchema,
   appConfigSchema,
   authHeaders,
+  buildAgentRegistry,
+  buildRoleRegistry,
   composeTaskText,
   createAgent,
   createProvider,
+  createTaskEngine,
   defaultProjectConfigYaml,
   expandEnvRefs,
   findConfigFile,