@agent-native/core 0.196.0 → 0.196.1-nightly-20260928204657

package/corpus/README.md

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

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

@@ -176,7 +176,7 @@ The playable Slack embed is deliberately narrower than the share page:
 
 - Only `ready` recordings with `visibility === "public"` can produce a video block.
 - Password-protected, expired, archived, trashed, private, org-only, or still-processing clips must not produce a playable Slack block.
-- Slack thumbnails use the same-origin proxy for stored thumbnails, or a public video frame when no stored thumbnail exists; normal share-page metadata remains the fallback when no Slack app is installed.
+- Slack thumbnails use the same-origin proxy for stored thumbnails and the branded social image while one is unavailable. The proxy redirects to that image if stored content cannot be served; normal share-page metadata remains the fallback when no Slack app is installed.
 - Do not put passwords, short-lived share tokens, raw provider URLs, or transcript text in Slack unfurl payloads.
 
 Required Slack app setup:

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

@@ -26,9 +26,9 @@ import {
   allowsSqlRecordingChunkScratch,
   STORAGE_SETUP_REQUIRED_REASON,
 } from "../server/lib/video-storage.js";
+import { DEFAULT_RECORDING_TITLE } from "../shared/title-source.js";
 import { createRecordingSchema } from "./lib/create-recording-schema.js";
 import { validateRecordingScope } from "./lib/recording-scope.js";
-import { DEFAULT_RECORDING_TITLE } from "./lib/title-source.js";
 
 export function classifyInitialUploadFailure(error: unknown): {
   failureCode: RecordingFailureCode;

package/corpus/templates/clips/actions/lib/auto-title-candidates.ts

@@ -0,0 +1,42 @@
+import { and, desc, eq, inArray, isNull, or, sql } from "drizzle-orm";
+
+import { getDb, schema } from "../../server/db/index.js";
+import { ownerEmailMatches } from "../../server/lib/recordings.js";
+import type { AutoTitleCandidate } from "../../shared/ai-request-status.js";
+import {
+  AUTO_REPLACEABLE_TITLE_SOURCES,
+  DEFAULT_RECORDING_TITLE,
+} from "../../shared/title-source.js";
+import { transcriptHasTextSql } from "./transcript-text.js";
+
+export const AUTO_TITLE_CANDIDATE_LIMIT = 50;
+
+/**
+ * The owner's ready recordings that still carry a replaceable title and have
+ * transcript text to title from — the SQL form of `isAutoTitleReplaceable`.
+ */
+export function listAutoTitleCandidates(
+  ownerEmail: string,
+): Promise<AutoTitleCandidate[]> {
+  const r = schema.recordings;
+  const t = schema.recordingTranscripts;
+  return getDb()
+    .select({ id: r.id, createdAt: r.createdAt })
+    .from(r)
+    .innerJoin(t, eq(t.recordingId, r.id))
+    .where(
+      and(
+        ownerEmailMatches(r.ownerEmail, ownerEmail),
+        eq(r.status, "ready"),
+        isNull(r.trashedAt),
+        or(
+          inArray(r.titleSource, [...AUTO_REPLACEABLE_TITLE_SOURCES]),
+          sql`TRIM(${r.title}) IN ('', ${DEFAULT_RECORDING_TITLE})`,
+        ),
+        eq(t.status, "ready"),
+        transcriptHasTextSql(t),
+      ),
+    )
+    .orderBy(desc(r.createdAt))
+    .limit(AUTO_TITLE_CANDIDATE_LIMIT);
+}

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

@@ -1,6 +1,6 @@
 import { z } from "zod";
 
-import { RECORDING_TITLE_SOURCES } from "./title-source.js";
+import { RECORDING_TITLE_SOURCES } from "../../shared/title-source.js";
 
 const cliBoolean = z
   .union([z.boolean(), z.enum(["true", "false"])])

package/corpus/templates/clips/actions/lib/transcript-text.ts

@@ -0,0 +1,16 @@
+import { sql, type SQL } from "drizzle-orm";
+
+import { schema } from "../../server/db/index.js";
+
+/**
+ * True when a transcript row carries any spoken text, in either the flat text
+ * or at least one non-empty segment. NULL for a missing (left-joined) row.
+ */
+export function transcriptHasTextSql(
+  transcripts: typeof schema.recordingTranscripts = schema.recordingTranscripts,
+): SQL<boolean | null> {
+  return sql<boolean | null>`(
+    TRIM(${transcripts.fullText}) <> ''
+    OR ${transcripts.segmentsJson} ~ '"text":"[^"]'
+  )`;
+}

package/corpus/templates/clips/actions/list-ai-requests.ts

@@ -1,48 +1,66 @@
 import { defineAction } from "@agent-native/core/action";
 import { listAppState } from "@agent-native/core/application-state";
+import { getRequestUserEmail } from "@agent-native/core/server/request-context";
 import { accessFilter } from "@agent-native/core/sharing";
 import { and, eq, inArray } from "drizzle-orm";
 import { z } from "zod";
 
 import { getDb, schema } from "../server/db/index.js";
+import { listAutoTitleCandidates } from "./lib/auto-title-candidates.js";
 
 const REQUEST_PREFIX = "clips-ai-request-";
 
+type QueuedAiRequest = Record<string, unknown> & { recordingId: string };
+
+async function listQueuedRequests(): Promise<QueuedAiRequest[]> {
+  const entries = await listAppState(REQUEST_PREFIX);
+
+  const requests = entries
+    .map((e) => e.value as Record<string, unknown>)
+    .filter(
+      (v): v is QueuedAiRequest =>
+        !!v && typeof v.recordingId === "string" && v.recordingId.length > 0,
+    );
+
+  if (requests.length === 0) return [];
+
+  const recordingIds = [...new Set(requests.map((r) => r.recordingId))];
+
+  const db = getDb();
+  const accessible = await db
+    .select({ id: schema.recordings.id, title: schema.recordings.title })
+    .from(schema.recordings)
+    .where(
+      and(
+        accessFilter(schema.recordings, schema.recordingShares),
+        inArray(schema.recordings.id, recordingIds),
+        eq(schema.recordings.status, "ready"),
+      ),
+    );
+
+  const titles = new Map(accessible.map((r) => [r.id, r.title]));
+
+  // Not every request kind stores `currentTitle` when queued; fill it from the
+  // recording so every delivered request tells the agent what the clip is.
+  return requests
+    .filter((r) => titles.has(r.recordingId))
+    .map((r) => ({
+      ...r,
+      currentTitle: r.currentTitle ?? titles.get(r.recordingId),
+    }));
+}
+
 export default defineAction({
   description:
-    "List pending clips AI requests (regenerate-title, summary, chapters, etc.) for recordings the current user can access.",
+    "List pending clips AI requests (regenerate-title, summary, chapters, etc.) for recordings the current user can access, plus the current user's ready recordings that still need an auto-generated title.",
   schema: z.object({}),
   http: { method: "GET" },
   run: async () => {
-    const entries = await listAppState(REQUEST_PREFIX);
-
-    const requests = entries
-      .map((e) => e.value as Record<string, unknown>)
-      .filter(
-        (v): v is Record<string, unknown> & { recordingId: string } =>
-          !!v && typeof v.recordingId === "string" && v.recordingId.length > 0,
-      );
-
-    if (requests.length === 0) return { requests: [] };
-
-    const recordingIds = [...new Set(requests.map((r) => r.recordingId))];
-
-    const db = getDb();
-    const accessible = await db
-      .select({ id: schema.recordings.id })
-      .from(schema.recordings)
-      .where(
-        and(
-          accessFilter(schema.recordings, schema.recordingShares),
-          inArray(schema.recordings.id, recordingIds),
-          eq(schema.recordings.status, "ready"),
-        ),
-      );
-
-    const accessibleIds = new Set(accessible.map((r) => r.id));
-
-    return {
-      requests: requests.filter((r) => accessibleIds.has(r.recordingId)),
-    };
+    const email = getRequestUserEmail();
+    const [requests, titleCandidates] = await Promise.all([
+      listQueuedRequests(),
+      email ? listAutoTitleCandidates(email) : [],
+    ]);
+    return { requests, titleCandidates };
   },
 });

package/corpus/templates/clips/actions/list-recordings.ts

@@ -31,6 +31,7 @@ import {
   parseSpaceIds,
 } from "../server/lib/recordings.js";
 import { profileNameFor } from "../server/lib/user-identities.js";
+import { transcriptHasTextSql } from "./lib/transcript-text.js";
 
 function escapeLike(s: string): string {
   return s.replace(/([\\%_])/g, "\\$1");
@@ -320,10 +321,7 @@ export default defineAction({
         },
         transcriptStatus: schema.recordingTranscripts.status,
         transcriptHasText: sql<number>`(
-          CASE WHEN (
-            TRIM(COALESCE(${schema.recordingTranscripts.fullText}, '')) <> ''
-            OR COALESCE(${schema.recordingTranscripts.segmentsJson}, '') LIKE '%"text":"_%'
-          ) THEN 1 ELSE 0 END
+          CASE WHEN ${transcriptHasTextSql()} THEN 1 ELSE 0 END
         )`,
       })
       .from(schema.recordings)

package/corpus/templates/clips/actions/list-transactional-email-ai-requests.ts

@@ -1,6 +1,6 @@
 import { defineAction } from "@agent-native/core/action";
 import { accessFilter, resolveAccess } from "@agent-native/core/sharing";
-import { and, eq, gte, inArray, ne, or } from "drizzle-orm";
+import { and, eq, gte, inArray, ne, or, sql } from "drizzle-orm";
 import { z } from "zod";
 
 import { getDb, schema } from "../server/db/index.js";
@@ -19,6 +19,9 @@ const MAX_CLAIMS = 10;
 const MAX_TITLE_LENGTH = 200;
 const MAX_DESCRIPTION_LENGTH = 600;
 export const MAX_TRANSCRIPT_EXCERPT_LENGTH = 1_200;
+// boundedText collapses whitespace before slicing, so the SQL prefix must be
+// far longer than the excerpt or whitespace-heavy transcripts come back short.
+const TRANSCRIPT_FETCH_LENGTH = 20_000;
 
 export type TransactionalEmailContextPacket = {
   recordingId: string;
@@ -183,7 +186,9 @@ async function loadContextPackets(
     db
       .select({
         recordingId: schema.recordingTranscripts.recordingId,
-        fullText: schema.recordingTranscripts.fullText,
+        fullText: sql<
+          string | null
+        >`left(${schema.recordingTranscripts.fullText}, ${TRANSCRIPT_FETCH_LENGTH})`,
       })
       .from(schema.recordingTranscripts)
       .where(
@@ -263,12 +268,13 @@ export async function claimTransactionalEmailAiRequests(
 ): Promise<{ requests: ClaimedTransactionalEmailAiRequest[] }> {
   const claimant = normalizeEmail(claimantEmail);
   const claimLimit = Math.min(Math.max(limit, 1), MAX_CLAIMS);
-  const config = await transactionalEmailStore.readConfig();
+  const [config, claimCandidates] = await Promise.all([
+    transactionalEmailStore.readConfig(),
+    transactionalEmailStore.listAiClaimCandidates(claimant),
+  ]);
   if (!config) return { requests: [] };
   const staleBefore = new Date(Date.now() - AI_DISPATCH_STALE_MS);
-  const candidates = (
-    await transactionalEmailStore.listJobs(["awaiting_ai", "ai_dispatched"])
-  ).filter(
+  const candidates = claimCandidates.filter(
     (job) =>
       isAiBackedType(job.type) &&
       (job.state === "awaiting_ai" ||

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

@@ -8,6 +8,10 @@ import { z } from "zod";
 import { getDb, schema } from "../server/db/index.js";
 import { isBuilderCreditsExhaustedMessage } from "../shared/builder-credits.js";
 import { withFullVideoAiInstructions } from "../shared/clips-ai-prefs.js";
+import {
+  isAutoTitleReplaceable,
+  isDefaultTitle,
+} from "../shared/title-source.js";
 import cleanupTranscript from "./cleanup-transcript.js";
 import { loadAgentsMdContext } from "./lib/agents-md-context.js";
 import {
@@ -20,7 +24,6 @@ import {
   cleanGeneratedTitle,
   fallbackTitleFromTranscript,
 } from "./lib/title-fallback.js";
-import { isAutoTitleReplaceable, isDefaultTitle } from "./lib/title-source.js";
 import regenerateSummary from "./regenerate-summary.js";
 
 function transcriptTextFromSegments(raw: string | null | undefined): string {

package/corpus/templates/clips/actions/request-transcript.ts

@@ -21,6 +21,7 @@ import {
 } from "../server/lib/recordings.js";
 import { isBuilderCreditsExhaustedMessage } from "../shared/builder-credits.js";
 import { normalizeLoomShareUrl } from "../shared/loom.js";
+import { isAutoTitleReplaceable } from "../shared/title-source.js";
 import {
   isRetryableTranscriptFailure,
   transcriptFailureMessage,
@@ -55,7 +56,6 @@ import {
   isLikelyMismatchedTranscriptLanguage,
   normalizeProviderTranscript,
 } from "./lib/provider-transcript.js";
-import { isAutoTitleReplaceable } from "./lib/title-source.js";
 import regenerateSummary from "./regenerate-summary.js";
 import regenerateTitle from "./regenerate-title.js";
 

package/corpus/templates/clips/actions/save-browser-transcript.ts

@@ -8,10 +8,10 @@ import { z } from "zod";
 import { getDb, schema } from "../server/db/index.js";
 import { dispatchPostFinalizeJob } from "../server/lib/post-finalize-dispatch.js";
 import { getCurrentOwnerEmail } from "../server/lib/recordings.js";
+import { isAutoTitleReplaceable } from "../shared/title-source.js";
 import { buildCaptionSegmentsFromText } from "../shared/transcript-segments.js";
 import { booleanParam } from "./lib/cli-params.js";
 import { finalizeEndedMeetingsForRecording } from "./lib/finalize-ended-meetings.js";
-import { isAutoTitleReplaceable } from "./lib/title-source.js";
 
 function nativeSegmentsJson(
   fullText: string,

package/corpus/templates/clips/app/components/editable-recording-title.tsx

@@ -1,5 +1,6 @@
 import { useActionMutation } from "@agent-native/core/client/hooks";
 import { useT } from "@agent-native/core/client/i18n";
+import { isDefaultTitle } from "@shared/title-source";
 import { IconEdit } from "@tabler/icons-react";
 import { useQueryClient } from "@tanstack/react-query";
 import { useEffect, useRef, useState, type ReactNode } from "react";
@@ -7,7 +8,6 @@ import { toast } from "sonner";
 
 import { Input } from "@/components/ui/input";
 import { Skeleton } from "@/components/ui/skeleton";
-import { isDefaultTitle } from "@/hooks/use-auto-title";
 import { cn } from "@/lib/utils";
 
 interface EditableRecordingTitleProps {

package/corpus/templates/clips/app/components/library/recording-card.tsx

@@ -1,6 +1,7 @@
 import { useFeatureFlag } from "@agent-native/core/client/feature-flags";
 import { useFormatters, useT } from "@agent-native/core/client/i18n";
 import { UPLOAD_RETRY_RESUME_FLAG } from "@shared/feature-flags";
+import { isDefaultTitle } from "@shared/title-source";
 import { isRetryableUploadInterruption } from "@shared/upload-interruption";
 import {
   IconDotsVertical,
@@ -47,7 +48,6 @@ import {
   DropdownMenuTrigger,
 } from "@/components/ui/dropdown-menu";
 import { Skeleton } from "@/components/ui/skeleton";
-import { isDefaultTitle } from "@/hooks/use-auto-title";
 import type { RecordingSummary } from "@/hooks/use-library";
 import { attemptOpenDesktopApp } from "@/lib/capture-install-options";
 import {