@agent-native/core 0.114.4 → 0.114.5

package/corpus/README.md

@@ -30,4 +30,4 @@ rg -n "defineAction|useActionQuery" node_modules/@agent-native/core/corpus
 
 - core files: 1517
 - toolkit files: 137
-- template files: 6106
+- template files: 6112

package/corpus/core/CHANGELOG.md

@@ -1,5 +1,13 @@
 # @agent-native/core
 
+## 0.114.5
+
+### Patch Changes
+
+- 570be31: Skip visual recap publishing when the authoring agent does not produce recap source.
+- Updated dependencies [570be31]
+  - @agent-native/recap-cli@0.4.5
+
 ## 0.114.4
 
 ### Patch Changes

package/corpus/core/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agent-native/core",
-  "version": "0.114.4",
+  "version": "0.114.5",
   "description": "Framework for agent-native application development — where AI agents and UI share SQL state, actions, and context",
   "homepage": "https://github.com/BuilderIO/agent-native#readme",
   "bugs": {

package/corpus/templates/clips/.agents/skills/meetings/SKILL.md

@@ -78,7 +78,7 @@ When meetings are enabled, the Clips desktop app also watches for native Zoom (`
 | `list-meetings`           | Upcoming + past, scoped via `accessFilter`; reads connected Google Calendar live |
 | `get-meeting`             | One meeting + participants + segments + notes                         |
 | `create-meeting`          | Create a meeting row (`source`: `calendar` / `adhoc` / `manual`); desktop adhoc Zoom/Teams detection passes `source: "adhoc"` |
-| `update-meeting`          | Inline title edit, notes edits                                        |
+| `update-meeting`          | Inline title/notes edits; owners/admins can opt the full transcript into or out of the meeting share link with `shareTranscript` |
 | `delete-meeting`          | Soft-delete a meeting from the visible list; linked recordings and calendar events stay intact |
 | `start-meeting-recording` | Begin native macOS transcript stream + create the linked recording   |
 | `stop-meeting-recording`  | End the active capture                                                |
@@ -91,6 +91,15 @@ When meetings are enabled, the Clips desktop app also watches for native Zoom (`
 
 All actions go through `accessFilter` / `assertAccess`. AI work delegates via `sendToAgentChat` per the `delegate-to-agent` skill — never inline LLM calls.
 
+## Sharing meeting notes and transcripts
+
+Meeting share links always include generated notes: the summary, key points,
+and action items. Full transcripts are more sensitive and stay excluded by
+default. Owners and share admins can call `update-meeting` with
+`shareTranscript=true|false` or use the Share popover's transcript switch.
+The setting controls only the meeting share payload; it must not change the
+linked recording's visibility or expose recording media and comments.
+
 ## Cleanup credential order
 
 The `cleanup-transcript` action resolves credentials in this order — **always lead with Builder.io Connect** when explaining options to the user:
@@ -121,6 +130,7 @@ The app exposes `view`, `meetingId`, and `dictationId` so the agent always knows
     "scheduledStart": "...",
     "scheduledEnd": "...",
     "transcriptStatus": "ready",
+    "shareTranscript": false,
     "participants": [{ "email": "alice@ex.com", "name": "Alice" }, ...],
     "actionItems": [{ "assigneeEmail": "alice@ex.com", "text": "..." }, ...],
     "hasRecording": true,

package/corpus/templates/clips/AGENTS.md

@@ -102,6 +102,11 @@ ladder.
   sharing/status boundary.
 - Use framework sharing actions for recordings. Password and expiry are extra
   controls on top of visibility/share grants.
+- Meeting share links include the summary, key points, and action items. The
+  full transcript is an explicit, default-off setting: call `update-meeting`
+  with `shareTranscript=true|false` only when the owner or a share admin asks
+  to change what the meeting link exposes. This does not change the linked
+  recording's visibility or expose its media.
 - Use `list-recordings --view=shared` for the current user's "Shared with me"
   collection. It returns recordings admitted by sharing access that are owned
   by someone else; public-link-only clips remain out of this list.
@@ -111,10 +116,15 @@ ladder.
   segments; `/api/agent-frame.jpg?id=<recordingId>&atMs=<ms>` for a screen
   frame at a timestamp. Password-protected clips require the password once to
   mint a short-lived token returned inside agent-context links.
-- If public agent context or transcript APIs report `transcript.status` as
-  `"pending"`, wait 15-30 seconds and retry the context/transcript URL a few
-  times, especially for long recordings. Do not pivot straight to frames or tell
-  the user there is no transcript until the retry budget is exhausted.
+- If a public agent discovery/context/transcript payload reports
+  `agentReadiness.state` as `"preparing"` (the clip is `"uploading"` or
+  `"processing"`), wait 15 seconds and retry `agentContextUrl`; do not open the
+  share page, fetch frames, or draw conclusions until the recording status is
+  `"ready"`.
+  If `transcript.status` is `"pending"` after the clip is ready, wait 15-30
+  seconds and retry the context/transcript URL a few times, especially for long
+  recordings. Do not pivot straight to frames or tell the user there is no
+  transcript until the retry budget is exhausted.
 - If transcription failed because Builder transcription credits are exhausted,
   tell the user that clearly and point them to Builder.io credits/upgrade or a
   Groq key for backup speech-to-text. Generic OpenAI or Anthropic chat keys do

package/corpus/templates/clips/actions/update-meeting.ts

@@ -1,5 +1,5 @@
 /**
- * Update a meeting's metadata. Editor access required.
+ * Update meeting content or owner/admin-managed sharing settings.
  */
 
 import { defineAction } from "@agent-native/core";
@@ -9,10 +9,11 @@ import { eq } from "drizzle-orm";
 import { z } from "zod";
 
 import { getDb, schema } from "../server/db/index.js";
+import { booleanParam } from "./lib/cli-params.js";
 
 export default defineAction({
   description:
-    "Partially update a meeting (title, schedule, notes, summary, action items). Only provided fields are updated.",
+    "Partially update a meeting's content. Owners and share admins can also control visibility and whether share links include the transcript.",
   schema: z.object({
     id: z.string().describe("Meeting id"),
     title: z.string().optional(),
@@ -41,10 +42,17 @@ export default defineAction({
       .optional()
       .describe("Replace the action item set on the meetings row JSON"),
     transcriptStatus: z.enum(["idle", "pending", "ready", "failed"]).optional(),
+    shareTranscript: booleanParam
+      .optional()
+      .describe(
+        "Include the linked recording transcript on meeting share pages",
+      ),
     visibility: z.enum(["private", "org", "public"]).optional(),
   }),
   run: async (args) => {
-    await assertAccess("meeting", args.id, "editor");
+    const updatesSharing =
+      args.shareTranscript !== undefined || args.visibility !== undefined;
+    await assertAccess("meeting", args.id, updatesSharing ? "admin" : "editor");
     const db = getDb();
 
     const patch: Record<string, unknown> = {
@@ -67,6 +75,8 @@ export default defineAction({
     if (args.actionItems)
       patch.actionItemsJson = JSON.stringify(args.actionItems);
     if (args.transcriptStatus) patch.transcriptStatus = args.transcriptStatus;
+    if (args.shareTranscript !== undefined)
+      patch.shareTranscript = args.shareTranscript;
     if (args.visibility) patch.visibility = args.visibility;
 
     await db

package/corpus/templates/clips/actions/view-screen.ts

@@ -414,6 +414,7 @@ async function fetchMeetingDetail(meetingId: string) {
       source: meeting.source,
       userNotesMd: meeting.userNotesMd,
       transcriptStatus: meeting.transcriptStatus,
+      shareTranscript: Boolean(meeting.shareTranscript),
       summaryMd: meeting.summaryMd,
       bullets: safeJsonArray<{ text: string }>(meeting.bulletsJson),
     },

package/corpus/templates/clips/app/components/meetings/meeting-card.tsx

@@ -1,4 +1,5 @@
 import { useT } from "@agent-native/core/client/i18n";
+import { resolveNativeMeetingJoinUrl } from "@shared/meeting-join-url";
 import {
   IconCheck,
   IconClock,
@@ -284,7 +285,7 @@ export function UpcomingMeetingCard({
           <div className="flex items-center gap-1.5">
             {meeting.joinUrl && (
               <a
-                href={meeting.joinUrl}
+                href={resolveNativeMeetingJoinUrl(meeting.joinUrl)}
                 target="_blank"
                 rel="noopener noreferrer"
                 onClick={(e) => e.stopPropagation()}

package/corpus/templates/clips/app/components/meetings/share-meeting-dialog.tsx

@@ -1,8 +1,11 @@
 import { appPath } from "@agent-native/core/client/api-path";
-import { useActionQuery } from "@agent-native/core/client/hooks";
+import {
+  useActionMutation,
+  useActionQuery,
+} from "@agent-native/core/client/hooks";
 import { useT } from "@agent-native/core/client/i18n";
-import { IconLink, IconMail } from "@tabler/icons-react";
-import { useMemo, type ReactNode } from "react";
+import { IconCheck, IconLink, IconMail } from "@tabler/icons-react";
+import { useEffect, useMemo, useState, type ReactNode } from "react";
 import { toast } from "sonner";
 
 import {
@@ -22,17 +25,22 @@ import {
   PopoverContent,
   PopoverTrigger,
 } from "@/components/ui/popover";
+import { Switch } from "@/components/ui/switch";
 import { Tabs, TabsContent, TabsList, TabsTrigger } from "@/components/ui/tabs";
 
 export interface ShareMeetingPopoverProps {
   meetingId: string;
   meetingTitle?: string;
+  shareTranscript: boolean;
+  transcriptReady: boolean;
   children: ReactNode;
 }
 
 export function ShareMeetingPopover({
   meetingId,
   meetingTitle,
+  shareTranscript,
+  transcriptReady,
   children,
 }: ShareMeetingPopoverProps) {
   return (
@@ -40,11 +48,13 @@ export function ShareMeetingPopover({
       <PopoverTrigger asChild>{children}</PopoverTrigger>
       <PopoverContent
         align="end"
-        className="w-[440px] max-w-[calc(100vw-1rem)] overflow-hidden border-border p-0"
+        className="max-h-[calc(100vh-1rem)] w-[440px] max-w-[calc(100vw-1rem)] overflow-y-auto border-border p-0"
       >
         <ShareMeetingContent
           meetingId={meetingId}
           meetingTitle={meetingTitle}
+          shareTranscript={shareTranscript}
+          transcriptReady={transcriptReady}
         />
       </PopoverContent>
     </Popover>
@@ -54,9 +64,13 @@ export function ShareMeetingPopover({
 function ShareMeetingContent({
   meetingId,
   meetingTitle,
+  shareTranscript,
+  transcriptReady,
 }: {
   meetingId: string;
   meetingTitle?: string;
+  shareTranscript: boolean;
+  transcriptReady: boolean;
 }) {
   const t = useT();
   const shareUrl = useMemo(
@@ -97,6 +111,8 @@ function ShareMeetingContent({
             shareUrl={shareUrl}
             sharesQuery={sharesQuery}
             canManage={canManage}
+            shareTranscript={shareTranscript}
+            transcriptReady={transcriptReady}
           />
         </TabsContent>
 
@@ -127,13 +143,22 @@ function LinkTab({
   shareUrl,
   sharesQuery,
   canManage,
+  shareTranscript,
+  transcriptReady,
 }: {
   meetingId: string;
   shareUrl: string;
   sharesQuery: SharesQuery;
   canManage: boolean;
+  shareTranscript: boolean;
+  transcriptReady: boolean;
 }) {
   const t = useT();
+  const updateMeeting = useActionMutation<
+    unknown,
+    { id: string; shareTranscript: boolean }
+  >("update-meeting");
+  const [includeTranscript, setIncludeTranscript] = useState(shareTranscript);
   const { setResourceVisibility, isPending } = useResourceVisibilityMutation(
     "meeting",
     meetingId,
@@ -144,6 +169,28 @@ function LinkTab({
     (data?.visibility as Visibility | null) ?? "private";
   const isPublic = visibility === "public";
 
+  useEffect(() => {
+    setIncludeTranscript(shareTranscript);
+  }, [shareTranscript]);
+
+  const handleTranscriptSharingChange = (next: boolean) => {
+    const previous = includeTranscript;
+    setIncludeTranscript(next);
+    updateMeeting.mutate(
+      { id: meetingId, shareTranscript: next },
+      {
+        onError: (error: unknown) => {
+          setIncludeTranscript(previous);
+          toast.error(
+            error instanceof Error
+              ? error.message
+              : t("shareMeeting.updateTranscriptSharingFailed"),
+          );
+        },
+      },
+    );
+  };
+
   return (
     <div className="space-y-4">
       <GeneralAccessSelect
@@ -153,6 +200,51 @@ function LinkTab({
         onChange={(next) => setResourceVisibility(next)}
       />
 
+      <div>
+        <div className="mb-2 text-xs font-semibold">
+          {t("shareMeeting.sharedContent")}
+        </div>
+        <div className="rounded-md border border-border">
+          <div className="flex items-center gap-3 border-b border-border px-3 py-2.5">
+            <span
+              aria-hidden
+              className="inline-flex size-5 shrink-0 items-center justify-center rounded-full bg-primary text-primary-foreground"
+            >
+              <IconCheck size={12} strokeWidth={2.5} />
+            </span>
+            <span className="text-sm">{t("shareMeeting.summaryIncluded")}</span>
+          </div>
+          <div className="flex items-start justify-between gap-4 px-3 py-2.5">
+            <div className="min-w-0">
+              <label
+                htmlFor={`meeting-share-transcript-${meetingId}`}
+                className="text-sm font-medium"
+              >
+                {t("shareMeeting.includeTranscript")}
+              </label>
+              <p
+                id={`meeting-share-transcript-description-${meetingId}`}
+                className="mt-0.5 text-xs text-muted-foreground"
+              >
+                {transcriptReady
+                  ? t("shareMeeting.includeTranscriptDescription")
+                  : t("shareMeeting.transcriptUnavailable")}
+              </p>
+            </div>
+            <Switch
+              id={`meeting-share-transcript-${meetingId}`}
+              checked={includeTranscript}
+              onCheckedChange={handleTranscriptSharingChange}
+              disabled={
+                !canManage || !transcriptReady || updateMeeting.isPending
+              }
+              aria-describedby={`meeting-share-transcript-description-${meetingId}`}
+              className="mt-0.5 shrink-0"
+            />
+          </div>
+        </div>
+      </div>
+
       <CopyField label={t("clipsFinalRaw.shareLink")} value={shareUrl} />
 
       {!isPublic && canManage ? (

package/corpus/templates/clips/app/i18n/en-US.ts

@@ -927,6 +927,17 @@ All notable user-facing changes to Clips are documented here. Open it any time f
     summary: "Summary",
     keyPoints: "Key points",
     actionItems: "Action items",
+    sharedContent: "Shared content",
+    summaryIncluded: "Summary, key points, and action items",
+    includeTranscript: "Include full transcript",
+    includeTranscriptDescription:
+      "Anyone with access to this meeting can read the complete transcript.",
+    transcriptUnavailable: "The transcript isn't ready yet.",
+    transcript: "Transcript",
+    copyTranscript: "Copy transcript",
+    transcriptCopied: "Transcript copied",
+    copyTranscriptFailed: "Couldn't copy the transcript",
+    updateTranscriptSharingFailed: "Couldn't update transcript sharing",
   },
   deleteRecordingMenu: {
     movedToTrash: "Clip moved to trash",

package/corpus/templates/clips/app/lib/public-meeting.ts

@@ -0,0 +1,85 @@
+import { appBasePath } from "@agent-native/core/client/api-path";
+
+import type { TranscriptSegment } from "@/components/meetings/transcript-bubbles";
+
+export interface PublicMeetingBullet {
+  text: string;
+}
+
+export interface PublicMeetingParticipant {
+  email: string;
+  name: string | null;
+  isOrganizer: boolean;
+}
+
+export interface PublicMeetingActionItem {
+  id: string;
+  text: string;
+  assigneeEmail: string | null;
+  completedAt: string | null;
+}
+
+export interface PublicMeetingTranscript {
+  status: string;
+  language: string | null;
+  fullText: string | null;
+  segments: TranscriptSegment[];
+}
+
+export interface PublicMeeting {
+  id: string;
+  title: string;
+  scheduledStart: string | null;
+  summaryMd: string;
+  bullets: PublicMeetingBullet[];
+  participants: PublicMeetingParticipant[];
+  actionItems: PublicMeetingActionItem[];
+  actualStart: string | null;
+  actualEnd: string | null;
+  transcriptStatus: string | null;
+  transcript?: PublicMeetingTranscript | null;
+}
+
+export interface PublicMeetingPayload {
+  meeting: PublicMeeting;
+  viewer: {
+    role: "owner" | "admin" | "editor" | "viewer";
+    canEdit: boolean;
+    isOwner: boolean;
+  } | null;
+}
+
+export interface PublicMeetingResult {
+  ok: boolean;
+  status: number;
+  data: PublicMeetingPayload | { error?: string };
+}
+
+export function publicMeetingUrl(
+  meetingId: string,
+  origin: string,
+  basePath: string,
+): string {
+  const url = new URL(`${basePath}/api/public-meeting`, origin);
+  url.searchParams.set("id", meetingId);
+  return url.toString();
+}
+
+export async function fetchPublicMeeting(
+  meetingId: string,
+  options: {
+    signal?: AbortSignal;
+    origin?: string;
+    basePath?: string;
+  } = {},
+): Promise<PublicMeetingResult> {
+  const origin = options.origin ?? window.location.origin;
+  const basePath = options.basePath ?? appBasePath();
+  const response = await fetch(publicMeetingUrl(meetingId, origin, basePath), {
+    signal: options.signal,
+  });
+  const data = (await response.json().catch(() => ({}))) as
+    | PublicMeetingPayload
+    | { error?: string };
+  return { ok: response.ok, status: response.status, data };
+}

package/corpus/templates/clips/app/routes/_app.meetings.$meetingId.tsx

@@ -99,6 +99,7 @@ interface Meeting {
   recordingId?: string | null;
   recordingDurationMs?: number | null;
   transcriptStatus?: "pending" | "ready" | "failed" | "in_progress" | string;
+  shareTranscript?: boolean | null;
   summaryMd?: string | null;
   userNotesMd?: string | null;
   bulletsJson?: Bullet[] | null;
@@ -313,7 +314,10 @@ export default function MeetingDetailRoute() {
     meeting?: Omit<Meeting, "participants" | "segmentsJson"> | null;
     participants?: Participant[];
     actionItems?: ActionItem[];
-    transcript?: { segmentsJson?: TranscriptSegment[] | null } | null;
+    transcript?: {
+      fullText?: string | null;
+      segmentsJson?: TranscriptSegment[] | null;
+    } | null;
     recording?: { id: string; durationMs?: number | null } | null;
     role?: "owner" | "admin" | "editor" | "viewer";
   };
@@ -682,6 +686,12 @@ export default function MeetingDetailRoute() {
           <ShareMeetingPopover
             meetingId={meeting.id}
             meetingTitle={meeting.title}
+            shareTranscript={meeting.shareTranscript === true}
+            transcriptReady={
+              meeting.transcriptStatus === "ready" &&
+              (segments.length > 0 ||
+                Boolean(data?.transcript?.fullText?.trim()))
+            }
           >
             <Button size="sm" className="shrink-0 gap-1.5">
               <IconShare3 className="h-4 w-4" />

package/corpus/templates/clips/app/routes/share.$shareId.tsx

@@ -69,6 +69,7 @@ import { getDb, schema } from "../../server/db";
 import { resolvePlayerThumbnailUrl } from "../../server/lib/player-thumbnail-url";
 import {
   buildAgentApiUrls,
+  buildAgentDiscoveryPayload,
   CLIPS_AGENT_ACCESS_PARAM,
   CLIP_AGENT_ACCESS_TOKEN_PREFIX,
   safeJsonForHtml,
@@ -305,20 +306,18 @@ function AgentDiscovery({
   recording,
   agentContextUrl,
 }: {
-  recording: Pick<SharePageMetaRecording, "id" | "title"> | null;
+  recording: Pick<SharePageMetaRecording, "id" | "title" | "status"> | null;
   agentContextUrl: string | null;
 }) {
   const t = useT();
   if (!recording || !agentContextUrl) return null;
 
-  const payload = {
-    type: "agent-native.clip.discovery",
-    clipId: recording.id,
+  const payload = buildAgentDiscoveryPayload({
+    recordingId: recording.id,
     title: recording.title,
+    status: recording.status,
     agentContextUrl,
-    instructions:
-      "Fetch agentContextUrl for the transcript and JPEG frame URLs. Fetch the frame URLs to SEE the screen, not just read the transcript.",
-  };
+  });
 
   return (
     <>