@almadar/agent 2.0.0 → 2.0.2

package/dist/index.d.ts

@@ -0,0 +1,59 @@
+/**
+ * @almadar/agent
+ *
+ * AI agent infrastructure for Almadar orbital schema generation.
+ *
+ * Provides everything needed to create, run, checkpoint, and resume
+ * skill-based agents. Uses @almadar/llm for LLM access and
+ * @almadar/skills for prompt sections.
+ *
+ * Key modules:
+ * - Agent factory: createSkillAgent(), resumeSkillAgent()
+ * - Session management: SessionManager with pluggable backends
+ * - Persistence: Memory + Firestore backends for checkpoints & sessions
+ * - Event transformer: Raw LangGraph events → typed SSE events
+ * - Tools: execute, validate, orbital subagent, domain, chunking
+ *
+ * @packageDocumentation
+ */
+export type { AgentDependencies, SubAgent, CombineOrbitalsFn, CombinerOptions, CombinerResult, ConvertDomainToSchemaFn, DomainConversionResult, GenerateFullOrbitalFn, OrbitalGenerationResult, OrbitalGenerationOptions, GenerationLog, } from './types.js';
+export { createSSEEvent, formatSSEEvent, parseSSEEvent, isSSEStartEvent, isSSEMessageEvent, isSSEInterruptEvent, isSSECompleteEvent, isSSEErrorEvent, isSSEToolCallEvent, isSSETodoUpdateEvent, isSSETodoDetailEvent, isSSESubagentEvent, isSSEGenerationLogEvent, ExtractedRequirementsSchema, GenerateRequestSchema, ResumeRequestSchema, ContinueRequestSchema, } from './api-types.js';
+export type { SSEEvent, SSEEventType, GenerateRequest, ResumeRequest, ContinueRequest, ExtractedRequirementsInput, StartEvent, MessageEvent, ToolCallEvent, ToolResultEvent, TodoUpdateEvent, ErrorEvent, CompleteEvent, SubagentEvent, GenerationLogEvent, InterruptEvent, } from './api-types.js';
+export { createAgentTools, createExecuteTool, validateCommandPaths, createValidateSchemaTool, createGenerateSchemaTool, createFinishTaskTool, createCombineSchemasTool, createOrbitalSubagentTool, createSubagentEventWrapper, createTraitSubagentTool, createTraitEventWrapper, createGenerateOrbitalDomainTool, createConstructCombinedDomainTool, createDomainOrbitalTools, createQuerySchemaStructureTool, createExtractChunkTool, createApplyChunkTool, createSchemaChunkingTools, } from './tools/index.js';
+export type { SubagentEventCallback, OrbitalCompleteCallback, OrbitalRequirements, OrbitalSubagentToolOptions, TraitEventCallback, TraitCompleteCallback, TraitSubagentToolOptions, TraitSpec, DomainOrbitalEventCallback, DomainOrbitalCompleteCallback, DomainOrbitalToolOptions, DomainOrbitalSpec, } from './tools/index.js';
+export { combineOrbitals, combineOrbitalsToSchema, estimateCombineComplexity, } from './orbitals/combiner/index.js';
+export type { CombinerOptions as OrbitalCombinerOptions, CombinerResult as OrbitalCombinerResult, OrbitalSchemaValidationResult, } from './orbitals/combiner/index.js';
+export { convertDomainToSchema, applySectionUpdate, deleteSection, convertSchemaToDomain, } from './orbitals/domain-language/index.js';
+export type { DomainToSchemaResult, SchemaToDomainResult, DomainDocument, ParseError, SectionMapping, } from './orbitals/domain-language/index.js';
+export { generateFullOrbital, estimateCacheSavings, } from './orbitals/generation/index.js';
+export { createSubagents, createSubagentConfigs, createSchemaGeneratorSubagent, createErrorFixerSubagent, createTestAnalyzerSubagent, } from './subagents.js';
+export { parseDeepAgentEvent, isStartEvent, isExecutionEvent, isSchemaEvent, isCompleteEvent, isErrorEvent, } from './events.js';
+export type { DeepAgentEvent, DeepAgentStartEvent, DeepAgentExecutionEvent, DeepAgentSchemaEvent, DeepAgentCompleteEvent, DeepAgentErrorEvent, } from './events.js';
+export { needsCompaction, createSummaryPrompt, estimateTokens, DEFAULT_COMPACTION_CONFIG, } from './context-compaction.js';
+export type { ContextCompactionConfig, } from './context-compaction.js';
+export { MetricsCollector, formatSummary, analyzeFailures, } from './metrics.js';
+export type { GenerationMetrics, MetricsSummary, } from './metrics.js';
+export { createSkillAgent, resumeSkillAgent, Command, SessionManager, EVENT_BUDGETS, getEventBudget, getBudgetWarningMessage, getInterruptConfig, } from './agent/index.js';
+export type { Skill, SkillLoader, SkillRefLoader, SkillAgentOptions, SkillAgentResult, SessionMetadata, SessionRecord, PersistenceMode, SessionManagerOptions, SkillMeta, } from './agent/index.js';
+export { MemorySessionBackend, FirestoreCheckpointer, FirestoreSessionStore, FirestoreStore, } from './persistence/index.js';
+export type { FirestoreCheckpointerOptions, FirestoreDb, FirestoreTimestamp, FirestoreSessionStoreOptions, FirestoreStoreOptions, Session, } from './persistence/index.js';
+export { transformAgentEvent, transformAgentEventMulti, hasInterrupt, extractInterruptData, isTodoUpdate, isFileOperation, extractFileOperation, } from './event-transformer/index.js';
+export type { RawAgentEvent, } from './event-transformer/index.js';
+export { MemoryOrbitalSchema, MemoryManager, PreferenceLearner, createPreferenceLearner, AgenticSearchEngine, createAgenticSearchEngine, ObservabilityCollector, getObservabilityCollector, resetObservabilityCollector, recordEvent, startObservabilitySession, endObservabilitySession, getPerformanceSnapshot, MultiUserManager, getMultiUserManager, resetMultiUserManager, createUserContext, isAdmin, requireOwnership, StateSyncManager, getStateSyncManager, resetStateSyncManager, withSync, debounceSync, } from './memory/index.js';
+export type { UserPreference, GenerationSession, ProjectContext, UserFeedback, PatternAffinity, InterruptRecord, ToolApprovalPreference, CheckpointRecord, MemoryManagerOptions, PreferenceLearnerOptions, InferredPreference, PreferenceAnalysis, SearchStrategy, AgenticSearchParams, SearchResult, AgenticSearchResponse, ObservableEventType, ObservableEvent, SessionTelemetry, PerformanceSnapshot, HealthCheckResult, UserContext, ScopedSessionMetadata, AccessCheckResult, UserSessionStats, StateChangeType, StateChangeEvent, VersionVector, StateSyncSnapshot, ConflictResolution, StateSyncConfig, } from './memory/index.js';
+export { OnlineEvalSampler, createOnlineEvalSampler, reviewSamples, } from './evals/online-sampling.js';
+export type { SamplingConfig, EvalSample, ErrorAlert, SamplingStats, ReviewOptions, } from './evals/online-sampling.js';
+export { WorkflowEngine, WorkflowBuilder, createWorkflowEngine, createSchemaGenerationWorkflow, } from './tools/composition.js';
+export type { ToolStep, ToolStepStatus, WorkflowContext, WorkflowDefinition, WorkflowExecutionResult, ParallelExecutionResult, ToolExecutor, } from './tools/composition.js';
+export { createWorkflowToolWrapper, createEvalWorkflowWrapper, } from './agent/workflow-tool-wrapper.js';
+export type { WorkflowToolWrapperOptions, ToolTelemetry, WorkflowToolWrapper, } from './agent/workflow-tool-wrapper.js';
+export { classifyComplexity, estimateComplexity, getExecutionStrategy, routeGeneration, quickComplexityCheck, } from './orchestration/index.js';
+export type { ComplexityLevel, ComplexityResult, RouteConfig, GenerationResult, DecomposedUnit, } from './orchestration/index.js';
+export { AuditLog, issueToken, verifyToken, isTokenValid, consumeToken, revokeToken, ThresholdAuthorizer, RateLimiter, CircuitBreaker, CircuitState, } from './utils/safety/index.js';
+export type { AuditEntry, CapabilityToken, TokenParams, ApprovalRequest, VoteResult, RateLimitConfig, CircuitBreakerConfig, } from './utils/safety/index.js';
+export { WorkspaceManager, SinkManager, GitClient, GitSink, FirestoreSink, WORKSPACE_LAYOUT, createUserOrbTemplate, createProjectOrbTemplate, createSchemaOrbTemplate, serializeOrb, parseOrb, readOrbInstances, readOrb, writeOrbInstances, writeOrb, } from './workspace/index.js';
+export type { WorkspaceSink, WorkspaceConfig, FileMeta, SinkResult, MemorySnapshot, FirestoreSinkConfig, GitLogEntry, GitStatus, } from './workspace/index.js';
+export { executeSandboxed } from './tools/sandbox-executor.js';
+export type { SandboxOptions, SandboxResult } from './tools/sandbox-executor.js';
+export { classifyCommand, TOOL_GATES, CRITICAL_COMMAND_PATTERNS } from './agent/interrupt-config.js';
+export type { ActionGate } from './agent/interrupt-config.js';