@agent-native/core 0.136.5 → 0.137.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (174) hide show
  1. package/corpus/README.md +1 -1
  2. package/corpus/templates/analytics/app/components/AgentCompletionSound.tsx +105 -0
  3. package/corpus/templates/analytics/app/components/layout/Layout.tsx +44 -35
  4. package/corpus/templates/analytics/app/i18n-data.ts +38 -0
  5. package/corpus/templates/analytics/app/pages/Settings.tsx +53 -1
  6. package/corpus/templates/analytics/app/pages/settings/settings-search.ts +6 -0
  7. package/corpus/templates/analytics/changelog/2026-08-04-choose-whether-analytics-plays-a-bell-when-the-agent-finishe.md +6 -0
  8. package/corpus/templates/analytics/shared/analytics-user-prefs.ts +2 -0
  9. package/corpus/templates/clips/app/components/import-menu.tsx +109 -0
  10. package/corpus/templates/clips/app/components/library/library-grid.tsx +8 -18
  11. package/corpus/templates/clips/app/components/library/library-layout.tsx +14 -50
  12. package/corpus/templates/clips/app/components/library/sort-menu.tsx +20 -6
  13. package/corpus/templates/clips/app/components/recorder/pre-record-panel.tsx +10 -34
  14. package/corpus/templates/clips/app/routes/_app.library._index.tsx +0 -2
  15. package/corpus/templates/clips/changelog/2026-08-04-cleaner-library-controls-with-an-icon-only-sort-button.md +6 -0
  16. package/corpus/templates/clips/changelog/2026-08-04-upload-and-loom-imports-now-live-under-one-import-menu.md +6 -0
  17. package/corpus/templates/content/actions/_database-utils.ts +6 -0
  18. package/corpus/templates/content/actions/bind-content-database-source-field.ts +273 -97
  19. package/corpus/templates/content/actions/change-content-database-source-role.ts +65 -29
  20. package/corpus/templates/content/actions/configure-document-property.ts +113 -32
  21. package/corpus/templates/content/actions/delete-content-database.ts +5 -7
  22. package/corpus/templates/content/actions/delete-document-property.ts +109 -62
  23. package/corpus/templates/content/actions/delete-document.ts +178 -36
  24. package/corpus/templates/content/actions/duplicate-database-item.ts +27 -0
  25. package/corpus/templates/content/actions/duplicate-database-items.ts +31 -1
  26. package/corpus/templates/content/actions/permanently-delete-document.ts +4 -6
  27. package/corpus/templates/content/actions/remove-database-items.ts +13 -0
  28. package/corpus/templates/content/actions/set-document-property.ts +69 -1
  29. package/corpus/templates/content/actions/upsert-database-item-by-key.ts +814 -0
  30. package/corpus/templates/content/parity/matrix.md +1 -1
  31. package/corpus/templates/content/parity/matrix.ts +1 -0
  32. package/corpus/templates/content/server/db/schema.ts +27 -0
  33. package/corpus/templates/content/server/plugins/db.ts +24 -0
  34. package/corpus/templates/design/app/components/design/BreakpointBar.tsx +122 -114
  35. package/corpus/templates/design/app/components/design/CanvasContextMenu.tsx +2 -2
  36. package/corpus/templates/design/app/components/design/EditPanel.tsx +68 -34
  37. package/corpus/templates/design/app/components/design/KeyboardShortcutsPanel.tsx +78 -4
  38. package/corpus/templates/design/app/components/design/MultiScreenCanvas.tsx +8 -0
  39. package/corpus/templates/design/app/components/design/QuestionFlow.tsx +5 -2
  40. package/corpus/templates/design/app/components/design/edit-panel/panel-primitives.tsx +10 -9
  41. package/corpus/templates/design/app/components/design/inspector/AutoLayoutMatrix.tsx +31 -69
  42. package/corpus/templates/design/app/components/design/inspector/design-icons.tsx +80 -106
  43. package/corpus/templates/design/app/components/design/multi-screen/types.ts +4 -0
  44. package/corpus/templates/design/app/hooks/use-editor-preferences.ts +75 -0
  45. package/corpus/templates/design/app/i18n-data.ts +8 -0
  46. package/corpus/templates/design/app/i18n-keyboard-shortcuts.ts +61 -0
  47. package/corpus/templates/design/app/pages/design-editor/editor-preferences.ts +98 -0
  48. package/corpus/templates/design/app/pages/design-editor/nudge-intent.ts +491 -0
  49. package/corpus/templates/design/app/pages/design-editor/paste-placement.ts +133 -0
  50. package/corpus/templates/design/app/pages/design-editor/png-export-render.ts +8 -0
  51. package/corpus/templates/design/app/pages/design-editor/selection-state.ts +5 -12
  52. package/corpus/templates/design/changelog/2026-08-03-arrow-keys-now-reorder-a-layer-inside-an-auto-layout-frame.md +6 -0
  53. package/corpus/templates/design/changelog/2026-08-03-auto-layout-flow-icons-show-the-direction-at-a-glance-instea.md +6 -0
  54. package/corpus/templates/design/changelog/2026-08-03-auto-layout-icons-share-one-outlined-square-style-so-flow-ga.md +6 -0
  55. package/corpus/templates/design/changelog/2026-08-03-export-has-a-named-preview-section-you-can-expand-replacing-.md +6 -0
  56. package/corpus/templates/design/changelog/2026-08-03-export-preview-shows-the-selected-element-instead-of-the-who.md +6 -0
  57. package/corpus/templates/design/changelog/2026-08-03-inspector-sections-show-an-expand-indicator-so-it-is-clear-w.md +6 -0
  58. package/corpus/templates/design/changelog/2026-08-03-paste-lands-inside-a-selected-frame-instead-of-beside-it.md +6 -0
  59. package/corpus/templates/design/changelog/2026-08-03-the-add-breakpoint-button-sits-outside-the-breakpoint-select.md +6 -0
  60. package/corpus/templates/design/changelog/2026-08-03-the-agent-s-follow-up-questions-keep-space-below-the-continu.md +6 -0
  61. package/corpus/templates/design/changelog/2026-08-03-the-agent-s-follow-up-questions-share-the-chat-panel-s-backg.md +6 -0
  62. package/corpus/templates/design/changelog/2026-08-03-the-export-panel-no-longer-stacks-a-duplicate-export-block-o.md +6 -0
  63. package/corpus/templates/design/changelog/2026-08-03-the-text-tool-uses-a-t-icon-matching-the-letter-it-inserts.md +6 -0
  64. package/corpus/templates/factory/.env.example +17 -0
  65. package/corpus/templates/factory/AGENTS.md +27 -17
  66. package/corpus/templates/factory/README.md +19 -9
  67. package/corpus/templates/factory/actions/get-slack-feedback-context.ts +90 -0
  68. package/corpus/templates/factory/actions/get-triage-config.ts +14 -3
  69. package/corpus/templates/factory/actions/govern-agent-native-pull-request.ts +386 -0
  70. package/corpus/templates/factory/actions/list-factory-automations.ts +53 -0
  71. package/corpus/templates/factory/actions/list-triage-items.ts +7 -2
  72. package/corpus/templates/factory/actions/poll-github-sources.ts +203 -0
  73. package/corpus/templates/factory/actions/poll-sentry-errors.ts +161 -0
  74. package/corpus/templates/factory/actions/poll-slack-channel.ts +4 -2
  75. package/corpus/templates/factory/actions/run-factory-automation.ts +42 -0
  76. package/corpus/templates/factory/actions/save-factory-automation.ts +69 -0
  77. package/corpus/templates/factory/actions/save-triage-config.ts +28 -2
  78. package/corpus/templates/factory/actions/start-builder-for-item.ts +411 -0
  79. package/corpus/templates/factory/app/components/factory/FactoryCanvas.tsx +14 -3
  80. package/corpus/templates/factory/app/components/ui/checkbox.tsx +1 -0
  81. package/corpus/templates/factory/app/hooks/use-navigation-state.ts +7 -0
  82. package/corpus/templates/factory/app/i18n/en-US.ts +35 -1
  83. package/corpus/templates/factory/app/routes/factory.tsx +462 -9
  84. package/corpus/templates/factory/changelog/2026-08-04-added-organization-owned-factory-automations-for-slack-bug-t.md +6 -0
  85. package/corpus/templates/factory/changelog/2026-08-04-automation-editor-controls-and-model-picker.md +6 -0
  86. package/corpus/templates/factory/netlify.toml +2 -2
  87. package/corpus/templates/factory/server/connectors/credentials.ts +6 -5
  88. package/corpus/templates/factory/server/connectors/slack.ts +133 -5
  89. package/corpus/templates/factory/server/db/schema.ts +6 -0
  90. package/corpus/templates/factory/server/lib/require-factory-automation.ts +65 -0
  91. package/corpus/templates/factory/server/plugins/agent-chat.ts +29 -11
  92. package/corpus/templates/factory/server/plugins/auth.ts +1 -0
  93. package/corpus/templates/factory/server/plugins/factory-migrations.ts +12 -0
  94. package/corpus/templates/factory/server/plugins/factory-scheduler-job.ts +218 -67
  95. package/corpus/templates/factory/server/triage/builder-executor.ts +4 -0
  96. package/corpus/templates/factory/server/triage/contracts.ts +14 -1
  97. package/corpus/templates/factory/server/triage/github-client.ts +404 -0
  98. package/corpus/templates/factory/server/triage/metadata.ts +44 -0
  99. package/corpus/templates/factory/server/triage/pr-babysit.ts +5 -5
  100. package/corpus/templates/factory/server/triage/pr-policy.ts +144 -0
  101. package/corpus/templates/factory/server/triage/sentry-client.ts +180 -0
  102. package/corpus/templates/factory/server/triage/slack-client.ts +43 -0
  103. package/corpus/templates/factory/server/triage/slack-poller.ts +9 -2
  104. package/corpus/templates/plan/.agents/skills/visual-plan/SKILL.md +27 -0
  105. package/corpus/templates/plan/.agents/skills/visual-plan/references/canvas.md +14 -4
  106. package/corpus/templates/plan/.agents/skills/visual-plan/references/wireframe.md +7 -0
  107. package/corpus/templates/plan/.agents/skills/visual-recap/references/wireframe.md +7 -0
  108. package/corpus/templates/plan/actions/create-plan-design.ts +8 -6
  109. package/corpus/templates/plan/actions/create-prototype-plan.ts +8 -6
  110. package/corpus/templates/plan/actions/create-ui-plan.ts +7 -7
  111. package/corpus/templates/plan/actions/get-plan-blocks.ts +7 -1
  112. package/corpus/templates/plan/actions/validate-plan-input.ts +39 -0
  113. package/corpus/templates/plan/app/components/plan/CanvasArea.tsx +167 -11
  114. package/corpus/templates/plan/app/i18n/en-US.ts +1 -0
  115. package/corpus/templates/plan/changelog/2026-08-04-canvas-zoom-controls-now-explain-the-command-ctrl-plus-scrol.md +6 -0
  116. package/corpus/templates/plan/changelog/2026-08-04-pinch-to-zoom-is-now-supported-on-touchscreens-in-visual-pla.md +6 -0
  117. package/corpus/templates/plan/shared/plan-content.ts +17 -2
  118. package/corpus/templates/slides/app/components/editor/NewDeckReferenceStep.tsx +321 -0
  119. package/corpus/templates/slides/app/components/editor/PromptDialog.tsx +32 -11
  120. package/corpus/templates/slides/app/lib/recent-references.ts +82 -0
  121. package/corpus/templates/slides/app/pages/DeckEditor.tsx +3 -0
  122. package/corpus/templates/slides/app/pages/Index.tsx +236 -181
  123. package/dist/cli/skills-content/canvas.d.ts +3 -3
  124. package/dist/cli/skills-content/canvas.js +16 -5
  125. package/dist/cli/skills-content/visual-plan-skill.d.ts +1 -1
  126. package/dist/cli/skills-content/visual-plan-skill.js +27 -0
  127. package/dist/cli/skills-content/wireframe.d.ts +2 -2
  128. package/dist/cli/skills-content/wireframe.js +7 -0
  129. package/dist/client/AgentPanel.js +23 -8
  130. package/dist/client/DefaultSpinner.d.ts +0 -12
  131. package/dist/client/DefaultSpinner.js +22 -2
  132. package/dist/client/api-path.d.ts +6 -0
  133. package/dist/client/api-path.js +55 -0
  134. package/dist/client/onboarding/FirstRunOnboarding.d.ts +3 -0
  135. package/dist/client/onboarding/FirstRunOnboarding.js +93 -0
  136. package/dist/client/onboarding/first-run-enabled.d.ts +2 -0
  137. package/dist/client/onboarding/first-run-enabled.js +9 -0
  138. package/dist/client/onboarding/index.d.ts +2 -1
  139. package/dist/client/onboarding/index.js +1 -0
  140. package/dist/client/onboarding/use-onboarding.d.ts +6 -1
  141. package/dist/client/onboarding/use-onboarding.js +35 -1
  142. package/dist/client/route-state.js +10 -0
  143. package/dist/collab/awareness.d.ts +2 -2
  144. package/dist/collab/routes.d.ts +1 -1
  145. package/dist/connections/catalog.d.ts +4 -4
  146. package/dist/connections/catalog.js +3 -3
  147. package/dist/db/index.d.ts +1 -1
  148. package/dist/db/index.js +1 -1
  149. package/dist/deploy/build.js +2 -1
  150. package/dist/notifications/routes.d.ts +3 -3
  151. package/dist/observability/routes.d.ts +1 -1
  152. package/dist/onboarding/app-profile.d.ts +4 -0
  153. package/dist/onboarding/app-profile.js +378 -0
  154. package/dist/onboarding/index.d.ts +2 -1
  155. package/dist/onboarding/index.js +1 -0
  156. package/dist/onboarding/plugin.d.ts +2 -0
  157. package/dist/onboarding/plugin.js +21 -1
  158. package/dist/onboarding/types.d.ts +19 -0
  159. package/dist/progress/routes.d.ts +1 -1
  160. package/dist/provider-api/actions/custom-provider-registration.d.ts +9 -9
  161. package/dist/provider-api/actions/provider-api.d.ts +12 -12
  162. package/dist/secrets/routes.d.ts +3 -3
  163. package/dist/server/auth.js +21 -1
  164. package/dist/server/better-auth-instance.d.ts +3 -2
  165. package/dist/server/better-auth-instance.js +9 -7
  166. package/dist/server/email-markdown.js +3 -8
  167. package/dist/shared/first-run-onboarding.d.ts +3 -0
  168. package/dist/shared/first-run-onboarding.js +3 -0
  169. package/dist/templates/workspace-core/.agents/skills/address-feedback/SKILL.md +25 -9
  170. package/dist/triggers/index.d.ts +3 -0
  171. package/dist/triggers/index.js +5 -0
  172. package/docs/content/cross-app-sso.mdx +26 -0
  173. package/package.json +1 -1
  174. package/src/templates/workspace-core/.agents/skills/address-feedback/SKILL.md +25 -9
@@ -311,9 +311,8 @@ export declare function createProviderApiActions(runtime: Pick<ProviderApiRuntim
311
311
  notes?: string | undefined;
312
312
  scope?: "org" | "user" | undefined;
313
313
  }, {
314
+ message?: undefined;
314
315
  id?: undefined;
315
- provider?: undefined;
316
- deleted?: undefined;
317
316
  found?: undefined;
318
317
  providers: {
319
318
  id: string;
@@ -325,45 +324,46 @@ export declare function createProviderApiActions(runtime: Pick<ProviderApiRuntim
325
324
  updatedAt: number;
326
325
  }[];
327
326
  count: number;
327
+ provider?: undefined;
328
+ deleted?: undefined;
328
329
  registered?: undefined;
329
330
  label?: undefined;
330
- message?: undefined;
331
331
  } | {
332
+ message?: undefined;
332
333
  id?: undefined;
333
- deleted?: undefined;
334
334
  count?: undefined;
335
335
  providers?: undefined;
336
336
  found: boolean;
337
337
  provider: import("../custom-registry.js").CustomProviderConfig;
338
+ deleted?: undefined;
338
339
  registered?: undefined;
339
340
  label?: undefined;
340
- message?: undefined;
341
341
  } | {
342
- provider?: undefined;
343
- deleted?: undefined;
342
+ message?: undefined;
344
343
  count?: undefined;
345
344
  providers?: undefined;
345
+ provider?: undefined;
346
346
  found: boolean;
347
347
  id: string;
348
+ deleted?: undefined;
348
349
  registered?: undefined;
349
350
  label?: undefined;
350
- message?: undefined;
351
351
  } | {
352
- provider?: undefined;
352
+ message?: undefined;
353
353
  found?: undefined;
354
354
  count?: undefined;
355
355
  providers?: undefined;
356
+ provider?: undefined;
356
357
  deleted: boolean;
357
358
  id: string;
358
359
  registered?: undefined;
359
360
  label?: undefined;
360
- message?: undefined;
361
361
  } | {
362
- provider?: undefined;
363
- deleted?: undefined;
364
362
  found?: undefined;
365
363
  count?: undefined;
366
364
  providers?: undefined;
365
+ provider?: undefined;
366
+ deleted?: undefined;
367
367
  registered: boolean;
368
368
  id: string;
369
369
  label: string;
@@ -34,16 +34,16 @@ export declare function createListSecretsHandler(): import("h3").EventHandlerWit
34
34
  /** POST /_agent-native/secrets/:key — write a secret. */
35
35
  export declare function createWriteSecretHandler(): import("h3").EventHandlerWithFetch<import("h3").EventHandlerRequest, Promise<{
36
36
  error: string;
37
- ok?: undefined;
38
37
  status?: undefined;
38
+ ok?: undefined;
39
39
  } | {
40
40
  error?: undefined;
41
41
  ok: boolean;
42
42
  status: string;
43
43
  } | {
44
- ok?: undefined;
45
44
  error: string;
46
45
  removed?: undefined;
46
+ ok?: undefined;
47
47
  } | {
48
48
  error?: undefined;
49
49
  ok: boolean;
@@ -54,9 +54,9 @@ export declare function createWriteSecretHandler(): import("h3").EventHandlerWit
54
54
  * or the current stored value without changing anything.
55
55
  */
56
56
  export declare function createTestSecretHandler(): import("h3").EventHandlerWithFetch<import("h3").EventHandlerRequest, Promise<{
57
- ok?: undefined;
58
57
  error: string;
59
58
  note?: undefined;
59
+ ok?: undefined;
60
60
  } | {
61
61
  error?: undefined;
62
62
  ok: boolean;
@@ -2,6 +2,7 @@ import crypto from "node:crypto";
2
2
  import { defineEventHandler, getMethod, getQuery, getRequestIP, setResponseHeader, setResponseStatus, getCookie, setCookie, deleteCookie, getHeader, } from "h3";
3
3
  import { EMBED_START_PATH } from "../shared/embed-auth.js";
4
4
  import { EMBED_TARGET_HEADER } from "../shared/embed-auth.js";
5
+ import { FIRST_RUN_ONBOARDING_COOKIE, FIRST_RUN_ONBOARDING_MAX_AGE, } from "../shared/first-run-onboarding.js";
5
6
  import { EMBED_TRANSPLANT_HEADER, isMcpEmbedCorsOrigin, MCP_EMBED_CORS_ALLOW_HEADERS, shouldAllowMcpEmbedCredentials, } from "../shared/mcp-embed-headers.js";
6
7
  import { isEmbedCapabilityScope, requestHasEmbedAuthMarker, resolveEmbedSessionFromRequest, } from "./embed-session.js";
7
8
  // In h3 v2, `event.req` IS the web Request — but in Nitro's dev server (srvx
@@ -1880,6 +1881,14 @@ function crossSiteCookieAttrs(event) {
1880
1881
  ? { sameSite: "none", secure: true, partitioned: true }
1881
1882
  : { sameSite: "lax", secure: false };
1882
1883
  }
1884
+ function setFirstRunOnboardingCookie(event) {
1885
+ setCookie(event, FIRST_RUN_ONBOARDING_COOKIE, "1", {
1886
+ ...crossSiteCookieAttrs(event),
1887
+ httpOnly: false,
1888
+ path: "/",
1889
+ maxAge: FIRST_RUN_ONBOARDING_MAX_AGE,
1890
+ });
1891
+ }
1883
1892
  export function setFrameworkSessionCookie(event, token) {
1884
1893
  clearFrameworkSessionCookies(event);
1885
1894
  setCookie(event, COOKIE_NAME, token, {
@@ -2293,11 +2302,14 @@ async function mountBetterAuthRoutes(app, options) {
2293
2302
  if (!googleAccountId) {
2294
2303
  throw new Error("Could not get Google account id");
2295
2304
  }
2296
- await ensureGoogleAuthIdentity({
2305
+ const isNewGoogleUser = await ensureGoogleAuthIdentity({
2297
2306
  email,
2298
2307
  accountId: googleAccountId,
2299
2308
  name: typeof user.name === "string" ? user.name : undefined,
2300
2309
  });
2310
+ if (isNewGoogleUser === true) {
2311
+ setFirstRunOnboardingCookie(event);
2312
+ }
2301
2313
  if (typeof user.picture === "string" && user.picture.trim()) {
2302
2314
  await putSetting(`avatar:${email}`, {
2303
2315
  image: user.picture,
@@ -2633,6 +2645,12 @@ async function mountBetterAuthRoutes(app, options) {
2633
2645
  // Best-effort — don't block the response
2634
2646
  }
2635
2647
  }
2648
+ if (reqPath.includes("/sign-up/email") &&
2649
+ isResponse &&
2650
+ response.status >= 200 &&
2651
+ response.status < 300) {
2652
+ setFirstRunOnboardingCookie(event);
2653
+ }
2636
2654
  return response;
2637
2655
  }));
2638
2656
  // Backward-compat: POST /_agent-native/auth/login
@@ -2721,6 +2739,7 @@ async function mountBetterAuthRoutes(app, options) {
2721
2739
  body: { email, password, name: email.split("@")[0], callbackURL },
2722
2740
  headers: event.headers,
2723
2741
  });
2742
+ setFirstRunOnboardingCookie(event);
2724
2743
  return { ok: true };
2725
2744
  }
2726
2745
  catch (e) {
@@ -2939,6 +2958,7 @@ function mountAuthFallbackRoutes(app) {
2939
2958
  body: { email, password, name: email.split("@")[0] },
2940
2959
  headers: event.headers,
2941
2960
  });
2961
+ setFirstRunOnboardingCookie(event);
2942
2962
  return { ok: true };
2943
2963
  }
2944
2964
  catch (e) {
@@ -193,9 +193,10 @@ export interface GoogleAuthIdentity {
193
193
  * Ensure a verified Google identity has a canonical Better Auth user/account
194
194
  * before the legacy email-keyed session is issued. This prevents a later
195
195
  * password signup from becoming the first canonical identity for that email.
196
+ * Returns whether this call created the canonical user.
196
197
  */
197
- export declare function ensureGoogleAuthIdentity(identity: GoogleAuthIdentity): Promise<void>;
198
- export declare function ensureGoogleAuthIdentityWithAdapter(adapter: BetterAuthInternalAdapter, identity: GoogleAuthIdentity): Promise<void>;
198
+ export declare function ensureGoogleAuthIdentity(identity: GoogleAuthIdentity): Promise<boolean>;
199
+ export declare function ensureGoogleAuthIdentityWithAdapter(adapter: BetterAuthInternalAdapter, identity: GoogleAuthIdentity): Promise<boolean>;
199
200
  /** Reset for testing */
200
201
  export declare function resetBetterAuth(): Promise<void>;
201
202
  /**
@@ -709,13 +709,14 @@ export async function getBetterAuthInternalAdapter(config) {
709
709
  * Ensure a verified Google identity has a canonical Better Auth user/account
710
710
  * before the legacy email-keyed session is issued. This prevents a later
711
711
  * password signup from becoming the first canonical identity for that email.
712
+ * Returns whether this call created the canonical user.
712
713
  */
713
714
  export async function ensureGoogleAuthIdentity(identity) {
714
715
  const adapter = await getBetterAuthInternalAdapter();
715
716
  if (!adapter) {
716
717
  throw new Error("Better Auth internal adapter is unavailable");
717
718
  }
718
- await ensureGoogleAuthIdentityWithAdapter(adapter, identity);
719
+ return ensureGoogleAuthIdentityWithAdapter(adapter, identity);
719
720
  }
720
721
  export async function ensureGoogleAuthIdentityWithAdapter(adapter, identity) {
721
722
  const email = identity.email.trim().toLowerCase();
@@ -731,13 +732,13 @@ export async function ensureGoogleAuthIdentityWithAdapter(adapter, identity) {
731
732
  if (!existing || linkedAccount.userId !== existing.user.id) {
732
733
  throw new Error("Google account is already linked to another user");
733
734
  }
734
- return;
735
+ return false;
735
736
  }
736
737
  if (!existing) {
737
738
  if (adapter.createOAuthUser) {
738
739
  try {
739
740
  await adapter.createOAuthUser({ email, name, emailVerified: true }, { providerId: "google", accountId });
740
- return;
741
+ return true;
741
742
  }
742
743
  catch (error) {
743
744
  // A concurrent first sign-in may have won the unique-email race. Only
@@ -754,7 +755,7 @@ export async function ensureGoogleAuthIdentityWithAdapter(adapter, identity) {
754
755
  if (linkedAccount.userId !== existing.user.id) {
755
756
  throw new Error("Google account is already linked to another user");
756
757
  }
757
- return;
758
+ return false;
758
759
  }
759
760
  }
760
761
  }
@@ -769,7 +770,7 @@ export async function ensureGoogleAuthIdentityWithAdapter(adapter, identity) {
769
770
  providerId: "google",
770
771
  accountId,
771
772
  });
772
- return;
773
+ return true;
773
774
  }
774
775
  }
775
776
  if (!existing) {
@@ -777,7 +778,7 @@ export async function ensureGoogleAuthIdentityWithAdapter(adapter, identity) {
777
778
  }
778
779
  const alreadyLinked = existing.accounts.some((account) => account.providerId === "google" && account.accountId === accountId);
779
780
  if (alreadyLinked)
780
- return;
781
+ return false;
781
782
  // A password signup reserves the email before verification. If that row is
782
783
  // credential-only, remove the unverified credential and promote the same
783
784
  // canonical user to the verified Google identity. Any other linked account
@@ -793,13 +794,14 @@ export async function ensureGoogleAuthIdentityWithAdapter(adapter, identity) {
793
794
  email,
794
795
  accountId,
795
796
  });
796
- return;
797
+ return false;
797
798
  }
798
799
  await adapter.linkAccount({
799
800
  userId: existing.user.id,
800
801
  providerId: "google",
801
802
  accountId,
802
803
  });
804
+ return false;
803
805
  }
804
806
  /** Reset for testing */
805
807
  export async function resetBetterAuth() {
@@ -25,14 +25,9 @@ function inlineMarkdown(value) {
25
25
  trailing = url.slice(-1) + trailing;
26
26
  url = url.slice(0, -1);
27
27
  }
28
- let label = "Open link";
29
- const normalizedUrl = url.replace(/&amp;/g, "&");
30
- if (URL.canParse(normalizedUrl)) {
31
- const host = new URL(normalizedUrl).hostname.replace(/^www\./, "");
32
- if (host)
33
- label = `Open ${host}`;
34
- }
35
- return `${prefix}<a href="${url}" style="color:${EMAIL_TEXT};text-decoration:underline;">${label}</a>${trailing}`;
28
+ // A bare URL stays its own link text: a recipient who cannot read the
29
+ // destination cannot tell a digest link from a phishing one.
30
+ return `${prefix}<a href="${url}" style="color:${EMAIL_TEXT};text-decoration:underline;">${url}</a>${trailing}`;
36
31
  });
37
32
  html = html
38
33
  .replace(/`([^`]+)`/g, `<code style="background:${EMAIL_CODE};padding:2px 5px;border-radius:4px;font-size:0.92em;">$1</code>`)
@@ -0,0 +1,3 @@
1
+ export declare const FIRST_RUN_ONBOARDING_COOKIE = "agent-native-first-run";
2
+ export declare const FIRST_RUN_ONBOARDING_MAX_AGE: number;
3
+ //# sourceMappingURL=first-run-onboarding.d.ts.map
@@ -0,0 +1,3 @@
1
+ export const FIRST_RUN_ONBOARDING_COOKIE = "agent-native-first-run";
2
+ export const FIRST_RUN_ONBOARDING_MAX_AGE = 24 * 60 * 60;
3
+ //# sourceMappingURL=first-run-onboarding.js.map
@@ -1,9 +1,9 @@
1
1
  ---
2
2
  name: address-feedback
3
3
  description: >-
4
- Triage feedback docs or pasted feedback into bugs to fix, UX suggestions to
5
- propose, unclear questions, and skipped noise; verify bugs, check Sentry when
6
- relevant, and keep UI changes minimal.
4
+ Triage feedback from docs, issues, Slack threads, or pasted notes into
5
+ verified bugs, UX proposals, unclear questions, and skipped noise. Use when a
6
+ user asks you to address product feedback or investigate a reported workflow.
7
7
  scope: dev
8
8
  metadata:
9
9
  internal: true
@@ -20,6 +20,7 @@ The default posture is judgment plus action: fix clear, verified bugs you agree
20
20
  - If no link or feedback text is provided, ask for it.
21
21
  - Read the repo `AGENTS.md` before touching code.
22
22
  - Use the relevant connector/plugin/skill for the source when available, instead of scraping authenticated pages.
23
+ - Before starting work, search available task history and local Git/PR metadata for the exact feedback link or issue identifiers. Reuse existing work instead of creating a duplicate fix.
23
24
 
24
25
  ## Steps
25
26
 
@@ -35,16 +36,28 @@ The default posture is judgment plus action: fix clear, verified bugs you agree
35
36
  | Public URL | Web browsing |
36
37
  | Pasted text | Read directly |
37
38
 
38
- Use web browsing only for public URLs. Auth-gated docs usually need their matching connector.
39
+ Use web browsing only for public URLs. Auth-gated docs usually need their matching connector. For threads, read the parent and all replies; note when there are no replies, and inspect linked files or newer follow-ups when the source refers to them.
39
40
 
40
- 2. Categorize every actionable item.
41
+ 2. Decompose and categorize every actionable item.
42
+
43
+ Build a compact checklist before changing code. For each item, record the
44
+ symptom, expected behavior, evidence, and owning surface: UI, action/tool,
45
+ data model, provider/runtime, or product policy.
41
46
 
42
47
  - **Bug**: Broken behavior, crash, wrong data, dead link, package/API mismatch, or captured exception. Verify and fix when you agree.
43
48
  - **UX suggestion**: Design, discoverability, workflow, or feature feedback. Propose the cleanest version first unless the user explicitly asked you to implement UX changes.
44
49
  - **Question or unclear**: Missing detail, contradictory feedback, or behavior you cannot inspect. Ask or flag it.
45
50
  - **Out of scope**: Outside this repo, already shipped, intentionally unsupported, or too low-signal. Note briefly and skip.
46
51
 
47
- 3. Check Sentry when the feedback smells like an error.
52
+ 3. For data, permissions, or resource-lifecycle feedback, verify the whole capability boundary before calling it UX.
53
+
54
+ - Check the supported create/read/update/delete lifecycle, including whether the backend/action exists when a UI control is missing.
55
+ - Inspect both the UI and the shared action/tool surface so agent and UI behavior stay in parity.
56
+ - Verify scope semantics such as owner/private, organization, shared, and public access. Test owner and non-owner paths with safe fixtures or read-only checks; never use another user's production data to test access.
57
+ - Treat possible cross-user or cross-organization exposure as a security/correctness bug and verify it before proposing polish.
58
+ - Keep undefined product policy separate from implementation bugs. If supported source types or scope semantics are not defined, flag the contract question instead of inventing behavior.
59
+
60
+ 4. Check Sentry when the feedback smells like an error.
48
61
 
49
62
  - Use the Sentry skill/plugin if available, or the repo's Sentry scripts if documented.
50
63
  - Search by route, stack symbol, error text, and symptom keywords.
@@ -52,7 +65,7 @@ The default posture is judgment plus action: fix clear, verified bugs you agree
52
65
  - Cite issue IDs or links when you find a match.
53
66
  - If nothing matches, say that plainly.
54
67
 
55
- 4. Fix only the clear bugs you agree with.
68
+ 5. Fix only the clear bugs you agree with.
56
69
 
57
70
  - Verify before fixing: reproduce locally, read the relevant code, inspect logs, or confirm with a stack trace.
58
71
  - Keep each fix narrow and mapped to a feedback item.
@@ -60,7 +73,7 @@ The default posture is judgment plus action: fix clear, verified bugs you agree
60
73
  - Do not switch branches, stash, reset, force-push, or open a PR unless the user asks.
61
74
  - Add or update focused tests when the bug risk warrants it.
62
75
 
63
- 5. Treat UX feedback with restraint.
76
+ 6. Treat UX feedback with restraint.
64
77
 
65
78
  Do not solve UX problems by adding more visible controls, helper text, banners, top-level nav, or always-open panels by default. Prefer cleaner interaction models:
66
79
 
@@ -72,11 +85,14 @@ The default posture is judgment plus action: fix clear, verified bugs you agree
72
85
 
73
86
  When proposing a UX change, write it as: what to change, why it helps, and the tradeoff. Keep each proposal short.
74
87
 
75
- 6. Verify changed behavior.
88
+ 7. Verify changed behavior.
76
89
 
77
90
  - Run the smallest relevant test or typecheck command.
78
91
  - For UI fixes, inspect the actual screen with a browser tool you already
79
92
  have. Do not write a browser-automation script to check a small fix.
93
+ - For resource visibility or lifecycle changes, verify both the screen and
94
+ shared action/tool behavior, including owner versus non-owner access when
95
+ relevant.
80
96
  - If you cannot run a useful verification, say why.
81
97
 
82
98
  ## Report Format
@@ -2,4 +2,7 @@ export type { TriggerFrontmatter, TriggerDispatchContext } from "./types.js";
2
2
  export { initTriggerDispatcher, refreshEventSubscriptions, parseTriggerFrontmatter, buildTriggerContent, type TriggerDispatcherDeps, } from "./dispatcher.js";
3
3
  export { evaluateCondition, __clearConditionCache, } from "./condition-evaluator.js";
4
4
  export { createAutomationToolEntries } from "./actions.js";
5
+ export { defineAutomation, listAutomationDefinitions, updateAutomation, type AutomationActor, type AutomationDefinition, } from "../automations/service.js";
6
+ export { queueAutomationRunNow } from "../jobs/run-now.js";
7
+ export { listAutomationRuns } from "../jobs/run-history.js";
5
8
  //# sourceMappingURL=index.d.ts.map
@@ -1,4 +1,9 @@
1
1
  export { initTriggerDispatcher, refreshEventSubscriptions, parseTriggerFrontmatter, buildTriggerContent, } from "./dispatcher.js";
2
2
  export { evaluateCondition, __clearConditionCache, } from "./condition-evaluator.js";
3
3
  export { createAutomationToolEntries } from "./actions.js";
4
+ // Template-native automation surfaces use the same organization-scoped
5
+ // service and run history as the framework Agent page.
6
+ export { defineAutomation, listAutomationDefinitions, updateAutomation, } from "../automations/service.js";
7
+ export { queueAutomationRunNow } from "../jobs/run-now.js";
8
+ export { listAutomationRuns } from "../jobs/run-history.js";
4
9
  //# sourceMappingURL=index.js.map
@@ -15,6 +15,32 @@ This is the same trust primitive [A2A](/docs/a2a-protocol) and [External Agents]
15
15
 
16
16
  </Callout>
17
17
 
18
+ ## What the user sees {#user-flow}
19
+
20
+ Cross-App SSO should feel like moving between products in one workspace, not
21
+ creating a second account. For example:
22
+
23
+ 1. Sign in to [Dispatch](https://dispatch.agent-native.com), or to any app
24
+ that already uses the workspace identity.
25
+ 2. Open [Mail](https://mail.agent-native.com), [Calendar](https://calendar.agent-native.com),
26
+ or another enabled app in a new tab.
27
+ 3. The app sends the browser to Dispatch only if it does not already have a
28
+ Dispatch session. If the session exists, the redirect is effectively
29
+ invisible.
30
+ 4. Return to the app already signed in, with the same email, records, and org
31
+ context as before.
32
+
33
+ The important distinction is that this is **one sign-in, not one shared
34
+ cookie**. Each separately hosted app still creates and owns its own local
35
+ session. Dispatch proves the user's identity at the app's front door, and the
36
+ app then continues with its normal local auth and access checks.
37
+
38
+ For a product walkthrough, record this exact sequence: sign in once in
39
+ Dispatch, open two other hosted apps, show that neither asks for credentials,
40
+ then sign out of one app and show that the other app's session is independent.
41
+ That last step makes the security boundary visible: SSO removes repeated
42
+ logins without turning every app into one shared session store.
43
+
18
44
  ## What & why {#what-why}
19
45
 
20
46
  Per-app user stores mean there is no single place a browser cookie could live that every app trusts. The federation model instead names one app — **Dispatch** — as the identity authority. Any other app can delegate "who is this person?" to Dispatch, get back a short-lived signed assertion of the user's verified email, and then **link that to its own local account by email**.
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@agent-native/core",
3
- "version": "0.136.5",
3
+ "version": "0.137.1",
4
4
  "description": "Framework for agent-native application development — where AI agents and UI share SQL state, actions, and context",
5
5
  "homepage": "https://github.com/BuilderIO/agent-native#readme",
6
6
  "bugs": {
@@ -1,9 +1,9 @@
1
1
  ---
2
2
  name: address-feedback
3
3
  description: >-
4
- Triage feedback docs or pasted feedback into bugs to fix, UX suggestions to
5
- propose, unclear questions, and skipped noise; verify bugs, check Sentry when
6
- relevant, and keep UI changes minimal.
4
+ Triage feedback from docs, issues, Slack threads, or pasted notes into
5
+ verified bugs, UX proposals, unclear questions, and skipped noise. Use when a
6
+ user asks you to address product feedback or investigate a reported workflow.
7
7
  scope: dev
8
8
  metadata:
9
9
  internal: true
@@ -20,6 +20,7 @@ The default posture is judgment plus action: fix clear, verified bugs you agree
20
20
  - If no link or feedback text is provided, ask for it.
21
21
  - Read the repo `AGENTS.md` before touching code.
22
22
  - Use the relevant connector/plugin/skill for the source when available, instead of scraping authenticated pages.
23
+ - Before starting work, search available task history and local Git/PR metadata for the exact feedback link or issue identifiers. Reuse existing work instead of creating a duplicate fix.
23
24
 
24
25
  ## Steps
25
26
 
@@ -35,16 +36,28 @@ The default posture is judgment plus action: fix clear, verified bugs you agree
35
36
  | Public URL | Web browsing |
36
37
  | Pasted text | Read directly |
37
38
 
38
- Use web browsing only for public URLs. Auth-gated docs usually need their matching connector.
39
+ Use web browsing only for public URLs. Auth-gated docs usually need their matching connector. For threads, read the parent and all replies; note when there are no replies, and inspect linked files or newer follow-ups when the source refers to them.
39
40
 
40
- 2. Categorize every actionable item.
41
+ 2. Decompose and categorize every actionable item.
42
+
43
+ Build a compact checklist before changing code. For each item, record the
44
+ symptom, expected behavior, evidence, and owning surface: UI, action/tool,
45
+ data model, provider/runtime, or product policy.
41
46
 
42
47
  - **Bug**: Broken behavior, crash, wrong data, dead link, package/API mismatch, or captured exception. Verify and fix when you agree.
43
48
  - **UX suggestion**: Design, discoverability, workflow, or feature feedback. Propose the cleanest version first unless the user explicitly asked you to implement UX changes.
44
49
  - **Question or unclear**: Missing detail, contradictory feedback, or behavior you cannot inspect. Ask or flag it.
45
50
  - **Out of scope**: Outside this repo, already shipped, intentionally unsupported, or too low-signal. Note briefly and skip.
46
51
 
47
- 3. Check Sentry when the feedback smells like an error.
52
+ 3. For data, permissions, or resource-lifecycle feedback, verify the whole capability boundary before calling it UX.
53
+
54
+ - Check the supported create/read/update/delete lifecycle, including whether the backend/action exists when a UI control is missing.
55
+ - Inspect both the UI and the shared action/tool surface so agent and UI behavior stay in parity.
56
+ - Verify scope semantics such as owner/private, organization, shared, and public access. Test owner and non-owner paths with safe fixtures or read-only checks; never use another user's production data to test access.
57
+ - Treat possible cross-user or cross-organization exposure as a security/correctness bug and verify it before proposing polish.
58
+ - Keep undefined product policy separate from implementation bugs. If supported source types or scope semantics are not defined, flag the contract question instead of inventing behavior.
59
+
60
+ 4. Check Sentry when the feedback smells like an error.
48
61
 
49
62
  - Use the Sentry skill/plugin if available, or the repo's Sentry scripts if documented.
50
63
  - Search by route, stack symbol, error text, and symptom keywords.
@@ -52,7 +65,7 @@ The default posture is judgment plus action: fix clear, verified bugs you agree
52
65
  - Cite issue IDs or links when you find a match.
53
66
  - If nothing matches, say that plainly.
54
67
 
55
- 4. Fix only the clear bugs you agree with.
68
+ 5. Fix only the clear bugs you agree with.
56
69
 
57
70
  - Verify before fixing: reproduce locally, read the relevant code, inspect logs, or confirm with a stack trace.
58
71
  - Keep each fix narrow and mapped to a feedback item.
@@ -60,7 +73,7 @@ The default posture is judgment plus action: fix clear, verified bugs you agree
60
73
  - Do not switch branches, stash, reset, force-push, or open a PR unless the user asks.
61
74
  - Add or update focused tests when the bug risk warrants it.
62
75
 
63
- 5. Treat UX feedback with restraint.
76
+ 6. Treat UX feedback with restraint.
64
77
 
65
78
  Do not solve UX problems by adding more visible controls, helper text, banners, top-level nav, or always-open panels by default. Prefer cleaner interaction models:
66
79
 
@@ -72,11 +85,14 @@ The default posture is judgment plus action: fix clear, verified bugs you agree
72
85
 
73
86
  When proposing a UX change, write it as: what to change, why it helps, and the tradeoff. Keep each proposal short.
74
87
 
75
- 6. Verify changed behavior.
88
+ 7. Verify changed behavior.
76
89
 
77
90
  - Run the smallest relevant test or typecheck command.
78
91
  - For UI fixes, inspect the actual screen with a browser tool you already
79
92
  have. Do not write a browser-automation script to check a small fix.
93
+ - For resource visibility or lifecycle changes, verify both the screen and
94
+ shared action/tool behavior, including owner versus non-owner access when
95
+ relevant.
80
96
  - If you cannot run a useful verification, say why.
81
97
 
82
98
  ## Report Format