@agent-native/core 0.146.8 → 0.147.0

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 (169) hide show
  1. package/corpus/README.md +1 -1
  2. package/corpus/templates/analytics/.agents/skills/turn-into-app/SKILL.md +18 -6
  3. package/corpus/templates/analytics/.agents/skills/turn-into-app/references/fresh-project.md +8 -1
  4. package/corpus/templates/analytics/app/routes/status.$slug.tsx +4 -2
  5. package/corpus/templates/analytics/scripts/first-party-analytics-bigquery-backfill.ts +56 -6
  6. package/corpus/templates/assets/.agents/skills/turn-into-app/SKILL.md +18 -6
  7. package/corpus/templates/assets/.agents/skills/turn-into-app/references/fresh-project.md +8 -1
  8. package/corpus/templates/brain/.agents/skills/adding-a-feature/SKILL.md +9 -0
  9. package/corpus/templates/brain/.agents/skills/turn-into-app/SKILL.md +18 -6
  10. package/corpus/templates/brain/.agents/skills/turn-into-app/references/fresh-project.md +8 -1
  11. package/corpus/templates/calendar/.agents/skills/turn-into-app/SKILL.md +18 -6
  12. package/corpus/templates/calendar/.agents/skills/turn-into-app/references/fresh-project.md +8 -1
  13. package/corpus/templates/chat/.agents/skills/adding-a-feature/SKILL.md +9 -0
  14. package/corpus/templates/chat/.agents/skills/turn-into-app/SKILL.md +18 -6
  15. package/corpus/templates/chat/.agents/skills/turn-into-app/references/fresh-project.md +8 -1
  16. package/corpus/templates/clips/.agents/skills/turn-into-app/SKILL.md +18 -6
  17. package/corpus/templates/clips/.agents/skills/turn-into-app/references/fresh-project.md +8 -1
  18. package/corpus/templates/clips/app/routes/r.$recordingId.tsx +16 -4
  19. package/corpus/templates/clips/app/routes/share.meeting.$meetingId.tsx +14 -5
  20. package/corpus/templates/clips/package.json +1 -0
  21. package/corpus/templates/clips/react-router.config.ts +7 -0
  22. package/corpus/templates/clips/server/plugins/auth.ts +6 -1
  23. package/corpus/templates/clips/shared/prerendered-public-paths.ts +21 -0
  24. package/corpus/templates/clips/shared/share-meta.ts +8 -3
  25. package/corpus/templates/content/.agents/skills/turn-into-app/SKILL.md +18 -6
  26. package/corpus/templates/content/.agents/skills/turn-into-app/references/fresh-project.md +8 -1
  27. package/corpus/templates/crm/.agents/skills/turn-into-app/SKILL.md +18 -6
  28. package/corpus/templates/crm/.agents/skills/turn-into-app/references/fresh-project.md +8 -1
  29. package/corpus/templates/design/.agents/skills/turn-into-app/SKILL.md +18 -6
  30. package/corpus/templates/design/.agents/skills/turn-into-app/references/fresh-project.md +8 -1
  31. package/corpus/templates/dispatch/.agents/skills/turn-into-app/SKILL.md +18 -6
  32. package/corpus/templates/dispatch/.agents/skills/turn-into-app/references/fresh-project.md +8 -1
  33. package/corpus/templates/dispatch/app/chat-first-pages.ts +747 -0
  34. package/corpus/templates/dispatch/app/i18n-data.ts +181 -0
  35. package/corpus/templates/dispatch/app/routes/settings.tsx +62 -1
  36. package/corpus/templates/dispatch/changelog/2026-08-08-chat-first-navigation-keeps-conversations-central-while-open.md +6 -0
  37. package/corpus/templates/factory/.agents/skills/adding-a-feature/SKILL.md +9 -0
  38. package/corpus/templates/factory/.agents/skills/turn-into-app/SKILL.md +18 -6
  39. package/corpus/templates/factory/.agents/skills/turn-into-app/references/fresh-project.md +8 -1
  40. package/corpus/templates/factory/app/routes/factory.tsx +108 -76
  41. package/corpus/templates/factory/changelog/2026-08-08-scheduler-health-moves-to-settings.md +6 -0
  42. package/corpus/templates/forms/.agents/skills/turn-into-app/SKILL.md +18 -6
  43. package/corpus/templates/forms/.agents/skills/turn-into-app/references/fresh-project.md +8 -1
  44. package/corpus/templates/macros/.agents/skills/turn-into-app/SKILL.md +18 -6
  45. package/corpus/templates/macros/.agents/skills/turn-into-app/references/fresh-project.md +8 -1
  46. package/corpus/templates/mail/.agents/skills/turn-into-app/SKILL.md +18 -6
  47. package/corpus/templates/mail/.agents/skills/turn-into-app/references/fresh-project.md +8 -1
  48. package/corpus/templates/plan/.agents/skills/adding-a-feature/SKILL.md +9 -0
  49. package/corpus/templates/plan/.agents/skills/turn-into-app/SKILL.md +18 -6
  50. package/corpus/templates/plan/.agents/skills/turn-into-app/references/fresh-project.md +8 -1
  51. package/corpus/templates/plan/app/lib/plan-document-title.ts +3 -1
  52. package/corpus/templates/plan/app/root.tsx +1 -0
  53. package/corpus/templates/slides/.agents/skills/turn-into-app/SKILL.md +18 -6
  54. package/corpus/templates/slides/.agents/skills/turn-into-app/references/fresh-project.md +8 -1
  55. package/corpus/templates/tasks/.agents/skills/adding-a-feature/SKILL.md +9 -0
  56. package/corpus/templates/tasks/.agents/skills/turn-into-app/SKILL.md +18 -6
  57. package/corpus/templates/tasks/.agents/skills/turn-into-app/references/fresh-project.md +8 -1
  58. package/dist/agent/engine/builder-engine.d.ts +11 -1
  59. package/dist/agent/engine/builder-engine.js +11 -4
  60. package/dist/chat-threads/store.d.ts +2 -0
  61. package/dist/chat-threads/store.js +1 -1
  62. package/dist/cli/agent-plugin.d.ts +5 -2
  63. package/dist/cli/agent-plugin.js +17 -9
  64. package/dist/cli/code-agent-executor.js +25 -5
  65. package/dist/cli/code-agent-mcp-config.d.ts +21 -0
  66. package/dist/cli/code-agent-mcp-config.js +103 -0
  67. package/dist/client/NewWorkspaceAppFlow.js +4 -1
  68. package/dist/client/agent-chat/index.d.ts +4 -1
  69. package/dist/client/agent-chat/index.js +4 -1
  70. package/dist/client/agent-page/AgentTabsPage.d.ts +1 -0
  71. package/dist/client/agent-page/AgentTabsPage.js +4 -3
  72. package/dist/client/app-providers.d.ts +3 -1
  73. package/dist/client/app-providers.js +50 -5
  74. package/dist/client/chat/runtime.js +63 -0
  75. package/dist/client/chat-first/agents-pane.d.ts +2 -0
  76. package/dist/client/chat-first/agents-pane.js +6 -0
  77. package/dist/client/chat-first/app-pane.d.ts +2 -0
  78. package/dist/client/chat-first/app-pane.js +6 -0
  79. package/dist/client/chat-first/apps-rail.d.ts +2 -0
  80. package/dist/client/chat-first/apps-rail.js +103 -0
  81. package/dist/client/chat-first/browser-pane.d.ts +2 -0
  82. package/dist/client/chat-first/browser-pane.js +64 -0
  83. package/dist/client/chat-first/chat-history.d.ts +12 -0
  84. package/dist/client/chat-first/chat-history.js +10 -0
  85. package/dist/client/chat-first/copy.d.ts +2 -0
  86. package/dist/client/chat-first/copy.js +117 -0
  87. package/dist/client/chat-first/index.d.ts +13 -0
  88. package/dist/client/chat-first/index.js +12 -0
  89. package/dist/client/chat-first/primary-nav.d.ts +8 -0
  90. package/dist/client/chat-first/primary-nav.js +6 -0
  91. package/dist/client/chat-first/session-watch-pane.d.ts +2 -0
  92. package/dist/client/chat-first/session-watch-pane.js +9 -0
  93. package/dist/client/chat-first/surface-panel.d.ts +9 -0
  94. package/dist/client/chat-first/surface-panel.js +9 -0
  95. package/dist/client/chat-first/surface-tabs.d.ts +9 -0
  96. package/dist/client/chat-first/surface-tabs.js +74 -0
  97. package/dist/client/chat-first/types.d.ts +74 -0
  98. package/dist/client/chat-first/types.js +1 -0
  99. package/dist/client/chat-first-agent-activity.d.ts +11 -0
  100. package/dist/client/chat-first-agent-activity.js +51 -0
  101. package/dist/client/chat-first-surface-panel-toggle.d.ts +5 -0
  102. package/dist/client/chat-first-surface-panel-toggle.js +6 -0
  103. package/dist/client/chat-first.d.ts +208 -0
  104. package/dist/client/chat-first.js +816 -0
  105. package/dist/client/extensions/ExtensionViewer.js +8 -1
  106. package/dist/client/resources/McpIntegrationDialog.js +3 -2
  107. package/dist/client/resources/McpServerDetail.js +6 -11
  108. package/dist/client/resources/index.d.ts +1 -0
  109. package/dist/client/resources/index.js +1 -0
  110. package/dist/client/resources/use-mcp-servers.d.ts +20 -0
  111. package/dist/client/resources/use-mcp-servers.js +82 -46
  112. package/dist/client/settings/index.d.ts +1 -0
  113. package/dist/client/settings/index.js +1 -0
  114. package/dist/collab/awareness.d.ts +2 -2
  115. package/dist/collab/routes.d.ts +1 -1
  116. package/dist/collab/struct-routes.d.ts +1 -1
  117. package/dist/jobs/background-automation-runner.js +19 -2
  118. package/dist/jobs/scheduler-health.d.ts +20 -0
  119. package/dist/jobs/scheduler-health.js +86 -1
  120. package/dist/jobs/scheduler.js +38 -1
  121. package/dist/mcp-client/routes.d.ts +3 -0
  122. package/dist/mcp-client/routes.js +14 -0
  123. package/dist/notifications/routes.d.ts +1 -1
  124. package/dist/observability/routes.d.ts +5 -5
  125. package/dist/progress/routes.d.ts +1 -1
  126. package/dist/provider-api/actions/provider-api.d.ts +2 -2
  127. package/dist/resources/handlers.d.ts +1 -1
  128. package/dist/secrets/routes.d.ts +3 -3
  129. package/dist/server/agent-engine-api-key-route.d.ts +1 -1
  130. package/dist/server/agents-bundle.d.ts +2 -0
  131. package/dist/server/agents-bundle.js +31 -2
  132. package/dist/server/credential-provider.d.ts +8 -2
  133. package/dist/server/credential-provider.js +13 -9
  134. package/dist/server/realtime-token.d.ts +1 -1
  135. package/dist/server/transcribe-voice.d.ts +1 -1
  136. package/dist/shared/chat-first-app-creation.d.ts +19 -0
  137. package/dist/shared/chat-first-app-creation.js +75 -0
  138. package/dist/shared/document-title.d.ts +7 -0
  139. package/dist/shared/document-title.js +29 -0
  140. package/dist/shared/index.d.ts +2 -0
  141. package/dist/shared/index.js +2 -0
  142. package/dist/styles/chat-history-list.css +16 -0
  143. package/dist/templates/chat/.agents/skills/adding-a-feature/SKILL.md +9 -0
  144. package/dist/templates/chat/.agents/skills/turn-into-app/SKILL.md +18 -6
  145. package/dist/templates/chat/.agents/skills/turn-into-app/references/fresh-project.md +8 -1
  146. package/dist/templates/default/.agents/skills/adding-a-feature/SKILL.md +9 -0
  147. package/dist/templates/default/.agents/skills/turn-into-app/SKILL.md +18 -6
  148. package/dist/templates/default/.agents/skills/turn-into-app/references/fresh-project.md +8 -1
  149. package/dist/templates/default/react-router.config.ts +18 -0
  150. package/dist/templates/headless/.agents/skills/turn-into-app/SKILL.md +18 -6
  151. package/dist/templates/headless/.agents/skills/turn-into-app/references/fresh-project.md +8 -1
  152. package/dist/templates/workspace-core/.agents/skills/adding-a-feature/SKILL.md +9 -0
  153. package/dist/templates/workspace-core/.agents/skills/turn-into-app/SKILL.md +18 -6
  154. package/dist/templates/workspace-core/.agents/skills/turn-into-app/references/fresh-project.md +8 -1
  155. package/dist/templates/workspace-core/.agents/skills/workspace-conventions/SKILL.md +7 -0
  156. package/package.json +3 -2
  157. package/src/templates/chat/.agents/skills/adding-a-feature/SKILL.md +9 -0
  158. package/src/templates/chat/.agents/skills/turn-into-app/SKILL.md +18 -6
  159. package/src/templates/chat/.agents/skills/turn-into-app/references/fresh-project.md +8 -1
  160. package/src/templates/default/.agents/skills/adding-a-feature/SKILL.md +9 -0
  161. package/src/templates/default/.agents/skills/turn-into-app/SKILL.md +18 -6
  162. package/src/templates/default/.agents/skills/turn-into-app/references/fresh-project.md +8 -1
  163. package/src/templates/default/react-router.config.ts +18 -0
  164. package/src/templates/headless/.agents/skills/turn-into-app/SKILL.md +18 -6
  165. package/src/templates/headless/.agents/skills/turn-into-app/references/fresh-project.md +8 -1
  166. package/src/templates/workspace-core/.agents/skills/adding-a-feature/SKILL.md +9 -0
  167. package/src/templates/workspace-core/.agents/skills/turn-into-app/SKILL.md +18 -6
  168. package/src/templates/workspace-core/.agents/skills/turn-into-app/references/fresh-project.md +8 -1
  169. package/src/templates/workspace-core/.agents/skills/workspace-conventions/SKILL.md +7 -0
@@ -589,11 +589,6 @@ function AutomationsView({
589
589
  "list-factory-automations",
590
590
  { factoryId },
591
591
  );
592
- const healthQuery = useActionQuery<FactoryAutomationHealth>(
593
- "get-factory-automation-health",
594
- {},
595
- { refetchInterval: 60_000 },
596
- );
597
592
  const saveMutation = useActionMutation("save-factory-automation");
598
593
  const runMutation = useActionMutation("run-factory-automation");
599
594
  const {
@@ -684,85 +679,17 @@ function AutomationsView({
684
679
  schedule: draft.schedule ?? "",
685
680
  enabled: draft.enabled,
686
681
  });
687
- await Promise.all([automationsQuery.refetch(), healthQuery.refetch()]);
682
+ await automationsQuery.refetch();
688
683
  }
689
684
 
690
685
  async function runAutomation() {
691
686
  if (!draft) return;
692
687
  await runMutation.mutateAsync({ factoryId, automationId: draft.id });
693
- await Promise.all([automationsQuery.refetch(), healthQuery.refetch()]);
688
+ await automationsQuery.refetch();
694
689
  }
695
690
 
696
- const health = healthQuery.data;
697
- const healthLabel = health
698
- ? {
699
- healthy: t("factoryRoute.automationHealthHealthy"),
700
- stale: t("factoryRoute.automationHealthStale"),
701
- error: t("factoryRoute.automationHealthError"),
702
- "no-data": t("factoryRoute.automationHealthNoData"),
703
- }[health.status]
704
- : t("factoryRoute.automationHealthNoData");
705
-
706
691
  return (
707
692
  <div className="space-y-4 p-4 lg:p-6">
708
- <Card>
709
- <CardHeader className="pb-3">
710
- <CardTitle className="text-base">
711
- {t("factoryRoute.automationHealthTitle")}
712
- </CardTitle>
713
- <p className="text-sm text-muted-foreground">
714
- {t("factoryRoute.automationHealthDescription")}
715
- </p>
716
- </CardHeader>
717
- <CardContent className="space-y-2 pt-0 text-sm">
718
- <div className="flex flex-wrap items-center gap-2">
719
- <span className="rounded-full border px-2 py-1 font-medium">
720
- {healthLabel}
721
- </span>
722
- {health?.lastCheckedAt && (
723
- <span className="text-muted-foreground">
724
- {t("factoryRoute.automationLastCheck")}:{" "}
725
- {formatAutomationDate(health.lastCheckedAt)}
726
- </span>
727
- )}
728
- {health?.lastDispatchedAt && (
729
- <span className="text-muted-foreground">
730
- {t("factoryRoute.automationLastDispatch")}:{" "}
731
- {formatAutomationDate(health.lastDispatchedAt)}
732
- </span>
733
- )}
734
- {health?.runtime && (
735
- <span className="text-muted-foreground">
736
- {t("factoryRoute.automationRuntime")}: {health.runtime}
737
- </span>
738
- )}
739
- </div>
740
- {!health?.lastCheckedAt && (
741
- <p className="text-muted-foreground">
742
- {t("factoryRoute.automationHealthNoDataHint")}
743
- </p>
744
- )}
745
- {health?.status === "stale" && (
746
- <p className="text-destructive">
747
- {t("factoryRoute.automationHealthStaleHint")}
748
- </p>
749
- )}
750
- {health?.lastError && (
751
- <p className="text-destructive">
752
- {t("factoryRoute.automationHealthErrorDetail")}:{" "}
753
- {health.lastError}
754
- </p>
755
- )}
756
- {healthQuery.isError && (
757
- <p className="text-destructive">
758
- {t("factoryRoute.automationDiagnosticsLoadError")}{" "}
759
- {healthQuery.error instanceof Error
760
- ? healthQuery.error.message
761
- : String(healthQuery.error)}
762
- </p>
763
- )}
764
- </CardContent>
765
- </Card>
766
693
  <div className="grid gap-4 lg:grid-cols-[minmax(220px,.35fr)_minmax(0,1fr)]">
767
694
  <Card>
768
695
  <CardHeader>
@@ -1407,6 +1334,11 @@ function SettingsView({ t }: { t: ReturnType<typeof useT> }) {
1407
1334
  const [automationFailureAlertEmail, setAutomationFailureAlertEmail] =
1408
1335
  useState("");
1409
1336
  const query = useActionQuery("get-triage-config", {});
1337
+ const schedulerHealthQuery = useActionQuery<FactoryAutomationHealth>(
1338
+ "get-factory-automation-health",
1339
+ {},
1340
+ { refetchInterval: 60_000 },
1341
+ );
1410
1342
  const mutation = useActionMutation("save-triage-config");
1411
1343
  useEffect(() => {
1412
1344
  const data = query.data as TriageConfig | undefined;
@@ -1427,7 +1359,7 @@ function SettingsView({ t }: { t: ReturnType<typeof useT> }) {
1427
1359
  setAutomationFailureAlertEmail(data.automationFailureAlertEmail ?? "");
1428
1360
  }, [query.data]);
1429
1361
  return (
1430
- <div className="max-w-4xl p-4 lg:p-6">
1362
+ <div className="max-w-4xl space-y-4 p-4 lg:p-6">
1431
1363
  <Card>
1432
1364
  <CardHeader>
1433
1365
  <CardTitle className="text-base">
@@ -1621,10 +1553,110 @@ function SettingsView({ t }: { t: ReturnType<typeof useT> }) {
1621
1553
  </div>
1622
1554
  </CardContent>
1623
1555
  </Card>
1556
+ <SchedulerHealthStatus
1557
+ health={schedulerHealthQuery.data}
1558
+ isError={schedulerHealthQuery.isError}
1559
+ error={schedulerHealthQuery.error}
1560
+ t={t}
1561
+ />
1624
1562
  </div>
1625
1563
  );
1626
1564
  }
1627
1565
 
1566
+ function SchedulerHealthStatus({
1567
+ health,
1568
+ isError,
1569
+ error,
1570
+ t,
1571
+ }: {
1572
+ health?: FactoryAutomationHealth;
1573
+ isError: boolean;
1574
+ error: unknown;
1575
+ t: ReturnType<typeof useT>;
1576
+ }) {
1577
+ const healthLabel = isError
1578
+ ? t("factoryRoute.automationHealthError")
1579
+ : health
1580
+ ? {
1581
+ healthy: t("factoryRoute.automationHealthHealthy"),
1582
+ stale: t("factoryRoute.automationHealthStale"),
1583
+ error: t("factoryRoute.automationHealthError"),
1584
+ "no-data": t("factoryRoute.automationHealthNoData"),
1585
+ }[health.status]
1586
+ : t("factoryRoute.automationHealthNoData");
1587
+ const hasNoHeartbeat =
1588
+ !isError &&
1589
+ (!health || health.status === "no-data") &&
1590
+ !health?.lastCheckedAt;
1591
+ const hasDiagnostics =
1592
+ isError ||
1593
+ hasNoHeartbeat ||
1594
+ health?.status === "stale" ||
1595
+ health?.status === "error" ||
1596
+ Boolean(health?.lastError);
1597
+
1598
+ return (
1599
+ <section
1600
+ aria-labelledby="factory-scheduler-health"
1601
+ className="border-t px-1 pt-4"
1602
+ >
1603
+ <div className="flex flex-wrap items-center justify-between gap-x-4 gap-y-2">
1604
+ <div className="flex flex-wrap items-center gap-2">
1605
+ <h2
1606
+ id="factory-scheduler-health"
1607
+ className="text-sm font-medium text-muted-foreground"
1608
+ >
1609
+ {t("factoryRoute.automationHealthTitle")}
1610
+ </h2>
1611
+ <span className="rounded-full border px-2 py-0.5 text-xs font-medium">
1612
+ {healthLabel}
1613
+ </span>
1614
+ </div>
1615
+ <div className="flex flex-wrap gap-x-4 gap-y-1 text-xs text-muted-foreground">
1616
+ {health?.lastCheckedAt && (
1617
+ <span>
1618
+ {t("factoryRoute.automationLastCheck")}:{" "}
1619
+ {formatAutomationDate(health.lastCheckedAt)}
1620
+ </span>
1621
+ )}
1622
+ {health?.lastDispatchedAt && (
1623
+ <span>
1624
+ {t("factoryRoute.automationLastDispatch")}:{" "}
1625
+ {formatAutomationDate(health.lastDispatchedAt)}
1626
+ </span>
1627
+ )}
1628
+ </div>
1629
+ </div>
1630
+ {hasDiagnostics && (
1631
+ <div className="mt-2 grid gap-1 text-xs">
1632
+ {hasNoHeartbeat && (
1633
+ <p className="text-muted-foreground">
1634
+ {t("factoryRoute.automationHealthNoDataHint")}
1635
+ </p>
1636
+ )}
1637
+ {health?.status === "stale" && (
1638
+ <p className="text-destructive">
1639
+ {t("factoryRoute.automationHealthStaleHint")}
1640
+ </p>
1641
+ )}
1642
+ {health?.lastError && (
1643
+ <p className="text-destructive">
1644
+ {t("factoryRoute.automationHealthErrorDetail")}:{" "}
1645
+ {health.lastError}
1646
+ </p>
1647
+ )}
1648
+ {isError && (
1649
+ <p className="text-destructive">
1650
+ {t("factoryRoute.automationDiagnosticsLoadError")}{" "}
1651
+ {error instanceof Error ? error.message : String(error)}
1652
+ </p>
1653
+ )}
1654
+ </div>
1655
+ )}
1656
+ </section>
1657
+ );
1658
+ }
1659
+
1628
1660
  function ErrorState({
1629
1661
  message,
1630
1662
  onRetry,
@@ -0,0 +1,6 @@
1
+ ---
2
+ type: improved
3
+ date: 2026-08-08
4
+ ---
5
+
6
+ Scheduler health now stays in Settings until diagnostics are needed.
@@ -3,8 +3,9 @@ name: turn-into-app
3
3
  description: >-
4
4
  Turn visible project context, a proven thread, skill, or workflow into a
5
5
  runnable Agent-Native app with simple buttons, visible agent steps, preview,
6
- and deployment handoff. Use when a user invokes `/turn-into-app` or asks to
7
- make a workflow into an app, including from Claude or ChatGPT on the web.
6
+ and deployment handoff. Use when a user invokes `/turn-into-app`,
7
+ `/make-into-app`, or asks to make a workflow into an app, including from
8
+ Claude or ChatGPT on the web.
8
9
  user-invocable: true
9
10
  scope: both
10
11
  metadata:
@@ -38,6 +39,15 @@ The build location depends on the host. Treat this as a hard routing rule:
38
39
  workspace, follow the local implementation steps below. The local agent may
39
40
  scaffold, edit, run, and verify the app there.
40
41
 
42
+ Once the source brief is sufficient to identify a repeatable workflow, the
43
+ handoff is non-interactive. Do not ask the user for visual, product, copy,
44
+ layout, template, integration, or implementation choices that can be resolved
45
+ from the source. Select the source's recommended option; otherwise choose the
46
+ most direct conventional default and record the assumption for later review.
47
+ Only stop for a genuine hard blocker such as missing authorization, a
48
+ destructive external action, an ambiguous target workspace, or no identifiable
49
+ workflow at all.
50
+
41
51
  ## Default behavior
42
52
 
43
53
  For a local code-agent runtime this is an end-to-end build skill, not a request
@@ -104,14 +114,16 @@ before creating the app. Read the host-provided context in this order:
104
114
  Record the brief with these headings before handoff: source and provenance,
105
115
  project goal, configuration and constraints, knowledge sources, repeatable
106
116
  workflow, inputs and outputs, judgment and review points, representative runs,
107
- integrations and permissions, and unknowns. This is the compact contract for
117
+ integrations and permissions, and unknowns and assumptions. This is the compact contract for
108
118
  the app. It keeps the new app useful without pretending that hidden Project
109
119
  history was imported. See [the fresh Project reference](references/fresh-project.md)
110
120
  for the host setup and brief template.
111
121
 
112
- If the visible Project context has no concrete repeatable job, ask for one
113
- focused clarification or a representative artifact. Do not fall back to a
114
- generic “what app do you want to make?” builder.
122
+ If the visible Project context has no concrete repeatable job and no primary
123
+ goal can be inferred, ask for one focused clarification or a representative
124
+ artifact. Otherwise use the project's primary goal and source conventions; do
125
+ not ask a questionnaire and do not fall back to a generic “what app do you
126
+ want to make?” builder.
115
127
 
116
128
  ## Source selection guard
117
129
 
@@ -36,7 +36,7 @@ Inputs and outputs:
36
36
  Judgment and review points:
37
37
  Representative runs: none, or 1-3 selected examples
38
38
  Integrations and permissions:
39
- Unknowns and follow-up:
39
+ Unknowns and assumptions:
40
40
  ```
41
41
 
42
42
  Keep source references bounded. Prefer a file name, URL, resource ID, or short
@@ -69,6 +69,13 @@ do not fall back to a local sandbox build. Claude Code and Codex Code are the
69
69
  local-agent exception and may follow the implementation steps in the main
70
70
  skill.
71
71
 
72
+ The brief is an implementation authorization, not a questionnaire. After a
73
+ repeatable workflow is identifiable, choose any source-recommended option
74
+ automatically. For unresolved non-blocking choices, use the most direct
75
+ conventional default, record it under assumptions, and continue. Ask only when
76
+ there is no identifiable workflow, no authorized target workspace, or a
77
+ destructive/credential boundary genuinely prevents the handoff.
78
+
72
79
  In a new Project chat, say:
73
80
 
74
81
  ```text
@@ -3,8 +3,9 @@ name: turn-into-app
3
3
  description: >-
4
4
  Turn visible project context, a proven thread, skill, or workflow into a
5
5
  runnable Agent-Native app with simple buttons, visible agent steps, preview,
6
- and deployment handoff. Use when a user invokes `/turn-into-app` or asks to
7
- make a workflow into an app, including from Claude or ChatGPT on the web.
6
+ and deployment handoff. Use when a user invokes `/turn-into-app`,
7
+ `/make-into-app`, or asks to make a workflow into an app, including from
8
+ Claude or ChatGPT on the web.
8
9
  user-invocable: true
9
10
  scope: both
10
11
  metadata:
@@ -38,6 +39,15 @@ The build location depends on the host. Treat this as a hard routing rule:
38
39
  workspace, follow the local implementation steps below. The local agent may
39
40
  scaffold, edit, run, and verify the app there.
40
41
 
42
+ Once the source brief is sufficient to identify a repeatable workflow, the
43
+ handoff is non-interactive. Do not ask the user for visual, product, copy,
44
+ layout, template, integration, or implementation choices that can be resolved
45
+ from the source. Select the source's recommended option; otherwise choose the
46
+ most direct conventional default and record the assumption for later review.
47
+ Only stop for a genuine hard blocker such as missing authorization, a
48
+ destructive external action, an ambiguous target workspace, or no identifiable
49
+ workflow at all.
50
+
41
51
  ## Default behavior
42
52
 
43
53
  For a local code-agent runtime this is an end-to-end build skill, not a request
@@ -104,14 +114,16 @@ before creating the app. Read the host-provided context in this order:
104
114
  Record the brief with these headings before handoff: source and provenance,
105
115
  project goal, configuration and constraints, knowledge sources, repeatable
106
116
  workflow, inputs and outputs, judgment and review points, representative runs,
107
- integrations and permissions, and unknowns. This is the compact contract for
117
+ integrations and permissions, and unknowns and assumptions. This is the compact contract for
108
118
  the app. It keeps the new app useful without pretending that hidden Project
109
119
  history was imported. See [the fresh Project reference](references/fresh-project.md)
110
120
  for the host setup and brief template.
111
121
 
112
- If the visible Project context has no concrete repeatable job, ask for one
113
- focused clarification or a representative artifact. Do not fall back to a
114
- generic “what app do you want to make?” builder.
122
+ If the visible Project context has no concrete repeatable job and no primary
123
+ goal can be inferred, ask for one focused clarification or a representative
124
+ artifact. Otherwise use the project's primary goal and source conventions; do
125
+ not ask a questionnaire and do not fall back to a generic “what app do you
126
+ want to make?” builder.
115
127
 
116
128
  ## Source selection guard
117
129
 
@@ -36,7 +36,7 @@ Inputs and outputs:
36
36
  Judgment and review points:
37
37
  Representative runs: none, or 1-3 selected examples
38
38
  Integrations and permissions:
39
- Unknowns and follow-up:
39
+ Unknowns and assumptions:
40
40
  ```
41
41
 
42
42
  Keep source references bounded. Prefer a file name, URL, resource ID, or short
@@ -69,6 +69,13 @@ do not fall back to a local sandbox build. Claude Code and Codex Code are the
69
69
  local-agent exception and may follow the implementation steps in the main
70
70
  skill.
71
71
 
72
+ The brief is an implementation authorization, not a questionnaire. After a
73
+ repeatable workflow is identifiable, choose any source-recommended option
74
+ automatically. For unresolved non-blocking choices, use the most direct
75
+ conventional default, record it under assumptions, and continue. Ask only when
76
+ there is no identifiable workflow, no authorized target workspace, or a
77
+ destructive/credential boundary genuinely prevents the handoff.
78
+
72
79
  In a new Project chat, say:
73
80
 
74
81
  ```text
@@ -3,8 +3,9 @@ name: turn-into-app
3
3
  description: >-
4
4
  Turn visible project context, a proven thread, skill, or workflow into a
5
5
  runnable Agent-Native app with simple buttons, visible agent steps, preview,
6
- and deployment handoff. Use when a user invokes `/turn-into-app` or asks to
7
- make a workflow into an app, including from Claude or ChatGPT on the web.
6
+ and deployment handoff. Use when a user invokes `/turn-into-app`,
7
+ `/make-into-app`, or asks to make a workflow into an app, including from
8
+ Claude or ChatGPT on the web.
8
9
  user-invocable: true
9
10
  scope: both
10
11
  metadata:
@@ -38,6 +39,15 @@ The build location depends on the host. Treat this as a hard routing rule:
38
39
  workspace, follow the local implementation steps below. The local agent may
39
40
  scaffold, edit, run, and verify the app there.
40
41
 
42
+ Once the source brief is sufficient to identify a repeatable workflow, the
43
+ handoff is non-interactive. Do not ask the user for visual, product, copy,
44
+ layout, template, integration, or implementation choices that can be resolved
45
+ from the source. Select the source's recommended option; otherwise choose the
46
+ most direct conventional default and record the assumption for later review.
47
+ Only stop for a genuine hard blocker such as missing authorization, a
48
+ destructive external action, an ambiguous target workspace, or no identifiable
49
+ workflow at all.
50
+
41
51
  ## Default behavior
42
52
 
43
53
  For a local code-agent runtime this is an end-to-end build skill, not a request
@@ -104,14 +114,16 @@ before creating the app. Read the host-provided context in this order:
104
114
  Record the brief with these headings before handoff: source and provenance,
105
115
  project goal, configuration and constraints, knowledge sources, repeatable
106
116
  workflow, inputs and outputs, judgment and review points, representative runs,
107
- integrations and permissions, and unknowns. This is the compact contract for
117
+ integrations and permissions, and unknowns and assumptions. This is the compact contract for
108
118
  the app. It keeps the new app useful without pretending that hidden Project
109
119
  history was imported. See [the fresh Project reference](references/fresh-project.md)
110
120
  for the host setup and brief template.
111
121
 
112
- If the visible Project context has no concrete repeatable job, ask for one
113
- focused clarification or a representative artifact. Do not fall back to a
114
- generic “what app do you want to make?” builder.
122
+ If the visible Project context has no concrete repeatable job and no primary
123
+ goal can be inferred, ask for one focused clarification or a representative
124
+ artifact. Otherwise use the project's primary goal and source conventions; do
125
+ not ask a questionnaire and do not fall back to a generic “what app do you
126
+ want to make?” builder.
115
127
 
116
128
  ## Source selection guard
117
129
 
@@ -36,7 +36,7 @@ Inputs and outputs:
36
36
  Judgment and review points:
37
37
  Representative runs: none, or 1-3 selected examples
38
38
  Integrations and permissions:
39
- Unknowns and follow-up:
39
+ Unknowns and assumptions:
40
40
  ```
41
41
 
42
42
  Keep source references bounded. Prefer a file name, URL, resource ID, or short
@@ -69,6 +69,13 @@ do not fall back to a local sandbox build. Claude Code and Codex Code are the
69
69
  local-agent exception and may follow the implementation steps in the main
70
70
  skill.
71
71
 
72
+ The brief is an implementation authorization, not a questionnaire. After a
73
+ repeatable workflow is identifiable, choose any source-recommended option
74
+ automatically. For unresolved non-blocking choices, use the most direct
75
+ conventional default, record it under assumptions, and continue. Ask only when
76
+ there is no identifiable workflow, no authorized target workspace, or a
77
+ destructive/credential boundary genuinely prevents the handoff.
78
+
72
79
  In a new Project chat, say:
73
80
 
74
81
  ```text
@@ -81,6 +81,13 @@ or other file-like payloads, design the upload path in the same change:
81
81
  provider upload first, then URL/id/blob handle in SQL. Do not add base64/binary
82
82
  columns or stuff files into `application_state`.
83
83
 
84
+ If the feature adds a server-side dependency carrying a native binary or heavy
85
+ runtime — headless browser, ffmpeg, image/video processing, ML runtime — read
86
+ the `performance` skill §9 before adding it. A deployed app has one `/*` page
87
+ function that every visitor's cache miss wakes, and it ships whatever the server
88
+ bundle depends on. Run that work from a background function or a job so the page
89
+ function never carries the weight.
90
+
84
91
  **If the action produces or lists a navigable resource**, add a `link` builder that returns `{ url: buildDeepLink({ app, view, params }), label }`. External coding agents and MCP hosts (Claude / ChatGPT / Claude Code / Cowork / Codex, over MCP/A2A) then surface an "Open in … →" deep link that drops the user back into the running UI focused on the record — for free. If a compatible MCP host should render an inline review/edit surface, also add `mcpApp` with `embedApp()` so the action embeds the real React app route instead of a one-off HTML UI. The `link` builder and `mcpApp` metadata must be pure and synchronous (no I/O). Any external-agent read/ingest action must be `http: { method: "GET" }` + `readOnly: true` + `publicAgent: { expose: true, readOnly: true, requiresAuth: true }`. See the `external-agents` skill.
85
92
 
86
93
  ### 3. Skills / Instructions
@@ -195,4 +202,6 @@ TL;DR: declare the vocabulary once with `defineAppRoles({ appId, roles, defaultR
195
202
  - **create-skill** — How to create skills for new patterns (area 3 in detail)
196
203
  - **storing-data** — Where to store the feature's data
197
204
  - **real-time-sync** — How the UI stays in sync when the agent writes data
205
+ - **performance** — Query/load cost, and (§9) cold-start artifact size when a
206
+ feature adds a server-side dependency
198
207
  - **internationalization** — How to update localized UI copy and catalogs
@@ -3,8 +3,9 @@ name: turn-into-app
3
3
  description: >-
4
4
  Turn visible project context, a proven thread, skill, or workflow into a
5
5
  runnable Agent-Native app with simple buttons, visible agent steps, preview,
6
- and deployment handoff. Use when a user invokes `/turn-into-app` or asks to
7
- make a workflow into an app, including from Claude or ChatGPT on the web.
6
+ and deployment handoff. Use when a user invokes `/turn-into-app`,
7
+ `/make-into-app`, or asks to make a workflow into an app, including from
8
+ Claude or ChatGPT on the web.
8
9
  user-invocable: true
9
10
  scope: both
10
11
  metadata:
@@ -38,6 +39,15 @@ The build location depends on the host. Treat this as a hard routing rule:
38
39
  workspace, follow the local implementation steps below. The local agent may
39
40
  scaffold, edit, run, and verify the app there.
40
41
 
42
+ Once the source brief is sufficient to identify a repeatable workflow, the
43
+ handoff is non-interactive. Do not ask the user for visual, product, copy,
44
+ layout, template, integration, or implementation choices that can be resolved
45
+ from the source. Select the source's recommended option; otherwise choose the
46
+ most direct conventional default and record the assumption for later review.
47
+ Only stop for a genuine hard blocker such as missing authorization, a
48
+ destructive external action, an ambiguous target workspace, or no identifiable
49
+ workflow at all.
50
+
41
51
  ## Default behavior
42
52
 
43
53
  For a local code-agent runtime this is an end-to-end build skill, not a request
@@ -104,14 +114,16 @@ before creating the app. Read the host-provided context in this order:
104
114
  Record the brief with these headings before handoff: source and provenance,
105
115
  project goal, configuration and constraints, knowledge sources, repeatable
106
116
  workflow, inputs and outputs, judgment and review points, representative runs,
107
- integrations and permissions, and unknowns. This is the compact contract for
117
+ integrations and permissions, and unknowns and assumptions. This is the compact contract for
108
118
  the app. It keeps the new app useful without pretending that hidden Project
109
119
  history was imported. See [the fresh Project reference](references/fresh-project.md)
110
120
  for the host setup and brief template.
111
121
 
112
- If the visible Project context has no concrete repeatable job, ask for one
113
- focused clarification or a representative artifact. Do not fall back to a
114
- generic “what app do you want to make?” builder.
122
+ If the visible Project context has no concrete repeatable job and no primary
123
+ goal can be inferred, ask for one focused clarification or a representative
124
+ artifact. Otherwise use the project's primary goal and source conventions; do
125
+ not ask a questionnaire and do not fall back to a generic “what app do you
126
+ want to make?” builder.
115
127
 
116
128
  ## Source selection guard
117
129
 
@@ -36,7 +36,7 @@ Inputs and outputs:
36
36
  Judgment and review points:
37
37
  Representative runs: none, or 1-3 selected examples
38
38
  Integrations and permissions:
39
- Unknowns and follow-up:
39
+ Unknowns and assumptions:
40
40
  ```
41
41
 
42
42
  Keep source references bounded. Prefer a file name, URL, resource ID, or short
@@ -69,6 +69,13 @@ do not fall back to a local sandbox build. Claude Code and Codex Code are the
69
69
  local-agent exception and may follow the implementation steps in the main
70
70
  skill.
71
71
 
72
+ The brief is an implementation authorization, not a questionnaire. After a
73
+ repeatable workflow is identifiable, choose any source-recommended option
74
+ automatically. For unresolved non-blocking choices, use the most direct
75
+ conventional default, record it under assumptions, and continue. Ask only when
76
+ there is no identifiable workflow, no authorized target workspace, or a
77
+ destructive/credential boundary genuinely prevents the handoff.
78
+
72
79
  In a new Project chat, say:
73
80
 
74
81
  ```text
@@ -1,6 +1,8 @@
1
+ import { normalizeDocumentTitle } from "@agent-native/core/shared";
2
+
1
3
  export function planDocumentTitle(
2
4
  planTitle: string | null | undefined,
3
5
  fallbackTitle: string,
4
6
  ): string {
5
- return planTitle?.trim() || fallbackTitle;
7
+ return normalizeDocumentTitle(planTitle, fallbackTitle);
6
8
  }
@@ -241,6 +241,7 @@ export default function Root() {
241
241
  <AppProviders
242
242
  queryClient={queryClient}
243
243
  sessionBypass={sessionBypass}
244
+ documentTitleFallback={APP_TITLE}
244
245
  toaster={<Toaster richColors position="bottom-left" />}
245
246
  i18n={{ catalog: i18nCatalog }}
246
247
  >
@@ -3,8 +3,9 @@ name: turn-into-app
3
3
  description: >-
4
4
  Turn visible project context, a proven thread, skill, or workflow into a
5
5
  runnable Agent-Native app with simple buttons, visible agent steps, preview,
6
- and deployment handoff. Use when a user invokes `/turn-into-app` or asks to
7
- make a workflow into an app, including from Claude or ChatGPT on the web.
6
+ and deployment handoff. Use when a user invokes `/turn-into-app`,
7
+ `/make-into-app`, or asks to make a workflow into an app, including from
8
+ Claude or ChatGPT on the web.
8
9
  user-invocable: true
9
10
  scope: both
10
11
  metadata:
@@ -38,6 +39,15 @@ The build location depends on the host. Treat this as a hard routing rule:
38
39
  workspace, follow the local implementation steps below. The local agent may
39
40
  scaffold, edit, run, and verify the app there.
40
41
 
42
+ Once the source brief is sufficient to identify a repeatable workflow, the
43
+ handoff is non-interactive. Do not ask the user for visual, product, copy,
44
+ layout, template, integration, or implementation choices that can be resolved
45
+ from the source. Select the source's recommended option; otherwise choose the
46
+ most direct conventional default and record the assumption for later review.
47
+ Only stop for a genuine hard blocker such as missing authorization, a
48
+ destructive external action, an ambiguous target workspace, or no identifiable
49
+ workflow at all.
50
+
41
51
  ## Default behavior
42
52
 
43
53
  For a local code-agent runtime this is an end-to-end build skill, not a request
@@ -104,14 +114,16 @@ before creating the app. Read the host-provided context in this order:
104
114
  Record the brief with these headings before handoff: source and provenance,
105
115
  project goal, configuration and constraints, knowledge sources, repeatable
106
116
  workflow, inputs and outputs, judgment and review points, representative runs,
107
- integrations and permissions, and unknowns. This is the compact contract for
117
+ integrations and permissions, and unknowns and assumptions. This is the compact contract for
108
118
  the app. It keeps the new app useful without pretending that hidden Project
109
119
  history was imported. See [the fresh Project reference](references/fresh-project.md)
110
120
  for the host setup and brief template.
111
121
 
112
- If the visible Project context has no concrete repeatable job, ask for one
113
- focused clarification or a representative artifact. Do not fall back to a
114
- generic “what app do you want to make?” builder.
122
+ If the visible Project context has no concrete repeatable job and no primary
123
+ goal can be inferred, ask for one focused clarification or a representative
124
+ artifact. Otherwise use the project's primary goal and source conventions; do
125
+ not ask a questionnaire and do not fall back to a generic “what app do you
126
+ want to make?” builder.
115
127
 
116
128
  ## Source selection guard
117
129
 
@@ -36,7 +36,7 @@ Inputs and outputs:
36
36
  Judgment and review points:
37
37
  Representative runs: none, or 1-3 selected examples
38
38
  Integrations and permissions:
39
- Unknowns and follow-up:
39
+ Unknowns and assumptions:
40
40
  ```
41
41
 
42
42
  Keep source references bounded. Prefer a file name, URL, resource ID, or short
@@ -69,6 +69,13 @@ do not fall back to a local sandbox build. Claude Code and Codex Code are the
69
69
  local-agent exception and may follow the implementation steps in the main
70
70
  skill.
71
71
 
72
+ The brief is an implementation authorization, not a questionnaire. After a
73
+ repeatable workflow is identifiable, choose any source-recommended option
74
+ automatically. For unresolved non-blocking choices, use the most direct
75
+ conventional default, record it under assumptions, and continue. Ask only when
76
+ there is no identifiable workflow, no authorized target workspace, or a
77
+ destructive/credential boundary genuinely prevents the handoff.
78
+
72
79
  In a new Project chat, say:
73
80
 
74
81
  ```text