@axiom-lattice/core 13.3.0 → 13.4.0

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 } from '@langchain/core/language_models/base';
8
8
  import { CallbackManagerForLLMRun } from '@langchain/core/callbacks/manager';
9
9
  import { ChatResult, ChatGenerationChunk } from '@langchain/core/outputs';
10
10
  import * as _axiom_lattice_protocols from '@axiom-lattice/protocols';
11
- import { LLMConfig, ModelProviderEntry, ModelProviderModelEntry, STTConfig, SemanticMetricsServerConfig, MetricMeta, MetricQueryResult, DataSource, SemanticMetricsQueryRequest, SemanticMetricsQueryResponse, TableQueryRequest, TableQueryResponse, ExecuteSqlQueryRequest, ExecuteSqlQueryResponse, MetricsServerType, MetricsServerConfig, ToolConfig, ToolExecutor, AgentConfig, GraphBuildOptions, DeepAgentConfig, MessageChunk, MessageChunkType, QueueLatticeProtocol, QueueConfig, QueueClient, QueueResult, ScheduleLatticeProtocol, ScheduleConfig, ScheduleClient, ScheduleStorage, TaskHandler, ScheduleOnceOptions, ScheduleCronOptions, ScheduledTaskDefinition, ScheduledTaskStatus, ScheduleExecutionType, TrustedRunContext, QueuedExecutionMode, ThreadStore, AssistantStore, SkillStore, CollectionStore, WorkspaceStore, ProjectStore, DatabaseConfigStore, MetricsServerConfigStore, McpServerConfigStore, ModelProviderStore, UserStore, TenantStore, UserTenantLinkStore, UserExternalIdentityStore, OidcProviderConfigStore, PlatformMemberStore, PlatformInvitationStore, OidcIdentityClaimStore, InviteLinkStore, WorkflowTrackingStore, EvalStore, ChannelInstallationStore, BindingRegistry, MenuRegistry, A2AApiKeyStore, OpenAuditStore, TaskStore, SharedResourceStore, ConnectionStore, TaskWorkItemStore, AgentWebAppStore, CapabilityBundleStore, ProjectRoomStore, ProjectMembershipStore, ProjectBotMembershipStore, ProjectRoomMessageStore, ProjectRoomReadStateStore, UserPushSubscriptionStore, LeaseStore, OutboxStore, PluginDeploymentStore, ChannelReplyJobStore, CheckpointStorage, StoreProtocol, PlatformSettingsStore, PlatformAuditStore, SessionStore, VectorStoreProvider, Thread, ThreadMonitorQuery, ThreadMonitorRecord, CreateThreadRequest, StorePutInput, StoreItem, StoreSearchInput, Assistant, CreateAssistantRequest, AgentWebApp, CreateAgentWebAppInput, AgentWebAppStorePatch, AgentWebAppUpdateOptions, Project, CreateProjectRequest, UpdateProjectRequest, UpdateProjectCapabilityBundlesResult, CapabilityBundle, InternalCreateCapabilityBundleInput, InternalUpdateCapabilityBundleInput, CapabilityBundleDeleteResult, Skill, CreateSkillRequest, SkillStoreContext, DatabaseConfigEntry, CreateDatabaseConfigRequest, UpdateDatabaseConfigRequest, CreateModelProviderRequest, UpdateModelProviderRequest, ModelProviderStatus, ProviderModelInput, User, CreateUserRequest, UpdateUserRequest, SessionRecord, Tenant, CreateTenantRequest, UpdateTenantRequest, UserTenantLink, CreateUserTenantLinkRequest, UpdateUserTenantLinkRequest, UserExternalIdentity, OidcProviderConfig, CreateOidcProviderConfigInput, UpdateOidcProviderConfigInput, PlatformMember, PlatformInvitation, OidcIdentityClaimStatus, OidcIdentityClaim, CreateOidcIdentityClaimInput, UpdateOidcIdentityClaimInput, OidcIdentityClaimApproval, InviteLink, CreateInviteLinkInput, ChannelInstallation, ChannelInstallationType, CreateChannelInstallationInput, UpdateChannelInstallationRequest, Binding, CreateBindingInput, BindingMutablePatch, BindingListParams, A2AApiKeyRecord, CreateA2AApiKeyInput, UpdateA2AApiKeyInput, A2AApiKeyEntry, OpenAuditAppendInput, OpenAuditRecord, OpenAuditQuery, PlatformAuditAppendInput, PlatformAuditRecord, PlatformAuditQuery, TaskMutationSnapshot, CreateTaskRequest, TaskItem, TaskListFilter, TaskDependentListQuery, UpdateTaskRequest, CreateWorkItemRequest, TaskWorkItem, CreateWorkItemIfAbsentRequest, TaskWorkItemListFilter, ProjectLifecycleEventQuery, Collection, CreateCollectionRequest, UpdateCollectionRequest, MenuItem, CreateMenuItemInput, UpdateMenuItemInput, ProjectRoom, ProjectMembership, ProjectBotMembership, ProjectRoomMessage, Workspace, CreateWorkspaceRequest, UpdateWorkspaceRequest, ProjectHumanRole, ProjectMembershipMutationResult, ProjectRoomReadState, UserPushSubscription, LeaseRecord, OutboxEvent, CreateChannelReplyJobInput, ChannelReplyJob, PlatformSettingsRecord, PlatformSettingsDocument, ShareRecord, CreateShareRecord, ShareRecordPatch, AuthProvider, LoginSurface, Principal, STTModelLatticeProtocol, STTClient, TranscriptionResult, LoggerLatticeProtocol, LoggerConfig, LoggerClient, LoggerContext, PinoFileOptions, SkillConfig, SkillClient, PluginSkillDefinition, McpTool, McpUiResourcePayload, McpServerConfig, PersonalMcpServerConfigStore, McpUiRef, ResourceResolver, ResourceAddress, ShareVisibility, OpenGrant, McpAppShareApp, McpAppShareRecord, CreateFileShareRequest, ObservabilityDashboardInput, ObservabilityDashboardResult, ChannelAdapter, InterruptPolicy, AgentInterrupt, ProjectTaskLifecycleAction, TaskBeliefState, PluginMeta, Plugin, PluginMetaOutput, SandboxPluginManifest, SandboxPluginToolDef, SandboxPluginDiagnostic, CapabilityPreview, CreateCapabilityBundleInput, UpdateCapabilityBundleInput, InternalInput, InternalStateField, InternalAgentNode, InternalMapNode, InternalNode, InternalDSL, ConnectionEntry } from '@axiom-lattice/protocols';
11
+ import { LLMConfig, ModelProviderEntry, ModelProviderModelEntry, STTConfig, SemanticMetricsServerConfig, MetricMeta, MetricQueryResult, DataSource, SemanticMetricsQueryRequest, SemanticMetricsQueryResponse, TableQueryRequest, TableQueryResponse, ExecuteSqlQueryRequest, ExecuteSqlQueryResponse, MetricsServerType, MetricsServerConfig, ToolConfig, ToolExecutor, AgentConfig, GraphBuildOptions, DeepAgentConfig, MessageChunk, MessageChunkType, QueueLatticeProtocol, QueueConfig, QueueClient, QueueResult, ScheduleLatticeProtocol, ScheduleConfig, ScheduleClient, ScheduleStorage, TaskHandler, ScheduleOnceOptions, ScheduleCronOptions, ScheduledTaskDefinition, ScheduledTaskStatus, ScheduleExecutionType, TrustedRunContext, QueuedExecutionMode, ThreadStore, AssistantStore, SkillStore, CollectionStore, WorkspaceStore, ProjectStore, DatabaseConfigStore, MetricsServerConfigStore, McpServerConfigStore, ModelProviderStore, UserStore, TenantStore, UserTenantLinkStore, UserExternalIdentityStore, OidcProviderConfigStore, PlatformMemberStore, PlatformInvitationStore, OidcIdentityClaimStore, InviteLinkStore, WorkflowTrackingStore, EvalStore, ChannelInstallationStore, BindingRegistry, MenuRegistry, A2AApiKeyStore, OpenAuditStore, TaskStore, SharedResourceStore, ConnectionStore, TaskWorkItemStore, AgentWebAppStore, CapabilityBundleStore, ProjectRoomStore, ProjectMembershipStore, ProjectBotMembershipStore, ProjectRoomMessageStore, ProjectRoomReadStateStore, UserPushSubscriptionStore, LeaseStore, OutboxStore, PluginDeploymentStore, ChannelReplyJobStore, CheckpointStorage, StoreProtocol, PlatformSettingsStore, PlatformAuditStore, SessionStore, VectorStoreProvider, Thread, ThreadMonitorQuery, ThreadMonitorRecord, ChannelSenderSummary, CreateThreadRequest, StorePutInput, StoreItem, StoreSearchInput, Assistant, CreateAssistantRequest, AgentWebApp, CreateAgentWebAppInput, AgentWebAppStorePatch, AgentWebAppUpdateOptions, Project, CreateProjectRequest, UpdateProjectRequest, UpdateProjectCapabilityBundlesResult, CapabilityBundle, InternalCreateCapabilityBundleInput, InternalUpdateCapabilityBundleInput, CapabilityBundleDeleteResult, Skill, CreateSkillRequest, SkillStoreContext, DatabaseConfigEntry, CreateDatabaseConfigRequest, UpdateDatabaseConfigRequest, CreateModelProviderRequest, UpdateModelProviderRequest, ModelProviderStatus, ProviderModelInput, User, CreateUserRequest, UpdateUserRequest, SessionRecord, Tenant, CreateTenantRequest, UpdateTenantRequest, UserTenantLink, CreateUserTenantLinkRequest, UpdateUserTenantLinkRequest, UserExternalIdentity, OidcProviderConfig, CreateOidcProviderConfigInput, UpdateOidcProviderConfigInput, PlatformMember, PlatformInvitation, OidcIdentityClaimStatus, OidcIdentityClaim, CreateOidcIdentityClaimInput, UpdateOidcIdentityClaimInput, OidcIdentityClaimApproval, InviteLink, CreateInviteLinkInput, ChannelInstallation, ChannelInstallationType, CreateChannelInstallationInput, UpdateChannelInstallationRequest, Binding, CreateBindingInput, BindingMutablePatch, BindingListParams, A2AApiKeyRecord, CreateA2AApiKeyInput, UpdateA2AApiKeyInput, A2AApiKeyEntry, OpenAuditAppendInput, OpenAuditRecord, OpenAuditQuery, PlatformAuditAppendInput, PlatformAuditRecord, PlatformAuditQuery, TaskMutationSnapshot, CreateTaskRequest, TaskItem, TaskListFilter, TaskDependentListQuery, UpdateTaskRequest, CreateWorkItemRequest, TaskWorkItem, CreateWorkItemIfAbsentRequest, TaskWorkItemListFilter, ProjectLifecycleEventQuery, Collection, CreateCollectionRequest, UpdateCollectionRequest, MenuItem, CreateMenuItemInput, UpdateMenuItemInput, ProjectRoom, ProjectMembership, ProjectBotMembership, ProjectRoomMessage, Workspace, CreateWorkspaceRequest, UpdateWorkspaceRequest, ProjectHumanRole, ProjectMembershipMutationResult, ProjectRoomReadState, UserPushSubscription, LeaseRecord, OutboxEvent, CreateChannelReplyJobInput, ChannelReplyJob, PlatformSettingsRecord, PlatformSettingsDocument, ShareRecord, CreateShareRecord, ShareRecordPatch, AuthProvider, LoginSurface, Principal, STTModelLatticeProtocol, STTClient, TranscriptionResult, LoggerLatticeProtocol, LoggerConfig, LoggerClient, LoggerContext, PinoFileOptions, SkillConfig, SkillClient, PluginSkillDefinition, McpTool, McpUiResourcePayload, McpServerConfig, PersonalMcpServerConfigStore, McpUiRef, ResourceResolver, ResourceAddress, ShareVisibility, OpenGrant, McpAppShareApp, McpAppShareRecord, CreateFileShareRequest, ObservabilityDashboardInput, ObservabilityDashboardResult, ChannelAdapter, InterruptPolicy, AgentInterrupt, ProjectTaskLifecycleAction, TaskBeliefState, PluginMeta, Plugin, PluginMetaOutput, SandboxPluginManifest, SandboxPluginToolDef, SandboxPluginDiagnostic, CapabilityPreview, CreateCapabilityBundleInput, UpdateCapabilityBundleInput, InternalInput, InternalStateField, InternalAgentNode, InternalMapNode, InternalNode, InternalDSL, ConnectionEntry } from '@axiom-lattice/protocols';
12
12
  export { _axiom_lattice_protocols as Protocols };
13
13
  export { AgentConfig, AgentType, GraphBuildOptions, McpServerConfigEntry, MemoryType, PersonalMcpServerConfigEntry, ProjectRoomTrustedRunContext, QueuedExecutionMode, TrustedRunContext, parseQueuedExecutionMode, parseTrustedRunContext } from '@axiom-lattice/protocols';
14
14
  import * as langchain from 'langchain';
@@ -5108,6 +5108,7 @@ declare class InMemoryThreadStore implements ThreadStore {
5108
5108
  records: ThreadMonitorRecord[];
5109
5109
  total: number;
5110
5110
  }>;
5111
+ listChannelSenders(tenantId: string, channelInstallationId: string, limit: number): Promise<ChannelSenderSummary[]>;
5111
5112
  /**
5112
5113
  * Get a thread by ID for a specific tenant
5113
5114
  */
@@ -9836,7 +9837,7 @@ declare const getSandBoxManager: (key?: string) => SandboxManagerProtocol;
9836
9837
  * Every consumer that reads or writes tenant-level sandbox data (skills,
9837
9838
  * plugins, knowledge, SDK bundles, the plugin host) derives its path from
9838
9839
  * these values instead of hardcoding `/root/.agents`. New deployments default
9839
- * to the non-root runtime (`/home/appuser`, image `0.2.1`). Old root deployments
9840
+ * to the non-root runtime (`/home/appuser`, image `0.2.2`). Old root deployments
9840
9841
  * opt out with `SANDBOX_RUNTIME_PROFILE=legacy-root` (or a legacy
9841
9842
  * `SANDBOX_HOME=/root` / `0.1.0` image for backward compatibility).
9842
9843
  *
@@ -9847,7 +9848,7 @@ declare const getSandBoxManager: (key?: string) => SandboxManagerProtocol;
9847
9848
  * process user's home, not the sandbox user's home.
9848
9849
  */
9849
9850
  /** Non-root default sandbox image. */
9850
- declare const NONROOT_SANDBOX_IMAGE = "kioko12520/sandbox:0.2.1";
9851
+ declare const NONROOT_SANDBOX_IMAGE = "kioko12520/sandbox:0.2.2";
9851
9852
  /** Legacy root sandbox image. */
9852
9853
  declare const LEGACY_ROOT_SANDBOX_IMAGE = "kioko12520/sandbox:0.1.0";
9853
9854
  /** Supported sandbox runtime profiles. */
@@ -9866,7 +9867,7 @@ interface ResolvedSandboxRuntime {
9866
9867
  *
9867
9868
  * `SANDBOX_RUNTIME_PROFILE` is the single recommended switch:
9868
9869
  *
9869
- * - omitted or `nonroot`: `/home/appuser`, image `0.2.1`
9870
+ * - omitted or `nonroot`: `/home/appuser`, image `0.2.2`
9870
9871
  * - `legacy-root`: `/root`, image `0.1.0`
9871
9872
  *
9872
9873
  * For backward compatibility, an explicit `SANDBOX_HOME=/root` or pinning the
@@ -12174,6 +12175,8 @@ declare class Agent {
12174
12175
  private directInvokeAbort;
12175
12176
  private abortPromise?;
12176
12177
  private activeExecutionPromise?;
12178
+ /** Scope requested while a run is in flight; applied before the next run. */
12179
+ private pendingExecutionScope?;
12177
12180
  /**
12178
12181
  * Run signals stopped by the destructive {@link abort}.
12179
12182
  *
@@ -12240,6 +12243,19 @@ declare class Agent {
12240
12243
  workspace_id?: string | null;
12241
12244
  project_id?: string | null;
12242
12245
  }): void;
12246
+ /**
12247
+ * Re-pins scope for a dispatch without racing an in-flight run.
12248
+ *
12249
+ * Legacy entry points reuse one Agent per thread; when they carry a project
12250
+ * scope they must make it authoritative before the next sandbox is created.
12251
+ * If a run is already active, defer the update until it settles.
12252
+ */
12253
+ applyExecutionScopeIfIdle(params: {
12254
+ workspace_id?: string | null;
12255
+ project_id?: string | null;
12256
+ }): void;
12257
+ /** Applies a scope requested during the previous active execution. */
12258
+ private applyPendingExecutionScope;
12243
12259
  /**
12244
12260
  * Accepts host-authenticated queue metadata through the package-private symbol capability.
12245
12261
  *
@@ -13441,10 +13457,24 @@ declare class AgentInstanceManager {
13441
13457
  */
13442
13458
  setRunLedger(ledger: IAgentRunLedger, idFactory?: () => string): void;
13443
13459
  /**
13444
- * Get or create Agent instance for a thread
13445
- * Ensures only one instance per thread exists
13460
+ * Get or create Agent instance for a thread.
13461
+ *
13462
+ * Ensures only one instance per thread exists. Read-only callers should use
13463
+ * {@link getAgentForRead}; dispatch callers use {@link getAgentForDispatch}
13464
+ * so the run's project scope is applied before a sandbox is created.
13446
13465
  */
13447
13466
  getAgent(params: AgentThreadInterface): Agent;
13467
+ /**
13468
+ * Resolve the managed Agent for a dispatch and apply its explicit project.
13469
+ *
13470
+ * Legacy execution paths (channels, commands, cron, scheduler, Web App,
13471
+ * Open API, task comments, queue recovery) reuse the same per-thread Agent
13472
+ * instance. An explicit project must become authoritative before the next
13473
+ * sandbox is created; while a run is active it is deferred by
13474
+ * {@link Agent.applyExecutionScopeIfIdle}. Calls without a project do not
13475
+ * clear an already-established scope.
13476
+ */
13477
+ getAgentForDispatch(params: AgentThreadInterface): Agent;
13448
13478
  /**
13449
13479
  * Get the managed Agent for an exclusive execution and re-pin its scope.
13450
13480
  *
@@ -13460,14 +13490,11 @@ declare class AgentInstanceManager {
13460
13490
  /**
13461
13491
  * Get the managed Agent for a thread WITHOUT creating or registering one.
13462
13492
  *
13463
- * Read-only control-plane callers (state, memory, inbox) must not be the first
13464
- * to establish a thread's execution scope: since identity is
13465
- * `(tenant_id, assistant_id, thread_id)`, whichever caller reaches
13466
- * {@link getAgent} first fixes the instance's workspace/project for its whole
13467
- * lifetime, and a later trusted dispatch on that thread would then fail
13468
- * trusted-scope validation. This returns the existing managed instance when
13493
+ * Read-only control-plane callers (state, memory, inbox) must not mutate a
13494
+ * thread's execution scope. This returns the existing managed instance when
13469
13495
  * present, otherwise a transient unregistered Agent that is sufficient for
13470
- * state reads and disappears with the request.
13496
+ * state reads and disappears with the request. Dispatch callers use
13497
+ * {@link getAgentForDispatch}.
13471
13498
  *
13472
13499
  * @param params - Thread identity; scope is only used for the transient Agent.
13473
13500
  * @returns The managed instance if any, else an unregistered read-only Agent.
package/dist/index.d.ts CHANGED
@@ -8,7 +8,7 @@ import { BaseLanguageModelInput } from '@langchain/core/language_models/base';
8
8
  import { CallbackManagerForLLMRun } from '@langchain/core/callbacks/manager';
9
9
  import { ChatResult, ChatGenerationChunk } from '@langchain/core/outputs';
10
10
  import * as _axiom_lattice_protocols from '@axiom-lattice/protocols';
11
- import { LLMConfig, ModelProviderEntry, ModelProviderModelEntry, STTConfig, SemanticMetricsServerConfig, MetricMeta, MetricQueryResult, DataSource, SemanticMetricsQueryRequest, SemanticMetricsQueryResponse, TableQueryRequest, TableQueryResponse, ExecuteSqlQueryRequest, ExecuteSqlQueryResponse, MetricsServerType, MetricsServerConfig, ToolConfig, ToolExecutor, AgentConfig, GraphBuildOptions, DeepAgentConfig, MessageChunk, MessageChunkType, QueueLatticeProtocol, QueueConfig, QueueClient, QueueResult, ScheduleLatticeProtocol, ScheduleConfig, ScheduleClient, ScheduleStorage, TaskHandler, ScheduleOnceOptions, ScheduleCronOptions, ScheduledTaskDefinition, ScheduledTaskStatus, ScheduleExecutionType, TrustedRunContext, QueuedExecutionMode, ThreadStore, AssistantStore, SkillStore, CollectionStore, WorkspaceStore, ProjectStore, DatabaseConfigStore, MetricsServerConfigStore, McpServerConfigStore, ModelProviderStore, UserStore, TenantStore, UserTenantLinkStore, UserExternalIdentityStore, OidcProviderConfigStore, PlatformMemberStore, PlatformInvitationStore, OidcIdentityClaimStore, InviteLinkStore, WorkflowTrackingStore, EvalStore, ChannelInstallationStore, BindingRegistry, MenuRegistry, A2AApiKeyStore, OpenAuditStore, TaskStore, SharedResourceStore, ConnectionStore, TaskWorkItemStore, AgentWebAppStore, CapabilityBundleStore, ProjectRoomStore, ProjectMembershipStore, ProjectBotMembershipStore, ProjectRoomMessageStore, ProjectRoomReadStateStore, UserPushSubscriptionStore, LeaseStore, OutboxStore, PluginDeploymentStore, ChannelReplyJobStore, CheckpointStorage, StoreProtocol, PlatformSettingsStore, PlatformAuditStore, SessionStore, VectorStoreProvider, Thread, ThreadMonitorQuery, ThreadMonitorRecord, CreateThreadRequest, StorePutInput, StoreItem, StoreSearchInput, Assistant, CreateAssistantRequest, AgentWebApp, CreateAgentWebAppInput, AgentWebAppStorePatch, AgentWebAppUpdateOptions, Project, CreateProjectRequest, UpdateProjectRequest, UpdateProjectCapabilityBundlesResult, CapabilityBundle, InternalCreateCapabilityBundleInput, InternalUpdateCapabilityBundleInput, CapabilityBundleDeleteResult, Skill, CreateSkillRequest, SkillStoreContext, DatabaseConfigEntry, CreateDatabaseConfigRequest, UpdateDatabaseConfigRequest, CreateModelProviderRequest, UpdateModelProviderRequest, ModelProviderStatus, ProviderModelInput, User, CreateUserRequest, UpdateUserRequest, SessionRecord, Tenant, CreateTenantRequest, UpdateTenantRequest, UserTenantLink, CreateUserTenantLinkRequest, UpdateUserTenantLinkRequest, UserExternalIdentity, OidcProviderConfig, CreateOidcProviderConfigInput, UpdateOidcProviderConfigInput, PlatformMember, PlatformInvitation, OidcIdentityClaimStatus, OidcIdentityClaim, CreateOidcIdentityClaimInput, UpdateOidcIdentityClaimInput, OidcIdentityClaimApproval, InviteLink, CreateInviteLinkInput, ChannelInstallation, ChannelInstallationType, CreateChannelInstallationInput, UpdateChannelInstallationRequest, Binding, CreateBindingInput, BindingMutablePatch, BindingListParams, A2AApiKeyRecord, CreateA2AApiKeyInput, UpdateA2AApiKeyInput, A2AApiKeyEntry, OpenAuditAppendInput, OpenAuditRecord, OpenAuditQuery, PlatformAuditAppendInput, PlatformAuditRecord, PlatformAuditQuery, TaskMutationSnapshot, CreateTaskRequest, TaskItem, TaskListFilter, TaskDependentListQuery, UpdateTaskRequest, CreateWorkItemRequest, TaskWorkItem, CreateWorkItemIfAbsentRequest, TaskWorkItemListFilter, ProjectLifecycleEventQuery, Collection, CreateCollectionRequest, UpdateCollectionRequest, MenuItem, CreateMenuItemInput, UpdateMenuItemInput, ProjectRoom, ProjectMembership, ProjectBotMembership, ProjectRoomMessage, Workspace, CreateWorkspaceRequest, UpdateWorkspaceRequest, ProjectHumanRole, ProjectMembershipMutationResult, ProjectRoomReadState, UserPushSubscription, LeaseRecord, OutboxEvent, CreateChannelReplyJobInput, ChannelReplyJob, PlatformSettingsRecord, PlatformSettingsDocument, ShareRecord, CreateShareRecord, ShareRecordPatch, AuthProvider, LoginSurface, Principal, STTModelLatticeProtocol, STTClient, TranscriptionResult, LoggerLatticeProtocol, LoggerConfig, LoggerClient, LoggerContext, PinoFileOptions, SkillConfig, SkillClient, PluginSkillDefinition, McpTool, McpUiResourcePayload, McpServerConfig, PersonalMcpServerConfigStore, McpUiRef, ResourceResolver, ResourceAddress, ShareVisibility, OpenGrant, McpAppShareApp, McpAppShareRecord, CreateFileShareRequest, ObservabilityDashboardInput, ObservabilityDashboardResult, ChannelAdapter, InterruptPolicy, AgentInterrupt, ProjectTaskLifecycleAction, TaskBeliefState, PluginMeta, Plugin, PluginMetaOutput, SandboxPluginManifest, SandboxPluginToolDef, SandboxPluginDiagnostic, CapabilityPreview, CreateCapabilityBundleInput, UpdateCapabilityBundleInput, InternalInput, InternalStateField, InternalAgentNode, InternalMapNode, InternalNode, InternalDSL, ConnectionEntry } from '@axiom-lattice/protocols';
11
+ import { LLMConfig, ModelProviderEntry, ModelProviderModelEntry, STTConfig, SemanticMetricsServerConfig, MetricMeta, MetricQueryResult, DataSource, SemanticMetricsQueryRequest, SemanticMetricsQueryResponse, TableQueryRequest, TableQueryResponse, ExecuteSqlQueryRequest, ExecuteSqlQueryResponse, MetricsServerType, MetricsServerConfig, ToolConfig, ToolExecutor, AgentConfig, GraphBuildOptions, DeepAgentConfig, MessageChunk, MessageChunkType, QueueLatticeProtocol, QueueConfig, QueueClient, QueueResult, ScheduleLatticeProtocol, ScheduleConfig, ScheduleClient, ScheduleStorage, TaskHandler, ScheduleOnceOptions, ScheduleCronOptions, ScheduledTaskDefinition, ScheduledTaskStatus, ScheduleExecutionType, TrustedRunContext, QueuedExecutionMode, ThreadStore, AssistantStore, SkillStore, CollectionStore, WorkspaceStore, ProjectStore, DatabaseConfigStore, MetricsServerConfigStore, McpServerConfigStore, ModelProviderStore, UserStore, TenantStore, UserTenantLinkStore, UserExternalIdentityStore, OidcProviderConfigStore, PlatformMemberStore, PlatformInvitationStore, OidcIdentityClaimStore, InviteLinkStore, WorkflowTrackingStore, EvalStore, ChannelInstallationStore, BindingRegistry, MenuRegistry, A2AApiKeyStore, OpenAuditStore, TaskStore, SharedResourceStore, ConnectionStore, TaskWorkItemStore, AgentWebAppStore, CapabilityBundleStore, ProjectRoomStore, ProjectMembershipStore, ProjectBotMembershipStore, ProjectRoomMessageStore, ProjectRoomReadStateStore, UserPushSubscriptionStore, LeaseStore, OutboxStore, PluginDeploymentStore, ChannelReplyJobStore, CheckpointStorage, StoreProtocol, PlatformSettingsStore, PlatformAuditStore, SessionStore, VectorStoreProvider, Thread, ThreadMonitorQuery, ThreadMonitorRecord, ChannelSenderSummary, CreateThreadRequest, StorePutInput, StoreItem, StoreSearchInput, Assistant, CreateAssistantRequest, AgentWebApp, CreateAgentWebAppInput, AgentWebAppStorePatch, AgentWebAppUpdateOptions, Project, CreateProjectRequest, UpdateProjectRequest, UpdateProjectCapabilityBundlesResult, CapabilityBundle, InternalCreateCapabilityBundleInput, InternalUpdateCapabilityBundleInput, CapabilityBundleDeleteResult, Skill, CreateSkillRequest, SkillStoreContext, DatabaseConfigEntry, CreateDatabaseConfigRequest, UpdateDatabaseConfigRequest, CreateModelProviderRequest, UpdateModelProviderRequest, ModelProviderStatus, ProviderModelInput, User, CreateUserRequest, UpdateUserRequest, SessionRecord, Tenant, CreateTenantRequest, UpdateTenantRequest, UserTenantLink, CreateUserTenantLinkRequest, UpdateUserTenantLinkRequest, UserExternalIdentity, OidcProviderConfig, CreateOidcProviderConfigInput, UpdateOidcProviderConfigInput, PlatformMember, PlatformInvitation, OidcIdentityClaimStatus, OidcIdentityClaim, CreateOidcIdentityClaimInput, UpdateOidcIdentityClaimInput, OidcIdentityClaimApproval, InviteLink, CreateInviteLinkInput, ChannelInstallation, ChannelInstallationType, CreateChannelInstallationInput, UpdateChannelInstallationRequest, Binding, CreateBindingInput, BindingMutablePatch, BindingListParams, A2AApiKeyRecord, CreateA2AApiKeyInput, UpdateA2AApiKeyInput, A2AApiKeyEntry, OpenAuditAppendInput, OpenAuditRecord, OpenAuditQuery, PlatformAuditAppendInput, PlatformAuditRecord, PlatformAuditQuery, TaskMutationSnapshot, CreateTaskRequest, TaskItem, TaskListFilter, TaskDependentListQuery, UpdateTaskRequest, CreateWorkItemRequest, TaskWorkItem, CreateWorkItemIfAbsentRequest, TaskWorkItemListFilter, ProjectLifecycleEventQuery, Collection, CreateCollectionRequest, UpdateCollectionRequest, MenuItem, CreateMenuItemInput, UpdateMenuItemInput, ProjectRoom, ProjectMembership, ProjectBotMembership, ProjectRoomMessage, Workspace, CreateWorkspaceRequest, UpdateWorkspaceRequest, ProjectHumanRole, ProjectMembershipMutationResult, ProjectRoomReadState, UserPushSubscription, LeaseRecord, OutboxEvent, CreateChannelReplyJobInput, ChannelReplyJob, PlatformSettingsRecord, PlatformSettingsDocument, ShareRecord, CreateShareRecord, ShareRecordPatch, AuthProvider, LoginSurface, Principal, STTModelLatticeProtocol, STTClient, TranscriptionResult, LoggerLatticeProtocol, LoggerConfig, LoggerClient, LoggerContext, PinoFileOptions, SkillConfig, SkillClient, PluginSkillDefinition, McpTool, McpUiResourcePayload, McpServerConfig, PersonalMcpServerConfigStore, McpUiRef, ResourceResolver, ResourceAddress, ShareVisibility, OpenGrant, McpAppShareApp, McpAppShareRecord, CreateFileShareRequest, ObservabilityDashboardInput, ObservabilityDashboardResult, ChannelAdapter, InterruptPolicy, AgentInterrupt, ProjectTaskLifecycleAction, TaskBeliefState, PluginMeta, Plugin, PluginMetaOutput, SandboxPluginManifest, SandboxPluginToolDef, SandboxPluginDiagnostic, CapabilityPreview, CreateCapabilityBundleInput, UpdateCapabilityBundleInput, InternalInput, InternalStateField, InternalAgentNode, InternalMapNode, InternalNode, InternalDSL, ConnectionEntry } from '@axiom-lattice/protocols';
12
12
  export { _axiom_lattice_protocols as Protocols };
13
13
  export { AgentConfig, AgentType, GraphBuildOptions, McpServerConfigEntry, MemoryType, PersonalMcpServerConfigEntry, ProjectRoomTrustedRunContext, QueuedExecutionMode, TrustedRunContext, parseQueuedExecutionMode, parseTrustedRunContext } from '@axiom-lattice/protocols';
14
14
  import * as langchain from 'langchain';
@@ -5108,6 +5108,7 @@ declare class InMemoryThreadStore implements ThreadStore {
5108
5108
  records: ThreadMonitorRecord[];
5109
5109
  total: number;
5110
5110
  }>;
5111
+ listChannelSenders(tenantId: string, channelInstallationId: string, limit: number): Promise<ChannelSenderSummary[]>;
5111
5112
  /**
5112
5113
  * Get a thread by ID for a specific tenant
5113
5114
  */
@@ -9836,7 +9837,7 @@ declare const getSandBoxManager: (key?: string) => SandboxManagerProtocol;
9836
9837
  * Every consumer that reads or writes tenant-level sandbox data (skills,
9837
9838
  * plugins, knowledge, SDK bundles, the plugin host) derives its path from
9838
9839
  * these values instead of hardcoding `/root/.agents`. New deployments default
9839
- * to the non-root runtime (`/home/appuser`, image `0.2.1`). Old root deployments
9840
+ * to the non-root runtime (`/home/appuser`, image `0.2.2`). Old root deployments
9840
9841
  * opt out with `SANDBOX_RUNTIME_PROFILE=legacy-root` (or a legacy
9841
9842
  * `SANDBOX_HOME=/root` / `0.1.0` image for backward compatibility).
9842
9843
  *
@@ -9847,7 +9848,7 @@ declare const getSandBoxManager: (key?: string) => SandboxManagerProtocol;
9847
9848
  * process user's home, not the sandbox user's home.
9848
9849
  */
9849
9850
  /** Non-root default sandbox image. */
9850
- declare const NONROOT_SANDBOX_IMAGE = "kioko12520/sandbox:0.2.1";
9851
+ declare const NONROOT_SANDBOX_IMAGE = "kioko12520/sandbox:0.2.2";
9851
9852
  /** Legacy root sandbox image. */
9852
9853
  declare const LEGACY_ROOT_SANDBOX_IMAGE = "kioko12520/sandbox:0.1.0";
9853
9854
  /** Supported sandbox runtime profiles. */
@@ -9866,7 +9867,7 @@ interface ResolvedSandboxRuntime {
9866
9867
  *
9867
9868
  * `SANDBOX_RUNTIME_PROFILE` is the single recommended switch:
9868
9869
  *
9869
- * - omitted or `nonroot`: `/home/appuser`, image `0.2.1`
9870
+ * - omitted or `nonroot`: `/home/appuser`, image `0.2.2`
9870
9871
  * - `legacy-root`: `/root`, image `0.1.0`
9871
9872
  *
9872
9873
  * For backward compatibility, an explicit `SANDBOX_HOME=/root` or pinning the
@@ -12174,6 +12175,8 @@ declare class Agent {
12174
12175
  private directInvokeAbort;
12175
12176
  private abortPromise?;
12176
12177
  private activeExecutionPromise?;
12178
+ /** Scope requested while a run is in flight; applied before the next run. */
12179
+ private pendingExecutionScope?;
12177
12180
  /**
12178
12181
  * Run signals stopped by the destructive {@link abort}.
12179
12182
  *
@@ -12240,6 +12243,19 @@ declare class Agent {
12240
12243
  workspace_id?: string | null;
12241
12244
  project_id?: string | null;
12242
12245
  }): void;
12246
+ /**
12247
+ * Re-pins scope for a dispatch without racing an in-flight run.
12248
+ *
12249
+ * Legacy entry points reuse one Agent per thread; when they carry a project
12250
+ * scope they must make it authoritative before the next sandbox is created.
12251
+ * If a run is already active, defer the update until it settles.
12252
+ */
12253
+ applyExecutionScopeIfIdle(params: {
12254
+ workspace_id?: string | null;
12255
+ project_id?: string | null;
12256
+ }): void;
12257
+ /** Applies a scope requested during the previous active execution. */
12258
+ private applyPendingExecutionScope;
12243
12259
  /**
12244
12260
  * Accepts host-authenticated queue metadata through the package-private symbol capability.
12245
12261
  *
@@ -13441,10 +13457,24 @@ declare class AgentInstanceManager {
13441
13457
  */
13442
13458
  setRunLedger(ledger: IAgentRunLedger, idFactory?: () => string): void;
13443
13459
  /**
13444
- * Get or create Agent instance for a thread
13445
- * Ensures only one instance per thread exists
13460
+ * Get or create Agent instance for a thread.
13461
+ *
13462
+ * Ensures only one instance per thread exists. Read-only callers should use
13463
+ * {@link getAgentForRead}; dispatch callers use {@link getAgentForDispatch}
13464
+ * so the run's project scope is applied before a sandbox is created.
13446
13465
  */
13447
13466
  getAgent(params: AgentThreadInterface): Agent;
13467
+ /**
13468
+ * Resolve the managed Agent for a dispatch and apply its explicit project.
13469
+ *
13470
+ * Legacy execution paths (channels, commands, cron, scheduler, Web App,
13471
+ * Open API, task comments, queue recovery) reuse the same per-thread Agent
13472
+ * instance. An explicit project must become authoritative before the next
13473
+ * sandbox is created; while a run is active it is deferred by
13474
+ * {@link Agent.applyExecutionScopeIfIdle}. Calls without a project do not
13475
+ * clear an already-established scope.
13476
+ */
13477
+ getAgentForDispatch(params: AgentThreadInterface): Agent;
13448
13478
  /**
13449
13479
  * Get the managed Agent for an exclusive execution and re-pin its scope.
13450
13480
  *
@@ -13460,14 +13490,11 @@ declare class AgentInstanceManager {
13460
13490
  /**
13461
13491
  * Get the managed Agent for a thread WITHOUT creating or registering one.
13462
13492
  *
13463
- * Read-only control-plane callers (state, memory, inbox) must not be the first
13464
- * to establish a thread's execution scope: since identity is
13465
- * `(tenant_id, assistant_id, thread_id)`, whichever caller reaches
13466
- * {@link getAgent} first fixes the instance's workspace/project for its whole
13467
- * lifetime, and a later trusted dispatch on that thread would then fail
13468
- * trusted-scope validation. This returns the existing managed instance when
13493
+ * Read-only control-plane callers (state, memory, inbox) must not mutate a
13494
+ * thread's execution scope. This returns the existing managed instance when
13469
13495
  * present, otherwise a transient unregistered Agent that is sufficient for
13470
- * state reads and disappears with the request.
13496
+ * state reads and disappears with the request. Dispatch callers use
13497
+ * {@link getAgentForDispatch}.
13471
13498
  *
13472
13499
  * @param params - Thread identity; scope is only used for the transient Agent.
13473
13500
  * @returns The managed instance if any, else an unregistered read-only Agent.