@agent-native/core 0.90.2 → 0.90.4

package/corpus/templates/calendar/changelog/2026-07-07-zoom-stays-selected-after-connecting-it-from-a-draft-event.md

@@ -0,0 +1,6 @@
+---
+type: fixed
+date: 2026-07-07
+---
+
+Zoom stays selected after connecting it from a draft event.

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

@@ -181,6 +181,7 @@ export const getEvent = defineEventHandler(async (event: H3Event) => {
             responseStatus: a.responseStatus || undefined,
             organizer: a.organizer || undefined,
             self: a.self || undefined,
+            optional: a.optional === true ? true : undefined,
           })),
           remindersUseDefault: evt.reminders?.useDefault ?? true,
           reminders: evt.reminders?.overrides?.map((r: any) => ({

package/corpus/templates/calendar/server/lib/google-calendar.ts

@@ -228,6 +228,7 @@ function mapAttendees(event: any): CalendarEvent["attendees"] {
     responseStatus: attendee.responseStatus || undefined,
     organizer: attendee.organizer || undefined,
     self: attendee.self || undefined,
+    optional: attendee.optional === true ? true : undefined,
   }));
 }
 
@@ -1094,6 +1095,7 @@ export async function createEvent(
       email: a.email,
       ...(a.displayName ? { displayName: a.displayName } : {}),
       ...(a.comment ? { comment: a.comment } : {}),
+      ...(a.optional === true ? { optional: true } : {}),
     }));
   }
 
@@ -1204,6 +1206,7 @@ export async function updateEvent(
       ...(a.displayName ? { displayName: a.displayName } : {}),
       ...(a.comment ? { comment: a.comment } : {}),
       ...(a.responseStatus ? { responseStatus: a.responseStatus } : {}),
+      ...(a.optional === true ? { optional: true } : { optional: false }),
     }));
   }
   if (eventPatch.recurrence !== undefined) {
@@ -1241,6 +1244,7 @@ export async function updateEvent(
       responseStatus: a.responseStatus || undefined,
       organizer: a.organizer || undefined,
       self: a.self || undefined,
+      optional: a.optional === true ? true : undefined,
     })),
   };
 }

package/corpus/templates/calendar/server/plugins/agent-chat.ts

@@ -107,7 +107,7 @@ Provider-specific Calendar actions are shortcuts, not limits. If a first-class a
 - \`pnpm action search-events --query "term" --from YYYY-MM-DD --to YYYY-MM-DD\` — Convenience bounded search by title, attendees, organizer, location, or description. For relationship history, all-calendar discovery, exact attendee/domain search, or custom pagination, prefer provider-api-request with provider=google_calendar.
 - \`pnpm action provider-api-catalog\` / \`provider-api-docs\` / \`provider-api-request\` — Inspect and call the real Google Calendar, Apollo, Gong, HubSpot, and Pylon APIs directly. For Google Calendar events.list pagination use provider=google_calendar, path=/calendars/primary/events, query={...}, fetchAllPages={cursorPath:"nextPageToken",cursorParam:"pageToken",itemsPath:"items"}. For large relationship-history scans, pass stageAs and pagination={nextCursorPath:"nextPageToken",cursorParam:"pageToken",maxPages:N} with itemsPath="items", then use query-staged-dataset.
 - \`pnpm action create-event --title "..." --start "ISO" --end "ISO"\` — Create a new event. Use \`--eventType outOfOffice\` for OOO, \`--eventType focusTime\` for focus time, \`--eventType workingLocation\` for working location, \`--transparency transparent\` to show as Free, \`--visibility private\` for private events, \`--startTimeZone America/Los_Angeles\` for timezone anchoring, \`--colorId 9\` for Google event color, \`--reminders '[{"method":"popup","minutes":10}]'\` for alerts, and \`--attachments '[{"fileUrl":"https://...","title":"Agenda"}]'\` for Drive/HTTPS file links.
-- \`pnpm action update-event --id "google-..." --transparency opaque|transparent --visibility default|public|private --reminderMinutes 10 --addAttendees "alice@example.com" --scope single|all\` — Update event availability, visibility, reminders, timezone, color, attachments, recurrence, guests, or generated video links. Use \`addAttendees\` when inviting more people so existing RSVP metadata is preserved. Use \`--scope all\` to update an entire recurring series from one occurrence.
+- \`pnpm action update-event --id "google-..." --transparency opaque|transparent --visibility default|public|private --reminderMinutes 10 --addAttendees "alice@example.com" --scope single|all\` — Update event availability, visibility, reminders, timezone, color, attachments, recurrence, guests, or generated video links. Use \`addAttendees\` when inviting more people so existing RSVP metadata is preserved. Pass attendee objects with \`optional:true\` to mark optional guests. Use \`--scope all\` to update an entire recurring series from one occurrence.
 - \`pnpm action navigate --view=calendar --calendarViewMode=day\` — Navigate the UI (day/week/month views, dates)
 - \`pnpm action navigate --view=calendar --date=YYYY-MM-DD\` — Navigate to a specific date
 - \`pnpm action navigate --view=availability\` — Show availability settings

package/corpus/templates/calendar/shared/api.ts

@@ -45,6 +45,8 @@ export interface CalendarEvent {
     responseStatus?: "accepted" | "declined" | "tentative" | "needsAction";
     organizer?: boolean;
     self?: boolean;
+    /** When true, the attendee is optional (Google Calendar `optional`). */
+    optional?: boolean;
   }>;
   reminders?: Array<{ method: "popup" | "email"; minutes: number }>;
   /** Whether this event uses the calendar's default reminder policy. */

package/corpus/templates/clips/.agents/skills/ai-video-tools/SKILL.md

@@ -27,15 +27,41 @@ The agent is already the user's primary interface — it has full project contex
 
 | Feature                   | Trigger                                                                               | What the action does                                                                                  |
 | ------------------------- | ------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------- |
-| Default title             | Native transcript is saved and the recording still has the default title              | `regenerate-title --recordingId=<id>` → writes `clips-ai-request-:id`; the UI bridge sends it to the agent chat |
+| Include full video        | User toggles "Include full video" in the AI tools menu                                | `update-clips-ai-prefs --includeFullVideoInAi=true\|false` → stored in `clips-user-prefs`; default off |
+| Default title             | Native transcript is saved and the recording still has the default title              | `regenerate-title --recordingId=<id>` → writes `clips-ai-request-:id`; the UI bridge sends it to the agent chat. If Include full video is on, skips the transcript-only Gemini fast path and always delegates so the agent watches the recording |
 | Manual title suggestion   | User asks the agent "rename this"                                                     | Agent reads transcript and calls `update-recording --id=<id> --title=...`                             |
-| Summary / description     | Upload completes, or user clicks "Summarize"                                          | `generate-ai-metadata --id=<id> --kind=summary` → agent writes `update-recording --description=...`   |
-| Chapters                  | User clicks "Add chapters" or transcript > 3 minutes                                  | `generate-chapters --id=<id>` → agent writes `chapters_json`                                          |
+| Summary / description     | Upload completes, or user clicks "Summarize" / "Regenerate description"               | `regenerate-summary` / `generate-ai-metadata --id=<id> --kind=summary` → agent writes `update-recording --description=...`. With Include full video, agent must watch the clip, not transcript alone |
+| Chapters                  | User clicks "Add chapters" or transcript > 3 minutes                                  | `generate-chapters --id=<id>` / `regenerate-chapters` → agent writes `chapters_json` (same full-video preference) |
 | Tags                      | On upload complete                                                                    | `generate-ai-metadata --id=<id> --kind=tags` → agent inserts `recording_tags` rows                    |
 | Filler-word removal       | User clicks "Remove ums and uhs"                                                      | `generate-filler-removal --id=<id>` → agent writes proposed cuts into `editor-draft` for user review  |
 | Comment auto-reply        | User types "reply with …" in the agent chat                                           | agent calls `add-comment` directly                                                                    |
 | **Transcription**         | On upload complete (automatic) + live during recording                                | `request-transcript` → native (Web Speech / macOS SFSpeech) first, then cloud fallback Builder.io managed Gemini → Groq; `save-browser-transcript` for instant Web Speech result — see "Transcription" section below |
 
+## Include full video
+
+Screen recordings often have thin or misleading audio ("real quick", "um this
+thing"). Titles, descriptions, chapters, and workflow docs (PR / SOP / ticket /
+email) are more accurate when the agent can **see** the UI, product names, and
+on-screen text.
+
+- Preference key: `includeFullVideoInAi` on user setting `clips-user-prefs`.
+- UI: checkbox at the top of the recording-page **AI tools** dropdown (copy
+  notes Gemini-only).
+- Actions: `get-clips-ai-prefs`, `update-clips-ai-prefs`.
+- **Gemini only:** sending / understanding the full recording video requires a
+  Gemini model (Builder Gemini or `GEMINI_API_KEY`). Claude and OpenAI cannot
+  ingest the MP4/WebM. When the preference is on, the AI-request bridge prefers
+  Builder `gemini-3-5-flash` for that turn.
+- When on, queued `clips-ai-request-*` messages include instructions to attach
+  or upload the recording to Gemini when possible, otherwise use
+  `get-recording-player-data` / `create-recording-agent-link` and follow
+  recommended frames / the frame API across the timeline — not transcript only.
+- Default title generation also honors this: `regenerate-title` skips the
+  transcript-only Gemini cleanup path and always queues the agent.
+
+Do not invent a parallel "video LLM" path in the UI. Keep the preference on the
+shared user-prefs object and keep delegation through the agent chat.
+
 ## The delegation pattern
 
 From an action, kick work over to the agent chat in **background mode** so the user doesn't see a new message bubble mid-playback:

package/corpus/templates/clips/actions/create-recording.ts

@@ -111,7 +111,11 @@ export default defineAction({
         await setResumableSession(id, {
           providerId: uploadProvider.id,
           sessionId: session.sessionId,
-          meta: { ...session.meta, skipCompressionWait: true },
+          meta: {
+            ...session.meta,
+            skipCompressionWait: true,
+            recordAsset: false,
+          },
           bytesUploaded: 0,
           lastCommittedIndex: -1,
         });

package/corpus/templates/clips/actions/finalize-recording.ts

@@ -98,6 +98,9 @@ function concatBytes(parts: Uint8Array[]): Uint8Array {
 
 const RECORDING_TOO_LARGE_REASON =
   "Recording is too large to process after automatic compression. Please update the app and try again, or record a shorter clip.";
+const MEDIA_SERVE_VERIFICATION_TIMEOUT_MS = 8_000;
+const MEDIA_SERVE_VERIFICATION_ATTEMPTS = 3;
+const MEDIA_SERVE_VERIFICATION_BACKOFF_MS = 350;
 
 function stateNumber(
   value: Record<string, unknown> | null | undefined,
@@ -124,6 +127,78 @@ const cliBoolean = z.preprocess((value) => {
   return value;
 }, z.boolean());
 
+function sleep(ms: number): Promise<void> {
+  return new Promise((resolve) => setTimeout(resolve, ms));
+}
+
+function shouldVerifyServedMediaUrl(value: string): boolean {
+  try {
+    const url = new URL(value);
+    return url.protocol === "http:" || url.protocol === "https:";
+  } catch {
+    return false;
+  }
+}
+
+async function responseHasReadableMediaBytes(
+  response: Response,
+): Promise<boolean> {
+  const reader = response.body?.getReader();
+  if (!reader) {
+    const body = await response.arrayBuffer().catch(() => new ArrayBuffer(0));
+    return body.byteLength > 0;
+  }
+
+  try {
+    const { value } = await reader.read();
+    return (value?.byteLength ?? 0) > 0;
+  } catch {
+    return false;
+  } finally {
+    await reader.cancel().catch(() => undefined);
+  }
+}
+
+async function verifyServedMediaUrl(videoUrl: string): Promise<void> {
+  if (!shouldVerifyServedMediaUrl(videoUrl)) return;
+
+  let lastFailure = "media URL did not serve readable bytes";
+  for (
+    let attempt = 1;
+    attempt <= MEDIA_SERVE_VERIFICATION_ATTEMPTS;
+    attempt++
+  ) {
+    const controller = new AbortController();
+    const timeout = setTimeout(
+      () => controller.abort(),
+      MEDIA_SERVE_VERIFICATION_TIMEOUT_MS,
+    );
+    try {
+      const response = await fetch(videoUrl, {
+        method: "GET",
+        headers: { Range: "bytes=0-1023" },
+        signal: controller.signal,
+      });
+      const statusOk = response.status === 200 || response.status === 206;
+      if (statusOk && (await responseHasReadableMediaBytes(response))) {
+        return;
+      }
+      lastFailure = `media URL returned HTTP ${response.status}`;
+      if (response.status < 500) break;
+    } catch (err) {
+      lastFailure = err instanceof Error ? err.message : String(err);
+    } finally {
+      clearTimeout(timeout);
+    }
+
+    if (attempt < MEDIA_SERVE_VERIFICATION_ATTEMPTS) {
+      await sleep(MEDIA_SERVE_VERIFICATION_BACKOFF_MS * attempt);
+    }
+  }
+
+  throw new Error(`Upload was stored-but-unservable: ${lastFailure}`);
+}
+
 function queueBackgroundBuilderCompression(args: {
   recordingId: string;
   ownerEmail: string;
@@ -142,6 +217,44 @@ function queueBackgroundBuilderCompression(args: {
   });
 }
 
+async function failStoredButUnservableRecording(params: {
+  id: string;
+  ownerEmail: string;
+  failureReason: string;
+}): Promise<void> {
+  const { id, ownerEmail, failureReason } = params;
+  const now = new Date().toISOString();
+  const db = getDb();
+  await db
+    .update(schema.recordings)
+    .set({
+      status: "failed",
+      failureReason,
+      updatedAt: now,
+    })
+    .where(
+      and(
+        eq(schema.recordings.id, id),
+        ownerEmailMatches(schema.recordings.ownerEmail, ownerEmail),
+      ),
+    );
+  const uploadStateRaw = await readAppState(`recording-upload-${id}`).catch(
+    () => null,
+  );
+  const uploadState =
+    uploadStateRaw && typeof uploadStateRaw === "object"
+      ? (uploadStateRaw as Record<string, unknown>)
+      : {};
+  await writeAppState(`recording-upload-${id}`, {
+    ...uploadState,
+    recordingId: id,
+    status: "failed",
+    failureReason,
+    updatedAt: now,
+  });
+  await writeAppState("refresh-signal", { ts: Date.now() });
+}
+
 // Flip recording to 'ready', seed transcript row, fire background transcript,
 // emit clip.created. Used by both the resumable and buffered upload paths.
 async function markRecordingReady(params: {
@@ -483,9 +596,21 @@ export default defineAction({
             typeof resumableSession.meta.filename === "string"
               ? resumableSession.meta.filename
               : "",
-            { skipCompressionWait: true },
+            { skipCompressionWait: true, recordAsset: false },
           );
           debugLog("[finalize] resumable upload completed", { id, videoUrl });
+          try {
+            await verifyServedMediaUrl(videoUrl);
+          } catch (err) {
+            const failureReason =
+              err instanceof Error ? err.message : String(err);
+            await failStoredButUnservableRecording({
+              id,
+              ownerEmail,
+              failureReason,
+            });
+            throw err;
+          }
           const result = await markRecordingReady({
             ...readyParams,
             videoUrl,
@@ -580,6 +705,7 @@ export default defineAction({
           })
           .where(eq(schema.recordings.id, id));
         await writeAppState(`recording-upload-${id}`, {
+          ...(uploadState ?? {}),
           recordingId: id,
           status: "failed",
           failureReason,
@@ -841,6 +967,7 @@ export default defineAction({
           mimeType,
           ownerEmail,
           skipCompressionWait: true,
+          recordAsset: false,
         });
       } catch (err) {
         // Capture structured context so a "Builder.io upload failed (500)" can
@@ -993,6 +1120,18 @@ export default defineAction({
         videoUrl: upload.url,
         bytes: uploadData.byteLength,
       });
+      try {
+        await verifyServedMediaUrl(upload.url);
+      } catch (err) {
+        chunkKeysToPurge = [];
+        const failureReason = err instanceof Error ? err.message : String(err);
+        await failStoredButUnservableRecording({
+          id,
+          ownerEmail,
+          failureReason,
+        });
+        throw err;
+      }
       const result = await markRecordingReady({
         ...readyParams,
         // Use the audio-probe-corrected value, not the raw client claim in

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

@@ -21,6 +21,8 @@ import { eq } from "drizzle-orm";
 import { z } from "zod";
 
 import { getDb, schema } from "../server/db/index.js";
+import { withFullVideoAiInstructions } from "../shared/clips-ai-prefs.js";
+import { readIncludeFullVideoInAi } from "./lib/clips-ai-prefs.js";
 
 const KIND_PROMPTS = {
   pr: `Compose a pull-request description. Include:
@@ -51,7 +53,7 @@ Keep it concise, warm, and professional.`,
 
 export default defineAction({
   description:
-    "Ask the agent to generate a structured workflow doc (pr/sop/ticket/email) from this recording's transcript. 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 writes the result to clips-workflow-<recordingId> in application_state.",
   schema: z.object({
     recordingId: z.string().describe("Recording ID"),
     kind: z.enum(["pr", "sop", "ticket", "email"]).describe("Workflow kind"),
@@ -74,6 +76,7 @@ export default defineAction({
       .limit(1);
 
     const stateKey = `clips-workflow-${args.recordingId}`;
+    const includeFullVideoInAi = await readIncludeFullVideoInAi();
 
     // Seed the output state with a "generating" placeholder so the UI can show
     // a loading state immediately.
@@ -84,6 +87,14 @@ export default defineAction({
       requestedAt: new Date().toISOString(),
     } as any);
 
+    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.`;
+
     const request = {
       kind: "generate-workflow" as const,
       workflowKind: args.kind,
@@ -95,13 +106,12 @@ export default defineAction({
       transcriptText: transcript?.fullText ?? "",
       stateKey,
       instructions: KIND_PROMPTS[args.kind],
-      message:
-        `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.`,
+      includeFullVideoInAi,
+      message: withFullVideoAiInstructions(
+        baseMessage,
+        args.recordingId,
+        includeFullVideoInAi,
+      ),
     };
 
     await writeAppState(`clips-ai-request-${args.recordingId}`, request as any);
@@ -115,6 +125,7 @@ export default defineAction({
       recordingId: args.recordingId,
       kind: args.kind,
       stateKey,
+      includeFullVideoInAi,
     };
   },
 });

package/corpus/templates/clips/actions/get-clips-ai-prefs.ts

@@ -0,0 +1,36 @@
+/**
+ * Read Clips AI preferences for the current user (include-full-video switch).
+ *
+ * Usage:
+ *   pnpm action get-clips-ai-prefs
+ */
+
+import { defineAction } from "@agent-native/core";
+import { getRequestUserEmail } from "@agent-native/core/server/request-context";
+import { getUserSetting } from "@agent-native/core/settings";
+import { z } from "zod";
+
+import {
+  CLIPS_USER_PREFS_KEY,
+  isIncludeFullVideoInAiEnabled,
+  type ClipsUserPrefs,
+} from "../shared/clips-ai-prefs.js";
+
+export default defineAction({
+  description:
+    "Get Clips AI tool preferences for the current user, including whether AI tools should watch the full recording with Gemini instead of transcript-only.",
+  schema: z.object({}),
+  http: { method: "GET" },
+  readOnly: true,
+  run: async () => {
+    const email = getRequestUserEmail();
+    if (!email) {
+      return { includeFullVideoInAi: false };
+    }
+    const prefs = ((await getUserSetting(email, CLIPS_USER_PREFS_KEY)) ??
+      {}) as ClipsUserPrefs;
+    return {
+      includeFullVideoInAi: isIncludeFullVideoInAiEnabled(prefs),
+    };
+  },
+});

package/corpus/templates/clips/actions/import-loom-recording.ts

@@ -297,6 +297,7 @@ export default defineAction({
       mimeType: media.mimeType,
       ownerEmail,
       skipCompressionWait: true,
+      recordAsset: false,
     });
 
     const recordingValues = buildRecordingValues(media.sizeBytes);

package/corpus/templates/clips/actions/lib/clips-ai-prefs.ts

@@ -0,0 +1,28 @@
+/**
+ * Server helper: load the current user's "include full video in AI" preference.
+ */
+
+import { getRequestUserEmail } from "@agent-native/core/server/request-context";
+import { getUserSetting } from "@agent-native/core/settings";
+
+import {
+  CLIPS_USER_PREFS_KEY,
+  isIncludeFullVideoInAiEnabled,
+  type ClipsUserPrefs,
+} from "../../shared/clips-ai-prefs.js";
+
+export async function readIncludeFullVideoInAi(
+  email?: string | null,
+): Promise<boolean> {
+  const userEmail = email ?? getRequestUserEmail();
+  if (!userEmail) return false;
+  try {
+    const prefs = (await getUserSetting(
+      userEmail,
+      CLIPS_USER_PREFS_KEY,
+    )) as ClipsUserPrefs | null;
+    return isIncludeFullVideoInAiEnabled(prefs);
+  } catch {
+    return false;
+  }
+}

package/corpus/templates/clips/actions/lib/ensure-seekable-video.ts

@@ -219,6 +219,7 @@ export async function ensureRecordingSeekable(params: {
     mimeType,
     ownerEmail,
     skipCompressionWait: true,
+    recordAsset: false,
   });
 
   if (!upload?.url) {

package/corpus/templates/clips/actions/regenerate-chapters.ts

@@ -15,10 +15,12 @@ import { eq } from "drizzle-orm";
 import { z } from "zod";
 
 import { getDb, schema } from "../server/db/index.js";
+import { withFullVideoAiInstructions } from "../shared/clips-ai-prefs.js";
+import { readIncludeFullVideoInAi } from "./lib/clips-ai-prefs.js";
 
 export default defineAction({
   description:
-    "Ask the agent to generate chapters for this recording based on its transcript. The agent identifies topic transitions and calls set-chapters.",
+    "Ask the agent to generate chapters for this recording based on its transcript (and the full video when Include full video is enabled). The agent identifies topic transitions and calls set-chapters.",
   schema: z.object({
     recordingId: z.string().describe("Recording ID"),
   }),
@@ -39,6 +41,13 @@ export default defineAction({
       .where(eq(schema.recordingTranscripts.recordingId, args.recordingId))
       .limit(1);
 
+    const includeFullVideoInAi = await readIncludeFullVideoInAi();
+    const baseMessage =
+      `Generate chapters for recording ${args.recordingId} (duration ${rec.durationMs}ms). ` +
+      `Read the transcript segments in this request's context, identify topic transitions, ` +
+      `and call \`set-chapters --recordingId=${args.recordingId} --chapters='[{ "startMs": 0, "title": "Intro" }, ...]'\`. ` +
+      `Aim for 3–8 chapters. Each chapter title should be 3–6 words and capture the essence of that section.`;
+
     const request = {
       kind: "regenerate-chapters" as const,
       recordingId: args.recordingId,
@@ -47,11 +56,12 @@ export default defineAction({
       transcriptStatus: transcript?.status ?? "pending",
       segmentsJson: transcript?.segmentsJson ?? "[]",
       transcriptText: transcript?.fullText ?? "",
-      message:
-        `Generate chapters for recording ${args.recordingId} (duration ${rec.durationMs}ms). ` +
-        `Read the transcript segments in this request's context, identify topic transitions, ` +
-        `and call \`set-chapters --recordingId=${args.recordingId} --chapters='[{ "startMs": 0, "title": "Intro" }, ...]'\`. ` +
-        `Aim for 3–8 chapters. Each chapter title should be 3–6 words and capture the essence of that section.`,
+      includeFullVideoInAi,
+      message: withFullVideoAiInstructions(
+        baseMessage,
+        args.recordingId,
+        includeFullVideoInAi,
+      ),
     };
 
     await writeAppState(`clips-ai-request-${args.recordingId}`, request as any);
@@ -60,6 +70,10 @@ export default defineAction({
     console.log(
       `Delegation queued: regenerate-chapters for ${args.recordingId}`,
     );
-    return { queued: true, recordingId: args.recordingId };
+    return {
+      queued: true,
+      recordingId: args.recordingId,
+      includeFullVideoInAi,
+    };
   },
 });

package/corpus/templates/clips/actions/regenerate-summary.ts

@@ -14,10 +14,12 @@ import { eq } from "drizzle-orm";
 import { z } from "zod";
 
 import { getDb, schema } from "../server/db/index.js";
+import { withFullVideoAiInstructions } from "../shared/clips-ai-prefs.js";
+import { readIncludeFullVideoInAi } from "./lib/clips-ai-prefs.js";
 
 export default defineAction({
   description:
-    "Ask the agent to regenerate this recording's description/summary based on its transcript.",
+    "Ask the agent to regenerate this recording's description/summary based on its transcript (and the full video when Include full video is enabled).",
   schema: z.object({
     recordingId: z.string().describe("Recording ID"),
   }),
@@ -42,7 +44,12 @@ export default defineAction({
       .where(eq(schema.recordingTranscripts.recordingId, args.recordingId))
       .limit(1);
 
-    if (transcript?.status !== "ready" || !transcript.fullText?.trim()) {
+    const includeFullVideoInAi = await readIncludeFullVideoInAi();
+
+    if (
+      !includeFullVideoInAi &&
+      (transcript?.status !== "ready" || !transcript.fullText?.trim())
+    ) {
       return {
         updated: false,
         skipped: true,
@@ -52,6 +59,12 @@ export default defineAction({
       };
     }
 
+    const baseMessage =
+      `Regenerate the description for recording ${args.recordingId}. ` +
+      `Read the transcript in this request's context and call ` +
+      `\`update-recording --id=${args.recordingId} --description="..."\` with a 2–4 ` +
+      `sentence summary of what the recording covers. Title: "${rec.title}".`;
+
     const request = {
       kind: "regenerate-summary" as const,
       recordingId: args.recordingId,
@@ -60,11 +73,12 @@ export default defineAction({
       currentDescription: rec.description,
       transcriptStatus: transcript?.status ?? "pending",
       transcriptText: transcript?.fullText ?? "",
-      message:
-        `Regenerate the description for recording ${args.recordingId}. ` +
-        `Read the transcript in this request's context and call ` +
-        `\`update-recording --id=${args.recordingId} --description="..."\` with a 2–4 ` +
-        `sentence summary of what the recording covers. Title: "${rec.title}".`,
+      includeFullVideoInAi,
+      message: withFullVideoAiInstructions(
+        baseMessage,
+        args.recordingId,
+        includeFullVideoInAi,
+      ),
     };
 
     await writeAppState(`clips-ai-request-${args.recordingId}`, request as any);
@@ -73,6 +87,10 @@ export default defineAction({
     console.log(
       `Delegation queued: regenerate-summary for ${args.recordingId}`,
     );
-    return { queued: true, recordingId: args.recordingId };
+    return {
+      queued: true,
+      recordingId: args.recordingId,
+      includeFullVideoInAi,
+    };
   },
 });