@desplega.ai/agent-swarm 1.158.0 → 1.160.0

package/src/tests/db-task-write-contract.test.ts

@@ -37,6 +37,28 @@ function manifest(source: string): string[] {
   return [...names].sort();
 }
 
+// Top-level declarations that carry code, exported or not. Re-exports, imports, types and
+// top-level statements (the configure*Dependencies wiring) are not bodies.
+function topLevelBodies(source: string): string[] {
+  const file = ts.createSourceFile("module.ts", source, ts.ScriptTarget.Latest, true);
+  const names = new Set<string>();
+  for (const node of file.statements) {
+    if (ts.isVariableStatement(node)) {
+      for (const declaration of node.declarationList.declarations)
+        names.add(declaration.name.getText(file));
+    } else if (
+      ((ts.isFunctionDeclaration(node) && node.body) ||
+        ts.isClassDeclaration(node) ||
+        ts.isEnumDeclaration(node) ||
+        ts.isModuleDeclaration(node)) &&
+      node.name
+    ) {
+      names.add(node.name.getText(file));
+    }
+  }
+  return [...names].sort();
+}
+
 // Complete public facade and selected range manifests captured from merged base 8ac7b4a7.
 const baseFacade = `type:AgentMailInboxMapping
 type:ApiKeyStatus
@@ -65,6 +87,7 @@ type:ExistingTrackerContextWorkReason
 type:InboxSummary
 type:InsertPricingRowInput
 type:InsertTaskAttachmentInput
+type:KeyAuthFailureResult
 type:KeyCostSummary
 type:KvJsonFieldEquals
 type:McpServerFilters
@@ -233,6 +256,7 @@ value:getAgentMailInboxMapping
 value:getAgentMailInboxMappingsByAgent
 value:getAgentMcpServers
 value:getAgentSkills
+value:getAgentStatusCounts
 value:getAgentWithTasks
 value:getAgentWorkingOnThread
 value:getAllAgentMailInboxMappings
@@ -387,6 +411,7 @@ value:getStepCountForNode
 value:getStuckApprovalRuns
 value:getStuckWaitRuns
 value:getStuckWorkflowRuns
+value:getSupersededTasksWithUnsettledDependents
 value:getSupersededTasksWithoutResume
 value:getSwarmConfigById
 value:getSwarmConfigLookupById
@@ -410,7 +435,6 @@ value:getUnassignedTaskIdsForAgent
 value:getUnassignedTasksCount
 value:getUnreadInboxMessages
 value:getUnreadMessages
-value:getUsageDataVersion
 value:getUserById
 value:getWaitStateById
 value:getWaitStateByStepId
@@ -443,6 +467,7 @@ value:isExtensionAgent
 value:isPendingSlackMessage
 value:isPoolAffinityEnforcementEnabled
 value:isSettledSlackMessage
+value:isSlackThreadAwaitingHuman
 value:isSqliteVecAvailable
 value:kvPrefixUpperBound
 value:listAgentsWithCredStatusByProvider
@@ -464,6 +489,7 @@ value:listScriptRunJournalSteps
 value:listScriptRuns
 value:listSkillFileManifest
 value:listSkills
+value:listSlackThreadsAwaitingHuman
 value:listTaskTemplates
 value:listUserFavorites
 value:listWorkflowRuns
@@ -497,7 +523,9 @@ value:promoteDraftTask
 value:reassociateSessionLogs
 value:recordBudgetRefusalNotification
 value:recordInlineScriptRun
+value:recordKeyAuthFailure
 value:recordKeyRateLimitWindows
+value:recordKeySeatMismatch
 value:recordKeyUsage
 value:recordSlackMessage
 value:recordTaskPullRequestAttachments
@@ -530,6 +558,7 @@ value:setBudgetRefusalFollowUpTaskId
 value:setFavorite
 value:setSlackMessageTracking
 value:setUserFavorite
+value:settleSupersededTaskDependents
 value:shouldBlockPolling
 value:startTask
 value:supersedeTask
@@ -597,6 +626,7 @@ value:overwriteTerminalTaskResultText
 value:pauseTask
 value:resetOrphanedInProgressTasksForAgent
 value:resumeTask
+value:settleSupersededTaskDependents
 value:startTask
 value:supersedeTask
 value:updateTaskClaudeSessionId
@@ -604,6 +634,498 @@ value:updateTaskProgress
 value:updateTaskTitle`.split("\n");
 const internal = ["value:configureTaskWriteDependencies"];
 
+// Top-level bodies in src/be/db.ts, frozen at main 7e6b97bf. The list may only shrink: delete an
+// entry when its code moves to src/be/db/<domain>/. Do not add to it; add a domain module instead.
+const frozenFacadeBodies = `BINARY_SKILL_FILE_PLACEHOLDER
+BUDGETED_IDENTITY_FIELDS
+ELIGIBILITY_SCAN_BATCH_SIZE
+ELIGIBILITY_SCAN_CAP
+GENERATED_PULL_REQUEST_DESCRIPTION
+GENERATED_PULL_REQUEST_INTENT
+GENERATED_PULL_REQUEST_PROVIDER_ID
+GENERATED_PULL_REQUEST_SOURCE
+HUMAN_FREE_SQL
+KvTypeCollisionError
+PENDING_SLACK_MESSAGE_TS_PREFIX
+RESERVED_CONFIG_PLACEHOLDER
+ROUTING_HOLDER_SQL
+SCHEDULE_TEMPLATE_PREVIEW_LENGTH
+SKILL_FILE_LIMITS
+SKILL_SLIM_COLUMNS
+STEERING_MESSAGE_SELECT
+UNATTRIBUTED_USER_ID
+VERSIONABLE_FIELDS
+WEEK_SECONDS
+WORKFLOW_RUN_SUMMARY_COLUMNS
+abandonSlackOutcomeDelivery
+acceptTask
+assertSkillFileLimits
+assetKeyPrefixPattern
+assetSummaryQueries
+autoEncryptLegacyPlaintextSecrets
+bindSlackMessageTimestamp
+bumpSkillVersion
+byteSize
+cancelApprovalRequestById
+cancelPendingApprovalRequestsForRun
+cancelPendingSteeringForTask
+captureRoutingDecisionSnapshot
+cascadeFailDependents
+checkDependencies
+checkoutPromptTemplate
+claimApprovalCancellationNotification
+claimInboxMessages
+claimKv
+claimMentions
+claimOfferedTask
+claimTask
+cleanupAgentSessions
+cleanupStaleSessions
+clearKeyRateLimit
+completeApprovalCancellationNotificationClaim
+countActiveScriptRuns
+countAllMetrics
+countAllPages
+countKv
+countMetricsByAgent
+countPagesByAgent
+countScriptRunJournalAgentTaskSteps
+countScriptRunJournalSteps
+countScriptRuns
+countSessions
+countWorkflowRuns
+createAgentMailInboxMapping
+createAppVersion
+createApprovalRequest
+createChannel
+createContextSnapshot
+createInboxMessage
+createLogEntry
+createMcpServer
+createMetric
+createMetricVersion
+createPage
+createPageVersion
+createScheduledTask
+createScriptRun
+createService
+createSessionCost
+createSessionLogs
+createSkill
+createSteeringMessage
+createSwarmRepo
+createTaskExtended
+createUser
+createWaitState
+createWorkflow
+createWorkflowRun
+createWorkflowRunStep
+createWorkflowVersion
+credentialKey
+currentAssetKey
+decodeKvRow
+defaultProviderId
+defaultProviderKey
+deleteActiveSession
+deleteActiveSessionById
+deleteAgentMailInboxMapping
+deleteBudget
+deleteChannel
+deleteKv
+deleteMcpServer
+deleteMetric
+deletePage
+deletePricingRow
+deletePromptTemplate
+deleteScheduledTask
+deleteService
+deleteServicesByAgentId
+deleteSkill
+deleteSkillFile
+deleteSlackMessageRecord
+deleteSwarmConfig
+deleteSwarmConfigByKey
+deleteSwarmRepo
+deleteTaskAttachment
+deleteUser
+deleteWorkflow
+deleteWorkflowRows
+detachTaskFromWorkflowRunStep
+emitBuiltInIntegrationConnectedOnce
+emitMcpServerConnectedTelemetry
+emitTaskLifecycleTelemetryAfterCommit
+emitWorkflowTerminalTelemetry
+encodeKvValue
+ensureSlackDelegationActivation
+ensureSlackRenderV2Activation
+failPendingResumeIfUnclaimed
+findLatestRoutingCandidate
+findRecentSimilarTasks
+findTaskByAgentMailThread
+getActivePricingRow
+getActiveSessionForTask
+getActiveSessions
+getAgentMailInboxMapping
+getAgentMailInboxMappingsByAgent
+getAgentMcpServers
+getAgentSkills
+getAgentWithTasks
+getAllAgentMailInboxMappings
+getAllAgentsWithTasks
+getAllChannelActivityCursors
+getAllChannels
+getAllLogs
+getAllPricingRows
+getAllServices
+getAllSessionCosts
+getAllUsers
+getAppVersion
+getAppVersions
+getApprovalRequestById
+getApprovalRequestByStepId
+getAssetKeyMapping
+getAssetKeyMappingByProvider
+getAttributionByPerson
+getAvailableKeyIndices
+getBudget
+getBudgetRefusalNotification
+getBudgets
+getChannelActivityCursor
+getChannelById
+getChannelByName
+getChannelMessages
+getCompletedStepNodeIds
+getConcurrentContext
+getContextSnapshotsBySessionId
+getContextSnapshotsByTaskId
+getContextSummaryByTaskId
+getCredentialLabels
+getCurrentStepForNode
+getDailySpendForAgent
+getDailySpendForUser
+getDailySpendGlobal
+getDashboardCostSummary
+getDependentTasks
+getDueScheduledTasks
+getDueWaitStates
+getExpiredPendingApprovals
+getFavoriteItemIdSet
+getIdleWorkersWithCapacity
+getInboxMessageById
+getInboxSummary
+getInjectableGlobalConfigs
+getInstanceActivity
+getKeyCostSummary
+getKeyStatuses
+getKv
+getLastReadAt
+getLastRunStart
+getLastSuccessfulRun
+getLatestPageBySlug
+getLatestStepForNode
+getLiveAgentCounts
+getLogsByAgentId
+getLogsByEventType
+getLogsByTaskId
+getLogsByTaskIdAndEventType
+getLogsByTaskIdChronological
+getMcpServerById
+getMcpServerByName
+getMentionsForAgent
+getMessageById
+getMetric
+getMetricBySlug
+getMetricVersion
+getMetricVersions
+getOfferedTasksForAgent
+getPage
+getPageBySlug
+getPageVersion
+getPageVersions
+getPendingEventWaitNames
+getPendingSteeringForAgent
+getPendingSteeringForTask
+getPendingWaitsByEvent
+getPricingRows
+getPromptTemplateById
+getPromptTemplateHistory
+getPromptTemplates
+getReadyAgentCounts
+getRecentBudgetRefusalNotifications
+getRecentCompletedCount
+getRecentFailedCount
+getRecentFailedTasks
+getResolvableDeferralOutcomes
+getResolvedConfig
+getRetryableSteps
+getRootTaskChain
+getRunningScriptRuns
+getScheduledTaskById
+getScheduledTaskByName
+getScheduledTasks
+getScriptRun
+getScriptRunByIdempotencyKey
+getScriptRunJournalStep
+getServiceByAgentAndName
+getServiceById
+getServicesByAgentId
+getSessionCostSummary
+getSessionCostsByAgentId
+getSessionCostsByTaskId
+getSessionCostsFiltered
+getSessionLogsBySession
+getSessionLogsByTaskId
+getSkillById
+getSkillByName
+getSkillFile
+getSkillFiles
+getSlackDelegationActivatedAt
+getSlackMessageByChannelTs
+getSlackOutcomeMessage
+getSlackRenderV2ActivatedAt
+getSlackTasksInThread
+getSlackTreeMessage
+getSlackTreeMessageByThread
+getSlackTreeMessages
+getStaleApprovalRequests
+getStalePinnedResumes
+getStaleUnassignedAffinityTasks
+getStalledInProgressTasks
+getSteeringMessageById
+getSteeringMessagesForTask
+getStepByIdempotencyKey
+getStepCountForNode
+getStuckApprovalRuns
+getStuckWaitRuns
+getStuckWorkflowRuns
+getSwarmConfigById
+getSwarmConfigLookupById
+getSwarmConfigs
+getSwarmMetrics
+getSwarmRepoById
+getSwarmRepoByName
+getSwarmRepoByUrl
+getSwarmRepos
+getSystemDefaultSkills
+getTaskAttachments
+getTaskByWorkflowRunStepId
+getUnassignedPoolTasks
+getUnassignedTaskIds
+getUnassignedTaskIdsForAgent
+getUnassignedTasksCount
+getUnreadInboxMessages
+getUnreadMessages
+getUserById
+getWaitStateById
+getWaitStateByStepId
+getWorkflow
+getWorkflowRun
+getWorkflowRunStep
+getWorkflowRunStepsByRunId
+getWorkflowVersion
+getWorkflowVersions
+getWorkflowsByScheduleId
+hasBudgetRefusalNotificationToday
+hasFirstCompletedTask
+hasPendingSteering
+heartbeatActiveSession
+incrKv
+incrementPageViewCount
+insertActiveSession
+insertAssetKeyHistory
+insertPricingRow
+insertTaskAttachment
+insertTaskAttachmentRow
+installMcpServer
+installSkill
+installSystemDefaultSkillsForAgent
+isPendingSlackMessage
+isSettledSlackMessage
+isSlackThreadAwaitingHuman
+kvJsonFieldConditions
+kvPrefixCondition
+kvPrefixUpperBound
+listAllMetrics
+listAllPages
+listApprovalRequests
+listAssetSummaries
+listCancelledApprovalRequestsForRun
+listCancelledApprovalRequestsForStep
+listFavorites
+listInboxState
+listKv
+listMcpServers
+listMetricsByAgent
+listPagesByAgent
+listRecentSessions
+listScriptRunJournalSteps
+listScriptRuns
+listSkillFileManifest
+listSkills
+listSlackThreadsAwaitingHuman
+listTaskTemplates
+listUserFavorites
+listWorkflowRuns
+listWorkflowRunsPage
+listWorkflows
+literalPrefixPattern
+logRoutingDecisionFailure
+markInboxMessageDelegated
+markInboxMessageRead
+markInboxMessageResponded
+markKeyRateLimited
+markSlackDeferralResolved
+markSlackTreeRendered
+markSteeringDelivered
+markSteeringHandled
+markSteeringPromoted
+markTaskSlackReplySent
+maskSecrets
+mergeRateLimitWindowTelemetry
+moveAssetKey
+moveTaskFromBacklog
+moveTaskToBacklog
+normalizeSkillFileInput
+normalizeSkillFilePath
+noteSlackOutcomeDeliveryFailure
+parseAttachmentCapabilities
+parseJsonColumn
+parseRateLimitWindowsJson
+postMessage
+previewText
+promoteAbandonedDraftTasks
+promoteDraftTask
+pullRequestKey
+quoteSqlIdentifier
+reassociateSessionLogs
+reconcileTaskPullRequestAttachments
+recordBudgetRefusalNotification
+recordInlineScriptRun
+recordKeyAuthFailure
+recordKeyRateLimitWindows
+recordKeyUsage
+recordSlackMessage
+recordTaskPullRequestAttachments
+refreshDraftTaskLease
+refreshEstimatedClaudePlan
+rejectTask
+releaseApprovalCancellationNotificationClaim
+releaseMentionProcessing
+releaseStaleMentionProcessing
+releaseStaleOfferedTasksForOfflineAgents
+releaseStaleProcessingInbox
+releaseStaleReviewingTasks
+releaseTask
+replaceTaskAttachment
+reserveSlackMessage
+resetPromptTemplateToDefault
+resolveApprovalRequest
+resolvePromptTemplate
+resolveWaitState
+rowToAgentLog
+rowToAgentMcpServer
+rowToAgentSkill
+rowToApiKeyStatus
+rowToAppVersion
+rowToApprovalRequest
+rowToAssetKeyMapping
+rowToBudget
+rowToBudgetRefusalNotification
+rowToChannel
+rowToChannelActivityCursor
+rowToChannelMessage
+rowToContextSnapshot
+rowToInboxItemState
+rowToInboxMessage
+rowToMcpServer
+rowToMcpServerWithInstall
+rowToMetric
+rowToMetricSummary
+rowToMetricVersion
+rowToPage
+rowToPageSummary
+rowToPageVersion
+rowToPricingRow
+rowToPromptTemplate
+rowToPromptTemplateHistory
+rowToScheduledTask
+rowToScheduledTaskSummary
+rowToScriptRun
+rowToScriptRunJournalEntry
+rowToScriptRunListItem
+rowToService
+rowToSessionCost
+rowToSessionLog
+rowToSkill
+rowToSkillFile
+rowToSkillWithInstall
+rowToSlackMessage
+rowToSteeringMessage
+rowToSwarmConfig
+rowToSwarmRepo
+rowToTaskAttachment
+rowToTaskTemplate
+rowToUser
+rowToUserFavorite
+rowToWaitState
+rowToWorkflow
+rowToWorkflowRun
+rowToWorkflowRunStep
+rowToWorkflowSummary
+rowToWorkflowVersion
+scriptRunUpdateSets
+searchSkills
+setApiKeyName
+setApiKeyPlan
+setBudgetRefusalFollowUpTaskId
+setFavorite
+setSlackMessageTracking
+setUserFavorite
+stringifyAttachmentCapabilities
+sweepExpiredKv
+sweepExpiredKvPrefix
+taskContextForTelemetry
+toggleAgentSkill
+uninstallMcpServer
+uninstallSkill
+updateActiveSessionProviderSessionId
+updateAgentName
+updateAgentProfile
+updateApprovalCancellationNotificationClaim
+updateApprovalRequestNotifications
+updateMcpServer
+updateMetric
+updatePage
+updateReadState
+updateScheduledTask
+updateScriptRun
+updateScriptRunGuarded
+updateScriptRunIfNotTerminal
+updateScriptRunIfRunning
+updateServiceStatus
+updateSkill
+updateSlackMessageRecord
+updateSwarmRepo
+updateTaskVcs
+updateUser
+updateWorkflow
+updateWorkflowRun
+updateWorkflowRunStep
+upsertAssetKeyMapping
+upsertBudget
+upsertChannelActivityCursor
+upsertInboxState
+upsertKv
+upsertPromptTemplate
+upsertScriptRunJournalStep
+upsertService
+upsertSkillFile
+upsertSkillFileUnchecked
+upsertSkillFiles
+upsertSwarmConfig
+withFavoriteFlags
+writeEnvFile`.split("\n");
+
 test("complete facade, selected public bindings and internal-only manifest remain exact", async () => {
   const facade = await Bun.file(new URL("../be/db.ts", import.meta.url)).text();
   const target = await Bun.file(new URL("../be/db/tasks/write.ts", import.meta.url)).text();
@@ -629,7 +1151,18 @@ test("complete facade, selected public bindings and internal-only manifest remai
   }
   expect(target).not.toMatch(/from ["'][^"']*(?:be\/db|\.\.\/\.\.\/db)["']/);
   expect(target).not.toContain("bun:sqlite");
-  expect(facade.split("\n").length).toBeLessThanOrEqual(14133);
+});
+
+test("db.ts gains no new top-level bodies; new db code lives in src/be/db/<domain>/", async () => {
+  const facade = await Bun.file(new URL("../be/db.ts", import.meta.url)).text();
+  const frozen = new Set(frozenFacadeBodies);
+  const added = topLevelBodies(facade)
+    .filter((name) => !frozen.has(name))
+    .map(
+      (name) =>
+        `${name}: new top-level body in src/be/db.ts. Move it to src/be/db/<domain>/ and re-export it from db.ts.`,
+    );
+  expect(added).toEqual([]);
 });
 
 test(

package/src/tests/docs-index-footprint.test.js

@@ -78,7 +78,7 @@ describe("docs API index footprint", () => {
     expect(tasks).toContain('"path":"/api/task-templates","method":"get"');
   });
 
-  test("OpenAPI and generated pages keep all 383 operations", async () => {
+  test("OpenAPI and generated pages keep all 391 operations", async () => {
     const spec = await Bun.file(resolve(repoRoot, "openapi.json")).json();
     const operationKeys = [];
     const tags = new Set();
@@ -103,8 +103,8 @@ describe("docs API index footprint", () => {
     expect(spec.paths["/api/agents/{id}/runtime"]?.get).toBeDefined();
 
     const generatedKeys = await generatedOperationKeys();
-    expect(operationKeys).toHaveLength(383);
-    expect(generatedKeys).toHaveLength(383);
+    expect(operationKeys).toHaveLength(391);
+    expect(generatedKeys).toHaveLength(391);
     expect(new Set(generatedKeys)).toEqual(new Set(operationKeys));
   });