@fenixforce/kernel 0.1.0

package/dist/index.d.ts

@@ -0,0 +1,227 @@
+export { createTelegramChannelAdapter, splitMessage, statusIcon, formatElapsed, } from "./channels/telegram.js";
+export type { STTProvider, TTSProvider, AdapterMode, ModeIndicator, TelegramAdapterConfig, TelegramChannelAdapter, MessageEnvelope, MessageHandler, Attachment, TaskInfo, JobInfo, PendingApproval, InlineKeyboardMarkup, InlineKeyboardButton, TelegramUpdate, TelegramMessage, TelegramUser, TelegramChat, TelegramCallbackQuery, TelegramPhotoSize, TelegramDocument, TelegramVoice, } from "./channels/telegram.js";
+export { JobQueue, JobWorker, createWorkerPool, createJobRouter, LOCAL_JOB_TYPES, } from "./jobs/index.js";
+export type { Job, JobStatus, JobPriority, JobOptions, JobQueueConfig, JobType, JobHandler, JobWorkerConfig, WorkerPool, WorkerPoolOptions, JobRouter, ToolRoute, } from "./jobs/index.js";
+export { createKnowledgeGraphStore, extractEntitiesAndRelations, createGraphToolRouter, _resetGraphIds, } from "./memory/knowledge-graph.js";
+export type { EntityType, RelationType, Entity, Relation, EntityUpdate, ExtractedEntity, ExtractedRelation, ExtractionResult, LLMCompleteFn, KnowledgeGraphStore, GraphToolRouter, } from "./memory/knowledge-graph.js";
+export { ENTITY_TYPES, RELATION_TYPES, } from "./memory/knowledge-graph.js";
+export { createCostMeter, _resetMeterIds, } from "./billing/cost-meter.js";
+export type { BudgetPeriod, ModelPricing, TokenUsage, UsageRecord, BudgetConfig, UserBudget, MeterEventType, MeterEvent, MeterEventListener, PreCallCheck, PeriodSummary, ModelBreakdown, DashboardData, CostMeter, } from "./billing/cost-meter.js";
+export { createApprovalGate, createInMemoryApprovalStore, createTelegramApprovalSender, createVoiceApprovalSender, createHttpApprovalHandlers, _resetApprovalIds, } from "./security/approval-gates.js";
+export type { RiskLevel, ApprovalStatus, ApprovalRequest, ApprovalResult, ApprovalPolicy, ChannelSender, ApprovalStore, ApprovalEventType, ApprovalEvent, ApprovalEventListener, HttpApprovalInfo, ApprovalGateConfig, ApprovalGate, TelegramSenderConfig, VoiceSenderConfig, HttpApprovalHandlers, } from "./security/approval-gates.js";
+export { createInstructionHierarchy, applyWebIsolation, containsWebIsolation, stripWebIsolation, WEB_ISOLATION_PREFIX, WEB_ISOLATION_SUFFIX, } from "./security/instruction-hierarchy.js";
+export type { InstructionSource, TaggedContent, SensitiveAction, ConfirmationRequest, ConfirmationHandler, ValidationVerdict, ValidationResult, HierarchyEventType, HierarchyEvent, HierarchyEventListener, InstructionHierarchyConfig, InstructionHierarchy, } from "./security/instruction-hierarchy.js";
+export { createOpenAICompatHandler, validateRequest, _resetCompletionIds, } from "./api/openai-compat.js";
+export type { ChatRole, ChatMessage, ChatCompletionRequest, ChatCompletionChoice, CompletionUsage, ChatCompletionResponse, ChatCompletionChunkDelta, ChatCompletionChunkChoice, ChatCompletionChunk, AgentCompletionResult, AgentCompletionFn, AgentStreamFn, CompatEventType, CompatEvent, CompatEventListener, ValidationError, OpenAICompatConfig, OpenAICompatHandler, } from "./api/openai-compat.js";
+export { createWebhookHandler, verifyGitHubSignature, verifyStripeSignature, verifyGenericAuth, safeEqual, extractWebhookContent, createWebhookEnvelope, } from "./api/webhook-triggers.js";
+export type { WebhookMessageEnvelope, WebhookProvider, GitHubWebhookConfig, StripeWebhookConfig, GenericWebhookConfig, WebhookConfig, WebhookRegistration, WebhookRequest, WebhookResult, WebhookEventType, WebhookEvent, WebhookEventListener, WebhookJobQueue, WebhookHandlerConfig, WebhookHandler, } from "./api/webhook-triggers.js";
+export { createScheduledWebhookJob, isWebhookJob, } from "./scheduler/webhook-handler.js";
+export type { ScheduledWebhookJob, } from "./scheduler/webhook-handler.js";
+export { createSchedulerEngine, parseCronExpression, nextCronTime, _resetEngineIds, } from "./scheduler/engine.js";
+export type { CronField, ScheduleType, CronSchedule, OnceSchedule, RecurringSchedule, Schedule, ScheduledEntry, SchedulerEngineConfig, SchedulerEngine, } from "./scheduler/engine.js";
+export { createPlannedTaskScheduler, _resetTaskIds, } from "./jobs/planned-tasks.js";
+export type { PlannedStepStatus, PlannedTaskStatus, PlannedStep, PlannedTask, PlannedStepInput, CreatePlannedTaskInput, SchedulerJobQueue, SchedulerEventType, SchedulerEvent, SchedulerEventListener, PlannedTaskSchedulerConfig, PlannedTaskScheduler, } from "./jobs/planned-tasks.js";
+export { createToolAccessControl, EDITION_PRO, EDITION_MOBILE, EDITION_VOICES, } from "./security/tool-access-control.js";
+export type { ToolCategory, ToolDefinition, EditionName, EditionManifest, AgentRole, AgentConfig, AccessVerdict, AccessCheckResult, AccessEventType, AccessEvent, AccessEventListener, ToolAccessControlConfig, ToolAccessControl, } from "./security/tool-access-control.js";
+export type { WorkspaceToolConfig, EditionToolConfig, ACLCheckResult, } from "./tools/access-control.js";
+export { chunkText, } from "./content/chunker.js";
+export type { ChunkOptions, TextChunk, } from "./content/chunker.js";
+export { createContentPipeline, _resetPipelineIds, } from "./content/pipeline.js";
+export type { ContentType, PipelineStage, ContentSource, IndexedChunk, SearchResult, ContentExtractor, EmbedProvider, PipelineJobQueue, PipelineEventType, PipelineEvent, PipelineEventListener, UploadRequest, HttpResult, ContentPipelineConfig, ContentPipeline, } from "./content/pipeline.js";
+export { createOCREngine, DEFAULT_PROVIDER_CASCADE, } from "./content/ocr.js";
+export type { OCRProviderName, OCRProvider, OCRInput, BoundingBox, OCRTextBlock, OCRResult, OCREventType, OCREvent, OCREventListener, OCREngineConfig, OCREngine, } from "./content/ocr.js";
+export { createEntityExtractor, } from "./content/entity-extractor.js";
+export type { EntityExtractionConfig, ChunkExtractionResult, BatchExtractionResult, EntityExtractorEventType, EntityExtractorEvent, EntityExtractorEventListener, EntityExtractor, } from "./content/entity-extractor.js";
+export { createCheckpointManager, _resetCheckpointIds, } from "./checkpoint.js";
+export type { CheckpointMessage, Checkpoint, CheckpointEventType, CheckpointEvent, CheckpointEventListener, CheckpointManagerConfig, CheckpointManager, } from "./checkpoint.js";
+export { createDualSearch, } from "./memory/dual-search.js";
+export type { DualSearchResult, SearchBackendResult, BM25SearchFn, SemanticSearchFn, DualSearchConfig, DualSearchEventType, DualSearchEvent, DualSearchEventListener, DualSearch, } from "./memory/dual-search.js";
+export { createTreeIndexManager, _resetTreeIds, } from "./memory/tree-index.js";
+export type { TreeNode, TreeIndex, NavigationStep, TreeSearchResult, SummarizeFn, NavigateFn, TreeEventType, TreeEvent, TreeEventListener, TreeIndexConfig, TreeIndexManager, } from "./memory/tree-index.js";
+export { createDashboard, _resetDashboardIds, } from "./api/dashboard.js";
+export type { ActivityEntry, ActivityFilter, ActivityFeed, CalendarTask, CalendarQuery, TaskCalendar, SearchScope, GlobalSearchResult, GlobalSearchOpts, GlobalSearchFn, DashboardStats, ProviderStatus, CostBreakdown, JobStatus as DashboardJobStatus, DashboardConfig, Dashboard, } from "./api/dashboard.js";
+export { createMissionControl, } from "./mission-control.js";
+export type { MissionControlConfig, MissionControl, } from "./mission-control.js";
+export { createInterruptState, createInterruptManager, } from "./interrupt.js";
+export type { InterruptState, InterruptResult, ResumeRequest, ResumeResult, InterruptEventType, InterruptEvent, InterruptEventListener, InterruptManagerConfig, InterruptManager, } from "./interrupt.js";
+export { createInterventionPipeline, } from "./extensions/intervention.js";
+export type { InterventionMessage, InterventionAction, InterventionHandler, InterventionEventType, InterventionEvent, InterventionEventListener, InterventionPipeline, } from "./extensions/intervention.js";
+export { createSecretStore, } from "./security/secret-store.js";
+export type { EncryptedCredential, SecretStoreConfig, SecretStore, } from "./security/secret-store.js";
+export { createKeyRotator, } from "./providers/key-rotation.js";
+export type { KeyRotationConfig, KeyRotator, } from "./providers/key-rotation.js";
+export { discoverModels, } from "./providers/auto-discover.js";
+export type { DiscoveryTarget, DiscoveryResult, } from "./providers/auto-discover.js";
+export { evaluateWriteGate, createTemporalValidity, invalidate as invalidateTemporal, isValid as isTemporallyValid, filterValid as filterTemporallyValid, } from "./memory/write-gate.js";
+export type { TemporalValidity, WriteGateInput, WriteGateResult, ExistingMemory, FetchExistingFn, WriteGateConfig, } from "./memory/write-gate.js";
+export { detectWidgetSources, dispatchWidgets, } from "./pre-classifier-widgets.js";
+export type { WidgetSource, WidgetResult, ParallelWidgetConfig, WidgetDetectFn, } from "./pre-classifier-widgets.js";
+export { createRuntimeProviderCRUD, _resetProviderIds, } from "./providers/runtime-crud.js";
+export type { ProviderEntry, CreateProviderInput, UpdateProviderInput, TestResult, ProviderFactory, RuntimeProviderCRUDConfig, RuntimeProviderCRUD, } from "./providers/runtime-crud.js";
+export { registerAPIRoutes, wireWebSocket } from "./channels/http-api.js";
+export type { APIHandlers, HTTPAPIConfig, StatelessRequest, StatelessResponse, } from "./channels/http-api.js";
+import { EventBus as _EventBus } from "./events/bus.js";
+import { SessionManager as _SessionManager } from "./events/session-manager.js";
+export { _EventBus as EventBus };
+export type { EventHandler, ErrorHandler } from "./events/bus.js";
+export { _SessionManager as SessionManager };
+export type { Session, SessionManagerConfig, EventListener } from "./events/session-manager.js";
+export { EventBlockManager } from "./events/block-manager.js";
+export type { BlockManagerConfig } from "./events/block-manager.js";
+export { bootKernel } from "./boot.js";
+export type { BootConfig, BootDeps, RunningKernel, KernelHealth } from "./boot.js";
+export { agentLoop, BlockManager as AgentBlockManager } from "./agent-loop.js";
+export type { AgentLoopConfig, QueryClassifier, QueryClassificationResult } from "./agent-loop.js";
+export { createPreClassifier } from "./pre-classifier.js";
+export { repairSession } from "./session-repair.js";
+export { contextOverflowRecovery, contextOverflowCheck, estimateTokens as estimateMessageTokens } from "./context-overflow.js";
+export type { OverflowContext, OverflowResult } from "./context-overflow.js";
+export { LoopGuard } from "./loop-guard.js";
+export type { LoopGuardResult } from "./loop-guard.js";
+export { sessionCompact, sessionCompactWithEvents, shouldCompact } from "./session-compaction.js";
+export type { CompactionStrategy, CompactionContext, CompactionResult } from "./session-compaction.js";
+export { TaskTrackerImpl, planWithEvents, updateWithEvents, _resetTaskIdCounter } from "./task-tracker.js";
+export { wrapup } from "./wrapup.js";
+export type { WrapupInput } from "./wrapup.js";
+export { qualityGates } from "./quality-gates.js";
+export type { ConditionFn, QualityGateInput } from "./quality-gates.js";
+export { sessionOrient } from "./session-orient.js";
+export type { OrientContext, OrientResult } from "./session-orient.js";
+export { ProviderManager } from "./providers/manager.js";
+export type { ProviderSlot } from "./providers/interface.js";
+export { OpenAICompatibleProvider } from "./providers/openai-compatible.js";
+export type { OpenAICompatibleConfig } from "./providers/openai-compatible.js";
+export { AnthropicProvider } from "./providers/anthropic.js";
+export { GoogleProvider } from "./providers/google.js";
+export { BedrockProvider } from "./providers/bedrock.js";
+export { autoDetectProviders, listSupportedProviders } from "./providers/auto-detect.js";
+export type { DetectedProvider, AutoDetectResult } from "./providers/auto-detect.js";
+export { createOpenAICompatibleStream } from "./providers/stream-wrapper.js";
+export type { ChatCompletionChunk as StreamChunk, TokenUsage as StreamTokenUsage } from "./providers/stream-wrapper.js";
+export { verifiedGenerateObject, StructuredOutputError } from "./providers/structured-verify.js";
+export type { VerifyOptions, VerifyResult } from "./providers/structured-verify.js";
+export { repairJson, parsePartialJson } from "./providers/json-repair.js";
+export { SidecarLifecycle } from "./providers/sidecar-lifecycle.js";
+export { ModelRegistry, loadDefaultRegistry, createRegistry } from "./providers/model-registry.js";
+export { ExtensionManager } from "./extensions/manager.js";
+export type { ExtensionDefinition, ExtensionAPI } from "./extensions/manager.js";
+export { ExtensionRunner, createExtensionRunner } from "./extensions/runner.js";
+export { registerSessionRepair } from "./extensions/defaults/05-session-repair.js";
+export { registerLogging } from "./extensions/defaults/10-logging.js";
+export { registerLoopGuard } from "./extensions/defaults/15-loop-guard.js";
+export { registerCostTracking } from "./extensions/defaults/20-cost-tracking.js";
+export { registerSsrfProtection } from "./extensions/defaults/25-ssrf-protection.js";
+export { registerRateLimiting } from "./extensions/defaults/30-rate-limiting.js";
+export { registerShellBleed } from "./extensions/defaults/35-shell-bleed.js";
+export { registerObservationCapture } from "./extensions/defaults/40-observation-capture.js";
+export { registerContextSurvival } from "./extensions/defaults/45-context-survival.js";
+export { registerContextBudget } from "./extensions/defaults/50-context-budget.js";
+export { registerSteeringRules } from "./extensions/defaults/55-steering-rules.js";
+export { registerQualityGates } from "./extensions/defaults/60-quality-gates.js";
+export { createJobDispatchExtension, getDispatchedJobs } from "./extensions/defaults/65-job-dispatch.js";
+export { createSkillLoaderExtension } from "./extensions/defaults/70-skill-loader.js";
+export { ToolRegistry } from "./tools/registry.js";
+export type { ToolDefinition as RegistryToolDefinition, ToolContext, ToolHandler, ParameterDef } from "./tools/registry.js";
+export { ToolRouter } from "./tools/router.js";
+export type { ToolCall, ToolResult } from "./tools/router.js";
+export { BrowserEngine } from "./tools/browser-engine.js";
+export type { BrowserPage, Browser, BrowserLauncher, NavigateResult, ExtractResult } from "./tools/browser-engine.js";
+export { discoverSkills, extractFrontmatter, formatSkillForAgent, searchSkills } from "./tools/skill-discovery.js";
+export type { Skill, SkillValidationError } from "./tools/skill-discovery.js";
+export { LazySkillRegistry, loadSkillsLazy, loadSkills } from "./tools/skill-loader.js";
+export type { SkillLoaderConfig, SkillLoadResult, SkillStub } from "./tools/skill-loader.js";
+export type { SkillDefinition, SkillCategory, McpServerRef } from "./tools/skill-types.js";
+export { createMemoryTools } from "./tools/routers/memory-router.js";
+export { createWebTools } from "./tools/routers/web-router.js";
+export { createCodeTools } from "./tools/routers/code-router.js";
+export { createFileTools } from "./tools/routers/file-router.js";
+export { createScheduleTools } from "./tools/routers/schedule-router.js";
+export { createTaskPlanTools } from "./tools/routers/task-router.js";
+export { createBrowserTools } from "./tools/routers/browser-router.js";
+export { loadProfile, loadProfileFromObject, interpolateEnv, ConfigError } from "./config/loader.js";
+export { loadSteeringRules, resolveRules } from "./config/steering-rules.js";
+export type { SteeringRule, SteeringRuleSet, RuleKind, ConversationContext } from "./config/steering-rules.js";
+export { createStorage } from "./storage/index.js";
+export type { StorageAdapter } from "./storage/interface.js";
+export { createPostgresStorage } from "./storage/postgres.js";
+export type { PostgresStorageConfig } from "./storage/postgres.js";
+export { createSqliteStorage } from "./storage/sqlite.js";
+export { buildSystemPrompt } from "./prompt/system-prompt.js";
+export type { SystemPromptInput } from "./prompt/system-prompt.js";
+export { allocateBudget, truncateToTokenBudget } from "./prompt/context-budget.js";
+export type { BudgetAllocation, SectionSizes } from "./prompt/context-budget.js";
+export { ANTI_VERBOSITY_MINIMAL, ANTI_VERBOSITY_NORMAL, ANTI_VERBOSITY_DETAILED, VERBOSITY_TEMPLATES, INSTRUCTION_HIERARCHY, BASE_IDENTITY, } from "./prompt/templates.js";
+export type { VerbosityLevel } from "./prompt/templates.js";
+export { IdentityAssembler } from "./identity/assembler.js";
+export type { IdentityBlock, AssemblerOptions } from "./identity/assembler.js";
+export { parseSoul } from "./identity/soul-parser.js";
+export type { SoulConfig } from "./identity/soul-parser.js";
+export { parsePersona } from "./identity/persona-parser.js";
+export type { PersonaConfig } from "./identity/persona-parser.js";
+export { extractTraits, renderUserBlock } from "./identity/user-populator.js";
+export type { UserTraits } from "./identity/user-populator.js";
+export { importCharacterCard, exportCharacterCard } from "./identity/ccc-adapter.js";
+export type { CharacterCardV3, IdentityFiles } from "./identity/ccc-adapter.js";
+export { ProgressiveSearch } from "./memory/progressive-search.js";
+export type { ProgressiveSearchConfig, KeywordSearchFn, EmbeddingSearchFn } from "./memory/progressive-search.js";
+export { BrainArtifactManager, STANDARD_ARTIFACTS } from "./memory/brain-artifacts.js";
+export { recordObservation, retrieveObservations, recordObservationWithEvents, retrieveObservationsWithEvents, resetAccessCounts, DEFAULT_OBSERVATION_CONFIG, } from "./memory/observation-store.js";
+export type { ObservationCategory, ObservationInput, ObservationStoreConfig } from "./memory/observation-store.js";
+export { immediateMemorySave, immediateMemorySaveWithEvents } from "./memory/mid-conversation-saves.js";
+export type { ImmediateSaveInput, ImmediateSaveContext } from "./memory/mid-conversation-saves.js";
+export { detectTensions, checkObservationThresholds, DEFAULT_REVIEW_CONFIG } from "./memory/observation-thresholds.js";
+export type { ObservationReviewConfig, ObservationReviewResult } from "./memory/observation-thresholds.js";
+export { SidecarManager } from "./voice/sidecar-manager.js";
+export type { SidecarConfig, SidecarState } from "./voice/sidecar-manager.js";
+export { SpeechQueue } from "./voice/speech-intent.js";
+export type { SpeechIntent, SpeechEventType, SpeechEventHandler } from "./voice/speech-intent.js";
+export { parseMarkers, stripMarkers, DEFAULT_VOCABULARY } from "./voice/marker-parser.js";
+export type { MarkerSegment, MarkerVocabulary } from "./voice/marker-parser.js";
+export { createJobQueue, createJobWorker, _resetIdCounter } from "./jobs/memory-queue.js";
+export type { MemoryJobWorker, MemoryWorkerOptions } from "./jobs/memory-queue.js";
+export { HookManager, registerDefaultGuardRails, _resetHookState } from "./hooks/hook-manager.js";
+export { dangerousCommandBlocker, syntaxChecker, contextWindowMonitor, autonomousDecisionEnforcer, setSessionUnattended } from "./hooks/hook-manager.js";
+export type { HookEvent, HookAction, HookContext as LifecycleHookContext, HookHandler as LifecycleHookHandler, HookRegistrationOptions, RegisteredHook, } from "./hooks/hook-types.js";
+export { createResult, mergeTokenUsage } from "./agent/execution-result.js";
+export type { FinishReason, TokenUsage as ExecutionTokenUsage, ExecutionResult } from "./agent/execution-result.js";
+export { StopController, createFleetStopController } from "./loop/stop-controller.js";
+export { MarkdownStore } from "./memory/markdown-store.js";
+export type { FileSystem, NoteIndex, NoteIndexResult, FileWatcher, MarkdownStoreConfig, MarkdownStoreEventType, MarkdownStoreEvent, MarkdownStoreEventHandler, } from "./memory/markdown-store.js";
+export { parseNote, parseFrontmatter, parseObservations, parseRelations, serializeNote } from "./memory/note-parser.js";
+export type { NoteFrontmatter, Observation as NoteObservation, NoteRelation, Note } from "./memory/note-parser.js";
+export { filtersToSQL, matchesFilters } from "./memory/metadata-filter.js";
+export type { FilterValue, MetadataFilters } from "./memory/metadata-filter.js";
+export { MobileHILChannel, HILTimeoutError, createInMemoryHILStore, _resetHILIds } from "./channels/mobile-hil.js";
+export type { HILQuestion, HILAnswer, HILStatus, HILRecord, HILEventType, HILEvent, HILEventHandler, PushNotificationSender, PushNotificationPayload, HILStore, MobileHILConfig, } from "./channels/mobile-hil.js";
+export { MCPToolExecutor, withHeartbeat, MCPTimeoutError, DEFAULT_HEARTBEAT_CONFIG } from "./mcp/tool-executor.js";
+export type { HeartbeatConfig, MCPProgressNotification, ProgressCallback, MCPToolCall, MCPToolResult, MCPToolHandler, MCPNotificationSender, MCPToolExecutorConfig, } from "./mcp/tool-executor.js";
+export { Fenix, createFenix } from "./sdk/index.js";
+export { FenixClient, FenixAPIError } from "./sdk/client.js";
+export { FenixAgent } from "./sdk/agent.js";
+export { FenixJobs } from "./sdk/jobs.js";
+export { FenixMemory } from "./sdk/memory.js";
+export type { FenixConfig, AgentOptions, AgentResult, StreamEvent, ToolCallRecord, JobSubmission as SDKJobSubmission, JobStatus as SDKJobStatus, MemoryEntry, MemorySearchOptions, MemoryWriteOptions, } from "./sdk/types.js";
+export declare const KERNEL_VERSION = "0.1.0";
+export interface KernelConfig {
+    /** Edition name (pro, voices, mobile, or custom). */
+    edition: string;
+    /** Channels to enable. */
+    channels?: string[];
+    /** Tool categories available. */
+    tools?: string[];
+    /** Domain-specific layers to load. */
+    layers?: string[];
+}
+export interface Kernel {
+    readonly edition: string;
+    readonly version: string;
+    readonly config: KernelConfig;
+    readonly bus: _EventBus;
+    readonly sessions: _SessionManager;
+}
+/**
+ * Create a lightweight Kernel instance from a config.
+ * For a fully-wired kernel with providers, tools, and agent loop,
+ * use `bootKernel()` instead.
+ */
+export declare function createKernel(config: KernelConfig): Kernel;