@agent-native/core 0.190.0 → 0.191.0-nightly-20260926043001

package/corpus/README.md

@@ -31,4 +31,4 @@ rg -n "defineAction|useActionQuery" node_modules/@agent-native/core/corpus
 
 ## Generated Counts
 
-- template files: 10001
+- template files: 10028

package/corpus/templates/assets/agent-native.json

@@ -3,7 +3,7 @@
   "onboarding": {
     "firstRun": {
       "development": "off",
-      "production": "connect-and-integrations"
+      "production": "connect"
     }
   },
   "doctor": {

package/corpus/templates/calendar/app/hooks/use-bookings.ts

@@ -28,15 +28,17 @@ export function useAvailableSlots(
   duration: number,
   slug?: string,
   draft?: BookingAvailabilityPreview,
+  username?: string,
 ) {
   const draftParam = draft ? JSON.stringify(draft) : undefined;
 
   return useQuery<{ start: string; end: string }[]>({
-    queryKey: ["available-slots", date, duration, slug, draftParam],
+    queryKey: ["available-slots", date, duration, slug, draftParam, username],
     queryFn: async () => {
       const params = new URLSearchParams({ date, duration: String(duration) });
       if (slug) params.set("slug", slug);
       if (draftParam) params.set("draft", draftParam);
+      if (username) params.set("username", username);
       const res = await fetch(
         appApiPath(`/api/bookings/available-slots?${params}`),
       );
@@ -55,10 +57,11 @@ export function useAvailableDays(
   to: string,
   duration: number,
   slug?: string,
+  username?: string,
   enabled = true,
 ) {
   return useQuery<string[]>({
-    queryKey: ["available-days", from, to, duration, slug],
+    queryKey: ["available-days", from, to, duration, slug, username],
     queryFn: async () => {
       const params = new URLSearchParams({
         from,
@@ -66,6 +69,7 @@ export function useAvailableDays(
         duration: String(duration),
       });
       if (slug) params.set("slug", slug);
+      if (username) params.set("username", username);
       const res = await fetch(
         appApiPath(`/api/bookings/available-slots?${params}`),
       );

package/corpus/templates/calendar/app/hooks/use-public-data.ts

@@ -16,12 +16,13 @@ export function usePublicSettings() {
 }
 
 /** Fetches availability from the public (unauthenticated) endpoint */
-export function usePublicAvailability(slug?: string) {
+export function usePublicAvailability(slug?: string, username?: string) {
   return useQuery<AvailabilityConfig>({
-    queryKey: ["public-availability", slug],
+    queryKey: ["public-availability", slug, username],
     queryFn: async () => {
       const params = new URLSearchParams();
       if (slug) params.set("slug", slug);
+      if (username) params.set("username", username);
       const path = params.size
         ? `/api/public/availability?${params}`
         : "/api/public/availability";

package/corpus/templates/calendar/app/pages/BookingPage.tsx

@@ -79,7 +79,7 @@ function BookingPageShell({
         <LanguagePicker variant="ghost-icon" />
         <ThemeToggle />
       </div>
-      <div className="fixed bottom-[21px] left-4 z-50 max-sm:static max-sm:mx-auto max-sm:mt-8 [&_.an-powered-logo]:!h-3.5 [&_.an-powered-logo]:brightness-0 dark:[&_.an-powered-logo]:invert">
+      <div className="fixed bottom-[21px] left-4 z-50 max-sm:static max-sm:mx-auto max-sm:pt-8 [&_.an-powered-logo]:!h-3.5 [&_.an-powered-logo]:brightness-0 dark:[&_.an-powered-logo]:invert">
         <PoweredByBadge variant="plain" embedded />
       </div>
       <div className="relative z-10 min-h-screen overflow-x-hidden p-4">
@@ -96,7 +96,7 @@ export default function BookingPage() {
   const navigate = useNavigate();
   const { data: settings, isLoading: settingsLoading } = usePublicSettings();
   const { data: availability, isLoading: availabilityLoading } =
-    usePublicAvailability(slug);
+    usePublicAvailability(slug, username);
   const {
     data: bookingLink,
     isLoading: bookingLinkLoading,
@@ -233,7 +233,7 @@ export default function BookingPage() {
     data: slots = [],
     isLoading: slotsLoading,
     error: slotsError,
-  } = useAvailableSlots(dateStr, duration, slug);
+  } = useAvailableSlots(dateStr, duration, slug, undefined, username);
   const monthStart = format(startOfMonth(viewMonth), "yyyy-MM-dd");
   const monthEnd = format(endOfMonth(viewMonth), "yyyy-MM-dd");
   const {
@@ -245,6 +245,7 @@ export default function BookingPage() {
     monthEnd,
     duration,
     slug,
+    username,
     step === "date" &&
       !!availability &&
       (!hasDurationChoice || selectedDuration !== null),

package/corpus/templates/calendar/changelog/2026-09-25-personal-booking-pages-use-the-host-s-saved-timezone-for-ava.md

@@ -0,0 +1,6 @@
+---
+type: fixed
+date: 2026-09-25
+---
+
+Personal booking pages use the host's saved timezone for availability.

package/corpus/templates/calendar/server/handlers/availability.ts

@@ -8,12 +8,14 @@ import { eq } from "drizzle-orm";
 import {
   defineEventHandler,
   getQuery,
+  createError,
   setResponseStatus,
   type H3Event,
 } from "h3";
 
 import type { AvailabilityConfig } from "../../shared/api.js";
 import { getDb, schema } from "../db/index.js";
+import { getBookingUsernameOwner } from "./booking-usernames.js";
 
 function createDefaultAvailability(timezone: string): AvailabilityConfig {
   return {
@@ -66,6 +68,7 @@ export const getPublicAvailability = defineEventHandler(
   async (event: H3Event) => {
     const query = getQuery(event);
     const slug = typeof query.slug === "string" ? query.slug : "";
+    const username = typeof query.username === "string" ? query.username : "";
     if (slug) {
       const link = await getDb()
         .select({ ownerEmail: schema.bookingLinks.ownerEmail })
@@ -86,12 +89,40 @@ export const getPublicAvailability = defineEventHandler(
           ownerSettings?.timezone || "America/New_York",
         );
       }
+
+      if (username) {
+        const ownerEmail = await getBookingUsernameOwner(username);
+        if (!ownerEmail) {
+          throw createError({
+            statusCode: 404,
+            statusMessage: "Booking page not found",
+          });
+        }
+
+        const ownerConfig = (await getUserSetting(
+          ownerEmail,
+          "calendar-availability",
+        )) as unknown as AvailabilityConfig | null;
+        if (ownerConfig?.bookingPageSlug === slug) return ownerConfig;
+        if (!ownerConfig && slug === "book") {
+          const ownerSettings = (await getUserSetting(
+            ownerEmail,
+            "calendar-settings",
+          )) as { timezone?: string } | null;
+          return createDefaultAvailability(
+            ownerSettings?.timezone || "America/New_York",
+          );
+        }
+
+        throw createError({
+          statusCode: 404,
+          statusMessage: "Booking page not found",
+        });
+      }
     }
 
-    // Fall back to defaults — never read the unscoped `calendar-availability`
-    // setting. That key was historically dual-written by every user's update
-    // (see the matching fix in updateAvailability), which meant a brand-new
-    // user's public booking link advertised whoever last saved their hours.
+    // Username-scoped pages fail closed above; legacy links without a username
+    // still use defaults and never read the unscoped availability setting.
     return createDefaultAvailability("America/New_York");
   },
 );

package/corpus/templates/calendar/server/handlers/booking-usernames.ts

@@ -64,6 +64,12 @@ async function findUsernameOwner(username: string): Promise<string | null> {
   return row?.ownerEmail ?? null;
 }
 
+export function getBookingUsernameOwner(
+  username: string,
+): Promise<string | null> {
+  return findUsernameOwner(username);
+}
+
 async function chooseAvailableUsername(
   base: string,
   ownerEmail: string,

package/corpus/templates/calendar/server/handlers/bookings.ts

@@ -61,6 +61,7 @@ import { getOwnerBookingTimeZone } from "../lib/booking-timezone.js";
 import { eventBlocksAvailability } from "../lib/calendar-availability.js";
 import * as googleCalendar from "../lib/google-calendar.js";
 import { createZoomMeeting } from "../lib/zoom.js";
+import { getBookingUsernameOwner } from "./booking-usernames.js";
 
 async function requireRequestContext<T>(
   event: H3Event,
@@ -598,10 +599,12 @@ function unavailableAvailabilityResponse(event: H3Event) {
 
 async function resolveAvailabilityContext({
   slug,
+  username,
   draft,
   db = getDb(),
 }: {
   slug: string;
+  username?: string;
   draft?: BookingAvailabilityDraft;
   db?: ConflictDb;
 }): Promise<AvailabilityContext> {
@@ -634,26 +637,42 @@ async function resolveAvailabilityContext({
     });
   }
   const config = configRaw as unknown as AvailabilityConfig | null;
-  const ownerEmail = bookingLink?.ownerEmail;
+  const usernameOwnerEmail =
+    !bookingLink && username && !draft
+      ? await getBookingUsernameOwner(username)
+      : null;
+  const candidateOwnerEmail = bookingLink?.ownerEmail || usernameOwnerEmail;
+  const [candidateOwnerConfigRaw, candidateOwnerSettingsRaw] =
+    candidateOwnerEmail
+      ? await Promise.all([
+          getUserSetting(candidateOwnerEmail, "calendar-availability"),
+          getUserSetting(candidateOwnerEmail, "calendar-settings"),
+        ])
+      : [null, null];
+  const candidateOwnerConfig =
+    candidateOwnerConfigRaw as AvailabilityConfig | null;
+  const usernameSlugMatches =
+    !usernameOwnerEmail ||
+    candidateOwnerConfig?.bookingPageSlug === slug ||
+    (!candidateOwnerConfig && slug === "book");
+  const ownerEmail =
+    bookingLink?.ownerEmail ||
+    (usernameSlugMatches ? usernameOwnerEmail || undefined : undefined);
   const overrides = bookingLink
     ? resolveBookingLinkAvailabilityOverrides({ bookingLink, draft })
     : undefined;
   const hostEmails = overrides?.hostEmails ?? (ownerEmail ? [ownerEmail] : []);
-  const [ownerConfigRaw, ownerSettingsRaw, conflictSlugs] = await Promise.all([
-    ownerEmail
-      ? getUserSetting(ownerEmail, "calendar-availability")
-      : Promise.resolve(null),
-    ownerEmail
-      ? getUserSetting(ownerEmail, "calendar-settings")
-      : Promise.resolve(null),
-    ownerEmail
-      ? getBookingLinkSlugsForOwners(hostEmails, db)
-      : slug
-        ? Promise.resolve([slug])
-        : Promise.resolve([]),
-  ]);
-  const ownerConfig = ownerConfigRaw as unknown as AvailabilityConfig | null;
-  const ownerSettings = ownerSettingsRaw as { timezone?: string } | null;
+  const ownerConfig = ownerEmail ? candidateOwnerConfig : null;
+  const ownerSettings = ownerEmail
+    ? (candidateOwnerSettingsRaw as { timezone?: string } | null)
+    : null;
+  const conflictSlugs = ownerEmail
+    ? await getBookingLinkSlugsForOwners(hostEmails, db).then((slugs) =>
+        Array.from(new Set([slug, ...slugs])),
+      )
+    : slug
+      ? [slug]
+      : [];
   const eligibleHosts = await getEligibleHostAvailability(
     ownerEmail,
     hostEmails,
@@ -666,7 +685,9 @@ async function resolveAvailabilityContext({
         ? createDefaultAvailability(
             ownerSettings?.timezone || "America/New_York",
           )
-        : config),
+        : username
+          ? null
+          : config),
     ownerEmail,
     hostEmails,
     eligibleHosts,
@@ -1700,6 +1721,7 @@ async function getAvailableSlotsForQuery(
   const to = parseDateOnly(query.to);
   const hasRangeQuery = query.from !== undefined || query.to !== undefined;
   const slug = typeof query.slug === "string" ? query.slug : "";
+  const username = typeof query.username === "string" ? query.username : "";
 
   if (hasRangeQuery) {
     if (!from || !to) {
@@ -1724,7 +1746,7 @@ async function getAvailableSlotsForQuery(
     return { error: "date query parameter is required" };
   }
 
-  const context = await resolveAvailabilityContext({ slug, draft });
+  const context = await resolveAvailabilityContext({ slug, username, draft });
   if (!context.effectiveConfig) {
     return hasRangeQuery ? { dates: [] } : { slots: [] };
   }

package/corpus/templates/chat/app/root.tsx

@@ -57,7 +57,7 @@ export function Layout({ children }: { children: React.ReactNode }) {
         <meta charSet="utf-8" />
         <meta
           name="viewport"
-          content="width=device-width, initial-scale=1, maximum-scale=1, user-scalable=no"
+          content="width=device-width, initial-scale=1, maximum-scale=1, user-scalable=no, interactive-widget=resizes-content"
         />
         <script
           suppressHydrationWarning

package/corpus/templates/clips/AGENTS.md

@@ -76,22 +76,23 @@ video sharing app. The agent and the UI share the same SQL data and actions.
 | --- | --- |
 | `view-screen`, `navigate` | Read context; open a surface |
 | `list-recordings`, `search-recordings` | Library, trash, `--view=shared` |
-| `get-recording-player-data` | Full transcript, chapters, diagnostics |
+| `get-recording-player-data` | Transcript, chapters, diagnostics |
 | `create-recording`, `finalize-recording` | Create row; finish upload |
-| `import-loom-recording` | Import Loom or direct MP4/WebM URL |
+| `import-loom-recording` | Import Loom or video URLs |
 | `update-recording` | Title, password, expiry, visibility |
-| `move-recording` | Move `id` or `ids` to a folder or root |
+| `move-recording` | Move recordings to folder/root |
 | `archive-`, `trash-`, `restore-recording` | Lifecycle |
 | `reprocess-recording` | Repair unseekable/frozen media |
-| `generate-filmstrip` | Editor timeline frame sprite; `all` backfills |
+| `generate-filmstrip` | Timeline frames |
 | `request-transcript`, `cleanup-transcript` | Transcribe; `force`/`regenerate` |
 | `regenerate-title`, `-summary`, `-chapters` | AI metadata |
+| `generate-workflow`, `complete-workflow` | Generate and save workflow |
 | `trim-`, `split-recording`, `remove-silences`, `remove-filler-words` | Edits |
 | `list-meetings`, `get-`, `update-`, `finalize-meeting` | Meetings |
-| `search-meetings` | Find a meeting by title, summary, notes, attendee, or transcript |
+| `search-meetings` | Search meetings |
 | `list-dictations`, `cleanup-dictation` | Dictation history |
 | `add-comment`, `update-comment`, `create-folder`, `create-space` | Comments, folders |
-| `get-clips-notification-prefs`, `update-clips-notification-prefs` | Read or change optional email notifications |
+| `get-clips-notification-prefs`, `update-clips-notification-prefs` | Read or update email alerts |
 | `share-resource`, `set-resource-visibility`, `build-embed-url` | Share, embed |
 | `create-recording-agent-link` | Two-hour `agent_access` share URL |
 | `prepare-crm-call-evidence` | Opaque clip id plus `/r/<id>` for CRM |

package/corpus/templates/clips/CHANGELOG.md

@@ -7,6 +7,7 @@ from the command menu (Cmd+K → "What's new") or from Settings.
 
 ### Improved
 
+- The no-comments sidebar gives viewers a concise reason to try Clips and a clear path to sign up.
 - Shared clips remember your sidebar choice and help new viewers understand why to sign up.
 
 ### Fixed

package/corpus/templates/clips/actions/complete-workflow.ts

@@ -0,0 +1,126 @@
+import { defineAction, fail } from "@agent-native/core/action";
+import {
+  compareAndSetAppState,
+  readAppState,
+} from "@agent-native/core/application-state";
+import { assertAccess } from "@agent-native/core/sharing";
+import { z } from "zod";
+
+import {
+  matchesWorkflowRequest,
+  WorkflowKindSchema,
+} from "../shared/workflow.js";
+
+const WorkflowStateSchema = z
+  .object({
+    kind: WorkflowKindSchema.optional(),
+    status: z.string(),
+    recordingId: z.string().min(1),
+    requestedAt: z.string().min(1),
+    requestId: z.string().min(1).optional(),
+  })
+  .passthrough();
+
+export default defineAction({
+  description:
+    "Save the final markdown for a Clips workflow request. Returns saved only after the matching request is persisted as ready.",
+  schema: z.object({
+    recordingId: z.string().min(1).describe("Recording that owns the workflow"),
+    requestedAt: z
+      .string()
+      .min(1)
+      .describe("Exact request timestamp from the generate-workflow context"),
+    requestId: z
+      .string()
+      .min(1)
+      .optional()
+      .describe(
+        "Exact workflow request ID when present in the request context",
+      ),
+    content: z
+      .string()
+      .trim()
+      .min(1)
+      .max(50_000)
+      .describe("Final workflow document in markdown"),
+  }),
+  run: async ({ recordingId, requestedAt, requestId, content }) => {
+    await assertAccess("recording", recordingId, "viewer");
+
+    const stateKey = `clips-workflow-${recordingId}`;
+    const current = await readAppState(stateKey);
+    if (current === null) {
+      fail("No active workflow request was found for this recording.", {
+        statusCode: 409,
+        errorCode: "workflow_not_active",
+      });
+    }
+
+    const parsed = WorkflowStateSchema.safeParse(current);
+    if (!parsed.success) {
+      throw new Error(`Invalid generated workflow state for ${recordingId}`);
+    }
+    if (parsed.data.recordingId !== recordingId) {
+      throw new Error(`Generated workflow state does not match ${recordingId}`);
+    }
+    const expected = { requestedAt, requestId };
+    if (!matchesWorkflowRequest(parsed.data, expected)) {
+      fail("This workflow request has been replaced by a newer request.", {
+        statusCode: 409,
+        errorCode: "stale_workflow_request",
+      });
+    }
+    const result = {
+      recordingId,
+      requestedAt,
+      ...(requestId ? { requestId } : {}),
+    };
+
+    if (parsed.data.status === "ready" && current.content === content) {
+      return { saved: true, ...result, alreadySaved: true };
+    }
+    if (parsed.data.status !== "generating") {
+      fail("This workflow request is no longer generating.", {
+        statusCode: 409,
+        errorCode: "workflow_not_generating",
+      });
+    }
+
+    const nextState = {
+      ...current,
+      status: "ready",
+      content,
+      completedAt: new Date().toISOString(),
+    };
+    const saved = await compareAndSetAppState(stateKey, current, nextState);
+    if (!saved) {
+      const latest = await readAppState(stateKey);
+      if (
+        latest?.status === "ready" &&
+        latest.recordingId === recordingId &&
+        matchesWorkflowRequest(latest, expected) &&
+        latest.content === content
+      ) {
+        return { saved: true, ...result, alreadySaved: true };
+      }
+      fail("The workflow changed before its result could be saved.", {
+        statusCode: 409,
+        errorCode: "workflow_changed",
+      });
+    }
+
+    const persisted = await readAppState(stateKey);
+    if (
+      persisted?.status !== "ready" ||
+      persisted.recordingId !== recordingId ||
+      !matchesWorkflowRequest(persisted, expected) ||
+      persisted.content !== content
+    ) {
+      throw new Error(
+        `Generated workflow was not persisted for ${recordingId}`,
+      );
+    }
+
+    return { saved: true, ...result };
+  },
+});

package/corpus/templates/clips/actions/generate-workflow.ts

@@ -7,15 +7,18 @@
  *   - ticket — a bug/issue ticket
  *   - email  — a ready-to-send email
  *
- * The agent composes the document and stores it in application_state under
- * `clips-workflow-<recordingId>` so the UI can pick it up and display it.
+ * The agent composes the document and saves it with complete-workflow so the
+ * UI can pick it up and display it.
  *
  * Usage:
  *   pnpm action generate-workflow --recordingId=<id> --kind=pr
  */
 
+import { randomUUID } from "node:crypto";
+
 import { defineAction } from "@agent-native/core/action";
 import {
+  compareAndSetManyAppState,
   readAppState,
   writeAppState,
 } from "@agent-native/core/application-state";
@@ -55,14 +58,23 @@ Output markdown.`,
 Keep it concise, warm, and professional.`,
 } as const;
 
-// Actions for the same recording can arrive concurrently when the player and
-// agent both retry a request. Keep the read-check-write/enqueue sequence
-// single-flight within this runtime so only one request can claim generation.
+// Skip duplicate database work in this runtime; the multi-key CAS below also
+// prevents separate runtimes from claiming the same generation.
 const workflowGenerationLocks = new Set<string>();
 
+function isRecentGeneration(state: Record<string, unknown> | null): boolean {
+  if (state?.status !== "generating") return false;
+  const requestedAt = Date.parse(
+    typeof state.requestedAt === "string" ? state.requestedAt : "",
+  );
+  return (
+    !Number.isFinite(requestedAt) || Date.now() - requestedAt < 10 * 60_000
+  );
+}
+
 export default defineAction({
   description:
-    "Ask the agent to generate a structured workflow doc (pr/sop/ticket/email) from this recording's transcript (and the full video when Include full video is enabled). The agent writes the result to clips-workflow-<recordingId> in application_state.",
+    "Ask the agent to generate a structured workflow doc (pr/sop/ticket/email) from this recording's transcript (and the full video when Include full video is enabled). The agent saves the result with complete-workflow.",
   schema: z.object({
     recordingId: z.string().describe("Recording ID"),
     kind: WorkflowKindSchema.describe("Workflow kind"),
@@ -104,47 +116,44 @@ export default defineAction({
       const includeFullVideoInAi = await readIncludeFullVideoInAi();
 
       const existing = await readAppState(stateKey);
-      if (existing?.status === "generating") {
-        const requestedAt = Date.parse(
-          typeof existing.requestedAt === "string" ? existing.requestedAt : "",
-        );
-        const isRecent =
-          !Number.isFinite(requestedAt) ||
-          Date.now() - requestedAt < 10 * 60_000;
-        if (isRecent) {
-          return {
-            queued: false,
-            duplicate: true,
-            recordingId: args.recordingId,
-            kind: existing.kind ?? args.kind,
-            stateKey,
-          };
-        }
+      if (isRecentGeneration(existing)) {
+        return {
+          queued: false,
+          duplicate: true,
+          recordingId: args.recordingId,
+          kind: existing?.kind ?? args.kind,
+          stateKey,
+        };
       }
 
+      const requestKey = `clips-ai-request-${args.recordingId}`;
+      const existingRequest = await readAppState(requestKey);
       const requestedAt = new Date().toISOString();
-      // Seed the output state with a "generating" placeholder so the UI can show
-      // a loading state immediately.
-      await writeAppState(stateKey, {
+      const requestId = randomUUID();
+      const workflowState = {
         kind: args.kind,
         status: "generating",
         recordingId: args.recordingId,
         requestedAt,
-      } as any);
+        requestId,
+      };
 
       const baseMessage =
         `Generate a ${args.kind.toUpperCase()} workflow document from recording ${args.recordingId} ` +
         `(title: "${rec.title}"). Read the transcript from this request's context. ` +
         `${KIND_PROMPTS[args.kind]} ` +
-        `Then write the final markdown to application_state key "${stateKey}" as ` +
-        `\`{ kind: "${args.kind}", status: "ready", content: "...", recordingId: "${args.recordingId}" }\`. ` +
-        `Finish by replying in chat with the same generated markdown so the user can read it immediately.`;
+        `Then call complete-workflow with recordingId "${args.recordingId}", ` +
+        `the exact requestedAt and requestId "${requestId}" from this request's context, ` +
+        `and the final markdown. ` +
+        `Do not report completion unless that action returns saved: true. ` +
+        `Finish by replying in chat with the same generated markdown.`;
 
       const request = {
         kind: "generate-workflow" as const,
         workflowKind: args.kind,
         recordingId: args.recordingId,
         requestedAt,
+        requestId,
         recordingTitle: rec.title,
         recordingDescription: rec.description,
         transcriptStatus: transcript?.status ?? "pending",
@@ -160,10 +169,40 @@ export default defineAction({
         ),
       };
 
-      await writeAppState(
-        `clips-ai-request-${args.recordingId}`,
-        request as any,
-      );
+      const claimed = await compareAndSetManyAppState([
+        {
+          key: stateKey,
+          expectedValue: existing,
+          nextValue: workflowState,
+        },
+        {
+          key: requestKey,
+          expectedValue: existingRequest,
+          nextValue: request,
+        },
+      ]);
+      if (!claimed) {
+        const current = await readAppState(stateKey);
+        if (isRecentGeneration(current)) {
+          return {
+            queued: false,
+            duplicate: true,
+            recordingId: args.recordingId,
+            kind: current?.kind ?? args.kind,
+            stateKey,
+          };
+        }
+        return {
+          queued: false,
+          duplicate: false,
+          retry: true,
+          reason: "claim-contended",
+          recordingId: args.recordingId,
+          kind: args.kind,
+          stateKey,
+        };
+      }
+
       await writeAppState("refresh-signal", { ts: Date.now() });
 
       console.log(