Files
PaperClipAI/server/src/__tests__/chat-interaction-publications.test.ts
T
DottaandPaperclip 7ae81c9fa7 fix(slack): support rich questions and complete review delivery (#17255)
## Thinking Path

> - Paperclip is the open source app people use to manage AI agents for
work.
> - Questions and review decisions must work in the conversation where a
task started.
> - Slack omitted question context and did not publish several review
kinds.
> - Some answers saved in Paperclip also lost their authorized
continuation or their final Slack reply.
> - A settled card and a successful run did not prove that the user
received the result.
> - This pull request preserves complete questions and follows the
existing answer and delivery receipts through continuation.
> - Users can read the request, submit an authorized decision, and
receive the resumed task's result in the same conversation.

## Linked Issues or Issue Description

Refs #17045 and #17218.

**What happened?**

Slack question cards could omit instructions and editable starting text.
Checkbox reviews, item verdicts, task suggestions, and connection
requests had no publication path. Complex question answers submitted in
Paperclip could fail continuation authorization. Several review
continuations completed without delivering their result to Slack.

**Expected behavior**

Show the actual question and context. Use native Slack controls when
they preserve the form contract. Otherwise provide an explicit Paperclip
review link. Persist one authorized response, resume through the
existing delivery path, settle the card, and deliver the useful result
to its originating conversation.

**Steps to reproduce**

1. Start a task in Slack and ask a text or choice question with
instructions and help text.
2. Submit native text and choice responses, then submit a complex form
through Paperclip.
3. Accept a checklist, submit item decisions, select suggested tasks, or
decline a connection request.
4. Inspect the saved answer, continuation run, original Slack card, and
final Slack reply independently.

## What Changed

- Preserve full prompts, context, descriptions, recommendations, help,
and editable starting text. Use direct buttons for short choices, inline
searchable selects for longer lists, and native checkboxes with explicit
submission for multiple choices.
- Add native custom-answer and validated-text modals, ordinary
confirmation buttons, checklist decisions, per-item verdicts with
reasons, suggested-task creation/dismissal, and connection decline. Keep
governed approvals, permission grants, and forms that cannot be
represented faithfully in the full Paperclip review surface.
- Keep Slack-specific canonical-validation feedback in its owning
platform module. Shared callbacks delegate without interpreting provider
presentation.
- Reuse the existing canonical interaction transactions, callback
receipts, publication queue, and continuation delivery. Share ordinary
confirmation handling across Telegram and Slack. Recheck current
authorization and commit response receipts atomically.
- Settle cards with the saved answer and remove stale controls. Ignore
passive Slack link callbacks so opening a task does not display a false
answer error.
- Validate exact multi-select receipt mappings during native
continuation. Recover automation-origin connection replies from their
published prompt after validating the durable connection receipt.
- Keep oversized multi-select handoffs free of unused native tokens, and
retain the complete Paperclip form for 101–128 choices plus Other. Make
the original-conversation audience explicit before submitting a Slack
modal.
- Add rollback, provider serialization, callback, continuation, and
negative authorization regressions. Update the connector playbook and
feature/access maps. No React or application UI changes are included.
- Add a durable Q01–Q11 qualification index and provider coverage
matrix. Require distinct functional, good-experience, and
best-available-control assessments; real unanswered/answering/settled
evidence; saved results, continuation and navigation proof; and retained
failures. Mark other providers unaudited rather than assuming Slack
parity.

## Verification

Candidate: `e0017d446b1016a38d65382366cd1408cce33039`. The
eleven-core-format live Slack gallery is pinned to
`c3d458b2a06b660448940fd8cf33c5906f0058d5`; subsequent boundary fixes
and the sharing notice have automated verification, not new live
screenshots.

- Real Slack UI testing covered all 11 formats: text, closed choice,
long single select, multiple choices, choices with a custom answer,
pattern-validated text, confirmation, checklist, item verdicts,
suggested tasks, and connection requests. Each has
unanswered/answering/answered screenshots as applicable, an inspected
saved result, one continuation, and an individual experience review in
the local HTML gallery.
- The dedicated private QA app/channel used signed callbacks to the
local candidate. A separately approved password-protected, read-only
preview proved connection-review, suggested-task review, and
created-task navigation. Anonymous access, writes, and credential routes
were denied. No OAuth grant was attempted.
- Real testing exposed and repaired a multi-select continuation failure
and a misleading error on link-button clicks. Failed attempts remain in
the evidence. The final navigation replay opened the exact pending
connection request and declined it in Slack without granting access.
Suggested-task creation produced the selected child with the correct
parent and description.
- Final review-fix verification: **32 form tests**, **28
provider/form-rendering tests**, **30 publication tests**, and **171
native continuation/authorization tests** passed. Earlier **3
atomic-resolution rollback**, **9 targeted
callback/publication/Telegram**, and **28 review-continuation** cases
passed. The final Slack/Teams modal subset also passed. The
automation-origin connection cases, 101/128 custom-choice cases, and
oversized multi-select continuation reproduced before their fixes and
passed afterward; failing logs remain retained. These counts describe
relevant runs, not a reliability percentage.
- CI on `b5885b85fd` exposed a test fixture that assumed every Slack
modal block was an input; the new sharing notice correctly renders a
non-input block. The fixture now selects input blocks safely. The exact
signed-modal correction/one-continuation test passed locally, together
with 14 Slack form/modal tests. The failing CI log and its specific
cause remain recorded.
- `pnpm -r typecheck` and `pnpm build` passed. Server typechecking was
repeated after the final source changes. Map and module-boundary checks
and `git diff --check` passed.
- The full `pnpm test:run` was attempted and stopped after repeated
embedded PostgreSQL semaphore exhaustion on this host. Its 1,395-test
chat suite found two stale native-control assertions; both were
corrected and re-tested in a focused run. Focused database suites used
separate disposable databases on existing local PostgreSQL. The full
suite is not claimed green; new-head CI must complete before merge.
- Final-head CI passed on `e0017d446b1016a38d65382366cd1408cce33039`:
all test/build jobs and required `ci / verify` and `ci / e2e` gates are
green
([run](https://github.com/paperclipai/paperclip/actions/runs/40115430194)).
Greptile and Ponytail both reviewed this exact head at 5/5, the security
scan passed, and all review threads are resolved.
- All three QA app callbacks were restored to staging. Both temporary
tunnels and local proxies were closed. The local endpoint was archived
and its local credential copies removed. The candidate app was stopped.

Limits: provider execution used a deterministic Claude protocol fixture,
not an LLM. This is local real-provider UX proof, not deployed staging
or broader Codie/Claude qualification. The public preview intentionally
blocked ancillary artifact routes, so its destination pages could show a
partial-history warning. The complete permission-grant flow and every
oversized/mixed-form branch were not driven manually. Earlier fixture,
test, and provider failures remain recorded.

## Risks

- New reply routes require durable origin proof. Incorrect receipt
matching could lose a reply or route it incorrectly. Tests cover
missing, forged, mismatched, and revoked authority.
- Governed forms keep their Paperclip resolution checks. This change
does not grant new approval authority to Slack.
- Existing completed review results can become deliverable through the
repaired publication path without another provider run.
- No schema, lockfile, workflow, public task-status model, or
runtime-instruction change is included. This branch is not deployed.

## Model Used

OpenAI Codex, GPT-6 family, with code execution and tool use. The exact
backend model ID and context-window size are not exposed in this
session.

## Checklist

- [x] I have included a thinking path that traces from project context
to this change
- [x] I have specified the model used (with version and capability
details)
- [x] I have checked ROADMAP.md and confirmed this PR does not duplicate
planned core work
- [x] I have searched GitHub for duplicate or related PRs and linked
them above
- [x] I have either linked existing issues or described the issue in-PR
following the relevant issue template
- [x] I have not referenced internal/instance-local Paperclip issues or
links
- [x] My branch name describes the change and contains no internal
Paperclip ticket id
- [x] I have run focused tests locally and they pass
- [x] I have added or updated tests where applicable
- [x] I have updated relevant documentation to reflect my changes
- [x] I have considered and documented any risks above
- [x] All Paperclip CI gates are green on the new head
- [x] Greptile is 5/5 with no open P2s, recommendations, or follow-ups
on the new head
- [x] I will address all Greptile and reviewer comments before
requesting merge

---------

Co-authored-by: Paperclip <noreply@paperclip.ing>
2026-10-24 10:29:15 -07:00

1501 lines
58 KiB
TypeScript

import { randomUUID } from "node:crypto";
import { and, eq, sql } from "drizzle-orm";
import { afterAll, beforeAll, describe, expect, it } from "vitest";
import {
agents,
applyPendingMigrations,
EMBEDDED_POSTGRES_TEST_TIMEOUT_MS,
chatActions,
chatConversations,
chatEndpoints,
chatPublications,
companies,
createDb,
documentRevisions,
documents,
heartbeatRuns,
issueComments,
issueDocuments,
issueThreadInteractions,
issues,
toolApplications,
toolConnections,
} from "@paperclipai/db";
import type { ChatProvider } from "@paperclipai/shared";
import { enqueueIssueInteractionChatPublications, enqueueTerminalIssueInteractionChatPublications } from "../services/chat-interaction-publications.js";
import { issueThreadInteractionService } from "../services/issue-thread-interactions.js";
import {
getEmbeddedPostgresTestSupport,
startEmbeddedPostgresTestDatabase,
} from "./helpers/embedded-postgres.js";
import { resolveExternalTestDatabaseUrl } from "./helpers/external-test-database.js";
const externalUrl = resolveExternalTestDatabaseUrl("PAPERCLIP_CHAT_PUBLICATIONS_TEST_DATABASE_URL");
const embeddedPostgresSupport = externalUrl ? { supported: true } : await getEmbeddedPostgresTestSupport();
const describeEmbeddedPostgres = embeddedPostgresSupport.supported
? describe
: describe.skip;
describeEmbeddedPostgres(
"terminal native chat interaction publications",
() => {
let db!: ReturnType<typeof createDb>;
let tempDb: Awaited<
ReturnType<typeof startEmbeddedPostgresTestDatabase>
> | null = null;
const previousPublicUrl = process.env.PAPERCLIP_PUBLIC_URL;
beforeAll(async () => {
process.env.PAPERCLIP_PUBLIC_URL = "https://paperclip.example";
if (externalUrl) await applyPendingMigrations(externalUrl);
else tempDb = await startEmbeddedPostgresTestDatabase("paperclip-terminal-chat-interaction-");
db = createDb(externalUrl ?? tempDb!.connectionString);
}, EMBEDDED_POSTGRES_TEST_TIMEOUT_MS);
afterAll(async () => {
if (previousPublicUrl === undefined)
delete process.env.PAPERCLIP_PUBLIC_URL;
else process.env.PAPERCLIP_PUBLIC_URL = previousPublicUrl;
await db?.$client.end({ timeout: 1 });
await tempDb?.cleanup();
});
async function seedBoundIssue(
providers: ChatProvider[] = ["slack", "telegram"],
) {
const companyId = randomUUID();
const agentId = randomUUID();
const issueId = randomUUID();
await db.insert(companies).values({
id: companyId,
name: `Terminal chat ${companyId}`,
issuePrefix: `TC${companyId.replaceAll("-", "").slice(0, 6).toUpperCase()}`,
});
await db.insert(agents).values({
id: agentId,
companyId,
name: "Native chat agent",
role: "operator",
status: "idle",
adapterType: "paperclip_runner",
adapterConfig: {},
runtimeConfig: {},
permissions: {},
});
await db.insert(issues).values({
id: issueId,
companyId,
title: "Resolve the native provider card",
status: "in_progress",
priority: "medium",
assigneeAgentId: agentId,
});
const endpointIds: Record<string, string> = {};
for (const provider of providers) {
const applicationId = randomUUID();
const connectionId = randomUUID();
const endpointId = randomUUID();
endpointIds[provider] = endpointId;
await db.insert(toolApplications).values({
id: applicationId,
companyId,
applicationKey: `chat:${provider}:${endpointId}`,
name: `${provider} ${endpointId}`,
type: "chat",
status: "active",
});
await db.insert(toolConnections).values({
id: connectionId,
companyId,
applicationId,
name: `${provider} channel`,
uid: `chat-${provider}-${endpointId}`,
connectionPurpose: "channel",
transport: "chat_sdk",
status: "active",
enabled: true,
});
await db.insert(chatEndpoints).values({
id: endpointId,
companyId,
connectionId,
provider,
publicId: randomUUID(),
assignedAgentId: agentId,
status: "active",
capabilities: {
threads: true,
directMessages: true,
nativeStreaming: false,
messageEdits: true,
messageDeletes: false,
reactions: true,
files: true,
cards: true,
actions: true,
modals: provider !== "telegram",
slashCommands: true,
ephemeralMessages: provider === "slack",
proactiveDirectMessages: true,
},
});
await db.insert(chatConversations).values({
companyId,
endpointId,
issueId,
externalConversationId: `${provider}-conversation`,
externalThreadId: `${provider}:thread:${issueId}`,
externalLabel: `${provider} thread`,
state: "active",
});
}
return { agentId, companyId, endpointIds, issueId };
}
async function markInteractionCardsPublished(
companyId: string,
interactionId: string,
) {
const originals = await db
.select()
.from(chatPublications)
.where(
and(
eq(chatPublications.companyId, companyId),
eq(
sql<string>`${chatPublications.payload}->>'interactionId'`,
interactionId,
),
),
);
for (const original of originals) {
await db
.update(chatPublications)
.set({
state: "published",
providerMessageId: `provider-${original.endpointId}`,
})
.where(eq(chatPublications.id, original.id));
}
return originals;
}
async function publicationsForInteraction(
companyId: string,
interactionId: string,
) {
return db
.select()
.from(chatPublications)
.where(
and(
eq(chatPublications.companyId, companyId),
eq(
sql<string>`${chatPublications.payload}->>'interactionId'`,
interactionId,
),
),
);
}
function interceptAfterFirstSelect(
afterSelect: () => Promise<void>,
): Parameters<typeof enqueueTerminalIssueInteractionChatPublications>[0] {
let intercepted = false;
const wrapQuery = (query: any): any =>
new Proxy(query, {
get(target, property) {
if (property === "then") {
return (onFulfilled: unknown, onRejected: unknown) =>
Promise.resolve(target)
.then(async (value) => {
if (!intercepted) {
intercepted = true;
await afterSelect();
}
return value;
})
.then(onFulfilled as never, onRejected as never);
}
const member = Reflect.get(target, property, target);
return typeof member === "function"
? (...args: unknown[]) =>
wrapQuery(Reflect.apply(member, target, args))
: member;
},
});
return {
select: ((...args: unknown[]) =>
wrapQuery(Reflect.apply(db.select, db, args))) as typeof db.select,
insert: db.insert.bind(db),
update: db.update.bind(db),
transaction: db.transaction.bind(db),
};
}
it("publishes a larger Slack choice as an inline selection backed by durable answer tokens", async () => {
const fixture = await seedBoundIssue(["slack", "microsoft-teams"]);
const interaction = await issueThreadInteractionService(db).create(
{ id: fixture.issueId, companyId: fixture.companyId },
{ kind: "ask_user_questions", payload: { version: 1, questions: [{
id: "fixture", prompt: "Which fixture?", selectionMode: "single", options: Array.from({ length: 13 }, (_, i) => ({ id: `fixture-${i}`, label: `Fixture ${i + 1}` })),
}] } }, { agentId: fixture.agentId },
);
const publications = await publicationsForInteraction(fixture.companyId, interaction.id);
const native = publications.find(row => row.payload.card?.selection);
expect(native?.payload.card?.selection?.options).toHaveLength(13);
expect(native?.payload.card?.actions).toBeUndefined();
expect(native?.payload.card?.body).not.toContain("- Fixture");
const tokens = await db.select().from(chatActions).where(eq(chatActions.endpointId, native!.endpointId));
expect(tokens.filter(token => token.kind === "question_answer")).toHaveLength(13);
expect(publications.find(row => row.id !== native!.id)?.payload.card?.actions).toEqual([expect.objectContaining({ label: "Respond" })]);
});
it("shows the free-text question and context alongside Respond", async () => {
const fixture = await seedBoundIssue(["slack"]);
const interaction = await issueThreadInteractionService(db).create(
{ id: fixture.issueId, companyId: fixture.companyId },
{
kind: "ask_user_questions",
title: "Identify the failed change",
summary: "The general migration checks passed. I need one detail to reproduce your specific failure.",
payload: {
version: 1,
title: "Identify the failed change",
questions: [{
id: "agent", prompt: "Which agent did you try to change?",
helpText: "Send the agent link and the error text, if available.",
selectionMode: "single", allowOther: true,
options: [{ id: "text", label: "Type an answer", freeText: true }],
}],
},
},
{ agentId: fixture.agentId },
);
const [publication] = await publicationsForInteraction(fixture.companyId, interaction.id);
expect(publication.payload.card).toMatchObject({
title: "Identify the failed change",
body: "The general migration checks passed. I need one detail to reproduce your specific failure.\n\nWhich agent did you try to change?\n\nSend the agent link and the error text, if available.",
actions: [expect.objectContaining({ label: "Respond", type: "callback" })],
});
});
it.each(["text", "single_select", "multi_select", "custom", "pattern", "oversized"] as const)("publishes the complete %s question with an actionable response path", async shape => {
const fixture = await seedBoundIssue(["slack"]);
const question = {
id: "agent", prompt: "Which agent failed?", helpText: "Send the link and error text.", required: true,
answerMode: shape === "multi_select" ? "multi_select" as const : shape === "text" || shape === "pattern" || shape === "oversized" ? "text" as const : "single_select" as const,
...(shape === "single_select" || shape === "multi_select" || shape === "custom" ? { options: [{ id: "codie", label: "Codie", description: "Native runner", recommended: true }, { id: "claude", label: "Claude", description: "Legacy runner" }] } : {}),
...(shape === "custom" ? { customAnswer: { enabled: true, label: "Another agent", placeholder: "Paste the agent link" } } : {}),
...(shape === "pattern" ? { textValidation: { pattern: "^[A-Z]+$" } } : {}),
...(shape === "oversized" ? { initialText: "x".repeat(3001) } : {}),
};
const service = issueThreadInteractionService(db);
const interaction = await service.create({ id: fixture.issueId, companyId: fixture.companyId }, {
kind: "ask_user_questions", title: "Identify the failed change",
payload: { version: 1, questionSet: { schema: "paperclip.question_set.v1", description: "The answer determines the next test.", questions: [question] } },
} as Parameters<typeof service.create>[1], { agentId: fixture.agentId });
const [publication] = await publicationsForInteraction(fixture.companyId, interaction.id);
expect(publication.payload.card?.body).toContain(question.prompt);
expect(publication.payload.card?.body).toContain(question.helpText);
expect(publication.payload.card?.body).toContain("The answer determines the next test.");
expect(publication.payload.text).toContain(question.prompt);
if (shape === "multi_select") {
expect(publication.payload.card?.selection).toMatchObject({ multiple: true, options: [
{ label: "Codie (recommended)", description: "Native runner" }, { label: "Claude", description: "Legacy runner" },
] });
} else if (question.options && shape !== "custom") {
expect(publication.payload.card?.body).toContain("Codie (recommended): Native runner");
expect(publication.payload.card?.body).toContain("Claude: Legacy runner");
}
if (shape === "custom") {
expect(publication.payload.card?.body).toContain("- Codie (recommended): Native runner");
expect(publication.payload.card?.actions?.map(action => action.label)).toEqual(["Codie", "Claude", "Other…"]);
const tokens = await db.select().from(chatActions).where(eq(chatActions.endpointId, publication.endpointId));
expect(tokens.map(token => token.kind).sort()).toEqual(["question_answer", "question_answer", "question_form_open", "question_form_submit"].sort());
}
if (shape === "oversized") {
expect(publication.payload.card?.actions).toEqual([{ type: "link", label: "Open in Paperclip", url: expect.stringContaining(fixture.issueId) }]);
} else if (shape !== "multi_select") {
expect(publication.payload.card?.actions?.every(action => action.type === "callback")).toBe(true);
}
});
it.each([100, 101, 128])("preserves the complete response path for %i choices plus Other", async count => {
const fixture = await seedBoundIssue(["slack"]);
const service = issueThreadInteractionService(db);
const options = Array.from({ length: count }, (_, index) => ({ id: `choice-${index}`, label: `Choice ${index}` }));
const interaction = await service.create({ id: fixture.issueId, companyId: fixture.companyId }, {
kind: "ask_user_questions",
payload: { version: 1, questionSet: { schema: "paperclip.question_set.v1", questions: [{
id: "choice", prompt: "Choose a fixture", answerMode: "single_select", required: true,
options, customAnswer: { enabled: true },
}] } },
}, { agentId: fixture.agentId });
const [publication] = await publicationsForInteraction(fixture.companyId, interaction.id);
const tokens = await db.select().from(chatActions).where(eq(chatActions.endpointId, publication.endpointId));
if (count === 100) {
expect(publication.payload.card?.selection?.options).toHaveLength(count);
expect(publication.payload.card?.actions).toEqual([
expect.objectContaining({ type: "callback", label: "Other…" }),
]);
expect(tokens.filter(token => token.kind === "question_answer")).toHaveLength(count);
} else {
expect(publication.payload.card?.selection).toBeUndefined();
expect(publication.payload.card?.actions).toEqual([
{ type: "link", label: "Open in Paperclip", url: expect.stringContaining(fixture.issueId) },
]);
expect(tokens).toEqual([]);
await markInteractionCardsPublished(fixture.companyId, interaction.id);
await service.answerQuestions({ id: fixture.issueId, companyId: fixture.companyId }, interaction.id, {
answers: [{ questionId: "choice", optionIds: [options[count - 1]!.id] }],
}, { userId: "board-user" });
const settled = await publicationsForInteraction(fixture.companyId, interaction.id);
expect(settled.find(row => row.id !== publication.id)?.payload.card?.body).toContain(`Answered: Choice ${count - 1}`);
}
});
it("keeps repeated choices and help under each question", async () => {
const fixture = await seedBoundIssue(["slack"]);
const interaction = await issueThreadInteractionService(db).create(
{ id: fixture.issueId, companyId: fixture.companyId },
{ kind: "ask_user_questions", payload: { version: 1, questions: ["Codie", "Claude"].map(agent => ({ id: agent, prompt: `Convert ${agent}?`, helpText: "Keep the existing configuration.", selectionMode: "single" as const, options: [{ id: "yes", label: "Yes" }, { id: "no", label: "No" }] })) } },
{ agentId: fixture.agentId },
);
const [publication] = await publicationsForInteraction(fixture.companyId, interaction.id);
const body = publication.payload.card!.body!;
expect(body.match(/- Yes/g)).toHaveLength(2);
expect(body.match(/- No/g)).toHaveLength(2);
expect(body.match(/Keep the existing configuration/g)).toHaveLength(2);
expect(body.slice(body.indexOf("Convert Claude?"))).toContain("- Yes");
});
it("publishes prompts only for the endpoint's verified immutable agent", async () => {
const fixture = await seedBoundIssue();
const service = issueThreadInteractionService(db);
const foreignAgentId = randomUUID();
await db.insert(agents).values({
id: foreignAgentId,
companyId: fixture.companyId,
name: "Foreign agent",
role: "operator",
status: "idle",
adapterType: "paperclip_runner",
adapterConfig: {},
runtimeConfig: {},
permissions: {},
});
const foreignRunId = randomUUID();
await db.insert(heartbeatRuns).values({
id: foreignRunId,
companyId: fixture.companyId,
agentId: foreignAgentId,
status: "succeeded",
});
const question = {
kind: "ask_user_questions" as const,
payload: {
version: 1 as const,
questions: [
{
id: "priority",
prompt: "Which priority?",
selectionMode: "single" as const,
allowOther: false,
options: [{ id: "high", label: "High" }],
},
],
},
};
const userAuthored = await service.create(
{ id: fixture.issueId, companyId: fixture.companyId },
question,
{ userId: "board-user" },
);
const foreignAuthored = await service.create(
{ id: fixture.issueId, companyId: fixture.companyId },
question,
{ agentId: foreignAgentId },
);
const mismatchedRun = await service.create(
{ id: fixture.issueId, companyId: fixture.companyId },
{ ...question, sourceRunId: foreignRunId },
{ agentId: foreignAgentId },
);
await expect(
publicationsForInteraction(fixture.companyId, userAuthored.id),
).resolves.toEqual([]);
await expect(
publicationsForInteraction(fixture.companyId, foreignAuthored.id),
).resolves.toEqual([]);
await expect(
publicationsForInteraction(fixture.companyId, mismatchedRun.id),
).resolves.toEqual([]);
const assignedAgent = await service.create(
{ id: fixture.issueId, companyId: fixture.companyId },
question,
{ agentId: fixture.agentId },
);
const publications = await publicationsForInteraction(
fixture.companyId,
assignedAgent.id,
);
expect(publications).toHaveLength(2);
expect(
publications.every(
(row) =>
row.idempotencyKey ===
`interaction:${assignedAgent.id}:${row.endpointId}`,
),
).toBe(true);
});
it("rolls back an interaction publication if its callback tokens cannot be stored", async () => {
const fixture = await seedBoundIssue(["telegram"]);
const interaction = await issueThreadInteractionService(db).create(
{ id: fixture.issueId, companyId: fixture.companyId },
{ kind: "request_confirmation", continuationPolicy: "wake_assignee", payload: { version: 1, prompt: "Proceed?" } },
{ agentId: fixture.agentId },
);
expect(await publicationsForInteraction(fixture.companyId, interaction.id)).toHaveLength(1);
await db.delete(chatActions).where(eq(chatActions.companyId, fixture.companyId));
await db.delete(chatPublications).where(eq(chatPublications.companyId, fixture.companyId));
const failTokens = (insert: typeof db.insert): typeof db.insert =>
((table: Parameters<typeof db.insert>[0]) => {
if (table === chatActions) throw new Error("Token write failed");
return insert(table);
}) as typeof db.insert;
const failingDb: Parameters<typeof enqueueIssueInteractionChatPublications>[0] = {
select: db.select.bind(db),
update: db.update.bind(db),
insert: failTokens(db.insert.bind(db)),
transaction: callback => db.transaction(async tx => {
tx.insert = failTokens(tx.insert.bind(tx));
return callback(tx);
}),
};
await expect(enqueueIssueInteractionChatPublications(failingDb, interaction))
.rejects.toThrow("Token write failed");
expect(await publicationsForInteraction(fixture.companyId, interaction.id)).toEqual([]);
});
it("delivers native checkbox reviews in Slack", async () => {
const fixture = await seedBoundIssue();
const interaction = await issueThreadInteractionService(db).create(
{ id: fixture.issueId, companyId: fixture.companyId },
{
kind: "request_checkbox_confirmation",
payload: {
version: 1,
prompt: "Choose deployment regions",
options: [{ id: "us", label: "US" }],
},
},
{ agentId: fixture.agentId },
);
const publications = await publicationsForInteraction(fixture.companyId, interaction.id);
expect(publications).toHaveLength(1);
expect(publications[0].endpointId).toBe(fixture.endpointIds.slack);
expect(publications[0].payload.card).toMatchObject({
selection: { multiple: true, options: [{ label: "US" }] },
actions: [{ type: "callback", label: "Reject" }],
});
await markInteractionCardsPublished(fixture.companyId, interaction.id);
await issueThreadInteractionService(db).rejectInteraction(
{ id: fixture.issueId, companyId: fixture.companyId }, interaction.id, {}, { userId: "board-user" },
);
const settled = await publicationsForInteraction(fixture.companyId, interaction.id);
expect(settled).toHaveLength(2);
expect(settled.find(row => row.id !== publications[0].id)?.payload.card?.body).toBe("Rejected");
expect(settled.find(row => row.id !== publications[0].id)?.payload.card?.actions).toBeUndefined();
});
it.each([
{ kind: "suggest_tasks", payload: { version: 1, tasks: [{ clientKey: "docs", title: "Review the migration", description: "Verify preserved configuration" }] }, expected: "Review the migration" },
{ kind: "request_item_verdicts", payload: { version: 1, prompt: "Review each change", items: [{ id: "docs", label: "Migration notes", description: "Verify preserved configuration" }] }, expected: "Migration notes" },
] as const)("delivers and settles $kind reviews in Slack", async ({ kind, payload, expected }) => {
const fixture = await seedBoundIssue();
const service = issueThreadInteractionService(db);
const issue = { id: fixture.issueId, companyId: fixture.companyId };
const interaction = await service.create(issue, { kind, payload } as Parameters<typeof service.create>[1], { agentId: fixture.agentId });
const [original] = await publicationsForInteraction(fixture.companyId, interaction.id);
expect(original?.endpointId).toBe(fixture.endpointIds.slack);
expect(original?.payload.card?.body).toContain(expected);
expect(original?.payload.card?.body).toContain("Verify preserved configuration");
expect(original?.payload.card?.actions).toEqual(kind === "request_item_verdicts" ? [{ type: "callback", actionId: expect.any(String), label: "Review decisions", style: "primary" }] : [{ type: "callback", actionId: expect.any(String), label: "Create task", style: "primary" }, { type: "callback", actionId: expect.any(String), label: "Dismiss", style: "default" }, { type: "link", label: "Revise in Paperclip", url: expect.stringContaining(fixture.issueId) }]);
await markInteractionCardsPublished(fixture.companyId, interaction.id);
if (kind === "request_item_verdicts") {
await service.submitItemVerdicts(issue, interaction.id, { verdicts: [{ id: "docs", verdict: "approve" }] }, { userId: "board-user" });
} else {
await service.rejectInteraction(issue, interaction.id, {}, { userId: "board-user" });
}
const settled = await publicationsForInteraction(fixture.companyId, interaction.id);
expect(settled).toHaveLength(2);
expect(settled.find(row => row.id !== original.id)?.payload.card?.body).toBe(kind === "request_item_verdicts" ? "Migration notes: approve" : "Dismissed — no tasks created.");
expect(settled.find(row => row.id !== original.id)?.payload.card?.actions).toBeUndefined();
});
it("settles an item review superseded by a historical human comment", async () => {
const fixture = await seedBoundIssue(["slack"]);
const service = issueThreadInteractionService(db);
const issue = { id: fixture.issueId, companyId: fixture.companyId };
const interaction = await service.create(issue, { kind: "request_item_verdicts", payload: { version: 1, prompt: "Review these items", supersedeOnUserComment: true, items: [{ id: "docs", label: "Migration notes" }] } }, { agentId: fixture.agentId });
const [original] = await markInteractionCardsPublished(fixture.companyId, interaction.id);
await db.insert(issueComments).values({ companyId: fixture.companyId, issueId: fixture.issueId, authorUserId: "board-user", body: "Use the updated proposal instead.", createdAt: new Date(Date.now() + 1000) });
const expired = await service.expireRequestConfirmationsSupersededByHistoricalComments(issue);
expect(expired).toHaveLength(1);
expect(expired[0].status).toBe("expired");
const publications = await publicationsForInteraction(fixture.companyId, interaction.id);
expect(publications).toHaveLength(2);
expect(publications.find(row => row.id !== original.id)?.payload.card?.body).toBe("Expired in Paperclip");
});
it.each(["decline", "reassign"] as const)("delivers, deduplicates and settles an addressed connection request on %s without a second wake owner", async outcome => {
const fixture = await seedBoundIssue();
const sourceRunId = randomUUID();
await db.insert(heartbeatRuns).values({ id: sourceRunId, companyId: fixture.companyId, agentId: fixture.agentId, status: "running", responsibleUserId: "board-user", contextSnapshot: { issueId: fixture.issueId } });
const service = issueThreadInteractionService(db);
const issue = { id: fixture.issueId, companyId: fixture.companyId };
const input = { sourceRunId, addresseeUserId: "board-user", idempotencyKey: "connection-slack", payload: { version: 1 as const, serviceSlug: "notion", serviceName: "Notion", requestingAgentId: fixture.agentId, requestingAgentName: "Codie", phase: "requested" as const } };
const interaction = await service.createConnectionIntent(issue, input);
await service.createConnectionIntent(issue, input);
const [original] = await publicationsForInteraction(fixture.companyId, interaction.id);
expect(original?.payload.card?.body).toContain("Codie needs Notion");
expect(original?.payload.card?.actions).toEqual([{ type: "link", label: "Review connection", url: expect.stringContaining(fixture.issueId) }, { type: "callback", actionId: expect.any(String), label: "Not now", style: "default" }]);
expect(await publicationsForInteraction(fixture.companyId, interaction.id)).toHaveLength(1);
await markInteractionCardsPublished(fixture.companyId, interaction.id);
await expect(service.resolveConnectionIntent(issue, interaction.id, { version: 1, outcome: "declined" }, { userId: "different-user" })).rejects.toMatchObject({ status: 403 });
if (outcome === "decline") await service.resolveConnectionIntent(issue, interaction.id, { version: 1, outcome: "declined" }, { userId: "board-user" });
else await db.transaction(async tx => issueThreadInteractionService(tx as unknown as typeof db).expireConnectionIntentsForOwnershipChange(issue));
const settled = await publicationsForInteraction(fixture.companyId, interaction.id);
expect(settled).toHaveLength(2);
expect(settled.find(row => row.id !== original.id)?.payload.card?.body).toBe(outcome === "decline" ? "Declined: Notion. No access was granted." : "Expired in Paperclip");
expect((await db.select().from(chatActions).where(eq(chatActions.companyId, fixture.companyId))).filter(action => action.kind === "interaction_wakeup")).toEqual([]);
});
it("settles a card when the dispatcher claims it between the read and cancellation CAS", async () => {
const fixture = await seedBoundIssue(["slack"]);
const service = issueThreadInteractionService(db);
const interaction = await service.create(
{ id: fixture.issueId, companyId: fixture.companyId },
{
kind: "ask_user_questions",
continuationPolicy: "wake_assignee",
payload: {
version: 1,
questions: [
{
id: "priority",
prompt: "Which priority?",
selectionMode: "single",
allowOther: false,
options: [{ id: "high", label: "High" }],
},
],
},
},
{ agentId: fixture.agentId },
);
const [original] = await publicationsForInteraction(
fixture.companyId,
interaction.id,
);
if (!original) throw new Error("Expected an original publication");
await db
.update(issueThreadInteractions)
.set({
status: "answered",
result: {
version: 1,
answers: [{ questionId: "priority", optionIds: ["high"] }],
summaryMarkdown: null,
},
resolvedByUserId: "board-user",
resolvedAt: new Date(),
updatedAt: new Date(),
})
.where(eq(issueThreadInteractions.id, interaction.id));
const answered = await service.getById(interaction.id);
if (!answered) throw new Error("Expected an answered interaction");
const raceDb = interceptAfterFirstSelect(async () => {
const claimed = await db
.update(chatPublications)
.set({ state: "streaming", updatedAt: new Date() })
.where(
and(
eq(chatPublications.id, original.id),
eq(chatPublications.state, "pending"),
),
)
.returning({ id: chatPublications.id });
expect(claimed).toEqual([{ id: original.id }]);
});
await enqueueTerminalIssueInteractionChatPublications(raceDb, answered);
await expect(
db
.select({ state: chatPublications.state })
.from(chatPublications)
.where(eq(chatPublications.id, original.id)),
).resolves.toEqual([{ state: "streaming" }]);
const publications = await publicationsForInteraction(
fixture.companyId,
interaction.id,
);
expect(publications).toEqual(
expect.arrayContaining([
expect.objectContaining({
idempotencyKey: `interaction-resolution:${interaction.id}:${fixture.endpointIds.slack}`,
state: "pending",
payload: expect.objectContaining({ text: "Answered: High." }),
}),
]),
);
});
it("settles an ambiguously delivered link-only card after an operator marks it delivered", async () => {
const fixture = await seedBoundIssue(["github"]);
const service = issueThreadInteractionService(db);
const interaction = await service.create(
{ id: fixture.issueId, companyId: fixture.companyId },
{
kind: "request_confirmation",
continuationPolicy: "wake_assignee",
payload: { version: 1, prompt: "Ship the GitHub release?" },
},
{ agentId: fixture.agentId },
);
const [original] = await publicationsForInteraction(
fixture.companyId,
interaction.id,
);
if (!original) throw new Error("Expected a GitHub link-only card");
await db
.update(chatPublications)
.set({ state: "published", providerMessageId: null })
.where(eq(chatPublications.id, original.id));
await service.acceptInteraction(
{
id: fixture.issueId,
companyId: fixture.companyId,
projectId: null,
goalId: null,
},
interaction.id,
{},
{ userId: "board-user" },
);
await expect(
db
.select({
idempotencyKey: chatPublications.idempotencyKey,
payload: chatPublications.payload,
state: chatPublications.state,
})
.from(chatPublications)
.where(
eq(
chatPublications.idempotencyKey,
`interaction-resolution:${interaction.id}:${fixture.endpointIds.github}`,
),
),
).resolves.toEqual([
{
idempotencyKey: `interaction-resolution:${interaction.id}:${fixture.endpointIds.github}`,
payload: expect.objectContaining({
interactionId: interaction.id,
text: "Accepted.",
}),
state: "pending",
},
]);
});
it("retains question and answer context while redacting credentials in settled form cards", async () => {
const fixture = await seedBoundIssue();
const service = issueThreadInteractionService(db);
const interaction = await service.create(
{ id: fixture.issueId, companyId: fixture.companyId },
{
kind: "ask_user_questions",
payload: {
version: 1,
questions: [
{
id: "choice",
prompt: "Choose a tree",
selectionMode: "single",
allowOther: false,
options: [{ id: "cedar", label: "Cedar" }],
},
{
id: "label",
prompt: "Enter a label",
selectionMode: "single",
allowOther: true,
options: [
{ id: "text", label: "Write a label", freeText: true },
],
},
],
},
},
{ agentId: fixture.agentId },
);
await markInteractionCardsPublished(fixture.companyId, interaction.id);
await service.answerQuestions(
{ id: fixture.issueId, companyId: fixture.companyId },
interaction.id,
{
answers: [
{ questionId: "choice", optionIds: ["cedar"] },
{
questionId: "label",
optionIds: [],
otherText: "Runner conversion failed. password=do-not-publish-this",
},
],
},
{ userId: "board-user" },
);
const settlements = (
await publicationsForInteraction(fixture.companyId, interaction.id)
).filter((row) => row.state === "pending");
expect(settlements).toHaveLength(2);
for (const settlement of settlements) {
expect(settlement.payload).toMatchObject({
text: expect.stringContaining("Enter a label\n\nAnswered: Runner conversion failed."),
card: { kind: "question", body: expect.stringContaining("Choose a tree\n\nAnswered: Cedar") },
});
expect(settlement.payload.card?.actions ?? []).toHaveLength(0);
expect(JSON.stringify(settlement.payload)).not.toContain(
"do-not-publish-this",
);
expect(JSON.stringify(settlement.payload)).not.toContain(
"Answered in Paperclip",
);
}
});
it("settles UI answers and skips on every provider-native card with no live actions", async () => {
const fixture = await seedBoundIssue();
const service = issueThreadInteractionService(db);
const questionInput = {
kind: "ask_user_questions" as const,
payload: {
version: 1 as const,
questions: [
{
id: "priority",
prompt: "Which priority?",
selectionMode: "single" as const,
allowOther: false,
options: [
{ id: "high", label: "High" },
{ id: "normal", label: "Normal" },
],
},
],
},
};
const answeredQuestion = await service.create(
{ id: fixture.issueId, companyId: fixture.companyId },
questionInput,
{ agentId: fixture.agentId },
);
expect(
await markInteractionCardsPublished(
fixture.companyId,
answeredQuestion.id,
),
).toHaveLength(2);
const answered = await service.answerQuestions(
{ id: fixture.issueId, companyId: fixture.companyId },
answeredQuestion.id,
{ answers: [{ questionId: "priority", optionIds: ["high"] }] },
{ userId: "board-user" },
);
const answeredSettlements = await db
.select()
.from(chatPublications)
.where(
and(
eq(chatPublications.companyId, fixture.companyId),
eq(
sql<string>`${chatPublications.payload}->>'interactionId'`,
answeredQuestion.id,
),
eq(chatPublications.state, "pending"),
),
);
expect(answeredSettlements).toHaveLength(2);
expect(answeredSettlements).toEqual(
expect.arrayContaining(
Object.values(fixture.endpointIds).map((endpointId) =>
expect.objectContaining({
endpointId,
idempotencyKey: `interaction-resolution:${answeredQuestion.id}:${endpointId}`,
payload: expect.objectContaining({
text: "Answered: High.",
card: expect.objectContaining({
kind: "question",
title: "Which priority?",
body: "Answered: High.",
}),
}),
}),
),
),
);
expect(
answeredSettlements.every(
(row) => (row.payload.card?.actions ?? []).length === 0,
),
).toBe(true);
await expect(
enqueueTerminalIssueInteractionChatPublications(db, answered),
).resolves.toEqual([]);
await expect(
db
.select({ status: chatActions.status })
.from(chatActions)
.where(
eq(
sql<string>`${chatActions.payload}->>'interactionId'`,
answeredQuestion.id,
),
),
).resolves.toEqual([
{ status: "expired" },
{ status: "expired" },
{ status: "expired" },
{ status: "expired" },
]);
const skippedQuestion = await service.create(
{ id: fixture.issueId, companyId: fixture.companyId },
questionInput,
{ agentId: fixture.agentId },
);
await markInteractionCardsPublished(
fixture.companyId,
skippedQuestion.id,
);
await service.skipInteraction(
{
id: fixture.issueId,
companyId: fixture.companyId,
status: "in_progress",
},
skippedQuestion.id,
{},
{ userId: "board-user" },
);
const skippedSettlements = await db
.select()
.from(chatPublications)
.where(
and(
eq(chatPublications.companyId, fixture.companyId),
eq(
sql<string>`${chatPublications.payload}->>'interactionId'`,
skippedQuestion.id,
),
eq(chatPublications.state, "pending"),
),
);
expect(skippedSettlements).toHaveLength(2);
expect(
skippedSettlements.every(
(row) => row.payload.card?.body === "Skipped in Paperclip.",
),
).toBe(true);
expect(
skippedSettlements.every(
(row) => (row.payload.card?.actions ?? []).length === 0,
),
).toBe(true);
await expect(
db
.select({ id: chatActions.id })
.from(chatActions)
.where(
and(
eq(chatActions.kind, "interaction_wakeup"),
eq(
sql<string>`${chatActions.payload}->>'interactionId'`,
skippedQuestion.id,
),
),
),
).resolves.toEqual([]);
});
it("settles native and link-only confirmation cards without inventing controls", async () => {
const fixture = await seedBoundIssue();
const service = issueThreadInteractionService(db);
for (const outcome of ["accept", "reject"] as const) {
const interaction = await service.create(
{ id: fixture.issueId, companyId: fixture.companyId },
{
kind: "request_confirmation",
continuationPolicy: "wake_assignee",
payload: { version: 1, prompt: `Should we ${outcome}?` },
},
{ agentId: fixture.agentId },
);
const originals = await markInteractionCardsPublished(
fixture.companyId,
interaction.id,
);
expect(originals).toHaveLength(2);
expect(
originals.find((row) => row.endpointId === fixture.endpointIds.slack)
?.payload.card?.actions,
).toEqual([
expect.objectContaining({ type: "callback", label: "Accept" }),
expect.objectContaining({ type: "callback", label: "Reject" }),
]);
expect(
originals.find(
(row) => row.endpointId === fixture.endpointIds.telegram,
)?.payload.card?.actions,
).toEqual([
expect.objectContaining({ type: "callback" }),
expect.objectContaining({ type: "callback" }),
]);
if (outcome === "accept") {
await service.acceptInteraction(
{
id: fixture.issueId,
companyId: fixture.companyId,
projectId: null,
goalId: null,
},
interaction.id,
{},
{ userId: "board-user" },
);
} else {
await service.rejectInteraction(
{ id: fixture.issueId, companyId: fixture.companyId },
interaction.id,
{},
{ userId: "board-user" },
);
}
const settlements = await db
.select()
.from(chatPublications)
.where(
and(
eq(chatPublications.companyId, fixture.companyId),
eq(
sql<string>`${chatPublications.payload}->>'interactionId'`,
interaction.id,
),
eq(chatPublications.state, "pending"),
),
);
expect(settlements).toHaveLength(2);
expect(settlements).toEqual(
expect.arrayContaining(
Object.values(fixture.endpointIds).map((endpointId) =>
expect.objectContaining({
endpointId,
idempotencyKey: `interaction-resolution:${interaction.id}:${endpointId}`,
payload: expect.objectContaining({
text: outcome === "accept" ? "Accepted." : "Rejected.",
card: expect.objectContaining({
kind: "confirmation",
title: `Should we ${outcome}?`,
body: outcome === "accept" ? "Accepted" : "Rejected",
}),
}),
}),
),
),
);
expect(
settlements.every(
(settlement) =>
(settlement.payload.card?.actions ?? []).length === 0,
),
).toBe(true);
await expect(
db
.select({
kind: chatActions.kind,
payload: chatActions.payload,
status: chatActions.status,
})
.from(chatActions)
.where(
and(
eq(chatActions.kind, "interaction_wakeup"),
eq(
sql<string>`${chatActions.payload}->>'interactionId'`,
interaction.id,
),
),
),
).resolves.toEqual([
{
kind: "interaction_wakeup",
payload: expect.objectContaining({
agentId: fixture.agentId,
interactionId: interaction.id,
interactionStatus: outcome === "accept" ? "accepted" : "rejected",
issueId: fixture.issueId,
requestedByActorId: "board-user",
requestedByActorType: "user",
}),
status: "issued",
},
]);
}
});
it("expires both modal action tokens when a form-backed question is answered", async () => {
const fixture = await seedBoundIssue(["slack"]);
const service = issueThreadInteractionService(db);
const interaction = await service.create(
{ id: fixture.issueId, companyId: fixture.companyId },
{
kind: "ask_user_questions",
continuationPolicy: "wake_assignee",
payload: {
version: 1,
questions: [
{
id: "priority",
prompt: "Which priority?",
selectionMode: "single",
allowOther: false,
options: [{ id: "high", label: "High" }],
},
{
id: "owner",
prompt: "Who owns it?",
selectionMode: "single",
allowOther: false,
options: [{ id: "agent", label: "Agent" }],
},
],
},
},
{ agentId: fixture.agentId },
);
await markInteractionCardsPublished(fixture.companyId, interaction.id);
await service.answerQuestions(
{ id: fixture.issueId, companyId: fixture.companyId },
interaction.id,
{
answers: [
{ questionId: "priority", optionIds: ["high"] },
{ questionId: "owner", optionIds: ["agent"] },
],
},
{ userId: "board-user" },
);
const actions = await db
.select({ kind: chatActions.kind, status: chatActions.status })
.from(chatActions)
.where(
eq(
sql<string>`${chatActions.payload}->>'interactionId'`,
interaction.id,
),
);
expect(actions).toEqual(
expect.arrayContaining([
{ kind: "question_form_open", status: "expired" },
{ kind: "question_form_submit", status: "expired" },
]),
);
expect(actions).toHaveLength(2);
});
it("cancels unsent native and link-only cards instead of publishing stale prompts", async () => {
const fixture = await seedBoundIssue();
const service = issueThreadInteractionService(db);
const interaction = await service.create(
{ id: fixture.issueId, companyId: fixture.companyId },
{
kind: "request_confirmation",
payload: { version: 1, prompt: "Proceed?" },
},
{ agentId: fixture.agentId },
);
await service.acceptInteraction(
{
id: fixture.issueId,
companyId: fixture.companyId,
projectId: null,
goalId: null,
},
interaction.id,
{},
{ userId: "board-user" },
);
const publications = await db
.select()
.from(chatPublications)
.where(
and(
eq(chatPublications.companyId, fixture.companyId),
eq(
sql<string>`${chatPublications.payload}->>'interactionId'`,
interaction.id,
),
),
);
expect(publications).toHaveLength(2);
expect(publications).toEqual(
expect.arrayContaining(
Object.values(fixture.endpointIds).map((endpointId) =>
expect.objectContaining({
endpointId,
idempotencyKey: `interaction:${interaction.id}:${endpointId}`,
state: "cancelled",
redactedError:
"Interaction was resolved before provider publication",
}),
),
),
);
expect(
publications.some((row) =>
row.payload.card?.actions?.some((action) => action.type === "callback"),
),
).toBe(true);
});
it("settles visible question cards when a newer interaction supersedes them", async () => {
const fixture = await seedBoundIssue();
const service = issueThreadInteractionService(db);
const input = {
kind: "ask_user_questions" as const,
payload: {
version: 1 as const,
questions: [
{
id: "priority",
prompt: "Which priority?",
selectionMode: "single" as const,
allowOther: false,
options: [{ id: "high", label: "High" }],
},
],
},
};
const original = await service.create(
{ id: fixture.issueId, companyId: fixture.companyId },
input,
{ agentId: fixture.agentId },
);
await markInteractionCardsPublished(fixture.companyId, original.id);
const replacement = await service.create(
{ id: fixture.issueId, companyId: fixture.companyId },
input,
{ agentId: fixture.agentId },
);
await expect(service.getById(original.id)).resolves.toMatchObject({
status: "expired",
result: {
expirationReason: "superseded_by_newer_interaction",
supersededByInteractionId: replacement.id,
},
});
const publications = await db
.select()
.from(chatPublications)
.where(
and(
eq(chatPublications.companyId, fixture.companyId),
eq(
sql<string>`${chatPublications.payload}->>'interactionId'`,
original.id,
),
),
);
const settlements = publications.filter((row) =>
row.idempotencyKey.startsWith("interaction-resolution:"),
);
expect(settlements).toHaveLength(2);
expect(
settlements.every(
(row) =>
row.state === "pending" &&
row.payload.text === "Expired: replaced by a newer request." &&
row.payload.card?.body === "Expired: replaced by a newer request" &&
(row.payload.card.actions ?? []).length === 0,
),
).toBe(true);
});
it("settles live and historical human-comment supersessions", async () => {
const fixture = await seedBoundIssue();
const service = issueThreadInteractionService(db);
const confirmation = await service.create(
{ id: fixture.issueId, companyId: fixture.companyId },
{
kind: "request_confirmation",
payload: {
version: 1,
prompt: "Proceed with the release?",
supersedeOnUserComment: true,
},
},
{ agentId: fixture.agentId },
);
await markInteractionCardsPublished(fixture.companyId, confirmation.id);
const liveCommentId = randomUUID();
await service.expireRequestConfirmationsSupersededByComment(
{ id: fixture.issueId, companyId: fixture.companyId },
{
id: liveCommentId,
authorUserId: "board-user",
createdByRunId: null,
createdAt: new Date(Date.now() + 1_000),
},
{ userId: "board-user" },
);
const liveSettlements = await db
.select()
.from(chatPublications)
.where(
eq(
chatPublications.idempotencyKey,
`interaction-resolution:${confirmation.id}:${fixture.endpointIds.telegram}`,
),
);
expect(liveSettlements).toEqual([
expect.objectContaining({
payload: expect.objectContaining({
text: "Expired: superseded by a newer reply.",
card: expect.objectContaining({
body: "Expired: superseded by a newer reply",
}),
}),
}),
]);
expect(liveSettlements[0]?.payload.card?.actions ?? []).toHaveLength(0);
const question = await service.create(
{ id: fixture.issueId, companyId: fixture.companyId },
{
kind: "ask_user_questions",
payload: {
version: 1,
supersedeOnUserComment: true,
questions: [
{
id: "priority",
prompt: "Which priority?",
selectionMode: "single",
allowOther: false,
options: [{ id: "high", label: "High" }],
},
],
},
},
{ agentId: fixture.agentId },
);
await markInteractionCardsPublished(fixture.companyId, question.id);
const questionCreatedAt = new Date("2026-09-05T12:00:00.000Z");
await db
.update(issueThreadInteractions)
.set({ createdAt: questionCreatedAt, updatedAt: questionCreatedAt })
.where(eq(issueThreadInteractions.id, question.id));
await db.insert(issueComments).values({
id: randomUUID(),
companyId: fixture.companyId,
issueId: fixture.issueId,
authorUserId: "board-user",
authorType: "user",
body: "Use the high-priority path.",
createdAt: new Date("2026-09-05T12:01:00.000Z"),
updatedAt: new Date("2026-09-05T12:01:00.000Z"),
});
await service.expireRequestConfirmationsSupersededByHistoricalComments({
id: fixture.issueId,
companyId: fixture.companyId,
});
const historicalSettlements = await db
.select()
.from(chatPublications)
.where(
and(
eq(chatPublications.companyId, fixture.companyId),
eq(
sql<string>`${chatPublications.payload}->>'interactionId'`,
question.id,
),
eq(chatPublications.state, "pending"),
),
);
expect(historicalSettlements).toHaveLength(2);
expect(
historicalSettlements.every(
(row) =>
row.payload.card?.body === "Expired: superseded by a newer reply" &&
(row.payload.card.actions ?? []).length === 0,
),
).toBe(true);
});
it("cancels stale-target prompts and settles terminal-issue expirations", async () => {
const fixture = await seedBoundIssue();
const service = issueThreadInteractionService(db);
const documentId = randomUUID();
const revisionId = randomUUID();
const nextRevisionId = randomUUID();
await db.insert(documents).values({
id: documentId,
companyId: fixture.companyId,
title: "Plan",
format: "markdown",
latestBody: "v1",
latestRevisionId: revisionId,
latestRevisionNumber: 1,
});
await db.insert(issueDocuments).values({
companyId: fixture.companyId,
issueId: fixture.issueId,
documentId,
key: "plan",
});
await db.insert(documentRevisions).values({
id: revisionId,
companyId: fixture.companyId,
documentId,
revisionNumber: 1,
title: "Plan",
format: "markdown",
body: "v1",
});
const confirmation = await service.create(
{ id: fixture.issueId, companyId: fixture.companyId },
{
kind: "request_confirmation",
payload: {
version: 1,
prompt: "Apply this plan?",
target: {
type: "issue_document",
issueId: fixture.issueId,
documentId,
key: "plan",
revisionId,
revisionNumber: 1,
},
},
},
{ agentId: fixture.agentId },
);
await service.expireStaleRequestConfirmationsForIssueDocument(
{ id: fixture.issueId, companyId: fixture.companyId },
{
id: documentId,
key: "plan",
latestRevisionId: nextRevisionId,
latestRevisionNumber: 2,
},
{ userId: "board-user" },
);
const stalePublications = await db
.select()
.from(chatPublications)
.where(
and(
eq(chatPublications.companyId, fixture.companyId),
eq(
sql<string>`${chatPublications.payload}->>'interactionId'`,
confirmation.id,
),
),
);
expect(stalePublications).toHaveLength(2);
expect(
stalePublications.every(
(row) =>
row.state === "cancelled" &&
row.redactedError ===
"Interaction was resolved before provider publication",
),
).toBe(true);
const question = await service.create(
{ id: fixture.issueId, companyId: fixture.companyId },
{
kind: "ask_user_questions",
payload: {
version: 1,
questions: [
{
id: "priority",
prompt: "Which priority?",
selectionMode: "single",
allowOther: false,
options: [{ id: "high", label: "High" }],
},
],
},
},
{ agentId: fixture.agentId },
);
await markInteractionCardsPublished(fixture.companyId, question.id);
await service.expirePendingInteractionsForTerminalIssue(
{
id: fixture.issueId,
companyId: fixture.companyId,
status: "done",
},
{ userId: "board-user" },
);
const closedSettlements = await db
.select()
.from(chatPublications)
.where(
and(
eq(chatPublications.companyId, fixture.companyId),
eq(
sql<string>`${chatPublications.payload}->>'interactionId'`,
question.id,
),
eq(chatPublications.state, "pending"),
),
);
expect(closedSettlements).toHaveLength(2);
expect(
closedSettlements.every(
(row) =>
row.payload.text === "Expired: task is closed." &&
row.payload.card?.body === "Expired: task is closed" &&
(row.payload.card.actions ?? []).length === 0,
),
).toBe(true);
});
},
);