@axiom-lattice/core 2.1.88 → 2.1.90

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 CHANGED
@@ -8,7 +8,7 @@ import { BaseLanguageModelInput, LanguageModelLike, BaseLanguageModel } from '@l
8
8
  import { CallbackManagerForLLMRun } from '@langchain/core/callbacks/manager';
9
9
  import { ChatResult } from '@langchain/core/outputs';
10
10
  import * as _axiom_lattice_protocols from '@axiom-lattice/protocols';
11
- import { LLMConfig, SemanticMetricsServerConfig, MetricMeta, MetricQueryResult, DataSource, SemanticMetricsQueryRequest, SemanticMetricsQueryResponse, TableQueryRequest, TableQueryResponse, ExecuteSqlQueryRequest, ExecuteSqlQueryResponse, MetricsServerType, MetricsServerConfig, ToolConfig, ToolExecutor, AgentConfig, MiddlewareType, GraphBuildOptions, MessageChunk, MessageChunkType, QueueLatticeProtocol, QueueConfig, QueueClient, QueueResult, ScheduleLatticeProtocol, ScheduleConfig, ScheduleClient, ScheduleStorage, TaskHandler, ScheduleOnceOptions, ScheduleCronOptions, ScheduledTaskDefinition, ScheduledTaskStatus, ScheduleExecutionType, ThreadStore, AssistantStore, SkillStore, WorkspaceStore, ProjectStore, DatabaseConfigStore, MetricsServerConfigStore, McpServerConfigStore, UserStore, TenantStore, UserTenantLinkStore, WorkflowTrackingStore, EvalStore, ChannelInstallationStore, BindingRegistry, MenuRegistry, A2AApiKeyStore, TaskStore, Thread, CreateThreadRequest, Assistant, CreateAssistantRequest, Skill, CreateSkillRequest, SkillStoreContext, DatabaseConfigEntry, CreateDatabaseConfigRequest, UpdateDatabaseConfigRequest, User, CreateUserRequest, UpdateUserRequest, Tenant, CreateTenantRequest, UpdateTenantRequest, UserTenantLink, CreateUserTenantLinkRequest, UpdateUserTenantLinkRequest, ChannelInstallation, ChannelInstallationType, CreateChannelInstallationRequest, UpdateChannelInstallationRequest, Binding, CreateBindingInput, A2AApiKeyRecord, CreateA2AApiKeyInput, A2AApiKeyEntry, CreateTaskRequest, TaskItem, TaskListFilter, UpdateTaskRequest, MenuItem, CreateMenuItemInput, UpdateMenuItemInput, LoggerLatticeProtocol, LoggerConfig, LoggerClient, LoggerContext, SkillConfig, SkillClient, ChannelAdapter, InternalStateField, InternalInput, InternalNode, InternalAgentNode, InternalMapNode, InternalDSL } from '@axiom-lattice/protocols';
11
+ import { LLMConfig, SemanticMetricsServerConfig, MetricMeta, MetricQueryResult, DataSource, SemanticMetricsQueryRequest, SemanticMetricsQueryResponse, TableQueryRequest, TableQueryResponse, ExecuteSqlQueryRequest, ExecuteSqlQueryResponse, MetricsServerType, MetricsServerConfig, ToolConfig, ToolExecutor, AgentConfig, MiddlewareType, GraphBuildOptions, MessageChunk, MessageChunkType, QueueLatticeProtocol, QueueConfig, QueueClient, QueueResult, ScheduleLatticeProtocol, ScheduleConfig, ScheduleClient, ScheduleStorage, TaskHandler, ScheduleOnceOptions, ScheduleCronOptions, ScheduledTaskDefinition, ScheduledTaskStatus, ScheduleExecutionType, ThreadStore, AssistantStore, SkillStore, WorkspaceStore, ProjectStore, DatabaseConfigStore, MetricsServerConfigStore, McpServerConfigStore, UserStore, TenantStore, UserTenantLinkStore, WorkflowTrackingStore, EvalStore, ChannelInstallationStore, BindingRegistry, MenuRegistry, A2AApiKeyStore, TaskStore, SharedResourceStore, Thread, CreateThreadRequest, Assistant, CreateAssistantRequest, Skill, CreateSkillRequest, SkillStoreContext, DatabaseConfigEntry, CreateDatabaseConfigRequest, UpdateDatabaseConfigRequest, User, CreateUserRequest, UpdateUserRequest, Tenant, CreateTenantRequest, UpdateTenantRequest, UserTenantLink, CreateUserTenantLinkRequest, UpdateUserTenantLinkRequest, ChannelInstallation, ChannelInstallationType, CreateChannelInstallationRequest, UpdateChannelInstallationRequest, Binding, CreateBindingInput, A2AApiKeyRecord, CreateA2AApiKeyInput, A2AApiKeyEntry, CreateTaskRequest, TaskItem, TaskListFilter, UpdateTaskRequest, MenuItem, CreateMenuItemInput, UpdateMenuItemInput, LoggerLatticeProtocol, LoggerConfig, LoggerClient, LoggerContext, SkillConfig, SkillClient, ResourceResolver, ResourceAddress, ShareVisibility, CreateShareRequest, ChannelAdapter, InternalStateField, InternalInput, InternalNode, InternalAgentNode, InternalMapNode, InternalDSL } from '@axiom-lattice/protocols';
12
12
  export { _axiom_lattice_protocols as Protocols };
13
13
  export { AgentConfig, AgentType, GraphBuildOptions, MemoryType } from '@axiom-lattice/protocols';
14
14
  import * as langchain from 'langchain';
@@ -1410,6 +1410,26 @@ interface BackendProtocol {
1410
1410
  * @returns Raw file content as FileData
1411
1411
  */
1412
1412
  readRaw(filePath: string): MaybePromise<FileData>;
1413
+ /**
1414
+ * Read file content as raw binary Buffer.
1415
+ *
1416
+ * Optional method for backends that support binary file access.
1417
+ * Backends that store files as text (StateBackend, MemoryBackend, StoreBackend)
1418
+ * may omit this method.
1419
+ *
1420
+ * @param filePath - Absolute file path
1421
+ * @returns Raw file content as Buffer
1422
+ */
1423
+ readBinary?(filePath: string): Promise<Buffer>;
1424
+ /**
1425
+ * Write raw binary data to a file.
1426
+ *
1427
+ * Optional method for backends that support binary file writing.
1428
+ *
1429
+ * @param filePath - Absolute file path
1430
+ * @param data - Binary data to write
1431
+ */
1432
+ writeBinary?(filePath: string, data: Buffer): Promise<void>;
1413
1433
  /**
1414
1434
  * Structured search results or error string for invalid input.
1415
1435
  *
@@ -2703,6 +2723,7 @@ type StoreTypeMap = {
2703
2723
  menu: MenuRegistry;
2704
2724
  a2aApiKey: A2AApiKeyStore;
2705
2725
  task: TaskStore;
2726
+ sharedResource: SharedResourceStore;
2706
2727
  };
2707
2728
  /**
2708
2729
  * Store type keys
@@ -4119,6 +4140,13 @@ interface SandboxProvider {
4119
4140
  deleteSandbox(name: string): Promise<void>;
4120
4141
  listSandboxes(): Promise<SandboxInstance[]>;
4121
4142
  createVolumeFsClient?(volumeName: string, pathPrefix?: string): VolumeFsClient;
4143
+ getResourceResolver(): ResourceResolver;
4144
+ createResourceAddress(config: {
4145
+ tenantId: string;
4146
+ workspaceId: string;
4147
+ projectId: string;
4148
+ resourcePath: string;
4149
+ }): ResourceAddress;
4122
4150
  }
4123
4151
 
4124
4152
  type SandboxLifecycleResponse = {
@@ -4217,6 +4245,18 @@ declare class MicrosandboxServiceClient {
4217
4245
  private request;
4218
4246
  }
4219
4247
 
4248
+ /**
4249
+ * Create a project-scoped resource address from tenant, workspace, and project IDs.
4250
+ *
4251
+ * Shared by all sandbox providers for consistent resource naming.
4252
+ */
4253
+ declare function createResourceAddress(config: {
4254
+ tenantId: string;
4255
+ workspaceId: string;
4256
+ projectId: string;
4257
+ resourcePath: string;
4258
+ }): ResourceAddress;
4259
+
4220
4260
  type MicrosandboxRemoteProviderClient = Pick<MicrosandboxServiceClient, "ensureSandbox" | "startSandbox" | "stopSandbox" | "killSandbox" | "deleteSandbox" | "getStatus" | "readFile" | "writeFile" | "listPath" | "findFiles" | "searchInFile" | "replaceInFile" | "uploadFile" | "downloadFile" | "execCommand" | "volumeFsRead" | "volumeFsWrite" | "volumeFsList" | "volumeFsDownload" | "volumeFsUpload">;
4221
4261
  interface MicrosandboxRemoteProviderConfig extends MicrosandboxServiceClientConfig {
4222
4262
  client?: MicrosandboxRemoteProviderClient;
@@ -4236,6 +4276,8 @@ declare class MicrosandboxRemoteProvider implements SandboxProvider {
4236
4276
  deleteSandbox(name: string): Promise<void>;
4237
4277
  createVolumeFsClient(volumeName: string, _pathPrefix?: string): VolumeFsClient;
4238
4278
  listSandboxes(): Promise<SandboxInstance[]>;
4279
+ getResourceResolver(): ResourceResolver;
4280
+ createResourceAddress: typeof createResourceAddress;
4239
4281
  private buildEnsureInput;
4240
4282
  private buildDefaultVolumes;
4241
4283
  }
@@ -4257,6 +4299,8 @@ declare class RemoteSandboxProvider implements SandboxProvider {
4257
4299
  stopSandbox(name: string): Promise<void>;
4258
4300
  deleteSandbox(name: string): Promise<void>;
4259
4301
  listSandboxes(): Promise<SandboxInstance[]>;
4302
+ getResourceResolver(): ResourceResolver;
4303
+ createResourceAddress: typeof createResourceAddress;
4260
4304
  createVolumeFsClient(_volumeName: string, pathPrefix?: string): VolumeFsClient;
4261
4305
  }
4262
4306
 
@@ -4275,6 +4319,8 @@ declare class E2BProvider implements SandboxProvider {
4275
4319
  stopSandbox(name: string): Promise<void>;
4276
4320
  deleteSandbox(name: string): Promise<void>;
4277
4321
  listSandboxes(): Promise<SandboxInstance[]>;
4322
+ getResourceResolver(): ResourceResolver;
4323
+ createResourceAddress: typeof createResourceAddress;
4278
4324
  }
4279
4325
 
4280
4326
  interface DaytonaProviderConfig {
@@ -4305,6 +4351,8 @@ declare class DaytonaProvider implements SandboxProvider {
4305
4351
  stopSandbox(name: string): Promise<void>;
4306
4352
  deleteSandbox(name: string): Promise<void>;
4307
4353
  listSandboxes(): Promise<SandboxInstance[]>;
4354
+ getResourceResolver(): ResourceResolver;
4355
+ createResourceAddress: typeof createResourceAddress;
4308
4356
  }
4309
4357
 
4310
4358
  interface LocalSandboxProviderConfig {
@@ -4349,6 +4397,8 @@ declare class LocalSandboxProvider implements SandboxProvider {
4349
4397
  stopSandbox(name: string): Promise<void>;
4350
4398
  deleteSandbox(name: string): Promise<void>;
4351
4399
  listSandboxes(): Promise<SandboxInstance[]>;
4400
+ getResourceResolver(): ResourceResolver;
4401
+ createResourceAddress: typeof createResourceAddress;
4352
4402
  }
4353
4403
 
4354
4404
  interface CreateSandboxProviderConfig {
@@ -4536,6 +4586,15 @@ declare class SandboxLatticeManager extends BaseLatticeManager<SandboxProvider>
4536
4586
  deleteSandbox(name: string): Promise<void>;
4537
4587
  listSandboxes(): Promise<SandboxInstance[]>;
4538
4588
  private _requireProvider;
4589
+ /**
4590
+ * Returns the first registered (default) sandbox provider.
4591
+ *
4592
+ * Used by the resource sharing system for file resolution
4593
+ * when a specific provider key is not specified.
4594
+ *
4595
+ * @returns The default registered {@link SandboxProvider}.
4596
+ */
4597
+ getDefaultProvider(): SandboxProvider;
4539
4598
  }
4540
4599
  declare const sandboxLatticeManager: SandboxLatticeManager;
4541
4600
  declare const getSandBoxManager: (key?: string) => SandboxManagerProtocol;
@@ -4569,6 +4628,98 @@ declare function buildSandboxMetadataEnv(config?: RunSandboxConfig): Record<stri
4569
4628
 
4570
4629
  declare function buildNamedVolumeName(prefix: "s" | "a" | "p", ...parts: Array<string | undefined>): string;
4571
4630
 
4631
+ /**
4632
+ * A single entry in the token cache, mapping a share token to a resource address.
4633
+ */
4634
+ interface CacheEntry {
4635
+ address: ResourceAddress;
4636
+ /** true = password-protected share; cache hits must re-check auth */
4637
+ requiresUnlock: boolean;
4638
+ }
4639
+ /**
4640
+ * In-memory token → address cache.
4641
+ *
4642
+ * Caches share token lookups so that frequent access to the same resource
4643
+ * does not repeatedly hit the share store. Entries live for a configurable
4644
+ * TTL (default 60s) so that revocations take effect within a bounded window.
4645
+ *
4646
+ * Password-protected shares are cached with {@link CacheEntry.requiresUnlock}
4647
+ * set to `true` so callers know they must still verify the password on every
4648
+ * hit — the cache only avoids the database round-trip, not the auth check.
4649
+ *
4650
+ * @remarks
4651
+ * - Single-instance only. Multi-instance deployments need a Redis pub/sub
4652
+ * broadcast on `share:revoke:{token}` to invalidate across processes.
4653
+ */
4654
+ declare class TokenCache {
4655
+ private cache;
4656
+ private ttlMs;
4657
+ /**
4658
+ * Look up a token in the cache.
4659
+ *
4660
+ * @param token - The share token.
4661
+ * @returns The cached entry, or `null` if the token is absent or expired.
4662
+ */
4663
+ get(token: string): CacheEntry | null;
4664
+ /**
4665
+ * Store a token → address mapping.
4666
+ *
4667
+ * @param token - The share token.
4668
+ * @param entry - The cache entry to associate with the token.
4669
+ */
4670
+ set(token: string, entry: CacheEntry): void;
4671
+ /**
4672
+ * Remove a cached entry (e.g. on revocation).
4673
+ *
4674
+ * @param token - The share token to invalidate.
4675
+ */
4676
+ invalidate(token: string): void;
4677
+ }
4678
+
4679
+ /**
4680
+ * Generate a cryptographically random share token.
4681
+ *
4682
+ * Uses 24 random bytes (192 bits), encoded as base64url for URL-safe transport.
4683
+ *
4684
+ * @returns A URL-safe random token string.
4685
+ */
4686
+ declare function generateToken(): string;
4687
+
4688
+ /**
4689
+ * Shape of the share document to persist in the share store.
4690
+ */
4691
+ interface SharePayload {
4692
+ address: ResourceAddress;
4693
+ tenantId: string;
4694
+ workspaceId: string;
4695
+ projectId: string;
4696
+ assistantId: string | null;
4697
+ vmIsolation: string;
4698
+ visibility: ShareVisibility;
4699
+ passwordHash: string | null;
4700
+ title: string | null;
4701
+ createdBy: string;
4702
+ expiresAt: Date | null;
4703
+ maxAccess: number | null;
4704
+ revoked: boolean;
4705
+ }
4706
+ /**
4707
+ * Build a share payload from the client request and tenant/project context.
4708
+ *
4709
+ * Combines the caller's tenant/project identifiers with the client-provided
4710
+ * {@link CreateShareRequest} to produce a ready-to-persist share document.
4711
+ * The password is stored as a plaintext placeholder — bcrypt hashing is
4712
+ * deferred to a later task.
4713
+ *
4714
+ * @param tenantId - The tenant that owns the resource.
4715
+ * @param workspaceId - The workspace the project belongs to.
4716
+ * @param projectId - The project whose resource path is being shared.
4717
+ * @param userId - The user creating the share.
4718
+ * @param request - Client-provided share parameters.
4719
+ * @returns A complete share payload for persistence.
4720
+ */
4721
+ declare function createSharePayload(tenantId: string, workspaceId: string, projectId: string, userId: string, request: CreateShareRequest): SharePayload;
4722
+
4572
4723
  /**
4573
4724
  * Channel connection lifecycle.
4574
4725
  *
@@ -5582,6 +5733,8 @@ declare class VolumeFilesystem implements BackendProtocol {
5582
5733
  lsInfo(path: string): Promise<FileInfo[]>;
5583
5734
  read(filePath: string, offset?: number, limit?: number): Promise<string>;
5584
5735
  readRaw(filePath: string): Promise<FileData>;
5736
+ readBinary(filePath: string): Promise<Buffer>;
5737
+ writeBinary(filePath: string, data: Buffer): Promise<void>;
5585
5738
  grepRaw(_pattern: string, _path?: string | null, _glob?: string | null): string | GrepMatch[];
5586
5739
  globInfo(_pattern: string, _path?: string): FileInfo[];
5587
5740
  write(filePath: string, content: string): Promise<WriteResult>;
@@ -6804,4 +6957,4 @@ declare class PersonalAssistantConfig {
6804
6957
  static render(config: AgentConfig, name: string, personality: string): void;
6805
6958
  }
6806
6959
 
6807
- export { AGENT_TASK_EVENT, type AddMessageParams, Agent, type AgentClient, type AgentExecutor, AgentInstanceManager, type AgentLattice, AgentLatticeManager, type AgentLifecycleEventName, AgentManager, type AgentStreamExecutor, type AgentThreadInterface, BUILTIN_SKILLS, type BackendFactory, type BackendProtocol, type BufferStats, type Chunk, ChunkBuffer, ChunkBufferLatticeManager, type ColumnInfo, CompositeBackend, type ConnectAllChannelsOptions, ConsoleLoggerClient, type CreateProcessingAgentParams, type CreateSandboxProviderConfig, type CronFields, CustomMetricsClient, type CustomMiddlewareFactory, CustomMiddlewareRegistry, type DatabaseConfig, type DatabaseType, DaytonaInstance, DaytonaProvider, type DaytonaProviderConfig, DefaultScheduleClient, E2BInstance, E2BProvider, type E2BProviderConfig, EMPTY_CONTENT_WARNING, type EditResult, type EmbeddingsLatticeInterface, EmbeddingsLatticeManager, type EnsureMicrosandboxInput, type FileData, type FileInfo, FileSystemSkillStore, type FileSystemSkillStoreOptions, FilesystemBackend, type FsEntry, type GrepMatch, type IMessageQueueStore, type IMetricsServerClient, type ISqlDatabase, InMemoryA2AApiKeyStore, InMemoryAssistantStore, InMemoryBindingStore, InMemoryChannelInstallationStore, InMemoryChunkBuffer, InMemoryDatabaseConfigStore, InMemoryMailboxStore, InMemoryMenuStore, InMemoryTaskListStore, InMemoryTaskStore, InMemoryTenantStore, InMemoryThreadMessageQueueStore, InMemoryThreadStore, InMemoryUserStore, InMemoryUserTenantLinkStore, LINE_NUMBER_WIDTH, type LangGraphStateChecker, 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 PendingMessage, PersonalAssistantConfig, PinoLoggerClient, PostgresDatabase, PrometheusClient, type QueryResult, type QueueLattice, QueueLatticeManager, QueueMode, type QueuePendingEvent, RemoteSandboxInstance, RemoteSandboxProvider, type RemoteSandboxProviderConfig, type ResolveAgentFn, type RunSandboxConfig, type RuntimeModelConfig, type SandboxFileInfo, type SandboxFileService, SandboxFilesystem, type SandboxInstance, type SandboxIsolationLevel, SandboxLatticeManager, type SandboxManagerProtocol, type SandboxProvider, type SandboxShellService, SandboxSkillStore, type SandboxSkillStoreOptions, type SandboxVolumeDefinition, type ScheduleLattice, ScheduleLatticeManager, type SchedulerMiddlewareOptions, SemanticMetricsClient, 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, type ToolDefinition, type ToolLattice, ToolLatticeManager, type TopologyEdge, type UnknownToolHandlerConfig, type VectorStoreLatticeInterface, VectorStoreLatticeManager, VolumeFilesystem, type VolumeFsClient, type WorkflowValidationError, type WriteResult, agentInstanceManager, agentLatticeManager, buildGrepResultsDict, buildInput, buildNamedVolumeName, buildSandboxMetadataEnv, buildSkillFile, buildStateAnnotation, checkEmptyContent, clearEncryptionKeyCache, compileInternal, compileWorkflow, computeSandboxName, configureStores, connectAllChannels, createAgentNode, createAgentTeam, createExecuteSqlQueryTool, createFileData, createInfoSqlTool, createListMetricsDataSourcesTool, createListMetricsServersTool, createListTablesSqlTool, createMapNode, createModelSelectorMiddleware, createNodeHandler, createProcessingAgent, createQueryCheckerSqlTool, createQueryMetricDefinitionTool, createQueryMetricsListTool, createQuerySemanticMetricDataTool, createQuerySqlTool, createQueryTableDefinitionTool, createQueryTablesListTool, createSandboxProvider, createSchedulerMiddleware, createTaskMiddleware, createTeamMiddleware, createTeammateTools, createUnknownToolHandlerMiddleware, createWidgetMiddleware, decrypt, describeCronExpression, embeddingsLatticeManager, encrypt, ensureBuiltinAgentsForTenant, eventBus, eventBus as eventBusDefault, extractFetcherError, extractOutput, fileDataToString, formatContentWithLineNumbers, formatGrepMatches, formatGrepResults, formatReadResponse, getAgentClient, getAgentConfig, getAllAgentConfigs, getAllBuiltInSkillMetas, getAllToolDefinitions, getBindingRegistry, getBuiltInSkillContent, getBuiltInSkillMeta, getBuiltInSkillNames, getCheckpointSaver, getChunkBuffer, getEmbeddingsClient, getEmbeddingsLattice, getEncryptionKey, getLoggerLattice, getMenuRegistry, getModelLattice, getNextCronTime, getQueueLattice, getSandBoxManager, getScheduleLattice, getStoreLattice, getToolClient, getToolDefinition, getToolLattice, getVectorStoreClient, getVectorStoreLattice, globSearchFiles, grepMatchesFromFiles, grepSearchFiles, hasChunkBuffer, invokeWithRetry, isBuiltInSkill, isUsingDefaultKey, isValidCronExpression, isValidSandboxName, isValidSkillName, loggerLatticeManager, mcpManager, metricsServerManager, modelLatticeManager, normalizeSandboxName, parallelLimit, parseCronExpression, parseSkillFrontmatter, parseYaml, performStringReplacement, queueLatticeManager, registerAgentLattice, registerAgentLatticeWithTenant, registerAgentLattices, registerCheckpointSaver, registerChunkBuffer, registerEmbeddingsLattice, registerExistingTool, registerLoggerLattice, registerModelLattice, registerQueueLattice, registerScheduleLattice, registerStoreLattice, registerTeammateAgent, registerToolLattice, registerVectorStoreLattice, renderTemplate, resolvePath, sandboxLatticeManager, sanitizeToolCallId, scheduleLatticeManager, setBindingRegistry, setMenuRegistry, skillLatticeManager, sqlDatabaseManager, storeLatticeManager, toJsonSchema, toSafeStateExpr, toolLatticeManager, truncateIfTooLong, unregisterTeammateAgent, updateFileData, validateAgentInput, validateDSL, validateEncryptionKey, validatePath, validateSkillName, validateToolInput, vectorStoreLatticeManager };
6960
+ export { AGENT_TASK_EVENT, type AddMessageParams, Agent, type AgentClient, type AgentExecutor, AgentInstanceManager, type AgentLattice, AgentLatticeManager, type AgentLifecycleEventName, AgentManager, type AgentStreamExecutor, type AgentThreadInterface, BUILTIN_SKILLS, type BackendFactory, type BackendProtocol, type BufferStats, type CacheEntry, type Chunk, ChunkBuffer, ChunkBufferLatticeManager, type ColumnInfo, CompositeBackend, type ConnectAllChannelsOptions, ConsoleLoggerClient, type CreateProcessingAgentParams, type CreateSandboxProviderConfig, type CronFields, CustomMetricsClient, type CustomMiddlewareFactory, CustomMiddlewareRegistry, type DatabaseConfig, type DatabaseType, DaytonaInstance, DaytonaProvider, type DaytonaProviderConfig, DefaultScheduleClient, E2BInstance, E2BProvider, type E2BProviderConfig, EMPTY_CONTENT_WARNING, type EditResult, type EmbeddingsLatticeInterface, EmbeddingsLatticeManager, type EnsureMicrosandboxInput, type FileData, type FileInfo, FileSystemSkillStore, type FileSystemSkillStoreOptions, FilesystemBackend, type FsEntry, type GrepMatch, type IMessageQueueStore, type IMetricsServerClient, type ISqlDatabase, InMemoryA2AApiKeyStore, InMemoryAssistantStore, InMemoryBindingStore, InMemoryChannelInstallationStore, InMemoryChunkBuffer, InMemoryDatabaseConfigStore, InMemoryMailboxStore, InMemoryMenuStore, InMemoryTaskListStore, InMemoryTaskStore, InMemoryTenantStore, InMemoryThreadMessageQueueStore, InMemoryThreadStore, InMemoryUserStore, InMemoryUserTenantLinkStore, LINE_NUMBER_WIDTH, type LangGraphStateChecker, 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 PendingMessage, PersonalAssistantConfig, PinoLoggerClient, PostgresDatabase, PrometheusClient, type QueryResult, type QueueLattice, QueueLatticeManager, QueueMode, type QueuePendingEvent, RemoteSandboxInstance, RemoteSandboxProvider, type RemoteSandboxProviderConfig, type ResolveAgentFn, type RunSandboxConfig, type RuntimeModelConfig, type SandboxFileInfo, type SandboxFileService, SandboxFilesystem, type SandboxInstance, type SandboxIsolationLevel, SandboxLatticeManager, type SandboxManagerProtocol, type SandboxProvider, type SandboxShellService, SandboxSkillStore, type SandboxSkillStoreOptions, type SandboxVolumeDefinition, type ScheduleLattice, ScheduleLatticeManager, type SchedulerMiddlewareOptions, SemanticMetricsClient, type SharePayload, 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 TopologyEdge, type UnknownToolHandlerConfig, type VectorStoreLatticeInterface, VectorStoreLatticeManager, VolumeFilesystem, type VolumeFsClient, type WorkflowValidationError, type WriteResult, agentInstanceManager, agentLatticeManager, buildGrepResultsDict, buildInput, buildNamedVolumeName, buildSandboxMetadataEnv, buildSkillFile, buildStateAnnotation, checkEmptyContent, clearEncryptionKeyCache, compileInternal, compileWorkflow, computeSandboxName, configureStores, connectAllChannels, createAgentNode, createAgentTeam, createExecuteSqlQueryTool, createFileData, createInfoSqlTool, createListMetricsDataSourcesTool, createListMetricsServersTool, createListTablesSqlTool, createMapNode, createModelSelectorMiddleware, createNodeHandler, createProcessingAgent, createQueryCheckerSqlTool, createQueryMetricDefinitionTool, createQueryMetricsListTool, createQuerySemanticMetricDataTool, createQuerySqlTool, createQueryTableDefinitionTool, createQueryTablesListTool, createResourceAddress, createSandboxProvider, createSchedulerMiddleware, createSharePayload, createTaskMiddleware, createTeamMiddleware, createTeammateTools, createUnknownToolHandlerMiddleware, createWidgetMiddleware, decrypt, describeCronExpression, embeddingsLatticeManager, encrypt, ensureBuiltinAgentsForTenant, eventBus, eventBus as eventBusDefault, extractFetcherError, extractOutput, fileDataToString, formatContentWithLineNumbers, formatGrepMatches, formatGrepResults, formatReadResponse, generateToken, getAgentClient, getAgentConfig, getAllAgentConfigs, getAllBuiltInSkillMetas, getAllToolDefinitions, getBindingRegistry, getBuiltInSkillContent, getBuiltInSkillMeta, getBuiltInSkillNames, getCheckpointSaver, getChunkBuffer, getEmbeddingsClient, getEmbeddingsLattice, getEncryptionKey, getLoggerLattice, getMenuRegistry, getModelLattice, getNextCronTime, getQueueLattice, getSandBoxManager, getScheduleLattice, getStoreLattice, getToolClient, getToolDefinition, getToolLattice, getVectorStoreClient, getVectorStoreLattice, globSearchFiles, grepMatchesFromFiles, grepSearchFiles, hasChunkBuffer, invokeWithRetry, isBuiltInSkill, isUsingDefaultKey, isValidCronExpression, isValidSandboxName, isValidSkillName, loggerLatticeManager, mcpManager, metricsServerManager, modelLatticeManager, normalizeSandboxName, parallelLimit, parseCronExpression, parseSkillFrontmatter, parseYaml, performStringReplacement, queueLatticeManager, registerAgentLattice, registerAgentLatticeWithTenant, registerAgentLattices, registerCheckpointSaver, registerChunkBuffer, registerEmbeddingsLattice, registerExistingTool, registerLoggerLattice, registerModelLattice, registerQueueLattice, registerScheduleLattice, registerStoreLattice, registerTeammateAgent, registerToolLattice, registerVectorStoreLattice, renderTemplate, resolvePath, sandboxLatticeManager, sanitizeToolCallId, scheduleLatticeManager, setBindingRegistry, setMenuRegistry, skillLatticeManager, sqlDatabaseManager, storeLatticeManager, toJsonSchema, toSafeStateExpr, toolLatticeManager, truncateIfTooLong, unregisterTeammateAgent, updateFileData, validateAgentInput, validateDSL, validateEncryptionKey, validatePath, validateSkillName, validateToolInput, vectorStoreLatticeManager };
package/dist/index.d.ts CHANGED
@@ -8,7 +8,7 @@ import { BaseLanguageModelInput, LanguageModelLike, BaseLanguageModel } from '@l
8
8
  import { CallbackManagerForLLMRun } from '@langchain/core/callbacks/manager';
9
9
  import { ChatResult } from '@langchain/core/outputs';
10
10
  import * as _axiom_lattice_protocols from '@axiom-lattice/protocols';
11
- import { LLMConfig, SemanticMetricsServerConfig, MetricMeta, MetricQueryResult, DataSource, SemanticMetricsQueryRequest, SemanticMetricsQueryResponse, TableQueryRequest, TableQueryResponse, ExecuteSqlQueryRequest, ExecuteSqlQueryResponse, MetricsServerType, MetricsServerConfig, ToolConfig, ToolExecutor, AgentConfig, MiddlewareType, GraphBuildOptions, MessageChunk, MessageChunkType, QueueLatticeProtocol, QueueConfig, QueueClient, QueueResult, ScheduleLatticeProtocol, ScheduleConfig, ScheduleClient, ScheduleStorage, TaskHandler, ScheduleOnceOptions, ScheduleCronOptions, ScheduledTaskDefinition, ScheduledTaskStatus, ScheduleExecutionType, ThreadStore, AssistantStore, SkillStore, WorkspaceStore, ProjectStore, DatabaseConfigStore, MetricsServerConfigStore, McpServerConfigStore, UserStore, TenantStore, UserTenantLinkStore, WorkflowTrackingStore, EvalStore, ChannelInstallationStore, BindingRegistry, MenuRegistry, A2AApiKeyStore, TaskStore, Thread, CreateThreadRequest, Assistant, CreateAssistantRequest, Skill, CreateSkillRequest, SkillStoreContext, DatabaseConfigEntry, CreateDatabaseConfigRequest, UpdateDatabaseConfigRequest, User, CreateUserRequest, UpdateUserRequest, Tenant, CreateTenantRequest, UpdateTenantRequest, UserTenantLink, CreateUserTenantLinkRequest, UpdateUserTenantLinkRequest, ChannelInstallation, ChannelInstallationType, CreateChannelInstallationRequest, UpdateChannelInstallationRequest, Binding, CreateBindingInput, A2AApiKeyRecord, CreateA2AApiKeyInput, A2AApiKeyEntry, CreateTaskRequest, TaskItem, TaskListFilter, UpdateTaskRequest, MenuItem, CreateMenuItemInput, UpdateMenuItemInput, LoggerLatticeProtocol, LoggerConfig, LoggerClient, LoggerContext, SkillConfig, SkillClient, ChannelAdapter, InternalStateField, InternalInput, InternalNode, InternalAgentNode, InternalMapNode, InternalDSL } from '@axiom-lattice/protocols';
11
+ import { LLMConfig, SemanticMetricsServerConfig, MetricMeta, MetricQueryResult, DataSource, SemanticMetricsQueryRequest, SemanticMetricsQueryResponse, TableQueryRequest, TableQueryResponse, ExecuteSqlQueryRequest, ExecuteSqlQueryResponse, MetricsServerType, MetricsServerConfig, ToolConfig, ToolExecutor, AgentConfig, MiddlewareType, GraphBuildOptions, MessageChunk, MessageChunkType, QueueLatticeProtocol, QueueConfig, QueueClient, QueueResult, ScheduleLatticeProtocol, ScheduleConfig, ScheduleClient, ScheduleStorage, TaskHandler, ScheduleOnceOptions, ScheduleCronOptions, ScheduledTaskDefinition, ScheduledTaskStatus, ScheduleExecutionType, ThreadStore, AssistantStore, SkillStore, WorkspaceStore, ProjectStore, DatabaseConfigStore, MetricsServerConfigStore, McpServerConfigStore, UserStore, TenantStore, UserTenantLinkStore, WorkflowTrackingStore, EvalStore, ChannelInstallationStore, BindingRegistry, MenuRegistry, A2AApiKeyStore, TaskStore, SharedResourceStore, Thread, CreateThreadRequest, Assistant, CreateAssistantRequest, Skill, CreateSkillRequest, SkillStoreContext, DatabaseConfigEntry, CreateDatabaseConfigRequest, UpdateDatabaseConfigRequest, User, CreateUserRequest, UpdateUserRequest, Tenant, CreateTenantRequest, UpdateTenantRequest, UserTenantLink, CreateUserTenantLinkRequest, UpdateUserTenantLinkRequest, ChannelInstallation, ChannelInstallationType, CreateChannelInstallationRequest, UpdateChannelInstallationRequest, Binding, CreateBindingInput, A2AApiKeyRecord, CreateA2AApiKeyInput, A2AApiKeyEntry, CreateTaskRequest, TaskItem, TaskListFilter, UpdateTaskRequest, MenuItem, CreateMenuItemInput, UpdateMenuItemInput, LoggerLatticeProtocol, LoggerConfig, LoggerClient, LoggerContext, SkillConfig, SkillClient, ResourceResolver, ResourceAddress, ShareVisibility, CreateShareRequest, ChannelAdapter, InternalStateField, InternalInput, InternalNode, InternalAgentNode, InternalMapNode, InternalDSL } from '@axiom-lattice/protocols';
12
12
  export { _axiom_lattice_protocols as Protocols };
13
13
  export { AgentConfig, AgentType, GraphBuildOptions, MemoryType } from '@axiom-lattice/protocols';
14
14
  import * as langchain from 'langchain';
@@ -1410,6 +1410,26 @@ interface BackendProtocol {
1410
1410
  * @returns Raw file content as FileData
1411
1411
  */
1412
1412
  readRaw(filePath: string): MaybePromise<FileData>;
1413
+ /**
1414
+ * Read file content as raw binary Buffer.
1415
+ *
1416
+ * Optional method for backends that support binary file access.
1417
+ * Backends that store files as text (StateBackend, MemoryBackend, StoreBackend)
1418
+ * may omit this method.
1419
+ *
1420
+ * @param filePath - Absolute file path
1421
+ * @returns Raw file content as Buffer
1422
+ */
1423
+ readBinary?(filePath: string): Promise<Buffer>;
1424
+ /**
1425
+ * Write raw binary data to a file.
1426
+ *
1427
+ * Optional method for backends that support binary file writing.
1428
+ *
1429
+ * @param filePath - Absolute file path
1430
+ * @param data - Binary data to write
1431
+ */
1432
+ writeBinary?(filePath: string, data: Buffer): Promise<void>;
1413
1433
  /**
1414
1434
  * Structured search results or error string for invalid input.
1415
1435
  *
@@ -2703,6 +2723,7 @@ type StoreTypeMap = {
2703
2723
  menu: MenuRegistry;
2704
2724
  a2aApiKey: A2AApiKeyStore;
2705
2725
  task: TaskStore;
2726
+ sharedResource: SharedResourceStore;
2706
2727
  };
2707
2728
  /**
2708
2729
  * Store type keys
@@ -4119,6 +4140,13 @@ interface SandboxProvider {
4119
4140
  deleteSandbox(name: string): Promise<void>;
4120
4141
  listSandboxes(): Promise<SandboxInstance[]>;
4121
4142
  createVolumeFsClient?(volumeName: string, pathPrefix?: string): VolumeFsClient;
4143
+ getResourceResolver(): ResourceResolver;
4144
+ createResourceAddress(config: {
4145
+ tenantId: string;
4146
+ workspaceId: string;
4147
+ projectId: string;
4148
+ resourcePath: string;
4149
+ }): ResourceAddress;
4122
4150
  }
4123
4151
 
4124
4152
  type SandboxLifecycleResponse = {
@@ -4217,6 +4245,18 @@ declare class MicrosandboxServiceClient {
4217
4245
  private request;
4218
4246
  }
4219
4247
 
4248
+ /**
4249
+ * Create a project-scoped resource address from tenant, workspace, and project IDs.
4250
+ *
4251
+ * Shared by all sandbox providers for consistent resource naming.
4252
+ */
4253
+ declare function createResourceAddress(config: {
4254
+ tenantId: string;
4255
+ workspaceId: string;
4256
+ projectId: string;
4257
+ resourcePath: string;
4258
+ }): ResourceAddress;
4259
+
4220
4260
  type MicrosandboxRemoteProviderClient = Pick<MicrosandboxServiceClient, "ensureSandbox" | "startSandbox" | "stopSandbox" | "killSandbox" | "deleteSandbox" | "getStatus" | "readFile" | "writeFile" | "listPath" | "findFiles" | "searchInFile" | "replaceInFile" | "uploadFile" | "downloadFile" | "execCommand" | "volumeFsRead" | "volumeFsWrite" | "volumeFsList" | "volumeFsDownload" | "volumeFsUpload">;
4221
4261
  interface MicrosandboxRemoteProviderConfig extends MicrosandboxServiceClientConfig {
4222
4262
  client?: MicrosandboxRemoteProviderClient;
@@ -4236,6 +4276,8 @@ declare class MicrosandboxRemoteProvider implements SandboxProvider {
4236
4276
  deleteSandbox(name: string): Promise<void>;
4237
4277
  createVolumeFsClient(volumeName: string, _pathPrefix?: string): VolumeFsClient;
4238
4278
  listSandboxes(): Promise<SandboxInstance[]>;
4279
+ getResourceResolver(): ResourceResolver;
4280
+ createResourceAddress: typeof createResourceAddress;
4239
4281
  private buildEnsureInput;
4240
4282
  private buildDefaultVolumes;
4241
4283
  }
@@ -4257,6 +4299,8 @@ declare class RemoteSandboxProvider implements SandboxProvider {
4257
4299
  stopSandbox(name: string): Promise<void>;
4258
4300
  deleteSandbox(name: string): Promise<void>;
4259
4301
  listSandboxes(): Promise<SandboxInstance[]>;
4302
+ getResourceResolver(): ResourceResolver;
4303
+ createResourceAddress: typeof createResourceAddress;
4260
4304
  createVolumeFsClient(_volumeName: string, pathPrefix?: string): VolumeFsClient;
4261
4305
  }
4262
4306
 
@@ -4275,6 +4319,8 @@ declare class E2BProvider implements SandboxProvider {
4275
4319
  stopSandbox(name: string): Promise<void>;
4276
4320
  deleteSandbox(name: string): Promise<void>;
4277
4321
  listSandboxes(): Promise<SandboxInstance[]>;
4322
+ getResourceResolver(): ResourceResolver;
4323
+ createResourceAddress: typeof createResourceAddress;
4278
4324
  }
4279
4325
 
4280
4326
  interface DaytonaProviderConfig {
@@ -4305,6 +4351,8 @@ declare class DaytonaProvider implements SandboxProvider {
4305
4351
  stopSandbox(name: string): Promise<void>;
4306
4352
  deleteSandbox(name: string): Promise<void>;
4307
4353
  listSandboxes(): Promise<SandboxInstance[]>;
4354
+ getResourceResolver(): ResourceResolver;
4355
+ createResourceAddress: typeof createResourceAddress;
4308
4356
  }
4309
4357
 
4310
4358
  interface LocalSandboxProviderConfig {
@@ -4349,6 +4397,8 @@ declare class LocalSandboxProvider implements SandboxProvider {
4349
4397
  stopSandbox(name: string): Promise<void>;
4350
4398
  deleteSandbox(name: string): Promise<void>;
4351
4399
  listSandboxes(): Promise<SandboxInstance[]>;
4400
+ getResourceResolver(): ResourceResolver;
4401
+ createResourceAddress: typeof createResourceAddress;
4352
4402
  }
4353
4403
 
4354
4404
  interface CreateSandboxProviderConfig {
@@ -4536,6 +4586,15 @@ declare class SandboxLatticeManager extends BaseLatticeManager<SandboxProvider>
4536
4586
  deleteSandbox(name: string): Promise<void>;
4537
4587
  listSandboxes(): Promise<SandboxInstance[]>;
4538
4588
  private _requireProvider;
4589
+ /**
4590
+ * Returns the first registered (default) sandbox provider.
4591
+ *
4592
+ * Used by the resource sharing system for file resolution
4593
+ * when a specific provider key is not specified.
4594
+ *
4595
+ * @returns The default registered {@link SandboxProvider}.
4596
+ */
4597
+ getDefaultProvider(): SandboxProvider;
4539
4598
  }
4540
4599
  declare const sandboxLatticeManager: SandboxLatticeManager;
4541
4600
  declare const getSandBoxManager: (key?: string) => SandboxManagerProtocol;
@@ -4569,6 +4628,98 @@ declare function buildSandboxMetadataEnv(config?: RunSandboxConfig): Record<stri
4569
4628
 
4570
4629
  declare function buildNamedVolumeName(prefix: "s" | "a" | "p", ...parts: Array<string | undefined>): string;
4571
4630
 
4631
+ /**
4632
+ * A single entry in the token cache, mapping a share token to a resource address.
4633
+ */
4634
+ interface CacheEntry {
4635
+ address: ResourceAddress;
4636
+ /** true = password-protected share; cache hits must re-check auth */
4637
+ requiresUnlock: boolean;
4638
+ }
4639
+ /**
4640
+ * In-memory token → address cache.
4641
+ *
4642
+ * Caches share token lookups so that frequent access to the same resource
4643
+ * does not repeatedly hit the share store. Entries live for a configurable
4644
+ * TTL (default 60s) so that revocations take effect within a bounded window.
4645
+ *
4646
+ * Password-protected shares are cached with {@link CacheEntry.requiresUnlock}
4647
+ * set to `true` so callers know they must still verify the password on every
4648
+ * hit — the cache only avoids the database round-trip, not the auth check.
4649
+ *
4650
+ * @remarks
4651
+ * - Single-instance only. Multi-instance deployments need a Redis pub/sub
4652
+ * broadcast on `share:revoke:{token}` to invalidate across processes.
4653
+ */
4654
+ declare class TokenCache {
4655
+ private cache;
4656
+ private ttlMs;
4657
+ /**
4658
+ * Look up a token in the cache.
4659
+ *
4660
+ * @param token - The share token.
4661
+ * @returns The cached entry, or `null` if the token is absent or expired.
4662
+ */
4663
+ get(token: string): CacheEntry | null;
4664
+ /**
4665
+ * Store a token → address mapping.
4666
+ *
4667
+ * @param token - The share token.
4668
+ * @param entry - The cache entry to associate with the token.
4669
+ */
4670
+ set(token: string, entry: CacheEntry): void;
4671
+ /**
4672
+ * Remove a cached entry (e.g. on revocation).
4673
+ *
4674
+ * @param token - The share token to invalidate.
4675
+ */
4676
+ invalidate(token: string): void;
4677
+ }
4678
+
4679
+ /**
4680
+ * Generate a cryptographically random share token.
4681
+ *
4682
+ * Uses 24 random bytes (192 bits), encoded as base64url for URL-safe transport.
4683
+ *
4684
+ * @returns A URL-safe random token string.
4685
+ */
4686
+ declare function generateToken(): string;
4687
+
4688
+ /**
4689
+ * Shape of the share document to persist in the share store.
4690
+ */
4691
+ interface SharePayload {
4692
+ address: ResourceAddress;
4693
+ tenantId: string;
4694
+ workspaceId: string;
4695
+ projectId: string;
4696
+ assistantId: string | null;
4697
+ vmIsolation: string;
4698
+ visibility: ShareVisibility;
4699
+ passwordHash: string | null;
4700
+ title: string | null;
4701
+ createdBy: string;
4702
+ expiresAt: Date | null;
4703
+ maxAccess: number | null;
4704
+ revoked: boolean;
4705
+ }
4706
+ /**
4707
+ * Build a share payload from the client request and tenant/project context.
4708
+ *
4709
+ * Combines the caller's tenant/project identifiers with the client-provided
4710
+ * {@link CreateShareRequest} to produce a ready-to-persist share document.
4711
+ * The password is stored as a plaintext placeholder — bcrypt hashing is
4712
+ * deferred to a later task.
4713
+ *
4714
+ * @param tenantId - The tenant that owns the resource.
4715
+ * @param workspaceId - The workspace the project belongs to.
4716
+ * @param projectId - The project whose resource path is being shared.
4717
+ * @param userId - The user creating the share.
4718
+ * @param request - Client-provided share parameters.
4719
+ * @returns A complete share payload for persistence.
4720
+ */
4721
+ declare function createSharePayload(tenantId: string, workspaceId: string, projectId: string, userId: string, request: CreateShareRequest): SharePayload;
4722
+
4572
4723
  /**
4573
4724
  * Channel connection lifecycle.
4574
4725
  *
@@ -5582,6 +5733,8 @@ declare class VolumeFilesystem implements BackendProtocol {
5582
5733
  lsInfo(path: string): Promise<FileInfo[]>;
5583
5734
  read(filePath: string, offset?: number, limit?: number): Promise<string>;
5584
5735
  readRaw(filePath: string): Promise<FileData>;
5736
+ readBinary(filePath: string): Promise<Buffer>;
5737
+ writeBinary(filePath: string, data: Buffer): Promise<void>;
5585
5738
  grepRaw(_pattern: string, _path?: string | null, _glob?: string | null): string | GrepMatch[];
5586
5739
  globInfo(_pattern: string, _path?: string): FileInfo[];
5587
5740
  write(filePath: string, content: string): Promise<WriteResult>;
@@ -6804,4 +6957,4 @@ declare class PersonalAssistantConfig {
6804
6957
  static render(config: AgentConfig, name: string, personality: string): void;
6805
6958
  }
6806
6959
 
6807
- export { AGENT_TASK_EVENT, type AddMessageParams, Agent, type AgentClient, type AgentExecutor, AgentInstanceManager, type AgentLattice, AgentLatticeManager, type AgentLifecycleEventName, AgentManager, type AgentStreamExecutor, type AgentThreadInterface, BUILTIN_SKILLS, type BackendFactory, type BackendProtocol, type BufferStats, type Chunk, ChunkBuffer, ChunkBufferLatticeManager, type ColumnInfo, CompositeBackend, type ConnectAllChannelsOptions, ConsoleLoggerClient, type CreateProcessingAgentParams, type CreateSandboxProviderConfig, type CronFields, CustomMetricsClient, type CustomMiddlewareFactory, CustomMiddlewareRegistry, type DatabaseConfig, type DatabaseType, DaytonaInstance, DaytonaProvider, type DaytonaProviderConfig, DefaultScheduleClient, E2BInstance, E2BProvider, type E2BProviderConfig, EMPTY_CONTENT_WARNING, type EditResult, type EmbeddingsLatticeInterface, EmbeddingsLatticeManager, type EnsureMicrosandboxInput, type FileData, type FileInfo, FileSystemSkillStore, type FileSystemSkillStoreOptions, FilesystemBackend, type FsEntry, type GrepMatch, type IMessageQueueStore, type IMetricsServerClient, type ISqlDatabase, InMemoryA2AApiKeyStore, InMemoryAssistantStore, InMemoryBindingStore, InMemoryChannelInstallationStore, InMemoryChunkBuffer, InMemoryDatabaseConfigStore, InMemoryMailboxStore, InMemoryMenuStore, InMemoryTaskListStore, InMemoryTaskStore, InMemoryTenantStore, InMemoryThreadMessageQueueStore, InMemoryThreadStore, InMemoryUserStore, InMemoryUserTenantLinkStore, LINE_NUMBER_WIDTH, type LangGraphStateChecker, 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 PendingMessage, PersonalAssistantConfig, PinoLoggerClient, PostgresDatabase, PrometheusClient, type QueryResult, type QueueLattice, QueueLatticeManager, QueueMode, type QueuePendingEvent, RemoteSandboxInstance, RemoteSandboxProvider, type RemoteSandboxProviderConfig, type ResolveAgentFn, type RunSandboxConfig, type RuntimeModelConfig, type SandboxFileInfo, type SandboxFileService, SandboxFilesystem, type SandboxInstance, type SandboxIsolationLevel, SandboxLatticeManager, type SandboxManagerProtocol, type SandboxProvider, type SandboxShellService, SandboxSkillStore, type SandboxSkillStoreOptions, type SandboxVolumeDefinition, type ScheduleLattice, ScheduleLatticeManager, type SchedulerMiddlewareOptions, SemanticMetricsClient, 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, type ToolDefinition, type ToolLattice, ToolLatticeManager, type TopologyEdge, type UnknownToolHandlerConfig, type VectorStoreLatticeInterface, VectorStoreLatticeManager, VolumeFilesystem, type VolumeFsClient, type WorkflowValidationError, type WriteResult, agentInstanceManager, agentLatticeManager, buildGrepResultsDict, buildInput, buildNamedVolumeName, buildSandboxMetadataEnv, buildSkillFile, buildStateAnnotation, checkEmptyContent, clearEncryptionKeyCache, compileInternal, compileWorkflow, computeSandboxName, configureStores, connectAllChannels, createAgentNode, createAgentTeam, createExecuteSqlQueryTool, createFileData, createInfoSqlTool, createListMetricsDataSourcesTool, createListMetricsServersTool, createListTablesSqlTool, createMapNode, createModelSelectorMiddleware, createNodeHandler, createProcessingAgent, createQueryCheckerSqlTool, createQueryMetricDefinitionTool, createQueryMetricsListTool, createQuerySemanticMetricDataTool, createQuerySqlTool, createQueryTableDefinitionTool, createQueryTablesListTool, createSandboxProvider, createSchedulerMiddleware, createTaskMiddleware, createTeamMiddleware, createTeammateTools, createUnknownToolHandlerMiddleware, createWidgetMiddleware, decrypt, describeCronExpression, embeddingsLatticeManager, encrypt, ensureBuiltinAgentsForTenant, eventBus, eventBus as eventBusDefault, extractFetcherError, extractOutput, fileDataToString, formatContentWithLineNumbers, formatGrepMatches, formatGrepResults, formatReadResponse, getAgentClient, getAgentConfig, getAllAgentConfigs, getAllBuiltInSkillMetas, getAllToolDefinitions, getBindingRegistry, getBuiltInSkillContent, getBuiltInSkillMeta, getBuiltInSkillNames, getCheckpointSaver, getChunkBuffer, getEmbeddingsClient, getEmbeddingsLattice, getEncryptionKey, getLoggerLattice, getMenuRegistry, getModelLattice, getNextCronTime, getQueueLattice, getSandBoxManager, getScheduleLattice, getStoreLattice, getToolClient, getToolDefinition, getToolLattice, getVectorStoreClient, getVectorStoreLattice, globSearchFiles, grepMatchesFromFiles, grepSearchFiles, hasChunkBuffer, invokeWithRetry, isBuiltInSkill, isUsingDefaultKey, isValidCronExpression, isValidSandboxName, isValidSkillName, loggerLatticeManager, mcpManager, metricsServerManager, modelLatticeManager, normalizeSandboxName, parallelLimit, parseCronExpression, parseSkillFrontmatter, parseYaml, performStringReplacement, queueLatticeManager, registerAgentLattice, registerAgentLatticeWithTenant, registerAgentLattices, registerCheckpointSaver, registerChunkBuffer, registerEmbeddingsLattice, registerExistingTool, registerLoggerLattice, registerModelLattice, registerQueueLattice, registerScheduleLattice, registerStoreLattice, registerTeammateAgent, registerToolLattice, registerVectorStoreLattice, renderTemplate, resolvePath, sandboxLatticeManager, sanitizeToolCallId, scheduleLatticeManager, setBindingRegistry, setMenuRegistry, skillLatticeManager, sqlDatabaseManager, storeLatticeManager, toJsonSchema, toSafeStateExpr, toolLatticeManager, truncateIfTooLong, unregisterTeammateAgent, updateFileData, validateAgentInput, validateDSL, validateEncryptionKey, validatePath, validateSkillName, validateToolInput, vectorStoreLatticeManager };
6960
+ export { AGENT_TASK_EVENT, type AddMessageParams, Agent, type AgentClient, type AgentExecutor, AgentInstanceManager, type AgentLattice, AgentLatticeManager, type AgentLifecycleEventName, AgentManager, type AgentStreamExecutor, type AgentThreadInterface, BUILTIN_SKILLS, type BackendFactory, type BackendProtocol, type BufferStats, type CacheEntry, type Chunk, ChunkBuffer, ChunkBufferLatticeManager, type ColumnInfo, CompositeBackend, type ConnectAllChannelsOptions, ConsoleLoggerClient, type CreateProcessingAgentParams, type CreateSandboxProviderConfig, type CronFields, CustomMetricsClient, type CustomMiddlewareFactory, CustomMiddlewareRegistry, type DatabaseConfig, type DatabaseType, DaytonaInstance, DaytonaProvider, type DaytonaProviderConfig, DefaultScheduleClient, E2BInstance, E2BProvider, type E2BProviderConfig, EMPTY_CONTENT_WARNING, type EditResult, type EmbeddingsLatticeInterface, EmbeddingsLatticeManager, type EnsureMicrosandboxInput, type FileData, type FileInfo, FileSystemSkillStore, type FileSystemSkillStoreOptions, FilesystemBackend, type FsEntry, type GrepMatch, type IMessageQueueStore, type IMetricsServerClient, type ISqlDatabase, InMemoryA2AApiKeyStore, InMemoryAssistantStore, InMemoryBindingStore, InMemoryChannelInstallationStore, InMemoryChunkBuffer, InMemoryDatabaseConfigStore, InMemoryMailboxStore, InMemoryMenuStore, InMemoryTaskListStore, InMemoryTaskStore, InMemoryTenantStore, InMemoryThreadMessageQueueStore, InMemoryThreadStore, InMemoryUserStore, InMemoryUserTenantLinkStore, LINE_NUMBER_WIDTH, type LangGraphStateChecker, 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 PendingMessage, PersonalAssistantConfig, PinoLoggerClient, PostgresDatabase, PrometheusClient, type QueryResult, type QueueLattice, QueueLatticeManager, QueueMode, type QueuePendingEvent, RemoteSandboxInstance, RemoteSandboxProvider, type RemoteSandboxProviderConfig, type ResolveAgentFn, type RunSandboxConfig, type RuntimeModelConfig, type SandboxFileInfo, type SandboxFileService, SandboxFilesystem, type SandboxInstance, type SandboxIsolationLevel, SandboxLatticeManager, type SandboxManagerProtocol, type SandboxProvider, type SandboxShellService, SandboxSkillStore, type SandboxSkillStoreOptions, type SandboxVolumeDefinition, type ScheduleLattice, ScheduleLatticeManager, type SchedulerMiddlewareOptions, SemanticMetricsClient, type SharePayload, 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 TopologyEdge, type UnknownToolHandlerConfig, type VectorStoreLatticeInterface, VectorStoreLatticeManager, VolumeFilesystem, type VolumeFsClient, type WorkflowValidationError, type WriteResult, agentInstanceManager, agentLatticeManager, buildGrepResultsDict, buildInput, buildNamedVolumeName, buildSandboxMetadataEnv, buildSkillFile, buildStateAnnotation, checkEmptyContent, clearEncryptionKeyCache, compileInternal, compileWorkflow, computeSandboxName, configureStores, connectAllChannels, createAgentNode, createAgentTeam, createExecuteSqlQueryTool, createFileData, createInfoSqlTool, createListMetricsDataSourcesTool, createListMetricsServersTool, createListTablesSqlTool, createMapNode, createModelSelectorMiddleware, createNodeHandler, createProcessingAgent, createQueryCheckerSqlTool, createQueryMetricDefinitionTool, createQueryMetricsListTool, createQuerySemanticMetricDataTool, createQuerySqlTool, createQueryTableDefinitionTool, createQueryTablesListTool, createResourceAddress, createSandboxProvider, createSchedulerMiddleware, createSharePayload, createTaskMiddleware, createTeamMiddleware, createTeammateTools, createUnknownToolHandlerMiddleware, createWidgetMiddleware, decrypt, describeCronExpression, embeddingsLatticeManager, encrypt, ensureBuiltinAgentsForTenant, eventBus, eventBus as eventBusDefault, extractFetcherError, extractOutput, fileDataToString, formatContentWithLineNumbers, formatGrepMatches, formatGrepResults, formatReadResponse, generateToken, getAgentClient, getAgentConfig, getAllAgentConfigs, getAllBuiltInSkillMetas, getAllToolDefinitions, getBindingRegistry, getBuiltInSkillContent, getBuiltInSkillMeta, getBuiltInSkillNames, getCheckpointSaver, getChunkBuffer, getEmbeddingsClient, getEmbeddingsLattice, getEncryptionKey, getLoggerLattice, getMenuRegistry, getModelLattice, getNextCronTime, getQueueLattice, getSandBoxManager, getScheduleLattice, getStoreLattice, getToolClient, getToolDefinition, getToolLattice, getVectorStoreClient, getVectorStoreLattice, globSearchFiles, grepMatchesFromFiles, grepSearchFiles, hasChunkBuffer, invokeWithRetry, isBuiltInSkill, isUsingDefaultKey, isValidCronExpression, isValidSandboxName, isValidSkillName, loggerLatticeManager, mcpManager, metricsServerManager, modelLatticeManager, normalizeSandboxName, parallelLimit, parseCronExpression, parseSkillFrontmatter, parseYaml, performStringReplacement, queueLatticeManager, registerAgentLattice, registerAgentLatticeWithTenant, registerAgentLattices, registerCheckpointSaver, registerChunkBuffer, registerEmbeddingsLattice, registerExistingTool, registerLoggerLattice, registerModelLattice, registerQueueLattice, registerScheduleLattice, registerStoreLattice, registerTeammateAgent, registerToolLattice, registerVectorStoreLattice, renderTemplate, resolvePath, sandboxLatticeManager, sanitizeToolCallId, scheduleLatticeManager, setBindingRegistry, setMenuRegistry, skillLatticeManager, sqlDatabaseManager, storeLatticeManager, toJsonSchema, toSafeStateExpr, toolLatticeManager, truncateIfTooLong, unregisterTeammateAgent, updateFileData, validateAgentInput, validateDSL, validateEncryptionKey, validatePath, validateSkillName, validateToolInput, vectorStoreLatticeManager };