@opengeni/core 0.4.7 → 0.4.9

package/dist/index.d.ts

@@ -1,5 +1,5 @@
 import { Settings } from '@opengeni/config';
-import { ScheduledTask, Document, Permission, AccessContext, AccessGrant, LimitAction, LimitDecision, CapabilityCatalogItem, CapabilityInstallation, CapabilityCatalogResponse, CreateCapabilityCatalogItemRequest, EnableCapabilityRequest, VariableSet, Rig, RigVersion, CreateRigRequest, RigDefinitionEditPayload, RigChange, ProposeRigChangeRequest, UpdateRigRequest, CapabilityPack, SocialConnection, ScheduledTaskAgentConfig, ToolRef, ResourceRef, CreateScheduledTaskRequest, UpdateScheduledTaskRequest, ReasoningEffort, SessionMcpCredentialUpdateInput, SessionEvent, SessionTurn, GoalSpec, SessionMcpServerMetadata, Session, WorkspaceMember } from '@opengeni/contracts';
+import { ScheduledTask, Document, Permission, AccessContext, AccessGrant, LimitAction, LimitDecision, CapabilityCatalogItem, CapabilityInstallation, CapabilityCatalogResponse, CreateCapabilityCatalogItemRequest, EnableCapabilityRequest, VariableSet, Rig, RigVersion, CreateRigRequest, RigDefinitionEditPayload, RigChange, ProposeRigChangeRequest, UpdateRigRequest, CapabilityPack, SocialConnection, ScheduledTaskAgentConfig, ToolRef, ResourceRef, CreateScheduledTaskRequest, UpdateScheduledTaskRequest, ReasoningEffort, SessionMcpCredentialUpdateInput, SessionEvent, SessionTurn, GoalSpec, SessionMcpServerMetadata, Session, WorkspaceMember, SessionControlRequest, SessionControlResponse, WorkspaceInferenceControlRequest, WorkspaceInferenceControlResponse, DeleteSessionQueueItemRequest, SessionQueueMutationResponse, EditSessionQueueItemRequest, ComposerDraft, MoveSessionQueueItemRequest, SaveComposerDraftRequest, SteerSessionQueueItemRequest } from '@opengeni/contracts';
 export { mergeToolRefs, stableJson } from '@opengeni/contracts';
 import * as _opengeni_db from '@opengeni/db';
 import { Database, SandboxRecord, EnabledMcpCapabilityServer, UpdateScheduledTaskInput, CreateSessionMcpServerInput, UpdateSessionMcpServerCredentialsInput } from '@opengeni/db';
@@ -78,8 +78,10 @@ type SessionWorkflowClient = {
         sessionId: string;
         workflowId: string;
         wakeRevision: number;
-        controlEventId?: string;
+        interruptionRequested?: boolean;
     }) => Promise<void>;
+    /** Trigger one bounded drain of already-committed workflow-wake revisions. */
+    requestSessionWorkflowWakeDispatch: () => Promise<void>;
     signalCodexCapacity?: (input: {
         accountId: string;
         workspaceId: string;
@@ -96,14 +98,6 @@ type SessionWorkflowClient = {
         workflowId: string;
         workflowWakeRevision: number;
     }) => Promise<void>;
-    signalSessionControl: (input: {
-        accountId: string;
-        workspaceId: string;
-        sessionId: string;
-        eventId: string;
-        workflowId: string;
-        workflowWakeRevision: number;
-    }) => Promise<void>;
     syncScheduledTask: (input: {
         task: ScheduledTask;
     }) => Promise<void>;
@@ -169,10 +163,15 @@ type ApiRouteDeps = AppDependencies & {
  * or sandbox services. The public API still passes its `ApiRouteDeps` superset.
  */
 type AcceptSessionUserMessageDependencies = Pick<AppDependencies, "settings" | "db" | "bus"> & {
-    workflowClient: Pick<SessionWorkflowClient, "wakeSessionWorkflow" | "signalSessionControl">;
+    workflowClient: Pick<SessionWorkflowClient, "wakeSessionWorkflow">;
     objectStorage: ObjectStorageDependency;
 };
 
+/** One global Temporal Schedule owns bounded delivery of committed session wakes. */
+declare const SESSION_WORKFLOW_WAKE_DISPATCHER_SCHEDULE_ID = "opengeni-session-workflow-wake-dispatcher";
+declare const SESSION_WORKFLOW_WAKE_DISPATCHER_WORKFLOW_TYPE = "sessionWorkflowWakeDispatcherWorkflow";
+declare const SESSION_WORKFLOW_WAKE_DISPATCHER_PERIOD_MS = 10000;
+
 type FleetServices = {
     db: Database;
     settings: Settings;
@@ -672,7 +671,7 @@ declare function createAndStartSession(input: {
     id: string;
     workspaceId: string;
     accountId: string;
-    status: "queued" | "running" | "idle" | "requires_action" | "recovering" | "waiting_capacity" | "paused" | "failed" | "cancelled";
+    status: "queued" | "running" | "idle" | "requires_action" | "recovering" | "waiting_capacity" | "failed" | "cancelled";
     initialMessage: string;
     title: string | null;
     titleSource: "user" | "agent" | null;
@@ -727,12 +726,54 @@ declare function createAndStartSession(input: {
     queueVersion: number;
     queueHeadPosition: number;
     queueTailPosition: number;
-    controlState: "paused" | "active";
-    controlGeneration: number;
-    controlReason: string | null;
-    controlChangedBy: string | null;
-    controlChangedAt: string | null;
-    workspaceRunExceptionGeneration: number | null;
+    effectiveControl: {
+        state: "active" | "paused";
+        controlVersion: number;
+        controlEtag: string;
+        directState: "active" | "paused";
+        primaryBlocker: {
+            kind: "workspace" | "session";
+            displayName: string;
+            actor: string | null;
+            reason: string | null;
+            changedAt: string | null;
+            revision: number;
+            sessionId?: string | undefined;
+        } | null;
+        additionalBlockerCount: number;
+        blockers: {
+            kind: "workspace" | "session";
+            displayName: string;
+            actor: string | null;
+            reason: string | null;
+            changedAt: string | null;
+            revision: number;
+            sessionId?: string | undefined;
+        }[];
+        resumeOptions: {
+            scope: "workspace" | "session" | "selected";
+            selectedStateAfter: "active" | "paused";
+            impactCopy: string;
+            targetId?: string | undefined;
+            remainingPrimaryBlocker?: {
+                kind: "workspace" | "session";
+                displayName: string;
+                actor: string | null;
+                reason: string | null;
+                changedAt: string | null;
+                revision: number;
+                sessionId?: string | undefined;
+            } | undefined;
+        }[];
+        override: {
+            rootSessionId: string;
+            revision: number;
+        } | null;
+        settlement: {
+            state: "stopping";
+            attemptCount: number;
+        } | null;
+    };
     lastSequence: number;
     codexPinnedCredentialId: string | null;
     codexLastCredentialId: string | null;
@@ -793,7 +834,7 @@ declare function reasoningEffortForSession(metadata: Record<string, unknown>, fa
 declare function postUserMessageTurn(input: {
     db: Database;
     bus: EventBus;
-    workflowClient: Pick<SessionWorkflowClient, "wakeSessionWorkflow" | "signalSessionControl">;
+    workflowClient: Pick<SessionWorkflowClient, "wakeSessionWorkflow">;
     settings: Settings;
     accountId: string;
     workspaceId: string;
@@ -805,11 +846,11 @@ declare function postUserMessageTurn(input: {
     reasoningEffort?: Settings["openaiReasoningEffort"] | null;
     clientEventId?: string;
     mcpCredentialUpdates?: UpdateSessionMcpServerCredentialsInput[];
-    delivery?: "queue" | "steer";
+    delivery?: "send" | "steer";
     origin?: "human" | "operator";
     actor?: string;
-    expectedControlGeneration?: number;
-    expectedWorkspaceInferenceGeneration?: number;
+    controlEtag?: string | null;
+    expectedDraftRevision?: number | null;
 }): Promise<{
     accepted: SessionEvent;
     turn: SessionTurn;
@@ -838,10 +879,10 @@ declare function acceptSessionUserMessage(deps: AcceptSessionUserMessageDependen
     reasoningEffort?: ReasoningEffort | null;
     clientEventId?: string;
     mcpCredentialUpdates?: SessionMcpCredentialUpdateInput[];
-    delivery?: "queue" | "steer";
+    delivery?: "send" | "steer";
     origin?: "human" | "operator";
-    expectedControlGeneration?: number;
-    expectedWorkspaceInferenceGeneration?: number;
+    controlEtag?: string | null;
+    expectedDraftRevision?: number | null;
 }): Promise<{
     accepted: SessionEvent;
     turn: SessionTurn;
@@ -898,4 +939,75 @@ declare function assertWorkspaceDeletable(input: {
     activeSessionCount: number;
 }): void;
 
-export { type AcceptSessionUserMessageDependencies, type AccessDeps, type ApiRouteDeps, type ApiSandboxClient, type ApiSandboxSession, type AppDependencies, type ChannelARoutingServices, type DocumentIndexClient, type FleetContext, type FleetListResult, type FleetLiveness, type FleetSandboxEntry, type FleetServices, type FleetSwapResult, type LimitCheckInput, type LimitDependencies, MARKETING_SOCIAL_PACK_ID, MAX_CHECKS_PER_RIG, MAX_CREDENTIAL_HOOKS_PER_RIG, MAX_DEFAULT_VARIABLE_SETS_PER_RIG, MAX_ENVIRONMENTS_PER_WORKSPACE, MAX_RIGS_PER_WORKSPACE, MAX_VARIABLES_PER_ENVIRONMENT, type ManagedAuth, type McpCapabilityProbe, type McpCapabilityProbeInput, type McpCapabilityProbeResult, type ObjectStorageDependency, type ProvisionResult, type ResumeBoxByIdInput, type ResumedSandboxSession, type RigServices, type RigVerificationClassification, type RunOnOp, type RunOnResult, type SessionWorkflowClient, acceptSessionUserMessage, activateRigVersionForApi, appendRigSetupCommand, applyCapabilityEnablement, assertAllowedEnvironmentVariableName, assertAllowedVariableSetVariableName, assertConfiguredModel, assertPackSandboxImageCompatible, assertWorkspaceDeletable, assertWorkspaceMemberRemovable, assertWorkspaceModelPolicyAllows, buildCapabilityCatalog, buildFleetContextForSession, buildMarketingDailyAnalysisAgentConfig, checkLimit, classifyRigVerificationOutcome, createAndStartSession, createCatalogItem, createRigForApi, createRigVersionForApi, createSessionForRequest, createValidatedScheduledTask, deleteRigForApi, disableCapability, discoverMcpRegistryCapabilities, enableCapability, enabledCapabilityMcpToolRefs, getCapabilityPack, hasPermission, isBuiltInCapabilityPack, isUserMember, listCapabilityPacks, listFleet, listRigChangesForApi, listRigVersionsForApi, listWorkspaceCapabilityPacks, manualScheduledTaskTriggerUsageKey, manualScheduledTaskTriggerWorkflowId, memberCanAdminister, mergeResourceRefs, normalizeResources, officialMcpRegistryUrl, postUserMessageTurn, promoteSetupAppendChange, promoteVerifiedDefinitionEditChangeForApi, proposeRigChangeForApi, provisionSandbox, readSessionLineage, reasoningEffortForSession, recordRigAuditEvent, recordVariableSetAuditEvent, recordWorkspaceUsage, relayConfigFromSettings, relayDialBaseFromSettings, requireAccessContext, requireAccessGrant, requireEnvironmentEncryption, requireLimit, requirePermission, requireQueuedTurnForApi, requireRigChangeForApi, requireRigForApi, requireScheduledTaskForApi, requireVariableSetEncryption, requireVariableSetForApi, resolveCapabilityPack, resolveMemberSubjectId, restoreScheduledTask, rigActorForGrant, routingEnabled, runOnSandbox, scheduledTaskTemporalScheduleId, scheduledTaskToolsProvided, scheduledTaskTriggerToken, settingsWithEnabledCapabilityMcpServers, settingsWithMcpCapabilityServers, settingsWithSessionMcpServerMetadata, swapActiveSandbox, syncCreatedScheduledTask, syncUpdatedScheduledTask, updateRigForApi, updateSessionTitle, validateFileResources, validateGitHubRepositorySelection, validateGitHubRepositorySelectionShape, validateMcpCapabilityConnection, validateToolRefs, validateVariableSetAttachment, validatedScheduledTaskUpdate, withDefaultEnabledCapabilityMcpTools, workflowIdForSession, wrapChannelABoxWithRouting };
+type HumanSessionCommandContext = {
+    accountId: string;
+    workspaceId: string;
+    sessionId: string;
+    subjectId: string;
+};
+type AgentSessionCommandContext = {
+    accountId: string;
+    workspaceId: string;
+    callerSessionId: string;
+    callerTurnId: string;
+    callerAttemptId: string;
+    callerExecutionGeneration: number;
+};
+declare function sendAgentSessionMessage(deps: {
+    db: Database;
+    bus: EventBus;
+    workflowClient: Pick<SessionWorkflowClient, "wakeSessionWorkflow">;
+}, context: AgentSessionCommandContext, input: {
+    targetSessionId: string;
+    text: string;
+    idempotencyKey: string;
+}): Promise<_opengeni_db.AgentInternalUpdateCommandResult>;
+declare function steerAgentSession(deps: {
+    db: Database;
+    bus: EventBus;
+    workflowClient: Pick<SessionWorkflowClient, "wakeSessionWorkflow">;
+}, context: AgentSessionCommandContext, input: {
+    targetSessionId: string;
+    instruction: string;
+    idempotencyKey: string;
+}): Promise<_opengeni_db.AgentInternalUpdateCommandResult>;
+declare function controlAgentSessionWorkstream(deps: {
+    db: Database;
+    bus: EventBus;
+    workflowClient: Pick<SessionWorkflowClient, "requestSessionWorkflowWakeDispatch">;
+}, context: AgentSessionCommandContext, input: {
+    targetSessionId: string;
+    action: "pause" | "resume";
+    idempotencyKey: string;
+    reason?: string | null;
+}): Promise<_opengeni_db.SessionControlMutationResult>;
+declare function moveHumanQueuePrompt(deps: {
+    db: Database;
+    bus: EventBus;
+}, context: HumanSessionCommandContext, turnId: string, input: MoveSessionQueueItemRequest): Promise<SessionQueueMutationResponse>;
+declare function deleteHumanQueuePrompt(deps: {
+    db: Database;
+    bus: EventBus;
+}, context: HumanSessionCommandContext, turnId: string, input: DeleteSessionQueueItemRequest): Promise<SessionQueueMutationResponse>;
+declare function editHumanQueuePrompt(deps: {
+    db: Database;
+    bus: EventBus;
+}, context: HumanSessionCommandContext, turnId: string, input: EditSessionQueueItemRequest): Promise<SessionQueueMutationResponse>;
+declare function steerHumanQueuePrompt(deps: {
+    db: Database;
+    bus: EventBus;
+}, context: HumanSessionCommandContext, turnId: string, input: SteerSessionQueueItemRequest): Promise<SessionQueueMutationResponse>;
+declare function controlHumanSessionWorkstream(deps: {
+    db: Database;
+    bus: EventBus;
+    workflowClient: Pick<SessionWorkflowClient, "requestSessionWorkflowWakeDispatch">;
+}, context: HumanSessionCommandContext, input: SessionControlRequest): Promise<SessionControlResponse>;
+declare function controlHumanWorkspace(deps: {
+    db: Database;
+    bus: EventBus;
+    workflowClient: Pick<SessionWorkflowClient, "requestSessionWorkflowWakeDispatch">;
+}, context: Omit<HumanSessionCommandContext, "sessionId">, input: WorkspaceInferenceControlRequest): Promise<WorkspaceInferenceControlResponse>;
+declare function getHumanComposerDraft(db: Database, context: HumanSessionCommandContext): Promise<ComposerDraft>;
+declare function saveHumanComposerDraft(db: Database, context: HumanSessionCommandContext, input: SaveComposerDraftRequest): Promise<ComposerDraft>;
+
+export { type AcceptSessionUserMessageDependencies, type AccessDeps, type AgentSessionCommandContext, type ApiRouteDeps, type ApiSandboxClient, type ApiSandboxSession, type AppDependencies, type ChannelARoutingServices, type DocumentIndexClient, type FleetContext, type FleetListResult, type FleetLiveness, type FleetSandboxEntry, type FleetServices, type FleetSwapResult, type HumanSessionCommandContext, type LimitCheckInput, type LimitDependencies, MARKETING_SOCIAL_PACK_ID, MAX_CHECKS_PER_RIG, MAX_CREDENTIAL_HOOKS_PER_RIG, MAX_DEFAULT_VARIABLE_SETS_PER_RIG, MAX_ENVIRONMENTS_PER_WORKSPACE, MAX_RIGS_PER_WORKSPACE, MAX_VARIABLES_PER_ENVIRONMENT, type ManagedAuth, type McpCapabilityProbe, type McpCapabilityProbeInput, type McpCapabilityProbeResult, type ObjectStorageDependency, type ProvisionResult, type ResumeBoxByIdInput, type ResumedSandboxSession, type RigServices, type RigVerificationClassification, type RunOnOp, type RunOnResult, SESSION_WORKFLOW_WAKE_DISPATCHER_PERIOD_MS, SESSION_WORKFLOW_WAKE_DISPATCHER_SCHEDULE_ID, SESSION_WORKFLOW_WAKE_DISPATCHER_WORKFLOW_TYPE, type SessionWorkflowClient, acceptSessionUserMessage, activateRigVersionForApi, appendRigSetupCommand, applyCapabilityEnablement, assertAllowedEnvironmentVariableName, assertAllowedVariableSetVariableName, assertConfiguredModel, assertPackSandboxImageCompatible, assertWorkspaceDeletable, assertWorkspaceMemberRemovable, assertWorkspaceModelPolicyAllows, buildCapabilityCatalog, buildFleetContextForSession, buildMarketingDailyAnalysisAgentConfig, checkLimit, classifyRigVerificationOutcome, controlAgentSessionWorkstream, controlHumanSessionWorkstream, controlHumanWorkspace, createAndStartSession, createCatalogItem, createRigForApi, createRigVersionForApi, createSessionForRequest, createValidatedScheduledTask, deleteHumanQueuePrompt, deleteRigForApi, disableCapability, discoverMcpRegistryCapabilities, editHumanQueuePrompt, enableCapability, enabledCapabilityMcpToolRefs, getCapabilityPack, getHumanComposerDraft, hasPermission, isBuiltInCapabilityPack, isUserMember, listCapabilityPacks, listFleet, listRigChangesForApi, listRigVersionsForApi, listWorkspaceCapabilityPacks, manualScheduledTaskTriggerUsageKey, manualScheduledTaskTriggerWorkflowId, memberCanAdminister, mergeResourceRefs, moveHumanQueuePrompt, normalizeResources, officialMcpRegistryUrl, postUserMessageTurn, promoteSetupAppendChange, promoteVerifiedDefinitionEditChangeForApi, proposeRigChangeForApi, provisionSandbox, readSessionLineage, reasoningEffortForSession, recordRigAuditEvent, recordVariableSetAuditEvent, recordWorkspaceUsage, relayConfigFromSettings, relayDialBaseFromSettings, requireAccessContext, requireAccessGrant, requireEnvironmentEncryption, requireLimit, requirePermission, requireQueuedTurnForApi, requireRigChangeForApi, requireRigForApi, requireScheduledTaskForApi, requireVariableSetEncryption, requireVariableSetForApi, resolveCapabilityPack, resolveMemberSubjectId, restoreScheduledTask, rigActorForGrant, routingEnabled, runOnSandbox, saveHumanComposerDraft, scheduledTaskTemporalScheduleId, scheduledTaskToolsProvided, scheduledTaskTriggerToken, sendAgentSessionMessage, settingsWithEnabledCapabilityMcpServers, settingsWithMcpCapabilityServers, settingsWithSessionMcpServerMetadata, steerAgentSession, steerHumanQueuePrompt, swapActiveSandbox, syncCreatedScheduledTask, syncUpdatedScheduledTask, updateRigForApi, updateSessionTitle, validateFileResources, validateGitHubRepositorySelection, validateGitHubRepositorySelectionShape, validateMcpCapabilityConnection, validateToolRefs, validateVariableSetAttachment, validatedScheduledTaskUpdate, withDefaultEnabledCapabilityMcpTools, workflowIdForSession, wrapChannelABoxWithRouting };