@agent-native/core 0.151.1 → 0.152.0

package/corpus/templates/clips/desktop/src/components/MediaDeviceRow.tsx

@@ -1,10 +1,8 @@
-import { IconVinyl } from "@tabler/icons-react";
 import { useMemo } from "react";
 
 import { useMicMeter } from "../hooks/useMicMeter";
 import { CameraIcon, CheckIcon, ChevronDown, MicIcon } from "./Icons";
 import { Switch } from "./Switch";
-import { Tooltip, TooltipContent, TooltipTrigger } from "./Tooltip";
 import { useRowMenu } from "./useRowMenu";
 
 function Toggle({
@@ -234,34 +232,24 @@ export function MediaDeviceRow({
                 )}
               </>
             ) : null}
+            {kind === "mic" && onSystemAudioToggle ? (
+              <div className="row-menu-settings" role="none">
+                <div className="row-menu-divider" aria-hidden />
+                <div className="row-menu-setting">
+                  <span className="row-menu-setting-label">
+                    Record System Audio
+                  </span>
+                  <Switch
+                    on={!!systemAudio}
+                    onChange={(value) => onSystemAudioToggle(value)}
+                    label="Record System Audio"
+                  />
+                </div>
+              </div>
+            ) : null}
           </div>
         ) : null}
       </div>
-      {kind === "mic" && onSystemAudioToggle ? (
-        <Tooltip>
-          <TooltipTrigger asChild>
-            <div
-              className={`row system-audio-option ${systemAudio ? "row-on" : "row-off"}`}
-            >
-              <span className="row-icon">
-                <IconVinyl size={18} stroke={1.75} />
-              </span>
-              <span className="system-audio-option-label">
-                Record System Audio
-              </span>
-              <span className="row-flex" aria-hidden />
-              <Toggle
-                on={!!systemAudio}
-                onChange={onSystemAudioToggle}
-                label="Record System Audio"
-              />
-            </div>
-          </TooltipTrigger>
-          <TooltipContent side="bottom">
-            Record audio from other applications
-          </TooltipContent>
-        </Tooltip>
-      ) : null}
     </div>
   );
 }

package/corpus/templates/clips/desktop/src/styles.css

@@ -108,8 +108,7 @@ button {
 
 body[data-clips-route="popover"] #root {
   min-height: 100vh;
-  padding: var(--popover-shadow-gutter-top) var(--popover-shadow-gutter)
-    var(--popover-shadow-gutter);
+  padding: 0;
 }
 
 body[data-clips-route]:not([data-clips-route="popover"]) #root {
@@ -152,6 +151,355 @@ body[data-clips-route="recording-pill"] #root {
   overflow-y: auto;
 }
 
+/* Settings uses the same calm rail + grouped rows as the hosted workspace
+   settings pages. The native popover keeps its own light/dark tokens, but the
+   hierarchy is intentionally shared: navigate on the left, edit one setting
+   at a time on the right. */
+.settings-page {
+  min-height: 560px;
+  max-height: calc(100vh - 48px);
+  padding: 0;
+  gap: 0;
+  overflow: hidden;
+}
+
+.settings-page-header {
+  flex: 0 0 auto;
+  min-height: 68px;
+  padding: 16px 24px 14px;
+  border-bottom: 1px solid var(--border);
+}
+
+.settings-page-title {
+  display: grid;
+  gap: 2px;
+}
+
+.settings-page-title h2 {
+  font-size: 17px;
+  letter-spacing: -0.01em;
+}
+
+.settings-page-title p {
+  font-size: 11px;
+  color: var(--fg-muted);
+}
+
+.settings-page-layout {
+  display: grid;
+  grid-template-columns: 190px minmax(0, 1fr);
+  min-height: 0;
+  flex: 1 1 auto;
+}
+
+.settings-nav {
+  min-width: 0;
+  padding: 18px 12px;
+  border-right: 1px solid var(--border);
+  background: var(--surface);
+  overflow-y: auto;
+}
+
+.settings-nav-group--start:not(:first-child) {
+  margin-top: 18px;
+}
+
+.settings-nav-group-label {
+  padding: 0 10px 7px;
+  color: var(--fg-subtle);
+  font-size: 10px;
+  font-weight: 700;
+  letter-spacing: 0.08em;
+  text-transform: uppercase;
+}
+
+.settings-nav-button {
+  display: block;
+  width: 100%;
+  min-height: 36px;
+  padding: 8px 10px;
+  border: 0;
+  border-radius: var(--radius-sm);
+  background: transparent;
+  color: var(--fg-muted);
+  cursor: pointer;
+  font-size: 13px;
+  font-weight: 600;
+  text-align: left;
+  transition:
+    background 120ms,
+    color 120ms;
+}
+
+.settings-nav-button:hover {
+  background: var(--surface-hover);
+  color: var(--fg);
+}
+
+.settings-nav-button.is-active {
+  background: var(--bg);
+  color: var(--fg);
+  box-shadow: var(--shadow-sm);
+}
+
+.settings-nav-button:focus-visible {
+  outline: none;
+  box-shadow: 0 0 0 3px var(--brand-ring);
+}
+
+.settings-page-content {
+  min-width: 0;
+  min-height: 0;
+  padding: 24px 28px 32px;
+  overflow-y: auto;
+  overscroll-behavior: contain;
+}
+
+.settings-tab-heading {
+  display: grid;
+  gap: 4px;
+  margin: 0 auto 22px;
+  max-width: 760px;
+}
+
+.settings-tab-heading h3 {
+  margin: 0;
+  font-size: 19px;
+  font-weight: 650;
+  letter-spacing: -0.02em;
+}
+
+.settings-tab-heading p {
+  color: var(--fg-muted);
+  font-size: 12px;
+}
+
+.settings-tab-content {
+  display: grid;
+  gap: 22px;
+  width: 100%;
+  max-width: 760px;
+  margin: 0 auto;
+}
+
+.settings-group {
+  min-width: 0;
+}
+
+.settings-group-header {
+  display: grid;
+  gap: 3px;
+  padding: 0 2px 9px;
+}
+
+.settings-group-header h4 {
+  margin: 0;
+  color: var(--fg);
+  font-size: 13px;
+  font-weight: 700;
+}
+
+.settings-group-header p {
+  color: var(--fg-muted);
+  font-size: 11px;
+  line-height: 1.45;
+}
+
+.settings-group-body {
+  overflow: hidden;
+  border: 1px solid var(--border);
+  border-radius: var(--radius);
+  background: var(--surface);
+  box-shadow: var(--shadow-sm);
+}
+
+.settings-row {
+  display: grid;
+  grid-template-columns: minmax(0, 1fr) minmax(230px, 360px);
+  align-items: center;
+  gap: 24px;
+  min-width: 0;
+  padding: 16px 18px;
+  border-bottom: 1px solid var(--border);
+}
+
+.settings-row:last-child {
+  border-bottom: 0;
+}
+
+.settings-row--stacked {
+  align-items: start;
+}
+
+.settings-row-copy {
+  display: grid;
+  gap: 4px;
+  min-width: 0;
+}
+
+.settings-row-copy strong {
+  color: var(--fg);
+  font-size: 13px;
+  font-weight: 650;
+}
+
+.settings-row-copy span {
+  color: var(--fg-muted);
+  font-size: 11px;
+  line-height: 1.45;
+}
+
+.settings-row-control {
+  display: flex;
+  min-width: 0;
+  justify-content: flex-end;
+}
+
+.settings-row-control > .setup-select,
+.settings-row-control > .setup-shortcut-recorder {
+  width: min(100%, 300px);
+}
+
+.settings-row-control > .setup-textarea {
+  width: 100%;
+}
+
+.settings-control-group {
+  display: flex;
+  align-items: center;
+  justify-content: flex-end;
+  gap: 8px;
+  width: 100%;
+  min-width: 0;
+  flex-wrap: wrap;
+}
+
+.settings-control-group--wide {
+  flex-wrap: nowrap;
+}
+
+.settings-control-group .setup-select {
+  width: min(100%, 300px);
+}
+
+.settings-control-group .settings-url-input {
+  min-width: 0;
+  flex: 1 1 180px;
+}
+
+.settings-page .secondary,
+.settings-page .link-button {
+  width: auto;
+  flex: 0 0 auto;
+  white-space: nowrap;
+}
+
+.settings-url-input {
+  width: 100%;
+}
+
+.settings-row-extra {
+  grid-column: 1 / -1;
+  display: grid;
+  gap: 8px;
+  min-width: 0;
+  padding-top: 2px;
+  color: var(--fg-muted);
+  font-size: 11px;
+  line-height: 1.45;
+}
+
+.settings-row-extra--inline {
+  display: flex;
+  align-items: center;
+  flex-wrap: wrap;
+  gap: 10px;
+}
+
+.settings-row-extra--inline > span:first-child {
+  flex: 1 1 260px;
+}
+
+.settings-text-button {
+  width: auto;
+  padding: 0;
+  border: 0;
+  background: transparent;
+  color: var(--fg-muted);
+  cursor: pointer;
+  font-size: 11px;
+  font-weight: 600;
+  text-decoration: underline;
+}
+
+.settings-text-button:hover {
+  color: var(--fg);
+}
+
+.settings-text-button:focus-visible {
+  outline: none;
+  box-shadow: 0 0 0 3px var(--brand-ring);
+}
+
+.settings-group-inset {
+  padding: 12px 14px;
+}
+
+@media (max-width: 760px) {
+  .settings-page {
+    min-height: 480px;
+  }
+
+  .settings-page-layout {
+    display: flex;
+    flex-direction: column;
+  }
+
+  .settings-nav {
+    display: flex;
+    gap: 4px;
+    padding: 10px 12px;
+    border-right: 0;
+    border-bottom: 1px solid var(--border);
+    overflow-x: auto;
+  }
+
+  .settings-nav-group,
+  .settings-nav-group + .settings-nav-group,
+  .settings-nav-group--start:not(:first-child) {
+    display: contents;
+    margin: 0;
+  }
+
+  .settings-nav-group-label {
+    display: none;
+  }
+
+  .settings-nav-button {
+    flex: 0 0 auto;
+    width: auto;
+  }
+
+  .settings-page-content {
+    padding: 20px 16px 24px;
+  }
+
+  .settings-row {
+    grid-template-columns: minmax(0, 1fr);
+    gap: 12px;
+  }
+
+  .settings-row-control {
+    justify-content: flex-start;
+  }
+
+  .settings-control-group,
+  .settings-control-group--wide {
+    justify-content: flex-start;
+    flex-wrap: wrap;
+  }
+}
+
 /* Recorder Home keeps its navigation present even when active-recording
    content exceeds the restored popover height. Only the content region may
    scroll; the window shell and bottom destinations stay put. */
@@ -665,13 +1013,24 @@ body[data-clips-route="recording-pill"] #root {
   border-radius: 4px;
 }
 
-.system-audio-option {
-  margin-top: 8px;
+.row-menu-divider {
+  height: 1px;
+  margin: 4px 6px;
+  background: var(--border);
 }
 
-.system-audio-option-label {
+.row-menu-setting {
+  display: flex;
+  align-items: center;
+  gap: 10px;
+  padding: 8px 10px;
   color: var(--fg);
   font-size: 13px;
+}
+
+.row-menu-setting-label {
+  flex: 1;
+  min-width: 0;
   font-weight: 500;
 }
 

package/corpus/templates/clips/desktop/src-tauri/src/clips/mod.rs

@@ -1342,7 +1342,7 @@ pub async fn resize_popover(app: AppHandle, height: f64, width: Option<f64>) ->
             })
             .unwrap_or(820.0);
         let clamped = height.clamp(200.0, max_logical_height);
-        let width = width.unwrap_or(360.0).clamp(320.0, 480.0);
+        let width = width.unwrap_or(360.0).clamp(320.0, 960.0);
         let (window_width, window_height) = popover_window_size_logical(width, clamped);
         let _ = w.set_size(tauri::Size::Logical(tauri::LogicalSize::new(
             window_width,

package/corpus/templates/clips/public/manifest.json

@@ -3,7 +3,6 @@
   "short_name": "Clips",
   "description": "Async video — record your screen, share a link, watch it back.",
   "start_url": ".",
-  "display": "standalone",
   "background_color": "#0F0F14",
   "theme_color": "#18181B",
   "icons": [

package/corpus/templates/content/.agents/skills/sharing/SKILL.md

@@ -189,7 +189,7 @@ The framework auto-mounts these actions in every template — no per-template bo
 
 | Action                     | Args                                                                           | Purpose                                   |
 | -------------------------- | ------------------------------------------------------------------------------ | ----------------------------------------- |
-| `share-resource`           | `resourceType, resourceId, principalType, principalId, role, notify?, resourceUrl?` | Grant a user or org access. `notify` defaults to true for individual user shares; `resourceUrl` can provide the direct app link used in the notification email. |
+| `share-resource`           | `resourceType, resourceId, principalType, principalId, role, notify?, resourceUrl?, message?` | Grant a user or org access. `notify` defaults to true for individual user shares; `resourceUrl` can provide the direct app link and `message` an optional short note for the notification email. |
 | `unshare-resource`         | `resourceType, resourceId, principalType, principalId`                         | Revoke access.                            |
 | `list-resource-shares`     | `resourceType, resourceId`                                                     | Current visibility + all share grants.    |
 | `set-resource-visibility`  | `resourceType, resourceId, visibility`                                         | Change to `private` / `org` / `public`.  |

package/corpus/templates/content/.agents/skills/turn-into-app/SKILL.md

@@ -84,6 +84,30 @@ private web access, invent an importer, add fake OAuth, or scrape a logged-in
 page. If the needed context is not visible, ask for an export, transcript, or
 attachment and treat that artifact as imported source material.
 
+### Spreadsheet sources
+
+Spreadsheet attachments are valid source artifacts for this workflow:
+
+- CSV files can be read as tabular text. XLS and XLSX uploads are parsed into
+  bounded worksheet metadata and representative rows when the host supports
+  workbook ingestion. Treat the preview as untrusted user data, preserve the
+  workbook name and worksheet names, and record row/column limits and any
+  truncation in the source brief.
+- A Google Sheets URL is a live provider source, not proof that the sheet is
+  readable. Use an authenticated Google Sheets/Drive connection and the
+  provider API catalog/docs/request path to read only the required sheet or
+  range. If that connection is unavailable, ask for a CSV/XLSX export or the
+  required connection; do not use a public export URL to bypass access.
+- Decide whether the generated app needs a one-time snapshot or a refreshable
+  source. For a snapshot, pass bounded sample context and provenance to the
+  Builder handoff. For a live source, preserve the provider/file identity,
+  worksheet or range, and refresh semantics, then implement a scoped action for
+  reads or refreshes. Never copy workbook bytes, base64 data, credentials, or a
+  full unbounded sheet into SQL, application state, or the handoff prompt.
+- Do not claim the app imported the whole workbook when only a preview was
+  available. Keep unreadable, partial, and failed source states distinct from
+  an empty sheet.
+
 For local code-agent runtimes, deliver a fresh app in a new directory,
 implement the repeatable workflow with buttons and agent handoffs, start its dev
 server, verify the main path, and continue through build/deployment handoff. Do

package/corpus/templates/content/AGENTS.md

@@ -59,6 +59,8 @@ Read the relevant skill before deeper work:
 - `creative-context` — `contextMode`, `selectedContextId`, `currentPackId`,
   `pinnedPackId`. Follow the `creative-context` reuse ladder before generating,
   and respect `contextMode: "off"` without silently restoring a pack.
+- `content-last-location-v1` — the last successfully loaded Page. The UI and
+  landing resolver own this state; do not write it from agent workflows.
 - Use actions for full document content and comment context.
 
 ## Actions
@@ -73,6 +75,7 @@ Read the relevant skill before deeper work:
 | `get-document` | One document with full content |
 | `pull-document` | Flush live collab state, then read (external edits) |
 | `create-document` | Create a page, optionally under a parent |
+| `resolve-content-landing` | Restore the caller's last authorized page or ensure their private Personal welcome page |
 | `edit-document` | Find/replace edit — preferred for small changes |
 | `update-document` | Full rewrite of title, content, or description |
 | `delete-document` | Move a page and its children to Trash |

package/corpus/templates/content/actions/resolve-content-landing.ts

@@ -0,0 +1,120 @@
+import { createHash } from "node:crypto";
+
+import { defineAction } from "@agent-native/core";
+import { readAppState } from "@agent-native/core/application-state";
+import { runWithRequestContext } from "@agent-native/core/server";
+import { getRequestUserEmail } from "@agent-native/core/server/request-context";
+import { z } from "zod";
+
+import {
+  CONTENT_LAST_LOCATION_STATE_KEY,
+  type ContentLandingResolution,
+  type ContentLastLocationState,
+} from "../shared/content-landing.js";
+import { resolveContentDocumentAccess } from "./_content-document-access.js";
+import { normalizeContentSpaceEmail } from "./_content-space-access.js";
+import { personalContentSpaceId } from "./_content-spaces.js";
+import { isSoftDeletedDatabaseDocument } from "./_database-utils.js";
+import createDocumentAction from "./create-document.js";
+
+const WELCOME_TITLE = "Welcome to Agent-Native Content";
+const WELCOME_CONTENT = `Start here with a page that is wholly yours.
+
+- Write a note, plan, or draft.
+- Use the sidebar to find and organize your work.
+- Ask the agent when you want a hand.`;
+
+function welcomeDocumentId(userEmail: string) {
+  const identity = normalizeContentSpaceEmail(userEmail);
+  const digest = createHash("sha256").update(identity).digest("hex");
+  return `content_welcome_${digest.slice(0, 32)}`;
+}
+
+function savedDocumentId(state: Record<string, unknown> | null): string | null {
+  const candidate = state as ContentLastLocationState | null;
+  return typeof candidate?.documentId === "string" && candidate.documentId
+    ? candidate.documentId
+    : null;
+}
+
+async function resolveUsableDocument(documentId: string) {
+  const access = await resolveContentDocumentAccess(documentId);
+  if (!access?.resource || access.resource.trashedAt) return null;
+  if (await isSoftDeletedDatabaseDocument(documentId)) return null;
+  return access.resource;
+}
+
+async function resolveWelcomeDocument(userEmail: string) {
+  const documentId = welcomeDocumentId(userEmail);
+  const document = await resolveUsableDocument(documentId);
+  if (!document) return null;
+
+  const normalizedEmail = normalizeContentSpaceEmail(userEmail);
+  if (
+    normalizeContentSpaceEmail(document.ownerEmail) !== normalizedEmail ||
+    document.spaceId !== personalContentSpaceId(normalizedEmail) ||
+    document.parentId !== null ||
+    document.visibility !== "private" ||
+    document.title !== WELCOME_TITLE
+  ) {
+    return null;
+  }
+  return documentId;
+}
+
+async function resolveWelcome(userEmail: string): Promise<{
+  documentId: string;
+  resolution: Extract<
+    ContentLandingResolution,
+    "welcome-created" | "welcome-reused"
+  >;
+}> {
+  const existing = await resolveWelcomeDocument(userEmail);
+  if (existing) return { documentId: existing, resolution: "welcome-reused" };
+
+  const documentId = welcomeDocumentId(userEmail);
+  const normalizedEmail = normalizeContentSpaceEmail(userEmail);
+  try {
+    await runWithRequestContext({ userEmail: normalizedEmail }, () =>
+      createDocumentAction.run({
+        id: documentId,
+        title: WELCOME_TITLE,
+        content: WELCOME_CONTENT,
+      }),
+    );
+    return { documentId, resolution: "welcome-created" };
+  } catch (error) {
+    // The stable per-user document ID is the cross-request convergence point.
+    // A competing request can own the insert; only reuse it after the complete
+    // personal-page invariant has been rechecked.
+    const raced = await resolveWelcomeDocument(userEmail);
+    if (raced) return { documentId: raced, resolution: "welcome-reused" };
+    throw error;
+  }
+}
+
+export default defineAction({
+  description:
+    "Resolve the signed-in user's safe Content landing page, restoring an authorized last page when possible.",
+  schema: z.object({}),
+  run: async () => {
+    const userEmail = getRequestUserEmail();
+    if (!userEmail) throw new Error("no authenticated user");
+
+    const lastLocation = await readAppState(CONTENT_LAST_LOCATION_STATE_KEY);
+    const lastDocumentId = savedDocumentId(lastLocation);
+    if (lastDocumentId && (await resolveUsableDocument(lastDocumentId))) {
+      return { documentId: lastDocumentId, resolution: "restored" as const };
+    }
+
+    const welcome = await resolveWelcome(userEmail);
+    if (lastDocumentId) {
+      return {
+        documentId: welcome.documentId,
+        resolution: "fallback" as const,
+        fallbackReason: "saved-document-unavailable" as const,
+      };
+    }
+    return welcome;
+  },
+});

package/corpus/templates/content/app/components/editor/DocumentEditor.tsx

@@ -78,6 +78,7 @@ import {
   useDocumentSyncStatus,
   usePushDocumentToNotion,
 } from "@/hooks/use-notion";
+import { rememberContentLandingDocument } from "@/lib/content-landing";
 import {
   canWriteLinkedLocalSource,
   writeDocumentToLinkedLocalSource,
@@ -538,6 +539,14 @@ function DocumentEditorBody({
   databaseDocumentId,
 }: DocumentEditorBodyProps) {
   const t = useT();
+  useEffect(() => {
+    void rememberContentLandingDocument(documentId).catch((error) => {
+      toast.error(t("landing.saveFailed"), {
+        description:
+          error instanceof Error ? error.message : t("empty.genericError"),
+      });
+    });
+  }, [documentId, t]);
   const updateDocument = useUpdateDocument();
   const createDatabase = useCreateContentDatabase(documentId);
   const deleteContentDatabase = useDeleteContentDatabase();