mirror of
https://github.com/paperclipai/paperclip.git
synced 2026-10-06 21:05:21 +02:00
## Thinking Path > - Paperclip is the open source app people use to manage AI agents for work. > - Conversations must use the same tasks, controls, and execution history. > - Users need an ongoing chat with an agent without managing task properties. > - Agents should clarify and plan work, then hand execution to assigned project tasks. > - This pull request combines the reviewed Agent Chat stack for one squash merge. > - The benefit is persistent conversation with normal task governance and shared UI. ## Linked Issues or Issue Description **Subsystem affected** Task lifecycle, agent runtime tools, shared task UI, and browser/paid runner tests. **Problem or motivation** Users need one persistent conversation with each agent. A separate chat store or renderer would duplicate task behavior and bypass existing controls. **Proposed solution** Use a task-backed chat per company, user, and agent. Reuse the task composer and transcript. Clarify and plan in chat, then create assigned project tasks with the relevant plan. Keep Agent Chat behind its own disabled-by-default experimental setting. **Roadmap alignment** This implements the task-backed direction in [CEO Chat](https://github.com/paperclipai/paperclip/blob/master/ROADMAP.md#-ceo-chat). Related proposals: #2504 and #9693. Related request: #7981. The maintainer requested one squash merge of the complete stack. Consolidates the reviewed runtime [#13281](https://github.com/paperclipai/paperclip/pull/13281), backend [#13282](https://github.com/paperclipai/paperclip/pull/13282), and UI [#13283](https://github.com/paperclipai/paperclip/pull/13283) layers with this PR's E2E coverage. All four layers passed CI and received Greptile 5/5 before consolidation. This PR targets master and includes the complete feature. ## What Changed - Add personal canonical chat tasks with ordinary company visibility, immutable identity, idempotent first sends, and an idle waiting state. - Process `/new` in queue order. Preserve history, release a chat pause, and fence old provider context and delayed writes. - Keep chat lifecycle rules across recovery, finalization, assignment, task lists, and rollups. - Support research and plan revision in chat. Hand plans to ordinary assigned project tasks before execution starts. Reject new chat subtasks. - Add repository-aware project creation and discovery tools, including multiple repository IDs and GitHub URLs, authorization, idempotency, and durable project-created cards. - Reuse task UI components for chat, with starred/recent agent navigation and a separate `enableAgentChat` experimental flag. - Add deterministic browser tests and 24 paid chat cells across four Codex/Claude profiles, with validated reports and screenshots. - Integrate current master recovery, controller lease, queued-message, and task UI changes. Gate chat interruption and deferred promotion on ownership/feature policy. Guarantee lease renewal and active controls are stopped even if teardown fails. - Preserve master's migration 0273 and generate chat migration 0274 with idempotent replay for development databases. ## Verification - Prior exact heads of all four PRs passed Linux CI, including build, typecheck, general/serialized tests, and browser E2E. Each had Greptile 5/5 and no unresolved findings. - Integrated local verification passed: full repository typecheck and production build, Storybook build, token gates, 340 focused UI tests, all 20 deterministic chat browser tests, two migration replay tests, 88 focused chat/queue/native/controller tests, and provider/session regressions including real lease expiry. These include the three lifecycle regressions for the final admission/teardown fixes; server typecheck also passes. Current head `1268eda16cc2af892055917e7292f068820be135` has Greptile 5/5 with no unresolved findings and passing security scans. All final-head CI gates passed: build, full Runner verification, typecheck/release registry, canary, all general/serialized test shards, and all browser E2E shards ([CI run](https://github.com/paperclipai/paperclip/actions/runs/34696739927)). Local PostgreSQL startup contention required serialized retries; skipped fixtures do not count as passing coverage. - The earlier paid campaign passed all 24 chat cells and retained 32 screenshots: [report](https://d1p6rlowie26tp.cloudfront.net/runner-e2e/campaigns/gha-34648511170-1/index.html?report=agent-chat#suite-agent-chat). It tested `abacbdfd2f660709ec37312cdb758284c8399d04`; it is prior evidence, not a paid run of this integrated head. - Manual check: enable Agent Chat in Experimental settings, open an agent, clarify and revise a plan, then hand off to an assigned project task. Stop a reply, send `/new`, and verify fresh context with retained history. Disable the setting and verify agent shortcuts/new chat turns are blocked. ## Risks - Queue/session integration can affect retries and delayed writes. Tests cover ownership, cancellation, reset boundaries, idle recovery, and ordinary task behavior. - Migration 0274 adds conversation fields and constraints. Replay is idempotent and preserves existing development chat history. - This combines the previously reviewed stack at the maintainer's request. Agent Chat remains off by default and is separate from Conference Room. ## Model Used OpenAI Codex, GPT-6 Astra (`gpt-6-astra`), with reasoning, code execution, browser tools, and parallel review. The exact context-window size is not exposed in this session. Codex and Claude also ran as test subjects in the linked paid campaign. ## 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 (a) linked existing issues with `Fixes: #` / `Closes #` / `Refs #` OR (b) described the issue in-PR following the relevant issue template - [x] I have not referenced internal/instance-local Paperclip issues or links (only public GitHub `#NNN` / `github.com/paperclipai/paperclip` URLs) - [x] My branch name describes the change (e.g. `docs/...`, `fix/...`) and contains no internal Paperclip ticket id or instance-derived details - [x] I have run 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 - [x] Greptile is 5/5 with no open P2s, recommendations, or follow-ups - [x] I will address all Greptile and reviewer comments before requesting merge --------- Co-authored-by: Paperclip <noreply@paperclip.ing>
163 lines
6.3 KiB
TypeScript
163 lines
6.3 KiB
TypeScript
import { discoverReportCatalog } from "./report-catalog.js";
|
|
import path from "node:path";
|
|
import { mkdir } from "node:fs/promises";
|
|
import { chromium } from "@playwright/test";
|
|
import { runnerMatrix } from "./catalog.js";
|
|
import type { RunnerE2ECampaign } from "./types.js";
|
|
|
|
const MAX_PUBLIC_EXECUTION_DURATION_MS = 24 * 60 * 60 * 1_000;
|
|
|
|
function html(value: unknown) {
|
|
return String(value ?? "")
|
|
.replaceAll("&", "&")
|
|
.replaceAll("<", "<")
|
|
.replaceAll(">", ">")
|
|
.replaceAll('"', """)
|
|
.replaceAll("'", "'");
|
|
}
|
|
|
|
function durationLabel(durationMs: number) {
|
|
const seconds = Math.round(durationMs / 1_000);
|
|
if (seconds < 60) return `${seconds}s`;
|
|
const minutes = Math.floor(seconds / 60);
|
|
if (minutes < 60) return `${minutes}m ${seconds % 60}s`;
|
|
return `${Math.floor(minutes / 60)}h ${minutes % 60}m`;
|
|
}
|
|
|
|
export function renderPublicCampaignSummary(campaign: RunnerE2ECampaign) {
|
|
const catalog = discoverReportCatalog({
|
|
catalog: runnerMatrix,
|
|
expected: campaign.expected,
|
|
results: campaign.results,
|
|
});
|
|
const catalogById = new Map(
|
|
catalog.map((execution) => [execution.id, execution]),
|
|
);
|
|
const expectedIds = [
|
|
...new Set(
|
|
campaign.expected.filter((executionId) => catalogById.has(executionId)),
|
|
),
|
|
];
|
|
const expectedIdSet = new Set(expectedIds);
|
|
const resultById = new Map(
|
|
campaign.results
|
|
.filter((result) => expectedIdSet.has(result.executionId))
|
|
.map((result) => [result.executionId, result]),
|
|
);
|
|
const isPassed = (executionId: string) => {
|
|
const result = resultById.get(executionId);
|
|
return result?.status === "passed" && result.cleanup === "passed";
|
|
};
|
|
const passed = expectedIds.filter(isPassed).length;
|
|
const durationMs = [...resultById.values()].reduce(
|
|
(total, result) =>
|
|
total +
|
|
(Number.isFinite(result.durationMs) && result.durationMs >= 0
|
|
? Math.min(result.durationMs, MAX_PUBLIC_EXECUTION_DURATION_MS)
|
|
: 0),
|
|
0,
|
|
);
|
|
const suites = [
|
|
...new Map(
|
|
catalog.map((execution) => [execution.suite.id, execution.suite.label]),
|
|
),
|
|
].map(([suiteId, label]) => {
|
|
const selectedIds = expectedIds.filter(
|
|
(executionId) => catalogById.get(executionId)?.suite.id === suiteId,
|
|
);
|
|
return {
|
|
label,
|
|
selected: selectedIds.length,
|
|
passed: selectedIds.filter(isPassed).length,
|
|
};
|
|
});
|
|
const rows = suites
|
|
.filter((suite) => suite.selected > 0)
|
|
.map(
|
|
(suite) => `<div class="suite">
|
|
<span>${html(suite.label)}</span>
|
|
<strong>${suite.passed}/${suite.selected}</strong>
|
|
<em>${suite.passed === suite.selected ? "Passed" : "Needs attention"}</em>
|
|
</div>`,
|
|
)
|
|
.join("");
|
|
|
|
return `<!doctype html>
|
|
<html lang="en">
|
|
<head>
|
|
<meta charset="utf-8">
|
|
<style>
|
|
* { box-sizing: border-box; }
|
|
body { width: 1400px; min-height: 780px; margin: 0; padding: 70px; color: #11110f; background: #f4f1e8; font: 24px/1.35 ui-sans-serif, system-ui, sans-serif; }
|
|
header { display: flex; align-items: center; justify-content: space-between; padding-bottom: 42px; border-bottom: 2px solid #cbc6b8; }
|
|
.brand { display: flex; align-items: center; gap: 16px; font-weight: 750; letter-spacing: -.03em; }
|
|
.mark { width: 44px; height: 44px; display: grid; place-items: center; border: 3px solid #11110f; border-radius: 50%; font-size: 24px; }
|
|
.campaign { color: #5f5b52; font: 600 18px/1.3 ui-monospace, monospace; }
|
|
main { padding-top: 54px; }
|
|
.eyebrow { margin: 0 0 10px; color: #676157; font: 700 16px/1.2 ui-monospace, monospace; letter-spacing: .09em; text-transform: uppercase; }
|
|
h1 { margin: 0; font-size: 66px; line-height: 1; letter-spacing: -.055em; }
|
|
.metrics { display: grid; grid-template-columns: repeat(3, 1fr); gap: 18px; margin: 46px 0; }
|
|
.metric { padding: 26px; border: 2px solid #cbc6b8; border-radius: 18px; background: #fffdf7; }
|
|
.metric strong, .metric span { display: block; }
|
|
.metric strong { font: 750 44px/1 ui-monospace, monospace; }
|
|
.metric span { margin-top: 10px; color: #676157; font-size: 16px; text-transform: uppercase; letter-spacing: .07em; }
|
|
.suites { display: grid; gap: 12px; }
|
|
.suite { display: grid; grid-template-columns: 1fr 120px 190px; align-items: center; padding: 17px 22px; border-top: 1px solid #cbc6b8; }
|
|
.suite strong { font: 700 22px/1 ui-monospace, monospace; }
|
|
.suite em { color: #676157; font-size: 17px; font-style: normal; text-align: right; }
|
|
footer { margin-top: 44px; color: #676157; font-size: 15px; }
|
|
</style>
|
|
</head>
|
|
<body>
|
|
<header><div class="brand"><span class="mark">P</span><span>Paperclip</span></div><div class="campaign">Trusted history publication</div></header>
|
|
<main>
|
|
<p class="eyebrow">Runner full-stack E2E</p>
|
|
<h1>Campaign summary</h1>
|
|
<section class="metrics">
|
|
<div class="metric"><strong>${passed}/${expectedIds.length}</strong><span>Selected executions passed</span></div>
|
|
<div class="metric"><strong>${expectedIds.length - passed}</strong><span>Failed or incomplete</span></div>
|
|
<div class="metric"><strong>${html(durationLabel(durationMs))}</strong><span>Total test time</span></div>
|
|
</section>
|
|
<section class="suites">${rows}</section>
|
|
<footer>Generated from trusted catalog labels, validated execution identities, and sanitized numeric/status fields. Provider output is never rendered here.</footer>
|
|
</main>
|
|
</body>
|
|
</html>`;
|
|
}
|
|
|
|
export async function writePublicCampaignSummaryImage(
|
|
campaign: RunnerE2ECampaign,
|
|
output: string,
|
|
) {
|
|
await mkdir(path.dirname(output), { recursive: true });
|
|
const browser = await chromium.launch({
|
|
headless: true,
|
|
env: {
|
|
LANG: "C.UTF-8",
|
|
PATH: process.env.PATH ?? "",
|
|
TMPDIR: process.env.RUNNER_TEMP ?? "/tmp",
|
|
},
|
|
});
|
|
try {
|
|
const context = await browser.newContext({
|
|
viewport: { width: 1400, height: 900 },
|
|
deviceScaleFactor: 1,
|
|
});
|
|
await context.setOffline(true);
|
|
await context.route("**/*", (route) => route.abort());
|
|
const page = await context.newPage();
|
|
await page.setContent(renderPublicCampaignSummary(campaign), {
|
|
waitUntil: "domcontentloaded",
|
|
});
|
|
await page.screenshot({
|
|
path: output,
|
|
type: "png",
|
|
fullPage: true,
|
|
animations: "disabled",
|
|
});
|
|
await context.close();
|
|
} finally {
|
|
await browser.close();
|
|
}
|
|
}
|