@nexus-cortex/core 4.26.0

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/index.js

@@ -0,0 +1,73 @@
+/**
+ * @nexus-cortex/core - Core orchestration library implementing Claude CLI architecture
+ *
+ * This package provides:
+ * - Conversation compaction with 9-section summaries
+ * - Content-addressable file checkpoints
+ * - Deterministic system-reminder injection
+ * - JSONL-based session storage
+ * - Multi-provider LLM orchestration
+ * - Helper model middleware with automatic fallback
+ * - Timeline-based conversation tracking
+ * - Historical context retrieval tools
+ */
+// Phase 1.5 Week 1: Multi-Provider Architecture
+// Adapter exports
+export * from './adapters/index.js';
+// Model registry exports
+export * from './models/index.js';
+// Phase 1.5 Week 2: Context Management & Helper Models
+// Conversation compaction exports
+// Note: CompactionResult conflict with middleware - use explicit import from needed module
+export { ContextBudgetManager, StoredCompactionManager } from './conversation/index.js';
+// Middleware exports (selective to avoid conflicts)
+export { HelperModelMiddleware, ErrorClassificationMiddleware, RetryMiddleware, PermissionsMiddleware, SystemMessageMiddleware, MentorshipMiddleware, 
+// Permissions system
+WhitelistPolicy, BlacklistPolicy, FileOperationPolicy, BashCommandPolicy, CLIApprovalHandler, AutoApproveHandler, DenyAllHandler, IPCApprovalHandler, // For sub-agent permission forwarding
+PermissionAuditLogger, PermissionEvaluator, PermissionConfigLoader, PermissionPresets, 
+// File-backed permission profile editing (headless CLI persistence)
+resolvePermissionProfilePath, grantToolInProfile, revokeToolInProfile, listProfilePolicies, getApprovalHandlerFromProfile, setApprovalHandlerInProfile, readPermissionProfile, resolvePermissionWriteTarget } from './middleware/index.js';
+// Phase 1.5 Week 3: Timeline & Historical Retrieval
+// Session management exports
+// Note: CheckpointOptions, ResumeOptions conflict with orchestrator
+// Note: CanonicalMessage conflict with adapters - both define it
+export { SessionTimeline, CheckpointManager, JSONLHistoryStore } from './session/index.js';
+// Tool definitions exports
+export * from './tools/index.js';
+// MCP infrastructure exports
+export * from './mcp/index.js';
+// Configuration system exports
+export * from './config/index.js';
+// Phase 2: Orchestrator
+// Orchestrator exports
+export * from './orchestrator/index.js';
+// Phase 1: Core Components (if integrated)
+// File checkpoint exports
+export * from './file-tracking/index.js';
+// System-reminder exports
+export * from './system-messages/index.js';
+// Agent management exports
+export * from './agents/index.js';
+// Slash command system exports
+export * from './commands/index.js';
+// Utility exports
+export * from './utils/index.js';
+// Shared UI types (for model pickers, session pickers, etc.)
+export * from './ui/index.js';
+// Training / routing
+export { ModelRouterMatrix, estimateCost as estimateModelCost, resolveMaxMatrixBytes } from './training/ModelRouterMatrix.js';
+export { classifyTask } from './training/TaskClassifier.js';
+export { ResearchBacklog, computePriority as computeDeficiencyPriority } from './training/ResearchBacklog.js';
+export { ExperimentLedger } from './training/ExperimentLedger.js';
+export { compareVersions, regressionScan, toTaskResult } from './training/VersionComparison.js';
+export { decideExperiment, bootstrapCI, permutationPValue, sidakThreshold, mcFwerThreshold, aggregateEffect, mulberry32, } from './training/AutoResearchStats.js';
+export { evaluateExperiment as evaluateAutoResearchExperiment, verifyOnHoldout } from './training/AutoResearchGate.js';
+export { thompsonSelect } from './training/ThompsonRouter.js';
+export { gradeRun, runBench, parseTaskSet } from './training/BenchRunner.js';
+export { runExperiment } from './training/ExperimentRunner.js';
+// Runtime-agnostic interfaces (Phase 0 — I/O boundary abstraction)
+// Namespaced to avoid conflicts with existing middleware PermissionDecision/PermissionPolicy exports
+export * as RuntimeInterfaces from './interfaces/index.js';
+// Node.js runtime adapters (wraps existing services behind runtime-agnostic interfaces)
+export { NodeConfigProvider, NodeHistoryStoreAdapter, NodeToolExecutorAdapter, NodePermissionAdapter } from './adapters/node/index.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,gDAAgD;AAChD,kBAAkB;AAClB,cAAc,qBAAqB,CAAC;AAEpC,yBAAyB;AACzB,cAAc,mBAAmB,CAAC;AAElC,uDAAuD;AACvD,kCAAkC;AAClC,2FAA2F;AAC3F,OAAO,EAAE,oBAAoB,EAAE,uBAAuB,EAAE,MAAM,yBAAyB,CAAC;AAExF,oDAAoD;AACpD,OAAO,EACL,qBAAqB,EACrB,6BAA6B,EAC7B,eAAe,EACf,qBAAqB,EACrB,uBAAuB,EACvB,oBAAoB;AACpB,qBAAqB;AACrB,eAAe,EACf,eAAe,EACf,mBAAmB,EACnB,iBAAiB,EACjB,kBAAkB,EAClB,kBAAkB,EAClB,cAAc,EACd,kBAAkB,EAAE,sCAAsC;AAC1D,qBAAqB,EACrB,mBAAmB,EACnB,sBAAsB,EACtB,iBAAiB;AACjB,oEAAoE;AACpE,4BAA4B,EAC5B,kBAAkB,EAClB,mBAAmB,EACnB,mBAAmB,EACnB,6BAA6B,EAC7B,2BAA2B,EAC3B,qBAAqB,EACrB,4BAA4B,EAC7B,MAAM,uBAAuB,CAAC;AAa/B,oDAAoD;AACpD,6BAA6B;AAC7B,oEAAoE;AACpE,iEAAiE;AACjE,OAAO,EAAE,eAAe,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAG3F,2BAA2B;AAC3B,cAAc,kBAAkB,CAAC;AAEjC,6BAA6B;AAC7B,cAAc,gBAAgB,CAAC;AAE/B,+BAA+B;AAC/B,cAAc,mBAAmB,CAAC;AAElC,wBAAwB;AACxB,uBAAuB;AACvB,cAAc,yBAAyB,CAAC;AAExC,2CAA2C;AAC3C,0BAA0B;AAC1B,cAAc,0BAA0B,CAAC;AAEzC,0BAA0B;AAC1B,cAAc,4BAA4B,CAAC;AAE3C,2BAA2B;AAC3B,cAAc,mBAAmB,CAAC;AAElC,+BAA+B;AAC/B,cAAc,qBAAqB,CAAC;AAEpC,kBAAkB;AAClB,cAAc,kBAAkB,CAAC;AAEjC,6DAA6D;AAC7D,cAAc,eAAe,CAAC;AAE9B,qBAAqB;AACrB,OAAO,EAAE,iBAAiB,EAAE,YAAY,IAAI,iBAAiB,EAAE,qBAAqB,EAAE,MAAM,iCAAiC,CAAC;AAE9H,OAAO,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAC;AAE5D,OAAO,EAAE,eAAe,EAAE,eAAe,IAAI,yBAAyB,EAAE,MAAM,+BAA+B,CAAC;AAE9G,OAAO,EAAE,gBAAgB,EAAE,MAAM,gCAAgC,CAAC;AAElE,OAAO,EAAE,eAAe,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,iCAAiC,CAAC;AAEhG,OAAO,EACL,gBAAgB,EAAE,WAAW,EAAE,iBAAiB,EAAE,cAAc,EAAE,eAAe,EACjF,eAAe,EAAE,UAAU,GAC5B,MAAM,iCAAiC,CAAC;AAEzC,OAAO,EAAE,kBAAkB,IAAI,8BAA8B,EAAE,eAAe,EAAE,MAAM,gCAAgC,CAAC;AAEvH,OAAO,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAE9D,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAK7E,OAAO,EAAE,aAAa,EAAE,MAAM,gCAAgC,CAAC;AAK/D,mEAAmE;AACnE,qGAAqG;AACrG,OAAO,KAAK,iBAAiB,MAAM,uBAAuB,CAAC;AAE3D,wFAAwF;AACxF,OAAO,EAAE,kBAAkB,EAAE,uBAAuB,EAAE,uBAAuB,EAAE,qBAAqB,EAAE,MAAM,0BAA0B,CAAC"}

package/dist/interfaces/APITransport.d.ts

@@ -0,0 +1,120 @@
+/**
+ * APITransport Interface
+ *
+ * Abstracts HTTP communication with AI provider APIs.
+ * Format conversion is handled separately by format adapters (already browser-safe).
+ * This interface only handles the HTTP transport layer.
+ *
+ * Node.js impl: wraps APIClient (uses @anthropic-ai/sdk, openai, @google/generative-ai)
+ * Browser impl: uses fetch() + CORS proxy
+ *
+ * @module interfaces/APITransport
+ */
+import type { ModelConfig } from '@nexus-cortex/types';
+import type { CanonicalToolUse } from '@nexus-cortex/types';
+/**
+ * Provider-agnostic API response
+ */
+export interface APIResponse {
+    /** Provider-specific response object */
+    data: any;
+    /** HTTP status code */
+    status: number;
+    /** Response headers */
+    headers: Record<string, string>;
+}
+/**
+ * Stream chunk for real-time UI updates
+ */
+export interface StreamChunk {
+    /** Chunk type */
+    type: 'text_delta' | 'content_block_start' | 'content_block_delta' | 'content_block_stop' | 'message_start' | 'message_delta' | 'message_stop' | 'tool_use_complete' | 'tool_result' | 'thinking_delta' | 'error';
+    /** Chunk data (provider-specific) */
+    data?: any;
+    /** Text delta (for text chunks) */
+    delta?: string;
+    /** Accumulated snapshot (optional) */
+    snapshot?: string;
+    /** Tool use block (for type === 'tool_use_complete') */
+    toolUse?: CanonicalToolUse;
+    /** Tool result (for type === 'tool_result') */
+    toolResult?: {
+        tool_use_id: string;
+        tool_name: string;
+        content: string;
+        is_error?: boolean;
+        metadata?: any;
+    };
+    /** Error details (for type === 'error') */
+    error?: {
+        type: string;
+        message: string;
+    };
+}
+/**
+ * Streaming response — composite of chunk generator + final assembled message.
+ *
+ * IMPORTANT: This is NOT just an AsyncGenerator. The finalMessage promise
+ * resolves after the stream completes and provides assembled metadata,
+ * thinking block assembly, token usage, etc.
+ */
+export interface StreamingResponse {
+    /** Async generator for real-time chunks */
+    chunks: AsyncGenerator<StreamChunk, void, unknown>;
+    /** Promise that resolves to final accumulated message */
+    finalMessage: Promise<any>;
+}
+/**
+ * Prepared request — format-converted and ready for HTTP transmission.
+ * Created by GatewayTranslationLayer (already browser-safe).
+ */
+export interface PreparedRequest {
+    /** Provider-specific messages */
+    messages: unknown[];
+    /** Provider-specific tools (if applicable) */
+    tools?: unknown[];
+    /** Request headers */
+    headers: Record<string, string>;
+    /** Request parameters */
+    parameters: Record<string, unknown>;
+    /** System message (handled separately for some providers) */
+    systemMessage?: string;
+    /** Model ID to use */
+    modelId: string;
+    /** Previous response ID for stateful Responses API chaining (XAI, OpenAI) */
+    previousResponseId?: string;
+    /**
+     * Conversation/session identifier for cache-routing.
+     * Used as `x-grok-conv-id` header (Chat Completions / Messages API) and
+     * `prompt_cache_key` body field (Responses API). Maximizes XAI cache hits
+     * by routing same-session requests to the same server.
+     */
+    conversationId?: string;
+}
+/**
+ * API Transport — HTTP layer abstraction for AI provider communication.
+ *
+ * Handles sending requests and receiving responses from AI provider APIs.
+ * Format conversion is NOT this interface's concern — that's handled by
+ * the format adapters (MessagesAPIAdapter, ChatCompletionsAPIAdapter, etc.)
+ * which are already browser-compatible pure TypeScript.
+ */
+export interface APITransport {
+    /**
+     * Send a non-streaming request to an AI provider.
+     *
+     * @param request - Format-converted request ready for transmission
+     * @param modelConfig - Model configuration (determines endpoint, auth, etc.)
+     * @returns Provider-specific response
+     */
+    sendRequest(request: PreparedRequest, modelConfig: ModelConfig): Promise<APIResponse>;
+    /**
+     * Send a streaming request to an AI provider.
+     *
+     * @param request - Format-converted request ready for transmission
+     * @param modelConfig - Model configuration (determines endpoint, auth, etc.)
+     * @returns Composite of chunk generator + final message promise
+     */
+    streamRequest(request: PreparedRequest, modelConfig: ModelConfig): StreamingResponse;
+}
+//# sourceMappingURL=APITransport.d.ts.map

package/dist/interfaces/APITransport.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"APITransport.d.ts","sourceRoot":"","sources":["../../src/interfaces/APITransport.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AACvD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAE5D;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,wCAAwC;IACxC,IAAI,EAAE,GAAG,CAAC;IACV,uBAAuB;IACvB,MAAM,EAAE,MAAM,CAAC;IACf,uBAAuB;IACvB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACjC;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,iBAAiB;IACjB,IAAI,EACA,YAAY,GACZ,qBAAqB,GACrB,qBAAqB,GACrB,oBAAoB,GACpB,eAAe,GACf,eAAe,GACf,cAAc,GACd,mBAAmB,GACnB,aAAa,GACb,gBAAgB,GAChB,OAAO,CAAC;IAEZ,qCAAqC;IACrC,IAAI,CAAC,EAAE,GAAG,CAAC;IAEX,mCAAmC;IACnC,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf,sCAAsC;IACtC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB,wDAAwD;IACxD,OAAO,CAAC,EAAE,gBAAgB,CAAC;IAE3B,+CAA+C;IAC/C,UAAU,CAAC,EAAE;QACX,WAAW,EAAE,MAAM,CAAC;QACpB,SAAS,EAAE,MAAM,CAAC;QAClB,OAAO,EAAE,MAAM,CAAC;QAChB,QAAQ,CAAC,EAAE,OAAO,CAAC;QACnB,QAAQ,CAAC,EAAE,GAAG,CAAC;KAChB,CAAC;IAEF,2CAA2C;IAC3C,KAAK,CAAC,EAAE;QACN,IAAI,EAAE,MAAM,CAAC;QACb,OAAO,EAAE,MAAM,CAAC;KACjB,CAAC;CACH;AAED;;;;;;GAMG;AACH,MAAM,WAAW,iBAAiB;IAChC,2CAA2C;IAC3C,MAAM,EAAE,cAAc,CAAC,WAAW,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC;IACnD,yDAAyD;IACzD,YAAY,EAAE,OAAO,CAAC,GAAG,CAAC,CAAC;CAC5B;AAED;;;GAGG;AACH,MAAM,WAAW,eAAe;IAC9B,iCAAiC;IACjC,QAAQ,EAAE,OAAO,EAAE,CAAC;IACpB,8CAA8C;IAC9C,KAAK,CAAC,EAAE,OAAO,EAAE,CAAC;IAClB,sBAAsB;IACtB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAChC,yBAAyB;IACzB,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACpC,6DAA6D;IAC7D,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,sBAAsB;IACtB,OAAO,EAAE,MAAM,CAAC;IAEhB,6EAA6E;IAC7E,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAE5B;;;;;OAKG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,YAAY;IAC3B;;;;;;OAMG;IACH,WAAW,CAAC,OAAO,EAAE,eAAe,EAAE,WAAW,EAAE,WAAW,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;IAEtF;;;;;;OAMG;IACH,aAAa,CAAC,OAAO,EAAE,eAAe,EAAE,WAAW,EAAE,WAAW,GAAG,iBAAiB,CAAC;CACtF"}

package/dist/interfaces/APITransport.js

@@ -0,0 +1,14 @@
+/**
+ * APITransport Interface
+ *
+ * Abstracts HTTP communication with AI provider APIs.
+ * Format conversion is handled separately by format adapters (already browser-safe).
+ * This interface only handles the HTTP transport layer.
+ *
+ * Node.js impl: wraps APIClient (uses @anthropic-ai/sdk, openai, @google/generative-ai)
+ * Browser impl: uses fetch() + CORS proxy
+ *
+ * @module interfaces/APITransport
+ */
+export {};
+//# sourceMappingURL=APITransport.js.map

package/dist/interfaces/APITransport.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"APITransport.js","sourceRoot":"","sources":["../../src/interfaces/APITransport.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG"}

package/dist/interfaces/ConfigProvider.d.ts

@@ -0,0 +1,52 @@
+/**
+ * ConfigProvider Interface
+ *
+ * Abstracts configuration / environment variable access.
+ * The orchestrator reads configuration for model selection, feature flags,
+ * tool limits, mentorship settings, etc.
+ *
+ * Node.js impl: wraps SettingsLoader (reads .env files via dotenv, process.env)
+ * Browser impl: reads from localStorage or host-provided settings
+ *
+ * @module interfaces/ConfigProvider
+ */
+/**
+ * Config Provider — read-only configuration access.
+ *
+ * Provides key-value access to settings. The orchestrator only reads
+ * configuration — write operations (e.g., writeEnvSetting) are
+ * CLI/UI concerns and not part of this interface.
+ */
+export interface ConfigProvider {
+    /**
+     * Get a configuration value by key.
+     *
+     * @param key - Setting name (e.g., 'DEFAULT_MODEL_ID', 'MAX_TOOL_ITERATIONS')
+     * @returns Setting value or undefined if not set
+     */
+    get(key: string): string | undefined;
+    /**
+     * Get a required configuration value. Throws if not set.
+     *
+     * @param key - Setting name
+     * @returns Setting value
+     * @throws Error if setting is not configured
+     */
+    getRequired(key: string): string;
+    /**
+     * Get all configuration as a key-value map.
+     *
+     * @returns All settings (both explicitly set and defaults)
+     */
+    getAll(): Record<string, string | undefined>;
+    /**
+     * Get configuration merged with schema defaults.
+     *
+     * Returns a fully-populated settings object where every known key
+     * has a value (either from configuration or from SettingsSchema defaults).
+     *
+     * @returns All settings with defaults applied
+     */
+    getMerged(): Record<string, string>;
+}
+//# sourceMappingURL=ConfigProvider.d.ts.map

package/dist/interfaces/ConfigProvider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ConfigProvider.d.ts","sourceRoot":"","sources":["../../src/interfaces/ConfigProvider.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH;;;;;;GAMG;AACH,MAAM,WAAW,cAAc;IAC7B;;;;;OAKG;IACH,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC;IAErC;;;;;;OAMG;IACH,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAAC;IAEjC;;;;OAIG;IACH,MAAM,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC;IAE7C;;;;;;;OAOG;IACH,SAAS,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACrC"}

package/dist/interfaces/ConfigProvider.js

@@ -0,0 +1,14 @@
+/**
+ * ConfigProvider Interface
+ *
+ * Abstracts configuration / environment variable access.
+ * The orchestrator reads configuration for model selection, feature flags,
+ * tool limits, mentorship settings, etc.
+ *
+ * Node.js impl: wraps SettingsLoader (reads .env files via dotenv, process.env)
+ * Browser impl: reads from localStorage or host-provided settings
+ *
+ * @module interfaces/ConfigProvider
+ */
+export {};
+//# sourceMappingURL=ConfigProvider.js.map

package/dist/interfaces/ConfigProvider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ConfigProvider.js","sourceRoot":"","sources":["../../src/interfaces/ConfigProvider.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG"}

package/dist/interfaces/CredentialResolver.d.ts

@@ -0,0 +1,57 @@
+/**
+ * CredentialResolver Interface
+ *
+ * Abstracts API key and credential resolution for AI providers.
+ * The orchestrator needs credentials to authenticate with provider APIs.
+ *
+ * Node.js impl: wraps AnthropicCredentialService (reads files, env vars, OAuth tokens)
+ * Browser impl: wraps SecretsService (reads from encrypted storage / user input)
+ *
+ * @module interfaces/CredentialResolver
+ */
+/**
+ * Authentication method preference.
+ *
+ * - 'oauth': Prefer OAuth token (e.g., OAuth token flow)
+ * - 'api-key': Use API key from environment or secrets
+ * - 'auto': Try OAuth first, fall back to API key
+ */
+export type AuthMethod = 'oauth' | 'api-key' | 'auto';
+/**
+ * Resolved credential — the result of credential lookup.
+ */
+export interface CredentialResult {
+    /** How the credential authenticates */
+    type: 'oauth' | 'api-key';
+    /** The credential value (API key or OAuth token) */
+    token: string;
+    /** Where the credential was found (for debugging) */
+    source: string;
+    /** Expiration timestamp in ms (for OAuth tokens that expire) */
+    expiresAt?: number;
+}
+/**
+ * Credential Resolver — API key / token resolution abstraction.
+ *
+ * Resolves credentials for AI providers. Each implementation handles
+ * its own storage mechanism (env vars, files, encrypted stores, etc.).
+ */
+export interface CredentialResolver {
+    /**
+     * Load a credential for a provider.
+     *
+     * @param provider - Provider name (e.g., 'anthropic', 'openai', 'google', 'xai')
+     * @param authMethod - Authentication method preference (default: 'auto')
+     * @returns Resolved credential
+     * @throws Error if no credential is available
+     */
+    loadCredential(provider: string, authMethod?: AuthMethod): Promise<CredentialResult>;
+    /**
+     * Check if a credential is available for a provider (without loading it).
+     *
+     * @param provider - Provider name
+     * @returns true if a credential can be resolved
+     */
+    hasCredential(provider: string): Promise<boolean>;
+}
+//# sourceMappingURL=CredentialResolver.d.ts.map

package/dist/interfaces/CredentialResolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CredentialResolver.d.ts","sourceRoot":"","sources":["../../src/interfaces/CredentialResolver.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH;;;;;;GAMG;AACH,MAAM,MAAM,UAAU,GAAG,OAAO,GAAG,SAAS,GAAG,MAAM,CAAC;AAEtD;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,uCAAuC;IACvC,IAAI,EAAE,OAAO,GAAG,SAAS,CAAC;IAC1B,oDAAoD;IACpD,KAAK,EAAE,MAAM,CAAC;IACd,qDAAqD;IACrD,MAAM,EAAE,MAAM,CAAC;IACf,gEAAgE;IAChE,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;;;GAKG;AACH,MAAM,WAAW,kBAAkB;IACjC;;;;;;;OAOG;IACH,cAAc,CAAC,QAAQ,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,UAAU,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAAC;IAErF;;;;;OAKG;IACH,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CACnD"}

package/dist/interfaces/CredentialResolver.js

@@ -0,0 +1,13 @@
+/**
+ * CredentialResolver Interface
+ *
+ * Abstracts API key and credential resolution for AI providers.
+ * The orchestrator needs credentials to authenticate with provider APIs.
+ *
+ * Node.js impl: wraps AnthropicCredentialService (reads files, env vars, OAuth tokens)
+ * Browser impl: wraps SecretsService (reads from encrypted storage / user input)
+ *
+ * @module interfaces/CredentialResolver
+ */
+export {};
+//# sourceMappingURL=CredentialResolver.js.map

package/dist/interfaces/CredentialResolver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"CredentialResolver.js","sourceRoot":"","sources":["../../src/interfaces/CredentialResolver.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG"}

package/dist/interfaces/HistoryStore.d.ts

@@ -0,0 +1,108 @@
+/**
+ * HistoryStore Interface
+ *
+ * Abstracts session persistence for conversation history.
+ * The orchestrator uses this for message storage, session management,
+ * and metadata tracking.
+ *
+ * Node.js impl: JSONLHistoryStore (append-only JSONL files via fs/promises)
+ * Browser impl: IndexedDB or host-provided storage
+ *
+ * @module interfaces/HistoryStore
+ */
+import type { CanonicalMessage, SessionMetadata } from '@nexus-cortex/types';
+/**
+ * Session information — summary of a stored session.
+ *
+ * Note: `filePath` and `fileSize` from the Node.js SessionInfo are
+ * implementation-specific (filesystem concepts) and excluded from
+ * the interface. Each implementation handles storage location internally.
+ */
+export interface SessionInfo {
+    /** Session UUID */
+    sessionId: string;
+    /** Session metadata */
+    metadata: SessionMetadata;
+    /** Total messages in session */
+    messageCount: number;
+    /** Last modified timestamp */
+    lastModified: Date;
+}
+/**
+ * History Store — session persistence abstraction.
+ *
+ * Provides CRUD operations for conversation sessions, plus metadata
+ * management for session resume, model switching, and compaction tracking.
+ */
+export interface HistoryStore {
+    /**
+     * Load all messages from a session.
+     *
+     * @param sessionId - Session UUID
+     * @returns Array of canonical messages (empty if session doesn't exist)
+     */
+    loadSession(sessionId: string): Promise<CanonicalMessage[]>;
+    /**
+     * Append a single message to a session (append-only).
+     *
+     * @param sessionId - Session UUID
+     * @param message - Message to append
+     */
+    appendMessage(sessionId: string, message: CanonicalMessage): Promise<void>;
+    /**
+     * Append multiple messages to a session atomically.
+     *
+     * @param sessionId - Session UUID
+     * @param messages - Messages to append
+     */
+    appendMessages(sessionId: string, messages: CanonicalMessage[]): Promise<void>;
+    /**
+     * Overwrite entire session history (used by compaction).
+     *
+     * @param sessionId - Session UUID
+     * @param messages - Complete message array to write
+     */
+    saveSession(sessionId: string, messages: CanonicalMessage[]): Promise<void>;
+    /**
+     * List all available sessions.
+     *
+     * @returns Array of session summaries sorted by lastModified (newest first)
+     */
+    listSessions(): Promise<SessionInfo[]>;
+    /**
+     * Delete a session and its metadata.
+     *
+     * @param sessionId - Session UUID
+     * @returns true if session was deleted, false if it didn't exist
+     */
+    deleteSession(sessionId: string): Promise<boolean>;
+    /**
+     * Check if a session exists.
+     *
+     * @param sessionId - Session UUID
+     * @returns true if session exists
+     */
+    sessionExists(sessionId: string): Promise<boolean>;
+    /**
+     * Save session metadata (model switches, compaction history, cache metrics, etc.).
+     *
+     * @param sessionId - Session UUID
+     * @param metadata - Metadata to persist
+     */
+    saveMetadata(sessionId: string, metadata: SessionMetadata): Promise<void>;
+    /**
+     * Load session metadata.
+     *
+     * @param sessionId - Session UUID
+     * @returns Metadata or null if not found
+     */
+    loadMetadata(sessionId: string): Promise<SessionMetadata | null>;
+    /**
+     * Get session info (summary without loading full message history).
+     *
+     * @param sessionId - Session UUID
+     * @returns Session info or null if not found
+     */
+    getSessionInfo(sessionId: string): Promise<SessionInfo | null>;
+}
+//# sourceMappingURL=HistoryStore.d.ts.map

package/dist/interfaces/HistoryStore.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"HistoryStore.d.ts","sourceRoot":"","sources":["../../src/interfaces/HistoryStore.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAE7E;;;;;;GAMG;AACH,MAAM,WAAW,WAAW;IAC1B,mBAAmB;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,uBAAuB;IACvB,QAAQ,EAAE,eAAe,CAAC;IAC1B,gCAAgC;IAChC,YAAY,EAAE,MAAM,CAAC;IACrB,8BAA8B;IAC9B,YAAY,EAAE,IAAI,CAAC;CACpB;AAED;;;;;GAKG;AACH,MAAM,WAAW,YAAY;IAK3B;;;;;OAKG;IACH,WAAW,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,EAAE,CAAC,CAAC;IAE5D;;;;;OAKG;IACH,aAAa,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAE3E;;;;;OAKG;IACH,cAAc,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,gBAAgB,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAE/E;;;;;OAKG;IACH,WAAW,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,gBAAgB,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAE5E;;;;OAIG;IACH,YAAY,IAAI,OAAO,CAAC,WAAW,EAAE,CAAC,CAAC;IAEvC;;;;;OAKG;IACH,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAEnD;;;;;OAKG;IACH,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAMnD;;;;;OAKG;IACH,YAAY,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAE1E;;;;;OAKG;IACH,YAAY,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC,CAAC;IAEjE;;;;;OAKG;IACH,cAAc,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC,CAAC;CAChE"}

package/dist/interfaces/HistoryStore.js

@@ -0,0 +1,14 @@
+/**
+ * HistoryStore Interface
+ *
+ * Abstracts session persistence for conversation history.
+ * The orchestrator uses this for message storage, session management,
+ * and metadata tracking.
+ *
+ * Node.js impl: JSONLHistoryStore (append-only JSONL files via fs/promises)
+ * Browser impl: IndexedDB or host-provided storage
+ *
+ * @module interfaces/HistoryStore
+ */
+export {};
+//# sourceMappingURL=HistoryStore.js.map

package/dist/interfaces/HistoryStore.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"HistoryStore.js","sourceRoot":"","sources":["../../src/interfaces/HistoryStore.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG"}

package/dist/interfaces/PermissionHandler.d.ts

@@ -0,0 +1,74 @@
+/**
+ * PermissionHandler Interface
+ *
+ * Abstracts tool execution permission evaluation and policy management.
+ * The orchestrator checks permissions before executing each tool call.
+ *
+ * Node.js impl: wraps PermissionEvaluator (3 profiles, 4 policy types, audit logging)
+ * Browser impl: modal-based approval flow (ModalPermissionHandler)
+ *
+ * @module interfaces/PermissionHandler
+ */
+/**
+ * Permission decision — result of evaluating a tool execution request.
+ */
+export interface PermissionDecision {
+    /** Whether execution is allowed */
+    allowed: boolean;
+    /**
+     * Whether the user can override this decision (approval flow).
+     * - true: blocked but user can approve via UI prompt
+     * - false/undefined: decision is final
+     */
+    canApprove?: boolean;
+    /** Human-readable reason for the decision */
+    reason?: string;
+    /** Policy tier that matched (for audit/debugging) */
+    tier?: 'whitelist' | 'graylist' | 'blacklist';
+}
+/**
+ * Permission policy — a rule that evaluates tool execution requests.
+ */
+export interface PermissionPolicy {
+    /** Policy name (for identification and audit) */
+    name: string;
+    /** Policy type */
+    type: 'whitelist' | 'blacklist' | 'file-operation' | 'bash-command';
+    /**
+     * Evaluate whether a tool execution is permitted.
+     *
+     * @param context - Tool execution context
+     * @returns Permission decision
+     */
+    evaluate(context: {
+        toolName: string;
+        toolInput: any;
+        sessionId: string;
+    }): PermissionDecision;
+}
+/**
+ * Permission Handler — tool execution permission abstraction.
+ *
+ * Evaluates whether tool calls should be permitted, denied, or
+ * require user approval. Supports pluggable policies.
+ */
+export interface PermissionHandler {
+    /**
+     * Evaluate a tool execution request against all registered policies.
+     *
+     * @param context - Tool execution context
+     * @returns Permission decision (allowed, denied, or needs approval)
+     */
+    evaluate(context: {
+        toolName: string;
+        toolInput: any;
+        sessionId: string;
+    }): Promise<PermissionDecision>;
+    /**
+     * Register a permission policy.
+     *
+     * @param policy - Policy to add to the evaluation chain
+     */
+    registerPolicy(policy: PermissionPolicy): void;
+}
+//# sourceMappingURL=PermissionHandler.d.ts.map

package/dist/interfaces/PermissionHandler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PermissionHandler.d.ts","sourceRoot":"","sources":["../../src/interfaces/PermissionHandler.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,mCAAmC;IACnC,OAAO,EAAE,OAAO,CAAC;IACjB;;;;OAIG;IACH,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,6CAA6C;IAC7C,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,qDAAqD;IACrD,IAAI,CAAC,EAAE,WAAW,GAAG,UAAU,GAAG,WAAW,CAAC;CAC/C;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,iDAAiD;IACjD,IAAI,EAAE,MAAM,CAAC;IACb,kBAAkB;IAClB,IAAI,EAAE,WAAW,GAAG,WAAW,GAAG,gBAAgB,GAAG,cAAc,CAAC;IACpE;;;;;OAKG;IACH,QAAQ,CAAC,OAAO,EAAE;QAChB,QAAQ,EAAE,MAAM,CAAC;QACjB,SAAS,EAAE,GAAG,CAAC;QACf,SAAS,EAAE,MAAM,CAAC;KACnB,GAAG,kBAAkB,CAAC;CACxB;AAED;;;;;GAKG;AACH,MAAM,WAAW,iBAAiB;IAChC;;;;;OAKG;IACH,QAAQ,CAAC,OAAO,EAAE;QAChB,QAAQ,EAAE,MAAM,CAAC;QACjB,SAAS,EAAE,GAAG,CAAC;QACf,SAAS,EAAE,MAAM,CAAC;KACnB,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAAC;IAEhC;;;;OAIG;IACH,cAAc,CAAC,MAAM,EAAE,gBAAgB,GAAG,IAAI,CAAC;CAChD"}

package/dist/interfaces/PermissionHandler.js

@@ -0,0 +1,13 @@
+/**
+ * PermissionHandler Interface
+ *
+ * Abstracts tool execution permission evaluation and policy management.
+ * The orchestrator checks permissions before executing each tool call.
+ *
+ * Node.js impl: wraps PermissionEvaluator (3 profiles, 4 policy types, audit logging)
+ * Browser impl: modal-based approval flow (ModalPermissionHandler)
+ *
+ * @module interfaces/PermissionHandler
+ */
+export {};
+//# sourceMappingURL=PermissionHandler.js.map

package/dist/interfaces/PermissionHandler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"PermissionHandler.js","sourceRoot":"","sources":["../../src/interfaces/PermissionHandler.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG"}