@agent-native/core 0.114.4 → 0.114.6

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: 6122

package/corpus/core/CHANGELOG.md

@@ -1,5 +1,21 @@
 # @agent-native/core
 
+## 0.114.6
+
+### Patch Changes
+
+- 6d96437: Add clear creation actions to empty resource views and improve collaboration usage feedback.
+- Updated dependencies [6d96437]
+  - @agent-native/toolkit@0.8.1
+
+## 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.6",
   "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/core/src/client/resources/ResourceTree.tsx

@@ -120,6 +120,8 @@ export interface ResourceTreeProps {
   headingHint?: React.ReactNode;
   /** Scope-specific action shown beside the section heading. */
   sectionAction?: React.ReactNode;
+  /** Scope-specific action shown beneath an empty collection message. */
+  emptyStateAction?: React.ReactNode;
 }
 
 interface CreatingState {
@@ -638,6 +640,7 @@ export function ResourceTree({
   readOnly = false,
   headingHint,
   sectionAction,
+  emptyStateAction,
 }: ResourceTreeProps) {
   const [expanded, setExpanded] = useState<Set<string>>(() => new Set());
   const [creating, setCreating] = useState<CreatingState | null>(null);
@@ -848,11 +851,14 @@ export function ResourceTree({
       {isEmpty && !creating && !isLoading && (
         <div className="flex items-start gap-2 border-y border-border/60 px-2 py-4">
           <IconFile className="mt-0.5 size-3.5 shrink-0 text-muted-foreground" />
-          <p className="text-xs text-muted-foreground">
-            {variant === "collection"
-              ? "No resources in this collection yet"
-              : "No files yet"}
-          </p>
+          <div className="flex flex-col items-start gap-2">
+            <p className="text-xs text-muted-foreground">
+              {variant === "collection"
+                ? "No resources in this collection yet"
+                : "No files yet"}
+            </p>
+            {emptyStateAction}
+          </div>
         </div>
       )}
     </div>

package/corpus/core/src/client/resources/ResourcesPanel.tsx

@@ -1,3 +1,4 @@
+import { Button } from "@agent-native/toolkit/ui/button";
 import {
   IconPlus,
   IconUpload,
@@ -82,6 +83,42 @@ import {
 const WORKSPACE_DOCS_URL = "https://agent-native.com/docs/workspace";
 const LOCAL_WORKSPACE_RESOURCE_METADATA_SOURCE = "local-workspace-resource";
 
+const EMPTY_RESOURCE_ACTION_LABELS: Record<ResourceView, string> = {
+  files: "Add file",
+  instructions: "Add instructions",
+  agents: "Add agent",
+  memory: "Add memory",
+  skills: "Add skill",
+  learnings: "Add learning",
+  "remote-agents": "Add remote agent",
+};
+
+const EMPTY_RESOURCE_SEEDS: Partial<
+  Record<ResourceView, { path: string; content: string; mimeType?: string }>
+> = {
+  instructions: {
+    path: "AGENTS.md",
+    content: "# Agent Instructions\n\n",
+    mimeType: "text/markdown",
+  },
+  memory: {
+    path: "memory/MEMORY.md",
+    content: "# Memory\n\n",
+    mimeType: "text/markdown",
+  },
+  learnings: {
+    path: "LEARNINGS.md",
+    content: "# Learnings\n\n",
+    mimeType: "text/markdown",
+  },
+  "remote-agents": {
+    path: "remote-agents/new-agent.json",
+    content:
+      '{\n  "id": "new-agent",\n  "name": "New agent",\n  "description": "",\n  "url": "",\n  "color": "#6B7280"\n}\n',
+    mimeType: "application/json",
+  },
+};
+
 export type ResourceView =
   | "files"
   | "instructions"
@@ -228,6 +265,9 @@ function CreateMenu({
   onCreated,
   showToast,
   mcpIntegrations,
+  triggerVariant = "icon",
+  triggerLabel,
+  initialView = "menu",
 }: {
   scope: ResourceScope;
   resourceFilter?: ResourceView;
@@ -257,6 +297,9 @@ function CreateMenu({
     message: string,
     opts?: { resourceId?: string; durationMs?: number },
   ) => void;
+  triggerVariant?: "icon" | "outline";
+  triggerLabel?: string;
+  initialView?: CreateMenuView;
 }) {
   const t = useT();
   const [open, setOpen] = useState(false);
@@ -313,7 +356,7 @@ function CreateMenu({
 
   useEffect(() => {
     if (open) {
-      setView("menu");
+      setView(initialView);
       setValue("");
       setAgentName("");
       setAgentDescription("");
@@ -326,7 +369,7 @@ function CreateMenu({
       setSkillUploadFileName("");
       setSkillFlyoutOpen(false);
     }
-  }, [open]);
+  }, [initialView, open]);
 
   useEffect(() => {
     if (view !== "menu" && view !== "agent-form") {
@@ -642,22 +685,36 @@ The result should be a reusable agent profile, not a one-off task response.`,
             e.target.value = "";
           }}
         />
-        <Tooltip>
-          <TooltipTrigger asChild>
-            <PopoverTrigger asChild>
-              <button
-                type="button"
-                className={cn(
-                  "flex h-6 w-6 items-center justify-center rounded-md text-muted-foreground hover:text-foreground hover:bg-accent/50",
-                  open && "bg-accent/50 text-foreground",
-                )}
-              >
-                <IconPlus className="h-3.5 w-3.5" />
-              </button>
-            </PopoverTrigger>
-          </TooltipTrigger>
-          <TooltipContent>Create new...</TooltipContent>
-        </Tooltip>
+        {triggerVariant === "outline" ? (
+          <PopoverTrigger asChild>
+            <Button
+              type="button"
+              variant="outline"
+              size="sm"
+              className="h-7 gap-1.5 px-2.5 text-xs"
+            >
+              <IconPlus className="size-3.5" />
+              {triggerLabel ?? "Add resource"}
+            </Button>
+          </PopoverTrigger>
+        ) : (
+          <Tooltip>
+            <TooltipTrigger asChild>
+              <PopoverTrigger asChild>
+                <button
+                  type="button"
+                  className={cn(
+                    "flex h-6 w-6 items-center justify-center rounded-md text-muted-foreground hover:text-foreground hover:bg-accent/50",
+                    open && "bg-accent/50 text-foreground",
+                  )}
+                >
+                  <IconPlus className="h-3.5 w-3.5" />
+                </button>
+              </PopoverTrigger>
+            </TooltipTrigger>
+            <TooltipContent>Create new...</TooltipContent>
+          </Tooltip>
+        )}
         <PopoverContent
           align="end"
           sideOffset={6}
@@ -1522,6 +1579,70 @@ export function ResourcesPanel({
     );
   };
 
+  const renderEmptyStateAction = (targetScope: ResourceScope) => {
+    if (targetScope === "shared" && !canEditOrg) return null;
+
+    const label = resourceFilter
+      ? EMPTY_RESOURCE_ACTION_LABELS[resourceFilter]
+      : "Add resource";
+
+    if (
+      !resourceFilter ||
+      resourceFilter === "files" ||
+      resourceFilter === "agents" ||
+      resourceFilter === "skills"
+    ) {
+      return (
+        <CreateMenu
+          scope={targetScope}
+          resourceFilter={resourceFilter}
+          onCreateFile={(name) => handleCreateFromToolbar(targetScope, name)}
+          onCreateResource={(path, content, mimeType, opts) =>
+            handleCreateResourceFromToolbar(
+              targetScope,
+              path,
+              content,
+              mimeType,
+              opts,
+            )
+          }
+          onCreateMcpServer={handleCreateMcpServer}
+          canCreateOrgMcp={canCreateOrgMcp}
+          hasOrg={hasOrgForMcp}
+          showToast={showToast}
+          mcpIntegrations={mcpIntegrations}
+          triggerVariant="outline"
+          triggerLabel={label}
+          initialView={resourceFilter === "files" ? "file" : "menu"}
+        />
+      );
+    }
+
+    const seed = EMPTY_RESOURCE_SEEDS[resourceFilter];
+    if (!seed) return null;
+
+    return (
+      <Button
+        type="button"
+        variant="outline"
+        size="sm"
+        className="h-7 gap-1.5 px-2.5 text-xs"
+        disabled={createResource.isPending}
+        onClick={() =>
+          handleCreateResourceFromToolbar(
+            targetScope,
+            seed.path,
+            seed.content,
+            seed.mimeType,
+          )
+        }
+      >
+        <IconPlus className="size-3.5" />
+        {label}
+      </Button>
+    );
+  };
+
   return (
     <div
       className={cn(
@@ -1881,6 +2002,7 @@ export function ResourcesPanel({
                 title="Personal"
                 titleTooltip="Files visible only to you"
                 sectionAction={renderScopeCreateMenu("personal")}
+                emptyStateAction={renderEmptyStateAction("personal")}
               />
             )}
             {showSharedTree && (
@@ -1915,6 +2037,7 @@ export function ResourcesPanel({
                 readOnly={!canEditOrg}
                 headingHint={!canEditOrg ? "Read only" : undefined}
                 sectionAction={renderScopeCreateMenu("shared")}
+                emptyStateAction={renderEmptyStateAction("shared")}
               />
             )}
           </div>

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/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",