@hilbras/omninode 0.6.0 → 0.8.0

package/dist/index.d.ts

@@ -27,6 +27,43 @@ interface Report {
     createdAt: string;
     metadata?: Record<string, unknown>;
 }
+/** Source attribution for an aggregated finding (§17). */
+interface FindingSource {
+    agent: string;
+    reportId: string;
+}
+interface AggregatedFinding {
+    title: string;
+    /** Distinct details contributed across reports. */
+    details: string[];
+    sources: FindingSource[];
+    /** How many reports reported this (or a similar) finding. */
+    occurrences: number;
+    /** Highest severity seen across merged duplicates. */
+    severity?: FindingSeverity;
+    evidence: string[];
+}
+interface AggregatedRecommendation {
+    text: string;
+    sources: FindingSource[];
+    occurrences: number;
+}
+/** Combined intelligence produced from several independent reports (§17). */
+interface CombinedReport {
+    id: string;
+    title: string;
+    objective?: string;
+    pipelineRunId?: string;
+    taskIds: string[];
+    summary: string;
+    findings: AggregatedFinding[];
+    recommendations: AggregatedRecommendation[];
+    /** Distinct agent names that contributed. */
+    sources: string[];
+    reportIds: string[];
+    createdAt: string;
+    metadata?: Record<string, unknown>;
+}
 
 /** Role system: what an AI is supposed to do, independent of any provider (§11). */
 interface RoleDefinition {
@@ -201,6 +238,8 @@ interface TaskResult {
     reportId?: string;
     /** Structured reports produced by protocol-mode agents (Phase 6 builds on this). */
     reports?: Report[];
+    /** Truncated verbatim agent output, kept for report extraction and audit. */
+    rawOutput?: string;
     error?: string;
     finishedAt?: string;
 }
@@ -263,6 +302,8 @@ interface PipelineRun {
     stepRuns: PipelineStepRun[];
     /** Structured reports gathered across all steps (Phase 6 builds on this). */
     reports?: Report[];
+    /** Set when the report system generated a combined report for this run. */
+    combinedReportId?: string;
 }
 
 /** Agent ↔ OmniNode communication protocol (§21). */
@@ -411,7 +452,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_NOT_FOUND" | "TASK_FAILED" | "PIPELINE_NOT_FOUND" | "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_NOT_FOUND" | "PIPELINE_INVALID" | "PIPELINE_FAILED" | "PROTOCOL_VIOLATION" | "MEMORY_UNAVAILABLE" | "REPORT_NOT_FOUND" | "NOT_IMPLEMENTED" | "CLI_USAGE" | "INTERNAL";
 interface OmniNodeErrorOptions {
     cause?: unknown;
     details?: Record<string, unknown>;
@@ -813,11 +854,17 @@ declare const projectConfigSchema: z.ZodObject<{
         objective?: string | undefined;
     }>, "many">>;
     memory: z.ZodOptional<z.ZodObject<{
-        provider: z.ZodString;
+        provider: z.ZodDefault<z.ZodString>;
+        base_url: z.ZodOptional<z.ZodString>;
+        api_key_env_var: z.ZodOptional<z.ZodString>;
     }, "strict", z.ZodTypeAny, {
         provider: string;
+        base_url?: string | undefined;
+        api_key_env_var?: string | undefined;
     }, {
-        provider: string;
+        base_url?: string | undefined;
+        api_key_env_var?: string | undefined;
+        provider?: string | undefined;
     }>>;
 }, "strict", z.ZodTypeAny, {
     name: string;
@@ -869,6 +916,8 @@ declare const projectConfigSchema: z.ZodObject<{
     }[];
     memory?: {
         provider: string;
+        base_url?: string | undefined;
+        api_key_env_var?: string | undefined;
     } | undefined;
 }, {
     name: string;
@@ -919,7 +968,9 @@ declare const projectConfigSchema: z.ZodObject<{
         objective?: string | undefined;
     }[] | undefined;
     memory?: {
-        provider: string;
+        base_url?: string | undefined;
+        api_key_env_var?: string | undefined;
+        provider?: string | undefined;
     } | undefined;
 }>;
 declare const appConfigSchema: z.ZodObject<{
@@ -1075,11 +1126,17 @@ declare const appConfigSchema: z.ZodObject<{
             objective?: string | undefined;
         }>, "many">>;
         memory: z.ZodOptional<z.ZodObject<{
-            provider: z.ZodString;
+            provider: z.ZodDefault<z.ZodString>;
+            base_url: z.ZodOptional<z.ZodString>;
+            api_key_env_var: z.ZodOptional<z.ZodString>;
         }, "strict", z.ZodTypeAny, {
             provider: string;
+            base_url?: string | undefined;
+            api_key_env_var?: string | undefined;
         }, {
-            provider: string;
+            base_url?: string | undefined;
+            api_key_env_var?: string | undefined;
+            provider?: string | undefined;
         }>>;
     }, "strict", z.ZodTypeAny, {
         name: string;
@@ -1131,6 +1188,8 @@ declare const appConfigSchema: z.ZodObject<{
         }[];
         memory?: {
             provider: string;
+            base_url?: string | undefined;
+            api_key_env_var?: string | undefined;
         } | undefined;
     }, {
         name: string;
@@ -1181,7 +1240,9 @@ declare const appConfigSchema: z.ZodObject<{
             objective?: string | undefined;
         }[] | undefined;
         memory?: {
-            provider: string;
+            base_url?: string | undefined;
+            api_key_env_var?: string | undefined;
+            provider?: string | undefined;
         } | undefined;
     }>;
     logging: z.ZodOptional<z.ZodObject<{
@@ -1242,6 +1303,8 @@ declare const appConfigSchema: z.ZodObject<{
         }[];
         memory?: {
             provider: string;
+            base_url?: string | undefined;
+            api_key_env_var?: string | undefined;
         } | undefined;
     };
     logging?: {
@@ -1297,7 +1360,9 @@ declare const appConfigSchema: z.ZodObject<{
             objective?: string | undefined;
         }[] | undefined;
         memory?: {
-            provider: string;
+            base_url?: string | undefined;
+            api_key_env_var?: string | undefined;
+            provider?: string | undefined;
         } | undefined;
     };
     logging?: {
@@ -1321,6 +1386,8 @@ interface AppConfig {
         pipelines: PipelineDefinition[];
         memory?: {
             provider: string;
+            baseUrl?: string;
+            apiKeyEnvVar?: string;
         };
     };
     logging?: {
@@ -1346,8 +1413,14 @@ declare function loadConfig(options?: LoadConfigOptions): AppConfig;
 /** Template written by `omninode init` (§22, §23). */
 declare function defaultProjectConfigYaml(projectName?: string): string;
 
-declare function resolveApiKey(config: ProviderConfig, env?: Record<string, string | undefined>): string | undefined;
-declare function authHeaders(config: ProviderConfig, env?: Record<string, string | undefined>): Record<string, string>;
+/** Minimal provider identity — any config object with a name and optional env var reference. */
+interface AuthRef {
+    name: string;
+    apiKeyEnvVar?: string;
+    headers?: Record<string, string>;
+}
+declare function resolveApiKey(config: AuthRef, env?: Record<string, string | undefined>): string | undefined;
+declare function authHeaders(config: AuthRef, env?: Record<string, string | undefined>): Record<string, string>;
 
 interface HttpRequestOptions {
     method?: "GET" | "POST";
@@ -1487,6 +1560,67 @@ declare class FileTaskStore implements TaskStore {
     private write;
 }
 
+declare function keywords(text: string): Set<string>;
+declare class LocalMemoryProvider implements IMemoryProvider {
+    readonly name = "local";
+    private readonly filePath;
+    private queue;
+    constructor(directory?: string);
+    query(query: MemoryQuery): Promise<MemoryEntry[]>;
+    write(entry: MemoryEntry): Promise<void>;
+    count(): Promise<number>;
+    private synchronized;
+    private load;
+    private saveAll;
+}
+
+interface RememberaConfig {
+    baseUrl: string;
+    apiKeyEnvVar?: string;
+    env?: Record<string, string | undefined>;
+}
+declare class RememberaMemoryProvider implements IMemoryProvider {
+    readonly name = "remembera";
+    private readonly baseUrl;
+    private readonly apiKeyEnvVar?;
+    private readonly env;
+    private readonly log;
+    constructor(config: RememberaConfig, log?: Logger);
+    private headers;
+    query(query: MemoryQuery): Promise<MemoryEntry[]>;
+    write(entry: MemoryEntry): Promise<void>;
+    private request;
+    private toEntry;
+}
+
+type MemoryProviderConfig = NonNullable<AppConfig["project"]["memory"]>;
+declare function createMemoryProvider(config?: MemoryProviderConfig): IMemoryProvider;
+
+/**
+ * Memory service (§19–§20): gathers relevant memory before a task runs and
+ * records outcomes afterwards — the Task → memory → relevant context →
+ * agents → reports → memory loop. Memory failures are best-effort: they log
+ * a warning and never fail a task, because memory is an enhancement, not a
+ * dependency (§2).
+ */
+
+interface MemoryContextQuery {
+    objective: string;
+    role?: string;
+    project?: string;
+}
+declare class MemoryService {
+    private readonly provider;
+    private readonly log;
+    constructor(provider: IMemoryProvider, log?: Logger);
+    get providerRef(): IMemoryProvider;
+    get providerName(): string;
+    /** Relevant context for a task objective; empty string when nothing matches. */
+    gatherContext(query: MemoryContextQuery): Promise<string>;
+    /** Records a finished task's outcome — best-effort. */
+    recordTaskOutcome(task: Task): Promise<void>;
+}
+
 interface CreateTaskInput {
     objective: string;
     project?: string;
@@ -1498,6 +1632,8 @@ interface TaskEngineOptions {
     agents: AgentRegistry;
     roles: RoleRegistry;
     store: TaskStore;
+    /** When present, tasks gather relevant memory before running and record outcomes after (§20). */
+    memory?: MemoryService;
     log?: Logger;
 }
 declare class TaskEngine {
@@ -1520,6 +1656,80 @@ declare class TaskEngine {
 
 declare function createTaskEngine(config: AppConfig, log?: Logger, directory?: string): TaskEngine;
 
+interface ReportFilter {
+    taskId?: string;
+    agent?: string;
+}
+interface CombinedReportFilter {
+    pipelineRunId?: string;
+}
+interface ReportStore {
+    saveReports(reports: Report[]): Promise<void>;
+    listReports(filter?: ReportFilter): Promise<Report[]>;
+    saveCombined(combined: CombinedReport): Promise<void>;
+    getCombined(id: string): Promise<CombinedReport | undefined>;
+    listCombined(filter?: CombinedReportFilter): Promise<CombinedReport[]>;
+}
+declare class FileReportStore implements ReportStore {
+    private readonly filePath;
+    private queue;
+    constructor(directory?: string);
+    saveReports(reports: Report[]): Promise<void>;
+    listReports(filter?: ReportFilter): Promise<Report[]>;
+    saveCombined(combined: CombinedReport): Promise<void>;
+    getCombined(id: string): Promise<CombinedReport | undefined>;
+    listCombined(filter?: CombinedReportFilter): Promise<CombinedReport[]>;
+    private synchronized;
+    private load;
+    private write;
+}
+
+/**
+ * Report service (§16–§17): collects reports from finished tasks (structured
+ * protocol reports when present, extraction from text otherwise), persists
+ * them with source attribution and generates combined reports.
+ */
+
+interface CombinedMeta {
+    objective?: string;
+    pipelineRunId?: string;
+    taskIds?: string[];
+}
+declare class ReportService {
+    private readonly store;
+    private readonly log;
+    constructor(store: ReportStore, log?: Logger);
+    get storeRef(): ReportStore;
+    /** Normalizes finished tasks into reports (§17 — normalizer). */
+    collectFromTasks(tasks: Task[]): Promise<Report[]>;
+    saveReports(reports: Report[]): Promise<void>;
+    generateCombined(reports: Report[], meta?: CombinedMeta): Promise<CombinedReport | undefined>;
+}
+
+/**
+ * Report normalization (§17): turns an agent's text output into a structured
+ * Report by extracting findings, recommendations and evidence from
+ * markdown-style sections. Deterministic heuristics; AI-assisted extraction
+ * can layer on top later via the planner.
+ */
+
+interface ExtractionMeta {
+    taskId: string;
+    agent: string;
+    model?: string;
+}
+declare function extractReportFromText(raw: string, meta: ExtractionMeta): Report;
+
+interface AggregateOptions {
+    objective?: string;
+    pipelineRunId?: string;
+    taskIds?: string[];
+    /** Token-set Jaccard similarity above which findings are merged. */
+    similarityThreshold?: number;
+}
+declare function aggregateReports(reports: Report[], options?: AggregateOptions): CombinedReport;
+declare function similar(a: string, b: string, threshold: number): boolean;
+
 interface PipelineRunFilter {
     pipelineId?: string;
     status?: PipelineRunStatus;
@@ -1549,6 +1759,8 @@ interface PipelineEngineOptions {
     providers: AppConfig["project"]["providers"];
     store: PipelineRunStore;
     chat?: ChatFn;
+    /** When present, finished runs have their reports collected, stored and combined (§16–§17). */
+    reports?: ReportService;
     log?: Logger;
 }
 interface RunPipelineOptions {
@@ -1589,6 +1801,6 @@ declare function createDefaultChatFn(providers: AppConfig["project"]["providers"
 
 declare function buildPipelineEngine(config: AppConfig, log?: Logger): PipelineEngine;
 
-declare const OMNINODE_VERSION = "0.6.0";
+declare const OMNINODE_VERSION = "0.8.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 ChatFn, type ChatMessage, type ChatRequest, type ChatResponse, type ChatRole, type ChatUsage, type Confidence, ConfigError, ConsoleLogSink, type CreateTaskInput, type DiscoveryResult, type EnvelopeMeta, FilePipelineRunStore, 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 PipelineConfigYaml, type PipelineDefinition, PipelineEngine, type PipelineEngineOptions, PipelineError, type PipelineRun, type PipelineRunFilter, type PipelineRunStatus, type PipelineRunStore, type PipelineStep, type PipelineStepCondition, type PipelineStepConfigYaml, 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 RunPipelineOptions, type Task, type TaskContext, TaskEngine, type TaskEngineOptions, TaskError, type TaskResult, type TaskStatus, type TaskStore, type TaskStoreFilter, type WritableLike, agentConfigSchema, appConfigSchema, authHeaders, buildAgentRegistry, buildPipelineEngine, buildRoleRegistry, composeTaskText, createAgent, createDefaultChatFn, createProvider, createTaskEngine, defaultProjectConfigYaml, expandEnvRefs, findConfigFile, isOmniNodeError, loadConfig, logger, pipelineConfigSchema, pipelineStepConfigSchema, 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 AggregateOptions, type AggregatedFinding, type AggregatedRecommendation, type AppConfig, type AppConfigYaml, type ChatFn, type ChatMessage, type ChatRequest, type ChatResponse, type ChatRole, type ChatUsage, type CombinedMeta, type CombinedReport, type CombinedReportFilter, type Confidence, ConfigError, ConsoleLogSink, type CreateTaskInput, type DiscoveryResult, type EnvelopeMeta, type ExtractionMeta, FilePipelineRunStore, FileReportStore, FileTaskStore, type Finding, type FindingSeverity, type FindingSource, type HttpRequestOptions, type HttpResponse, type IAgent, type IChatProvider, type IMemoryProvider, type IProvider, type LoadConfigOptions, LocalMemoryProvider, type LogLevel, type LogSink, Logger, type LoggerOptions, type MemoryContextQuery, type MemoryEntry, MemoryError, type MemoryProviderConfig, type MemoryQuery, type MemoryScope, MemoryService, 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 PipelineConfigYaml, type PipelineDefinition, PipelineEngine, type PipelineEngineOptions, PipelineError, type PipelineRun, type PipelineRunFilter, type PipelineRunStatus, type PipelineRunStore, type PipelineStep, type PipelineStepCondition, type PipelineStepConfigYaml, type PipelineStepKind, type PipelineStepRun, ProcessAgent, type Project, type ProjectConfigYaml, ProtocolError, type ProviderConfig, type ProviderConfigYaml, ProviderError, type ProviderHealth, type ProviderStatus, type ProviderType, type RememberaConfig, RememberaMemoryProvider, type Report, type ReportFilter, ReportService, type ReportStore, type RoleConfigYaml, type RoleDefinition, RoleRegistry, type RunPipelineOptions, type Task, type TaskContext, TaskEngine, type TaskEngineOptions, TaskError, type TaskResult, type TaskStatus, type TaskStore, type TaskStoreFilter, type WritableLike, agentConfigSchema, aggregateReports, appConfigSchema, authHeaders, buildAgentRegistry, buildPipelineEngine, buildRoleRegistry, composeTaskText, createAgent, createDefaultChatFn, createMemoryProvider, createProvider, createTaskEngine, defaultProjectConfigYaml, expandEnvRefs, extractReportFromText, findConfigFile, isOmniNodeError, keywords, loadConfig, logger, pipelineConfigSchema, pipelineStepConfigSchema, projectConfigSchema, providerConfigSchema, registryKey, requestJson, resolveApiKey, roleConfigSchema, similar };