@graph8/sdk 0.362.0 → 0.370.0

package/blocks/deals/components/deal-detail.tsx

@@ -12,7 +12,7 @@
  *   5. DELETE /deals/{id}                      (deals.deleteDeal)       DESTRUCTIVE -> ConfirmSpendDialog first
  * Compose notes, tasks and the activity timeline from the crm block under `children`.
  */
-import { useEffect, useState, type ReactNode } from "react";
+import { useEffect, useRef, useState, type ReactNode } from "react";
 import { Button, Input, Label, Skeleton, Textarea } from "@graph8/sdk/ui";
 import { ApiError } from "@/g8/components/api-error";
 import { ConfirmSpendDialog } from "@/g8/components/confirm-spend-dialog";
@@ -21,6 +21,7 @@ import { useG8Mutation } from "@/g8/hooks/use-g8-mutation";
 import { useG8Query } from "@/g8/hooks/use-g8-query";
 import { usePipelines } from "../hooks/use-pipelines";
 import { dataOf, formatMoney, type Deal } from "../lib/deals-types";
+import { useBrand } from "@/g8/hooks/use-brand";
 
 export interface DealDetailProps {
   /** Edit this deal; omit to create one. */
@@ -53,6 +54,7 @@ function fromDeal(d: Deal): Form {
 }
 
 export function DealDetail({ dealId, ownerId, contactIds = [], pipelineId, allowDuplicate, onSaved, onDeleted, children, className }: DealDetailProps) {
+  const brand = useBrand();
   const { pipelines, defaultPipeline } = usePipelines();
   const [form, setForm] = useState<Form>(EMPTY);
   const [confirmDelete, setConfirmDelete] = useState(false);
@@ -60,14 +62,23 @@ export function DealDetail({ dealId, ownerId, contactIds = [], pipelineId, allow
   const [createdId, setCreatedId] = useState<string | null>(null);
   const [createdRevision, setCreatedRevision] = useState<number | null>(null);
   const effectiveId = dealId ?? createdId ?? undefined;
-  const deal = useG8Query(async (signal) => dataOf<Deal>(await g8Get(`/deals/${encodeURIComponent(dealId as string)}`, undefined, { signal })), [dealId], { enabled: Boolean(dealId) });
-  const history = useG8Query(async (signal) => dataOf<{ items?: HistoryItem[] }>(await g8Get(`/deals/${encodeURIComponent(dealId as string)}/history`, { limit: 20 }, { signal })).items ?? [], [dealId], { enabled: Boolean(dealId) });
-  useEffect(() => { if (deal.data) setForm(fromDeal(deal.data)); }, [deal.data]);
-  // A different deal (or create mode again) must not show the previous one's fields.
-  useEffect(() => { setForm(EMPTY); setCreatedId(null); setCreatedRevision(null); setConfirmDelete(false); }, [dealId]);
+  const deal = useG8Query(async (signal) => dataOf<Deal>(await g8Get(`/deals/${encodeURIComponent(dealId as string)}`, undefined, { signal })), [dealId], {
+    enabled: Boolean(dealId),
+    key: ["deals", "detail", dealId ?? null],
+    // The form is seeded from this record: never swap it under someone typing on a window refocus.
+    refetchOnFocus: false,
+  });
+  const history = useG8Query(async (signal) => dataOf<{ items?: HistoryItem[] }>(await g8Get(`/deals/${encodeURIComponent(dealId as string)}/history`, { limit: 20 }, { signal })).items ?? [], [dealId], { enabled: Boolean(dealId), key: ["deals", "history", dealId ?? null] });
+  // Unsaved edits win over a refreshed record (focus, invalidation from a board move, refetch): only an
+  // untouched form follows the server. Saving or switching deals makes the form untouched again.
+  const dirty = useRef(false);
+  // A different deal (or create mode again) must not show the previous one's fields. Declared BEFORE the
+  // seeding effect so that, when the record is already cached, the reset runs first and the seed wins.
+  useEffect(() => { dirty.current = false; setForm(EMPTY); setCreatedId(null); setCreatedRevision(null); setConfirmDelete(false); }, [dealId]);
+  useEffect(() => { if (deal.data && !dirty.current) setForm(fromDeal(deal.data)); }, [deal.data]);
 
   const pipeline = pipelines.find((p) => p.id === (deal.data?.pipeline_id ?? pipelineId)) ?? defaultPipeline;
-  const set = <K extends keyof Form>(k: K, v: Form[K]) => setForm((f) => ({ ...f, [k]: v }));
+  const set = <K extends keyof Form>(k: K, v: Form[K]) => { dirty.current = true; setForm((f) => ({ ...f, [k]: v })); };
 
   const save = useG8Mutation(async () => {
     const body = {
@@ -81,11 +92,12 @@ export function DealDetail({ dealId, ownerId, contactIds = [], pipelineId, allow
       ? await g8Patch(`/deals/${encodeURIComponent(effectiveId)}`, { ...body, expected_revision: (dealId ? deal.data?.revision : createdRevision) ?? undefined })
       : await g8Post("/deals", { ...body, owner_id: ownerId, contact_ids: contactIds, allow_duplicate: allowDuplicate || undefined, pipeline_id: pipeline?.id, amount: body.amount ?? undefined, close_date: body.close_date ?? undefined });
     return dataOf<Deal>(env);
-  }, { onSuccess: (saved) => { if (!dealId && saved.id) { setCreatedId(saved.id); setCreatedRevision(saved.revision ?? null); } if (dealId) { void deal.refetch(); void history.refetch(); } onSaved?.(saved); } });
-  const remove = useG8Mutation(async () => { await g8Delete(`/deals/${encodeURIComponent(dealId as string)}`); }, { onSuccess: () => { setConfirmDelete(false); onDeleted?.(dealId as string); }, onError: () => setConfirmDelete(false) });
+  }, { invalidates: [["deals", "list"], ["deals", "history"]], onSuccess: (saved) => { dirty.current = false; if (!dealId && saved.id) { setCreatedId(saved.id); setCreatedRevision(saved.revision ?? null); } if (dealId) { void deal.refetch(); void history.refetch(); } onSaved?.(saved); } });
+  const remove = useG8Mutation(async () => { await g8Delete(`/deals/${encodeURIComponent(dealId as string)}`); }, { invalidates: [["deals", "list"]], onSuccess: () => { setConfirmDelete(false); onDeleted?.(dealId as string); }, onError: () => setConfirmDelete(false) });
 
   if (deal.error) return <ApiError error={deal.error} title="Could not load the deal" onRetry={() => void deal.refetch()} />;
-  if (dealId && deal.loading && !deal.data) return <Skeleton className="h-56 w-full" aria-label="Loading deal" />;
+  // The hook keeps the previous deal's data while the next loads: wait for THIS deal, so a blank form is never shown (or saved) over it.
+  if (dealId && (!deal.data || String(deal.data.id) !== String(dealId))) return <Skeleton className="h-56 w-full" aria-label="Loading deal" />;
   const d = deal.data;
   const canCreate = Boolean(ownerId);
 
@@ -105,7 +117,7 @@ export function DealDetail({ dealId, ownerId, contactIds = [], pipelineId, allow
           </div>
         </div>
         <div className="space-y-1"><Label htmlFor="deal-desc">Description</Label><Textarea id="deal-desc" rows={3} value={form.description} onChange={(e) => set("description", e.target.value)} /></div>
-        {!dealId && !canCreate ? <p className="text-sm text-muted-foreground">Pass ownerId (a graph8 user id) to create deals: the API requires an owner.</p> : null}
+        {!dealId && !canCreate ? <p className="text-sm text-muted-foreground">Pass ownerId (a {brand.linkLabel} user id) to create deals: the API requires an owner.</p> : null}
         {save.error ? <ApiError error={save.error} title="Could not save the deal" /> : null}
         {remove.error ? <ApiError error={remove.error} title="Could not delete the deal" /> : null}
         <div className="flex justify-between">

package/blocks/deals/components/deal-related.tsx

@@ -24,7 +24,7 @@ import { dataOf, type Deal } from "../lib/deals-types";
 
 export function DealContactsTab({ dealId }: { dealId: string }) {
   const [open, setOpen] = useState<number | null>(null);
-  const q = useG8Query(async (signal) => dataOf<Deal>(await g8Get(`/deals/${encodeURIComponent(dealId)}`, undefined, { signal })), [dealId]);
+  const q = useG8Query(async (signal) => dataOf<Deal>(await g8Get(`/deals/${encodeURIComponent(dealId)}`, undefined, { signal })), [dealId], { key: ["deals", "detail", dealId] });
   if (q.error) return <ApiError error={q.error} title="Could not load the deal's contacts" onRetry={() => void q.refetch()} />;
   if (!q.data) return <Skeleton className="h-24 w-full" aria-label="Loading contacts" />;
   const contacts = q.data.contacts ?? [];

package/blocks/deals/components/deals-screen.tsx

@@ -43,6 +43,8 @@ import { useG8Query } from "@/g8/hooks/use-g8-query";
 import { ActivityTimeline } from "@/g8/crm/components/activity-timeline";
 import { useDebouncedValue } from "@/g8/crm/hooks/use-debounced";
 import { contactName, type ContactRecord } from "@/g8/crm/lib/crm-types";
+import { rowActivationProps } from "@/g8/hooks/use-row-activation";
+import { RecordLink } from "@/g8/components/screen/record-link";
 import { useDefaultOwner } from "../hooks/use-default-owner";
 import { usePipelineDeals } from "../hooks/use-pipeline-deals";
 import { usePipelines } from "../hooks/use-pipelines";
@@ -52,6 +54,7 @@ import { DealContactsTab, DealQuotesTab } from "./deal-related";
 import { ForecastView } from "./forecast-view";
 import { PipelineBoard } from "./pipeline-board";
 import { StageEditor } from "./stage-editor";
+import { useBrand } from "@/g8/hooks/use-brand";
 
 export interface DealsScreenProps {
   /** Start on this pipeline; defaults to the org's default one. */
@@ -84,6 +87,7 @@ function stageTone(stage: Stage | undefined): "neutral" | "positive" | "negative
 
 /** Contact search + chips for the new-deal sheet. The API requires at least one contact. */
 function ContactPicker({ value, onChange }: { value: ContactRecord[]; onChange: (next: ContactRecord[]) => void }) {
+  const brand = useBrand();
   const [text, setText] = useState("");
   const term = useDebouncedValue(text.trim());
   const found = useG8Query(async (signal) => {
@@ -119,7 +123,7 @@ function ContactPicker({ value, onChange }: { value: ContactRecord[]; onChange:
           </li>
         ))}
       </ul>
-      <p className="text-xs text-muted-foreground">graph8 needs at least one contact on a deal. Every contact must work at the same company.</p>
+      <p className="text-xs text-muted-foreground">{brand.linkLabel} needs at least one contact on a deal. Every contact must work at the same company.</p>
     </div>
   );
 }
@@ -182,8 +186,8 @@ function DealRows({ deals, stages, selectedId, onOpen, renderRowActions }: { dea
         {deals.map((d) => {
           const stage = d.stage_id ? byId.get(d.stage_id) : undefined;
           return (
-            <TableRow key={d.id} data-state={selectedId === d.id ? "selected" : undefined} className="cursor-pointer" onClick={() => onOpen(d)}>
-              <TableCell><button type="button" className="font-medium hover:underline" onClick={(e) => { e.stopPropagation(); onOpen(d); }}>{d.name || "Untitled deal"}</button></TableCell>
+            <TableRow key={d.id} data-state={selectedId === d.id ? "selected" : undefined} className="cursor-pointer" {...rowActivationProps(() => onOpen(d))}>
+              <TableCell><RecordLink param="id" id={d.id} onOpen={() => onOpen(d)}>{d.name || "Untitled deal"}</RecordLink></TableCell>
               <TableCell><StatusPill tone={stageTone(stage)} dot>{stage?.name ?? d.stage_name ?? "Unknown"}</StatusPill></TableCell>
               <TableCell className="text-right tabular-nums">{formatMoney(d.amount, d.currency)}</TableCell>
               <TableCell><span className="inline-flex items-center gap-2"><EntityAvatar name={d.owner_name ?? d.owner_email ?? "?"} size="sm" />{d.owner_name ?? d.owner_email ?? "No owner"}</span></TableCell>
@@ -198,6 +202,7 @@ function DealRows({ deals, stages, selectedId, onOpen, renderRowActions }: { dea
 }
 
 export function DealsScreen({ pipelineId: initialPipelineId, renderRowActions, renderDetailActions, extraDetailTabs, toolbarActions, onOpenQuote }: DealsScreenProps) {
+  const brand = useBrand();
   const [viewParam, setViewParam] = useUrlState("tab", "board");
   const [selectedId, setSelectedId] = useUrlState("id");
   const [mode, setMode] = useUrlState("view");
@@ -228,7 +233,7 @@ export function DealsScreen({ pipelineId: initialPipelineId, renderRowActions, r
 
   const listed = data.deals.find((d) => d.id === selectedId);
   // A deep link can point at a deal in another pipeline or hidden by the search: resolve it directly.
-  const fetched = useG8Query(async (signal) => dataOf<Deal>(await g8Get(`/deals/${encodeURIComponent(selectedId ?? "")}`, undefined, { signal })), [selectedId, version], { enabled: Boolean(selectedId) && !listed && !data.loading });
+  const fetched = useG8Query(async (signal) => dataOf<Deal>(await g8Get(`/deals/${encodeURIComponent(selectedId ?? "")}`, undefined, { signal })), [selectedId, version], { enabled: Boolean(selectedId) && !listed && !data.loading, key: ["deals", "detail", selectedId ?? null] });
   const selected = listed ?? (fetched.data?.id === selectedId ? fetched.data : undefined);
   const open = (id: string) => setSelectedId(id);
   const close = () => { setSelectedId(null); setMode(null); };
@@ -259,7 +264,7 @@ export function DealsScreen({ pipelineId: initialPipelineId, renderRowActions, r
 
   let body: ReactNode;
   if (view === "forecast") body = <ForecastView pipelineId={pipeline?.id} />;
-  else if (view === "stages") body = pipeline ? <div className="space-y-6"><StageSummary stages={stages} deals={data.deals} /><StageEditor pipelineId={pipeline.id} onChanged={refresh} /></div> : <EmptyState title="No pipeline yet" description="Create a pipeline in graph8 first." />;
+  else if (view === "stages") body = pipeline ? <div className="space-y-6"><StageSummary stages={stages} deals={data.deals} /><StageEditor pipelineId={pipeline.id} onChanged={refresh} /></div> : <EmptyState title="No pipeline yet" description={`Create a pipeline in ${brand.linkLabel} first.`} />;
   else body = <SplitView detailOpen={Boolean(selectedId)} onCloseDetail={close} expanded={mode === "full" && Boolean(selectedId)} onExpandedChange={(full) => setMode(full ? "full" : null)} detailWidth="lg" detail={detail} list={view === "board" ? <PipelineBoard key={`${pipeline?.id}-${version}`} pipelineId={pipeline?.id} search={search} onSelectDeal={(d) => open(d.id)} onChanged={() => void data.reload()} /> : list} />;
 
   return (

package/blocks/deals/components/stage-editor.tsx

@@ -45,21 +45,21 @@ export function StageEditor({ pipelineId, onChanged, className }: StageEditorPro
     const saved = dataOf<Stage>(await g8Put(`${base}/stages/${encodeURIComponent(s.id)}`, { name: s.name, probability: s.probability ?? 0, stage_type: s.stage_type ?? "open", color: s.color ?? undefined }));
     done(stages.map((x) => (x.id === saved.id ? { ...x, ...saved } : x)));
     } finally { setSavingId(null); }
-  });
+  }, { invalidates: [["deals", "pipelines"]] });
   const add = useG8Mutation(async (name: string) => {
     const created = dataOf<Stage>(await g8Post(`${base}/stages`, { name, probability: 0, stage_type: "open" }));
     done([...stages, created]);
     setNewName("");
-  });
+  }, { invalidates: [["deals", "pipelines"]] });
   const reorder = useG8Mutation(async (next: Stage[]) => {
     await g8Put(`${base}/stages/reorder`, { stage_ids: next.map((s) => s.id) });
     done(next);
-  });
+  }, { invalidates: [["deals", "pipelines"]] });
   const remove = useG8Mutation(async (s: Stage) => {
     await g8Delete(`${base}/stages/${encodeURIComponent(s.id)}`);
     done(stages.filter((x) => x.id !== s.id));
     setRemoving(null);
-  }, { onError: () => setRemoving(null) });
+  }, { invalidates: [["deals", "pipelines"]], onError: () => setRemoving(null) });
 
   const patch = (id: string, change: Partial<Stage>) => setStages((all) => all.map((s) => (s.id === id ? { ...s, ...change } : s)));
   const swap = (i: number, j: number) => { const next = [...stages]; [next[i], next[j]] = [next[j], next[i]]; void reorder.mutate(next); };

package/blocks/deals/hooks/use-pipeline-deals.ts

@@ -15,6 +15,7 @@
 import { useCallback, useEffect, useState } from "react";
 import { g8Get, g8Patch } from "@/g8/lib/g8-client";
 import { useG8Query } from "@/g8/hooks/use-g8-query";
+import { invalidate } from "@/g8/lib/g8-cache";
 import type { Deal } from "../lib/deals-types";
 import { dataOf } from "../lib/deals-types";
 
@@ -42,7 +43,7 @@ export function usePipelineDeals(pipelineId: string | undefined, filters: Pipeli
       return all.slice(0, maxDeals);
     },
     [pipelineId, filters.search, filters.ownerId, maxDeals],
-    { enabled: Boolean(pipelineId) },
+    { enabled: Boolean(pipelineId), key: ["deals", "list", "board", { pipelineId, search: filters.search || undefined, ownerId: filters.ownerId || undefined, maxDeals }] },
   );
   useEffect(() => { if (query.data) setDeals(query.data); }, [query.data]);
 
@@ -53,6 +54,9 @@ export function usePipelineDeals(pipelineId: string | undefined, filters: Pipeli
     try {
       const saved = dataOf<Deal>(await g8Patch(`/deals/${encodeURIComponent(deal.id)}`, { stage_id: stageId, expected_revision: deal.revision ?? undefined, ...extra }));
       setDeals((all) => all.map((d) => (d.id === deal.id ? { ...d, ...saved } : d)));
+      // The deal's revision changed: a cached detail or history of it is out of date.
+      void invalidate(["deals", "detail"]);
+      void invalidate(["deals", "history"]);
       return saved;
     } catch (err) {
       // Roll back by re-reading the server's truth: a snapshot taken before the move could itself be stale.

package/blocks/deals/hooks/use-pipelines.ts

@@ -13,7 +13,7 @@ export function usePipelines() {
   const q = useG8Query(async (signal) => {
     const env = await g8Get<Pipeline[]>("/deals/pipelines", undefined, { signal });
     return (env.data ?? []).map((p) => ({ ...p, stages: sortedStages(p) }));
-  }, []);
+  }, [], { key: ["deals", "pipelines"] });
   const pipelines = q.data ?? [];
   return { ...q, pipelines, defaultPipeline: pipelines.find((p) => p.is_default) ?? pipelines[0] };
 }

package/blocks/dialer/README.md

@@ -9,6 +9,26 @@ browser, record outcomes, and review transcripts. Copy `DialerWorkspace` for the
 > voicemail, or mints a softphone credential without a confirm dialog first, and the block never auto-advances to
 > the next batch.
 
+## Screens
+
+- `DialerScreen` (`components/dialer-screen.tsx`): **Session** tab picks a list (ListPicker), creates a session (dials
+  nobody), then runs the queue: every batch, voicemail drop, softphone credential and stop is confirmed; finished calls
+  open the outcome panel and transcript. **Sessions** tab lists every session; a row opens `DialerSessionDetail` (stats, details, calls, queue; pause, confirmed resume, confirmed stop; `?tab=sessions&session=<id>`). **History** tab lists the rep's calls. Props are optional: `userId` (needed to
+  enable the browser softphone), `userEmail`, `listId`, `sessionId`, `transport` (default: the Twilio adapter, loaded
+  on demand, needs `@twilio/voice-sdk`). Resume a session with `?session=<id>`. Add `&view=full` to any detail (session, call, and the same in the other screens) to open it as a full page.
+- `CallLogScreen` (`components/call-log-screen.tsx`): history of one rep, contact or session with outcome filter and search;
+  open a call for recording, transcript and AI grade (`?id=<room_name>`), and **Call back** the number (`CallContactButton`). Needs a rep email (it asks) or a prop.
+- Slots on both: `toolbarActions`, `renderRowActions`, `renderDetailActions`, `extraDetailTabs`.
+- `CallContactButton` (`components/call-contact-button.tsx`): **call one contact from any screen**. Drop it into a
+  contact page's `renderDetailActions` (the apollo and outreach stacks do) or a row slot: `<CallContactButton contact={c} />`.
+  Closed, it loads nothing. Open: pick the number (masked `***` numbers are never offered), a PAUSED or COMPLETED
+  session to log the call under, and the caller ID; turn on the softphone; confirm (external, 1 recipient). It calls
+  `POST /dialer/parallel-calls/manual-dial` and the softphone joins the returned `conference_name`. The rep is
+  `userId` if passed, else the personal key's user (`GET /team-members/me`); an organisation key is not a rep, so it
+  then asks for `userId`. Why not `next-batch` with `force_next_contact`: that only picks a contact already in the
+  session's list and dials a whole batch.
+Scopes: `voice:read`, `voice:write`, `voice:run` (and `team:read` for `CallContactButton` without `userId`). A phone number must exist (buy or verify it in the graph8 app).
+
 ## How it works (read this before building)
 
 - graph8 places the calls **from its servers** into a conference. The rep's browser only **joins that
@@ -81,13 +101,22 @@ and the call log for a rep email. Pass `userId` / `userEmail` from your session
 - Voicemail drop plays the rep's cloned voice to a stranger's phone. The confirm dialog names the contact.
 - Another tenant's session id is a 404, the same as a missing one.
 - Manual dial (`POST /dialer/parallel-calls/manual-dial`, external) needs a PAUSED or COMPLETED session and can
-  create a contact; it is a server recipe here, not a component.
+  create a contact (an unknown number is matched to a contact or one is created). `CallContactButton` uses it.
+- **Late join.** The conference name of a batch is only known from the `next-batch` (or `manual-dial`) response; the
+  app learns the NEXT batch's name earlier over a WebSocket the API does not have, and the session read does not
+  expose it. Voice waits up to 2 s for the rep only when the name was announced, so an SDK softphone joins after the
+  dials go out and the first second of an instant answer can be missed (voice's late-join reconciliation still
+  connects the audio). Keep the softphone registered BEFORE dialing (`CallContactButton` only enables the call once
+  it is ready) so the join is a single `joinConference` the moment the response lands.
+- `next-batch` `user_email`: with a personal key the dialer's rep is the key's own user (naming someone else is a
+  403); with an organisation key the name is passed through but not vouched for, so voice keeps dialing without
+  moving the session to that rep.
 
 ## Operations
 
 | Operation | Method and path | Tier | Used by |
 |---|---|---|---|
-| `voice.listDialerNumbers` | GET /voice/dialer/numbers | read | SessionStartForm |
+| `voice.listDialerNumbers` | GET /voice/dialer/numbers | read | SessionStartForm, CallContactButton |
 | `dialer.createSessionDraft` | POST /dialer/sessions/draft | write | SessionStartForm |
 | `dialer.readQueueStats` | GET /dialer/sessions/{id}/queue-stats | read | useDialerSession |
 | `voice.getDialerSession` | GET /dialer/sessions/{id} | read | useDialerSession |
@@ -106,6 +135,9 @@ and the call log for a rep email. Pass `userId` / `userEmail` from your session
 | `voice.getCallTranscript` | GET /voice/dialer/calls/{room}/transcript | read | TranscriptViewer |
 | `voice.getCallGrading` | GET /voice/dialer/calls/{room}/grading | read | TranscriptViewer |
 | `voice.downloadCallRecording` | GET /voice/calls/{id}/recording | read | TranscriptViewer |
+| `teamMembers.getMyTeamMember` | GET /team-members/me | read | CallContactButton (only without `userId`) |
+| `voice.listDialerSessions` | GET /voice/dialer/sessions | read | CallContactButton |
+| `dialer.manualDial` | POST /dialer/parallel-calls/manual-dial | external | CallContactButton |
 
 ## Recipes (server side)
 

package/blocks/dialer/block.json

@@ -21,15 +21,19 @@
     "get_call_grading_voice_dialer_calls__room_name__grading_get",
     "get_call_transcript_voice_dialer_calls__room_name__transcript_get",
     "get_dialer_session_dialer_sessions__session_id__get",
+    "get_my_team_member_team_members_me_get",
     "hangup_session_call_dialer_sessions_calls_hangup_post",
     "list_calls_for_contact_voice_dialer_calls_get",
     "list_dialer_numbers_voice_dialer_numbers_get",
+    "list_dialer_sessions_voice_dialer_sessions_get",
     "list_voice_dispositions_voice_dispositions_get",
+    "manual_dial_dialer_parallel_calls_manual_dial_post",
     "mint_softphone_token_dialer_sessions_token_get",
     "mute_call_dialer_sessions_calls_mute_post",
     "pause_dialer_session_dialer_sessions__session_id__pause_post",
     "read_queue_stats_dialer_sessions__session_id__queue_stats_get",
     "read_session_grid_dialer_sessions__session_id__grid_post",
+    "resume_dialer_session_voice_dialer_sessions__session_id__resume_post",
     "set_call_disposition_dialer_parallel_calls_calls__livekit_room_name__disposition_patch",
     "skip_contact_dialer_sessions__session_id__calls_skip_contact_post",
     "stop_dialer_session_dialer_sessions__session_id__stop_post"
@@ -135,6 +139,61 @@
       "purpose": "The whole rep screen wiring queue, softphone, outcome panel and transcript together.",
       "operations": [],
       "tiers": []
+    },
+    {
+      "name": "DialerScreen",
+      "file": "components/dialer-screen.tsx",
+      "purpose": "Finished calling page: pick a list, run a session, softphone, outcomes, transcript and history.",
+      "operations": [
+        "get_dialer_session_dialer_sessions__session_id__get",
+        "list_dialer_sessions_voice_dialer_sessions_get"
+      ],
+      "tiers": [
+        "read"
+      ]
+    },
+    {
+      "name": "CallLogScreen",
+      "file": "components/call-log-screen.tsx",
+      "purpose": "Finished call history page with outcome filter, recording, transcript and AI grade, and Call back on a call (CallContactButton, confirmed); also exports CallHistory.",
+      "operations": [
+        "list_calls_for_contact_voice_dialer_calls_get"
+      ],
+      "tiers": [
+        "read"
+      ]
+    },
+    {
+      "name": "DialerSessionDetail",
+      "file": "components/dialer-session-detail.tsx",
+      "purpose": "One dialing session as a full record: stats, details, calls and queue, with pause, confirmed resume and confirmed stop.",
+      "operations": [
+        "get_dialer_session_dialer_sessions__session_id__get",
+        "pause_dialer_session_dialer_sessions__session_id__pause_post",
+        "read_queue_stats_dialer_sessions__session_id__queue_stats_get",
+        "resume_dialer_session_voice_dialer_sessions__session_id__resume_post",
+        "stop_dialer_session_dialer_sessions__session_id__stop_post"
+      ],
+      "tiers": [
+        "read",
+        "write",
+        "external"
+      ]
+    },
+    {
+      "name": "CallContactButton",
+      "file": "components/call-contact-button.tsx",
+      "purpose": "Call one contact from any screen (contact page, table row): pick the number, a paused or completed session and the caller ID, turn on the softphone, confirm (external), and the softphone joins the call.",
+      "operations": [
+        "get_my_team_member_team_members_me_get",
+        "list_dialer_sessions_voice_dialer_sessions_get",
+        "list_dialer_numbers_voice_dialer_numbers_get",
+        "manual_dial_dialer_parallel_calls_manual_dial_post"
+      ],
+      "tiers": [
+        "read",
+        "external"
+      ]
     }
   ],
   "hooks": [
@@ -222,6 +281,7 @@
     }
   ],
   "scopes": [
+    "team:read",
     "voice:read",
     "voice:run",
     "voice:write"
@@ -251,10 +311,16 @@
       "decision": "Browser audio vendor for the Softphone",
       "default": "Twilio via lib/twilio-transport.ts; graph8's dialer runs on Twilio conferences. For another vendor write a SoftphoneTransport and delete twilio-transport.ts",
       "askHuman": true
+    },
+    {
+      "decision": "How a single contact is called outside a dialing session",
+      "default": "manual-dial under a PAUSED or COMPLETED session the rep picks (same call log and analytics), only once the softphone is ready; the rep is the personal key's user unless userId is passed",
+      "askHuman": false
     }
   ],
   "peerDependencies": {
     "react": ">=18",
-    "@twilio/voice-sdk": "^2.18.5"
+    "@twilio/voice-sdk": "^2.18.5",
+    "lucide-react": ">=0.400.0"
   }
 }