@hilbras/omninode 2.0.0-alpha.6 → 2.0.0-alpha.7

package/dist/index.d.ts

@@ -296,6 +296,14 @@ interface ChatResponse {
  * layer so adapters (e.g. planner) never depend on engine modules.
  */
 type ChatFn = (model: string, messages: ChatMessage[]) => Promise<string>;
+/** One streamed chunk (SSE deltas from OpenAI-compatible gateways). */
+interface ChatStreamChunk {
+    /** Text delta (empty for role-only or final chunks). */
+    delta: string;
+    /** Provider-reported finish reason, on the final chunk. */
+    finishReason?: string;
+    raw?: unknown;
+}
 
 /**
  * Memory abstraction. Remembera is the preferred Hilbras integration, but the
@@ -685,6 +693,8 @@ interface ProviderConfig {
      */
     apiKeyEnvVar?: string;
     headers?: Record<string, string>;
+    /** Provider-level request timeout in ms (distinct from agent/pipeline budgets). */
+    timeoutMs?: number;
     /** Capabilities declared for this provider (discovered ones are merged in). */
     capabilities?: ProviderCapability[];
     enabled?: boolean;
@@ -722,6 +732,11 @@ interface IProvider {
 /** Contract for providers that can run chat completions (foundation for planning). */
 interface IChatProvider extends IProvider {
     chat(request: ChatRequest): Promise<ChatResponse>;
+    /**
+     * Stream a completion where the provider supports it (§11). Chunks are
+     * delivered in order; the resolved ChatResponse carries the assembled text.
+     */
+    stream?(request: ChatRequest, onChunk: (chunk: ChatStreamChunk) => void): Promise<ChatResponse>;
 }
 
 /** Typed error hierarchy shared across the whole codebase (§4.1 — error model). */
@@ -806,6 +821,7 @@ declare const providerConfigSchema: z.ZodObject<{
     type: z.ZodEnum<["openai-compatible", "omnihilbras", "openrouter", "local", "custom"]>;
     base_url: z.ZodString;
     api_key_env_var: z.ZodOptional<z.ZodString>;
+    timeout_ms: z.ZodOptional<z.ZodNumber>;
     headers: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
     enabled: z.ZodOptional<z.ZodBoolean>;
     metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
@@ -815,6 +831,7 @@ declare const providerConfigSchema: z.ZodObject<{
     base_url: string;
     metadata?: Record<string, unknown> | undefined;
     api_key_env_var?: string | undefined;
+    timeout_ms?: number | undefined;
     headers?: Record<string, string> | undefined;
     enabled?: boolean | undefined;
 }, {
@@ -823,6 +840,7 @@ declare const providerConfigSchema: z.ZodObject<{
     base_url: string;
     metadata?: Record<string, unknown> | undefined;
     api_key_env_var?: string | undefined;
+    timeout_ms?: number | undefined;
     headers?: Record<string, string> | undefined;
     enabled?: boolean | undefined;
 }>;
@@ -848,11 +866,11 @@ declare const agentConfigSchema: z.ZodObject<{
     type: "native" | "process" | "cli";
     input_mode: "protocol" | "stdin" | "arg";
     metadata?: Record<string, unknown> | undefined;
+    timeout_ms?: number | undefined;
     command?: string | undefined;
     args?: string[] | undefined;
     cwd?: string | undefined;
     env?: Record<string, string> | undefined;
-    timeout_ms?: number | undefined;
     inherit_env?: boolean | undefined;
     env_policy?: "inherit" | "allowlist" | "denylist" | "explicit" | undefined;
     env_allowlist?: string[] | undefined;
@@ -863,12 +881,12 @@ declare const agentConfigSchema: z.ZodObject<{
     name: string;
     metadata?: Record<string, unknown> | undefined;
     type?: "native" | "process" | "cli" | undefined;
+    timeout_ms?: number | undefined;
     command?: string | undefined;
     args?: string[] | undefined;
     cwd?: string | undefined;
     env?: Record<string, string> | undefined;
     input_mode?: "protocol" | "stdin" | "arg" | undefined;
-    timeout_ms?: number | undefined;
     inherit_env?: boolean | undefined;
     env_policy?: "inherit" | "allowlist" | "denylist" | "explicit" | undefined;
     env_allowlist?: string[] | undefined;
@@ -1016,6 +1034,7 @@ declare const projectConfigSchema: z.ZodObject<{
         type: z.ZodEnum<["openai-compatible", "omnihilbras", "openrouter", "local", "custom"]>;
         base_url: z.ZodString;
         api_key_env_var: z.ZodOptional<z.ZodString>;
+        timeout_ms: z.ZodOptional<z.ZodNumber>;
         headers: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
         enabled: z.ZodOptional<z.ZodBoolean>;
         metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
@@ -1025,6 +1044,7 @@ declare const projectConfigSchema: z.ZodObject<{
         base_url: string;
         metadata?: Record<string, unknown> | undefined;
         api_key_env_var?: string | undefined;
+        timeout_ms?: number | undefined;
         headers?: Record<string, string> | undefined;
         enabled?: boolean | undefined;
     }, {
@@ -1033,6 +1053,7 @@ declare const projectConfigSchema: z.ZodObject<{
         base_url: string;
         metadata?: Record<string, unknown> | undefined;
         api_key_env_var?: string | undefined;
+        timeout_ms?: number | undefined;
         headers?: Record<string, string> | undefined;
         enabled?: boolean | undefined;
     }>, "many">>;
@@ -1058,11 +1079,11 @@ declare const projectConfigSchema: z.ZodObject<{
         type: "native" | "process" | "cli";
         input_mode: "protocol" | "stdin" | "arg";
         metadata?: Record<string, unknown> | undefined;
+        timeout_ms?: number | undefined;
         command?: string | undefined;
         args?: string[] | undefined;
         cwd?: string | undefined;
         env?: Record<string, string> | undefined;
-        timeout_ms?: number | undefined;
         inherit_env?: boolean | undefined;
         env_policy?: "inherit" | "allowlist" | "denylist" | "explicit" | undefined;
         env_allowlist?: string[] | undefined;
@@ -1073,12 +1094,12 @@ declare const projectConfigSchema: z.ZodObject<{
         name: string;
         metadata?: Record<string, unknown> | undefined;
         type?: "native" | "process" | "cli" | undefined;
+        timeout_ms?: number | undefined;
         command?: string | undefined;
         args?: string[] | undefined;
         cwd?: string | undefined;
         env?: Record<string, string> | undefined;
         input_mode?: "protocol" | "stdin" | "arg" | undefined;
-        timeout_ms?: number | undefined;
         inherit_env?: boolean | undefined;
         env_policy?: "inherit" | "allowlist" | "denylist" | "explicit" | undefined;
         env_allowlist?: string[] | undefined;
@@ -1195,13 +1216,16 @@ declare const projectConfigSchema: z.ZodObject<{
         provider: z.ZodDefault<z.ZodString>;
         base_url: z.ZodOptional<z.ZodString>;
         api_key_env_var: z.ZodOptional<z.ZodString>;
+        timeout_ms: z.ZodOptional<z.ZodNumber>;
     }, "strict", z.ZodTypeAny, {
         provider: string;
         base_url?: string | undefined;
         api_key_env_var?: string | undefined;
+        timeout_ms?: number | undefined;
     }, {
         base_url?: string | undefined;
         api_key_env_var?: string | undefined;
+        timeout_ms?: number | undefined;
         provider?: string | undefined;
     }>>;
 }, "strict", z.ZodTypeAny, {
@@ -1211,11 +1235,11 @@ declare const projectConfigSchema: z.ZodObject<{
         type: "native" | "process" | "cli";
         input_mode: "protocol" | "stdin" | "arg";
         metadata?: Record<string, unknown> | undefined;
+        timeout_ms?: number | undefined;
         command?: string | undefined;
         args?: string[] | undefined;
         cwd?: string | undefined;
         env?: Record<string, string> | undefined;
-        timeout_ms?: number | undefined;
         inherit_env?: boolean | undefined;
         env_policy?: "inherit" | "allowlist" | "denylist" | "explicit" | undefined;
         env_allowlist?: string[] | undefined;
@@ -1229,6 +1253,7 @@ declare const projectConfigSchema: z.ZodObject<{
         base_url: string;
         metadata?: Record<string, unknown> | undefined;
         api_key_env_var?: string | undefined;
+        timeout_ms?: number | undefined;
         headers?: Record<string, string> | undefined;
         enabled?: boolean | undefined;
     }[];
@@ -1267,6 +1292,7 @@ declare const projectConfigSchema: z.ZodObject<{
         provider: string;
         base_url?: string | undefined;
         api_key_env_var?: string | undefined;
+        timeout_ms?: number | undefined;
     } | undefined;
 }, {
     name: string;
@@ -1274,12 +1300,12 @@ declare const projectConfigSchema: z.ZodObject<{
         name: string;
         metadata?: Record<string, unknown> | undefined;
         type?: "native" | "process" | "cli" | undefined;
+        timeout_ms?: number | undefined;
         command?: string | undefined;
         args?: string[] | undefined;
         cwd?: string | undefined;
         env?: Record<string, string> | undefined;
         input_mode?: "protocol" | "stdin" | "arg" | undefined;
-        timeout_ms?: number | undefined;
         inherit_env?: boolean | undefined;
         env_policy?: "inherit" | "allowlist" | "denylist" | "explicit" | undefined;
         env_allowlist?: string[] | undefined;
@@ -1293,6 +1319,7 @@ declare const projectConfigSchema: z.ZodObject<{
         base_url: string;
         metadata?: Record<string, unknown> | undefined;
         api_key_env_var?: string | undefined;
+        timeout_ms?: number | undefined;
         headers?: Record<string, string> | undefined;
         enabled?: boolean | undefined;
     }[] | undefined;
@@ -1330,6 +1357,7 @@ declare const projectConfigSchema: z.ZodObject<{
     memory?: {
         base_url?: string | undefined;
         api_key_env_var?: string | undefined;
+        timeout_ms?: number | undefined;
         provider?: string | undefined;
     } | undefined;
 }>;
@@ -1341,6 +1369,7 @@ declare const appConfigSchema: z.ZodObject<{
             type: z.ZodEnum<["openai-compatible", "omnihilbras", "openrouter", "local", "custom"]>;
             base_url: z.ZodString;
             api_key_env_var: z.ZodOptional<z.ZodString>;
+            timeout_ms: z.ZodOptional<z.ZodNumber>;
             headers: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
             enabled: z.ZodOptional<z.ZodBoolean>;
             metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
@@ -1350,6 +1379,7 @@ declare const appConfigSchema: z.ZodObject<{
             base_url: string;
             metadata?: Record<string, unknown> | undefined;
             api_key_env_var?: string | undefined;
+            timeout_ms?: number | undefined;
             headers?: Record<string, string> | undefined;
             enabled?: boolean | undefined;
         }, {
@@ -1358,6 +1388,7 @@ declare const appConfigSchema: z.ZodObject<{
             base_url: string;
             metadata?: Record<string, unknown> | undefined;
             api_key_env_var?: string | undefined;
+            timeout_ms?: number | undefined;
             headers?: Record<string, string> | undefined;
             enabled?: boolean | undefined;
         }>, "many">>;
@@ -1383,11 +1414,11 @@ declare const appConfigSchema: z.ZodObject<{
             type: "native" | "process" | "cli";
             input_mode: "protocol" | "stdin" | "arg";
             metadata?: Record<string, unknown> | undefined;
+            timeout_ms?: number | undefined;
             command?: string | undefined;
             args?: string[] | undefined;
             cwd?: string | undefined;
             env?: Record<string, string> | undefined;
-            timeout_ms?: number | undefined;
             inherit_env?: boolean | undefined;
             env_policy?: "inherit" | "allowlist" | "denylist" | "explicit" | undefined;
             env_allowlist?: string[] | undefined;
@@ -1398,12 +1429,12 @@ declare const appConfigSchema: z.ZodObject<{
             name: string;
             metadata?: Record<string, unknown> | undefined;
             type?: "native" | "process" | "cli" | undefined;
+            timeout_ms?: number | undefined;
             command?: string | undefined;
             args?: string[] | undefined;
             cwd?: string | undefined;
             env?: Record<string, string> | undefined;
             input_mode?: "protocol" | "stdin" | "arg" | undefined;
-            timeout_ms?: number | undefined;
             inherit_env?: boolean | undefined;
             env_policy?: "inherit" | "allowlist" | "denylist" | "explicit" | undefined;
             env_allowlist?: string[] | undefined;
@@ -1520,13 +1551,16 @@ declare const appConfigSchema: z.ZodObject<{
             provider: z.ZodDefault<z.ZodString>;
             base_url: z.ZodOptional<z.ZodString>;
             api_key_env_var: z.ZodOptional<z.ZodString>;
+            timeout_ms: z.ZodOptional<z.ZodNumber>;
         }, "strict", z.ZodTypeAny, {
             provider: string;
             base_url?: string | undefined;
             api_key_env_var?: string | undefined;
+            timeout_ms?: number | undefined;
         }, {
             base_url?: string | undefined;
             api_key_env_var?: string | undefined;
+            timeout_ms?: number | undefined;
             provider?: string | undefined;
         }>>;
     }, "strict", z.ZodTypeAny, {
@@ -1536,11 +1570,11 @@ declare const appConfigSchema: z.ZodObject<{
             type: "native" | "process" | "cli";
             input_mode: "protocol" | "stdin" | "arg";
             metadata?: Record<string, unknown> | undefined;
+            timeout_ms?: number | undefined;
             command?: string | undefined;
             args?: string[] | undefined;
             cwd?: string | undefined;
             env?: Record<string, string> | undefined;
-            timeout_ms?: number | undefined;
             inherit_env?: boolean | undefined;
             env_policy?: "inherit" | "allowlist" | "denylist" | "explicit" | undefined;
             env_allowlist?: string[] | undefined;
@@ -1554,6 +1588,7 @@ declare const appConfigSchema: z.ZodObject<{
             base_url: string;
             metadata?: Record<string, unknown> | undefined;
             api_key_env_var?: string | undefined;
+            timeout_ms?: number | undefined;
             headers?: Record<string, string> | undefined;
             enabled?: boolean | undefined;
         }[];
@@ -1592,6 +1627,7 @@ declare const appConfigSchema: z.ZodObject<{
             provider: string;
             base_url?: string | undefined;
             api_key_env_var?: string | undefined;
+            timeout_ms?: number | undefined;
         } | undefined;
     }, {
         name: string;
@@ -1599,12 +1635,12 @@ declare const appConfigSchema: z.ZodObject<{
             name: string;
             metadata?: Record<string, unknown> | undefined;
             type?: "native" | "process" | "cli" | undefined;
+            timeout_ms?: number | undefined;
             command?: string | undefined;
             args?: string[] | undefined;
             cwd?: string | undefined;
             env?: Record<string, string> | undefined;
             input_mode?: "protocol" | "stdin" | "arg" | undefined;
-            timeout_ms?: number | undefined;
             inherit_env?: boolean | undefined;
             env_policy?: "inherit" | "allowlist" | "denylist" | "explicit" | undefined;
             env_allowlist?: string[] | undefined;
@@ -1618,6 +1654,7 @@ declare const appConfigSchema: z.ZodObject<{
             base_url: string;
             metadata?: Record<string, unknown> | undefined;
             api_key_env_var?: string | undefined;
+            timeout_ms?: number | undefined;
             headers?: Record<string, string> | undefined;
             enabled?: boolean | undefined;
         }[] | undefined;
@@ -1655,6 +1692,7 @@ declare const appConfigSchema: z.ZodObject<{
         memory?: {
             base_url?: string | undefined;
             api_key_env_var?: string | undefined;
+            timeout_ms?: number | undefined;
             provider?: string | undefined;
         } | undefined;
     }>;
@@ -1673,11 +1711,11 @@ declare const appConfigSchema: z.ZodObject<{
             type: "native" | "process" | "cli";
             input_mode: "protocol" | "stdin" | "arg";
             metadata?: Record<string, unknown> | undefined;
+            timeout_ms?: number | undefined;
             command?: string | undefined;
             args?: string[] | undefined;
             cwd?: string | undefined;
             env?: Record<string, string> | undefined;
-            timeout_ms?: number | undefined;
             inherit_env?: boolean | undefined;
             env_policy?: "inherit" | "allowlist" | "denylist" | "explicit" | undefined;
             env_allowlist?: string[] | undefined;
@@ -1691,6 +1729,7 @@ declare const appConfigSchema: z.ZodObject<{
             base_url: string;
             metadata?: Record<string, unknown> | undefined;
             api_key_env_var?: string | undefined;
+            timeout_ms?: number | undefined;
             headers?: Record<string, string> | undefined;
             enabled?: boolean | undefined;
         }[];
@@ -1729,6 +1768,7 @@ declare const appConfigSchema: z.ZodObject<{
             provider: string;
             base_url?: string | undefined;
             api_key_env_var?: string | undefined;
+            timeout_ms?: number | undefined;
         } | undefined;
     };
     logging?: {
@@ -1741,12 +1781,12 @@ declare const appConfigSchema: z.ZodObject<{
             name: string;
             metadata?: Record<string, unknown> | undefined;
             type?: "native" | "process" | "cli" | undefined;
+            timeout_ms?: number | undefined;
             command?: string | undefined;
             args?: string[] | undefined;
             cwd?: string | undefined;
             env?: Record<string, string> | undefined;
             input_mode?: "protocol" | "stdin" | "arg" | undefined;
-            timeout_ms?: number | undefined;
             inherit_env?: boolean | undefined;
             env_policy?: "inherit" | "allowlist" | "denylist" | "explicit" | undefined;
             env_allowlist?: string[] | undefined;
@@ -1760,6 +1800,7 @@ declare const appConfigSchema: z.ZodObject<{
             base_url: string;
             metadata?: Record<string, unknown> | undefined;
             api_key_env_var?: string | undefined;
+            timeout_ms?: number | undefined;
             headers?: Record<string, string> | undefined;
             enabled?: boolean | undefined;
         }[] | undefined;
@@ -1797,6 +1838,7 @@ declare const appConfigSchema: z.ZodObject<{
         memory?: {
             base_url?: string | undefined;
             api_key_env_var?: string | undefined;
+            timeout_ms?: number | undefined;
             provider?: string | undefined;
         } | undefined;
     };
@@ -1923,12 +1965,19 @@ declare class OpenAICompatibleProvider implements IChatProvider {
     private discovered?;
     private readonly env;
     constructor(config: ProviderConfig, log?: Logger, env?: Record<string, string | undefined>);
+    /** Provider-level request timeout (roadmap §6.6/§11) with the shared default. */
+    private get requestTimeoutMs();
     /** Authenticate + discover (roadmap §10, Model Discovery). */
     connect(): Promise<ModelInfo[]>;
     getModel(modelId: string): Promise<ModelInfo | undefined>;
+    /** Raw /models body (protected so adapters can capture gateway-level metadata). */
+    protected rawModelsResponse(): Promise<unknown>;
+    private modelsRequest;
     listModels(): Promise<ModelInfo[]>;
     /** Maps a raw model entry onto the normalized metadata shape (§10). */
     private toModelInfo;
+    /** Streaming where the gateway supports it (§11). */
+    stream(request: ChatRequest, onChunk: (chunk: ChatStreamChunk) => void): Promise<ChatResponse>;
     healthCheck(): Promise<ProviderStatus>;
     chat(request: ChatRequest): Promise<ChatResponse>;
 }
@@ -1971,10 +2020,18 @@ interface OmniHilbrasConnectionResult {
     registered: number;
 }
 declare class OmniHilbrasProvider extends OpenAICompatibleProvider {
+    private gateway?;
+    listModels(): Promise<ModelInfo[]>;
     /**
      * Run the full connect flow. Throws on authentication or transport failure
      * (use healthCheck() for a non-throwing probe).
      */
+    /**
+     * Gateway metadata reported alongside the model list (gateway version, tier,
+     * region…), kept separate from per-model metadata (§11 — provider metadata).
+     */
+    gatewayMetadata(): Record<string, unknown> | undefined;
+    protected extractGatewayMetadata(body: unknown): Promise<void>;
     connectAndRegister(registry?: ModelRegistry): Promise<OmniHilbrasConnectionResult>;
 }
 
@@ -2645,6 +2702,6 @@ declare class ProjectStores {
     constructor(directory?: string);
 }
 
-declare const OMNINODE_VERSION = "2.0.0-alpha.6";
+declare const OMNINODE_VERSION = "2.0.0-alpha.7";
 
-export { AgentAdapterRegistry, type AgentConfig, type AgentConfigYaml, type AgentDescriptor, 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 ArtifactKind, type ArtifactPayload, type AskedQuestion, type AuditAction, type AuditEvent, type AuditSink, 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 CwdValidation, DEFAULT_MAX_OUTPUT_BYTES, type DecodeResult, type DiscoveryResult, type EnvPolicy, type EnvelopeMeta, type ExecutionRecord, type ExtractionMeta, FileAuditLog, FilePipelineRunStore, FilePlanStore, FileReportStore, FileTaskStore, type Finding, type FindingSeverity, type FindingSource, type HelloResult, HeuristicPlanner, type HttpRequestOptions, type HttpResponse, type IAgent, type IAgentAdapter, type IChatProvider, type IMemoryProvider, type IPipelineExecutor, type IPlanner, type IProvider, type JsonDocument, JsonFileStore, type JsonFileStoreOptions, type LoadConfigOptions, LocalMemoryProvider, type LogLevel, type LogSink, Logger, type LoggerOptions, MAX_MESSAGE_BYTES, type MemoryContextQuery, type MemoryEntry, MemoryError, type MemoryProviderConfig, type MemoryQuery, type MemoryScope, MemoryService, type MessageEnvelope, type Modality, type ModelCapabilities, type ModelFilter, type ModelInfo, ModelPlanner, ModelRegistry, type ModelStatus, type NodeToAgentMessage, OMNINODE_VERSION, OPENAI_COMPATIBLE_TYPES, type OmniHilbrasConnectionResult, OmniHilbrasProvider, OmniNodeError, type OmniNodeErrorCode, type OmniNodeErrorOptions, OpenAICompatibleProvider, PROTOCOL_V2, type PipelineConfigYaml, type PipelineDefinition, PipelineEngine, type PipelineEngineOptions, PipelineError, type PipelineRun, type PipelineRunAttempt, type PipelineRunFilter, type PipelineRunOptions, type PipelineRunStatus, type PipelineRunStore, type PipelineStep, type PipelineStepCondition, type PipelineStepConfigYaml, type PipelineStepKind, type PipelineStepRun, type Plan, type PlanFilter, type PlanRequest, type PlanStep, type PlanStore, type PlannerConfigYaml, PlannerError, ProcessAgent, ProcessAgentAdapter, type Project, type ProjectConfigYaml, ProjectStores, type ProtocolAgentToNodeType, ProtocolDecoder, type ProtocolEnvelope, ProtocolError, type ProtocolMessageType, type ProtocolNodeToAgentType, ProtocolSession, type ProtocolViolation, type ProtocolViolationCode, type ProviderAuthentication, type ProviderCapability, type ProviderConfig, type ProviderConfigYaml, ProviderError, type ProviderErrorKind, type ProviderHealth, type ProviderStatus, type ProviderType, type QuestionPayload, type QuestionResponder, type RememberaConfig, RememberaMemoryProvider, type Report, type ReportFilter, type ReportPayload, ReportService, type ReportStore, type RoleConfigYaml, type RoleDefinition, RoleRegistry, type RunPipelineOptions, SUPPORTED_PROTOCOL_VERSIONS, type SessionIds, TERMINAL_TASK_STATUSES, type Task, type TaskContext, TaskEngine, type TaskEngineOptions, TaskError, type TaskPayload, type TaskResult, type TaskStatus, type TaskStore, type TaskStoreFilter, type WritableLike, agentConfigSchema, aggregateReports, appConfigSchema, authHeaders, buildAgentRegistry, buildChildEnv, buildHello, buildHelloAck, buildPipelineEngine, buildPlanner, buildPlannerContext, buildRoleRegistry, composeTaskText, createAgent, createDefaultChatFn, createMemoryProvider, createProvider, createTaskEngine, decodeMessage, decodeStream, defaultProjectConfigYaml, describeExit, encodeMessage, envelope, expandEnvRefs, extractMessage, extractReportFromText, findConfigFile, isNetworkError, isOmniNodeError, isRetryable, isSupportedProtocol, isTimeoutError, keywords, killTree, kindFromStatus, loadConfig, logger, newMessageId, parseHello, parsePlanJson, parseRetryAfter, pipelineConfigSchema, pipelineStepConfigSchema, plannerConfigSchema, projectConfigSchema, providerConfigSchema, providerHttpError, providerTransportError, registryKey, requestJson, requireCompletion, resolveApiKey, resolveEnvPolicy, roleConfigSchema, sanitizeChunk, similar, validateEnvelope, validateWorkingDirectory };
+export { AgentAdapterRegistry, type AgentConfig, type AgentConfigYaml, type AgentDescriptor, 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 ArtifactKind, type ArtifactPayload, type AskedQuestion, type AuditAction, type AuditEvent, type AuditSink, type ChatFn, type ChatMessage, type ChatRequest, type ChatResponse, type ChatRole, type ChatStreamChunk, type ChatUsage, type CombinedMeta, type CombinedReport, type CombinedReportFilter, type Confidence, ConfigError, ConsoleLogSink, type CreateTaskInput, type CwdValidation, DEFAULT_MAX_OUTPUT_BYTES, type DecodeResult, type DiscoveryResult, type EnvPolicy, type EnvelopeMeta, type ExecutionRecord, type ExtractionMeta, FileAuditLog, FilePipelineRunStore, FilePlanStore, FileReportStore, FileTaskStore, type Finding, type FindingSeverity, type FindingSource, type HelloResult, HeuristicPlanner, type HttpRequestOptions, type HttpResponse, type IAgent, type IAgentAdapter, type IChatProvider, type IMemoryProvider, type IPipelineExecutor, type IPlanner, type IProvider, type JsonDocument, JsonFileStore, type JsonFileStoreOptions, type LoadConfigOptions, LocalMemoryProvider, type LogLevel, type LogSink, Logger, type LoggerOptions, MAX_MESSAGE_BYTES, type MemoryContextQuery, type MemoryEntry, MemoryError, type MemoryProviderConfig, type MemoryQuery, type MemoryScope, MemoryService, type MessageEnvelope, type Modality, type ModelCapabilities, type ModelFilter, type ModelInfo, ModelPlanner, ModelRegistry, type ModelStatus, type NodeToAgentMessage, OMNINODE_VERSION, OPENAI_COMPATIBLE_TYPES, type OmniHilbrasConnectionResult, OmniHilbrasProvider, OmniNodeError, type OmniNodeErrorCode, type OmniNodeErrorOptions, OpenAICompatibleProvider, PROTOCOL_V2, type PipelineConfigYaml, type PipelineDefinition, PipelineEngine, type PipelineEngineOptions, PipelineError, type PipelineRun, type PipelineRunAttempt, type PipelineRunFilter, type PipelineRunOptions, type PipelineRunStatus, type PipelineRunStore, type PipelineStep, type PipelineStepCondition, type PipelineStepConfigYaml, type PipelineStepKind, type PipelineStepRun, type Plan, type PlanFilter, type PlanRequest, type PlanStep, type PlanStore, type PlannerConfigYaml, PlannerError, ProcessAgent, ProcessAgentAdapter, type Project, type ProjectConfigYaml, ProjectStores, type ProtocolAgentToNodeType, ProtocolDecoder, type ProtocolEnvelope, ProtocolError, type ProtocolMessageType, type ProtocolNodeToAgentType, ProtocolSession, type ProtocolViolation, type ProtocolViolationCode, type ProviderAuthentication, type ProviderCapability, type ProviderConfig, type ProviderConfigYaml, ProviderError, type ProviderErrorKind, type ProviderHealth, type ProviderStatus, type ProviderType, type QuestionPayload, type QuestionResponder, type RememberaConfig, RememberaMemoryProvider, type Report, type ReportFilter, type ReportPayload, ReportService, type ReportStore, type RoleConfigYaml, type RoleDefinition, RoleRegistry, type RunPipelineOptions, SUPPORTED_PROTOCOL_VERSIONS, type SessionIds, TERMINAL_TASK_STATUSES, type Task, type TaskContext, TaskEngine, type TaskEngineOptions, TaskError, type TaskPayload, type TaskResult, type TaskStatus, type TaskStore, type TaskStoreFilter, type WritableLike, agentConfigSchema, aggregateReports, appConfigSchema, authHeaders, buildAgentRegistry, buildChildEnv, buildHello, buildHelloAck, buildPipelineEngine, buildPlanner, buildPlannerContext, buildRoleRegistry, composeTaskText, createAgent, createDefaultChatFn, createMemoryProvider, createProvider, createTaskEngine, decodeMessage, decodeStream, defaultProjectConfigYaml, describeExit, encodeMessage, envelope, expandEnvRefs, extractMessage, extractReportFromText, findConfigFile, isNetworkError, isOmniNodeError, isRetryable, isSupportedProtocol, isTimeoutError, keywords, killTree, kindFromStatus, loadConfig, logger, newMessageId, parseHello, parsePlanJson, parseRetryAfter, pipelineConfigSchema, pipelineStepConfigSchema, plannerConfigSchema, projectConfigSchema, providerConfigSchema, providerHttpError, providerTransportError, registryKey, requestJson, requireCompletion, resolveApiKey, resolveEnvPolicy, roleConfigSchema, sanitizeChunk, similar, validateEnvelope, validateWorkingDirectory };

package/dist/index.js

@@ -125,6 +125,7 @@ var providerConfigSchema = z.object({
   type: z.enum(["openai-compatible", "omnihilbras", "openrouter", "local", "custom"]),
   base_url: z.string().url(),
   api_key_env_var: z.string().min(1).optional(),
+  timeout_ms: z.number().int().positive().optional(),
   headers: z.record(z.string()).optional(),
   enabled: z.boolean().optional(),
   metadata: z.record(z.unknown()).optional()
@@ -189,7 +190,8 @@ var projectConfigSchema = z.object({
   memory: z.object({
     provider: z.string().min(1).default("local"),
     base_url: z.string().url().optional(),
-    api_key_env_var: z.string().min(1).optional()
+    api_key_env_var: z.string().min(1).optional(),
+    timeout_ms: z.number().int().positive().optional()
   }).strict().optional()
 }).strict();
 var appConfigSchema = z.object({
@@ -302,6 +304,7 @@ function toProviderConfig(raw) {
     type: raw.type,
     baseUrl: raw.base_url,
     apiKeyEnvVar: raw.api_key_env_var,
+    timeoutMs: raw.timeout_ms,
     headers: raw.headers,
     enabled: raw.enabled,
     metadata: raw.metadata
@@ -524,6 +527,7 @@ function providerTransportError(context) {
 }
 
 // src/providers/openai-compatible/index.ts
+var DEFAULT_REQUEST_TIMEOUT_MS = 3e4;
 var OpenAICompatibleProvider = class {
   config;
   providerId;
@@ -543,6 +547,10 @@ var OpenAICompatibleProvider = class {
     };
     this.log = log.child({ provider: config.name });
   }
+  /** Provider-level request timeout (roadmap §6.6/§11) with the shared default. */
+  get requestTimeoutMs() {
+    return this.config.timeoutMs ?? DEFAULT_REQUEST_TIMEOUT_MS;
+  }
   /** Authenticate + discover (roadmap §10, Model Discovery). */
   async connect() {
     authHeaders(this.config, this.env);
@@ -554,11 +562,17 @@ var OpenAICompatibleProvider = class {
     const models = this.discovered ?? await this.connect();
     return models.find((m) => m.id === modelId);
   }
-  async listModels() {
+  /** Raw /models body (protected so adapters can capture gateway-level metadata). */
+  async rawModelsResponse() {
+    const response = await this.modelsRequest();
+    return response.body;
+  }
+  async modelsRequest() {
     let response;
     try {
       response = await requestJson(`${this.config.baseUrl}/models`, {
-        headers: authHeaders(this.config, this.env)
+        headers: authHeaders(this.config, this.env),
+        timeoutMs: this.requestTimeoutMs
       });
     } catch (error) {
       if (error instanceof ProviderError) throw error;
@@ -573,6 +587,10 @@ var OpenAICompatibleProvider = class {
         body
       });
     }
+    return response;
+  }
+  async listModels() {
+    const body = await this.rawModelsResponse();
     const entries = extractModelEntries(body, this.config);
     const models = [];
     let skipped = 0;
@@ -615,6 +633,10 @@ var OpenAICompatibleProvider = class {
       }
     };
   }
+  /** Streaming where the gateway supports it (§11). */
+  stream(request, onChunk) {
+    return streamChatCompletion(this.config, request, onChunk, this.env);
+  }
   async healthCheck() {
     const lastCheckedAt = (/* @__PURE__ */ new Date()).toISOString();
     try {
@@ -649,6 +671,7 @@ var OpenAICompatibleProvider = class {
       response = await requestJson(`${this.config.baseUrl}/chat/completions`, {
         method: "POST",
         headers: authHeaders(this.config, this.env),
+        timeoutMs: this.requestTimeoutMs,
         body: {
           model: request.model,
           messages: request.messages,
@@ -693,6 +716,74 @@ var OpenAICompatibleProvider = class {
     };
   }
 };
+async function streamChatCompletion(config, request, onChunk, env = process.env) {
+  const baseUrl = normalizeBaseUrl(config.baseUrl);
+  const timeoutMs = config.timeoutMs ?? DEFAULT_REQUEST_TIMEOUT_MS;
+  let response;
+  try {
+    response = await fetch(`${baseUrl}/chat/completions`, {
+      method: "POST",
+      headers: {
+        accept: "text/event-stream",
+        "content-type": "application/json",
+        ...authHeaders(config, env)
+      },
+      body: JSON.stringify({
+        model: request.model,
+        messages: request.messages,
+        stream: true,
+        ...request.temperature !== void 0 ? { temperature: request.temperature } : {},
+        ...request.maxTokens !== void 0 ? { max_tokens: request.maxTokens } : {}
+      }),
+      signal: AbortSignal.timeout(timeoutMs)
+    });
+  } catch (error) {
+    throw providerTransportError({ provider: config.name, operation: "stream", cause: error });
+  }
+  if (!response.ok) {
+    const body = await response.json().catch(() => void 0);
+    throw providerHttpError({ provider: config.name, operation: "stream", status: response.status, body });
+  }
+  if (!response.body) {
+    throw providerHttpError({
+      provider: config.name,
+      operation: "stream",
+      status: 500,
+      body: { error: { message: "streaming is not supported by this endpoint" } }
+    });
+  }
+  let content = "";
+  let model = request.model;
+  let finishReason;
+  const decoder = new TextDecoder();
+  let buffer = "";
+  for await (const piece of response.body) {
+    buffer += decoder.decode(piece, { stream: true });
+    let newline = buffer.indexOf("\n");
+    while (newline >= 0) {
+      const line = buffer.slice(0, newline).trim();
+      buffer = buffer.slice(newline + 1);
+      newline = buffer.indexOf("\n");
+      if (line.length === 0 || line.startsWith(":")) continue;
+      const data = line.startsWith("data:") ? line.slice(5).trim() : line;
+      if (data === "[DONE]") continue;
+      let event;
+      try {
+        event = JSON.parse(data);
+      } catch {
+        continue;
+      }
+      if (typeof event.model === "string") model = event.model;
+      const choices = Array.isArray(event.choices) ? event.choices : [];
+      const first = choices[0];
+      const delta = typeof first?.delta?.content === "string" ? first.delta.content : "";
+      if (delta.length > 0) content += delta;
+      if (typeof first?.finish_reason === "string") finishReason = first.finish_reason;
+      onChunk({ delta, ...finishReason !== void 0 ? { finishReason } : {}, raw: event });
+    }
+  }
+  return { model, content, ...finishReason !== void 0 ? { finishReason } : {} };
+}
 function normalizeModalities(value) {
   const list = Array.isArray(value) ? value : typeof value === "string" ? [value] : void 0;
   if (!list) return void 0;
@@ -726,10 +817,32 @@ function inferHealth(error) {
 
 // src/providers/omnihilbras/index.ts
 var OmniHilbrasProvider = class extends OpenAICompatibleProvider {
+  gateway;
+  async listModels() {
+    const raw = await this.rawModelsResponse();
+    await this.extractGatewayMetadata(raw);
+    const models = await super.listModels();
+    return this.gateway ? models.map((model) => ({ ...model, metadata: { ...model.metadata, gateway: this.gateway } })) : models;
+  }
   /**
    * Run the full connect flow. Throws on authentication or transport failure
    * (use healthCheck() for a non-throwing probe).
    */
+  /**
+   * Gateway metadata reported alongside the model list (gateway version, tier,
+   * region…), kept separate from per-model metadata (§11 — provider metadata).
+   */
+  gatewayMetadata() {
+    return this.gateway;
+  }
+  async extractGatewayMetadata(body) {
+    if (body !== null && typeof body === "object") {
+      const gateway = body.gateway;
+      if (gateway !== null && typeof gateway === "object") {
+        this.gateway = gateway;
+      }
+    }
+  }
   async connectAndRegister(registry) {
     const apiKey = resolveApiKey(this.config);
     const discovered = await this.listModels();
@@ -3477,7 +3590,7 @@ var ProjectStores = class {
 };
 
 // src/version.ts
-var OMNINODE_VERSION = "2.0.0-alpha.6";
+var OMNINODE_VERSION = "2.0.0-alpha.7";
 export {
   AgentAdapterRegistry,
   AgentError,