@hilbras/omninode 0.3.0 → 0.5.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+). */
@@ -148,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;
@@ -162,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;
 }
@@ -215,34 +254,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 {
@@ -389,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>;
@@ -409,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);
@@ -495,15 +506,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 +527,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 +593,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 +614,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 +666,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 +706,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 +759,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 +780,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 +832,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 +872,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 +892,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 +911,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 +934,7 @@ declare const appConfigSchema: z.ZodObject<{
         } | undefined;
     };
     logging?: {
-        level: "error" | "info" | "debug" | "warn";
+        level: "info" | "error" | "debug" | "warn";
     } | undefined;
 }, {
     project: {
@@ -917,6 +956,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 +974,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 +1089,101 @@ 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[];
+}
+
+/** 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[];
+}
+
+/**
+ * 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 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 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 };