Files
PaperClipAI/ui/src/pages/apps/chat/ChatConversationList.tsx
T
DottaandPaperclip 22d05644f4 feat(ui): add Speko voice setup, task calls, and Storybook coverage (#15728)
Runtime #15727 is merged. This PR adds the UI. Qualification follows in
#15729.

## Thinking Path

> - Paperclip manages agent work through tasks and governed connections.
> - Chat connections already bind external conversations to those tasks.
> - Speko handles voice and telephony, while the selected Paperclip
agent does the work.
> - A call needs durable session authority, ordered follow-ups, and safe
result delivery.
> - This PR adds the Speko setup and call controls to the existing Apps
and task UI.
> - This PR depends on #15727. The qualification suite follows
separately. Speko stays experimental.

## Linked Issues or Issue Description

**Problem or motivation**

Phone and browser voice conversations cannot use the chat connection
task lifecycle. A separate voice runtime is needed to preserve task
authority, retries, and reply history.

**Proposed solution**

Add company-scoped voice sessions, signed callbacks, durable replies,
inbound intake, and an agent-facing outbound-call tool. Reuse existing
tasks, queues, secrets, and publications.

**Roadmap alignment**

This extends the experimental chat connector entry points under Agent
Chat and Connected Apps. The project owner requested this feature.

Refs #11418 for the original provider catalog proposal. This
implementation uses the newer chat connection infrastructure rather than
an MCP catalog-only integration. Refs #15721 for remote OpenCode
startup.

## What Changed

- Add the Speko Apps catalog entry, provider artwork, and browser SDK.
- Reuse existing agents in setup. Keep the optional Company Phone Agent
in the catalog, with connection instructions available to any assigned
agent.
- Add task voice controls, transcripts, phone callbacks, inbound-line
settings, and call Activity entries.
- Surface retryable connection and incoming-task inventory failures,
preserve active call controls and cached tasks, restore keyboard focus
after recovery, and bound notification polling so a stuck request cannot
hide later results.
- Put Save & exit and Connect Speko in the credential step’s shared
footer.
- Add deterministic production-component Storybook fixtures for setup,
lifecycle, failures, permissions, and phone surfaces.
- Include voice components in the design guide. Stories never request a
real microphone or place calls.

## Verification

- All 27 focused UI/controller regressions, UI typecheck, token gates,
and 28 map/catalog structural tests pass. The shared connection cache
test covers pause/resume invalidation during the 30-second fresh period.
- Storybook builds 157 Speko production-component stories. The complete
prior 156-story set passed all 624 checks on UI source 249cbc616a. After
the final cache repair, all 152 affected page/launcher checks passed
across both themes, 390/1200 widths and reduced motion. Real microphone
access and external provider requests are blocked.
- Source annotations follow the current generated-catalog contract. No
generated catalog or lockfile is included. Three inherited
GitHub-heading tests passed after master reconciliation.
- Latest-head CI and Greptile review must pass before merge. Local
fixture success does not establish provider or spoken-playback
acceptance.
- The separate integrated browser run passed two journeys and failed
browser answer retrieval. Real browser/telephone playback and timing
acceptance remain outstanding. See the dated qualification report and
E01–E16 runbook. Speko stays experimental.

## Risks

- Voice sessions add migrations and provider-dependent lifecycle
behavior. Migrations preserve existing chat and AI transports.
- Callback origins must be reachable HTTPS. Provider keys and signing
secrets remain vaulted.
- Unverified callers receive task-scoped low-trust authority. Caller ID
does not grant private task access.
- Outbound telephony incurs provider charges. Provider acceptance is not
proof that the caller heard an answer.
- Keep the feature behind the existing experimental chat setting until
the real browser, inbound, outbound, and delayed-result acceptance
matrix passes.

## Model Used

OpenAI Codex, GPT-6, with tool use and code execution. The exact serving
model ID and context window 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 (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
- [ ] 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>
2026-10-13 16:26:38 -05:00

113 lines
3.6 KiB
TypeScript
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
import { MessageSquare } from "lucide-react";
import type { ChatConversation, ChatProvider } from "@/api/chatEndpoints";
import { EmptyState } from "@/components/EmptyState";
import { StatusBadge } from "@/components/StatusBadge";
import { Link } from "@/lib/router";
import { formatDateTime } from "@/lib/utils";
import { AppLogo } from "../AppLogo";
export function conversationDestination(
row: ChatConversation,
provider: ChatProvider,
) {
if (provider === "github" && row.externalUrl) {
try {
const url = new URL(row.externalUrl);
const parts = url.pathname.split("/");
if (
url.hostname === "github.com" &&
["issues", "pull"].includes(parts[3]) &&
/^\d+$/.test(parts[4])
)
return `${parts[1]}/${parts[2]} #${parts[4]}`;
} catch {
/* Preserve the provider label when no thread URL is available. */
}
}
return row.externalLabel;
}
export function ChatConversationList({
rows,
provider,
}: {
rows: ChatConversation[];
provider: ChatProvider;
}) {
if (!rows.length)
return (
<EmptyState
icon={MessageSquare}
message="No conversations yet"
description={
provider === "speko"
? "Open an assigned task and choose Talk to agent."
: provider === "agentmail"
? "Send an email to this agent’s address to start one."
: "Mention the agent in an enabled destination to start one."
}
/>
);
return (
<ul
aria-label="Conversations"
className="divide-y divide-border border-y border-border"
>
{rows.map((row) => (
<li key={row.id} className="flex items-start gap-3 py-4 text-sm">
<AppLogo
name={provider}
brandKey={provider}
compact
className="mt-0.5 size-5! shrink-0 rounded-sm bg-transparent"
/>
<div className="min-w-0 flex-1 space-y-1">
<div className="break-words">
{row.issueIdentifier && (
<span className="mr-2 text-xs text-muted-foreground">
{row.issueIdentifier}
</span>
)}
{row.issueId ? (
<Link
className="break-words font-medium hover:underline"
to={`/issues/${row.issueId}`}
>
{row.issueTitle ?? row.issueIdentifier ?? "Paperclip task"}
</Link>
) : (
<span className="font-medium">
{row.issueTitle ?? "Waiting for task"}
</span>
)}
</div>
<div className="flex flex-wrap items-baseline gap-x-3 gap-y-1 text-xs text-muted-foreground">
{row.externalUrl ? (
<a
href={row.externalUrl}
target="_blank"
rel="noreferrer"
className="break-words hover:text-foreground hover:underline"
>
{conversationDestination(row, provider)}
</a>
) : (
<span className="break-all">{row.externalLabel}</span>
)}
{row.updatedAt && (
<time dateTime={row.updatedAt}>
{formatDateTime(row.updatedAt)}
</time>
)}
{row.state === "completed" && <span>Completed</span>}
</div>
</div>
{row.state !== "active" && row.state !== "completed" && (
<StatusBadge status={row.state} />
)}
</li>
))}
</ul>
);
}