@hilbras/omninode 0.7.0 → 0.8.0

package/dist/index.d.ts

@@ -854,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;
@@ -910,6 +916,8 @@ declare const projectConfigSchema: z.ZodObject<{
     }[];
     memory?: {
         provider: string;
+        base_url?: string | undefined;
+        api_key_env_var?: string | undefined;
     } | undefined;
 }, {
     name: string;
@@ -960,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<{
@@ -1116,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;
@@ -1172,6 +1188,8 @@ declare const appConfigSchema: z.ZodObject<{
         }[];
         memory?: {
             provider: string;
+            base_url?: string | undefined;
+            api_key_env_var?: string | undefined;
         } | undefined;
     }, {
         name: string;
@@ -1222,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<{
@@ -1283,6 +1303,8 @@ declare const appConfigSchema: z.ZodObject<{
         }[];
         memory?: {
             provider: string;
+            base_url?: string | undefined;
+            api_key_env_var?: string | undefined;
         } | undefined;
     };
     logging?: {
@@ -1338,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?: {
@@ -1362,6 +1386,8 @@ interface AppConfig {
         pipelines: PipelineDefinition[];
         memory?: {
             provider: string;
+            baseUrl?: string;
+            apiKeyEnvVar?: string;
         };
     };
     logging?: {
@@ -1387,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";
@@ -1528,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;
@@ -1539,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 {
@@ -1575,6 +1670,19 @@ interface ReportStore {
     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
@@ -1598,6 +1706,30 @@ declare class ReportService {
     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;
@@ -1669,6 +1801,6 @@ declare function createDefaultChatFn(providers: AppConfig["project"]["providers"
 
 declare function buildPipelineEngine(config: AppConfig, log?: Logger): PipelineEngine;
 
-declare const OMNINODE_VERSION = "0.7.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 AggregatedFinding, type AggregatedRecommendation, type AppConfig, type AppConfigYaml, type ChatFn, type ChatMessage, type ChatRequest, type ChatResponse, type ChatRole, type ChatUsage, type CombinedReport, type Confidence, ConfigError, ConsoleLogSink, type CreateTaskInput, type DiscoveryResult, type EnvelopeMeta, FilePipelineRunStore, FileTaskStore, type Finding, type FindingSeverity, type FindingSource, 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 };