mirror of
https://github.com/paperclipai/paperclip.git
synced 2026-11-20 09:50:48 +01:00
139 lines
5.7 KiB
TypeScript
139 lines
5.7 KiB
TypeScript
import type { Db } from "@paperclipai/db";
|
|
import {
|
|
createAdmissionTransactionScope as buildAdmissionTransactionScope,
|
|
createFreshIssueRunWriter,
|
|
createPostgresWakeQueueAdapter,
|
|
createWakeAdmissionReader,
|
|
createWakeAdmissionWriter,
|
|
} from "./adapters/postgres.js";
|
|
import { createQueuedCommentIssueLockWriter } from "./adapters/queued-comment-postgres.js";
|
|
import type { QueuedCommentQueuePostgresAdapterDeps } from "./adapters/queued-comment-postgres.js";
|
|
import { createFreshIssueRunAdmission } from "./application/fresh-issue-run.js";
|
|
import { createAdmitWakeBehindIssueExecution, createReleaseIssueExecution } from "./application/use-cases.js";
|
|
import {
|
|
createDiscardQueuedComment,
|
|
createEditQueuedComment,
|
|
createReorderQueuedComments,
|
|
} from "./application/queued-comment-use-cases.js";
|
|
import type {
|
|
IssueSnapshot,
|
|
RecoveryEscalationPort,
|
|
RunSnapshot,
|
|
TransactionScope,
|
|
WakeAdmissionHeartbeatHelpers,
|
|
WakeQueueHost,
|
|
} from "./application/ports.js";
|
|
|
|
export type {
|
|
PostCommitEffect,
|
|
ReleaseOutcome,
|
|
RunSummary,
|
|
} from "./application/types.js";
|
|
export { WakeQueueApplicationError } from "./application/types.js";
|
|
export { hasRetainedExternalChatRetry } from "./domain/context.js";
|
|
export { QUEUED_MESSAGES_DELIVERED_REASON } from "./domain/policy.js";
|
|
export type {
|
|
IssueSnapshot,
|
|
RunSnapshot,
|
|
RecoveryEscalationPort,
|
|
ReleaseRecoveryBlockedNoticeKind,
|
|
TransactionScope,
|
|
} from "./application/ports.js";
|
|
export type { AdmitWakeBehindIssueExecutionInput, AdmitWakeBehindIssueExecutionResult, ReleaseIssueExecutionInput } from "./application/use-cases.js";
|
|
export {
|
|
QueuedCommentMutationError,
|
|
QueuedCommentMutationForbiddenError,
|
|
} from "./application/queued-comment-use-cases.js";
|
|
export type {
|
|
DiscardQueuedCommentInput,
|
|
DiscardQueuedCommentResult,
|
|
EditQueuedCommentInput,
|
|
EditQueuedCommentResult,
|
|
QueuedCommentMutationErrorCode,
|
|
ReorderQueuedCommentsInput,
|
|
ReorderQueuedCommentsResult,
|
|
} from "./application/queued-comment-use-cases.js";
|
|
export type {
|
|
QueuedCommentActivityPublication,
|
|
QueuedCommentActor,
|
|
QueuedCommentIssueContext,
|
|
QueuedCommentQueueSnapshot,
|
|
} from "./application/queued-comment-ports.js";
|
|
export type { QueuedCommentQueuePostgresAdapterDeps } from "./adapters/queued-comment-postgres.js";
|
|
|
|
export type WakeQueueDeps = {
|
|
/** Stays in `heartbeat.ts`; resolves the responsible user for a promoted or recovery run seed. */
|
|
resolveResponsibleUserId: WakeQueueHost["resolveResponsibleUserId"];
|
|
/** Stays in `heartbeat.ts`; reads the routine environment context for an execution issue. */
|
|
getRoutineEnv: WakeQueueHost["getRoutineEnv"];
|
|
/** Stays in `heartbeat.ts`; resolves the session-before display id for a wakeup. */
|
|
resolveSessionBeforeForWakeup: WakeQueueHost["resolveSessionBeforeForWakeup"];
|
|
/**
|
|
* The four wake-admission decision helpers stay in `heartbeat.ts` today;
|
|
* the module receives them here so it never imports the service it is
|
|
* extracted from.
|
|
*/
|
|
wakeAdmissionHelpers: WakeAdmissionHeartbeatHelpers;
|
|
/** `services/recovery`'s stranded-issue escalation, called only after the release transaction commits. */
|
|
recovery: RecoveryEscalationPort;
|
|
};
|
|
|
|
/**
|
|
* Composes the wake-queue module: the Postgres adapter (which owns the
|
|
* release transaction) and the release use case. `heartbeat.ts` holds the
|
|
* only caller: it builds one instance per process next to
|
|
* `createRunDispatch(db)` and delegates `releaseIssueExecutionAndPromote`'s
|
|
* body to `releaseIssueExecution`.
|
|
*
|
|
* The admission half is temporary: `heartbeat.ts` still opens and owns the
|
|
* transaction that admits a wake behind an active issue execution, so it
|
|
* builds a `TransactionScope` through `createAdmissionTransactionScope`
|
|
* before it calls `admitWakeBehindIssueExecution`.
|
|
*/
|
|
export function createWakeQueue(db: Db, deps: WakeQueueDeps) {
|
|
const issueLock = createPostgresWakeQueueAdapter(db, {
|
|
resolveResponsibleUserId: deps.resolveResponsibleUserId,
|
|
getRoutineEnv: deps.getRoutineEnv,
|
|
resolveSessionBeforeForWakeup: deps.resolveSessionBeforeForWakeup,
|
|
});
|
|
|
|
return {
|
|
releaseIssueExecution: createReleaseIssueExecution({ issueLock, recovery: deps.recovery }),
|
|
admitWakeBehindIssueExecution: createAdmitWakeBehindIssueExecution({
|
|
reader: createWakeAdmissionReader(),
|
|
writer: createWakeAdmissionWriter(),
|
|
helpers: deps.wakeAdmissionHelpers,
|
|
}),
|
|
createAdmissionTransactionScope(companyId: string, tx: Db): TransactionScope {
|
|
return buildAdmissionTransactionScope(companyId, tx);
|
|
},
|
|
};
|
|
}
|
|
|
|
export type WakeQueue = ReturnType<typeof createWakeQueue>;
|
|
|
|
/** Uses the transaction that already owns the issue's admission lock. */
|
|
export function bindFreshIssueRunAdmission(companyId: string, tx: Db) {
|
|
return createFreshIssueRunAdmission(createFreshIssueRunWriter(buildAdmissionTransactionScope(companyId, tx), companyId));
|
|
}
|
|
|
|
/**
|
|
* Composes the three queued-comment queue mutations (edit, reorder,
|
|
* discard): the Postgres adapter, which owns the one transaction each
|
|
* mutation runs in, and the three use cases. This is a separate factory
|
|
* from `createWakeQueue` because these mutations need none of the release
|
|
* or admission host callbacks -- only the small set of comment-reference
|
|
* and external-object sync callbacks in `deps`, which a caller outside
|
|
* `heartbeat.ts` (the queued-comment route) can supply directly.
|
|
*/
|
|
export function createQueuedCommentQueue(db: Db, deps: QueuedCommentQueuePostgresAdapterDeps) {
|
|
const issueLock = createQueuedCommentIssueLockWriter(db, deps);
|
|
return {
|
|
editQueuedComment: createEditQueuedComment({ issueLock }),
|
|
reorderQueuedComments: createReorderQueuedComments({ issueLock }),
|
|
discardQueuedComment: createDiscardQueuedComment({ issueLock }),
|
|
};
|
|
}
|
|
|
|
export type QueuedCommentQueue = ReturnType<typeof createQueuedCommentQueue>;
|