@agent-native/core 0.37.3 → 0.38.0

package/dist/client/rich-markdown-editor/useCollabReconcile.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useCollabReconcile.js","sourceRoot":"","sources":["../../../src/client/rich-markdown-editor/useCollabReconcile.ts"],"names":[],"mappings":"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","sourcesContent":["import { useEffect, useRef, useState, type MutableRefObject } from \"react\";\nimport type { Editor } from \"@tiptap/react\";\nimport type { Transaction } from \"@tiptap/pm/state\";\nimport { isChangeOrigin } from \"@tiptap/extension-collaboration\";\nimport type { Doc as YDoc } from \"yjs\";\nimport type { Awareness } from \"y-protocols/awareness\";\nimport { isReconcileLeadClient } from \"../../collab/client.js\";\nimport { AGENT_CLIENT_ID } from \"../../collab/agent-identity.js\";\n\n/** Reads the current markdown out of the tiptap-markdown storage. */\nexport function getEditorMarkdown(editor: Editor): string {\n  const markdownStorage = editor.storage as unknown as {\n    markdown?: { getMarkdown?: () => string };\n  };\n  return markdownStorage.markdown?.getMarkdown?.() ?? \"\";\n}\n\nexport interface UseCollabReconcileOptions {\n  /** The live editor, or null until it mounts. */\n  editor: Editor | null;\n  /** Shared Y.Doc when collaborating; null disables all collab paths. */\n  ydoc?: YDoc | null;\n  /** Shared awareness; null keeps the sole-client lead path. */\n  awareness?: Awareness | null;\n  /** Authoritative markdown value (SQL source of truth). */\n  value: string;\n  /** Timestamp of the authoritative value; gates newer-than reconcile. */\n  contentUpdatedAt?: string | null;\n  /** Whether the editor accepts edits. Reconcile/seed only run for the live editor. */\n  editable: boolean;\n  /**\n   * Reads the current markdown from the editor. Injected so a dialect could\n   * swap serializers; defaults to the tiptap-markdown storage reader. For an app\n   * with a custom serializer (e.g. Content's `docToNfm(editor.getJSON())`), pass\n   * it here so the seed/reconcile equality checks compare like-for-like.\n   */\n  getMarkdown?: (editor: Editor) => string;\n  /**\n   * Applies the authoritative `value` into the editor. Defaults to passing the\n   * raw markdown string to `editor.commands.setContent`. Apps whose serializer\n   * is NOT tiptap-markdown (Content parses `nfmToDoc(value)` into a PM doc)\n   * override this so seed + reconcile write the correct content shape. The\n   * supplied `options` carry the history/whitespace flags the default path uses;\n   * a custom implementation should forward them when relevant.\n   */\n  setContent?: (\n    editor: Editor,\n    value: string,\n    options: { emitUpdate?: boolean; addToHistory?: boolean },\n  ) => void;\n  /**\n   * Normalizes the authoritative `value` to the canonical markdown the editor\n   * would emit, so the \"already in sync / our own echo\" equality checks match a\n   * serializer that re-canonicalizes (Content's `canonicalizeNfm`). Defaults to\n   * identity (GFM already round-trips byte-stably).\n   */\n  normalizeValue?: (value: string) => string;\n  /**\n   * Decides whether the empty-doc seed should run for the current shared\n   * fragment. Defaults to \"fragment has no nodes, or the editor holds no\n   * semantic markdown\". Apps with sentinel-empty content (Content's\n   * `<empty-block/>` filler) override this. Receives the live fragment length\n   * and the editor's current markdown.\n   */\n  shouldSeed?: (info: {\n    value: string;\n    currentMarkdown: string;\n    fragmentLength: number;\n  }) => boolean;\n  /**\n   * The initial \"applied\" watermark. Default mirrors `contentUpdatedAt`, so a\n   * fresh mount whose Y.Doc already matches SQL doesn't re-apply. Pass `null`\n   * to force the first reconcile pass to adopt authoritative SQL even at the\n   * same timestamp — Content does this so a stale persisted Y.Doc (an agent that\n   * edited the CLOSED doc) is corrected on open. The editor is keyed per\n   * document upstream, so this only affects the first mount of each doc.\n   */\n  initialAppliedUpdatedAt?: string | null;\n}\n\nexport interface UseCollabReconcileResult {\n  /** True when a Y.Doc is bound (collaborative editing active). */\n  collab: boolean;\n  /**\n   * Set true around any programmatic `setContent` so the editor's `onUpdate`\n   * can ignore the resulting transaction (it isn't a user edit).\n   */\n  isSettingContentRef: MutableRefObject<boolean>;\n  /**\n   * Call from `onUpdate` BEFORE serializing. Returns true when the update must\n   * be ignored: editor not editable, mid-programmatic-setContent, or (in collab\n   * mode) a remote-origin transaction. Also records the local typing time.\n   */\n  shouldIgnoreUpdate: (transaction: Transaction) => boolean;\n  /**\n   * Call from `onUpdate` AFTER computing the markdown to emit. Returns false\n   * when the value must NOT be persisted yet (an empty collab doc before the\n   * seed has run); records it as the last-emitted value otherwise.\n   */\n  registerEmitted: (markdown: string) => boolean;\n}\n\n/**\n * The subtle seed / reconcile / lead-client logic for the shared markdown\n * editor, extracted once so it can never be duplicated across embedders.\n *\n * Responsibilities (reproducing the Plan editor's behavior exactly):\n *  - Track whether THIS client is the reconcile lead (sole client always leads;\n *    otherwise elected via {@link isReconcileLeadClient}) and how many other\n *    visible human peers are present.\n *  - Seed an empty shared Y.Doc once from `value` — lead client only — so two\n *    clients opening a brand-new block don't both insert the content.\n *  - Reconcile authoritative external markdown (agent edit, source patch, peer\n *    edit mirrored to SQL) into the editor: in collab mode only the lead client\n *    applies it through `setContent` and Yjs propagates; in non-collab mode this\n *    is the original controlled-value reconcile.\n *  - Provide the `onUpdate` guards (`shouldIgnoreUpdate`, `registerEmitted`) so\n *    the component never persists remote-origin or pre-seed empty content.\n */\n/** Default seed predicate: seed only when the shared doc is genuinely empty. */\nfunction defaultShouldSeed({\n  currentMarkdown,\n  fragmentLength,\n}: {\n  value: string;\n  currentMarkdown: string;\n  fragmentLength: number;\n}): boolean {\n  return fragmentLength === 0 || !currentMarkdown.trim();\n}\n\n/**\n * Default content writer: hand the raw markdown string to `setContent`, which\n * tiptap-markdown overrides to parse the markdown into a ProseMirror doc.\n *\n * IMPORTANT: do NOT pass `parseOptions: { preserveWhitespace: \"full\" }` here.\n * In tiptap v3 the core `setContent` command routes `preserveWhitespace: \"full\"`\n * through `insertContentAt`, which tiptap-markdown ALSO overrides to re-run its\n * markdown parser. That double-parse stringifies the already-parsed PM doc and\n * re-parses it as HTML, so a clean heading/list/code block comes back as the\n * escaped, non-idempotent `&lt;h1&gt;…` — which then escalates every reconcile\n * cycle (`<p>` → `&lt;p&gt;` → `&amp;lt;p&amp;gt;` …). Letting the markdown\n * override parse the string directly (no `parseOptions`) round-trips byte-stably\n * for the GFM corpus, including code-block and empty-line whitespace. Content's\n * NFM path supplies its own `setContent` (it passes a pre-parsed PM doc) and is\n * unaffected by this default.\n */\nfunction defaultSetContent(\n  editor: Editor,\n  value: string,\n  options: { emitUpdate?: boolean; addToHistory?: boolean },\n): void {\n  if (options.addToHistory === false) {\n    editor\n      .chain()\n      .command(({ tr }) => {\n        // addToHistory:false so cmd+z (or Yjs undo) doesn't erase\n        // externally-loaded content.\n        tr.setMeta(\"addToHistory\", false);\n        return true;\n      })\n      .setContent(value, { emitUpdate: options.emitUpdate })\n      .run();\n    return;\n  }\n  editor.commands.setContent(value);\n}\n\nexport function useCollabReconcile({\n  editor,\n  ydoc = null,\n  awareness = null,\n  value,\n  contentUpdatedAt,\n  editable,\n  getMarkdown = getEditorMarkdown,\n  setContent = defaultSetContent,\n  normalizeValue = (v) => v,\n  shouldSeed = defaultShouldSeed,\n  initialAppliedUpdatedAt,\n}: UseCollabReconcileOptions): UseCollabReconcileResult {\n  const collab = !!ydoc;\n  const isSettingContentRef = useRef(false);\n  const lastEmittedRef = useRef(\"\");\n  const lastTypedAtRef = useRef(0);\n  // The raw authoritative `value` string the reconcile last applied. When the\n  // SAME raw string is re-fetched (a lagging poll, or a source-sync that keeps\n  // re-supplying the same stored markdown), applying it again would only\n  // reproduce the doc we already hold — and if `value` is NON-idempotent\n  // (serialize(parse(value)) !== value) re-applying compounds the divergence\n  // every cycle (`<p>` → `&lt;p&gt;` → `&amp;lt;p&amp;gt;` …). Tracked so the\n  // identical re-fetch is recognized and skipped.\n  const lastAppliedValueRef = useRef<string | null>(null);\n  // The editor's SERIALIZED output captured right AFTER the last reconcile/seed\n  // apply (`getMarkdown(editor)` once the content settled). For non-idempotent\n  // input this is what autosave actually persists, so the NEXT poll hands it\n  // back as the new `value`. Comparing the incoming value against this lets the\n  // reconcile recognize its own echo even when the raw string changed once, so\n  // it never re-parses content the editor already represents. This is the\n  // doc-equivalence guard that breaks the escalation loop.\n  const lastAppliedSerializedRef = useRef<string | null>(null);\n  const lastAppliedUpdatedAtRef = useRef<string | null>(\n    initialAppliedUpdatedAt !== undefined\n      ? initialAppliedUpdatedAt\n      : (contentUpdatedAt ?? null),\n  );\n\n  // Whether THIS client is the one that seeds the empty shared doc / applies an\n  // authoritative external snapshot into it. Exactly one client does, so the\n  // content isn't inserted once per open editor. A sole client always leads.\n  const [isLeadClient, setIsLeadClient] = useState(true);\n  // Count of OTHER visible human collaborators. When >0, a peer's edit also\n  // arrives via Yjs, so external markdown reconcile must defer (avoid applying\n  // the same change through both Yjs and setContent).\n  const peerCountRef = useRef(0);\n  useEffect(() => {\n    if (!collab || !awareness || !ydoc) {\n      setIsLeadClient(true);\n      peerCountRef.current = 0;\n      return;\n    }\n    const update = () => {\n      setIsLeadClient(isReconcileLeadClient(awareness, ydoc.clientID));\n      let peers = 0;\n      awareness.getStates().forEach((state, clientId) => {\n        if (clientId === ydoc.clientID) return; // self\n        if (clientId === AGENT_CLIENT_ID) return; // agent isn't a Yjs editor\n        const s = state as { user?: unknown; visible?: boolean };\n        if (s && s.user && s.visible !== false) peers += 1;\n      });\n      peerCountRef.current = peers;\n    };\n    update();\n    awareness.on(\"change\", update);\n    document.addEventListener(\"visibilitychange\", update);\n    return () => {\n      awareness.off(\"change\", update);\n      document.removeEventListener(\"visibilitychange\", update);\n    };\n  }, [collab, awareness, ydoc]);\n\n  // Collab seed: populate an empty shared Y.Doc from the markdown `value` once.\n  // The Collaboration extension does NOT auto-seed; only the lead client does,\n  // so two clients opening a brand-new block at once don't both seed (which\n  // would duplicate the content via concurrent inserts at the same position).\n  const seededRef = useRef(false);\n  useEffect(() => {\n    if (!collab || !editor || editor.isDestroyed || !ydoc) return;\n    if (seededRef.current) return;\n    if (!isLeadClient) return;\n    if (!value.trim()) return;\n    const fragment = ydoc.getXmlFragment(\"default\");\n    const currentMarkdown = getMarkdown(editor);\n    // Seed only when the shared doc is genuinely empty — either the fragment has\n    // no nodes yet, or it holds no semantic markdown (an empty paragraph, or an\n    // app's sentinel-empty filler via a custom `shouldSeed`).\n    if (\n      shouldSeed({ value, currentMarkdown, fragmentLength: fragment.length })\n    ) {\n      isSettingContentRef.current = true;\n      setContent(editor, value, {});\n      isSettingContentRef.current = false;\n      const serialized = getMarkdown(editor);\n      lastEmittedRef.current = serialized;\n      lastAppliedValueRef.current = value;\n      lastAppliedSerializedRef.current = serialized;\n      if (contentUpdatedAt) lastAppliedUpdatedAtRef.current = contentUpdatedAt;\n    }\n    seededRef.current = true;\n  }, [\n    collab,\n    editor,\n    ydoc,\n    value,\n    isLeadClient,\n    contentUpdatedAt,\n    getMarkdown,\n    setContent,\n    shouldSeed,\n  ]);\n\n  // Reconcile authoritative external markdown (agent edit, source patch, or a\n  // peer edit mirrored to SQL) into the live editor. In collab mode only the\n  // lead client applies it through setContent; Yjs propagates the result to\n  // every other client. In non-collab mode this is the original controlled-value\n  // reconcile, unchanged.\n  useEffect(() => {\n    if (!editor || editor.isDestroyed) return;\n\n    let cancelled = false;\n    let retry: ReturnType<typeof setTimeout> | null = null;\n    // With peers present, a peer's edit also arrives via Yjs. Defer one poll\n    // cycle (+margin) and re-check before applying via setContent so the same\n    // change isn't inserted twice (Yjs + setContent → duplicated region).\n    const PEER_SETTLE_MS = 2500;\n\n    const apply = (deferred = false) => {\n      if (cancelled || editor.isDestroyed) return;\n      // In collab mode, defer all reconcile until the shared doc is seeded so we\n      // never setContent over an unseeded fragment.\n      if (collab && !seededRef.current) {\n        retry = setTimeout(() => apply(deferred), 300);\n        return;\n      }\n      const currentMarkdown = getMarkdown(editor);\n      // Compare against the canonical form the editor would emit so a serializer\n      // that re-normalizes (Content's NFM) still recognizes \"already in sync\".\n      const normalizedValue = normalizeValue(value);\n      // Whether the editor still holds exactly what THIS hook last applied (the\n      // user hasn't edited since). Only then are the round-trip echo guards\n      // below safe: if the user has since edited away from the applied content,\n      // an external snapshot equal to a previously-applied value is a real\n      // revert and must NOT be swallowed as an echo.\n      const editorUnchangedSinceApply =\n        lastAppliedSerializedRef.current !== null &&\n        currentMarkdown === lastAppliedSerializedRef.current;\n\n      // Doc-equivalence skip. Never re-apply content the editor already\n      // represents — comparing by DOC EQUIVALENCE, not raw strings/timestamps:\n      //   1. `currentMarkdown === normalizedValue` — the editor's CURRENT\n      //      serialized doc already equals the (normalized) incoming value.\n      //   2. `value === lastEmittedRef.current` — the incoming value is our own\n      //      just-emitted markdown echoing back.\n      //   3. `value === lastAppliedValueRef.current` — the SAME raw value we\n      //      already applied is being re-supplied (a lagging poll or a\n      //      source-sync re-handing the same stored markdown). Applying it again\n      //      would only reproduce the doc we hold; for NON-idempotent input it\n      //      would compound divergence. Guarded by `editorUnchangedSinceApply`\n      //      so a deliberate revert-to-previous after a local edit still lands.\n      //   4. `normalizedValue === lastAppliedSerializedRef.current` — the\n      //      incoming value round-trips to the serialized output we last\n      //      produced (our own autosaved echo coming back from SQL). For\n      //      non-idempotent input the raw string differs from what we were\n      //      handed, but it is doc-equivalent to what the editor already shows,\n      //      so re-parsing it must be skipped. This is the guard that stops the\n      //      `<p>` → `&lt;p&gt;` → `&amp;lt;p&amp;gt;` escalation.\n      if (\n        currentMarkdown === normalizedValue ||\n        value === lastEmittedRef.current ||\n        (editorUnchangedSinceApply &&\n          (value === lastAppliedValueRef.current ||\n            normalizedValue === lastAppliedSerializedRef.current))\n      ) {\n        if (contentUpdatedAt) {\n          lastAppliedUpdatedAtRef.current = contentUpdatedAt;\n        }\n        return;\n      }\n\n      const externalNewer =\n        !lastAppliedUpdatedAtRef.current ||\n        !contentUpdatedAt ||\n        contentUpdatedAt > lastAppliedUpdatedAtRef.current;\n\n      // Only the lead client applies an authoritative snapshot into the shared\n      // Y.Doc; peers receive it through Yjs sync.\n      if (collab && !isLeadClient) {\n        if (contentUpdatedAt && !externalNewer) {\n          lastAppliedUpdatedAtRef.current = contentUpdatedAt;\n        }\n        return;\n      }\n\n      // Never clobber an in-progress edit. While the user is actively typing\n      // (focused and a keystroke landed within the window) defer and re-check —\n      // applying external content now would yank text out from under them and,\n      // for non-idempotent input, fight every keystroke. Newer external content\n      // retries so it still lands once they pause; older-or-equal content is a\n      // stale poll and is dropped outright while focused.\n      const typingRecently =\n        editor.isFocused && Date.now() - lastTypedAtRef.current < 1500;\n      if (typingRecently) {\n        if (externalNewer) {\n          retry = setTimeout(() => apply(deferred), 700);\n        }\n        return;\n      }\n      if (!externalNewer && editor.isFocused) return;\n\n      // Race guard: with peers present, let Yjs deliver a peer's edit first.\n      // Defer once and re-check — a peer edit makes the equality check above\n      // no-op next pass; an agent/source edit still differs and applies.\n      if (collab && externalNewer && !deferred && peerCountRef.current > 0) {\n        retry = setTimeout(() => apply(true), PEER_SETTLE_MS);\n        return;\n      }\n\n      queueMicrotask(() => {\n        if (cancelled || editor.isDestroyed) return;\n        // Re-check doc-equivalence at apply time. Between the decision above and\n        // this microtask a peer/Yjs edit (or our own prior apply) may have made\n        // the editor already represent this value — re-applying would be a\n        // wasted setContent that, for non-idempotent input, re-triggers the\n        // loop. Skip when the editor's current serialization already matches the\n        // normalized value, or the value round-trips to what we last produced.\n        const beforeMarkdown = getMarkdown(editor);\n        const normalized = normalizeValue(value);\n        const unchangedSinceApply =\n          lastAppliedSerializedRef.current !== null &&\n          beforeMarkdown === lastAppliedSerializedRef.current;\n        if (\n          beforeMarkdown === normalized ||\n          (unchangedSinceApply &&\n            normalized === lastAppliedSerializedRef.current)\n        ) {\n          lastAppliedValueRef.current = value;\n          if (contentUpdatedAt) {\n            lastAppliedUpdatedAtRef.current = contentUpdatedAt;\n          }\n          return;\n        }\n        isSettingContentRef.current = true;\n        setContent(editor, value, { emitUpdate: false, addToHistory: false });\n        isSettingContentRef.current = false;\n        // Capture the SERIALIZED result, not the raw value. For non-idempotent\n        // input these differ; recording the serialized output is what lets the\n        // next poll (which returns this serialized form) be recognized as our\n        // own echo and skipped — stabilizing the doc after exactly one apply.\n        const serialized = getMarkdown(editor);\n        lastEmittedRef.current = serialized;\n        lastAppliedValueRef.current = value;\n        lastAppliedSerializedRef.current = serialized;\n        if (contentUpdatedAt) {\n          lastAppliedUpdatedAtRef.current = contentUpdatedAt;\n        }\n      });\n    };\n\n    apply();\n    return () => {\n      cancelled = true;\n      if (retry) clearTimeout(retry);\n    };\n  }, [\n    contentUpdatedAt,\n    editor,\n    value,\n    collab,\n    isLeadClient,\n    getMarkdown,\n    setContent,\n    normalizeValue,\n  ]);\n\n  const shouldIgnoreUpdate = (transaction: Transaction): boolean => {\n    if (!editable || isSettingContentRef.current) return true;\n    // In collab mode, never persist remote-originated changes (the initial Yjs\n    // state load or a peer's edit arriving via sync). Each client saves only its\n    // OWN local edits; a peer's edit is saved by that peer. Without this, a\n    // lagging Y.Doc load would write stale markdown over newer SQL.\n    if (collab && transaction && isChangeOrigin(transaction)) return true;\n    lastTypedAtRef.current = Date.now();\n    return false;\n  };\n\n  const registerEmitted = (markdown: string): boolean => {\n    // Don't persist an empty doc before Collaboration has seeded — that would\n    // clobber the saved block content with an empty string.\n    if (collab && !markdown.trim()) return false;\n    lastEmittedRef.current = markdown;\n    return true;\n  };\n\n  return {\n    collab,\n    isSettingContentRef,\n    shouldIgnoreUpdate,\n    registerEmitted,\n  };\n}\n"]}

package/dist/client/track.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Fire an analytics event from browser/app code. This is the client-side twin
+ * of the server `track()` from `@agent-native/core/tracking`: it POSTs to the
+ * `/_agent-native/track` framework route, which forwards the event to the SAME
+ * registered server-side providers (PostHog, Mixpanel, Amplitude, webhook,
+ * etc.). The event is attributed server-side to the signed-in user (and active
+ * org) — callers do not pass an identity.
+ *
+ * ```ts
+ * import { track } from "@agent-native/core/client";
+ *
+ * track("checkout.completed", { total: 49.99, items: 3 });
+ * ```
+ *
+ * Fire-and-forget by design: it never blocks the UI, never throws, and
+ * swallows network errors. The returned promise resolves once the request
+ * settles (useful in tests) but does not reject.
+ *
+ * This is intentionally distinct from the framework's internal browser
+ * analytics (`trackEvent` / pageview tracking in `analytics.ts`), which feeds
+ * Agent Native's own product telemetry. Use `track()` for your app's own
+ * analytics events.
+ */
+export declare function track(name: string, properties?: Record<string, unknown>): Promise<void>;
+//# sourceMappingURL=track.d.ts.map

package/dist/client/track.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"track.d.ts","sourceRoot":"","sources":["../../src/client/track.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,KAAK,CACnB,IAAI,EAAE,MAAM,EACZ,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GACnC,OAAO,CAAC,IAAI,CAAC,CA4Bf"}

package/dist/client/track.js

@@ -0,0 +1,53 @@
+import { agentNativePath } from "./api-path.js";
+/**
+ * Fire an analytics event from browser/app code. This is the client-side twin
+ * of the server `track()` from `@agent-native/core/tracking`: it POSTs to the
+ * `/_agent-native/track` framework route, which forwards the event to the SAME
+ * registered server-side providers (PostHog, Mixpanel, Amplitude, webhook,
+ * etc.). The event is attributed server-side to the signed-in user (and active
+ * org) — callers do not pass an identity.
+ *
+ * ```ts
+ * import { track } from "@agent-native/core/client";
+ *
+ * track("checkout.completed", { total: 49.99, items: 3 });
+ * ```
+ *
+ * Fire-and-forget by design: it never blocks the UI, never throws, and
+ * swallows network errors. The returned promise resolves once the request
+ * settles (useful in tests) but does not reject.
+ *
+ * This is intentionally distinct from the framework's internal browser
+ * analytics (`trackEvent` / pageview tracking in `analytics.ts`), which feeds
+ * Agent Native's own product telemetry. Use `track()` for your app's own
+ * analytics events.
+ */
+export function track(name, properties) {
+    if (typeof fetch !== "function")
+        return Promise.resolve();
+    if (typeof name !== "string" || !name.trim())
+        return Promise.resolve();
+    let body;
+    try {
+        body = JSON.stringify(properties === undefined ? { name } : { name, properties });
+    }
+    catch {
+        // Non-serializable properties — drop rather than throw into the caller.
+        return Promise.resolve();
+    }
+    return fetch(agentNativePath("/_agent-native/track"), {
+        method: "POST",
+        headers: {
+            "Content-Type": "application/json",
+            // Custom header forces a preflight cross-origin; the framework CSRF
+            // middleware trusts it as a first-party marker. Matches the convention
+            // used by other client writes (application-state, guided-questions).
+            "X-Agent-Native-CSRF": "1",
+        },
+        body,
+        keepalive: true,
+    })
+        .then(() => undefined)
+        .catch(() => undefined);
+}
+//# sourceMappingURL=track.js.map

package/dist/client/track.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"track.js","sourceRoot":"","sources":["../../src/client/track.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAEhD;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,MAAM,UAAU,KAAK,CACnB,IAAY,EACZ,UAAoC;IAEpC,IAAI,OAAO,KAAK,KAAK,UAAU;QAAE,OAAO,OAAO,CAAC,OAAO,EAAE,CAAC;IAC1D,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE;QAAE,OAAO,OAAO,CAAC,OAAO,EAAE,CAAC;IAEvE,IAAI,IAAY,CAAC;IACjB,IAAI,CAAC;QACH,IAAI,GAAG,IAAI,CAAC,SAAS,CACnB,UAAU,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,UAAU,EAAE,CAC3D,CAAC;IACJ,CAAC;IAAC,MAAM,CAAC;QACP,wEAAwE;QACxE,OAAO,OAAO,CAAC,OAAO,EAAE,CAAC;IAC3B,CAAC;IAED,OAAO,KAAK,CAAC,eAAe,CAAC,sBAAsB,CAAC,EAAE;QACpD,MAAM,EAAE,MAAM;QACd,OAAO,EAAE;YACP,cAAc,EAAE,kBAAkB;YAClC,oEAAoE;YACpE,uEAAuE;YACvE,qEAAqE;YACrE,qBAAqB,EAAE,GAAG;SAC3B;QACD,IAAI;QACJ,SAAS,EAAE,IAAI;KAChB,CAAC;SACC,IAAI,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC;SACrB,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;AAC5B,CAAC","sourcesContent":["import { agentNativePath } from \"./api-path.js\";\n\n/**\n * Fire an analytics event from browser/app code. This is the client-side twin\n * of the server `track()` from `@agent-native/core/tracking`: it POSTs to the\n * `/_agent-native/track` framework route, which forwards the event to the SAME\n * registered server-side providers (PostHog, Mixpanel, Amplitude, webhook,\n * etc.). The event is attributed server-side to the signed-in user (and active\n * org) — callers do not pass an identity.\n *\n * ```ts\n * import { track } from \"@agent-native/core/client\";\n *\n * track(\"checkout.completed\", { total: 49.99, items: 3 });\n * ```\n *\n * Fire-and-forget by design: it never blocks the UI, never throws, and\n * swallows network errors. The returned promise resolves once the request\n * settles (useful in tests) but does not reject.\n *\n * This is intentionally distinct from the framework's internal browser\n * analytics (`trackEvent` / pageview tracking in `analytics.ts`), which feeds\n * Agent Native's own product telemetry. Use `track()` for your app's own\n * analytics events.\n */\nexport function track(\n  name: string,\n  properties?: Record<string, unknown>,\n): Promise<void> {\n  if (typeof fetch !== \"function\") return Promise.resolve();\n  if (typeof name !== \"string\" || !name.trim()) return Promise.resolve();\n\n  let body: string;\n  try {\n    body = JSON.stringify(\n      properties === undefined ? { name } : { name, properties },\n    );\n  } catch {\n    // Non-serializable properties — drop rather than throw into the caller.\n    return Promise.resolve();\n  }\n\n  return fetch(agentNativePath(\"/_agent-native/track\"), {\n    method: \"POST\",\n    headers: {\n      \"Content-Type\": \"application/json\",\n      // Custom header forces a preflight cross-origin; the framework CSRF\n      // middleware trusts it as a first-party marker. Matches the convention\n      // used by other client writes (application-state, guided-questions).\n      \"X-Agent-Native-CSRF\": \"1\",\n    },\n    body,\n    keepalive: true,\n  })\n    .then(() => undefined)\n    .catch(() => undefined);\n}\n"]}

package/dist/client/use-action.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"use-action.d.ts","sourceRoot":"","sources":["../../src/client/use-action.ts"],"names":[],"mappings":"AAwBA,OAAO,KAAK,EACV,eAAe,EACf,kBAAkB,EACnB,MAAM,uBAAuB,CAAC;AA4B/B;;;;;GAKG;AACH,MAAM,WAAW,cAAc;CAAG;AAElC,2FAA2F;AAC3F,KAAK,UAAU,GAAG,MAAM,cAAc,SAAS,KAAK,GAChD,MAAM,GACN,CAAC,MAAM,cAAc,GAAG,MAAM,CAAC,GAAG,CAAC,MAAM,GAAG,EAAE,CAAC,CAAC;AAEpD,8EAA8E;AAC9E,KAAK,YAAY,CAAC,CAAC,SAAS,MAAM,IAAI,CAAC,SAAS,MAAM,cAAc,GAChE,cAAc,CAAC,CAAC,CAAC,SAAS;IAAE,MAAM,EAAE,MAAM,CAAC,CAAA;CAAE,GAC3C,CAAC,GACD,GAAG,GACL,GAAG,CAAC;AAER,iGAAiG;AACjG,KAAK,YAAY,CAAC,CAAC,SAAS,MAAM,IAAI,CAAC,SAAS,MAAM,cAAc,GAChE,cAAc,CAAC,CAAC,CAAC,SAAS;IAAE,MAAM,EAAE,MAAM,CAAC,CAAA;CAAE,GAC3C,CAAC,GACD,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GACrB,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;AAExB,MAAM,MAAM,kBAAkB,GAAG,KAAK,GAAG,MAAM,GAAG,KAAK,GAAG,QAAQ,CAAC;AAEnE,MAAM,WAAW,uBAAuB;IACtC,MAAM,CAAC,EAAE,kBAAkB,CAAC;CAC7B;AAmBD,wBAAgB,0BAA0B,CACxC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAC1B,MAAM,CAMR;AAgID;;;;;;GAMG;AACH,wBAAgB,UAAU,CACxB,OAAO,GAAG,SAAS,EACnB,KAAK,SAAS,UAAU,GAAG,UAAU,EAErC,UAAU,EAAE,KAAK,EACjB,MAAM,CAAC,EAAE,YAAY,CAAC,KAAK,CAAC,EAC5B,OAAO,GAAE,uBAA4B,GACpC,OAAO,CAAC,OAAO,SAAS,SAAS,GAAG,YAAY,CAAC,KAAK,CAAC,GAAG,OAAO,CAAC,CAGpE;AAMD;;;;;;;;;;;;;GAaG;AACH,wBAAgB,cAAc,CAC5B,OAAO,GAAG,SAAS,EACnB,KAAK,SAAS,UAAU,GAAG,UAAU,EAErC,UAAU,EAAE,KAAK,EACjB,MAAM,CAAC,EAAE,YAAY,CAAC,KAAK,CAAC,EAC5B,OAAO,CAAC,EAAE,IAAI,CACZ,eAAe,CAAC,OAAO,SAAS,SAAS,GAAG,YAAY,CAAC,KAAK,CAAC,GAAG,OAAO,CAAC,EAC1E,UAAU,GAAG,SAAS,CACvB,6JASF;AAMD;;;;;;;;;;;GAWG;AACH,wBAAgB,iBAAiB,CAC/B,KAAK,GAAG,SAAS,EACjB,UAAU,GAAG,SAAS,EACtB,KAAK,SAAS,UAAU,GAAG,UAAU,EAErC,UAAU,EAAE,KAAK,EACjB,OAAO,CAAC,EAAE,IAAI,CACZ,kBAAkB,CAChB,KAAK,SAAS,SAAS,GAAG,YAAY,CAAC,KAAK,CAAC,GAAG,KAAK,EACrD,KAAK,EACL,UAAU,SAAS,SAAS,GAAG,YAAY,CAAC,KAAK,CAAC,GAAG,UAAU,CAChE,EACD,YAAY,CACb,GAAG;IACF,MAAM,CAAC,EAAE,MAAM,GAAG,KAAK,GAAG,QAAQ,CAAC;CACpC,6LAuBF"}
+{"version":3,"file":"use-action.d.ts","sourceRoot":"","sources":["../../src/client/use-action.ts"],"names":[],"mappings":"AAwBA,OAAO,KAAK,EACV,eAAe,EACf,kBAAkB,EACnB,MAAM,uBAAuB,CAAC;AA4B/B;;;;;GAKG;AACH,MAAM,WAAW,cAAc;CAAG;AAElC,2FAA2F;AAC3F,KAAK,UAAU,GAAG,MAAM,cAAc,SAAS,KAAK,GAChD,MAAM,GACN,CAAC,MAAM,cAAc,GAAG,MAAM,CAAC,GAAG,CAAC,MAAM,GAAG,EAAE,CAAC,CAAC;AAEpD,8EAA8E;AAC9E,KAAK,YAAY,CAAC,CAAC,SAAS,MAAM,IAAI,CAAC,SAAS,MAAM,cAAc,GAChE,cAAc,CAAC,CAAC,CAAC,SAAS;IAAE,MAAM,EAAE,MAAM,CAAC,CAAA;CAAE,GAC3C,CAAC,GACD,GAAG,GACL,GAAG,CAAC;AAER,iGAAiG;AACjG,KAAK,YAAY,CAAC,CAAC,SAAS,MAAM,IAAI,CAAC,SAAS,MAAM,cAAc,GAChE,cAAc,CAAC,CAAC,CAAC,SAAS;IAAE,MAAM,EAAE,MAAM,CAAC,CAAA;CAAE,GAC3C,CAAC,GACD,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GACrB,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;AAExB,MAAM,MAAM,kBAAkB,GAAG,KAAK,GAAG,MAAM,GAAG,KAAK,GAAG,QAAQ,CAAC;AAEnE,MAAM,WAAW,uBAAuB;IACtC,MAAM,CAAC,EAAE,kBAAkB,CAAC;CAC7B;AAmBD,wBAAgB,0BAA0B,CACxC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAC1B,MAAM,CAMR;AAsID;;;;;;GAMG;AACH,wBAAgB,UAAU,CACxB,OAAO,GAAG,SAAS,EACnB,KAAK,SAAS,UAAU,GAAG,UAAU,EAErC,UAAU,EAAE,KAAK,EACjB,MAAM,CAAC,EAAE,YAAY,CAAC,KAAK,CAAC,EAC5B,OAAO,GAAE,uBAA4B,GACpC,OAAO,CAAC,OAAO,SAAS,SAAS,GAAG,YAAY,CAAC,KAAK,CAAC,GAAG,OAAO,CAAC,CAGpE;AAMD;;;;;;;;;;;;;GAaG;AACH,wBAAgB,cAAc,CAC5B,OAAO,GAAG,SAAS,EACnB,KAAK,SAAS,UAAU,GAAG,UAAU,EAErC,UAAU,EAAE,KAAK,EACjB,MAAM,CAAC,EAAE,YAAY,CAAC,KAAK,CAAC,EAC5B,OAAO,CAAC,EAAE,IAAI,CACZ,eAAe,CAAC,OAAO,SAAS,SAAS,GAAG,YAAY,CAAC,KAAK,CAAC,GAAG,OAAO,CAAC,EAC1E,UAAU,GAAG,SAAS,CACvB,6JASF;AAMD;;;;;;;;;;;GAWG;AACH,wBAAgB,iBAAiB,CAC/B,KAAK,GAAG,SAAS,EACjB,UAAU,GAAG,SAAS,EACtB,KAAK,SAAS,UAAU,GAAG,UAAU,EAErC,UAAU,EAAE,KAAK,EACjB,OAAO,CAAC,EAAE,IAAI,CACZ,kBAAkB,CAChB,KAAK,SAAS,SAAS,GAAG,YAAY,CAAC,KAAK,CAAC,GAAG,KAAK,EACrD,KAAK,EACL,UAAU,SAAS,SAAS,GAAG,YAAY,CAAC,KAAK,CAAC,GAAG,UAAU,CAChE,EACD,YAAY,CACb,GAAG;IACF,MAAM,CAAC,EAAE,MAAM,GAAG,KAAK,GAAG,QAAQ,CAAC;CACpC,6LAuBF"}

package/dist/client/use-action.js

@@ -78,6 +78,12 @@ async function actionFetch(name, method, params) {
     let url = `${ACTION_PREFIX}/${name}`;
     const headers = {
         "Content-Type": "application/json",
+        // Tag browser-originated action calls so the server can set
+        // `ctx.caller = "frontend"` (vs a bare programmatic `"http"` POST).
+        // Mirrors the X-Agent-Native-Tool-Bridge: 1 convention. The header is
+        // safe to expose: CORS allows it (see action-routes.ts) and it carries
+        // no auth weight — it only narrows the caller tag.
+        "X-Agent-Native-Frontend": "1",
     };
     const tz = resolveUserTimezone();
     if (tz)

package/dist/client/use-action.js.map

@@ -1 +1 @@
-{"version":3,"file":"use-action.js","sourceRoot":"","sources":["../../src/client/use-action.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Client helpers for calling actions through the framework transport.\n *\n * Components should prefer `useActionQuery` / `useActionMutation`; use\n * `callAction` for imperative cases such as debounced search, prefetching, or\n * event handlers that do not fit a hook.\n *\n * ## End-to-end type safety\n *\n * When the action type registry is generated (via the Vite plugin or CLI),\n * `useActionQuery` and `useActionMutation` automatically infer the correct\n * return type and parameter types from the action definitions — no manual\n * type annotations needed.\n *\n * ```ts\n * // Fully typed — return type and params inferred from the action's defineAction()\n * const { data } = useActionQuery(\"list-forms\", { status: \"published\" });\n * //      ^? Form[]  (inferred from the action's run() return type)\n * ```\n *\n * Without the registry, the hooks fall back to `any` types for backward\n * compatibility.\n */\nimport { useQuery, useMutation, useQueryClient } from \"@tanstack/react-query\";\nimport type {\n  UseQueryOptions,\n  UseMutationOptions,\n} from \"@tanstack/react-query\";\nimport { agentNativePath } from \"./api-path.js\";\nimport { ensureEmbedAuthFetchInterceptor } from \"./embed-auth.js\";\n\nconst ACTION_PREFIX = agentNativePath(\"/_agent-native/actions\");\n\nfunction isAuthFailure(error: unknown): boolean {\n  return (\n    !!error &&\n    typeof error === \"object\" &&\n    \"status\" in error &&\n    ((error as { status?: unknown }).status === 401 ||\n      (error as { status?: unknown }).status === 403)\n  );\n}\n\nfunction defaultActionQueryRetry(\n  failureCount: number,\n  error: unknown,\n): boolean {\n  if (isAuthFailure(error)) return false;\n  return failureCount < 3;\n}\n\n// ---------------------------------------------------------------------------\n// Action type registry — augmented by generated code\n// ---------------------------------------------------------------------------\n\n/**\n * Action type registry. This interface is empty by default and gets augmented\n * by the auto-generated `.generated/action-types.d.ts` file. When augmented,\n * it maps action names to their parameter and return types, enabling\n * end-to-end type safety for `useActionQuery` and `useActionMutation`.\n */\nexport interface ActionRegistry {}\n\n/** Resolves to the union of registered action names, or `string` if no registry exists. */\ntype ActionName = keyof ActionRegistry extends never\n  ? string\n  : (keyof ActionRegistry & string) | (string & {});\n\n/** Resolves the return type of an action, or `any` if not in the registry. */\ntype ActionResult<T extends string> = T extends keyof ActionRegistry\n  ? ActionRegistry[T] extends { result: infer R }\n    ? R\n    : any\n  : any;\n\n/** Resolves the parameter type of an action, or `Record<string, any>` if not in the registry. */\ntype ActionParams<T extends string> = T extends keyof ActionRegistry\n  ? ActionRegistry[T] extends { params: infer P }\n    ? P\n    : Record<string, any>\n  : Record<string, any>;\n\nexport type ClientActionMethod = \"GET\" | \"POST\" | \"PUT\" | \"DELETE\";\n\nexport interface ClientActionCallOptions {\n  method?: ClientActionMethod;\n}\n\n// ---------------------------------------------------------------------------\n// Fetch helper\n// ---------------------------------------------------------------------------\n\n/**\n * Resolve the browser's IANA timezone (e.g. \"America/Los_Angeles\"). This is\n * sent on every action request as `x-user-timezone` so server-side defaults\n * like \"today\" honor the user's local day rather than the server's UTC clock.\n */\nfunction resolveUserTimezone(): string | undefined {\n  try {\n    return Intl.DateTimeFormat().resolvedOptions().timeZone || undefined;\n  } catch {\n    return undefined;\n  }\n}\n\nexport function serializeActionQueryParams(\n  params: Record<string, any>,\n): string {\n  const qs = new URLSearchParams();\n  for (const [key, value] of Object.entries(params)) {\n    appendActionQueryParam(qs, key, value);\n  }\n  return qs.toString();\n}\n\nfunction appendActionQueryParam(\n  qs: URLSearchParams,\n  key: string,\n  value: unknown,\n) {\n  if (value === null || value === undefined) return;\n  if (Array.isArray(value)) {\n    // Use bracket keys so a one-item array still arrives as an array after the\n    // server parses URLSearchParams. Repeated bare keys lose that distinction.\n    for (const item of value) {\n      appendActionQueryParam(qs, `${key}[]`, item);\n    }\n    return;\n  }\n  qs.append(key, String(value));\n}\n\nasync function actionFetch<T>(\n  name: string,\n  method: string,\n  params?: Record<string, any>,\n): Promise<T> {\n  ensureEmbedAuthFetchInterceptor();\n  let url = `${ACTION_PREFIX}/${name}`;\n  const headers: Record<string, string> = {\n    \"Content-Type\": \"application/json\",\n  };\n  const tz = resolveUserTimezone();\n  if (tz) headers[\"x-user-timezone\"] = tz;\n  const init: RequestInit = {\n    method,\n    headers,\n    cache: \"no-store\",\n  };\n\n  if (method === \"GET\" && params && Object.keys(params).length > 0) {\n    // Skip null/undefined so optional filters don't turn into literal \"null\"\n    // strings in the query string (e.g. `?folderId=null`).\n    const qs = serializeActionQueryParams(params);\n    if (qs) url += `?${qs}`;\n  } else if (method !== \"GET\" && params) {\n    init.body = JSON.stringify(params);\n  }\n\n  let res: Response;\n  try {\n    res = await fetch(url, init);\n  } catch (err) {\n    // Network failures, CORS, server unreachable, etc. — give the caller a\n    // useful message instead of the opaque \"Failed to fetch\".\n    const cause = err instanceof Error ? err.message : String(err);\n    throw new Error(`Action ${name} failed: ${cause}`);\n  }\n\n  // 204 No Content — nothing to parse.\n  if (res.status === 204) return null as T;\n\n  // Read the body as text first so we can:\n  //   - tolerate empty bodies (avoids \"Unexpected end of JSON input\")\n  //   - surface non-JSON error responses (HTML 401/404 pages, plain text, etc.)\n  //   - preserve the original HTTP status in the thrown error\n  // Track read failures separately from \"no body\" — a stream interruption /\n  // decode failure on a 2xx response should error rather than silently\n  // succeed with `null`.\n  let raw = \"\";\n  let readFailed = false;\n  let readError: unknown;\n  try {\n    raw = await res.text();\n  } catch (err) {\n    readFailed = true;\n    readError = err;\n  }\n\n  let data: any = undefined;\n  let parseFailed = false;\n  if (raw.length > 0) {\n    try {\n      data = JSON.parse(raw);\n    } catch {\n      // Body wasn't JSON — keep `data` undefined and use the raw text below.\n      parseFailed = true;\n    }\n  }\n\n  if (!res.ok) {\n    const message =\n      (data && (data.error || data.message)) ||\n      // Truncate non-JSON bodies so we don't dump entire HTML pages into the\n      // console, but still give the developer a hint as to what came back.\n      (raw && raw.slice(0, 200)) ||\n      res.statusText ||\n      `HTTP ${res.status}`;\n    const error = new Error(`Action ${name} failed: ${message}`);\n    (error as any).status = res.status;\n    throw error;\n  }\n\n  // 2xx but the body couldn't even be read (mid-stream abort, decode failure,\n  // etc.). Don't silently treat that as a `null` success.\n  if (readFailed) {\n    const cause =\n      readError instanceof Error ? readError.message : String(readError);\n    const error = new Error(\n      `Action ${name} returned ${res.status} but the body could not be read: ${cause}`,\n    );\n    (error as any).status = res.status;\n    throw error;\n  }\n\n  // 2xx with a non-empty, non-JSON body. Action callers expect typed data, so\n  // returning `null` here would silently mask a real server bug (e.g. a proxy\n  // returning HTML 200 instead of JSON). Throw instead — empty bodies (handled\n  // above by the `raw.length > 0` guard and the 204 short-circuit) still\n  // correctly resolve to `null`.\n  if (parseFailed) {\n    const error = new Error(\n      `Action ${name} returned a non-JSON ${res.status} response: ${raw.slice(0, 200)}`,\n    );\n    (error as any).status = res.status;\n    throw error;\n  }\n\n  return (data ?? (null as unknown)) as T;\n}\n\n/**\n * Imperatively call an action from browser/client code.\n *\n * Prefer `useActionQuery` / `useActionMutation` in React render flows. Use this\n * helper when a hook is not ergonomic; do not hand-write fetch calls to\n * `/_agent-native/actions/*` in components.\n */\nexport function callAction<\n  TResult = undefined,\n  TName extends ActionName = ActionName,\n>(\n  actionName: TName,\n  params?: ActionParams<TName>,\n  options: ClientActionCallOptions = {},\n): Promise<TResult extends undefined ? ActionResult<TName> : TResult> {\n  type R = TResult extends undefined ? ActionResult<TName> : TResult;\n  return actionFetch<R>(actionName, options.method ?? \"POST\", params);\n}\n\n// ---------------------------------------------------------------------------\n// Query hook\n// ---------------------------------------------------------------------------\n\n/**\n * Query an action exposed as GET.\n *\n * When the action type registry is generated, the return type and parameter\n * types are inferred automatically from the action's `defineAction()` call.\n *\n * ```ts\n * // Type-safe — no manual generic needed\n * const { data } = useActionQuery(\"list-meals\", { date: \"2025-01-01\" });\n *\n * // Manual override still works when needed\n * const { data } = useActionQuery<CustomType>(\"list-meals\");\n * ```\n */\nexport function useActionQuery<\n  TResult = undefined,\n  TName extends ActionName = ActionName,\n>(\n  actionName: TName,\n  params?: ActionParams<TName>,\n  options?: Omit<\n    UseQueryOptions<TResult extends undefined ? ActionResult<TName> : TResult>,\n    \"queryKey\" | \"queryFn\"\n  >,\n) {\n  type R = TResult extends undefined ? ActionResult<TName> : TResult;\n  return useQuery<R>({\n    queryKey: [\"action\", actionName, params],\n    queryFn: () => actionFetch<R>(actionName, \"GET\", params),\n    retry: defaultActionQueryRetry,\n    ...options,\n  });\n}\n\n// ---------------------------------------------------------------------------\n// Mutation hook\n// ---------------------------------------------------------------------------\n\n/**\n * Mutate via an action exposed as POST (default), PUT, or DELETE.\n *\n * When the action type registry is generated, the return type and parameter\n * types are inferred automatically.\n *\n * ```ts\n * // Type-safe\n * const { mutate } = useActionMutation(\"log-meal\");\n * mutate({ name: \"Salad\", calories: 350 });\n * ```\n */\nexport function useActionMutation<\n  TData = undefined,\n  TVariables = undefined,\n  TName extends ActionName = ActionName,\n>(\n  actionName: TName,\n  options?: Omit<\n    UseMutationOptions<\n      TData extends undefined ? ActionResult<TName> : TData,\n      Error,\n      TVariables extends undefined ? ActionParams<TName> : TVariables\n    >,\n    \"mutationFn\"\n  > & {\n    method?: \"POST\" | \"PUT\" | \"DELETE\";\n  },\n) {\n  const queryClient = useQueryClient();\n  const {\n    method: methodOpt,\n    onSuccess,\n    ...restOptions\n  } = options ?? ({} as any);\n  const method = methodOpt ?? \"POST\";\n\n  type D = TData extends undefined ? ActionResult<TName> : TData;\n  type V = TVariables extends undefined ? ActionParams<TName> : TVariables;\n\n  return useMutation<D, Error, V>({\n    ...restOptions,\n    mutationFn: (params) =>\n      actionFetch<D>(actionName, method, params as Record<string, any>),\n    onSuccess: (...args: [any, any, any]) => {\n      // Invalidate related action queries\n      queryClient.invalidateQueries({ queryKey: [\"action\"] });\n      (onSuccess as Function)?.(...args);\n    },\n  });\n}\n"]}
+{"version":3,"file":"use-action.js","sourceRoot":"","sources":["../../src/client/use-action.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Client helpers for calling actions through the framework transport.\n *\n * Components should prefer `useActionQuery` / `useActionMutation`; use\n * `callAction` for imperative cases such as debounced search, prefetching, or\n * event handlers that do not fit a hook.\n *\n * ## End-to-end type safety\n *\n * When the action type registry is generated (via the Vite plugin or CLI),\n * `useActionQuery` and `useActionMutation` automatically infer the correct\n * return type and parameter types from the action definitions — no manual\n * type annotations needed.\n *\n * ```ts\n * // Fully typed — return type and params inferred from the action's defineAction()\n * const { data } = useActionQuery(\"list-forms\", { status: \"published\" });\n * //      ^? Form[]  (inferred from the action's run() return type)\n * ```\n *\n * Without the registry, the hooks fall back to `any` types for backward\n * compatibility.\n */\nimport { useQuery, useMutation, useQueryClient } from \"@tanstack/react-query\";\nimport type {\n  UseQueryOptions,\n  UseMutationOptions,\n} from \"@tanstack/react-query\";\nimport { agentNativePath } from \"./api-path.js\";\nimport { ensureEmbedAuthFetchInterceptor } from \"./embed-auth.js\";\n\nconst ACTION_PREFIX = agentNativePath(\"/_agent-native/actions\");\n\nfunction isAuthFailure(error: unknown): boolean {\n  return (\n    !!error &&\n    typeof error === \"object\" &&\n    \"status\" in error &&\n    ((error as { status?: unknown }).status === 401 ||\n      (error as { status?: unknown }).status === 403)\n  );\n}\n\nfunction defaultActionQueryRetry(\n  failureCount: number,\n  error: unknown,\n): boolean {\n  if (isAuthFailure(error)) return false;\n  return failureCount < 3;\n}\n\n// ---------------------------------------------------------------------------\n// Action type registry — augmented by generated code\n// ---------------------------------------------------------------------------\n\n/**\n * Action type registry. This interface is empty by default and gets augmented\n * by the auto-generated `.generated/action-types.d.ts` file. When augmented,\n * it maps action names to their parameter and return types, enabling\n * end-to-end type safety for `useActionQuery` and `useActionMutation`.\n */\nexport interface ActionRegistry {}\n\n/** Resolves to the union of registered action names, or `string` if no registry exists. */\ntype ActionName = keyof ActionRegistry extends never\n  ? string\n  : (keyof ActionRegistry & string) | (string & {});\n\n/** Resolves the return type of an action, or `any` if not in the registry. */\ntype ActionResult<T extends string> = T extends keyof ActionRegistry\n  ? ActionRegistry[T] extends { result: infer R }\n    ? R\n    : any\n  : any;\n\n/** Resolves the parameter type of an action, or `Record<string, any>` if not in the registry. */\ntype ActionParams<T extends string> = T extends keyof ActionRegistry\n  ? ActionRegistry[T] extends { params: infer P }\n    ? P\n    : Record<string, any>\n  : Record<string, any>;\n\nexport type ClientActionMethod = \"GET\" | \"POST\" | \"PUT\" | \"DELETE\";\n\nexport interface ClientActionCallOptions {\n  method?: ClientActionMethod;\n}\n\n// ---------------------------------------------------------------------------\n// Fetch helper\n// ---------------------------------------------------------------------------\n\n/**\n * Resolve the browser's IANA timezone (e.g. \"America/Los_Angeles\"). This is\n * sent on every action request as `x-user-timezone` so server-side defaults\n * like \"today\" honor the user's local day rather than the server's UTC clock.\n */\nfunction resolveUserTimezone(): string | undefined {\n  try {\n    return Intl.DateTimeFormat().resolvedOptions().timeZone || undefined;\n  } catch {\n    return undefined;\n  }\n}\n\nexport function serializeActionQueryParams(\n  params: Record<string, any>,\n): string {\n  const qs = new URLSearchParams();\n  for (const [key, value] of Object.entries(params)) {\n    appendActionQueryParam(qs, key, value);\n  }\n  return qs.toString();\n}\n\nfunction appendActionQueryParam(\n  qs: URLSearchParams,\n  key: string,\n  value: unknown,\n) {\n  if (value === null || value === undefined) return;\n  if (Array.isArray(value)) {\n    // Use bracket keys so a one-item array still arrives as an array after the\n    // server parses URLSearchParams. Repeated bare keys lose that distinction.\n    for (const item of value) {\n      appendActionQueryParam(qs, `${key}[]`, item);\n    }\n    return;\n  }\n  qs.append(key, String(value));\n}\n\nasync function actionFetch<T>(\n  name: string,\n  method: string,\n  params?: Record<string, any>,\n): Promise<T> {\n  ensureEmbedAuthFetchInterceptor();\n  let url = `${ACTION_PREFIX}/${name}`;\n  const headers: Record<string, string> = {\n    \"Content-Type\": \"application/json\",\n    // Tag browser-originated action calls so the server can set\n    // `ctx.caller = \"frontend\"` (vs a bare programmatic `\"http\"` POST).\n    // Mirrors the X-Agent-Native-Tool-Bridge: 1 convention. The header is\n    // safe to expose: CORS allows it (see action-routes.ts) and it carries\n    // no auth weight — it only narrows the caller tag.\n    \"X-Agent-Native-Frontend\": \"1\",\n  };\n  const tz = resolveUserTimezone();\n  if (tz) headers[\"x-user-timezone\"] = tz;\n  const init: RequestInit = {\n    method,\n    headers,\n    cache: \"no-store\",\n  };\n\n  if (method === \"GET\" && params && Object.keys(params).length > 0) {\n    // Skip null/undefined so optional filters don't turn into literal \"null\"\n    // strings in the query string (e.g. `?folderId=null`).\n    const qs = serializeActionQueryParams(params);\n    if (qs) url += `?${qs}`;\n  } else if (method !== \"GET\" && params) {\n    init.body = JSON.stringify(params);\n  }\n\n  let res: Response;\n  try {\n    res = await fetch(url, init);\n  } catch (err) {\n    // Network failures, CORS, server unreachable, etc. — give the caller a\n    // useful message instead of the opaque \"Failed to fetch\".\n    const cause = err instanceof Error ? err.message : String(err);\n    throw new Error(`Action ${name} failed: ${cause}`);\n  }\n\n  // 204 No Content — nothing to parse.\n  if (res.status === 204) return null as T;\n\n  // Read the body as text first so we can:\n  //   - tolerate empty bodies (avoids \"Unexpected end of JSON input\")\n  //   - surface non-JSON error responses (HTML 401/404 pages, plain text, etc.)\n  //   - preserve the original HTTP status in the thrown error\n  // Track read failures separately from \"no body\" — a stream interruption /\n  // decode failure on a 2xx response should error rather than silently\n  // succeed with `null`.\n  let raw = \"\";\n  let readFailed = false;\n  let readError: unknown;\n  try {\n    raw = await res.text();\n  } catch (err) {\n    readFailed = true;\n    readError = err;\n  }\n\n  let data: any = undefined;\n  let parseFailed = false;\n  if (raw.length > 0) {\n    try {\n      data = JSON.parse(raw);\n    } catch {\n      // Body wasn't JSON — keep `data` undefined and use the raw text below.\n      parseFailed = true;\n    }\n  }\n\n  if (!res.ok) {\n    const message =\n      (data && (data.error || data.message)) ||\n      // Truncate non-JSON bodies so we don't dump entire HTML pages into the\n      // console, but still give the developer a hint as to what came back.\n      (raw && raw.slice(0, 200)) ||\n      res.statusText ||\n      `HTTP ${res.status}`;\n    const error = new Error(`Action ${name} failed: ${message}`);\n    (error as any).status = res.status;\n    throw error;\n  }\n\n  // 2xx but the body couldn't even be read (mid-stream abort, decode failure,\n  // etc.). Don't silently treat that as a `null` success.\n  if (readFailed) {\n    const cause =\n      readError instanceof Error ? readError.message : String(readError);\n    const error = new Error(\n      `Action ${name} returned ${res.status} but the body could not be read: ${cause}`,\n    );\n    (error as any).status = res.status;\n    throw error;\n  }\n\n  // 2xx with a non-empty, non-JSON body. Action callers expect typed data, so\n  // returning `null` here would silently mask a real server bug (e.g. a proxy\n  // returning HTML 200 instead of JSON). Throw instead — empty bodies (handled\n  // above by the `raw.length > 0` guard and the 204 short-circuit) still\n  // correctly resolve to `null`.\n  if (parseFailed) {\n    const error = new Error(\n      `Action ${name} returned a non-JSON ${res.status} response: ${raw.slice(0, 200)}`,\n    );\n    (error as any).status = res.status;\n    throw error;\n  }\n\n  return (data ?? (null as unknown)) as T;\n}\n\n/**\n * Imperatively call an action from browser/client code.\n *\n * Prefer `useActionQuery` / `useActionMutation` in React render flows. Use this\n * helper when a hook is not ergonomic; do not hand-write fetch calls to\n * `/_agent-native/actions/*` in components.\n */\nexport function callAction<\n  TResult = undefined,\n  TName extends ActionName = ActionName,\n>(\n  actionName: TName,\n  params?: ActionParams<TName>,\n  options: ClientActionCallOptions = {},\n): Promise<TResult extends undefined ? ActionResult<TName> : TResult> {\n  type R = TResult extends undefined ? ActionResult<TName> : TResult;\n  return actionFetch<R>(actionName, options.method ?? \"POST\", params);\n}\n\n// ---------------------------------------------------------------------------\n// Query hook\n// ---------------------------------------------------------------------------\n\n/**\n * Query an action exposed as GET.\n *\n * When the action type registry is generated, the return type and parameter\n * types are inferred automatically from the action's `defineAction()` call.\n *\n * ```ts\n * // Type-safe — no manual generic needed\n * const { data } = useActionQuery(\"list-meals\", { date: \"2025-01-01\" });\n *\n * // Manual override still works when needed\n * const { data } = useActionQuery<CustomType>(\"list-meals\");\n * ```\n */\nexport function useActionQuery<\n  TResult = undefined,\n  TName extends ActionName = ActionName,\n>(\n  actionName: TName,\n  params?: ActionParams<TName>,\n  options?: Omit<\n    UseQueryOptions<TResult extends undefined ? ActionResult<TName> : TResult>,\n    \"queryKey\" | \"queryFn\"\n  >,\n) {\n  type R = TResult extends undefined ? ActionResult<TName> : TResult;\n  return useQuery<R>({\n    queryKey: [\"action\", actionName, params],\n    queryFn: () => actionFetch<R>(actionName, \"GET\", params),\n    retry: defaultActionQueryRetry,\n    ...options,\n  });\n}\n\n// ---------------------------------------------------------------------------\n// Mutation hook\n// ---------------------------------------------------------------------------\n\n/**\n * Mutate via an action exposed as POST (default), PUT, or DELETE.\n *\n * When the action type registry is generated, the return type and parameter\n * types are inferred automatically.\n *\n * ```ts\n * // Type-safe\n * const { mutate } = useActionMutation(\"log-meal\");\n * mutate({ name: \"Salad\", calories: 350 });\n * ```\n */\nexport function useActionMutation<\n  TData = undefined,\n  TVariables = undefined,\n  TName extends ActionName = ActionName,\n>(\n  actionName: TName,\n  options?: Omit<\n    UseMutationOptions<\n      TData extends undefined ? ActionResult<TName> : TData,\n      Error,\n      TVariables extends undefined ? ActionParams<TName> : TVariables\n    >,\n    \"mutationFn\"\n  > & {\n    method?: \"POST\" | \"PUT\" | \"DELETE\";\n  },\n) {\n  const queryClient = useQueryClient();\n  const {\n    method: methodOpt,\n    onSuccess,\n    ...restOptions\n  } = options ?? ({} as any);\n  const method = methodOpt ?? \"POST\";\n\n  type D = TData extends undefined ? ActionResult<TName> : TData;\n  type V = TVariables extends undefined ? ActionParams<TName> : TVariables;\n\n  return useMutation<D, Error, V>({\n    ...restOptions,\n    mutationFn: (params) =>\n      actionFetch<D>(actionName, method, params as Record<string, any>),\n    onSuccess: (...args: [any, any, any]) => {\n      // Invalidate related action queries\n      queryClient.invalidateQueries({ queryKey: [\"action\"] });\n      (onSuccess as Function)?.(...args);\n    },\n  });\n}\n"]}

package/dist/client/use-session.d.ts

@@ -7,8 +7,9 @@ interface UseSessionResult {
 /**
  * Client-side hook to get the current auth session.
  *
- * - In dev mode: immediately returns { email: "local@localhost" }
- * - In production: fetches /_agent-native/auth/session and returns the result
+ * Fetches the current session from `/_agent-native/auth/session` and returns
+ * it, or `null` when unauthenticated. This behavior is the same in all
+ * environments — there is no dev bypass and no `local@localhost` sentinel.
  *
  * Templates should use this instead of building their own auth context.
  */

package/dist/client/use-session.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"use-session.d.ts","sourceRoot":"","sources":["../../src/client/use-session.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAIrD,YAAY,EAAE,WAAW,EAAE,CAAC;AAE5B,UAAU,gBAAgB;IACxB,OAAO,EAAE,WAAW,GAAG,IAAI,CAAC;IAC5B,SAAS,EAAE,OAAO,CAAC;CACpB;AAED;;;;;;;GAOG;AACH,wBAAgB,UAAU,IAAI,gBAAgB,CA4D7C"}
+{"version":3,"file":"use-session.d.ts","sourceRoot":"","sources":["../../src/client/use-session.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAIrD,YAAY,EAAE,WAAW,EAAE,CAAC;AAE5B,UAAU,gBAAgB;IACxB,OAAO,EAAE,WAAW,GAAG,IAAI,CAAC;IAC5B,SAAS,EAAE,OAAO,CAAC;CACpB;AAED;;;;;;;;GAQG;AACH,wBAAgB,UAAU,IAAI,gBAAgB,CA4D7C"}

package/dist/client/use-session.js

@@ -4,8 +4,9 @@ import { agentNativePath } from "./api-path.js";
 /**
  * Client-side hook to get the current auth session.
  *
- * - In dev mode: immediately returns { email: "local@localhost" }
- * - In production: fetches /_agent-native/auth/session and returns the result
+ * Fetches the current session from `/_agent-native/auth/session` and returns
+ * it, or `null` when unauthenticated. This behavior is the same in all
+ * environments — there is no dev bypass and no `local@localhost` sentinel.
  *
  * Templates should use this instead of building their own auth context.
  */

package/dist/client/use-session.js.map

@@ -1 +1 @@
-{"version":3,"file":"use-session.js","sourceRoot":"","sources":["../../src/client/use-session.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,OAAO,CAAC;AAEpD,OAAO,EAAE,aAAa,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AACnE,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAShD;;;;;;;GAOG;AACH,MAAM,UAAU,UAAU;IACxB,MAAM,CAAC,OAAO,EAAE,UAAU,CAAC,GAAG,QAAQ,CAAqB,IAAI,CAAC,CAAC;IACjE,MAAM,CAAC,SAAS,EAAE,YAAY,CAAC,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC;IACjD,MAAM,UAAU,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;IAEjC,SAAS,CAAC,GAAG,EAAE;QACb,IAAI,SAAS,GAAG,KAAK,CAAC;QAEtB,KAAK,UAAU,YAAY;YACzB,IAAI,QAAQ,GAAG,KAAK,CAAC;YACrB,IAAI,QAAQ,GAAuB,IAAI,CAAC;YACxC,IAAI,CAAC;gBACH,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,eAAe,CAAC,6BAA6B,CAAC,CAAC,CAAC;gBACxE,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC;oBACZ,UAAU,CAAC,IAAI,CAAC,CAAC;oBACjB,OAAO;gBACT,CAAC;gBACD,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC,IAAI,EAAE,CAAC;gBAC9B,IAAI,CAAC,SAAS,EAAE,CAAC;oBACf,+DAA+D;oBAC/D,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;wBACf,UAAU,CAAC,IAAI,CAAC,CAAC;oBACnB,CAAC;yBAAM,CAAC;wBACN,QAAQ,GAAG,IAAmB,CAAC;wBAC/B,UAAU,CAAC,QAAQ,CAAC,CAAC;wBACrB,QAAQ,GAAG,IAAI,CAAC;oBAClB,CAAC;gBACH,CAAC;YACH,CAAC;YAAC,MAAM,CAAC;gBACP,IAAI,CAAC,SAAS;oBAAE,UAAU,CAAC,IAAI,CAAC,CAAC;YACnC,CAAC;oBAAS,CAAC;gBACT,IAAI,CAAC,SAAS,EAAE,CAAC;oBACf,YAAY,CAAC,KAAK,CAAC,CAAC;oBACpB,IAAI,QAAQ,EAAE,CAAC;wBACb,aAAa,CACX;4BACE,EAAE,EAAE,QAAQ,CAAC,MAAM;4BACnB,KAAK,EAAE,QAAQ,CAAC,KAAK;4BACrB,QAAQ,EAAE,QAAQ,CAAC,IAAI;yBACxB,EACD,QAAQ,CAAC,KAAK,IAAI,IAAI,CACvB,CAAC;oBACJ,CAAC;yBAAM,CAAC;wBACN,aAAa,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;oBAC5B,CAAC;oBACD,IAAI,CAAC,UAAU,CAAC,OAAO,EAAE,CAAC;wBACxB,UAAU,CAAC,OAAO,GAAG,IAAI,CAAC;wBAC1B,kBAAkB,CAAC,QAAQ,CAAC,CAAC;oBAC/B,CAAC;gBACH,CAAC;YACH,CAAC;QACH,CAAC;QAED,YAAY,EAAE,CAAC;QACf,OAAO,GAAG,EAAE;YACV,SAAS,GAAG,IAAI,CAAC;QACnB,CAAC,CAAC;IACJ,CAAC,EAAE,EAAE,CAAC,CAAC;IAEP,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,CAAC;AAChC,CAAC","sourcesContent":["import { useState, useEffect, useRef } from \"react\";\nimport type { AuthSession } from \"../server/auth.js\";\nimport { setSentryUser, trackSessionStatus } from \"./analytics.js\";\nimport { agentNativePath } from \"./api-path.js\";\n\nexport type { AuthSession };\n\ninterface UseSessionResult {\n  session: AuthSession | null;\n  isLoading: boolean;\n}\n\n/**\n * Client-side hook to get the current auth session.\n *\n * - In dev mode: immediately returns { email: \"local@localhost\" }\n * - In production: fetches /_agent-native/auth/session and returns the result\n *\n * Templates should use this instead of building their own auth context.\n */\nexport function useSession(): UseSessionResult {\n  const [session, setSession] = useState<AuthSession | null>(null);\n  const [isLoading, setIsLoading] = useState(true);\n  const trackedRef = useRef(false);\n\n  useEffect(() => {\n    let cancelled = false;\n\n    async function fetchSession() {\n      let signedIn = false;\n      let resolved: AuthSession | null = null;\n      try {\n        const res = await fetch(agentNativePath(\"/_agent-native/auth/session\"));\n        if (!res.ok) {\n          setSession(null);\n          return;\n        }\n        const data = await res.json();\n        if (!cancelled) {\n          // The endpoint returns { error: \"...\" } when not authenticated\n          if (data.error) {\n            setSession(null);\n          } else {\n            resolved = data as AuthSession;\n            setSession(resolved);\n            signedIn = true;\n          }\n        }\n      } catch {\n        if (!cancelled) setSession(null);\n      } finally {\n        if (!cancelled) {\n          setIsLoading(false);\n          if (resolved) {\n            setSentryUser(\n              {\n                id: resolved.userId,\n                email: resolved.email,\n                username: resolved.name,\n              },\n              resolved.orgId ?? null,\n            );\n          } else {\n            setSentryUser(null, null);\n          }\n          if (!trackedRef.current) {\n            trackedRef.current = true;\n            trackSessionStatus(signedIn);\n          }\n        }\n      }\n    }\n\n    fetchSession();\n    return () => {\n      cancelled = true;\n    };\n  }, []);\n\n  return { session, isLoading };\n}\n"]}
+{"version":3,"file":"use-session.js","sourceRoot":"","sources":["../../src/client/use-session.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,OAAO,CAAC;AAEpD,OAAO,EAAE,aAAa,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AACnE,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAShD;;;;;;;;GAQG;AACH,MAAM,UAAU,UAAU;IACxB,MAAM,CAAC,OAAO,EAAE,UAAU,CAAC,GAAG,QAAQ,CAAqB,IAAI,CAAC,CAAC;IACjE,MAAM,CAAC,SAAS,EAAE,YAAY,CAAC,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC;IACjD,MAAM,UAAU,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;IAEjC,SAAS,CAAC,GAAG,EAAE;QACb,IAAI,SAAS,GAAG,KAAK,CAAC;QAEtB,KAAK,UAAU,YAAY;YACzB,IAAI,QAAQ,GAAG,KAAK,CAAC;YACrB,IAAI,QAAQ,GAAuB,IAAI,CAAC;YACxC,IAAI,CAAC;gBACH,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,eAAe,CAAC,6BAA6B,CAAC,CAAC,CAAC;gBACxE,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC;oBACZ,UAAU,CAAC,IAAI,CAAC,CAAC;oBACjB,OAAO;gBACT,CAAC;gBACD,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC,IAAI,EAAE,CAAC;gBAC9B,IAAI,CAAC,SAAS,EAAE,CAAC;oBACf,+DAA+D;oBAC/D,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;wBACf,UAAU,CAAC,IAAI,CAAC,CAAC;oBACnB,CAAC;yBAAM,CAAC;wBACN,QAAQ,GAAG,IAAmB,CAAC;wBAC/B,UAAU,CAAC,QAAQ,CAAC,CAAC;wBACrB,QAAQ,GAAG,IAAI,CAAC;oBAClB,CAAC;gBACH,CAAC;YACH,CAAC;YAAC,MAAM,CAAC;gBACP,IAAI,CAAC,SAAS;oBAAE,UAAU,CAAC,IAAI,CAAC,CAAC;YACnC,CAAC;oBAAS,CAAC;gBACT,IAAI,CAAC,SAAS,EAAE,CAAC;oBACf,YAAY,CAAC,KAAK,CAAC,CAAC;oBACpB,IAAI,QAAQ,EAAE,CAAC;wBACb,aAAa,CACX;4BACE,EAAE,EAAE,QAAQ,CAAC,MAAM;4BACnB,KAAK,EAAE,QAAQ,CAAC,KAAK;4BACrB,QAAQ,EAAE,QAAQ,CAAC,IAAI;yBACxB,EACD,QAAQ,CAAC,KAAK,IAAI,IAAI,CACvB,CAAC;oBACJ,CAAC;yBAAM,CAAC;wBACN,aAAa,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;oBAC5B,CAAC;oBACD,IAAI,CAAC,UAAU,CAAC,OAAO,EAAE,CAAC;wBACxB,UAAU,CAAC,OAAO,GAAG,IAAI,CAAC;wBAC1B,kBAAkB,CAAC,QAAQ,CAAC,CAAC;oBAC/B,CAAC;gBACH,CAAC;YACH,CAAC;QACH,CAAC;QAED,YAAY,EAAE,CAAC;QACf,OAAO,GAAG,EAAE;YACV,SAAS,GAAG,IAAI,CAAC;QACnB,CAAC,CAAC;IACJ,CAAC,EAAE,EAAE,CAAC,CAAC;IAEP,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,CAAC;AAChC,CAAC","sourcesContent":["import { useState, useEffect, useRef } from \"react\";\nimport type { AuthSession } from \"../server/auth.js\";\nimport { setSentryUser, trackSessionStatus } from \"./analytics.js\";\nimport { agentNativePath } from \"./api-path.js\";\n\nexport type { AuthSession };\n\ninterface UseSessionResult {\n  session: AuthSession | null;\n  isLoading: boolean;\n}\n\n/**\n * Client-side hook to get the current auth session.\n *\n * Fetches the current session from `/_agent-native/auth/session` and returns\n * it, or `null` when unauthenticated. This behavior is the same in all\n * environments — there is no dev bypass and no `local@localhost` sentinel.\n *\n * Templates should use this instead of building their own auth context.\n */\nexport function useSession(): UseSessionResult {\n  const [session, setSession] = useState<AuthSession | null>(null);\n  const [isLoading, setIsLoading] = useState(true);\n  const trackedRef = useRef(false);\n\n  useEffect(() => {\n    let cancelled = false;\n\n    async function fetchSession() {\n      let signedIn = false;\n      let resolved: AuthSession | null = null;\n      try {\n        const res = await fetch(agentNativePath(\"/_agent-native/auth/session\"));\n        if (!res.ok) {\n          setSession(null);\n          return;\n        }\n        const data = await res.json();\n        if (!cancelled) {\n          // The endpoint returns { error: \"...\" } when not authenticated\n          if (data.error) {\n            setSession(null);\n          } else {\n            resolved = data as AuthSession;\n            setSession(resolved);\n            signedIn = true;\n          }\n        }\n      } catch {\n        if (!cancelled) setSession(null);\n      } finally {\n        if (!cancelled) {\n          setIsLoading(false);\n          if (resolved) {\n            setSentryUser(\n              {\n                id: resolved.userId,\n                email: resolved.email,\n                username: resolved.name,\n              },\n              resolved.orgId ?? null,\n            );\n          } else {\n            setSentryUser(null, null);\n          }\n          if (!trackedRef.current) {\n            trackedRef.current = true;\n            trackSessionStatus(signedIn);\n          }\n        }\n      }\n    }\n\n    fetchSession();\n    return () => {\n      cancelled = true;\n    };\n  }, []);\n\n  return { session, isLoading };\n}\n"]}

package/dist/deploy/build.d.ts

@@ -14,6 +14,7 @@
  */
 import { type DiscoveredRoute, type DiscoveredAction } from "./route-discovery.js";
 import { type WorkspaceCoreExports } from "./workspace-core.js";
+export declare const NITRO_RUNTIME_IGNORE_PATTERNS: string[];
 export declare function generateProvidedPluginsNitroPluginSource(pluginStems: string[]): string;
 type RouteRules = Record<string, {
     headers?: Record<string, string>;
@@ -34,6 +35,10 @@ export declare function copyDir(src: string, dest: string, ancestorRealPaths?: S
 type ServerlessFfmpegStaticArch = "arm64" | "x64";
 export declare function shouldBundleFfmpegStaticForServerless(hostPlatform?: NodeJS.Platform, hostArch?: NodeJS.Architecture, targetArch?: ServerlessFfmpegStaticArch | null): boolean;
 export declare function findInstalledFfmpegStaticPackage(nodeModulesRoots: string[]): string | null;
+export declare function findInstalledResvgPackages(nodeModulesRoots: string[]): Array<{
+    packageName: string;
+    packageDir: string;
+}>;
 /**
  * Build for any non-Cloudflare preset using Nitro's programmatic build API.
  * Handles netlify, vercel, deno_deploy, aws-lambda, and all other targets.

package/dist/deploy/build.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"build.d.ts","sourceRoot":"","sources":["../../src/deploy/build.ts"],"names":[],"mappings":";AAEA;;;;;;;;;;;;GAYG;AAOH,OAAO,EAML,KAAK,eAAe,EACpB,KAAK,gBAAgB,EACtB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAEL,KAAK,oBAAoB,EAC1B,MAAM,qBAAqB,CAAC;AAkD7B,wBAAgB,wCAAwC,CACtD,WAAW,EAAE,MAAM,EAAE,GACpB,MAAM,CAaR;AAgBD,KAAK,UAAU,GAAG,MAAM,CAAC,MAAM,EAAE;IAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CAAE,CAAC,CAAC;AAgBvE,wBAAgB,yCAAyC,CACvD,UAAU,EAAE,UAAU,EACtB,SAAS,EAAE,MAAM,EACjB,WAAW,SAAK,GACf,IAAI,CAQN;AAED;;;;;;;;GAQG;AACH,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,eAAe,EAAE,EACzB,WAAW,EAAE,MAAM,EAAE,EACrB,kBAAkB,GAAE,MAAM,EAAO,EACjC,OAAO,GAAE,gBAAgB,EAAO,EAChC,aAAa,GAAE,oBAAoB,GAAG,IAAW,EACjD,mBAAmB,GAAE,MAAM,EAAO,EAClC,gBAAgB,SAAmC,GAClD,MAAM,CAokBR;AA4VD,wBAAgB,mBAAmB,IAAI,MAAM,EAAE,CAE9C;AAkHD,wBAAgB,OAAO,CACrB,GAAG,EAAE,MAAM,EACX,IAAI,EAAE,MAAM,EACZ,iBAAiB,cAAoB,QAoCtC;AAqBD,KAAK,0BAA0B,GAAG,OAAO,GAAG,KAAK,CAAC;AAQlD,wBAAgB,qCAAqC,CACnD,YAAY,GAAE,MAAM,CAAC,QAA2B,EAChD,QAAQ,GAAE,MAAM,CAAC,YAA2B,EAC5C,UAAU,GAAE,0BAA0B,GAAG,IAAgD,GACxF,OAAO,CAOT;AAqED,wBAAgB,gCAAgC,CAC9C,gBAAgB,EAAE,MAAM,EAAE,GACzB,MAAM,GAAG,IAAI,CA8Bf;AAmMD;;;GAGG;AACH,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,CAAC,KAAK,EAAE,GAAG,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACvC,gBAAgB,EAAE,CAAC,KAAK,EAAE,GAAG,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAChD,UAAU,EAAE,CAAC,KAAK,EAAE,GAAG,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CAC3C;AAED,MAAM,WAAW,yBAAyB;IACxC,KAAK,EAAE,GAAG,CAAC;IACX,KAAK,EAAE,eAAe,CAAC;IACvB,SAAS,EAAE,MAAM,CAAC;IAClB,eAAe,EAAE,MAAM,GAAG,SAAS,CAAC;IACpC,WAAW,EAAE,MAAM,CAAC;IACpB,GAAG,EAAE,MAAM,CAAC;CACb;AAED;;;;;;;;;;;GAWG;AACH,wBAAsB,qBAAqB,CACzC,IAAI,EAAE,yBAAyB,GAC9B,OAAO,CAAC,IAAI,CAAC,CA+Bf"}
+{"version":3,"file":"build.d.ts","sourceRoot":"","sources":["../../src/deploy/build.ts"],"names":[],"mappings":";AAEA;;;;;;;;;;;;GAYG;AAOH,OAAO,EAML,KAAK,eAAe,EACpB,KAAK,gBAAgB,EACtB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAEL,KAAK,oBAAoB,EAC1B,MAAM,qBAAqB,CAAC;AAyB7B,eAAO,MAAM,6BAA6B,UAiBzC,CAAC;AA0BF,wBAAgB,wCAAwC,CACtD,WAAW,EAAE,MAAM,EAAE,GACpB,MAAM,CAaR;AAgBD,KAAK,UAAU,GAAG,MAAM,CAAC,MAAM,EAAE;IAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CAAE,CAAC,CAAC;AAgBvE,wBAAgB,yCAAyC,CACvD,UAAU,EAAE,UAAU,EACtB,SAAS,EAAE,MAAM,EACjB,WAAW,SAAK,GACf,IAAI,CAQN;AAED;;;;;;;;GAQG;AACH,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,eAAe,EAAE,EACzB,WAAW,EAAE,MAAM,EAAE,EACrB,kBAAkB,GAAE,MAAM,EAAO,EACjC,OAAO,GAAE,gBAAgB,EAAO,EAChC,aAAa,GAAE,oBAAoB,GAAG,IAAW,EACjD,mBAAmB,GAAE,MAAM,EAAO,EAClC,gBAAgB,SAAmC,GAClD,MAAM,CAokBR;AA4VD,wBAAgB,mBAAmB,IAAI,MAAM,EAAE,CAE9C;AAkHD,wBAAgB,OAAO,CACrB,GAAG,EAAE,MAAM,EACX,IAAI,EAAE,MAAM,EACZ,iBAAiB,cAAoB,QAoCtC;AAuBD,KAAK,0BAA0B,GAAG,OAAO,GAAG,KAAK,CAAC;AAQlD,wBAAgB,qCAAqC,CACnD,YAAY,GAAE,MAAM,CAAC,QAA2B,EAChD,QAAQ,GAAE,MAAM,CAAC,YAA2B,EAC5C,UAAU,GAAE,0BAA0B,GAAG,IAAgD,GACxF,OAAO,CAOT;AAqED,wBAAgB,gCAAgC,CAC9C,gBAAgB,EAAE,MAAM,EAAE,GACzB,MAAM,GAAG,IAAI,CA8Bf;AAED,wBAAgB,0BAA0B,CACxC,gBAAgB,EAAE,MAAM,EAAE,GACzB,KAAK,CAAC;IAAE,WAAW,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,CAAC,CAqCpD;AAkND;;;GAGG;AACH,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,CAAC,KAAK,EAAE,GAAG,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACvC,gBAAgB,EAAE,CAAC,KAAK,EAAE,GAAG,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAChD,UAAU,EAAE,CAAC,KAAK,EAAE,GAAG,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CAC3C;AAED,MAAM,WAAW,yBAAyB;IACxC,KAAK,EAAE,GAAG,CAAC;IACX,KAAK,EAAE,eAAe,CAAC;IACvB,SAAS,EAAE,MAAM,CAAC;IAClB,eAAe,EAAE,MAAM,GAAG,SAAS,CAAC;IACpC,WAAW,EAAE,MAAM,CAAC;IACpB,GAAG,EAAE,MAAM,CAAC;CACb;AAED;;;;;;;;;;;GAWG;AACH,wBAAsB,qBAAqB,CACzC,IAAI,EAAE,yBAAyB,GAC9B,OAAO,CAAC,IAAI,CAAC,CA+Bf"}

package/dist/deploy/build.js

@@ -26,6 +26,24 @@ import { DEFAULT_SSR_CDN_CACHE_CONTROL, DEFAULT_SSR_NETLIFY_CDN_CACHE_CONTROL, D
 import { collectImmutableAssetPaths, IMMUTABLE_ASSET_CACHE_CONTROL, IMMUTABLE_ASSET_CACHE_HEADERS, prefixAssetPath, } from "./immutable-assets.js";
 const cwd = process.cwd();
 const preset = process.env.NITRO_PRESET || "node";
+export const NITRO_RUNTIME_IGNORE_PATTERNS = [
+    "**/*.spec.ts",
+    "**/*.spec.tsx",
+    "**/*.spec.mts",
+    "**/*.spec.cts",
+    "**/*.spec.js",
+    "**/*.spec.jsx",
+    "**/*.spec.mjs",
+    "**/*.spec.cjs",
+    "**/*.test.ts",
+    "**/*.test.tsx",
+    "**/*.test.mts",
+    "**/*.test.cts",
+    "**/*.test.js",
+    "**/*.test.jsx",
+    "**/*.test.mjs",
+    "**/*.test.cjs",
+];
 function normalizeConfiguredAppBasePath() {
     const raw = process.env.VITE_APP_BASE_PATH || process.env.APP_BASE_PATH;
     if (!raw || raw === "/")
@@ -139,7 +157,7 @@ export function generateWorkerEntry(routes, pluginPaths, defaultPluginStems = []
         actionRegistrations.push(`  app.on(${JSON.stringify(a.method.toUpperCase())}, ${JSON.stringify(routePath)}, defineEventHandler(async (event) => {
     const params = ${a.method === "get" ? "parseActionSearchParams(event.url.searchParams)" : "(await readBody(event)) ?? {}"};
     try {
-      const result = await ${varName}.run(params);
+      const result = await ${varName}.run(params, { caller: "http" });
       if (typeof result === "string") { try { return JSON.parse(result); } catch { return result; } }
       return result;
     } catch (err) {
@@ -1062,6 +1080,8 @@ const LIBSQL_NATIVE_PACKAGE_NAMES = [
     "win32-x64-msvc",
 ];
 const FFMPEG_STATIC_PACKAGE_NAME = "ffmpeg-static";
+const RESVG_SCOPE = "@resvg";
+const RESVG_PACKAGE_PREFIX = "resvg-js";
 const FFMPEG_STATIC_BINARY_NAMES = process.platform === "win32" ? ["ffmpeg.exe", "ffmpeg"] : ["ffmpeg"];
 const SERVERLESS_FFMPEG_STATIC_PLATFORM = "linux";
 const SERVERLESS_FFMPEG_STATIC_ARCHES = new Set([
@@ -1158,6 +1178,38 @@ export function findInstalledFfmpegStaticPackage(nodeModulesRoots) {
     }
     return null;
 }
+export function findInstalledResvgPackages(nodeModulesRoots) {
+    const found = new Map();
+    for (const root of nodeModulesRoots) {
+        const directScope = path.join(root, RESVG_SCOPE);
+        if (fs.existsSync(directScope)) {
+            for (const entry of fs.readdirSync(directScope)) {
+                if (!entry.startsWith(RESVG_PACKAGE_PREFIX))
+                    continue;
+                const packageDir = path.join(directScope, entry);
+                if (fs.existsSync(path.join(packageDir, "package.json"))) {
+                    found.set(entry, packageDir);
+                }
+            }
+        }
+        const pnpmRoot = path.join(root, ".pnpm");
+        if (!fs.existsSync(pnpmRoot))
+            continue;
+        for (const entry of fs.readdirSync(pnpmRoot)) {
+            const match = entry.match(/^@resvg\+(resvg-js[^@]*)@/);
+            if (!match)
+                continue;
+            const packageName = match[1];
+            const packageDir = path.join(pnpmRoot, entry, "node_modules", RESVG_SCOPE, packageName);
+            if (fs.existsSync(path.join(packageDir, "package.json"))) {
+                found.set(packageName, packageDir);
+            }
+        }
+    }
+    return [...found.entries()]
+        .sort(([a], [b]) => a.localeCompare(b))
+        .map(([packageName, packageDir]) => ({ packageName, packageDir }));
+}
 function copyInstalledLibsqlNativePackages(serverDir) {
     if (!serverDir || !fs.existsSync(serverDir))
         return;
@@ -1175,6 +1227,18 @@ function copyInstalledLibsqlNativePackages(serverDir) {
         console.log(`[deploy] Copied ${copied} installed libsql native package(s) into the server bundle.`);
     }
 }
+function copyInstalledResvgPackages(serverDir) {
+    if (!serverDir || !fs.existsSync(serverDir))
+        return;
+    const packages = findInstalledResvgPackages(nodeModulesAncestors(cwd));
+    if (packages.length === 0)
+        return;
+    const destScopeDir = path.join(serverDir, "node_modules", RESVG_SCOPE);
+    for (const { packageName, packageDir } of packages) {
+        copyDir(packageDir, path.join(destScopeDir, packageName));
+    }
+    console.log(`[deploy] Copied ${packages.length} resvg package(s) into the server bundle for OG image rendering.`);
+}
 function copyInstalledFfmpegStaticPackage(serverDir) {
     if (!serverDir || !fs.existsSync(serverDir))
         return;
@@ -1433,6 +1497,7 @@ export default bundle;
         baseURL: appBasePath || "/",
         minify: true,
         serverDir: "./server",
+        ignore: NITRO_RUNTIME_IGNORE_PATTERNS,
         alias: {
             ...pathAliases,
             ...(fs.existsSync(rrServerBuild)
@@ -1462,6 +1527,7 @@ export default bundle;
     });
     if (preset === "netlify" || preset === "vercel" || preset === "aws-lambda") {
         copyInstalledLibsqlNativePackages(nitro.options.output.serverDir);
+        copyInstalledResvgPackages(nitro.options.output.serverDir);
         copyInstalledFfmpegStaticPackage(nitro.options.output.serverDir);
     }
     // Resolve remaining bare npm imports by bundling them into _libs/.