@axiom-lattice/core 2.1.99 → 2.1.100
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/dist/index.d.mts +257 -1
- package/dist/index.d.ts +257 -1
- package/dist/index.js +240 -9
- package/dist/index.js.map +1 -1
- package/dist/index.mjs +238 -10
- package/dist/index.mjs.map +1 -1
- package/package.json +1 -1
package/dist/index.d.mts
CHANGED
|
@@ -7591,4 +7591,260 @@ declare class ConnectionRegistry {
|
|
|
7591
7591
|
private static ensureStore;
|
|
7592
7592
|
}
|
|
7593
7593
|
|
|
7594
|
-
|
|
7594
|
+
/**
|
|
7595
|
+
* Export/Import shared type definitions.
|
|
7596
|
+
*
|
|
7597
|
+
* @module @axiom-lattice/core/export_import/types
|
|
7598
|
+
*/
|
|
7599
|
+
/** A single exported entity within the JSON bundle. */
|
|
7600
|
+
interface ExportableEntity {
|
|
7601
|
+
_exportId: string;
|
|
7602
|
+
data: Record<string, unknown>;
|
|
7603
|
+
}
|
|
7604
|
+
/** Top-level export JSON format written to file. */
|
|
7605
|
+
interface ExportBundle {
|
|
7606
|
+
version: 1;
|
|
7607
|
+
exportedAt: string;
|
|
7608
|
+
sourceTenantId: string;
|
|
7609
|
+
entities: Record<string, ExportableEntity[]>;
|
|
7610
|
+
dependencyOrder: string[];
|
|
7611
|
+
_warning?: string;
|
|
7612
|
+
}
|
|
7613
|
+
/** Describes a registered exportable entity type to the frontend. */
|
|
7614
|
+
interface ExportableTypeInfo {
|
|
7615
|
+
entityType: string;
|
|
7616
|
+
label: string;
|
|
7617
|
+
category: 'core' | 'plugin';
|
|
7618
|
+
dependsOn: string[];
|
|
7619
|
+
cascadeParents: string[];
|
|
7620
|
+
}
|
|
7621
|
+
/** Result of a single conflict check. */
|
|
7622
|
+
interface ConflictItem {
|
|
7623
|
+
_exportId: string;
|
|
7624
|
+
entityType: string;
|
|
7625
|
+
conflictType: 'id_exists' | 'unique_constraint';
|
|
7626
|
+
existingName?: string;
|
|
7627
|
+
existingId?: string;
|
|
7628
|
+
field?: string;
|
|
7629
|
+
}
|
|
7630
|
+
/** Result of a single insertion (no conflict). */
|
|
7631
|
+
interface InsertionItem {
|
|
7632
|
+
_exportId: string;
|
|
7633
|
+
entityType: string;
|
|
7634
|
+
name: string;
|
|
7635
|
+
}
|
|
7636
|
+
/** Error detected during preview. */
|
|
7637
|
+
interface PreviewError {
|
|
7638
|
+
_exportId: string;
|
|
7639
|
+
entityType: string;
|
|
7640
|
+
error: string;
|
|
7641
|
+
}
|
|
7642
|
+
/** Combined result from import preview. */
|
|
7643
|
+
interface ImportPreviewResult {
|
|
7644
|
+
conflicts: ConflictItem[];
|
|
7645
|
+
insertions: InsertionItem[];
|
|
7646
|
+
errors: PreviewError[];
|
|
7647
|
+
}
|
|
7648
|
+
/** User's resolution decision for a single conflict. */
|
|
7649
|
+
type ResolutionAction = 'skip' | 'overwrite' | 'rename';
|
|
7650
|
+
interface Resolution {
|
|
7651
|
+
_exportId: string;
|
|
7652
|
+
action: ResolutionAction;
|
|
7653
|
+
newId?: string;
|
|
7654
|
+
}
|
|
7655
|
+
/** Result of importing a single entity. */
|
|
7656
|
+
type ImportEntityStatus = 'created' | 'updated' | 'skipped' | 'failed';
|
|
7657
|
+
interface ImportEntityResult {
|
|
7658
|
+
_exportId: string;
|
|
7659
|
+
entityType: string;
|
|
7660
|
+
status: ImportEntityStatus;
|
|
7661
|
+
newId?: string;
|
|
7662
|
+
error?: string;
|
|
7663
|
+
}
|
|
7664
|
+
/** Combined result from import apply. */
|
|
7665
|
+
interface ImportApplyResult {
|
|
7666
|
+
results: ImportEntityResult[];
|
|
7667
|
+
idMap: Record<string, string>;
|
|
7668
|
+
}
|
|
7669
|
+
/** Export job tracking (in-memory, ephemeral). */
|
|
7670
|
+
interface ExportJob {
|
|
7671
|
+
jobId: string;
|
|
7672
|
+
tenantId: string;
|
|
7673
|
+
bundle: ExportBundle;
|
|
7674
|
+
createdAt: Date;
|
|
7675
|
+
}
|
|
7676
|
+
/**
|
|
7677
|
+
* Definition for a single exportable entity type.
|
|
7678
|
+
* Plugins and built-in types register through this interface.
|
|
7679
|
+
*/
|
|
7680
|
+
interface ExportableEntityDefinition {
|
|
7681
|
+
entityType: string;
|
|
7682
|
+
label: string;
|
|
7683
|
+
category: 'core' | 'plugin';
|
|
7684
|
+
dependsOn: string[];
|
|
7685
|
+
cascadeParents: string[];
|
|
7686
|
+
/** List all entities of this type for the given tenant. */
|
|
7687
|
+
listForExport(tenantId: string): Promise<ExportableEntity[]>;
|
|
7688
|
+
/**
|
|
7689
|
+
* Map of field name → referenced entityType. During export, raw IDs in these fields
|
|
7690
|
+
* are replaced with @type/exportId references. During import, IdRemapper reverses this.
|
|
7691
|
+
*/
|
|
7692
|
+
referenceFields?: Record<string, string>;
|
|
7693
|
+
/** Check for conflicts when importing into the target tenant. */
|
|
7694
|
+
previewImport(tenantId: string, entities: ExportableEntity[]): Promise<ImportPreviewResult>;
|
|
7695
|
+
/**
|
|
7696
|
+
* Apply a single entity import.
|
|
7697
|
+
* @param tenantId - Target tenant
|
|
7698
|
+
* @param entity - The entity data with references already remapped by the service
|
|
7699
|
+
* @param resolution - How to handle this entity (skip/overwrite/rename)
|
|
7700
|
+
* @returns The new ID created, or undefined if skipped
|
|
7701
|
+
*/
|
|
7702
|
+
applyImport(tenantId: string, entity: ExportableEntity, resolution: Resolution): Promise<{
|
|
7703
|
+
newId?: string;
|
|
7704
|
+
}>;
|
|
7705
|
+
}
|
|
7706
|
+
|
|
7707
|
+
/**
|
|
7708
|
+
* Singleton registry for exportable entity type definitions.
|
|
7709
|
+
*
|
|
7710
|
+
* Plugins and built-in types register their export/import logic through this
|
|
7711
|
+
* registry. The export/import service discovers registered types at runtime
|
|
7712
|
+
* and orchestrates export, preview, and import operations.
|
|
7713
|
+
*
|
|
7714
|
+
* @example
|
|
7715
|
+
* ```ts
|
|
7716
|
+
* const registry = ExportableEntityRegistry.getInstance();
|
|
7717
|
+
* registry.register({
|
|
7718
|
+
* entityType: 'skill',
|
|
7719
|
+
* label: 'Skills',
|
|
7720
|
+
* category: 'core',
|
|
7721
|
+
* dependsOn: [],
|
|
7722
|
+
* cascadeParents: [],
|
|
7723
|
+
* listForExport: async (tenantId) => [...],
|
|
7724
|
+
* previewImport: async (tenantId, entities) => ({ conflicts: [], insertions: [], errors: [] }),
|
|
7725
|
+
* applyImport: async (tenantId, entity, resolution) => ({ newId: '...' }),
|
|
7726
|
+
* });
|
|
7727
|
+
* ```
|
|
7728
|
+
*
|
|
7729
|
+
* @remarks
|
|
7730
|
+
* - Uses the singleton pattern — there is only one registry instance.
|
|
7731
|
+
* - Registration order does not matter; the DependencyResolver handles ordering.
|
|
7732
|
+
*/
|
|
7733
|
+
declare class ExportableEntityRegistry {
|
|
7734
|
+
private static instance;
|
|
7735
|
+
private definitions;
|
|
7736
|
+
/**
|
|
7737
|
+
* Returns the singleton registry instance, creating it if necessary.
|
|
7738
|
+
*
|
|
7739
|
+
* @returns The singleton {@link ExportableEntityRegistry} instance.
|
|
7740
|
+
*/
|
|
7741
|
+
static getInstance(): ExportableEntityRegistry;
|
|
7742
|
+
/**
|
|
7743
|
+
* Registers an exportable entity type definition.
|
|
7744
|
+
*
|
|
7745
|
+
* @param def - The entity definition to register.
|
|
7746
|
+
*
|
|
7747
|
+
* @throws If an entity type with the same `entityType` is already registered.
|
|
7748
|
+
*/
|
|
7749
|
+
register(def: ExportableEntityDefinition): void;
|
|
7750
|
+
/**
|
|
7751
|
+
* Retrieves a registered entity definition by type name.
|
|
7752
|
+
*
|
|
7753
|
+
* @param entityType - The entity type identifier (e.g. `'skill'`, `'agent'`).
|
|
7754
|
+
*
|
|
7755
|
+
* @returns The registered {@link ExportableEntityDefinition}.
|
|
7756
|
+
*
|
|
7757
|
+
* @throws If no definition is registered for the given type.
|
|
7758
|
+
*/
|
|
7759
|
+
get(entityType: string): ExportableEntityDefinition;
|
|
7760
|
+
/**
|
|
7761
|
+
* Returns lightweight metadata for all registered types (for the frontend).
|
|
7762
|
+
*
|
|
7763
|
+
* @returns An array of {@link ExportableTypeInfo} objects.
|
|
7764
|
+
*/
|
|
7765
|
+
listTypes(): ExportableTypeInfo[];
|
|
7766
|
+
/**
|
|
7767
|
+
* Returns all registered entity definitions.
|
|
7768
|
+
*
|
|
7769
|
+
* @returns An array of all registered {@link ExportableEntityDefinition} objects.
|
|
7770
|
+
*/
|
|
7771
|
+
getAll(): ExportableEntityDefinition[];
|
|
7772
|
+
/**
|
|
7773
|
+
* Removes a registered entity type definition.
|
|
7774
|
+
*
|
|
7775
|
+
* @param entityType - The entity type identifier to remove.
|
|
7776
|
+
*/
|
|
7777
|
+
unregister(entityType: string): void;
|
|
7778
|
+
}
|
|
7779
|
+
|
|
7780
|
+
/**
|
|
7781
|
+
* Resolves topological ordering and CASCADE dependencies across registered
|
|
7782
|
+
* exportable entity types.
|
|
7783
|
+
*
|
|
7784
|
+
* Used during export/import to determine the correct sequence for serialising
|
|
7785
|
+
* and re-creating entities (e.g. skills before agents, parent entities before
|
|
7786
|
+
* children in eval hierarchies).
|
|
7787
|
+
*
|
|
7788
|
+
* @example
|
|
7789
|
+
* ```ts
|
|
7790
|
+
* const defs: ExportableEntityDefinition[] = [
|
|
7791
|
+
* { entityType: 'agent', dependsOn: ['skill'], cascadeParents: [], ... },
|
|
7792
|
+
* { entityType: 'skill', dependsOn: [], cascadeParents: [], ... },
|
|
7793
|
+
* ];
|
|
7794
|
+
* const order = DependencyResolver.resolveOrder(defs);
|
|
7795
|
+
* // order[0] === 'skill', order[1] === 'agent'
|
|
7796
|
+
* ```
|
|
7797
|
+
*/
|
|
7798
|
+
declare class DependencyResolver {
|
|
7799
|
+
/**
|
|
7800
|
+
* Topological sort of entity types based on their {@link ExportableEntityDefinition.dependsOn}
|
|
7801
|
+
* declarations. Entities with no dependencies come first.
|
|
7802
|
+
*
|
|
7803
|
+
* @param defs - All registered exportable entity definitions.
|
|
7804
|
+
* @returns Entity type names in dependency-first order.
|
|
7805
|
+
*/
|
|
7806
|
+
static resolveOrder(defs: ExportableEntityDefinition[]): string[];
|
|
7807
|
+
/**
|
|
7808
|
+
* Given a set of selected entity types, expand to include all CASCADE
|
|
7809
|
+
* parents. Only walks **upward** (parents), never downward (children).
|
|
7810
|
+
*
|
|
7811
|
+
* @param defs - All registered exportable entity definitions.
|
|
7812
|
+
* @param selected - Entity type names the user explicitly chose.
|
|
7813
|
+
* @returns The original selection plus every reachable cascade parent.
|
|
7814
|
+
*/
|
|
7815
|
+
static expandCascade(defs: ExportableEntityDefinition[], selected: string[]): string[];
|
|
7816
|
+
/**
|
|
7817
|
+
* Compute which required dependencies are missing from the selected types.
|
|
7818
|
+
*
|
|
7819
|
+
* Only considers dependencies that are themselves registered as exportable
|
|
7820
|
+
* entity types. Unregistered dependencies (e.g. `Workspace`, `Project` —
|
|
7821
|
+
* infrastructure types) are silently excluded.
|
|
7822
|
+
*
|
|
7823
|
+
* @param defs - All registered exportable entity definitions.
|
|
7824
|
+
* @param selected - Entity type names the user has selected.
|
|
7825
|
+
* @returns The list of entity types that must also be selected (or
|
|
7826
|
+
* auto-included).
|
|
7827
|
+
*/
|
|
7828
|
+
static computeDependencies(defs: ExportableEntityDefinition[], selected: string[]): {
|
|
7829
|
+
missing: string[];
|
|
7830
|
+
};
|
|
7831
|
+
}
|
|
7832
|
+
|
|
7833
|
+
declare class IdRemapper {
|
|
7834
|
+
private readonly idMap;
|
|
7835
|
+
constructor(idMap: Record<string, string>);
|
|
7836
|
+
/**
|
|
7837
|
+
* Deep-traverse an object/array and replace all @type/exportId string values
|
|
7838
|
+
* with their corresponding real IDs from the idMap.
|
|
7839
|
+
* Values not matching the @type/exportId pattern are returned unchanged.
|
|
7840
|
+
*/
|
|
7841
|
+
remapReferences(value: unknown): unknown;
|
|
7842
|
+
/**
|
|
7843
|
+
* Replace raw skill IDs in an agent's graphDefinition.skillIds array.
|
|
7844
|
+
* This handles the implicit agent->skill reference that uses raw skill IDs
|
|
7845
|
+
* (not @type/exportId format). Agents reference skills by their string ID.
|
|
7846
|
+
*/
|
|
7847
|
+
remapSkillIds(graphDefinition: Record<string, unknown>, skillRemap: Record<string, string>): Record<string, unknown>;
|
|
7848
|
+
}
|
|
7849
|
+
|
|
7850
|
+
export { AGENT_TASK_EVENT, type AddMessageParams, Agent, type AgentClient, type AgentExecutor, AgentInstanceManager, type AgentLattice, AgentLatticeManager, type AgentLifecycleEventName, AgentManager, type AgentStreamExecutor, type AgentThreadInterface, BUILTIN_PLUGINS, BUILTIN_SKILLS, type BackendFactory, type BackendProtocol, type BufferStats, type CacheEntry, type CaseRunResult, type Chunk, ChunkBuffer, ChunkBufferLatticeManager, CollectionLatticeManager, type ColumnInfo, CompositeBackend, type ConflictItem, type ConnectAllChannelsOptions, ConnectionRegistry, ConsoleLoggerClient, type CreateSandboxProviderConfig, type CronFields, CustomMetricsClient, type CustomMiddlewareFactory, CustomMiddlewareRegistry, type DatabaseConfig, type DatabaseType, DaytonaInstance, DaytonaProvider, type DaytonaProviderConfig, DefaultScheduleClient, DependencyResolver, E2BInstance, E2BProvider, type E2BProviderConfig, EMPTY_CONTENT_WARNING, type EditResult, type EmbeddingsInfo, type EmbeddingsLatticeInterface, EmbeddingsLatticeManager, type EnsureMicrosandboxInput, type EvalRunService, type ExportBundle, type ExportJob, type ExportableEntity, type ExportableEntityDefinition, ExportableEntityRegistry, type ExportableTypeInfo, type FileData, type FileInfo, FileSystemSkillStore, type FileSystemSkillStoreOptions, FilesystemBackend, type FsEntry, type GrepMatch, type IMessageQueueStore, type IMetricsServerClient, type ISqlDatabase, IdRemapper, type ImportApplyResult, type ImportEntityResult, type ImportEntityStatus, type ImportPreviewResult, InMemoryA2AApiKeyStore, InMemoryAssistantStore, InMemoryBindingStore, InMemoryChannelInstallationStore, InMemoryChunkBuffer, InMemoryCollectionStore, InMemoryDatabaseConfigStore, InMemoryMailboxStore, InMemoryMenuStore, InMemoryTaskListStore, InMemoryTaskStore, InMemoryTenantStore, InMemoryThreadMessageQueueStore, InMemoryThreadStore, InMemoryUserStore, InMemoryUserTenantLinkStore, type InsertionItem, LINE_NUMBER_WIDTH, type LangGraphStateChecker, type LatticeAgentStepConfig, LatticeEval, type LatticeEvalBatchReport, type LatticeEvalCase, type LatticeEvalCaseType, type LatticeEvalCaseWithTemplate, type LatticeEvalConfig, type LatticeEvalLogEvent, type LatticeEvalLogLevel, LatticeEvalProject, type LatticeEvalProjectType, type LatticeEvalResult, type LatticeEvalRubric, LatticeEvalSuite, type LatticeEvalSuiteType, type LatticeEvalTemplate, LocalSandboxInstance, LocalSandboxProvider, type LocalSandboxProviderConfig, type LoggerLattice, LoggerLatticeManager, MAX_LINE_LENGTH, type MailboxMessage, type MailboxStore, type McpLatticeInterface, McpLatticeManager, type McpServerInfo, MemoryBackend, MemoryLatticeManager, MemoryQueueClient, MemoryScheduleStorage, type MessageCompletedEvent, type MessageFailedEvent, type MessageStartedEvent, MessageType, MetricsServerManager, MicrosandboxRemoteInstance, MicrosandboxRemoteProvider, type MicrosandboxRemoteProviderClient, type MicrosandboxRemoteProviderConfig, MicrosandboxServiceClient, type MicrosandboxServiceClientConfig, type MicrosandboxShellExecInput, type ModelConfig, type ModelLatticeInterface, ModelLatticeManager, MysqlDatabase, type OutputType, type PendingMessage, PersonalAssistantConfig, PinoLoggerClient, PluginRegistry, PostgresDatabase, type PreviewError, PrometheusClient, type QueryResult, type QueueLattice, QueueLatticeManager, QueueMode, type QueuePendingEvent, RemoteSandboxInstance, RemoteSandboxProvider, type RemoteSandboxProviderConfig, type Resolution, type ResolutionAction, type ResolveAgentFn, type ResolvedConfig, type RunSandboxConfig, type RuntimeModelConfig, type SandboxFileInfo, type SandboxFileService, SandboxFilesystem, type SandboxInstance, type SandboxIsolationLevel, SandboxLatticeManager, type SandboxManagerProtocol, type SandboxProvider, type SandboxProviderFactory, type SandboxProviderType, type SandboxShellService, SandboxSkillStore, type SandboxSkillStoreOptions, type SandboxVolumeDefinition, type ScheduleLattice, ScheduleLatticeManager, type SchedulerMiddlewareOptions, SemanticMetricsClient, type SharePayload, SimpleMemoryVectorStore, type SkillLattice, SkillLatticeManager, type SkillMeta, type SkillResource, SqlDatabaseManager, type StateAndStore, StateBackend, StoreBackend, type StoreLattice, StoreLatticeManager, type StoreType, type StoreTypeMap, TOOL_RESULT_TOKEN_LIMIT, TRUNCATION_GUIDANCE, type TableInfo, type TableSchema, type TaskEvent, type TaskListStore, type TaskSpec, TaskStatus, type TaskUpdatable, TeamAgentGraphBuilder, type TeamConfig, type TeamMiddlewareOptions, type TeamTask, type TeammateSpec, type TeammateToolsOptions, type ThreadBuffer, type ThreadBufferConfig, type ThreadBusyEvent, type ThreadIdleEvent, type ThreadInfo, type ThreadQueueConfig, type ThreadState, ThreadStatus, type ThreadStatusChangedEvent, TokenCache, type ToolDefinition, type ToolLattice, ToolLatticeManager, type UnknownToolHandlerConfig, type VectorStoreLatticeInterface, VectorStoreLatticeManager, type VectorStoreProviderLattice, VectorStoreProviderManager, VolumeFilesystem, type VolumeFsClient, type WorkflowValidationError, type WriteResult, abortWorkflowRun, agentInstanceManager, agentLatticeManager, buildGrepResultsDict, buildInput, buildNamedVolumeName, buildSandboxMetadataEnv, buildSkillFile, buildStateAnnotation, buildTableName, checkEmptyContent, clearEncryptionKeyCache, clearEvalRunService, collectionLatticeManager, compileInternal, compileWorkflow, computeSandboxName, configureStores, connectAllChannels, createAgentNode, createAgentTeam, createExecuteSqlQueryTool, createFileData, createInfoSqlTool, createListMetricsDataSourcesTool, createListMetricsServersTool, createListTablesSqlTool, createMapNode, createModelSelectorMiddleware, createNodeHandler, createQueryCheckerSqlTool, createQueryMetricDefinitionTool, createQueryMetricsListTool, createQuerySemanticMetricDataTool, createQuerySqlTool, createQueryTableDefinitionTool, createQueryTablesListTool, createResourceAddress, createSandboxProvider, createSchedulerMiddleware, createSharePayload, createTaskMiddleware, createTeamMiddleware, createTeammateTools, createUnknownToolHandlerMiddleware, createWidgetMiddleware, decrypt, describeCronExpression, embeddingsLatticeManager, encrypt, ensureBuiltinAgentsForTenant, evaluateLatticeCaseWithLogs, eventBus, eventBus as eventBusDefault, extractFetcherError, extractOutput, fileDataToString, formatContentWithLineNumbers, formatGrepMatches, formatGrepResults, formatReadResponse, generateToken, getAgentClient, getAgentConfig, getAllAgentConfigs, getAllBuiltInSkillMetas, getAllToolDefinitions, getBindingRegistry, getBuiltInSkillContent, getBuiltInSkillMeta, getBuiltInSkillNames, getCheckpointSaver, getChunkBuffer, getCollectionEntryCount, getEmbeddingsClient, getEmbeddingsLattice, getEncryptionKey, getEvalRunService, getLoggerLattice, getMenuRegistry, getModelLattice, getNextCronTime, getOrCreateCollectionVectorStore, getQueueLattice, getSandBoxManager, getScheduleLattice, getStoreLattice, getToolClient, getToolDefinition, getToolLattice, getVectorStoreClient, getVectorStoreLattice, getVectorStoreProvider, getWorkflowSignal, globSearchFiles, grepMatchesFromFiles, grepSearchFiles, hasChunkBuffer, invokeWithRetry, isBuiltInSkill, isUsingDefaultKey, isValidCronExpression, isValidSandboxName, isValidSkillName, listCollectionEntries, listSandboxProviderTypes, loggerLatticeManager, mcpManager, metricsServerManager, modelLatticeManager, normalizeSandboxName, parallelLimit, parseCronExpression, parseSkillFrontmatter, parseYaml, performStringReplacement, queueLatticeManager, registerAgentLattice, registerAgentLatticeWithTenant, registerAgentLattices, registerCheckpointSaver, registerChunkBuffer, registerEmbeddingsLattice, registerExistingTool, registerLoggerLattice, registerModelLattice, registerQueueLattice, registerSandboxProviderType, registerScheduleLattice, registerStoreLattice, registerTeammateAgent, registerToolLattice, registerVectorStoreLattice, registerVectorStoreProvider, registerWorkflowRun, removeCollectionVectorStore, renderTemplate, resolvePath, sandboxLatticeManager, sanitizeToolCallId, scheduleLatticeManager, serializePluginMeta, setBindingRegistry, setEvalRunService, setMenuRegistry, skillLatticeManager, sqlDatabaseManager, storeLatticeManager, toJsonSchema, toSafeStateExpr, toolLatticeManager, truncateIfTooLong, unregisterTeammateAgent, unregisterWorkflowRun, updateFileData, validateAgentInput, validateDSL, validateEncryptionKey, validatePath, validateSkillName, validateToolInput, vectorStoreLatticeManager, vectorStoreProviderManager };
|
package/dist/index.d.ts
CHANGED
|
@@ -7591,4 +7591,260 @@ declare class ConnectionRegistry {
|
|
|
7591
7591
|
private static ensureStore;
|
|
7592
7592
|
}
|
|
7593
7593
|
|
|
7594
|
-
|
|
7594
|
+
/**
|
|
7595
|
+
* Export/Import shared type definitions.
|
|
7596
|
+
*
|
|
7597
|
+
* @module @axiom-lattice/core/export_import/types
|
|
7598
|
+
*/
|
|
7599
|
+
/** A single exported entity within the JSON bundle. */
|
|
7600
|
+
interface ExportableEntity {
|
|
7601
|
+
_exportId: string;
|
|
7602
|
+
data: Record<string, unknown>;
|
|
7603
|
+
}
|
|
7604
|
+
/** Top-level export JSON format written to file. */
|
|
7605
|
+
interface ExportBundle {
|
|
7606
|
+
version: 1;
|
|
7607
|
+
exportedAt: string;
|
|
7608
|
+
sourceTenantId: string;
|
|
7609
|
+
entities: Record<string, ExportableEntity[]>;
|
|
7610
|
+
dependencyOrder: string[];
|
|
7611
|
+
_warning?: string;
|
|
7612
|
+
}
|
|
7613
|
+
/** Describes a registered exportable entity type to the frontend. */
|
|
7614
|
+
interface ExportableTypeInfo {
|
|
7615
|
+
entityType: string;
|
|
7616
|
+
label: string;
|
|
7617
|
+
category: 'core' | 'plugin';
|
|
7618
|
+
dependsOn: string[];
|
|
7619
|
+
cascadeParents: string[];
|
|
7620
|
+
}
|
|
7621
|
+
/** Result of a single conflict check. */
|
|
7622
|
+
interface ConflictItem {
|
|
7623
|
+
_exportId: string;
|
|
7624
|
+
entityType: string;
|
|
7625
|
+
conflictType: 'id_exists' | 'unique_constraint';
|
|
7626
|
+
existingName?: string;
|
|
7627
|
+
existingId?: string;
|
|
7628
|
+
field?: string;
|
|
7629
|
+
}
|
|
7630
|
+
/** Result of a single insertion (no conflict). */
|
|
7631
|
+
interface InsertionItem {
|
|
7632
|
+
_exportId: string;
|
|
7633
|
+
entityType: string;
|
|
7634
|
+
name: string;
|
|
7635
|
+
}
|
|
7636
|
+
/** Error detected during preview. */
|
|
7637
|
+
interface PreviewError {
|
|
7638
|
+
_exportId: string;
|
|
7639
|
+
entityType: string;
|
|
7640
|
+
error: string;
|
|
7641
|
+
}
|
|
7642
|
+
/** Combined result from import preview. */
|
|
7643
|
+
interface ImportPreviewResult {
|
|
7644
|
+
conflicts: ConflictItem[];
|
|
7645
|
+
insertions: InsertionItem[];
|
|
7646
|
+
errors: PreviewError[];
|
|
7647
|
+
}
|
|
7648
|
+
/** User's resolution decision for a single conflict. */
|
|
7649
|
+
type ResolutionAction = 'skip' | 'overwrite' | 'rename';
|
|
7650
|
+
interface Resolution {
|
|
7651
|
+
_exportId: string;
|
|
7652
|
+
action: ResolutionAction;
|
|
7653
|
+
newId?: string;
|
|
7654
|
+
}
|
|
7655
|
+
/** Result of importing a single entity. */
|
|
7656
|
+
type ImportEntityStatus = 'created' | 'updated' | 'skipped' | 'failed';
|
|
7657
|
+
interface ImportEntityResult {
|
|
7658
|
+
_exportId: string;
|
|
7659
|
+
entityType: string;
|
|
7660
|
+
status: ImportEntityStatus;
|
|
7661
|
+
newId?: string;
|
|
7662
|
+
error?: string;
|
|
7663
|
+
}
|
|
7664
|
+
/** Combined result from import apply. */
|
|
7665
|
+
interface ImportApplyResult {
|
|
7666
|
+
results: ImportEntityResult[];
|
|
7667
|
+
idMap: Record<string, string>;
|
|
7668
|
+
}
|
|
7669
|
+
/** Export job tracking (in-memory, ephemeral). */
|
|
7670
|
+
interface ExportJob {
|
|
7671
|
+
jobId: string;
|
|
7672
|
+
tenantId: string;
|
|
7673
|
+
bundle: ExportBundle;
|
|
7674
|
+
createdAt: Date;
|
|
7675
|
+
}
|
|
7676
|
+
/**
|
|
7677
|
+
* Definition for a single exportable entity type.
|
|
7678
|
+
* Plugins and built-in types register through this interface.
|
|
7679
|
+
*/
|
|
7680
|
+
interface ExportableEntityDefinition {
|
|
7681
|
+
entityType: string;
|
|
7682
|
+
label: string;
|
|
7683
|
+
category: 'core' | 'plugin';
|
|
7684
|
+
dependsOn: string[];
|
|
7685
|
+
cascadeParents: string[];
|
|
7686
|
+
/** List all entities of this type for the given tenant. */
|
|
7687
|
+
listForExport(tenantId: string): Promise<ExportableEntity[]>;
|
|
7688
|
+
/**
|
|
7689
|
+
* Map of field name → referenced entityType. During export, raw IDs in these fields
|
|
7690
|
+
* are replaced with @type/exportId references. During import, IdRemapper reverses this.
|
|
7691
|
+
*/
|
|
7692
|
+
referenceFields?: Record<string, string>;
|
|
7693
|
+
/** Check for conflicts when importing into the target tenant. */
|
|
7694
|
+
previewImport(tenantId: string, entities: ExportableEntity[]): Promise<ImportPreviewResult>;
|
|
7695
|
+
/**
|
|
7696
|
+
* Apply a single entity import.
|
|
7697
|
+
* @param tenantId - Target tenant
|
|
7698
|
+
* @param entity - The entity data with references already remapped by the service
|
|
7699
|
+
* @param resolution - How to handle this entity (skip/overwrite/rename)
|
|
7700
|
+
* @returns The new ID created, or undefined if skipped
|
|
7701
|
+
*/
|
|
7702
|
+
applyImport(tenantId: string, entity: ExportableEntity, resolution: Resolution): Promise<{
|
|
7703
|
+
newId?: string;
|
|
7704
|
+
}>;
|
|
7705
|
+
}
|
|
7706
|
+
|
|
7707
|
+
/**
|
|
7708
|
+
* Singleton registry for exportable entity type definitions.
|
|
7709
|
+
*
|
|
7710
|
+
* Plugins and built-in types register their export/import logic through this
|
|
7711
|
+
* registry. The export/import service discovers registered types at runtime
|
|
7712
|
+
* and orchestrates export, preview, and import operations.
|
|
7713
|
+
*
|
|
7714
|
+
* @example
|
|
7715
|
+
* ```ts
|
|
7716
|
+
* const registry = ExportableEntityRegistry.getInstance();
|
|
7717
|
+
* registry.register({
|
|
7718
|
+
* entityType: 'skill',
|
|
7719
|
+
* label: 'Skills',
|
|
7720
|
+
* category: 'core',
|
|
7721
|
+
* dependsOn: [],
|
|
7722
|
+
* cascadeParents: [],
|
|
7723
|
+
* listForExport: async (tenantId) => [...],
|
|
7724
|
+
* previewImport: async (tenantId, entities) => ({ conflicts: [], insertions: [], errors: [] }),
|
|
7725
|
+
* applyImport: async (tenantId, entity, resolution) => ({ newId: '...' }),
|
|
7726
|
+
* });
|
|
7727
|
+
* ```
|
|
7728
|
+
*
|
|
7729
|
+
* @remarks
|
|
7730
|
+
* - Uses the singleton pattern — there is only one registry instance.
|
|
7731
|
+
* - Registration order does not matter; the DependencyResolver handles ordering.
|
|
7732
|
+
*/
|
|
7733
|
+
declare class ExportableEntityRegistry {
|
|
7734
|
+
private static instance;
|
|
7735
|
+
private definitions;
|
|
7736
|
+
/**
|
|
7737
|
+
* Returns the singleton registry instance, creating it if necessary.
|
|
7738
|
+
*
|
|
7739
|
+
* @returns The singleton {@link ExportableEntityRegistry} instance.
|
|
7740
|
+
*/
|
|
7741
|
+
static getInstance(): ExportableEntityRegistry;
|
|
7742
|
+
/**
|
|
7743
|
+
* Registers an exportable entity type definition.
|
|
7744
|
+
*
|
|
7745
|
+
* @param def - The entity definition to register.
|
|
7746
|
+
*
|
|
7747
|
+
* @throws If an entity type with the same `entityType` is already registered.
|
|
7748
|
+
*/
|
|
7749
|
+
register(def: ExportableEntityDefinition): void;
|
|
7750
|
+
/**
|
|
7751
|
+
* Retrieves a registered entity definition by type name.
|
|
7752
|
+
*
|
|
7753
|
+
* @param entityType - The entity type identifier (e.g. `'skill'`, `'agent'`).
|
|
7754
|
+
*
|
|
7755
|
+
* @returns The registered {@link ExportableEntityDefinition}.
|
|
7756
|
+
*
|
|
7757
|
+
* @throws If no definition is registered for the given type.
|
|
7758
|
+
*/
|
|
7759
|
+
get(entityType: string): ExportableEntityDefinition;
|
|
7760
|
+
/**
|
|
7761
|
+
* Returns lightweight metadata for all registered types (for the frontend).
|
|
7762
|
+
*
|
|
7763
|
+
* @returns An array of {@link ExportableTypeInfo} objects.
|
|
7764
|
+
*/
|
|
7765
|
+
listTypes(): ExportableTypeInfo[];
|
|
7766
|
+
/**
|
|
7767
|
+
* Returns all registered entity definitions.
|
|
7768
|
+
*
|
|
7769
|
+
* @returns An array of all registered {@link ExportableEntityDefinition} objects.
|
|
7770
|
+
*/
|
|
7771
|
+
getAll(): ExportableEntityDefinition[];
|
|
7772
|
+
/**
|
|
7773
|
+
* Removes a registered entity type definition.
|
|
7774
|
+
*
|
|
7775
|
+
* @param entityType - The entity type identifier to remove.
|
|
7776
|
+
*/
|
|
7777
|
+
unregister(entityType: string): void;
|
|
7778
|
+
}
|
|
7779
|
+
|
|
7780
|
+
/**
|
|
7781
|
+
* Resolves topological ordering and CASCADE dependencies across registered
|
|
7782
|
+
* exportable entity types.
|
|
7783
|
+
*
|
|
7784
|
+
* Used during export/import to determine the correct sequence for serialising
|
|
7785
|
+
* and re-creating entities (e.g. skills before agents, parent entities before
|
|
7786
|
+
* children in eval hierarchies).
|
|
7787
|
+
*
|
|
7788
|
+
* @example
|
|
7789
|
+
* ```ts
|
|
7790
|
+
* const defs: ExportableEntityDefinition[] = [
|
|
7791
|
+
* { entityType: 'agent', dependsOn: ['skill'], cascadeParents: [], ... },
|
|
7792
|
+
* { entityType: 'skill', dependsOn: [], cascadeParents: [], ... },
|
|
7793
|
+
* ];
|
|
7794
|
+
* const order = DependencyResolver.resolveOrder(defs);
|
|
7795
|
+
* // order[0] === 'skill', order[1] === 'agent'
|
|
7796
|
+
* ```
|
|
7797
|
+
*/
|
|
7798
|
+
declare class DependencyResolver {
|
|
7799
|
+
/**
|
|
7800
|
+
* Topological sort of entity types based on their {@link ExportableEntityDefinition.dependsOn}
|
|
7801
|
+
* declarations. Entities with no dependencies come first.
|
|
7802
|
+
*
|
|
7803
|
+
* @param defs - All registered exportable entity definitions.
|
|
7804
|
+
* @returns Entity type names in dependency-first order.
|
|
7805
|
+
*/
|
|
7806
|
+
static resolveOrder(defs: ExportableEntityDefinition[]): string[];
|
|
7807
|
+
/**
|
|
7808
|
+
* Given a set of selected entity types, expand to include all CASCADE
|
|
7809
|
+
* parents. Only walks **upward** (parents), never downward (children).
|
|
7810
|
+
*
|
|
7811
|
+
* @param defs - All registered exportable entity definitions.
|
|
7812
|
+
* @param selected - Entity type names the user explicitly chose.
|
|
7813
|
+
* @returns The original selection plus every reachable cascade parent.
|
|
7814
|
+
*/
|
|
7815
|
+
static expandCascade(defs: ExportableEntityDefinition[], selected: string[]): string[];
|
|
7816
|
+
/**
|
|
7817
|
+
* Compute which required dependencies are missing from the selected types.
|
|
7818
|
+
*
|
|
7819
|
+
* Only considers dependencies that are themselves registered as exportable
|
|
7820
|
+
* entity types. Unregistered dependencies (e.g. `Workspace`, `Project` —
|
|
7821
|
+
* infrastructure types) are silently excluded.
|
|
7822
|
+
*
|
|
7823
|
+
* @param defs - All registered exportable entity definitions.
|
|
7824
|
+
* @param selected - Entity type names the user has selected.
|
|
7825
|
+
* @returns The list of entity types that must also be selected (or
|
|
7826
|
+
* auto-included).
|
|
7827
|
+
*/
|
|
7828
|
+
static computeDependencies(defs: ExportableEntityDefinition[], selected: string[]): {
|
|
7829
|
+
missing: string[];
|
|
7830
|
+
};
|
|
7831
|
+
}
|
|
7832
|
+
|
|
7833
|
+
declare class IdRemapper {
|
|
7834
|
+
private readonly idMap;
|
|
7835
|
+
constructor(idMap: Record<string, string>);
|
|
7836
|
+
/**
|
|
7837
|
+
* Deep-traverse an object/array and replace all @type/exportId string values
|
|
7838
|
+
* with their corresponding real IDs from the idMap.
|
|
7839
|
+
* Values not matching the @type/exportId pattern are returned unchanged.
|
|
7840
|
+
*/
|
|
7841
|
+
remapReferences(value: unknown): unknown;
|
|
7842
|
+
/**
|
|
7843
|
+
* Replace raw skill IDs in an agent's graphDefinition.skillIds array.
|
|
7844
|
+
* This handles the implicit agent->skill reference that uses raw skill IDs
|
|
7845
|
+
* (not @type/exportId format). Agents reference skills by their string ID.
|
|
7846
|
+
*/
|
|
7847
|
+
remapSkillIds(graphDefinition: Record<string, unknown>, skillRemap: Record<string, string>): Record<string, unknown>;
|
|
7848
|
+
}
|
|
7849
|
+
|
|
7850
|
+
export { AGENT_TASK_EVENT, type AddMessageParams, Agent, type AgentClient, type AgentExecutor, AgentInstanceManager, type AgentLattice, AgentLatticeManager, type AgentLifecycleEventName, AgentManager, type AgentStreamExecutor, type AgentThreadInterface, BUILTIN_PLUGINS, BUILTIN_SKILLS, type BackendFactory, type BackendProtocol, type BufferStats, type CacheEntry, type CaseRunResult, type Chunk, ChunkBuffer, ChunkBufferLatticeManager, CollectionLatticeManager, type ColumnInfo, CompositeBackend, type ConflictItem, type ConnectAllChannelsOptions, ConnectionRegistry, ConsoleLoggerClient, type CreateSandboxProviderConfig, type CronFields, CustomMetricsClient, type CustomMiddlewareFactory, CustomMiddlewareRegistry, type DatabaseConfig, type DatabaseType, DaytonaInstance, DaytonaProvider, type DaytonaProviderConfig, DefaultScheduleClient, DependencyResolver, E2BInstance, E2BProvider, type E2BProviderConfig, EMPTY_CONTENT_WARNING, type EditResult, type EmbeddingsInfo, type EmbeddingsLatticeInterface, EmbeddingsLatticeManager, type EnsureMicrosandboxInput, type EvalRunService, type ExportBundle, type ExportJob, type ExportableEntity, type ExportableEntityDefinition, ExportableEntityRegistry, type ExportableTypeInfo, type FileData, type FileInfo, FileSystemSkillStore, type FileSystemSkillStoreOptions, FilesystemBackend, type FsEntry, type GrepMatch, type IMessageQueueStore, type IMetricsServerClient, type ISqlDatabase, IdRemapper, type ImportApplyResult, type ImportEntityResult, type ImportEntityStatus, type ImportPreviewResult, InMemoryA2AApiKeyStore, InMemoryAssistantStore, InMemoryBindingStore, InMemoryChannelInstallationStore, InMemoryChunkBuffer, InMemoryCollectionStore, InMemoryDatabaseConfigStore, InMemoryMailboxStore, InMemoryMenuStore, InMemoryTaskListStore, InMemoryTaskStore, InMemoryTenantStore, InMemoryThreadMessageQueueStore, InMemoryThreadStore, InMemoryUserStore, InMemoryUserTenantLinkStore, type InsertionItem, LINE_NUMBER_WIDTH, type LangGraphStateChecker, type LatticeAgentStepConfig, LatticeEval, type LatticeEvalBatchReport, type LatticeEvalCase, type LatticeEvalCaseType, type LatticeEvalCaseWithTemplate, type LatticeEvalConfig, type LatticeEvalLogEvent, type LatticeEvalLogLevel, LatticeEvalProject, type LatticeEvalProjectType, type LatticeEvalResult, type LatticeEvalRubric, LatticeEvalSuite, type LatticeEvalSuiteType, type LatticeEvalTemplate, LocalSandboxInstance, LocalSandboxProvider, type LocalSandboxProviderConfig, type LoggerLattice, LoggerLatticeManager, MAX_LINE_LENGTH, type MailboxMessage, type MailboxStore, type McpLatticeInterface, McpLatticeManager, type McpServerInfo, MemoryBackend, MemoryLatticeManager, MemoryQueueClient, MemoryScheduleStorage, type MessageCompletedEvent, type MessageFailedEvent, type MessageStartedEvent, MessageType, MetricsServerManager, MicrosandboxRemoteInstance, MicrosandboxRemoteProvider, type MicrosandboxRemoteProviderClient, type MicrosandboxRemoteProviderConfig, MicrosandboxServiceClient, type MicrosandboxServiceClientConfig, type MicrosandboxShellExecInput, type ModelConfig, type ModelLatticeInterface, ModelLatticeManager, MysqlDatabase, type OutputType, type PendingMessage, PersonalAssistantConfig, PinoLoggerClient, PluginRegistry, PostgresDatabase, type PreviewError, PrometheusClient, type QueryResult, type QueueLattice, QueueLatticeManager, QueueMode, type QueuePendingEvent, RemoteSandboxInstance, RemoteSandboxProvider, type RemoteSandboxProviderConfig, type Resolution, type ResolutionAction, type ResolveAgentFn, type ResolvedConfig, type RunSandboxConfig, type RuntimeModelConfig, type SandboxFileInfo, type SandboxFileService, SandboxFilesystem, type SandboxInstance, type SandboxIsolationLevel, SandboxLatticeManager, type SandboxManagerProtocol, type SandboxProvider, type SandboxProviderFactory, type SandboxProviderType, type SandboxShellService, SandboxSkillStore, type SandboxSkillStoreOptions, type SandboxVolumeDefinition, type ScheduleLattice, ScheduleLatticeManager, type SchedulerMiddlewareOptions, SemanticMetricsClient, type SharePayload, SimpleMemoryVectorStore, type SkillLattice, SkillLatticeManager, type SkillMeta, type SkillResource, SqlDatabaseManager, type StateAndStore, StateBackend, StoreBackend, type StoreLattice, StoreLatticeManager, type StoreType, type StoreTypeMap, TOOL_RESULT_TOKEN_LIMIT, TRUNCATION_GUIDANCE, type TableInfo, type TableSchema, type TaskEvent, type TaskListStore, type TaskSpec, TaskStatus, type TaskUpdatable, TeamAgentGraphBuilder, type TeamConfig, type TeamMiddlewareOptions, type TeamTask, type TeammateSpec, type TeammateToolsOptions, type ThreadBuffer, type ThreadBufferConfig, type ThreadBusyEvent, type ThreadIdleEvent, type ThreadInfo, type ThreadQueueConfig, type ThreadState, ThreadStatus, type ThreadStatusChangedEvent, TokenCache, type ToolDefinition, type ToolLattice, ToolLatticeManager, type UnknownToolHandlerConfig, type VectorStoreLatticeInterface, VectorStoreLatticeManager, type VectorStoreProviderLattice, VectorStoreProviderManager, VolumeFilesystem, type VolumeFsClient, type WorkflowValidationError, type WriteResult, abortWorkflowRun, agentInstanceManager, agentLatticeManager, buildGrepResultsDict, buildInput, buildNamedVolumeName, buildSandboxMetadataEnv, buildSkillFile, buildStateAnnotation, buildTableName, checkEmptyContent, clearEncryptionKeyCache, clearEvalRunService, collectionLatticeManager, compileInternal, compileWorkflow, computeSandboxName, configureStores, connectAllChannels, createAgentNode, createAgentTeam, createExecuteSqlQueryTool, createFileData, createInfoSqlTool, createListMetricsDataSourcesTool, createListMetricsServersTool, createListTablesSqlTool, createMapNode, createModelSelectorMiddleware, createNodeHandler, createQueryCheckerSqlTool, createQueryMetricDefinitionTool, createQueryMetricsListTool, createQuerySemanticMetricDataTool, createQuerySqlTool, createQueryTableDefinitionTool, createQueryTablesListTool, createResourceAddress, createSandboxProvider, createSchedulerMiddleware, createSharePayload, createTaskMiddleware, createTeamMiddleware, createTeammateTools, createUnknownToolHandlerMiddleware, createWidgetMiddleware, decrypt, describeCronExpression, embeddingsLatticeManager, encrypt, ensureBuiltinAgentsForTenant, evaluateLatticeCaseWithLogs, eventBus, eventBus as eventBusDefault, extractFetcherError, extractOutput, fileDataToString, formatContentWithLineNumbers, formatGrepMatches, formatGrepResults, formatReadResponse, generateToken, getAgentClient, getAgentConfig, getAllAgentConfigs, getAllBuiltInSkillMetas, getAllToolDefinitions, getBindingRegistry, getBuiltInSkillContent, getBuiltInSkillMeta, getBuiltInSkillNames, getCheckpointSaver, getChunkBuffer, getCollectionEntryCount, getEmbeddingsClient, getEmbeddingsLattice, getEncryptionKey, getEvalRunService, getLoggerLattice, getMenuRegistry, getModelLattice, getNextCronTime, getOrCreateCollectionVectorStore, getQueueLattice, getSandBoxManager, getScheduleLattice, getStoreLattice, getToolClient, getToolDefinition, getToolLattice, getVectorStoreClient, getVectorStoreLattice, getVectorStoreProvider, getWorkflowSignal, globSearchFiles, grepMatchesFromFiles, grepSearchFiles, hasChunkBuffer, invokeWithRetry, isBuiltInSkill, isUsingDefaultKey, isValidCronExpression, isValidSandboxName, isValidSkillName, listCollectionEntries, listSandboxProviderTypes, loggerLatticeManager, mcpManager, metricsServerManager, modelLatticeManager, normalizeSandboxName, parallelLimit, parseCronExpression, parseSkillFrontmatter, parseYaml, performStringReplacement, queueLatticeManager, registerAgentLattice, registerAgentLatticeWithTenant, registerAgentLattices, registerCheckpointSaver, registerChunkBuffer, registerEmbeddingsLattice, registerExistingTool, registerLoggerLattice, registerModelLattice, registerQueueLattice, registerSandboxProviderType, registerScheduleLattice, registerStoreLattice, registerTeammateAgent, registerToolLattice, registerVectorStoreLattice, registerVectorStoreProvider, registerWorkflowRun, removeCollectionVectorStore, renderTemplate, resolvePath, sandboxLatticeManager, sanitizeToolCallId, scheduleLatticeManager, serializePluginMeta, setBindingRegistry, setEvalRunService, setMenuRegistry, skillLatticeManager, sqlDatabaseManager, storeLatticeManager, toJsonSchema, toSafeStateExpr, toolLatticeManager, truncateIfTooLong, unregisterTeammateAgent, unregisterWorkflowRun, updateFileData, validateAgentInput, validateDSL, validateEncryptionKey, validatePath, validateSkillName, validateToolInput, vectorStoreLatticeManager, vectorStoreProviderManager };
|