@agent-native/core 0.95.1 โ†’ 0.97.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 (655) hide show
  1. package/README.md +6 -0
  2. package/corpus/README.md +2 -2
  3. package/corpus/core/CHANGELOG.md +64 -0
  4. package/corpus/core/docs/content/audit-log.mdx +2 -1
  5. package/corpus/core/docs/content/automations.mdx +7 -7
  6. package/corpus/core/docs/content/creating-templates.mdx +1 -1
  7. package/corpus/core/docs/content/internationalization.mdx +2 -1
  8. package/corpus/core/docs/content/locales/ar-SA/audit-log.mdx +2 -1
  9. package/corpus/core/docs/content/locales/ar-SA/automations.mdx +7 -7
  10. package/corpus/core/docs/content/locales/ar-SA/getting-started.mdx +7 -1
  11. package/corpus/core/docs/content/locales/ar-SA/internationalization.mdx +1 -1
  12. package/corpus/core/docs/content/locales/ar-SA/package-lifecycle.mdx +19 -0
  13. package/corpus/core/docs/content/locales/ar-SA/sandbox-adapters.mdx +18 -7
  14. package/corpus/core/docs/content/locales/ar-SA/security.mdx +8 -0
  15. package/corpus/core/docs/content/locales/de-DE/audit-log.mdx +2 -1
  16. package/corpus/core/docs/content/locales/de-DE/automations.mdx +7 -7
  17. package/corpus/core/docs/content/locales/de-DE/getting-started.mdx +7 -1
  18. package/corpus/core/docs/content/locales/de-DE/internationalization.mdx +1 -1
  19. package/corpus/core/docs/content/locales/de-DE/package-lifecycle.mdx +22 -0
  20. package/corpus/core/docs/content/locales/de-DE/sandbox-adapters.mdx +18 -7
  21. package/corpus/core/docs/content/locales/de-DE/security.mdx +8 -0
  22. package/corpus/core/docs/content/locales/es-ES/audit-log.mdx +2 -1
  23. package/corpus/core/docs/content/locales/es-ES/automations.mdx +7 -7
  24. package/corpus/core/docs/content/locales/es-ES/getting-started.mdx +7 -1
  25. package/corpus/core/docs/content/locales/es-ES/internationalization.mdx +1 -1
  26. package/corpus/core/docs/content/locales/es-ES/package-lifecycle.mdx +22 -0
  27. package/corpus/core/docs/content/locales/es-ES/sandbox-adapters.mdx +18 -7
  28. package/corpus/core/docs/content/locales/es-ES/security.mdx +8 -0
  29. package/corpus/core/docs/content/locales/fr-FR/audit-log.mdx +2 -1
  30. package/corpus/core/docs/content/locales/fr-FR/automations.mdx +7 -7
  31. package/corpus/core/docs/content/locales/fr-FR/getting-started.mdx +7 -1
  32. package/corpus/core/docs/content/locales/fr-FR/internationalization.mdx +1 -1
  33. package/corpus/core/docs/content/locales/fr-FR/package-lifecycle.mdx +21 -0
  34. package/corpus/core/docs/content/locales/fr-FR/sandbox-adapters.mdx +19 -8
  35. package/corpus/core/docs/content/locales/fr-FR/security.mdx +8 -0
  36. package/corpus/core/docs/content/locales/hi-IN/audit-log.mdx +2 -1
  37. package/corpus/core/docs/content/locales/hi-IN/automations.mdx +7 -7
  38. package/corpus/core/docs/content/locales/hi-IN/getting-started.mdx +7 -1
  39. package/corpus/core/docs/content/locales/hi-IN/internationalization.mdx +1 -1
  40. package/corpus/core/docs/content/locales/hi-IN/package-lifecycle.mdx +20 -0
  41. package/corpus/core/docs/content/locales/hi-IN/sandbox-adapters.mdx +18 -7
  42. package/corpus/core/docs/content/locales/hi-IN/security.mdx +8 -0
  43. package/corpus/core/docs/content/locales/ja-JP/audit-log.mdx +2 -1
  44. package/corpus/core/docs/content/locales/ja-JP/automations.mdx +7 -7
  45. package/corpus/core/docs/content/locales/ja-JP/getting-started.mdx +7 -1
  46. package/corpus/core/docs/content/locales/ja-JP/internationalization.mdx +1 -1
  47. package/corpus/core/docs/content/locales/ja-JP/package-lifecycle.mdx +21 -0
  48. package/corpus/core/docs/content/locales/ja-JP/sandbox-adapters.mdx +17 -6
  49. package/corpus/core/docs/content/locales/ja-JP/security.mdx +8 -0
  50. package/corpus/core/docs/content/locales/ko-KR/audit-log.mdx +2 -1
  51. package/corpus/core/docs/content/locales/ko-KR/automations.mdx +7 -7
  52. package/corpus/core/docs/content/locales/ko-KR/getting-started.mdx +7 -1
  53. package/corpus/core/docs/content/locales/ko-KR/internationalization.mdx +1 -1
  54. package/corpus/core/docs/content/locales/ko-KR/package-lifecycle.mdx +20 -0
  55. package/corpus/core/docs/content/locales/ko-KR/sandbox-adapters.mdx +17 -6
  56. package/corpus/core/docs/content/locales/ko-KR/security.mdx +8 -0
  57. package/corpus/core/docs/content/locales/pt-BR/audit-log.mdx +2 -1
  58. package/corpus/core/docs/content/locales/pt-BR/automations.mdx +7 -7
  59. package/corpus/core/docs/content/locales/pt-BR/getting-started.mdx +7 -1
  60. package/corpus/core/docs/content/locales/pt-BR/internationalization.mdx +1 -1
  61. package/corpus/core/docs/content/locales/pt-BR/package-lifecycle.mdx +21 -0
  62. package/corpus/core/docs/content/locales/pt-BR/sandbox-adapters.mdx +18 -7
  63. package/corpus/core/docs/content/locales/pt-BR/security.mdx +8 -0
  64. package/corpus/core/docs/content/locales/zh-CN/audit-log.mdx +2 -1
  65. package/corpus/core/docs/content/locales/zh-CN/automations.mdx +7 -7
  66. package/corpus/core/docs/content/locales/zh-CN/getting-started.mdx +6 -4
  67. package/corpus/core/docs/content/locales/zh-CN/internationalization.mdx +1 -1
  68. package/corpus/core/docs/content/locales/zh-CN/package-lifecycle.mdx +19 -0
  69. package/corpus/core/docs/content/locales/zh-CN/sandbox-adapters.mdx +17 -6
  70. package/corpus/core/docs/content/locales/zh-CN/security.mdx +8 -0
  71. package/corpus/core/docs/content/locales/zh-TW/audit-log.mdx +2 -1
  72. package/corpus/core/docs/content/locales/zh-TW/automations.mdx +7 -7
  73. package/corpus/core/docs/content/locales/zh-TW/getting-started.mdx +6 -4
  74. package/corpus/core/docs/content/locales/zh-TW/internationalization.mdx +1 -1
  75. package/corpus/core/docs/content/locales/zh-TW/package-lifecycle.mdx +19 -0
  76. package/corpus/core/docs/content/locales/zh-TW/sandbox-adapters.mdx +18 -7
  77. package/corpus/core/docs/content/locales/zh-TW/security.mdx +8 -0
  78. package/corpus/core/docs/content/package-lifecycle.mdx +51 -0
  79. package/corpus/core/docs/content/sandbox-adapters.mdx +16 -5
  80. package/corpus/core/package.json +11 -2
  81. package/corpus/core/src/a2a/auth-policy.ts +33 -0
  82. package/corpus/core/src/a2a/client.ts +11 -1
  83. package/corpus/core/src/agent/durable-background.ts +15 -7
  84. package/corpus/core/src/agent/production-agent.ts +87 -27
  85. package/corpus/core/src/agent/run-store.ts +13 -4
  86. package/corpus/core/src/agent/thread-data-builder.ts +7 -5
  87. package/corpus/core/src/audit/actions/export-audit-events.ts +162 -0
  88. package/corpus/core/src/audit/store.ts +8 -3
  89. package/corpus/core/src/audit/types.ts +3 -0
  90. package/corpus/core/src/chat-threads/store.ts +20 -1
  91. package/corpus/core/src/cli/code-agent-executor.ts +1 -0
  92. package/corpus/core/src/cli/code-agent-runs.ts +14 -0
  93. package/corpus/core/src/cli/doctor.ts +396 -0
  94. package/corpus/core/src/cli/index.ts +56 -0
  95. package/corpus/core/src/cli/info.ts +3 -3
  96. package/corpus/core/src/cli/package-lifecycle.ts +821 -0
  97. package/corpus/core/src/client/AgentPanel.tsx +32 -25
  98. package/corpus/core/src/client/AssistantChat.tsx +36 -20
  99. package/corpus/core/src/client/MultiTabAssistantChat.tsx +141 -90
  100. package/corpus/core/src/client/agent-chat-adapter.ts +9 -9
  101. package/corpus/core/src/client/chat/ChatHistoryList.tsx +404 -0
  102. package/corpus/core/src/client/chat/index.ts +6 -0
  103. package/corpus/core/src/client/chat/tool-call-display.tsx +37 -3
  104. package/corpus/core/src/client/code-agent-chat-adapter.ts +72 -4
  105. package/corpus/core/src/client/composer/RealtimeVoiceMode.tsx +52 -11
  106. package/corpus/core/src/client/composer/TiptapComposer.tsx +157 -20
  107. package/corpus/core/src/client/composer/VoiceButton.tsx +28 -0
  108. package/corpus/core/src/client/composer/useRealtimeVoiceMode.tsx +5 -0
  109. package/corpus/core/src/client/conversation/code-agent-transcript.ts +4 -5
  110. package/corpus/core/src/client/guided-questions.tsx +2 -1
  111. package/corpus/core/src/client/index.ts +11 -0
  112. package/corpus/core/src/client/use-chat-threads.ts +10 -1
  113. package/corpus/core/src/client/voice-provider-status.ts +44 -0
  114. package/corpus/core/src/code-agents/transcript-normalizer.ts +76 -0
  115. package/corpus/core/src/deploy/build.ts +12 -11
  116. package/corpus/core/src/guards/db-tool-scoping.ts +129 -0
  117. package/corpus/core/src/guards/index.ts +23 -0
  118. package/corpus/core/src/guards/no-drizzle-push.ts +116 -0
  119. package/corpus/core/src/guards/no-env-credentials.ts +229 -0
  120. package/corpus/core/src/guards/no-env-mutation.ts +114 -0
  121. package/corpus/core/src/guards/no-localhost-fallback.ts +124 -0
  122. package/corpus/core/src/guards/no-unscoped-credentials.ts +227 -0
  123. package/corpus/core/src/guards/no-unscoped-queries.ts +834 -0
  124. package/corpus/core/src/guards/scan-utils.ts +105 -0
  125. package/corpus/core/src/guards/types.ts +30 -0
  126. package/corpus/core/src/integrations/a2a-continuation-processor.ts +35 -5
  127. package/corpus/core/src/integrations/adapters/slack.ts +74 -21
  128. package/corpus/core/src/integrations/webhook-handler.ts +14 -0
  129. package/corpus/core/src/localization/default-messages.ts +6 -0
  130. package/corpus/core/src/observability/hosted-model-experiment.ts +118 -0
  131. package/corpus/core/src/observability/routes.ts +17 -0
  132. package/corpus/core/src/observability/store.ts +4 -1
  133. package/corpus/core/src/observability/traces.ts +41 -2
  134. package/corpus/core/src/org/accept-pending.ts +9 -1
  135. package/corpus/core/src/org/migrations.ts +41 -0
  136. package/corpus/core/src/package-lifecycle/index.ts +1 -0
  137. package/corpus/core/src/package-lifecycle/manifest.ts +120 -0
  138. package/corpus/core/src/provider-api/custom-registry.ts +56 -0
  139. package/corpus/core/src/provider-api/index.ts +2 -0
  140. package/corpus/core/src/scripts/agent-engines/list-agent-engines.ts +19 -1
  141. package/corpus/core/src/scripts/call-agent.ts +53 -3
  142. package/corpus/core/src/scripts/chat/search-chats.ts +11 -8
  143. package/corpus/core/src/secrets/register-framework-secrets.ts +1 -1
  144. package/corpus/core/src/secrets/storage.ts +47 -27
  145. package/corpus/core/src/server/action-discovery.ts +4 -0
  146. package/corpus/core/src/server/agent-chat-plugin.ts +95 -18
  147. package/corpus/core/src/server/core-routes-plugin.ts +45 -14
  148. package/corpus/core/src/server/csrf.ts +24 -5
  149. package/corpus/core/src/server/framework-request-handler.ts +34 -0
  150. package/corpus/core/src/server/google-realtime-session.ts +1 -36
  151. package/corpus/core/src/server/poll.ts +24 -2
  152. package/corpus/core/src/server/realtime-voice.ts +80 -24
  153. package/corpus/core/src/server/request-origin.ts +63 -0
  154. package/corpus/core/src/server/transcribe-voice.ts +1 -50
  155. package/corpus/core/src/server/voice-providers-status.ts +4 -3
  156. package/corpus/core/src/shared/cache-control.ts +2 -8
  157. package/corpus/core/src/styles/agent-native.css +1 -0
  158. package/corpus/core/src/styles/chat-history-list.css +313 -0
  159. package/corpus/core/src/templates/default/package.json +2 -2
  160. package/corpus/core/src/templates/headless/package.json +0 -1
  161. package/corpus/core/src/templates/workspace-core/.agents/skills/audit-log/SKILL.md +3 -0
  162. package/corpus/core/src/templates/workspace-core/.agents/skills/automations/SKILL.md +1 -1
  163. package/corpus/core/src/templates/workspace-core/.agents/skills/observability/SKILL.md +20 -0
  164. package/corpus/core/src/templates/workspace-core/.agents/skills/voice-transcription/SKILL.md +8 -4
  165. package/corpus/core/src/templates/workspace-core/package.json +0 -1
  166. package/corpus/core/src/templates/workspace-root/package.json +0 -1
  167. package/corpus/core/src/triggers/actions.ts +11 -3
  168. package/corpus/core/src/triggers/types.ts +7 -1
  169. package/corpus/core/src/vite/client.ts +1 -0
  170. package/corpus/templates/analytics/AGENTS.md +7 -0
  171. package/corpus/templates/analytics/actions/bigquery.ts +26 -2
  172. package/corpus/templates/analytics/actions/compose-dashboard.ts +65 -37
  173. package/corpus/templates/analytics/actions/data-source-status.ts +18 -0
  174. package/corpus/templates/analytics/actions/mutate-dashboard.ts +73 -24
  175. package/corpus/templates/analytics/actions/reorder-dashboard-panels.ts +16 -13
  176. package/corpus/templates/analytics/actions/update-dashboard.ts +53 -42
  177. package/corpus/templates/analytics/app/components/layout/Sidebar.tsx +5 -4
  178. package/corpus/templates/analytics/app/global.css +10 -0
  179. package/corpus/templates/analytics/app/pages/Ask.tsx +25 -2
  180. package/corpus/templates/analytics/changelog/2026-07-10-analytics-answers-simple-time-bounded-metrics-without-unnece.md +6 -0
  181. package/corpus/templates/analytics/changelog/2026-07-10-analytics-chat-reliably-uses-connected-data-sources-across-s.md +6 -0
  182. package/corpus/templates/analytics/changelog/2026-07-10-chat-threads-now-stay-clear-of-top-actions-and-fade-smoothly.md +6 -0
  183. package/corpus/templates/analytics/changelog/2026-07-10-context-chips-can-now-be-selected-and-removed-one-at-a-time-.md +6 -0
  184. package/corpus/templates/analytics/changelog/2026-07-10-dashboard-edits-from-the-agent-and-the-ui-at-the-same-time-n.md +6 -0
  185. package/corpus/templates/analytics/changelog/2026-07-10-the-ask-composer-no-longer-carries-dashboard-or-panel-contex.md +6 -0
  186. package/corpus/templates/analytics/changelog/2026-07-10-the-ask-section-stays-highlighted-while-its-chat-history-is-.md +6 -0
  187. package/corpus/templates/analytics/changelog/2026-07-10-timed-out-bigquery-jobs-are-now-cancelled-so-they-stop-consu.md +6 -0
  188. package/corpus/templates/analytics/package.json +1 -2
  189. package/corpus/templates/analytics/server/lib/bigquery.ts +91 -14
  190. package/corpus/templates/analytics/server/lib/dashboards-store.ts +154 -11
  191. package/corpus/templates/analytics/server/plugins/agent-chat.ts +82 -7
  192. package/corpus/templates/assets/package.json +1 -2
  193. package/corpus/templates/brain/package.json +1 -2
  194. package/corpus/templates/calendar/package.json +1 -2
  195. package/corpus/templates/chat/package.json +1 -2
  196. package/corpus/templates/clips/changelog/2026-07-10-atomic-view-tracking.md +6 -0
  197. package/corpus/templates/clips/chrome-extension/package.json +3 -2
  198. package/corpus/templates/clips/desktop/package.json +6 -4
  199. package/corpus/templates/clips/desktop/src/lib/recorder.ts +26 -13
  200. package/corpus/templates/clips/desktop/src/lib/voice-dictation.ts +4 -1
  201. package/corpus/templates/clips/package.json +1 -2
  202. package/corpus/templates/clips/server/db/schema.ts +29 -17
  203. package/corpus/templates/clips/server/plugins/db.ts +8 -0
  204. package/corpus/templates/clips/server/routes/api/view-event.post.ts +260 -105
  205. package/corpus/templates/content/.agents/skills/notion-integration/SKILL.md +16 -0
  206. package/corpus/templates/content/AGENTS.md +72 -62
  207. package/corpus/templates/content/actions/_content-database-source-adapters.ts +84 -0
  208. package/corpus/templates/content/actions/_database-source-utils.ts +206 -96
  209. package/corpus/templates/content/actions/_notion-database-source-adapter.ts +216 -0
  210. package/corpus/templates/content/actions/_position-utils.ts +76 -0
  211. package/corpus/templates/content/actions/_property-utils.ts +31 -20
  212. package/corpus/templates/content/actions/add-database-item.ts +52 -39
  213. package/corpus/templates/content/actions/attach-content-database-source.ts +95 -11
  214. package/corpus/templates/content/actions/change-content-database-source-role.ts +24 -1
  215. package/corpus/templates/content/actions/configure-document-property.ts +36 -27
  216. package/corpus/templates/content/actions/create-content-database.ts +40 -30
  217. package/corpus/templates/content/actions/create-document.ts +39 -32
  218. package/corpus/templates/content/actions/duplicate-document-property.ts +37 -28
  219. package/corpus/templates/content/actions/list-notion-database-sources.ts +80 -0
  220. package/corpus/templates/content/actions/move-document.ts +64 -48
  221. package/corpus/templates/content/actions/refresh-content-database-source.ts +42 -3
  222. package/corpus/templates/content/actions/share-local-file-document.ts +36 -27
  223. package/corpus/templates/content/actions/suggest-source-join-key.ts +39 -16
  224. package/corpus/templates/content/app/components/editor/database/DatabaseView.tsx +89 -23
  225. package/corpus/templates/content/app/components/editor/database/settings.tsx +1 -1
  226. package/corpus/templates/content/app/hooks/use-content-database.ts +18 -1
  227. package/corpus/templates/content/app/i18n/zh-TW.ts +4 -0
  228. package/corpus/templates/content/app/i18n-data.ts +40 -0
  229. package/corpus/templates/content/changelog/2026-07-10-failed-row-creation-and-source-attach-now-show-an-error-inst.md +6 -0
  230. package/corpus/templates/content/changelog/2026-07-10-items-added-at-the-same-time-no-longer-end-up-with-identical.md +6 -0
  231. package/corpus/templates/content/changelog/2026-07-10-notion-databases-can-add-read-only-details-to-content-tables.md +6 -0
  232. package/corpus/templates/content/package.json +1 -2
  233. package/corpus/templates/content/parity/matrix.md +25 -25
  234. package/corpus/templates/content/parity/matrix.ts +1 -0
  235. package/corpus/templates/content/server/routes/api/documents/[id]/move.patch.ts +43 -26
  236. package/corpus/templates/content/shared/api.ts +16 -1
  237. package/corpus/templates/design/.agents/skills/visual-edit/SKILL.md +8 -4
  238. package/corpus/templates/design/AGENTS.md +12 -2
  239. package/corpus/templates/design/DEVELOPING.md +10 -6
  240. package/corpus/templates/design/actions/apply-visual-edit.ts +191 -6
  241. package/corpus/templates/design/actions/duplicate-design.ts +31 -25
  242. package/corpus/templates/design/app/pages/design-editor/pending-edits.ts +5 -1
  243. package/corpus/templates/design/changelog/2026-07-10-duplicating-a-design-can-no-longer-produce-a-copy-with-missi.md +6 -0
  244. package/corpus/templates/design/changelog/2026-07-10-local-visual-edits-can-now-save-safe-leaf-text-class-and.md +6 -0
  245. package/corpus/templates/design/package.json +1 -1
  246. package/corpus/templates/design/shared/local-jsx-visual-edit.ts +388 -0
  247. package/corpus/templates/dispatch/package.json +1 -2
  248. package/corpus/templates/forms/actions/patch-form-fields.ts +82 -44
  249. package/corpus/templates/forms/changelog/2026-07-10-simultaneous-edits-to-different-form-fields-no-longer-overwr.md +6 -0
  250. package/corpus/templates/forms/package.json +1 -2
  251. package/corpus/templates/macros/package.json +1 -2
  252. package/corpus/templates/mail/app/components/email/EmailThread.tsx +3 -1
  253. package/corpus/templates/mail/changelog/2026-07-10-fixed-calendar-rsvp-buttons-in-emails-firing-duplicate-respo.md +6 -0
  254. package/corpus/templates/mail/package.json +1 -2
  255. package/corpus/templates/plan/actions/restore-plan-version.ts +126 -96
  256. package/corpus/templates/plan/changelog/2026-07-10-restoring-a-plan-version-can-no-longer-leave-a-plan-half-res.md +6 -0
  257. package/corpus/templates/plan/package.json +1 -2
  258. package/corpus/templates/plan/server/plans.ts +9 -2
  259. package/corpus/templates/slides/actions/list-decks.ts +28 -0
  260. package/corpus/templates/slides/app/components/deck/MermaidRenderer.tsx +41 -26
  261. package/corpus/templates/slides/app/components/design-system/DesignSystemSetup.tsx +4 -8
  262. package/corpus/templates/slides/app/components/editor/EditorSidebar.tsx +2 -4
  263. package/corpus/templates/slides/app/components/editor/EditorToolbar.tsx +4 -8
  264. package/corpus/templates/slides/app/components/editor/ExportMenu.tsx +5 -12
  265. package/corpus/templates/slides/app/components/editor/HistoryPanel.tsx +3 -6
  266. package/corpus/templates/slides/app/components/editor/ImageDropPromptPopover.tsx +3 -6
  267. package/corpus/templates/slides/app/components/editor/PromptDialog.tsx +2 -5
  268. package/corpus/templates/slides/app/context/DeckContext.tsx +47 -4
  269. package/corpus/templates/slides/app/pages/DeckEditor.tsx +11 -30
  270. package/corpus/templates/slides/app/pages/Index.tsx +2 -3
  271. package/corpus/templates/slides/app/root.tsx +0 -5
  272. package/corpus/templates/slides/changelog/2026-07-10-deck-lists-load-much-faster-and-no-longer-re-download-slide-.md +6 -0
  273. package/corpus/templates/slides/package.json +1 -2
  274. package/dist/a2a/auth-policy.d.ts +19 -0
  275. package/dist/a2a/auth-policy.d.ts.map +1 -1
  276. package/dist/a2a/auth-policy.js +32 -0
  277. package/dist/a2a/auth-policy.js.map +1 -1
  278. package/dist/a2a/client.d.ts +7 -0
  279. package/dist/a2a/client.d.ts.map +1 -1
  280. package/dist/a2a/client.js +2 -1
  281. package/dist/a2a/client.js.map +1 -1
  282. package/dist/agent/durable-background.d.ts +8 -5
  283. package/dist/agent/durable-background.d.ts.map +1 -1
  284. package/dist/agent/durable-background.js +15 -8
  285. package/dist/agent/durable-background.js.map +1 -1
  286. package/dist/agent/production-agent.d.ts +6 -0
  287. package/dist/agent/production-agent.d.ts.map +1 -1
  288. package/dist/agent/production-agent.js +63 -26
  289. package/dist/agent/production-agent.js.map +1 -1
  290. package/dist/agent/run-store.d.ts.map +1 -1
  291. package/dist/agent/run-store.js +9 -4
  292. package/dist/agent/run-store.js.map +1 -1
  293. package/dist/agent/thread-data-builder.d.ts +1 -0
  294. package/dist/agent/thread-data-builder.d.ts.map +1 -1
  295. package/dist/agent/thread-data-builder.js +6 -5
  296. package/dist/agent/thread-data-builder.js.map +1 -1
  297. package/dist/audit/actions/export-audit-events.d.ts +27 -0
  298. package/dist/audit/actions/export-audit-events.d.ts.map +1 -0
  299. package/dist/audit/actions/export-audit-events.js +144 -0
  300. package/dist/audit/actions/export-audit-events.js.map +1 -0
  301. package/dist/audit/store.d.ts +1 -0
  302. package/dist/audit/store.d.ts.map +1 -1
  303. package/dist/audit/store.js +8 -3
  304. package/dist/audit/store.js.map +1 -1
  305. package/dist/audit/types.d.ts +3 -0
  306. package/dist/audit/types.d.ts.map +1 -1
  307. package/dist/audit/types.js.map +1 -1
  308. package/dist/chat-threads/store.d.ts +10 -0
  309. package/dist/chat-threads/store.d.ts.map +1 -1
  310. package/dist/chat-threads/store.js +6 -0
  311. package/dist/chat-threads/store.js.map +1 -1
  312. package/dist/cli/code-agent-executor.d.ts.map +1 -1
  313. package/dist/cli/code-agent-executor.js +1 -0
  314. package/dist/cli/code-agent-executor.js.map +1 -1
  315. package/dist/cli/code-agent-runs.d.ts +12 -0
  316. package/dist/cli/code-agent-runs.d.ts.map +1 -1
  317. package/dist/cli/code-agent-runs.js +1 -0
  318. package/dist/cli/code-agent-runs.js.map +1 -1
  319. package/dist/cli/doctor.d.ts +83 -0
  320. package/dist/cli/doctor.d.ts.map +1 -0
  321. package/dist/cli/doctor.js +277 -0
  322. package/dist/cli/doctor.js.map +1 -0
  323. package/dist/cli/index.js +50 -0
  324. package/dist/cli/index.js.map +1 -1
  325. package/dist/cli/info.js +3 -3
  326. package/dist/cli/info.js.map +1 -1
  327. package/dist/cli/package-lifecycle.d.ts +50 -0
  328. package/dist/cli/package-lifecycle.d.ts.map +1 -0
  329. package/dist/cli/package-lifecycle.js +560 -0
  330. package/dist/cli/package-lifecycle.js.map +1 -0
  331. package/dist/client/AgentPanel.d.ts.map +1 -1
  332. package/dist/client/AgentPanel.js +3 -3
  333. package/dist/client/AgentPanel.js.map +1 -1
  334. package/dist/client/AssistantChat.d.ts +11 -0
  335. package/dist/client/AssistantChat.d.ts.map +1 -1
  336. package/dist/client/AssistantChat.js +7 -4
  337. package/dist/client/AssistantChat.js.map +1 -1
  338. package/dist/client/MultiTabAssistantChat.d.ts.map +1 -1
  339. package/dist/client/MultiTabAssistantChat.js +83 -10
  340. package/dist/client/MultiTabAssistantChat.js.map +1 -1
  341. package/dist/client/agent-chat-adapter.js +7 -3
  342. package/dist/client/agent-chat-adapter.js.map +1 -1
  343. package/dist/client/chat/ChatHistoryList.d.ts +88 -0
  344. package/dist/client/chat/ChatHistoryList.d.ts.map +1 -0
  345. package/dist/client/chat/ChatHistoryList.js +83 -0
  346. package/dist/client/chat/ChatHistoryList.js.map +1 -0
  347. package/dist/client/chat/index.d.ts +1 -0
  348. package/dist/client/chat/index.d.ts.map +1 -1
  349. package/dist/client/chat/index.js +1 -0
  350. package/dist/client/chat/index.js.map +1 -1
  351. package/dist/client/chat/tool-call-display.d.ts +13 -1
  352. package/dist/client/chat/tool-call-display.d.ts.map +1 -1
  353. package/dist/client/chat/tool-call-display.js +10 -2
  354. package/dist/client/chat/tool-call-display.js.map +1 -1
  355. package/dist/client/code-agent-chat-adapter.d.ts +17 -1
  356. package/dist/client/code-agent-chat-adapter.d.ts.map +1 -1
  357. package/dist/client/code-agent-chat-adapter.js +47 -3
  358. package/dist/client/code-agent-chat-adapter.js.map +1 -1
  359. package/dist/client/composer/RealtimeVoiceMode.d.ts +11 -1
  360. package/dist/client/composer/RealtimeVoiceMode.d.ts.map +1 -1
  361. package/dist/client/composer/RealtimeVoiceMode.js +5 -3
  362. package/dist/client/composer/RealtimeVoiceMode.js.map +1 -1
  363. package/dist/client/composer/TiptapComposer.d.ts +25 -2
  364. package/dist/client/composer/TiptapComposer.d.ts.map +1 -1
  365. package/dist/client/composer/TiptapComposer.js +96 -5
  366. package/dist/client/composer/TiptapComposer.js.map +1 -1
  367. package/dist/client/composer/VoiceButton.d.ts.map +1 -1
  368. package/dist/client/composer/VoiceButton.js +21 -1
  369. package/dist/client/composer/VoiceButton.js.map +1 -1
  370. package/dist/client/composer/useRealtimeVoiceMode.d.ts.map +1 -1
  371. package/dist/client/composer/useRealtimeVoiceMode.js +5 -0
  372. package/dist/client/composer/useRealtimeVoiceMode.js.map +1 -1
  373. package/dist/client/conversation/code-agent-transcript.d.ts +2 -0
  374. package/dist/client/conversation/code-agent-transcript.d.ts.map +1 -1
  375. package/dist/client/conversation/code-agent-transcript.js +3 -5
  376. package/dist/client/conversation/code-agent-transcript.js.map +1 -1
  377. package/dist/client/guided-questions.d.ts.map +1 -1
  378. package/dist/client/guided-questions.js +2 -1
  379. package/dist/client/guided-questions.js.map +1 -1
  380. package/dist/client/index.d.ts +3 -1
  381. package/dist/client/index.d.ts.map +1 -1
  382. package/dist/client/index.js +3 -1
  383. package/dist/client/index.js.map +1 -1
  384. package/dist/client/use-chat-threads.d.ts.map +1 -1
  385. package/dist/client/use-chat-threads.js +9 -1
  386. package/dist/client/use-chat-threads.js.map +1 -1
  387. package/dist/client/voice-provider-status.d.ts +10 -0
  388. package/dist/client/voice-provider-status.d.ts.map +1 -0
  389. package/dist/client/voice-provider-status.js +32 -0
  390. package/dist/client/voice-provider-status.js.map +1 -0
  391. package/dist/code-agents/transcript-normalizer.d.ts +29 -0
  392. package/dist/code-agents/transcript-normalizer.d.ts.map +1 -1
  393. package/dist/code-agents/transcript-normalizer.js +55 -0
  394. package/dist/code-agents/transcript-normalizer.js.map +1 -1
  395. package/dist/collab/routes.d.ts +1 -1
  396. package/dist/deploy/build.d.ts.map +1 -1
  397. package/dist/deploy/build.js +13 -11
  398. package/dist/deploy/build.js.map +1 -1
  399. package/dist/guards/db-tool-scoping.d.ts +38 -0
  400. package/dist/guards/db-tool-scoping.d.ts.map +1 -0
  401. package/dist/guards/db-tool-scoping.js +114 -0
  402. package/dist/guards/db-tool-scoping.js.map +1 -0
  403. package/dist/guards/index.d.ts +23 -0
  404. package/dist/guards/index.d.ts.map +1 -0
  405. package/dist/guards/index.js +19 -0
  406. package/dist/guards/index.js.map +1 -0
  407. package/dist/guards/no-drizzle-push.d.ts +14 -0
  408. package/dist/guards/no-drizzle-push.d.ts.map +1 -0
  409. package/dist/guards/no-drizzle-push.js +97 -0
  410. package/dist/guards/no-drizzle-push.js.map +1 -0
  411. package/dist/guards/no-env-credentials.d.ts +36 -0
  412. package/dist/guards/no-env-credentials.d.ts.map +1 -0
  413. package/dist/guards/no-env-credentials.js +204 -0
  414. package/dist/guards/no-env-credentials.js.map +1 -0
  415. package/dist/guards/no-env-mutation.d.ts +23 -0
  416. package/dist/guards/no-env-mutation.d.ts.map +1 -0
  417. package/dist/guards/no-env-mutation.js +90 -0
  418. package/dist/guards/no-env-mutation.js.map +1 -0
  419. package/dist/guards/no-localhost-fallback.d.ts +30 -0
  420. package/dist/guards/no-localhost-fallback.d.ts.map +1 -0
  421. package/dist/guards/no-localhost-fallback.js +105 -0
  422. package/dist/guards/no-localhost-fallback.js.map +1 -0
  423. package/dist/guards/no-unscoped-credentials.d.ts +28 -0
  424. package/dist/guards/no-unscoped-credentials.d.ts.map +1 -0
  425. package/dist/guards/no-unscoped-credentials.js +199 -0
  426. package/dist/guards/no-unscoped-credentials.js.map +1 -0
  427. package/dist/guards/no-unscoped-queries.d.ts +32 -0
  428. package/dist/guards/no-unscoped-queries.d.ts.map +1 -0
  429. package/dist/guards/no-unscoped-queries.js +720 -0
  430. package/dist/guards/no-unscoped-queries.js.map +1 -0
  431. package/dist/guards/scan-utils.d.ts +28 -0
  432. package/dist/guards/scan-utils.d.ts.map +1 -0
  433. package/dist/guards/scan-utils.js +92 -0
  434. package/dist/guards/scan-utils.js.map +1 -0
  435. package/dist/guards/types.d.ts +28 -0
  436. package/dist/guards/types.d.ts.map +1 -0
  437. package/dist/guards/types.js +11 -0
  438. package/dist/guards/types.js.map +1 -0
  439. package/dist/integrations/a2a-continuation-processor.d.ts.map +1 -1
  440. package/dist/integrations/a2a-continuation-processor.js +25 -5
  441. package/dist/integrations/a2a-continuation-processor.js.map +1 -1
  442. package/dist/integrations/adapters/slack.d.ts.map +1 -1
  443. package/dist/integrations/adapters/slack.js +55 -21
  444. package/dist/integrations/adapters/slack.js.map +1 -1
  445. package/dist/integrations/webhook-handler.d.ts.map +1 -1
  446. package/dist/integrations/webhook-handler.js +11 -0
  447. package/dist/integrations/webhook-handler.js.map +1 -1
  448. package/dist/localization/default-messages.d.ts +5 -0
  449. package/dist/localization/default-messages.d.ts.map +1 -1
  450. package/dist/localization/default-messages.js +5 -0
  451. package/dist/localization/default-messages.js.map +1 -1
  452. package/dist/notifications/routes.d.ts +2 -2
  453. package/dist/observability/hosted-model-experiment.d.ts +39 -0
  454. package/dist/observability/hosted-model-experiment.d.ts.map +1 -0
  455. package/dist/observability/hosted-model-experiment.js +90 -0
  456. package/dist/observability/hosted-model-experiment.js.map +1 -0
  457. package/dist/observability/routes.d.ts +1 -1
  458. package/dist/observability/routes.d.ts.map +1 -1
  459. package/dist/observability/routes.js +16 -0
  460. package/dist/observability/routes.js.map +1 -1
  461. package/dist/observability/store.d.ts.map +1 -1
  462. package/dist/observability/store.js +4 -1
  463. package/dist/observability/store.js.map +1 -1
  464. package/dist/observability/traces.d.ts +6 -0
  465. package/dist/observability/traces.d.ts.map +1 -1
  466. package/dist/observability/traces.js +28 -2
  467. package/dist/observability/traces.js.map +1 -1
  468. package/dist/org/accept-pending.d.ts.map +1 -1
  469. package/dist/org/accept-pending.js +9 -1
  470. package/dist/org/accept-pending.js.map +1 -1
  471. package/dist/org/migrations.d.ts +7 -2
  472. package/dist/org/migrations.d.ts.map +1 -1
  473. package/dist/org/migrations.js +41 -0
  474. package/dist/org/migrations.js.map +1 -1
  475. package/dist/package-lifecycle/index.d.ts +2 -0
  476. package/dist/package-lifecycle/index.d.ts.map +1 -0
  477. package/dist/package-lifecycle/index.js +2 -0
  478. package/dist/package-lifecycle/index.js.map +1 -0
  479. package/dist/package-lifecycle/manifest.d.ts +24 -0
  480. package/dist/package-lifecycle/manifest.d.ts.map +1 -0
  481. package/dist/package-lifecycle/manifest.js +81 -0
  482. package/dist/package-lifecycle/manifest.js.map +1 -0
  483. package/dist/progress/routes.d.ts +1 -1
  484. package/dist/provider-api/custom-registry.d.ts +32 -1
  485. package/dist/provider-api/custom-registry.d.ts.map +1 -1
  486. package/dist/provider-api/custom-registry.js +41 -1
  487. package/dist/provider-api/custom-registry.js.map +1 -1
  488. package/dist/provider-api/index.d.ts +1 -1
  489. package/dist/provider-api/index.d.ts.map +1 -1
  490. package/dist/provider-api/index.js +1 -1
  491. package/dist/provider-api/index.js.map +1 -1
  492. package/dist/resources/handlers.d.ts +1 -1
  493. package/dist/scripts/agent-engines/list-agent-engines.d.ts.map +1 -1
  494. package/dist/scripts/agent-engines/list-agent-engines.js +19 -1
  495. package/dist/scripts/agent-engines/list-agent-engines.js.map +1 -1
  496. package/dist/scripts/call-agent.d.ts.map +1 -1
  497. package/dist/scripts/call-agent.js +43 -3
  498. package/dist/scripts/call-agent.js.map +1 -1
  499. package/dist/scripts/chat/search-chats.d.ts +1 -1
  500. package/dist/scripts/chat/search-chats.d.ts.map +1 -1
  501. package/dist/scripts/chat/search-chats.js +11 -8
  502. package/dist/scripts/chat/search-chats.js.map +1 -1
  503. package/dist/secrets/register-framework-secrets.js +1 -1
  504. package/dist/secrets/register-framework-secrets.js.map +1 -1
  505. package/dist/secrets/storage.d.ts.map +1 -1
  506. package/dist/secrets/storage.js +45 -27
  507. package/dist/secrets/storage.js.map +1 -1
  508. package/dist/server/action-discovery.d.ts.map +1 -1
  509. package/dist/server/action-discovery.js +4 -0
  510. package/dist/server/action-discovery.js.map +1 -1
  511. package/dist/server/agent-chat-plugin.d.ts +11 -0
  512. package/dist/server/agent-chat-plugin.d.ts.map +1 -1
  513. package/dist/server/agent-chat-plugin.js +74 -19
  514. package/dist/server/agent-chat-plugin.js.map +1 -1
  515. package/dist/server/agent-engine-api-key-route.d.ts +1 -1
  516. package/dist/server/core-routes-plugin.d.ts +3 -0
  517. package/dist/server/core-routes-plugin.d.ts.map +1 -1
  518. package/dist/server/core-routes-plugin.js +36 -12
  519. package/dist/server/core-routes-plugin.js.map +1 -1
  520. package/dist/server/csrf.d.ts.map +1 -1
  521. package/dist/server/csrf.js +18 -5
  522. package/dist/server/csrf.js.map +1 -1
  523. package/dist/server/framework-request-handler.d.ts.map +1 -1
  524. package/dist/server/framework-request-handler.js +34 -0
  525. package/dist/server/framework-request-handler.js.map +1 -1
  526. package/dist/server/google-realtime-session.d.ts.map +1 -1
  527. package/dist/server/google-realtime-session.js +2 -34
  528. package/dist/server/google-realtime-session.js.map +1 -1
  529. package/dist/server/poll.d.ts.map +1 -1
  530. package/dist/server/poll.js +24 -2
  531. package/dist/server/poll.js.map +1 -1
  532. package/dist/server/realtime-voice.d.ts.map +1 -1
  533. package/dist/server/realtime-voice.js +64 -21
  534. package/dist/server/realtime-voice.js.map +1 -1
  535. package/dist/server/request-origin.d.ts +10 -0
  536. package/dist/server/request-origin.d.ts.map +1 -0
  537. package/dist/server/request-origin.js +60 -0
  538. package/dist/server/request-origin.js.map +1 -0
  539. package/dist/server/transcribe-voice.d.ts.map +1 -1
  540. package/dist/server/transcribe-voice.js +2 -48
  541. package/dist/server/transcribe-voice.js.map +1 -1
  542. package/dist/server/voice-providers-status.d.ts.map +1 -1
  543. package/dist/server/voice-providers-status.js +2 -3
  544. package/dist/server/voice-providers-status.js.map +1 -1
  545. package/dist/shared/cache-control.d.ts +4 -6
  546. package/dist/shared/cache-control.d.ts.map +1 -1
  547. package/dist/shared/cache-control.js +2 -7
  548. package/dist/shared/cache-control.js.map +1 -1
  549. package/dist/styles/agent-native.css +1 -0
  550. package/dist/styles/chat-history-list.css +313 -0
  551. package/dist/templates/default/package.json +2 -2
  552. package/dist/templates/headless/package.json +0 -1
  553. package/dist/templates/workspace-core/.agents/skills/audit-log/SKILL.md +3 -0
  554. package/dist/templates/workspace-core/.agents/skills/automations/SKILL.md +1 -1
  555. package/dist/templates/workspace-core/.agents/skills/observability/SKILL.md +20 -0
  556. package/dist/templates/workspace-core/.agents/skills/voice-transcription/SKILL.md +8 -4
  557. package/dist/templates/workspace-core/package.json +0 -1
  558. package/dist/templates/workspace-root/package.json +0 -1
  559. package/dist/triggers/actions.d.ts.map +1 -1
  560. package/dist/triggers/actions.js +8 -3
  561. package/dist/triggers/actions.js.map +1 -1
  562. package/dist/triggers/types.d.ts +7 -1
  563. package/dist/triggers/types.d.ts.map +1 -1
  564. package/dist/triggers/types.js.map +1 -1
  565. package/dist/vite/client.d.ts.map +1 -1
  566. package/dist/vite/client.js +1 -0
  567. package/dist/vite/client.js.map +1 -1
  568. package/docs/content/audit-log.mdx +2 -1
  569. package/docs/content/automations.mdx +7 -7
  570. package/docs/content/creating-templates.mdx +1 -1
  571. package/docs/content/internationalization.mdx +2 -1
  572. package/docs/content/locales/ar-SA/audit-log.mdx +2 -1
  573. package/docs/content/locales/ar-SA/automations.mdx +7 -7
  574. package/docs/content/locales/ar-SA/getting-started.mdx +7 -1
  575. package/docs/content/locales/ar-SA/internationalization.mdx +1 -1
  576. package/docs/content/locales/ar-SA/package-lifecycle.mdx +19 -0
  577. package/docs/content/locales/ar-SA/sandbox-adapters.mdx +18 -7
  578. package/docs/content/locales/ar-SA/security.mdx +8 -0
  579. package/docs/content/locales/de-DE/audit-log.mdx +2 -1
  580. package/docs/content/locales/de-DE/automations.mdx +7 -7
  581. package/docs/content/locales/de-DE/getting-started.mdx +7 -1
  582. package/docs/content/locales/de-DE/internationalization.mdx +1 -1
  583. package/docs/content/locales/de-DE/package-lifecycle.mdx +22 -0
  584. package/docs/content/locales/de-DE/sandbox-adapters.mdx +18 -7
  585. package/docs/content/locales/de-DE/security.mdx +8 -0
  586. package/docs/content/locales/es-ES/audit-log.mdx +2 -1
  587. package/docs/content/locales/es-ES/automations.mdx +7 -7
  588. package/docs/content/locales/es-ES/getting-started.mdx +7 -1
  589. package/docs/content/locales/es-ES/internationalization.mdx +1 -1
  590. package/docs/content/locales/es-ES/package-lifecycle.mdx +22 -0
  591. package/docs/content/locales/es-ES/sandbox-adapters.mdx +18 -7
  592. package/docs/content/locales/es-ES/security.mdx +8 -0
  593. package/docs/content/locales/fr-FR/audit-log.mdx +2 -1
  594. package/docs/content/locales/fr-FR/automations.mdx +7 -7
  595. package/docs/content/locales/fr-FR/getting-started.mdx +7 -1
  596. package/docs/content/locales/fr-FR/internationalization.mdx +1 -1
  597. package/docs/content/locales/fr-FR/package-lifecycle.mdx +21 -0
  598. package/docs/content/locales/fr-FR/sandbox-adapters.mdx +19 -8
  599. package/docs/content/locales/fr-FR/security.mdx +8 -0
  600. package/docs/content/locales/hi-IN/audit-log.mdx +2 -1
  601. package/docs/content/locales/hi-IN/automations.mdx +7 -7
  602. package/docs/content/locales/hi-IN/getting-started.mdx +7 -1
  603. package/docs/content/locales/hi-IN/internationalization.mdx +1 -1
  604. package/docs/content/locales/hi-IN/package-lifecycle.mdx +20 -0
  605. package/docs/content/locales/hi-IN/sandbox-adapters.mdx +18 -7
  606. package/docs/content/locales/hi-IN/security.mdx +8 -0
  607. package/docs/content/locales/ja-JP/audit-log.mdx +2 -1
  608. package/docs/content/locales/ja-JP/automations.mdx +7 -7
  609. package/docs/content/locales/ja-JP/getting-started.mdx +7 -1
  610. package/docs/content/locales/ja-JP/internationalization.mdx +1 -1
  611. package/docs/content/locales/ja-JP/package-lifecycle.mdx +21 -0
  612. package/docs/content/locales/ja-JP/sandbox-adapters.mdx +17 -6
  613. package/docs/content/locales/ja-JP/security.mdx +8 -0
  614. package/docs/content/locales/ko-KR/audit-log.mdx +2 -1
  615. package/docs/content/locales/ko-KR/automations.mdx +7 -7
  616. package/docs/content/locales/ko-KR/getting-started.mdx +7 -1
  617. package/docs/content/locales/ko-KR/internationalization.mdx +1 -1
  618. package/docs/content/locales/ko-KR/package-lifecycle.mdx +20 -0
  619. package/docs/content/locales/ko-KR/sandbox-adapters.mdx +17 -6
  620. package/docs/content/locales/ko-KR/security.mdx +8 -0
  621. package/docs/content/locales/pt-BR/audit-log.mdx +2 -1
  622. package/docs/content/locales/pt-BR/automations.mdx +7 -7
  623. package/docs/content/locales/pt-BR/getting-started.mdx +7 -1
  624. package/docs/content/locales/pt-BR/internationalization.mdx +1 -1
  625. package/docs/content/locales/pt-BR/package-lifecycle.mdx +21 -0
  626. package/docs/content/locales/pt-BR/sandbox-adapters.mdx +18 -7
  627. package/docs/content/locales/pt-BR/security.mdx +8 -0
  628. package/docs/content/locales/zh-CN/audit-log.mdx +2 -1
  629. package/docs/content/locales/zh-CN/automations.mdx +7 -7
  630. package/docs/content/locales/zh-CN/getting-started.mdx +6 -4
  631. package/docs/content/locales/zh-CN/internationalization.mdx +1 -1
  632. package/docs/content/locales/zh-CN/package-lifecycle.mdx +19 -0
  633. package/docs/content/locales/zh-CN/sandbox-adapters.mdx +17 -6
  634. package/docs/content/locales/zh-CN/security.mdx +8 -0
  635. package/docs/content/locales/zh-TW/audit-log.mdx +2 -1
  636. package/docs/content/locales/zh-TW/automations.mdx +7 -7
  637. package/docs/content/locales/zh-TW/getting-started.mdx +6 -4
  638. package/docs/content/locales/zh-TW/internationalization.mdx +1 -1
  639. package/docs/content/locales/zh-TW/package-lifecycle.mdx +19 -0
  640. package/docs/content/locales/zh-TW/sandbox-adapters.mdx +18 -7
  641. package/docs/content/locales/zh-TW/security.mdx +8 -0
  642. package/docs/content/package-lifecycle.mdx +51 -0
  643. package/docs/content/sandbox-adapters.mdx +16 -5
  644. package/package.json +12 -3
  645. package/src/templates/default/package.json +2 -2
  646. package/src/templates/headless/package.json +0 -1
  647. package/src/templates/workspace-core/.agents/skills/audit-log/SKILL.md +3 -0
  648. package/src/templates/workspace-core/.agents/skills/automations/SKILL.md +1 -1
  649. package/src/templates/workspace-core/.agents/skills/observability/SKILL.md +20 -0
  650. package/src/templates/workspace-core/.agents/skills/voice-transcription/SKILL.md +8 -4
  651. package/src/templates/workspace-core/package.json +0 -1
  652. package/src/templates/workspace-root/package.json +0 -1
  653. package/corpus/templates/slides/app/components/ui/toast.tsx +0 -1
  654. package/corpus/templates/slides/app/components/ui/toaster.tsx +0 -1
  655. package/corpus/templates/slides/app/hooks/use-toast.ts +0 -1
@@ -163,7 +163,13 @@ Ajoutez une route `/response-insights` avec `useActionQuery("list-response-insig
163
163
  />
164
164
  </WireframeBlock>
165
165
 
166
- ร‰tendez `view-screen` et `navigate` pour que l'agent connaisse la route active et puisse ouvrir `/response-insights`. Les rรฉsultats peuvent aussi contenir `href: "/response-insights"` pour afficher un bouton "Ouvrir les insights de rรฉponses".
166
+ ## 6. Laisser l'agent naviguer {#agent-navigation}
167
+
168
+ Le modรจle Chat inclut les actions `view-screen` et `navigate`. ร‰tendez-les ร  mesure que votre app grandit :
169
+
170
+ - `view-screen` doit lire le application state et renvoyer la route active, l'insight sรฉlectionnรฉ, les filtres actifs et tout contexte de page compact dont l'agent a besoin.
171
+ - `navigate` doit รฉcrire un chemin same-origin comme `/response-insights` quand l'agent dรฉcide que l'utilisateur doit inspecter le rรฉsultat visuellement.
172
+ - Les rรฉsultats d'une action peuvent inclure des liens comme `href: "/response-insights"` pour que le chat propose un bouton explicite ยซ Ouvrir les insights de rรฉponses ยป.
167
173
 
168
174
  Quand le chat pleine page ouvre une page d'app, utilisez `AgentChatSurface`, `AgentSidebar`, `useAgentChatHomeHandoff`, `useAgentChatHomeHandoffLinks` et `chatViewTransition` depuis [Agent Surfaces](/docs/agent-surfaces#rich-chat) pour glisser le chat dans le panneau latรฉral sans perdre le thread.
169
175
 
@@ -59,7 +59,7 @@ export const i18nCatalog = {
59
59
  ```
60
60
 
61
61
  Toujours regrouper `en-US`. Importation dynamique de catalogues dans une langue autre que l'anglais pour les utilisateurs uniquement
62
- tรฉlรฉchargez les paramรจtres rรฉgionaux actifs. Les codes rรฉgionaux pris en charge sont `en-US`, `zh-CN`,
62
+ tรฉlรฉchargez les paramรจtres rรฉgionaux actifs. Les codes rรฉgionaux pris en charge sont `en-US`, `zh-CN`, `zh-TW`,
63
63
  `es-ES`, `fr-FR`, `de-DE`, `ja-JP`, `ko-KR`, `pt-BR`, `hi-IN` et `ar-SA`.
64
64
 
65
65
  ## UI
@@ -0,0 +1,21 @@
1
+ ---
2
+ title: Cycle de vie des paquets
3
+ description: Inspecter, ajouter et รฉjecter des paquets Agent Native pilotรฉs par manifeste.
4
+ ---
5
+
6
+ # Cycle de vie des paquets
7
+
8
+ Un paquet rรฉutilisable peut publier un fichier statique et versionnรฉ
9
+ `agent-native.package.json`. La CLI lit uniquement ce JSON et n'exรฉcute aucun
10
+ code du paquet pendant l'inspection.
11
+
12
+ ```bash
13
+ agent-native package inspect @agent-native/scheduling --json
14
+ agent-native package add @agent-native/scheduling --apply
15
+ agent-native package eject @agent-native/scheduling --apply
16
+ ```
17
+
18
+ L'ajout et l'รฉjection sont simulรฉs par dรฉfaut. `--apply` autorise les รฉcritures
19
+ et le gestionnaire de paquets. La CLI refuse les collisions et dispositions
20
+ inconnues, puis restaure fichiers et verrous si l'installation รฉchoue. Seul
21
+ Scheduling est รฉjectable pendant ce pilote; Pinpoint reste diffรฉrรฉ.
@@ -102,7 +102,11 @@ La couture rรฉside dans le noyau de `packages/core/src/coding-tools/sandbox/`ย :
102
102
  },
103
103
  {
104
104
  path: "index.ts",
105
- note: "Sรฉlection : getSandboxAdapter() / registerSandboxAdapter()",
105
+ note: "Sรฉlectionย : getSandboxAdapter() / registerSandboxAdapter()",
106
+ },
107
+ {
108
+ path: "background.ts",
109
+ note: "marqueur de file durable et cycle de vie de lโ€™exรฉcution en arriรจre-plan",
106
110
  },
107
111
  {
108
112
  path: "local-child-process-adapter.ts",
@@ -184,12 +188,17 @@ registerSandboxAdapter(adapter) โ†’ AGENT_NATIVE_SANDBOX โ†’ local default
184
188
 
185
189
  ### Variable d'environnement `AGENT_NATIVE_SANDBOX` {#env}
186
190
 
187
- Sรฉlectionne un adaptateur intรฉgrรฉ par identifiant. Actuellement, seul le `local` (valeur par dรฉfaut) est cรขblรฉย ; les valeurs inconnues reviennent au niveau local plutรดt que d'รฉchouer l'exรฉcution.
191
+ Sรฉlectionne un adaptateur intรฉgrรฉ par identifiant. `local` (valeur par dรฉfaut) et `background` sont tous deux cรขblรฉsย ; les valeurs inconnues reviennent ร  `local` plutรดt que dโ€™รฉchouer lโ€™exรฉcution.
188
192
 
189
193
  ```bash
190
- AGENT_NATIVE_SANDBOX=local # la valeur par dรฉfaut - explicite
194
+ AGENT_NATIVE_SANDBOX=local # la valeur par dรฉfaut - explicite
195
+ AGENT_NATIVE_SANDBOX=background # met durablement en file chaque appel run-code
191
196
  ```
192
197
 
198
+ `background` stocke le code brut dans `sandbox_executions` et renvoie immรฉdiatement un `executionId` avec `status: "queued"`. Un auto-dispatch signรฉ dรฉmarre une nouvelle invocation serverlessย ; un processus Node de longue durรฉe lance un travail dรฉtachรฉ dans le processusย ; lโ€™interrogation du statut et le balayage pรฉriodique relancent les dispatchs perdus ou les baux expirรฉs. Interrogez lโ€™exรฉcution plus tard pour obtenir son rรฉsultat persistant.
199
+
200
+ `BackgroundQueueAdapter` est un marqueur de file durable, pas lโ€™exรฉcuteur. Le travail en file utilise un adaptateur dโ€™exรฉcution enregistrรฉ non mis en file lorsquโ€™il est disponibleย ; sinon, il revient au processus enfant local. La sรฉlection de `background` seule ne fournit pas dโ€™isolation distante ou par conteneur et ne rend pas un environnement edge compatible avec `node:child_process`.
201
+
193
202
  ### `registerSandboxAdapter()` {#register}
194
203
 
195
204
  Un processus hรดte remplace le backend pour tous les appels `run-code` ultรฉrieurs via le `index.ts` de la couture โ€” par exemple, pour exรฉcuter chaque appel dans un conteneur distantย :
@@ -214,13 +223,15 @@ registerSandboxAdapter(new RemoteSandboxAdapter());
214
223
 
215
224
  ## La couture pour un coureur durable {#durable}
216
225
 
217
- Cette interface est dรฉlibรฉrรฉment le joint d'un futur bac ร  sable distant/durable. Un adaptateur distant ou durable (Docker, un exรฉcuteur de type Vercel-Sandbox ou un travailleur en arriรจre-plan en file d'attente)ย :
226
+ Lโ€™adaptateur intรฉgrรฉ `background` fournit dรฉjร  une mise en file durable et un nouveau budget dโ€™exรฉcution, tandis que lโ€™exรฉcution rรฉelle utilise toujours un adaptateur non mis en file ou le processus enfant local comme solution de repli. Un adaptateur distant ou isolรฉ enregistrรฉ sรฉparรฉment (Docker ou un exรฉcuteur de type Vercel-Sandbox) peut fournir une autre frontiรจre dโ€™exรฉcution et exรฉcuter รฉgalement du travail en arriรจre-plan par appel.
227
+
228
+ Un tel adaptateurย :
218
229
 
219
- 1. Implรฉmentez `SandboxAdapter.run` sur un environnement d'exรฉcution hors processus.
220
- 2. Tunnelez le pont de bouclage (ou le pont proxy rappelle le parent).
221
- 3. Laissez les tรขches de donnรฉes volumineuses s'exรฉcuter jusqu'ร  leur terme indรฉpendamment du cycle de vie de la demande, en dรฉpassant le plafond d'exรฉcution de code hรฉbergรฉ d'environ 40ย s qui limite l'adaptateur de processus enfant local.
230
+ 1. Implรฉmenterait `SandboxAdapter.run` sur un environnement dโ€™exรฉcution hors processus.
231
+ 2. Crรฉerait un tunnel pour le pont de bouclage ou transmettrait ses appels au processus parent.
232
+ 3. Fournirait une isolation distante ou par conteneur indรฉpendamment du cycle de vie de la file durable livrรฉe.
222
233
 
223
- Enregistrez-le sous une nouvelle valeur `AGENT_NATIVE_SANDBOX` (par exemple `remote`) et/ou via `registerSandboxAdapter()`. La boucle d'agent et `run-code.ts` ne changent jamais.
234
+ Enregistrez-le par programmation avec `registerSandboxAdapter()`. La boucle dโ€™agent et `run-code.ts` nโ€™ont pas besoin de changer.
224
235
 
225
236
  > [!TIP]
226
237
  > Le plan `agent-native add sandbox docker` รฉmet une recette complรจte et autonome pour implรฉmenter un adaptateur Docker contre cette couture. Voir [Blueprint Installer](/docs/blueprint-installer).
@@ -417,3 +417,11 @@ AGENT_NATIVE_KEYS_WORKSPACE_FALLBACK=1
417
417
  ```
418
418
 
419
419
  Les รฉcritures secrรจtes ร  lโ€™รฉchelle de lโ€™espace de travail nรฉcessitent toujours le rรดle de propriรฉtaire/administrateur de lโ€™organisation, quel que soit cet indicateur.
420
+
421
+ ## Suite
422
+
423
+ - [**Authentication**](/docs/authentication) โ€” modes d'auth, cookie realms et dรฉtails de session sur lesquels cette page s'appuie
424
+ - [**Multi-Tenancy**](/docs/multi-tenancy) โ€” le modรจle d'appartenance ร  l'organisation derriรจre le scoping par `org_id`
425
+ - [**Sharing**](/docs/sharing) โ€” le pattern `ownableColumns()` et le garde d'accรจs appliquรฉs aux ressources partageables
426
+ - [**Messaging**](/docs/messaging#env-vars) โ€” les secrets de signature de webhook par intรฉgration rรฉfรฉrencรฉs dans la liste de contrรดle ci-dessus
427
+ - [**Deployment**](/docs/deployment) โ€” les variables d'environnement de production que cette liste de contrรดle suppose dรฉfinies
@@ -73,10 +73,11 @@ export default defineAction({
73
73
 
74
74
  ## เคŸเฅเคฐเฅ‡เคฒ เคชเคขเคผเคจเคพ {#reading}
75
75
 
76
- เคฆเฅ‹ เคฐเฅ€เคก actions เคเคœเฅ‡เค‚เคŸ เค•เฅ‡ เคฒเคฟเค เค‰เคชเคฒเคฌเฅเคง เคนเฅˆเค‚ **เค”เคฐ** เคนเคฐ เคเคช เคฎเฅ‡เค‚ เคซเฅเคฐเค‚เคŸเคเค‚เคก, SQL เคฎเฅ‡เค‚ เค•เฅ‰เคฒ เค•เคฐเคจเฅ‡ เคตเคพเคฒเฅ‡ เค•เฅ‡ เคฆเคพเคฏเคฐเฅ‡ เคฎเฅ‡เค‚ เค†เคคเคพ เคนเฅˆ - เคตเฅ‡ เค•เคญเฅ€ เคญเฅ€ เค•เคฟเคธเฅ€ เค…เคจเฅเคฏ เค•เคฟเคฐเคพเคฏเฅ‡เคฆเคพเคฐ เค•เฅ€ เคชเค‚เค•เฅเคคเคฟเคฏเคพเค เคจเคนเฅ€เค‚ เคฒเฅŒเคŸเคพเคคเฅ‡ เคนเฅˆเค‚:
76
+ เคคเฅ€เคจ เคฐเฅ€เคก actions เคเคœเฅ‡เค‚เคŸ เค•เฅ‡ เคฒเคฟเค เค‰เคชเคฒเคฌเฅเคง เคนเฅˆเค‚ **เค”เคฐ** เคนเคฐ เคเคช เคฎเฅ‡เค‚ เคซเฅเคฐเค‚เคŸเคเค‚เคก, SQL เคฎเฅ‡เค‚ เค•เฅ‰เคฒ เค•เคฐเคจเฅ‡ เคตเคพเคฒเฅ‡ เค•เฅ‡ เคฆเคพเคฏเคฐเฅ‡ เคฎเฅ‡เค‚ เค†เคคเคพ เคนเฅˆ - เคตเฅ‡ เค•เคญเฅ€ เคญเฅ€ เค•เคฟเคธเฅ€ เค…เคจเฅเคฏ เค•เคฟเคฐเคพเคฏเฅ‡เคฆเคพเคฐ เค•เฅ€ เคชเค‚เค•เฅเคคเคฟเคฏเคพเค เคจเคนเฅ€เค‚ เคฒเฅŒเคŸเคพเคคเฅ‡ เคนเฅˆเค‚:
77
77
 
78
78
  - **`list-audit-events`** - `targetType` / `targetId`, `actorKind` (`agent` | `human` | `system`), `status`, `threadId` / `turnId`, `action` เคฆเฅเคตเคพเคฐเคพ เคซเคผเคฟเคฒเฅเคŸเคฐ เค•เคฐเฅ‡เค‚เฅค `sinceMs`, เค”เคฐ `limit`.
79
79
  - **`get-audit-event`** - เค†เคˆเคกเฅ€ เค•เฅ‡ เค…เคจเฅเคธเคพเคฐ เคเค• เคˆเคตเฅ‡เค‚เคŸ, เคœเคฟเคธเคฎเฅ‡เค‚ เค‡เคธเค•เคพ เคธเค‚เคถเฅ‹เคงเคฟเคค เค‡เคจเคชเฅเคŸ เคชเฅ‡เคฒเฅ‹เคก เคญเฅ€ เคถเคพเคฎเคฟเคฒ เคนเฅˆเฅค
80
+ - **`export-audit-events`** โ€” `list-audit-events` เค•เฅ‹ เคนเคพเคฅ เคธเฅ‡ เคชเฅ‡เคœ เค•เคฐเคจเฅ‡ เค•เฅ‡ เคฌเคœเคพเคฏ เคŸเฅเคฐเฅ‡เคฒ เค•เฅ‹ CSV เคฏเคพ NDJSON เค•เฅ‡ เคฐเฅ‚เคช เคฎเฅ‡เค‚ เคฌเคฒเฅเค• เคฎเฅ‡เค‚ เคเค•เฅเคธเคชเฅ‹เคฐเฅเคŸ เค•เคฐเคคเคพ เคนเฅˆ, เค‘เคซเคผเคฒเคพเค‡เคจ เค…เคจเฅเคชเคพเคฒเคจ เคชเฅเคฒ เค•เฅ‡ เคฒเคฟเคเฅค เคฏเคน `list-audit-events` เคœเฅˆเคธเฅ‡ เคนเฅ€ เคซเคผเคฟเคฒเฅเคŸเคฐ เคฒเฅ‡เคคเคพ เคนเฅˆ (`limit` เค•เฅ‹ เค›เฅ‹เคกเคผเค•เคฐ) เคธเคพเคฅ เคนเฅ€ `format` (`csv` | `ndjson`, เคกเคฟเคซเคผเฅ‰เคฒเฅเคŸ `csv`) เค”เคฐ `maxRows` (เคกเคฟเคซเคผเฅ‰เคฒเฅเคŸ 5000, เคนเคพเคฐเฅเคก เค•เฅˆเคช 10000), เค”เคฐ `{ content, rowCount, truncated, format }` เคฒเฅŒเคŸเคพเคคเคพ เคนเฅˆ โ€” `truncated: true` เค•เคพ เคฎเคคเคฒเคฌ เคนเฅˆ เค•เคฟ `maxRows` เค•เฅ€ เค…เคจเฅเคฎเคคเคฟ เคธเฅ‡ เค…เคงเคฟเค• เคชเค‚เค•เฅเคคเคฟเคฏเคพเค เคฎเฅ‡เคฒ เค–เคพเคˆเค‚เฅค เคฏเคน เคธเฅเคตเคฏเค‚ เคเค• เคธเค‚เคตเฅ‡เคฆเคจเคถเฅ€เคฒ เคฐเฅ€เคก เคนเฅˆ, เคœเคฟเคธเฅ‡ `audit: { onRead: true }` เค•เฅ‡ เคฎเคพเคงเฅเคฏเคฎ เคธเฅ‡ เค‘เคกเคฟเคŸ เค•เคฟเคฏเคพ เคœเคพเคคเคพ เคนเฅˆเฅค
80
81
 
81
82
  `useActionQuery` เค•เฅ‡ เคธเคพเคฅ UI เคธเฅ‡ `list-audit-events` เค•เฅ‹ เค•เฅ‰เคฒ เค•เคฐเค•เฅ‡ เคเค• เค—เคคเคฟเคตเคฟเคงเคฟ เคซเคผเฅ€เคก เคฏเคพ "เคฏเคน เค•เคฟเคธเคจเฅ‡ เคฌเคฆเคฒเคพ" เคฒเคพเค‡เคจ เคฌเคจเคพเคเค‚ - เค•เคญเฅ€ เคญเฅ€ เค‘เคกเคฟเคŸ เคŸเฅ‡เคฌเคฒ เคชเคฐ เคนเคพเคฅ เคธเฅ‡ เคจ เคฒเคฟเค–เฅ‡เค‚:
82
83
 
@@ -114,13 +114,13 @@ description: "เคชเฅเคฐเคพเค•เฅƒเคคเคฟเค•-เคญเคพเคทเคพ เคธเฅเคฅเคฟเคคเคฟเคฏเฅ‹
114
114
 
115
115
  เค‘เคŸเฅ‹เคฎเฅ‡เคถเคจ [recurring-jobs frontmatter table](/docs/recurring-jobs#frontmatter) เคฎเฅ‡เค‚ เคนเคฐ เคซเคผเฅ€เคฒเฅเคก เค•เฅ‹ เคธเคพเคเคพ เค•เคฐเคคเคพ เคนเฅˆเฅค เคฏเฅ‡ เค…เคคเคฟเคฐเคฟเค•เฅเคค เคซเคผเฅ€เคฒเฅเคก เค‡เคตเฅ‡เค‚เคŸ เคŸเฅเคฐเคฟเค—เคฐเฅเคธ, เคถเคฐเฅเคคเฅ‹เค‚ เค”เคฐ เคจเคฟเคทเฅเคชเคพเคฆเคจ เคฎเฅ‹เคก เค•เฅ‹ เคจเคฟเคฏเค‚เคคเฅเคฐเคฟเคค เค•เคฐเคคเฅ‡ เคนเฅˆเค‚:
116
116
 
117
- | เคซเคผเฅ€เคฒเฅเคก | เคชเฅเคฐเค•เคพเคฐ | เคกเคฟเคซเคผเฅ‰เคฒเฅเคŸ | เคตเคฟเคตเคฐเคฃ |
118
- | ------------- | -------------------------------- | ------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
119
- | `triggerType` | `"schedule"` \| `"event"` | `"schedule"` | เค‘เคŸเฅ‹เคฎเฅ‡เคถเคจ เค•เฅˆเคธเฅ‡ เคธเค•เฅเคฐเคฟเคฏ เคนเฅ‹เคคเคพ เคนเฅˆ |
120
- | `event` | เคธเฅเคŸเฅเคฐเคฟเค‚เค— | _(เคตเฅˆเค•เคฒเฅเคชเคฟเค•)_ | เคธเคฆเคธเฅเคฏเคคเคพ เค•เฅ‡ เคฒเคฟเค เคˆเคตเฅ‡เค‚เคŸ เค•เคพ เคจเคพเคฎ (เค•เฅ‡เคตเคฒ เคˆเคตเฅ‡เค‚เคŸ เคŸเฅเคฐเคฟเค—เคฐเฅเคธ) |
121
- | `condition` | เคธเฅเคŸเฅเคฐเคฟเค‚เค— | _(เคตเฅˆเค•เคฒเฅเคชเคฟเค•)_ | เคชเฅเคฐเฅ‡เคทเคฃ เคธเฅ‡ เคชเคนเคฒเฅ‡ เคชเฅเคฐเคพเค•เฅƒเคคเคฟเค•-เคญเคพเคทเคพ เค•เฅ€ เคธเฅเคฅเคฟเคคเคฟ เค•เคพ เคฎเฅ‚เคฒเฅเคฏเคพเค‚เค•เคจ เค•เคฟเคฏเคพ เค—เคฏเคพ |
122
- | `mode` | `"agentic"` \| `"deterministic"` | `"agentic"` | เคชเฅ‚เคฐเฅเคฃ เคเคœเฅ‡เค‚เคŸ เคฒเฅ‚เคช. (`"deterministic"` เค†เคฐเค•เฅเคทเคฟเคค เคนเฅˆ เคฒเฅ‡เค•เคฟเคจ เค…เคญเฅ€ เคคเค• เคฒเคพเค—เฅ‚ เคจเคนเฅ€เค‚ เค•เคฟเคฏเคพ เค—เคฏเคพ เคนเฅˆ - เค‡เคธเฅ‡ เคธเฅ‡เคŸ เค•เคฐเคจเฅ‡ เคตเคพเคฒเฅ‡ เค‘เคŸเฅ‹เคฎเฅ‡เคถเคจ เค•เฅ‹ เค›เฅ‹เคกเคผ เคฆเคฟเคฏเคพ เค—เคฏเคพ เคนเฅˆเฅค เคธเคญเฅ€ เคฎเฅŒเคœเฅ‚เคฆเคพ เค‘เคŸเฅ‹เคฎเฅ‡เคถเคจ เค•เฅ‡ เคฒเคฟเค `"agentic"` เค•เคพ เค‰เคชเคฏเฅ‹เค— เค•เคฐเฅ‡เค‚เฅค) |
123
- | `domain` | เคธเฅเคŸเฅเคฐเคฟเค‚เค— | _(เคตเฅˆเค•เคฒเฅเคชเคฟเค•)_ | เค—เฅเคฐเฅเคชเคฟเค‚เค— เคŸเฅˆเค— (เคฎเฅ‡เคฒ, เค•เฅˆเคฒเฅ‡เค‚เคกเคฐ, เค•เฅเคฒเคฟเคช เค†เคฆเคฟ) |
117
+ | เคซเคผเฅ€เคฒเฅเคก | เคชเฅเคฐเค•เคพเคฐ | เคกเคฟเคซเคผเฅ‰เคฒเฅเคŸ | เคตเคฟเคตเคฐเคฃ |
118
+ | ------------- | ------------------------- | ------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------- |
119
+ | `triggerType` | `"schedule"` \| `"event"` | `"schedule"` | เค‘เคŸเฅ‹เคฎเฅ‡เคถเคจ เค•เฅˆเคธเฅ‡ เคธเค•เฅเคฐเคฟเคฏ เคนเฅ‹เคคเคพ เคนเฅˆ |
120
+ | `event` | เคธเฅเคŸเฅเคฐเคฟเค‚เค— | _(เคตเฅˆเค•เคฒเฅเคชเคฟเค•)_ | เคธเคฆเคธเฅเคฏเคคเคพ เค•เฅ‡ เคฒเคฟเค เคˆเคตเฅ‡เค‚เคŸ เค•เคพ เคจเคพเคฎ (เค•เฅ‡เคตเคฒ เคˆเคตเฅ‡เค‚เคŸ เคŸเฅเคฐเคฟเค—เคฐเฅเคธ) |
121
+ | `condition` | เคธเฅเคŸเฅเคฐเคฟเค‚เค— | _(เคตเฅˆเค•เคฒเฅเคชเคฟเค•)_ | เคชเฅเคฐเฅ‡เคทเคฃ เคธเฅ‡ เคชเคนเคฒเฅ‡ เคชเฅเคฐเคพเค•เฅƒเคคเคฟเค•-เคญเคพเคทเคพ เค•เฅ€ เคธเฅเคฅเคฟเคคเคฟ เค•เคพ เคฎเฅ‚เคฒเฅเคฏเคพเค‚เค•เคจ เค•เคฟเคฏเคพ เค—เคฏเคพ |
122
+ | `mode` | `"agentic"` | `"agentic"` | เคชเฅ‚เคฐเฅเคฃ เคเคœเฅ‡เค‚เคŸ เคฒเฅ‚เคช (เคเค•เคฎเคพเคคเฅเคฐ เคธเคฎเคฐเฅเคฅเคฟเคค เคฎเฅ‹เคก)เฅค `"deterministic"` เค•เฅ‹ เคนเคŸเคพ เคฆเคฟเคฏเคพ เค—เคฏเคพ เคนเฅˆ โ€” เค‡เคธเฅ‡ เค•เคญเฅ€ เคฒเคพเค—เฅ‚ เคจเคนเฅ€เค‚ เค•เคฟเคฏเคพ เค—เคฏเคพ เคฅเคพ, เค”เคฐ เค‡เคธเฅ‡ เคธเฅ‡เคŸ เค•เคฐเคจเฅ‡ เคตเคพเคฒเฅ‡ เค‘เคŸเฅ‹เคฎเฅ‡เคถเคจ เค•เคญเฅ€ เคšเคฒเฅ‡ เคนเฅ€ เคจเคนเฅ€เค‚เฅค |
123
+ | `domain` | เคธเฅเคŸเฅเคฐเคฟเค‚เค— | _(เคตเฅˆเค•เคฒเฅเคชเคฟเค•)_ | เค—เฅเคฐเฅเคชเคฟเค‚เค— เคŸเฅˆเค— (เคฎเฅ‡เคฒ, เค•เฅˆเคฒเฅ‡เค‚เคกเคฐ, เค•เฅเคฒเคฟเคช เค†เคฆเคฟ) |
124
124
 
125
125
  เคˆเคตเฅ‡เค‚เคŸ เคŸเฅเคฐเคฟเค—เคฐ เค•เฅ‡ เคฒเคฟเค, `schedule` `""` (เค–เคพเคฒเฅ€) เคนเฅˆ; เคถเฅ‡เคกเฅเคฏเฅ‚เคฒ เคŸเฅเคฐเคฟเค—เคฐ เค•เฅ‡ เคฒเคฟเค เค‡เคธเคฎเฅ‡เค‚ เค•เฅเคฐเฅ‰เคจ เคเค•เฅเคธเคชเฅเคฐเฅ‡เคถเคจ เคนเฅ‹เคคเคพ เคนเฅˆเฅค เคกเคฟเคธเฅเคชเฅˆเคšเคฐ เคตเคนเฅ€ เคชเฅเคฐเคฌเค‚เคงเคฟเคค `lastRun` / `lastStatus` / `lastError` เคซเคผเฅ€เคฒเฅเคก เคญเฅ€ เคฒเคฟเค–เคคเคพ เคนเฅˆ เคœเฅ‹ เคถเฅ‡เคกเฅเคฏเฅ‚เคฒเคฐ เคฒเคฟเค–เคคเคพ เคนเฅˆ, เคธเคพเคฅ เคนเฅ€ เคœเคฌ เค•เฅ‹เคˆ เคถเคฐเฅเคค เค—เคฒเคค เคชเคฐ เคฎเฅ‚เคฒเฅเคฏเคพเค‚เค•เคจ เค•เคฐเคคเฅ€ เคนเฅˆ เคคเฅ‹ เคเค• `"skipped"` เคธเฅเคฅเคฟเคคเคฟ เคญเฅ€ เคฒเคฟเค–เคคเคพ เคนเฅˆเฅค
126
126
 
@@ -163,7 +163,13 @@ Browser เค•เฅ‡ เคฒเคฟเค เค…เคฒเค— duplicate REST route เคจ เคฌเคจเคพเคเค‚; UI
163
163
  />
164
164
  </WireframeBlock>
165
165
 
166
- `view-screen` เค”เคฐ `navigate` เค•เฅ‹ extend เค•เคฐเฅ‡เค‚ เคคเคพเค•เคฟ agent current route เคœเคพเคจ เคธเค•เฅ‡ เค”เคฐ `/response-insights` เค–เฅ‹เคฒ เคธเค•เฅ‡. Results เคฎเฅ‡เค‚ `href: "/response-insights"` เคญเฅ€ เคนเฅ‹ เคธเค•เคคเคพ เคนเฅˆ, เคœเคฟเคธเคธเฅ‡ chat เคฎเฅ‡เค‚ "เคชเฅเคฐเคคเคฟเค•เฅเคฐเคฟเคฏเคพ insights เค–เฅ‹เคฒเฅ‡เค‚" button เคฆเคฟเค–เฅ‡.
166
+ ## 6. agent เค•เฅ‹ navigate เค•เคฐเคจเฅ‡ เคฆเฅ‡เค‚ {#agent-navigation}
167
+
168
+ Chat template เคฎเฅ‡เค‚ `view-screen` เค”เคฐ `navigate` actions เคถเคพเคฎเคฟเคฒ เคนเฅˆเค‚. เค†เคชเค•เฅ€ app เคฌเคขเคผเคจเฅ‡ เค•เฅ‡ เคธเคพเคฅ เค‡เคจเฅเคนเฅ‡เค‚ extend เค•เคฐเฅ‡เค‚:
169
+
170
+ - `view-screen` เค•เฅ‹ application state เคชเคขเคผเค•เคฐ current route, selected insight, active filters, เค”เคฐ agent เค•เฅ‹ เคœเคฐเฅ‚เคฐเฅ€ เค•เคฟเคธเฅ€ เคญเฅ€ compact page context เค•เฅ‹ return เค•เคฐเคจเคพ เคšเคพเคนเคฟเค.
171
+ - `navigate` เค•เฅ‹ `/response-insights` เคœเฅˆเคธเคพ same-origin path เคคเคฌ เคฒเคฟเค–เคจเคพ เคšเคพเคนเคฟเค เคœเคฌ agent เคคเคฏ เค•เคฐเฅ‡ เค•เคฟ user เค•เฅ‹ result visually เคฆเฅ‡เค–เคจเคพ เคšเคพเคนเคฟเค.
172
+ - action results เคฎเฅ‡เค‚ `href: "/response-insights"` เคœเฅˆเคธเฅ‡ links เคนเฅ‹ เคธเค•เคคเฅ‡ เคนเฅˆเค‚ เคคเคพเค•เคฟ chat เคเค• เคธเฅเคชเคทเฅเคŸ "เคชเฅเคฐเคคเคฟเค•เฅเคฐเคฟเคฏเคพ insights เค–เฅ‹เคฒเฅ‡เค‚" button เคฆเคฟเค–เคพ เคธเค•เฅ‡.
167
173
 
168
174
  เคœเคฌ full-page chat app page เค–เฅ‹เคฒเคคเคพ เคนเฅˆ, เคคเฅ‹ [Agent Surfaces](/docs/agent-surfaces#rich-chat) เคธเฅ‡ `AgentChatSurface`, `AgentSidebar`, `useAgentChatHomeHandoff`, `useAgentChatHomeHandoffLinks` เค”เคฐ `chatViewTransition` เค‡เคธเฅเคคเฅ‡เคฎเคพเคฒ เค•เคฐเฅ‡เค‚ เคคเคพเค•เคฟ เคตเคนเฅ€ thread เคฐเค–เคคเฅ‡ เคนเฅเค chat side panel เคฎเฅ‡เค‚ slide เคนเฅ‹ เคœเคพเค.
169
175
 
@@ -59,7 +59,7 @@ export const i18nCatalog = {
59
59
  ```
60
60
 
61
61
  เคนเคฎเฅ‡เคถเคพ `en-US` เค•เฅ‹ เคฌเค‚เคกเคฒ เค•เคฐเฅ‡เค‚เฅค เคกเคพเคฏเคจเคพเคฎเคฟเค•-เค†เคฏเคพเคค เค—เฅˆเคฐ-เค…เค‚เค—เฅเคฐเฅ‡เคœเคผเฅ€ เค•เฅˆเคŸเคฒเฅ‰เค— เค•เฅ‡เคตเคฒ เค‰เคชเคฏเฅ‹เค—เค•เคฐเฅเคคเคพเค“เค‚ เค•เฅ‡ เคฒเคฟเค
62
- เคธเค•เฅเคฐเคฟเคฏ เคฒเฅ‹เค•เฅ‡เคฒ เคกเคพเค‰เคจเคฒเฅ‹เคก เค•เคฐเฅ‡เค‚เฅค เคธเคฎเคฐเฅเคฅเคฟเคค เคธเฅเคฅเคพเคจเฅ€เคฏ เค•เฅ‹เคก `en-US`, `zh-CN`,
62
+ เคธเค•เฅเคฐเคฟเคฏ เคฒเฅ‹เค•เฅ‡เคฒ เคกเคพเค‰เคจเคฒเฅ‹เคก เค•เคฐเฅ‡เค‚เฅค เคธเคฎเคฐเฅเคฅเคฟเคค เคธเฅเคฅเคพเคจเฅ€เคฏ เค•เฅ‹เคก `en-US`, `zh-CN`, `zh-TW`,
63
63
  `es-ES`, `fr-FR`, `de-DE`, `ja-JP`, `ko-KR`, `pt-BR`, `hi-IN`, เค”เคฐ `ar-SA`เฅค
64
64
 
65
65
  ## UI
@@ -0,0 +1,20 @@
1
+ ---
2
+ title: เคชเฅˆเค•เฅ‡เคœ เคœเฅ€เคตเคจเคšเค•เฅเคฐ
3
+ description: เคฎเฅˆเคจเคฟเคซเคผเฅ‡เคธเฅเคŸ เคธเฅ‡ เคธเค‚เคšเคพเคฒเคฟเคค Agent Native เคชเฅˆเค•เฅ‡เคœ เค•เฅ‹ เคธเฅเคฐเค•เฅเคทเคฟเคค เคฐเฅ‚เคช เคธเฅ‡ เคœเคพเคเคšเฅ‡เค‚, เคœเฅ‹เคกเคผเฅ‡เค‚ เค”เคฐ เคฌเคพเคนเคฐ เคจเคฟเค•เคพเคฒเฅ‡เค‚เฅค
4
+ ---
5
+
6
+ # เคชเฅˆเค•เฅ‡เคœ เคœเฅ€เคตเคจเคšเค•เฅเคฐ
7
+
8
+ เคฆเฅ‹เคฌเคพเคฐเคพ เค‰เคชเคฏเฅ‹เค— เคนเฅ‹เคจเฅ‡ เคตเคพเคฒเฅ‡ เคชเฅˆเค•เฅ‡เคœ เคธเค‚เคธเฅเค•เคฐเคฃเคฏเฅเค•เฅเคค เคธเฅเคฅเคฟเคฐ `agent-native.package.json`
9
+ เคชเฅเคฐเค•เคพเคถเคฟเคค เค•เคฐ เคธเค•เคคเฅ‡ เคนเฅˆเค‚เฅค เคœเคพเคเคš เค•เฅ‡ เคธเคฎเคฏ CLI เค•เฅ‡เคตเคฒ เคฏเคน JSON เคชเคขเคผเคคเคพ เคนเฅˆ เค”เคฐ เคชเฅˆเค•เฅ‡เคœ เค•เฅ‹เคก เคจเคนเฅ€เค‚ เคšเคฒเคพเคคเคพเฅค
10
+
11
+ ```bash
12
+ agent-native package inspect @agent-native/scheduling --json
13
+ agent-native package add @agent-native/scheduling --apply
14
+ agent-native package eject @agent-native/scheduling --apply
15
+ ```
16
+
17
+ เคœเฅ‹เคกเคผเคจเคพ เค”เคฐ เคฌเคพเคนเคฐ เคจเคฟเค•เคพเคฒเคจเคพ เคกเคฟเคซเคผเฅ‰เคฒเฅเคŸ เคฐเฅ‚เคช เคธเฅ‡ เค•เฅ‡เคตเคฒ เคชเฅ‚เคฐเฅเคตเคพเคตเคฒเฅ‹เค•เคจ เคนเฅˆเฅค `--apply` เคฒเคฟเค–เคจเฅ‡ เค”เคฐ เคชเฅˆเค•เฅ‡เคœ
18
+ เคฎเฅˆเคจเฅ‡เคœเคฐ เคšเคฒเคพเคจเฅ‡ เค•เฅ€ เค…เคจเฅเคฎเคคเคฟ เคฆเฅ‡เคคเคพ เคนเฅˆเฅค เคŸเค•เคฐเคพเคต เคฏเคพ เค…เคจเคœเคพเคจ เคฒเฅ‡เค†เค‰เคŸ เค…เคธเฅเคตเฅ€เค•เคพเคฐ เคนเฅ‹เคคเฅ‡ เคนเฅˆเค‚ เค”เคฐ เค‡เค‚เคธเฅเคŸเฅ‰เคฒ เคตเคฟเคซเคฒ
19
+ เคนเฅ‹เคจเฅ‡ เคชเคฐ เคซเคผเคพเค‡เคฒเฅ‡เค‚ เคต เคฒเฅ‰เค•เคซเคผเคพเค‡เคฒ เคตเคพเคชเคธ เคฐเค–เฅ€ เคœเคพเคคเฅ€ เคนเฅˆเค‚เฅค เค…เคญเฅ€ เค•เฅ‡เคตเคฒ Scheduling เคธเคฎเคฐเฅเคฅเคฟเคค เคนเฅˆ; Pinpoint
20
+ เคฌเคพเคฆ เค•เฅ‡ เคฒเคฟเค เคธเฅเคฅเค—เคฟเคค เคนเฅˆเฅค
@@ -103,6 +103,10 @@ Agent-Native เคฎเฅ‡เค‚ เคฆเฅ‹ เคเคกเคพเคชเฅเคŸเคฐ เคธเฅ€เคฎ เคนเฅˆเค‚ เคœเฅ‹
103
103
  path: "index.ts",
104
104
  note: "selection logic: getSandboxAdapter() / registerSandboxAdapter()",
105
105
  },
106
+ {
107
+ path: "background.ts",
108
+ note: "เคŸเคฟเค•เคพเคŠ เค•เคคเคพเคฐ เคšเคฟเคนเฅเคจเค• เค”เคฐ เคฌเฅˆเค•เค—เฅเคฐเคพเค‰เค‚เคก เคจเคฟเคทเฅเคชเคพเคฆเคจ เคœเฅ€เคตเคจเคšเค•เฅเคฐ",
109
+ },
106
110
  {
107
111
  path: "local-child-process-adapter.ts",
108
112
  note: "default backend: locked-down Node child process",
@@ -183,12 +187,17 @@ registerSandboxAdapter(adapter) โ†’ AGENT_NATIVE_SANDBOX โ†’ local default
183
187
 
184
188
  ### `AGENT_NATIVE_SANDBOX` env var {#env}
185
189
 
186
- เค†เคˆเคกเฅ€ เค•เฅ‡ เค†เคงเคพเคฐ เคชเคฐ เคเค• เค…เค‚เคคเคฐเฅเคจเคฟเคนเคฟเคค เคเคกเคพเคชเฅเคŸเคฐ เค•เคพ เคšเคฏเคจ เค•เคฐเคคเคพ เคนเฅˆเฅค เคตเคฐเฅเคคเคฎเคพเคจ เคฎเฅ‡เค‚ เค•เฅ‡เคตเคฒ `local` (เคกเคฟเคซเคผเฅ‰เคฒเฅเคŸ) เคตเคพเคฏเคฐเฅเคก เคนเฅˆ; เค…เคœเฅเคžเคพเคค เคฎเคพเคจ เคฐเคจ เคฎเฅ‡เค‚ เคตเคฟเคซเคฒ เคนเฅ‹เคจเฅ‡ เค•เฅ‡ เคฌเคœเคพเคฏ เคธเฅเคฅเคพเคจเฅ€เคฏ เคธเฅเคคเคฐ เคชเคฐ เคตเคพเคชเคธ เค† เคœเคพเคคเฅ‡ เคนเฅˆเค‚เฅค
190
+ เค†เคˆเคกเฅ€ เค•เฅ‡ เค†เคงเคพเคฐ เคชเคฐ เคเค• เค…เค‚เคคเคฐเฅเคจเคฟเคนเคฟเคค เคเคกเคพเคชเฅเคŸเคฐ เคšเฅเคจเคคเคพ เคนเฅˆเฅค `local` (เคกเคฟเคซเคผเฅ‰เคฒเฅเคŸ) เค”เคฐ `background` เคฆเฅ‹เคจเฅ‹เค‚ เคตเคพเคฏเคฐเฅเคก เคนเฅˆเค‚; เค…เคœเฅเคžเคพเคค เคฎเคพเคจ เคฐเคจ เค•เฅ‹ เคตเคฟเคซเคฒ เค•เคฐเคจเฅ‡ เค•เฅ‡ เคฌเคœเคพเคฏ `local` เคชเคฐ เคตเคพเคชเคธ เค†เคคเฅ‡ เคนเฅˆเค‚เฅค
187
191
 
188
192
  ```bash
189
- AGENT_NATIVE_SANDBOX=local # เคกเคฟเคซเคผเฅ‰เคฒเฅเคŸ - เคธเฅเคชเคทเฅเคŸ
193
+ AGENT_NATIVE_SANDBOX=local # เคกเคฟเคซเคผเฅ‰เคฒเฅเคŸ - เคธเฅเคชเคทเฅเคŸ
194
+ AGENT_NATIVE_SANDBOX=background # เคนเคฐ run-code เค•เฅ‰เคฒ เค•เฅ‹ เคŸเคฟเค•เคพเคŠ เค•เคคเคพเคฐ เคฎเฅ‡เค‚ เคกเคพเคฒเฅ‡เค‚
190
195
  ```
191
196
 
197
+ `background` เค•เคšเฅเคšเฅ‡ เค•เฅ‹เคก เค•เฅ‹ `sandbox_executions` เคฎเฅ‡เค‚ เคธเค‚เค—เฅเคฐเคนเฅ€เคค เค•เคฐเคคเคพ เคนเฅˆ เค”เคฐ เคคเฅเคฐเค‚เคค `status: "queued"` เค•เฅ‡ เคธเคพเคฅ เคเค• `executionId` เคฒเฅŒเคŸเคพเคคเคพ เคนเฅˆเฅค เคนเคธเฅเคคเคพเค•เฅเคทเคฐเคฟเคค เคธเฅเคต-เคชเฅเคฐเฅ‡เคทเคฃ เคเค• เคจเคฏเคพ เคธเคฐเฅเคตเคฐเคฒเฅ‡เคธ เค†เคนเฅเคตเคพเคจ เคถเฅเคฐเฅ‚ เค•เคฐเคคเคพ เคนเฅˆ; เคฒเค‚เคฌเฅ‡ เคธเคฎเคฏ เคคเค• เคšเคฒเคจเฅ‡ เคตเคพเคฒเคพ Node เคชเฅเคฐเค•เฅเคฐเคฟเคฏเคพ เคฎเฅ‡เค‚ เค…เคฒเค— เค•เคพเคฎ เคถเฅเคฐเฅ‚ เค•เคฐเคคเคพ เคนเฅˆ; เคธเฅเคฅเคฟเคคเคฟ เคœเคพเคเคš เค”เคฐ เค†เคตเคงเคฟเค• เคธเฅเค•เฅˆเคจ เค–เฅ‹เค เคนเฅเค เคชเฅเคฐเฅ‡เคทเคฃ เคฏเคพ เคธเคฎเคพเคชเฅเคค เคฒเฅ€เคœเคผ เค•เฅ‹ เคซเคฟเคฐ เคšเคฒเคพเคคเฅ‡ เคนเฅˆเค‚เฅค เคธเฅเคฅเคพเคฏเฅ€ เคชเคฐเคฟเคฃเคพเคฎ เค•เฅ‡ เคฒเคฟเค เคจเคฟเคทเฅเคชเคพเคฆเคจ เค•เฅ€ เคธเฅเคฅเคฟเคคเคฟ เคฌเคพเคฆ เคฎเฅ‡เค‚ เคœเคพเคเคšเฅ‡เค‚เฅค
198
+
199
+ `BackgroundQueueAdapter` เคŸเคฟเค•เคพเคŠ เค•เคคเคพเคฐ เค•เคพ เคšเคฟเคนเฅเคจเค• เคนเฅˆ, เคจเคฟเคทเฅเคชเคพเคฆเค• เคจเคนเฅ€เค‚เฅค เค‰เคชเคฒเคฌเฅเคง เคนเฅ‹เคจเฅ‡ เคชเคฐ เค•เคคเคพเคฐเคฌเคฆเฅเคง เค•เคพเคฎ เคเค• เคชเค‚เคœเฅ€เค•เฅƒเคค เค—เฅˆเคฐ-เค•เคคเคพเคฐ เคจเคฟเคทเฅเคชเคพเคฆเคจ เคเคกเคพเคชเฅเคŸเคฐ เค•เคพ เค‰เคชเคฏเฅ‹เค— เค•เคฐเคคเคพ เคนเฅˆ; เค…เคจเฅเคฏเคฅเคพ เคฏเคน เคธเฅเคฅเคพเคจเฅ€เคฏ เคšเคพเค‡เคฒเฅเคก เคชเฅเคฐเฅ‹เคธเฅ‡เคธ เคชเคฐ เคตเคพเคชเคธ เค†เคคเคพ เคนเฅˆเฅค เค•เฅ‡เคตเคฒ `background` เคšเฅเคจเคจเฅ‡ เคธเฅ‡ เคฐเคฟเคฎเฅ‹เคŸ เคฏเคพ เค•เค‚เคŸเฅ‡เคจเคฐ เค…เคฒเค—เคพเคต เคจเคนเฅ€เค‚ เคฎเคฟเคฒเคคเคพ เค”เคฐ เคเคœ เคฐเคจเคŸเคพเค‡เคฎ `node:child_process` เค•เฅ‡ เค…เคจเฅเค•เฅ‚เคฒ เคจเคนเฅ€เค‚ เคฌเคจเคคเคพเฅค
200
+
192
201
  ### `registerSandboxAdapter()` {#register}
193
202
 
194
203
  เคเค• เคนเฅ‹เคธเฅเคŸ เคชเฅเคฐเค•เฅเคฐเคฟเคฏเคพ เคธเฅ€เคฎ เค•เฅ‡ `index.ts` เค•เฅ‡ เคฎเคพเคงเฅเคฏเคฎ เคธเฅ‡ เคธเคญเฅ€ เคฌเคพเคฆ เค•เฅ‡ `run-code` เค†เคฎเค‚เคคเฅเคฐเคฃเฅ‹เค‚ เค•เฅ‡ เคฒเคฟเค เคฌเฅˆเค•เคเค‚เคก เค•เฅ‹ เค“เคตเคฐเคฐเคพเค‡เคก เค•เคฐเคคเฅ€ เคนเฅˆ - เค‰เคฆเคพเคนเคฐเคฃ เค•เฅ‡ เคฒเคฟเค, เคเค• เคฆเฅ‚เคฐเคธเฅเคฅ เค•เค‚เคŸเฅ‡เคจเคฐ เคฎเฅ‡เค‚ เคชเฅเคฐเคคเฅเคฏเฅ‡เค• เค•เฅ‰เคฒ เค•เฅ‹ เคšเคฒเคพเคจเฅ‡ เค•เฅ‡ เคฒเคฟเค:
@@ -213,13 +222,15 @@ registerSandboxAdapter(new RemoteSandboxAdapter());
213
222
 
214
223
  ## เคŸเคฟเค•เคพเคŠ เคงเคพเคตเค• เค•เฅ‡ เคฒเคฟเค เคธเฅ€เคฎ {#durable}
215
224
 
216
- เคฏเคน เค‡เค‚เคŸเคฐเคซเคผเฅ‡เคธ เคœเคพเคจเคฌเฅ‚เคเค•เคฐ เคญเคตเคฟเคทเฅเคฏ เค•เฅ‡ เคฐเคฟเคฎเฅ‹เคŸ/เคŸเคฟเค•เคพเคŠ เคธเฅˆเค‚เคกเคฌเฅ‰เค•เฅเคธ เค•เฅ‡ เคฒเคฟเค เคธเฅ€เคฎ เคนเฅˆเฅค เคเค• เคฐเคฟเคฎเฅ‹เคŸ เคฏเคพ เคŸเคฟเค•เคพเคŠ เคเคกเฅ‰เคชเฅเคŸเคฐ (เคกเฅ‰เค•เคฐ, เคเค• เคตเคฐเฅเคธเฅ‡เคฒ-เคธเฅˆเค‚เคกเคฌเฅ‰เค•เฅเคธ-เคถเฅˆเคฒเฅ€ เคงเคพเคตเค•, เคฏเคพ เคเค• เค•เคคเคพเคฐเคฌเคฆเฅเคง เคชเฅƒเคทเฅเค เคญเฅ‚เคฎเคฟ เค•เคพเคฐเฅเคฏเค•เคฐเฅเคคเคพ) เคฏเคน เค•เคฐเฅ‡เค—เคพ:
225
+ เค…เค‚เคคเคฐเฅเคจเคฟเคนเคฟเคค `background` เคเคกเคพเคชเฅเคŸเคฐ เคชเคนเคฒเฅ‡ เคธเฅ‡ เคŸเคฟเค•เคพเคŠ เค•เคคเคพเคฐ เค”เคฐ เคจเคฏเคพ เคจเคฟเคทเฅเคชเคพเคฆเคจ เคฌเคœเคŸ เคฆเฅ‡เคคเคพ เคนเฅˆ, เคœเคฌเค•เคฟ เคตเคพเคธเฅเคคเคตเคฟเค• เคจเคฟเคทเฅเคชเคพเคฆเคจ เค…เคฌ เคญเฅ€ เค—เฅˆเคฐ-เค•เคคเคพเคฐ เคเคกเคพเคชเฅเคŸเคฐ เคฏเคพ เคธเฅเคฅเคพเคจเฅ€เคฏ เคšเคพเค‡เคฒเฅเคก-เคชเฅเคฐเฅ‹เคธเฅ‡เคธ เคซเคผเฅ‰เคฒเคฌเฅˆเค• เค•เคพ เค‰เคชเคฏเฅ‹เค— เค•เคฐเคคเคพ เคนเฅˆเฅค เค…เคฒเค— เคธเฅ‡ เคชเค‚เคœเฅ€เค•เฅƒเคค เคฐเคฟเคฎเฅ‹เคŸ เคฏเคพ เคชเฅƒเคฅเค• เคเคกเคพเคชเฅเคŸเคฐ (Docker เคฏเคพ Vercel-Sandbox เคถเฅˆเคฒเฅ€ เคฐเคจเคฐ) เค…เคฒเค— เคจเคฟเคทเฅเคชเคพเคฆเคจ เคธเฅ€เคฎเคพ เคฆเฅ‡ เคธเค•เคคเคพ เคนเฅˆ เค”เคฐ เคชเฅเคฐเคคเคฟ เค•เฅ‰เคฒ เคฌเฅˆเค•เค—เฅเคฐเคพเค‰เค‚เคก เค•เคพเคฎ เคญเฅ€ เคจเคฟเคทเฅเคชเคพเคฆเคฟเคค เค•เคฐ เคธเค•เคคเคพ เคนเฅˆเฅค
226
+
227
+ เคเคธเคพ เคเคกเคพเคชเฅเคŸเคฐ:
217
228
 
218
- 1. เค†เค‰เคŸ-เค‘เคซเคผ-เคชเฅเคฐเฅ‹เคธเฅ‡เคธ เคฐเคจเคŸเคพเค‡เคฎ เค•เฅ‡ เคตเคฟเคฐเฅเคฆเฅเคง `SandboxAdapter.run` เคฒเคพเค—เฅ‚ เค•เคฐเฅ‡เค‚เฅค
219
- 2. เคฒเฅ‚เคชเคฌเฅˆเค• เคฌเฅเคฐเคฟเคœ เค•เฅ‹ เคŸเคจเคฒ เค•เคฐเฅ‡เค‚ (เคฏเคพ เคชเฅเคฐเฅ‰เค•เฅเคธเฅ€ เคฌเฅเคฐเคฟเคœ เคชเฅˆเคฐเฅ‡เค‚เคŸ เค•เฅ‹ เคตเคพเคชเคธ เค•เฅ‰เคฒ เค•เคฐเคคเคพ เคนเฅˆ)เฅค
220
- 3. เคฌเคกเคผเฅ‡ เคกเฅ‡เคŸเคพ เคœเฅ‰เคฌเฅเคธ เค•เฅ‹ เค…เคจเฅเคฐเฅ‹เคง เคœเฅ€เคตเคจเคšเค•เฅเคฐ เคธเฅ‡ เคธเฅเคตเคคเค‚เคคเฅเคฐ เคฐเฅ‚เคช เคธเฅ‡ เคชเฅ‚เคฐเคพ เคนเฅ‹เคจเฅ‡ เคฆเฅ‡เค‚ - เคธเฅเคฅเคพเคจเฅ€เคฏ เคšเคพเค‡เคฒเฅเคก-เคชเฅเคฐเฅ‹เคธเฅ‡เคธ เคเคกเฅ‰เคชเฅเคŸเคฐ เค•เฅ‹ เคธเฅ€เคฎเคฟเคค เค•เคฐเคจเฅ‡ เคตเคพเคฒเฅ€ เคนเฅ‹เคธเฅเคŸ เค•เฅ€ เค—เคˆ ~40เคเคธ เค•เฅ‹เคก-เคเค•เฅเคœเคผเฅ€เค•เฅเคฏเฅ‚เคŸเคฟเคต เคธเฅ€เคฎเคพ เคธเฅ‡ เค…เคงเคฟเค•เฅค
229
+ 1. เคชเฅเคฐเค•เฅเคฐเคฟเคฏเคพ เคธเฅ‡ เคฌเคพเคนเคฐ เค•เฅ‡ เคฐเคจเคŸเคพเค‡เคฎ เค•เฅ‡ เคตเคฟเคฐเฅเคฆเฅเคง `SandboxAdapter.run` เคฒเคพเค—เฅ‚ เค•เคฐเฅ‡เค—เคพเฅค
230
+ 2. เคฒเฅ‚เคชเคฌเฅˆเค• เคฌเฅเคฐเคฟเคœ เค•เฅ‹ เคŸเคจเคฒ เค•เคฐเฅ‡เค—เคพ เคฏเคพ เคฌเฅเคฐเคฟเคœ เค•เฅ‰เคฒ เค•เฅ‹ เคฎเฅ‚เคฒ เคชเฅเคฐเค•เฅเคฐเคฟเคฏเคพ เคคเค• เคชเฅเคฐเฅ‰เค•เฅเคธเฅ€ เค•เคฐเฅ‡เค—เคพเฅค
231
+ 3. เค‰เคชเคฒเคฌเฅเคง เคŸเคฟเค•เคพเคŠ เค•เคคเคพเคฐ เคœเฅ€เคตเคจเคšเค•เฅเคฐ เคธเฅ‡ เคธเฅเคตเคคเค‚เคคเฅเคฐ เคฐเคฟเคฎเฅ‹เคŸ เคฏเคพ เค•เค‚เคŸเฅ‡เคจเคฐ เค…เคฒเค—เคพเคต เคฆเฅ‡เค—เคพเฅค
221
232
 
222
- เค‡เคธเฅ‡ เคเค• เคจเค `AGENT_NATIVE_SANDBOX` เคฎเคพเคจ (เคœเฅˆเคธเฅ‡ `remote`) เค”เคฐ/เคฏเคพ `registerSandboxAdapter()` เค•เฅ‡ เคฎเคพเคงเฅเคฏเคฎ เคธเฅ‡ เคชเค‚เคœเฅ€เค•เฅƒเคค เค•เคฐเฅ‡เค‚เฅค เคเคœเฅ‡เค‚เคŸ เคฒเฅ‚เคช เค”เคฐ `run-code.ts` เค•เคญเฅ€ เคจเคนเฅ€เค‚ เคฌเคฆเคฒเคคเฅ‡เฅค
233
+ เค‡เคธเฅ‡ `registerSandboxAdapter()` เค•เฅ‡ เคฎเคพเคงเฅเคฏเคฎ เคธเฅ‡ เคชเฅเคฐเฅ‹เค—เฅเคฐเคพเคฎเฅ‡เคŸเคฟเค• เคฐเฅ‚เคช เคธเฅ‡ เคชเค‚เคœเฅ€เค•เฅƒเคค เค•เคฐเฅ‡เค‚เฅค เคเคœเฅ‡เค‚เคŸ เคฒเฅ‚เคช เค”เคฐ `run-code.ts` เค•เฅ‹ เคฌเคฆเคฒเคจเฅ‡ เค•เฅ€ เค†เคตเคถเฅเคฏเค•เคคเคพ เคจเคนเฅ€เค‚ เคนเฅˆเฅค
223
234
 
224
235
  > [!TIP]
225
236
  > `agent-native add sandbox docker` เคฌเฅเคฒเฅ‚เคชเฅเคฐเคฟเค‚เคŸ เค‡เคธ เคธเฅ€เคฎ เค•เฅ‡ เคตเคฟเคฐเฅเคฆเฅเคง เคกเฅ‰เค•เคฐ เคเคกเคพเคชเฅเคŸเคฐ เค•เฅ‹ เคฒเคพเค—เฅ‚ เค•เคฐเคจเฅ‡ เค•เฅ‡ เคฒเคฟเค เคเค• เคชเฅ‚เคฐเฅเคฃ, เคธเฅเคต-เคจเคฟเคนเคฟเคค เคจเฅเคธเฅเค–เคพ เค‰เคคเฅเคธเคฐเฅเคœเคฟเคค เค•เคฐเคคเคพ เคนเฅˆเฅค [Blueprint Installer](/docs/blueprint-installer) เคฆเฅ‡เค–เฅ‡เค‚.
@@ -415,3 +415,11 @@ AGENT_NATIVE_KEYS_WORKSPACE_FALLBACK=1
415
415
  ```
416
416
 
417
417
  เคตเคฐเฅเค•เคธเฅเคชเฅ‡เคธ-เคธเฅเค•เฅ‹เคช เค—เฅเคชเฅเคค เคฒเฅ‡เค–เคจ เค•เฅ‡ เคฒเคฟเค เค‡เคธ เคงเฅเคตเคœ เค•เฅ€ เคชเคฐเคตเคพเคน เค•เคฟเค เคฌเคฟเคจเคพ เค…เคญเฅ€ เคญเฅ€ เคธเค‚เค—เค เคจ เคธเฅเคตเคพเคฎเฅ€/เคตเฅเคฏเคตเคธเฅเคฅเคพเคชเค• เคญเฅ‚เคฎเคฟเค•เคพ เค•เฅ€ เค†เคตเคถเฅเคฏเค•เคคเคพ เคนเฅ‹เคคเฅ€ เคนเฅˆเฅค
418
+
419
+ ## เค†เค—เฅ‡ เค•เฅเคฏเคพ
420
+
421
+ - [**Authentication**](/docs/authentication) โ€” auth modes, cookie realms, เค”เคฐ session เค•เฅ‡ เคตเฅ‡ details เคœเคฟเคจ เคชเคฐ เคฏเคน เคชเฅ‡เคœ เคฌเคจเคพ เคนเฅˆ
422
+ - [**Multi-Tenancy**](/docs/multi-tenancy) โ€” `org_id` scoping เค•เฅ‡ เคชเฅ€เค›เฅ‡ เค•เคพ org-membership เคฎเฅ‰เคกเคฒ
423
+ - [**Sharing**](/docs/sharing) โ€” shareable resources เคชเคฐ เคฒเคพเค—เฅ‚ `ownableColumns()` เค”เคฐ access-guard เคชเฅˆเคŸเคฐเฅเคจ
424
+ - [**Messaging**](/docs/messaging#env-vars) โ€” เคŠเคชเคฐ checklist เคฎเฅ‡เค‚ เคฌเคคเคพเค เค—เค per-integration webhook signing secrets
425
+ - [**Deployment**](/docs/deployment) โ€” production environment variables เคœเคฟเคจเฅเคนเฅ‡เค‚ เคฏเคน checklist เคธเฅ‡เคŸ เคฎเคพเคจเคคเฅ€ เคนเฅˆ
@@ -73,10 +73,11 @@ export default defineAction({
73
73
 
74
74
  ## ่ปŒ่ทกใ‚’่ชญใ‚€ {#reading}
75
75
 
76
- 2 ใคใฎ่ชญใฟๅ–ใ‚Š actions ใฏใ€ใ‚จใƒผใ‚ธใ‚งใƒณใƒˆ ** ใŠใ‚ˆใณ ** ใ™ในใฆใฎใ‚ขใƒ—ใƒชใฎใƒ•ใƒญใƒณใƒˆใ‚จใƒณใƒ‰ใงไฝฟ็”จใงใใ€ๅ‘ผใณๅ‡บใ—ๅ…ƒใซๅฏพใ—ใฆ SQL ใซใ‚นใ‚ณใƒผใƒ—ใ•ใ‚Œใพใ™ใ€‚ใ“ใ‚Œใ‚‰ใฏๅˆฅใฎใƒ†ใƒŠใƒณใƒˆใฎ่กŒใ‚’่ฟ”ใ™ใ“ใจใฏใ‚ใ‚Šใพใ›ใ‚“ใ€‚
76
+ 3 ใคใฎ่ชญใฟๅ–ใ‚Š actions ใฏใ€ใ‚จใƒผใ‚ธใ‚งใƒณใƒˆ ** ใŠใ‚ˆใณ ** ใ™ในใฆใฎใ‚ขใƒ—ใƒชใฎใƒ•ใƒญใƒณใƒˆใ‚จใƒณใƒ‰ใงไฝฟ็”จใงใใ€ๅ‘ผใณๅ‡บใ—ๅ…ƒใซๅฏพใ—ใฆ SQL ใซใ‚นใ‚ณใƒผใƒ—ใ•ใ‚Œใพใ™ใ€‚ใ“ใ‚Œใ‚‰ใฏๅˆฅใฎใƒ†ใƒŠใƒณใƒˆใฎ่กŒใ‚’่ฟ”ใ™ใ“ใจใฏใ‚ใ‚Šใพใ›ใ‚“ใ€‚
77
77
 
78
78
  - **`list-audit-events`** โ€” `targetType` / `targetId`ใ€`actorKind` (`agent` | `human` | `system`)ใ€`status`ใ€`threadId` / `turnId`ใ€`action`ใ€ใงใƒ•ใ‚ฃใƒซใ‚ฟใƒผใ—ใพใ™ใ€‚ `sinceMs`ใ€`limit`ใ€‚
79
79
  - **`get-audit-event`** โ€” ID ใซใ‚ˆใ‚‹ 1 ใคใฎใ‚คใƒ™ใƒณใƒˆ (็ทจ้›†ใ•ใ‚ŒใŸๅ…ฅๅŠ›ใƒšใ‚คใƒญใƒผใƒ‰ใ‚’ๅซใ‚€)ใ€‚
80
+ - **`export-audit-events`** โ€” `list-audit-events` ใ‚’ๆ‰‹ๅ‹•ใงใƒšใƒผใ‚ธใƒณใ‚ฐใ™ใ‚‹ไปฃใ‚ใ‚Šใซใ€ใƒˆใƒฌใ‚คใƒซใ‚’ CSV ใพใŸใฏ NDJSON ใจใ—ใฆไธ€ๆ‹ฌใ‚จใ‚ฏใ‚นใƒใƒผใƒˆใ—ใพใ™๏ผˆใ‚ชใƒ•ใƒฉใ‚คใƒณใฎใ‚ณใƒณใƒ—ใƒฉใ‚คใ‚ขใƒณใ‚นๅ–ๅพ—็”จ๏ผ‰ใ€‚`list-audit-events` ใจๅŒใ˜ใƒ•ใ‚ฃใƒซใ‚ฟใƒผ๏ผˆ`limit` ใ‚’้™คใ๏ผ‰ใซๅŠ ใˆใฆใ€`format`๏ผˆ`csv` | `ndjson`ใ€ใƒ‡ใƒ•ใ‚ฉใƒซใƒˆ `csv`๏ผ‰ใจ `maxRows`๏ผˆใƒ‡ใƒ•ใ‚ฉใƒซใƒˆ 5000ใ€ไธŠ้™ 10000๏ผ‰ใ‚’ๅ—ใ‘ๅ–ใ‚Šใ€`{ content, rowCount, truncated, format }` ใ‚’่ฟ”ใ—ใพใ™ โ€” `truncated: true` ใฏใ€`maxRows` ใฎ่จฑๅฎนๆ•ฐใ‚’่ถ…ใˆใ‚‹่กŒใŒไธ€่‡ดใ—ใŸใ“ใจใ‚’ๆ„ๅ‘ณใ—ใพใ™ใ€‚ใ“ใ‚Œ่‡ชไฝ“ใ€`audit: { onRead: true }` ใซใ‚ˆใฃใฆ็›ฃๆŸปใ•ใ‚Œใ‚‹ๆฉŸๅฏ†ๆ€งใฎ้ซ˜ใ„่ชญใฟๅ–ใ‚Šใงใ™ใ€‚
80
81
 
81
82
  `useActionQuery` ใ‚’ไฝฟ็”จใ—ใฆ UI ใ‹ใ‚‰ `list-audit-events` ใ‚’ๅ‘ผใณๅ‡บใ—ใฆใ€ใ‚ขใ‚ฏใƒ†ใ‚ฃใƒ“ใƒ†ใ‚ฃ ใƒ•ใ‚ฃใƒผใƒ‰ใพใŸใฏใ€Œ่ชฐใŒใ“ใ‚Œใ‚’ๅค‰ๆ›ดใ—ใŸใ‹ใ€่กŒใ‚’ไฝœๆˆใ—ใพใ™ใ€‚็›ฃๆŸปใƒ†ใƒผใƒ–ใƒซใธใฎใƒ•ใ‚งใƒƒใƒใ‚’ๆ‰‹ๅ‹•ใงๆ›ธใ่พผใพใชใ„ใงใใ ใ•ใ„ใ€‚
82
83
 
@@ -114,13 +114,13 @@ description: "่‡ช็„ถ่จ€่ชžๆกไปถใ‚’ไฝฟ็”จใ—ใŸใ‚คใƒ™ใƒณใƒˆใƒˆใƒชใ‚ฌใƒผใŠใ‚ˆใณ
114
114
 
115
115
  ใ‚ชใƒผใƒˆใƒกใƒผใ‚ทใƒงใƒณใฏใ€[recurring-jobs frontmatter table](/docs/recurring-jobs#frontmatter) ใฎใ™ในใฆใฎใƒ•ใ‚ฃใƒผใƒซใƒ‰ใ‚’ๅ…ฑๆœ‰ใ—ใพใ™ใ€‚ใ“ใ‚Œใ‚‰ใฎ่ฟฝๅŠ ใƒ•ใ‚ฃใƒผใƒซใƒ‰ใฏใ€ใ‚คใƒ™ใƒณใƒˆ ใƒˆใƒชใ‚ฌใƒผใ€ๆกไปถใ€ๅฎŸ่กŒใƒขใƒผใƒ‰ใ‚’ๅˆถๅพกใ—ใพใ™ใ€‚
116
116
 
117
- | ใƒ•ใ‚ฃใƒผใƒซใƒ‰ | ใ‚ฟใ‚คใƒ— | ใƒ‡ใƒ•ใ‚ฉใƒซใƒˆ | ่ชฌๆ˜Ž |
118
- | ------------- | -------------------------------- | -------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
119
- | `triggerType` | `"schedule"` \| `"event"` | `"schedule"` | ใ‚ชใƒผใƒˆใƒกใƒผใ‚ทใƒงใƒณใฎ่ตทๅ‹•ๆ–นๆณ• |
120
- | `event` | ๆ–‡ๅญ—ๅˆ— | _(ใ‚ชใƒ—ใ‚ทใƒงใƒณ)_ | ใ‚ตใƒ–ใ‚นใ‚ฏใƒฉใ‚คใƒ–ใ™ใ‚‹ใ‚คใƒ™ใƒณใƒˆๅ (ใ‚คใƒ™ใƒณใƒˆ ใƒˆใƒชใ‚ฌใƒผใฎใฟ) |
121
- | `condition` | ๆ–‡ๅญ—ๅˆ— | _(ใ‚ชใƒ—ใ‚ทใƒงใƒณ)_ | ็™บ้€ๅ‰ใซ่ฉ•ไพกใ•ใ‚Œใ‚‹่‡ช็„ถ่จ€่ชžๆกไปถ |
122
- | `mode` | `"agentic"` \| `"deterministic"` | `"agentic"` | ๅฎŒๅ…จใชใ‚จใƒผใ‚ธใ‚งใƒณใƒˆ ใƒซใƒผใƒ—ใ€‚ (`"deterministic"` ใฏไบˆ็ด„ใ•ใ‚Œใฆใ„ใพใ™ใŒใ€ใพใ ๅฎŸ่ฃ…ใ•ใ‚Œใฆใ„ใพใ›ใ‚“ใ€‚ใ“ใ‚Œใ‚’่จญๅฎšใ™ใ‚‹ใ‚ชใƒผใƒˆใƒกใƒผใ‚ทใƒงใƒณใฏใ‚นใ‚ญใƒƒใƒ—ใ•ใ‚Œใพใ™ใ€‚็พๅœจใฎใ™ในใฆใฎใ‚ชใƒผใƒˆใƒกใƒผใ‚ทใƒงใƒณใซใฏ `"agentic"` ใ‚’ไฝฟ็”จใ—ใฆใใ ใ•ใ„ใ€‚) |
123
- | `domain` | ๆ–‡ๅญ—ๅˆ— | _(ใ‚ชใƒ—ใ‚ทใƒงใƒณ)_ | ใ‚ฐใƒซใƒผใƒ—ๅŒ–ใ‚ฟใ‚ฐ (ใƒกใƒผใƒซใ€ใ‚ซใƒฌใƒณใƒ€ใƒผใ€ใ‚ฏใƒชใƒƒใƒ—ใชใฉ) |
117
+ | ใƒ•ใ‚ฃใƒผใƒซใƒ‰ | ใ‚ฟใ‚คใƒ— | ใƒ‡ใƒ•ใ‚ฉใƒซใƒˆ | ่ชฌๆ˜Ž |
118
+ | ------------- | ------------------------- | -------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
119
+ | `triggerType` | `"schedule"` \| `"event"` | `"schedule"` | ใ‚ชใƒผใƒˆใƒกใƒผใ‚ทใƒงใƒณใฎ่ตทๅ‹•ๆ–นๆณ• |
120
+ | `event` | ๆ–‡ๅญ—ๅˆ— | _(ใ‚ชใƒ—ใ‚ทใƒงใƒณ)_ | ใ‚ตใƒ–ใ‚นใ‚ฏใƒฉใ‚คใƒ–ใ™ใ‚‹ใ‚คใƒ™ใƒณใƒˆๅ (ใ‚คใƒ™ใƒณใƒˆ ใƒˆใƒชใ‚ฌใƒผใฎใฟ) |
121
+ | `condition` | ๆ–‡ๅญ—ๅˆ— | _(ใ‚ชใƒ—ใ‚ทใƒงใƒณ)_ | ็™บ้€ๅ‰ใซ่ฉ•ไพกใ•ใ‚Œใ‚‹่‡ช็„ถ่จ€่ชžๆกไปถ |
122
+ | `mode` | `"agentic"` | `"agentic"` | ๅฎŒๅ…จใชใ‚จใƒผใ‚ธใ‚งใƒณใƒˆ ใƒซใƒผใƒ—๏ผˆๅ”ฏไธ€ใ‚ตใƒใƒผใƒˆใ•ใ‚Œใฆใ„ใ‚‹ใƒขใƒผใƒ‰๏ผ‰ใ€‚`"deterministic"` ใฏๅ‰Š้™คใ•ใ‚Œใพใ—ใŸ โ€” ๅฎŸ่ฃ…ใ•ใ‚ŒใŸใ“ใจใฏไธ€ๅบฆใ‚‚ใชใใ€ใ“ใ‚Œใ‚’่จญๅฎšใ—ใŸใ‚ชใƒผใƒˆใƒกใƒผใ‚ทใƒงใƒณใŒ็™บ็ซใ™ใ‚‹ใ“ใจใ‚‚ใ‚ใ‚Šใพใ›ใ‚“ใงใ—ใŸใ€‚ |
123
+ | `domain` | ๆ–‡ๅญ—ๅˆ— | _(ใ‚ชใƒ—ใ‚ทใƒงใƒณ)_ | ใ‚ฐใƒซใƒผใƒ—ๅŒ–ใ‚ฟใ‚ฐ (ใƒกใƒผใƒซใ€ใ‚ซใƒฌใƒณใƒ€ใƒผใ€ใ‚ฏใƒชใƒƒใƒ—ใชใฉ) |
124
124
 
125
125
  ใ‚คใƒ™ใƒณใƒˆ ใƒˆใƒชใ‚ฌใƒผใฎๅ ดๅˆใ€`schedule` ใฏ `""` (็ฉบ) ใงใ™ใ€‚ใ‚นใ‚ฑใ‚ธใƒฅใƒผใƒซ ใƒˆใƒชใ‚ฌใƒผใฎๅ ดๅˆใฏ cron ๅผใŒๅซใพใ‚Œใพใ™ใ€‚ใƒ‡ใ‚ฃใ‚นใƒ‘ใƒƒใƒใƒฃใฏใ€ใ‚นใ‚ฑใ‚ธใƒฅใƒผใƒฉใจๅŒใ˜็ฎก็†ๅฏพ่ฑก `lastRun` / `lastStatus` / `lastError` ใƒ•ใ‚ฃใƒผใƒซใƒ‰ใซๅŠ ใˆใฆใ€ๆกไปถใŒ false ใจ่ฉ•ไพกใ•ใ‚ŒใŸๅ ดๅˆใฎ `"skipped"` ใ‚นใƒ†ใƒผใ‚ฟใ‚นใ‚‚ๆ›ธใ่พผใฟใพใ™ใ€‚
126
126
 
@@ -163,7 +163,13 @@ export const responseInsights = table("response_insights", {
163
163
  />
164
164
  </WireframeBlock>
165
165
 
166
- `view-screen` ใจ `navigate` ใ‚’ๆ‹กๅผตใ—ใ€agent ใŒ็พๅœจใฎ route ใ‚’็†่งฃใ—ใฆ `/response-insights` ใ‚’้–‹ใ‘ใ‚‹ใ‚ˆใ†ใซใ—ใพใ™ใ€‚็ตๆžœใซ `href: "/response-insights"` ใ‚’ๅซใ‚ใ‚Œใฐใ€ใƒใƒฃใƒƒใƒˆใซ "ๅ›ž็ญ”ใ‚คใƒณใ‚ตใ‚คใƒˆใ‚’้–‹ใ" ใƒœใ‚ฟใƒณใ‚’่กจ็คบใงใใพใ™ใ€‚
166
+ ## 6. agent ใซใƒŠใƒ“ใ‚ฒใƒผใƒˆใ•ใ›ใ‚‹ {#agent-navigation}
167
+
168
+ Chat ใƒ†ใƒณใƒ—ใƒฌใƒผใƒˆใซใฏ `view-screen` ใจ `navigate` action ใŒๅซใพใ‚Œใพใ™ใ€‚ใ‚ขใƒ—ใƒชใฎๆˆ้•ทใซๅˆใ‚ใ›ใฆๆ‹กๅผตใ—ใฆใใ ใ•ใ„ใ€‚
169
+
170
+ - `view-screen` ใฏ application state ใ‚’่ชญใฟๅ–ใ‚Šใ€็พๅœจใฎ routeใ€้ธๆŠžไธญใฎ insightใ€ๆœ‰ๅŠนใชใƒ•ใ‚ฃใƒซใ‚ฟใƒผใ€agent ใŒๅฟ…่ฆใจใ™ใ‚‹ใ‚ณใƒณใƒ‘ใ‚ฏใƒˆใชใƒšใƒผใ‚ธใ‚ณใƒณใƒ†ใ‚ญใ‚นใƒˆใ‚’่ฟ”ใ™ๅฟ…่ฆใŒใ‚ใ‚Šใพใ™ใ€‚
171
+ - `navigate` ใฏใ€agent ใŒใƒฆใƒผใ‚ถใƒผใซ็ตๆžœใ‚’่ฆ–่ฆš็š„ใซ็ขบ่ชใ•ใ›ใ‚‹ในใใจๅˆคๆ–ญใ—ใŸใจใใซใ€`/response-insights` ใฎใ‚ˆใ†ใช same-origin path ใ‚’ๆ›ธใ่พผใ‚€ๅฟ…่ฆใŒใ‚ใ‚Šใพใ™ใ€‚
172
+ - action ใฎ็ตๆžœใซใฏ `href: "/response-insights"` ใฎใ‚ˆใ†ใชใƒชใƒณใ‚ฏใ‚’ๅซใ‚ใ‚‰ใ‚Œใ‚‹ใŸใ‚ใ€ใƒใƒฃใƒƒใƒˆใฏๆ˜Ž็คบ็š„ใชใ€Œๅ›ž็ญ”ใ‚คใƒณใ‚ตใ‚คใƒˆใ‚’้–‹ใใ€ใƒœใ‚ฟใƒณใ‚’ๆ็คบใงใใพใ™ใ€‚
167
173
 
168
174
  ใƒ•ใƒซใƒšใƒผใ‚ธ chat ใ‹ใ‚‰ app ใƒšใƒผใ‚ธใ‚’้–‹ใใจใใฏใ€[Agent Surfaces](/docs/agent-surfaces#rich-chat) ใฎ `AgentChatSurface`ใ€`AgentSidebar`ใ€`useAgentChatHomeHandoff`ใ€`useAgentChatHomeHandoffLinks`ใ€`chatViewTransition` ใ‚’ไฝฟใ„ใ€ๅŒใ˜ thread ใฎใพใพใƒใƒฃใƒƒใƒˆใ‚’ใ‚ตใ‚คใƒ‰ใƒใƒผใธ็งปๅ‹•ใ—ใพใ™ใ€‚
169
175
 
@@ -59,7 +59,7 @@ export const i18nCatalog = {
59
59
  ```
60
60
 
61
61
  ๅธธใซ `en-US` ใ‚’ใƒใƒณใƒ‰ใƒซใ—ใพใ™ใ€‚่‹ฑ่ชžไปฅๅค–ใฎใ‚ซใ‚ฟใƒญใ‚ฐใ‚’ๅ‹•็š„ใซใ‚คใƒณใƒใƒผใƒˆใงใใ‚‹ใŸใ‚ใ€ใƒฆใƒผใ‚ถใƒผใฎใฟ
62
- ใ‚ขใ‚ฏใƒ†ใ‚ฃใƒ–ใชใƒญใ‚ฑใƒผใƒซใ‚’ใƒ€ใ‚ฆใƒณใƒญใƒผใƒ‰ใ—ใพใ™ใ€‚ใ‚ตใƒใƒผใƒˆใ•ใ‚Œใฆใ„ใ‚‹ใƒญใ‚ฑใƒผใƒซ ใ‚ณใƒผใƒ‰ใฏใ€`en-US`ใ€`zh-CN`ใ€
62
+ ใ‚ขใ‚ฏใƒ†ใ‚ฃใƒ–ใชใƒญใ‚ฑใƒผใƒซใ‚’ใƒ€ใ‚ฆใƒณใƒญใƒผใƒ‰ใ—ใพใ™ใ€‚ใ‚ตใƒใƒผใƒˆใ•ใ‚Œใฆใ„ใ‚‹ใƒญใ‚ฑใƒผใƒซ ใ‚ณใƒผใƒ‰ใฏใ€`en-US`ใ€`zh-CN`ใ€`zh-TW`ใ€
63
63
  `es-ES`ใ€`fr-FR`ใ€`de-DE`ใ€`ja-JP`ใ€`ko-KR`ใ€`pt-BR`ใ€`hi-IN`ใ€ใŠใ‚ˆใณ `ar-SA`ใ€‚
64
64
 
65
65
  ## UI
@@ -0,0 +1,21 @@
1
+ ---
2
+ title: ใƒ‘ใƒƒใ‚ฑใƒผใ‚ธใฎใƒฉใ‚คใƒ•ใ‚ตใ‚คใ‚ฏใƒซ
3
+ description: ใƒžใƒ‹ใƒ•ใ‚งใ‚นใƒˆ้ง†ๅ‹•ใฎ Agent Native ใƒ‘ใƒƒใ‚ฑใƒผใ‚ธใ‚’ๅฎ‰ๅ…จใซ็ขบ่ชใ€่ฟฝๅŠ ใ€ๆŽ’ๅ‡บใ—ใพใ™ใ€‚
4
+ ---
5
+
6
+ # ใƒ‘ใƒƒใ‚ฑใƒผใ‚ธใฎใƒฉใ‚คใƒ•ใ‚ตใ‚คใ‚ฏใƒซ
7
+
8
+ ๅ†ๅˆฉ็”จๅฏ่ƒฝใชใƒ‘ใƒƒใ‚ฑใƒผใ‚ธใฏใ€ใƒใƒผใ‚ธใƒงใƒณไป˜ใใฎ้™็š„ใช
9
+ `agent-native.package.json` ใ‚’ๅ…ฌ้–‹ใงใใพใ™ใ€‚CLI ใฏๆคœๆŸปๆ™‚ใซใ“ใฎ JSON ใฎใฟใ‚’
10
+ ่ชญใฟใ€ใƒ‘ใƒƒใ‚ฑใƒผใ‚ธใ‚ณใƒผใƒ‰ใ‚’ๅฎŸ่กŒใ—ใพใ›ใ‚“ใ€‚
11
+
12
+ ```bash
13
+ agent-native package inspect @agent-native/scheduling --json
14
+ agent-native package add @agent-native/scheduling --apply
15
+ agent-native package eject @agent-native/scheduling --apply
16
+ ```
17
+
18
+ ่ฟฝๅŠ ใจๆŽ’ๅ‡บใฏๆ—ขๅฎšใงใƒ‰ใƒฉใ‚คใƒฉใƒณใงใ™ใ€‚`--apply` ใ‚’ๆŒ‡ๅฎšใ—ใŸๅ ดๅˆใ ใ‘ๆ›ธใ่พผใฟใจ
19
+ ใƒ‘ใƒƒใ‚ฑใƒผใ‚ธใƒžใƒใƒผใ‚ธใƒฃใƒผใ‚’ๅฎŸ่กŒใ—ใพใ™ใ€‚็ซถๅˆใ‚„ๆœช็Ÿฅใฎ้…็ฝฎใฏๆ‹’ๅฆใ—ใ€ใ‚คใƒณใ‚นใƒˆใƒผใƒซ
20
+ ๅคฑๆ•—ๆ™‚ใซใฏใƒ•ใ‚กใ‚คใƒซใจใƒญใƒƒใ‚ฏใƒ•ใ‚กใ‚คใƒซใ‚’ๅพฉๅ…ƒใ—ใพใ™ใ€‚ใƒ‘ใ‚คใƒญใƒƒใƒˆใงใฏ Scheduling
21
+ ใฎใฟๆŽ’ๅ‡บๅฏ่ƒฝใงใ€Pinpoint ใฏๅฏพ่ฑกๅค–ใงใ™ใ€‚
@@ -103,6 +103,10 @@ Agent-Native ใซใฏใ‚ขใƒ€ใƒ—ใ‚ฟใƒผใฎ็ถ™ใŽ็›ฎใŒ 2 ใคใ‚ใ‚Šใ€็‹ญใ„้ƒจๅˆ†ใฎ
103
103
  path: "index.ts",
104
104
  note: "้ธๆŠž: getSandboxAdapter() / registerSandboxAdapter()",
105
105
  },
106
+ {
107
+ path: "background.ts",
108
+ note: "่€ไน…ใ‚ญใƒฅใƒผใƒžใƒผใ‚ซใƒผใจใƒใƒƒใ‚ฏใ‚ฐใƒฉใ‚ฆใƒณใƒ‰ๅฎŸ่กŒใฎใƒฉใ‚คใƒ•ใ‚ตใ‚คใ‚ฏใƒซ",
109
+ },
106
110
  {
107
111
  path: "local-child-process-adapter.ts",
108
112
  note: "ใƒ‡ใƒ•ใ‚ฉใƒซใƒˆ backend: ๅˆถ้™ใ•ใ‚ŒใŸ Node ๅญใƒ—ใƒญใ‚ปใ‚น",
@@ -183,12 +187,17 @@ registerSandboxAdapter(adapter) โ†’ AGENT_NATIVE_SANDBOX โ†’ local default
183
187
 
184
188
  ### `AGENT_NATIVE_SANDBOX` ็’ฐๅขƒๅค‰ๆ•ฐ {#env}
185
189
 
186
- ID ใซใ‚ˆใฃใฆ็ต„ใฟ่พผใฟใ‚ขใƒ€ใƒ—ใ‚ฟใƒผใ‚’้ธๆŠžใ—ใพใ™ใ€‚็พๅœจใ€`local` (ใƒ‡ใƒ•ใ‚ฉใƒซใƒˆ) ใฎใฟใŒ้…็ทšใ•ใ‚Œใฆใ„ใพใ™ใ€‚ไธๆ˜Žใชๅ€คใฏๅฎŸ่กŒใซๅคฑๆ•—ใ™ใ‚‹ใฎใงใฏใชใใ€ใƒญใƒผใ‚ซใƒซใซใƒ•ใ‚ฉใƒผใƒซใƒใƒƒใ‚ฏใ—ใพใ™ใ€‚
190
+ ID ใซใ‚ˆใฃใฆ็ต„ใฟ่พผใฟใ‚ขใƒ€ใƒ—ใ‚ฟใƒผใ‚’้ธๆŠžใ—ใพใ™ใ€‚`local`๏ผˆใƒ‡ใƒ•ใ‚ฉใƒซใƒˆ๏ผ‰ใจ `background` ใฎไธกๆ–นใŒ้…็ทšใ•ใ‚Œใฆใ„ใพใ™ใ€‚ไธๆ˜Žใชๅ€คใฏๅฎŸ่กŒใซๅคฑๆ•—ใ™ใ‚‹ใฎใงใฏใชใ `local` ใซใƒ•ใ‚ฉใƒผใƒซใƒใƒƒใ‚ฏใ—ใพใ™ใ€‚
187
191
 
188
192
  ```bash
189
- AGENT_NATIVE_SANDBOX=local # ใƒ‡ใƒ•ใ‚ฉใƒซใƒˆ โ€” ๆ˜Ž็คบ็š„
193
+ AGENT_NATIVE_SANDBOX=local # ใƒ‡ใƒ•ใ‚ฉใƒซใƒˆ โ€” ๆ˜Ž็คบ็š„
194
+ AGENT_NATIVE_SANDBOX=background # ใ™ในใฆใฎ run-code ๅ‘ผใณๅ‡บใ—ใ‚’่€ไน…ใ‚ญใƒฅใƒผใซๅ…ฅใ‚Œใ‚‹
190
195
  ```
191
196
 
197
+ `background` ใฏ็”Ÿใฎใ‚ณใƒผใƒ‰ใ‚’ `sandbox_executions` ใซไฟๅญ˜ใ—ใ€`status: "queued"` ใจ `executionId` ใ‚’ใ™ใใซ่ฟ”ใ—ใพใ™ใ€‚็ฝฒๅไป˜ใใ‚ปใƒซใƒ•ใƒ‡ใ‚ฃใ‚นใƒ‘ใƒƒใƒใฏๆ–ฐใ—ใ„ serverless ๅ‘ผใณๅ‡บใ—ใ‚’้–‹ๅง‹ใ—ใ€้•ทๆ™‚้–“็จผๅƒใ™ใ‚‹ Node ใฏใƒ—ใƒญใ‚ปใ‚นๅ†…ใงๅˆ‡ใ‚Š้›ขใ—ใŸๅ‡ฆ็†ใ‚’้–‹ๅง‹ใ—ใพใ™ใ€‚ใ‚นใƒ†ใƒผใ‚ฟใ‚นใƒใƒผใƒชใƒณใ‚ฐใจๅฎšๆœŸ sweep ใฏใ€ๅคฑใ‚ใ‚ŒใŸใƒ‡ใ‚ฃใ‚นใƒ‘ใƒƒใƒใ‚„ๆœŸ้™ๅˆ‡ใ‚Œใฎ lease ใ‚’ๅ†ๅฎŸ่กŒใ—ใพใ™ใ€‚ๆฐธ็ถšๅŒ–ใ•ใ‚ŒใŸ็ตๆžœใฏๅพŒใ‹ใ‚‰ๅฎŸ่กŒใ‚’ใƒใƒผใƒชใƒณใ‚ฐใ—ใฆๅ–ๅพ—ใ—ใพใ™ใ€‚
198
+
199
+ `BackgroundQueueAdapter` ใฏ่€ไน…ใ‚ญใƒฅใƒผใฎใƒžใƒผใ‚ซใƒผใงใ‚ใ‚Šใ€executor ใงใฏใ‚ใ‚Šใพใ›ใ‚“ใ€‚ใ‚ญใƒฅใƒผๅ†…ใฎๅ‡ฆ็†ใฏใ€ๅˆฉ็”จๅฏ่ƒฝใชใ‚‰็™ป้Œฒๆธˆใฟใฎ้žใ‚ญใƒฅใƒผๅฎŸ่กŒใ‚ขใƒ€ใƒ—ใ‚ฟใƒผใ‚’ไฝฟใ„ใ€ใใ‚Œไปฅๅค–ใฏใƒญใƒผใ‚ซใƒซๅญใƒ—ใƒญใ‚ปใ‚นใซใƒ•ใ‚ฉใƒผใƒซใƒใƒƒใ‚ฏใ—ใพใ™ใ€‚`background` ใ ใ‘ใ‚’้ธๆŠžใ—ใฆใ‚‚ใƒชใƒขใƒผใƒˆๅˆ†้›ขใ‚„ใ‚ณใƒณใƒ†ใƒŠๅˆ†้›ขใฏๆไพ›ใ•ใ‚Œใšใ€edge ใƒฉใƒณใ‚ฟใ‚คใƒ ใŒ `node:child_process` ใซๅฏพๅฟœใ™ใ‚‹ใ‚ใ‘ใงใ‚‚ใ‚ใ‚Šใพใ›ใ‚“ใ€‚
200
+
192
201
  ### `registerSandboxAdapter()` {#register}
193
202
 
194
203
  ใƒ›ใ‚นใƒˆ ใƒ—ใƒญใ‚ปใ‚นใฏใ€ใ‚ทใƒผใƒ ใฎ `index.ts` ใ‚’ไป‹ใ—ใŸๅพŒ็ถšใฎใ™ในใฆใฎ `run-code` ๅ‘ผใณๅ‡บใ—ใฎใƒใƒƒใ‚ฏใ‚จใƒณใƒ‰ใ‚’ใ‚ชใƒผใƒใƒผใƒฉใ‚คใƒ‰ใ—ใพใ™ใ€‚ใŸใจใˆใฐใ€ใƒชใƒขใƒผใƒˆ ใ‚ณใƒณใƒ†ใƒŠใƒผใงใ™ในใฆใฎๅ‘ผใณๅ‡บใ—ใ‚’ๅฎŸ่กŒใ—ใพใ™ใ€‚
@@ -213,13 +222,15 @@ registerSandboxAdapter(new RemoteSandboxAdapter());
213
222
 
214
223
  ## ่€ไน…ๆ€งใฎใ‚ใ‚‹ใƒฉใƒณใƒŠใƒผใฎใŸใ‚ใฎ็ธซใ„็›ฎ {#durable}
215
224
 
216
- ใ“ใฎใ‚คใƒณใ‚ฟใƒผใƒ•ใ‚งใ‚คใ‚นใฏใ€ๅฐ†ๆฅใฎใƒชใƒขใƒผใƒˆ/่€ไน…ๆ€งใฎใ‚ใ‚‹ใ‚ตใƒณใƒ‰ใƒœใƒƒใ‚ฏใ‚นใฎ็ถ™ใŽ็›ฎใจใ—ใฆๆ„ๅ›ณ็š„ใซไฝœใ‚‰ใ‚Œใฆใ„ใพใ™ใ€‚ใƒชใƒขใƒผใƒˆใพใŸใฏ่€ไน…ๆ€งใฎใ‚ใ‚‹ใ‚ขใƒ€ใƒ—ใ‚ฟใƒผ (Dockerใ€Vercel-Sandbox ใ‚นใ‚ฟใ‚คใƒซใฎใƒฉใƒณใƒŠใƒผใ€ใพใŸใฏใ‚ญใƒฅใƒผใซๅ…ฅใ‚Œใ‚‰ใ‚ŒใŸใƒใƒƒใ‚ฏใ‚ฐใƒฉใ‚ฆใƒณใƒ‰ ใƒฏใƒผใ‚ซใƒผ) ใฏๆฌกใฎใจใŠใ‚Šใงใ™ใ€‚
225
+ ็ต„ใฟ่พผใฟใฎ `background` ใ‚ขใƒ€ใƒ—ใ‚ฟใƒผใฏใ€ใ™ใงใซ่€ไน…ใ‚ญใƒฅใƒผใจๆ–ฐใ—ใ„ๅฎŸ่กŒไบˆ็ฎ—ใ‚’ๆไพ›ใ—ใพใ™ใ€‚ไธ€ๆ–นใ€ๅฎŸ้š›ใฎๅฎŸ่กŒใซใฏๅผ•ใ็ถšใ้žใ‚ญใƒฅใƒผใ‚ขใƒ€ใƒ—ใ‚ฟใƒผใพใŸใฏใƒญใƒผใ‚ซใƒซๅญใƒ—ใƒญใ‚ปใ‚นใฎใƒ•ใ‚ฉใƒผใƒซใƒใƒƒใ‚ฏใŒไฝฟใ‚ใ‚Œใพใ™ใ€‚ๅˆฅ้€”็™ป้Œฒใ—ใŸใƒชใƒขใƒผใƒˆใพใŸใฏๅˆ†้›ขใ‚ขใƒ€ใƒ—ใ‚ฟใƒผ๏ผˆDocker ใ‚„ Vercel-Sandbox ใ‚นใ‚ฟใ‚คใƒซใฎใƒฉใƒณใƒŠใƒผ๏ผ‰ใฏใ€็•ฐใชใ‚‹ๅฎŸ่กŒๅขƒ็•Œใ‚’ๆไพ›ใ—ใ€ๅ‘ผใณๅ‡บใ—ใ”ใจใฎใƒใƒƒใ‚ฏใ‚ฐใƒฉใ‚ฆใƒณใƒ‰ๅ‡ฆ็†ใ‚‚ๅฎŸ่กŒใงใใพใ™ใ€‚
226
+
227
+ ใ“ใฎใ‚ˆใ†ใชใ‚ขใƒ€ใƒ—ใ‚ฟใƒผใฏๆฌกใ‚’่กŒใ„ใพใ™ใ€‚
217
228
 
218
229
  1. ใ‚ขใ‚ฆใƒˆใƒ—ใƒญใ‚ปใ‚น ใƒฉใƒณใ‚ฟใ‚คใƒ ใซๅฏพใ—ใฆ `SandboxAdapter.run` ใ‚’ๅฎŸ่ฃ…ใ—ใพใ™ใ€‚
219
- 2. ใƒซใƒผใƒ—ใƒใƒƒใ‚ฏ ใƒ–ใƒชใƒƒใ‚ธใ‚’ใƒˆใƒณใƒใƒซใ—ใพใ™ (ใพใŸใฏใƒ—ใƒญใ‚ญใ‚ท ใƒ–ใƒชใƒƒใ‚ธใŒ่ฆชใซใ‚ณใƒผใƒซใƒใƒƒใ‚ฏใ—ใพใ™)ใ€‚
220
- 3. ๅคง่ฆๆจกใชใƒ‡ใƒผใ‚ฟ ใ‚ธใƒงใƒ–ใ‚’ใ€ใƒชใ‚ฏใ‚จใ‚นใƒˆใฎใƒฉใ‚คใƒ•ใ‚ตใ‚คใ‚ฏใƒซใจใฏ็‹ฌ็ซ‹ใ—ใฆๅฎŒไบ†ใพใงๅฎŸ่กŒใ—ใพใ™ใ€‚ใ“ใ‚Œใฏใ€ใƒญใƒผใ‚ซใƒซใฎๅญใƒ—ใƒญใ‚ปใ‚น ใ‚ขใƒ€ใƒ—ใ‚ฟใƒผใ‚’ๅˆถ้™ใ™ใ‚‹ใ€ใƒ›ใ‚นใƒˆใ•ใ‚ŒใŸใ‚ณใƒผใƒ‰ๅฎŸ่กŒใฎๆœ€ๅคง 40 ็ง’ใฎไธŠ้™ใ‚’่ถ…ใˆใพใ™ใ€‚
230
+ 2. ใƒซใƒผใƒ—ใƒใƒƒใ‚ฏใƒ–ใƒชใƒƒใ‚ธใ‚’ใƒˆใƒณใƒใƒซใ™ใ‚‹ใ‹ใ€ใใฎๅ‘ผใณๅ‡บใ—ใ‚’่ฆชใƒ—ใƒญใ‚ปใ‚นใธใƒ—ใƒญใ‚ญใ‚ทใ—ใพใ™ใ€‚
231
+ 3. ๆไพ›ๆธˆใฟใฎ่€ไน…ใ‚ญใƒฅใƒผใฎใƒฉใ‚คใƒ•ใ‚ตใ‚คใ‚ฏใƒซใจใฏ็‹ฌ็ซ‹ใ—ใฆใ€ใƒชใƒขใƒผใƒˆๅˆ†้›ขใพใŸใฏใ‚ณใƒณใƒ†ใƒŠๅˆ†้›ขใ‚’ๆไพ›ใ—ใพใ™ใ€‚
221
232
 
222
- ๆ–ฐใ—ใ„ `AGENT_NATIVE_SANDBOX` ๅ€ค (ไพ‹: `remote`) ใŠใ‚ˆใณ/ใพใŸใฏ `registerSandboxAdapter()` ็ตŒ็”ฑใง็™ป้Œฒใ—ใพใ™ใ€‚ใ‚จใƒผใ‚ธใ‚งใƒณใƒˆ ใƒซใƒผใƒ—ใจ `run-code.ts` ใฏๆฑบใ—ใฆๅค‰ใ‚ใ‚Šใพใ›ใ‚“ใ€‚
233
+ `registerSandboxAdapter()` ใ‚’ไฝฟใฃใฆใƒ—ใƒญใ‚ฐใƒฉใƒ ใ‹ใ‚‰็™ป้Œฒใ—ใพใ™ใ€‚ใ‚จใƒผใ‚ธใ‚งใƒณใƒˆใƒซใƒผใƒ—ใจ `run-code.ts` ใ‚’ๅค‰ๆ›ดใ™ใ‚‹ๅฟ…่ฆใฏใ‚ใ‚Šใพใ›ใ‚“ใ€‚
223
234
 
224
235
  > [!TIP]
225
236
  > `agent-native add sandbox docker` ใƒ–ใƒซใƒผใƒ—ใƒชใƒณใƒˆใฏใ€ใ“ใฎใ‚ทใƒผใƒ ใซๅฏพใ—ใฆ Docker ใ‚ขใƒ€ใƒ—ใ‚ฟใƒผใ‚’ๅฎŸ่ฃ…ใ™ใ‚‹ใŸใ‚ใฎๅฎŒๅ…จใช่‡ชๅทฑๅฎŒ็ตๅž‹ใƒฌใ‚ทใƒ”ใ‚’็”Ÿๆˆใ—ใพใ™ใ€‚ [Blueprint Installer](/docs/blueprint-installer) ใ‚’ๅ‚็…งใ—ใฆใใ ใ•ใ„ใ€‚
@@ -417,3 +417,11 @@ AGENT_NATIVE_KEYS_WORKSPACE_FALLBACK=1
417
417
  ```
418
418
 
419
419
  ใƒฏใƒผใ‚ฏใ‚นใƒšใƒผใ‚น ใ‚นใ‚ณใƒผใƒ—ใฎใ‚ทใƒผใ‚ฏใƒฌใƒƒใƒˆใฎๆ›ธใ่พผใฟใซใฏใ€ใ“ใฎใƒ•ใƒฉใ‚ฐใซ้–ขไฟ‚ใชใใ€็ต„็น”ใฎๆ‰€ๆœ‰่€…/็ฎก็†่€…ใฎใƒญใƒผใƒซใŒๅฟ…่ฆใงใ™ใ€‚
420
+
421
+ ## ๆฌกใฎใ‚นใƒ†ใƒƒใƒ—
422
+
423
+ - [**Authentication**](/docs/authentication) โ€” ใ“ใฎใƒšใƒผใ‚ธใŒๅ‰ๆใจใ™ใ‚‹่ช่จผใƒขใƒผใƒ‰ใ€cookie realmใ€ใ‚ปใƒƒใ‚ทใƒงใƒณใฎ่ฉณ็ดฐ
424
+ - [**Multi-Tenancy**](/docs/multi-tenancy) โ€” `org_id` ใ‚นใ‚ณใƒผใƒ”ใƒณใ‚ฐใฎ่ƒŒๅพŒใซใ‚ใ‚‹็ต„็น”ใƒกใƒณใƒใƒผใ‚ทใƒƒใƒ—ใƒขใƒ‡ใƒซ
425
+ - [**Sharing**](/docs/sharing) โ€” ๅ…ฑๆœ‰ๅฏ่ƒฝใชใƒชใ‚ฝใƒผใ‚นใซ้ฉ็”จใ•ใ‚Œใ‚‹ `ownableColumns()` ใจใ‚ขใ‚ฏใ‚ปใ‚นใ‚ฌใƒผใƒ‰ใฎใƒ‘ใ‚ฟใƒผใƒณ
426
+ - [**Messaging**](/docs/messaging#env-vars) โ€” ไธŠใฎใƒใ‚งใƒƒใ‚ฏใƒชใ‚นใƒˆใงๅ‚็…งใ•ใ‚Œใฆใ„ใ‚‹็ตฑๅˆใ”ใจใฎ webhook ็ฝฒๅใ‚ทใƒผใ‚ฏใƒฌใƒƒใƒˆ
427
+ - [**Deployment**](/docs/deployment) โ€” ใ“ใฎใƒใ‚งใƒƒใ‚ฏใƒชใ‚นใƒˆใŒ่จญๅฎšๆธˆใฟใงใ‚ใ‚‹ใ“ใจใ‚’ๅ‰ๆใจใ™ใ‚‹ๆœฌ็•ช็’ฐๅขƒๅค‰ๆ•ฐ
@@ -73,10 +73,11 @@ export default defineAction({
73
73
 
74
74
  ## ํŠธ๋ ˆ์ผ ์ฝ๊ธฐ {#reading}
75
75
 
76
- 2๊ฐœ์˜ ์ฝ๊ธฐ actions๋Š” ์—์ด์ „ํŠธ **๋ฐ** ํ˜ธ์ถœ์ž์—๊ฒŒ SQL ๋ฒ”์œ„๋กœ ์ง€์ •๋œ ๋ชจ๋“  ์•ฑ์˜ ํ”„๋ŸฐํŠธ์—”๋“œ์—์„œ ์‚ฌ์šฉํ•  ์ˆ˜ ์žˆ์œผ๋ฉฐ ๋‹ค๋ฅธ ํ…Œ๋„ŒํŠธ์˜ ํ–‰์„ ๋ฐ˜ํ™˜ํ•˜์ง€ ์•Š์Šต๋‹ˆ๋‹ค.
76
+ 3๊ฐœ์˜ ์ฝ๊ธฐ actions๋Š” ์—์ด์ „ํŠธ **๋ฐ** ํ˜ธ์ถœ์ž์—๊ฒŒ SQL ๋ฒ”์œ„๋กœ ์ง€์ •๋œ ๋ชจ๋“  ์•ฑ์˜ ํ”„๋ŸฐํŠธ์—”๋“œ์—์„œ ์‚ฌ์šฉํ•  ์ˆ˜ ์žˆ์œผ๋ฉฐ ๋‹ค๋ฅธ ํ…Œ๋„ŒํŠธ์˜ ํ–‰์„ ๋ฐ˜ํ™˜ํ•˜์ง€ ์•Š์Šต๋‹ˆ๋‹ค.
77
77
 
78
78
  - **`list-audit-events`** โ€” `targetType` / `targetId`, `actorKind`(`agent` | `human` | `system`), `status`, `threadId` / `turnId`, `action`๋กœ ํ•„ํ„ฐ๋ง, `sinceMs` ๋ฐ `limit`.
79
79
  - **`get-audit-event`** โ€” ์ˆ˜์ •๋œ ์ž…๋ ฅ ํŽ˜์ด๋กœ๋“œ๋ฅผ ํฌํ•จํ•˜์—ฌ ID๋ณ„ ์ด๋ฒคํŠธ 1๊ฐœ.
80
+ - **`export-audit-events`** โ€” `list-audit-events`๋ฅผ ์ˆ˜๋™์œผ๋กœ ํŽ˜์ด์ง•ํ•˜๋Š” ๋Œ€์‹  ์ถ”์  ๊ธฐ๋ก์„ CSV ๋˜๋Š” NDJSON์œผ๋กœ ์ผ๊ด„ ๋‚ด๋ณด๋‚ด๋ฉฐ, ์˜คํ”„๋ผ์ธ ๊ทœ์ • ์ค€์ˆ˜ ํ™•์ธ์šฉ์ž…๋‹ˆ๋‹ค. `list-audit-events`์™€ ๋™์ผํ•œ ํ•„ํ„ฐ(`limit` ์ œ์™ธ)์— `format`(`csv` | `ndjson`, ๊ธฐ๋ณธ๊ฐ’ `csv`)๊ณผ `maxRows`(๊ธฐ๋ณธ๊ฐ’ 5000, ์ƒํ•œ 10000)๋ฅผ ์ถ”๊ฐ€๋กœ ๋ฐ›์œผ๋ฉฐ, `{ content, rowCount, truncated, format }`์„ ๋ฐ˜ํ™˜ํ•ฉ๋‹ˆ๋‹ค โ€” `truncated: true`๋Š” `maxRows`๊ฐ€ ํ—ˆ์šฉํ•œ ๊ฒƒ๋ณด๋‹ค ๋” ๋งŽ์€ ํ–‰์ด ์ผ์น˜ํ–ˆ์Œ์„ ์˜๋ฏธํ•ฉ๋‹ˆ๋‹ค. ์ด ์ž์ฒด๋„ ๋ฏผ๊ฐํ•œ ์ฝ๊ธฐ์ด๋ฉฐ `audit: { onRead: true }`๋ฅผ ํ†ตํ•ด ๊ฐ์‚ฌ๋ฉ๋‹ˆ๋‹ค.
80
81
 
81
82
  `useActionQuery`๋ฅผ ์‚ฌ์šฉํ•˜์—ฌ UI์—์„œ `list-audit-events`๋ฅผ ํ˜ธ์ถœํ•˜์—ฌ ํ™œ๋™ ํ”ผ๋“œ ๋˜๋Š” "์ด ํ•ญ๋ชฉ์„ ๋ณ€๊ฒฝํ•œ ์‚ฌ๋žŒ" ์ค„์„ ์ž‘์„ฑํ•ฉ๋‹ˆ๋‹ค. ๊ฐ์‚ฌ ํ…Œ์ด๋ธ”์— ๊ฐ€์ ธ์˜ค๊ธฐ๋ฅผ ์ง์ ‘ ์ž‘์„ฑํ•˜์ง€ ๋งˆ์„ธ์š”.
82
83
 
@@ -114,13 +114,13 @@ description: "์ž์—ฐ์–ด ์กฐ๊ฑด์„ ์‚ฌ์šฉํ•œ ์ด๋ฒคํŠธ ํŠธ๋ฆฌ๊ฑฐ ๋ฐ ์˜ˆ์•ฝ ์ž
114
114
 
115
115
  ์ž๋™ํ™”๋Š” [recurring-jobs frontmatter table](/docs/recurring-jobs#frontmatter)์˜ ๋ชจ๋“  ํ•„๋“œ๋ฅผ ๊ณต์œ ํ•ฉ๋‹ˆ๋‹ค. ๋‹ค์Œ ์ถ”๊ฐ€ ํ•„๋“œ๋Š” ์ด๋ฒคํŠธ ํŠธ๋ฆฌ๊ฑฐ, ์กฐ๊ฑด ๋ฐ ์‹คํ–‰ ๋ชจ๋“œ๋ฅผ ์ œ์–ดํ•ฉ๋‹ˆ๋‹ค.
116
116
 
117
- | ํ•„๋“œ | ์œ ํ˜• | ๊ธฐ๋ณธ๊ฐ’ | ์„ค๋ช… |
118
- | ------------- | -------------------------------- | ------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
119
- | `triggerType` | `"schedule"` \| `"event"` | `"schedule"` | ์ž๋™ํ™” ์‹คํ–‰ ๋ฐฉ๋ฒ• |
120
- | `event` | ๋ฌธ์ž์—ด | _(์„ ํƒ์‚ฌํ•ญ)_ | ๊ตฌ๋…ํ•  ์ด๋ฒคํŠธ ์ด๋ฆ„(์ด๋ฒคํŠธ ํŠธ๋ฆฌ๊ฑฐ์—๋งŒ ํ•ด๋‹น) |
121
- | `condition` | ๋ฌธ์ž์—ด | _(์„ ํƒ์‚ฌํ•ญ)_ | ๋ฐฐ์†ก ์ „ ์ž์—ฐ์–ด ์กฐ๊ฑด ํ‰๊ฐ€ |
122
- | `mode` | `"agentic"` \| `"deterministic"` | `"agentic"` | ์ „์ฒด ์—์ด์ „ํŠธ ๋ฃจํ”„. (`"deterministic"`๋Š” ์˜ˆ์•ฝ๋˜์–ด ์žˆ์ง€๋งŒ ์•„์ง ๊ตฌํ˜„๋˜์ง€ ์•Š์•˜์Šต๋‹ˆ๋‹ค. ์ด๋ฅผ ์„ค์ •ํ•œ ์ž๋™ํ™”๋Š” ๊ฑด๋„ˆ๋œ๋‹ˆ๋‹ค. ๋ชจ๋“  ํ˜„์žฌ ์ž๋™ํ™”์—๋Š” `"agentic"`๋ฅผ ์‚ฌ์šฉํ•˜์„ธ์š”.) |
123
- | `domain` | ๋ฌธ์ž์—ด | _(์„ ํƒ์‚ฌํ•ญ)_ | ๊ทธ๋ฃนํ™” ํƒœ๊ทธ(๋ฉ”์ผ, ์บ˜๋ฆฐ๋”, ํด๋ฆฝ ๋“ฑ) |
117
+ | ํ•„๋“œ | ์œ ํ˜• | ๊ธฐ๋ณธ๊ฐ’ | ์„ค๋ช… |
118
+ | ------------- | ------------------------- | ------------ | ----------------------------------------------------------------------------------------------------------------------------------------------- |
119
+ | `triggerType` | `"schedule"` \| `"event"` | `"schedule"` | ์ž๋™ํ™” ์‹คํ–‰ ๋ฐฉ๋ฒ• |
120
+ | `event` | ๋ฌธ์ž์—ด | _(์„ ํƒ์‚ฌํ•ญ)_ | ๊ตฌ๋…ํ•  ์ด๋ฒคํŠธ ์ด๋ฆ„(์ด๋ฒคํŠธ ํŠธ๋ฆฌ๊ฑฐ์—๋งŒ ํ•ด๋‹น) |
121
+ | `condition` | ๋ฌธ์ž์—ด | _(์„ ํƒ์‚ฌํ•ญ)_ | ๋ฐฐ์†ก ์ „ ์ž์—ฐ์–ด ์กฐ๊ฑด ํ‰๊ฐ€ |
122
+ | `mode` | `"agentic"` | `"agentic"` | ์ „์ฒด ์—์ด์ „ํŠธ ๋ฃจํ”„(์œ ์ผํ•˜๊ฒŒ ์ง€์›๋˜๋Š” ๋ชจ๋“œ). `"deterministic"`๋Š” ์ œ๊ฑฐ๋˜์—ˆ์Šต๋‹ˆ๋‹ค โ€” ๊ตฌํ˜„๋œ ์ ์ด ์—†์œผ๋ฉฐ, ์ด๋ฅผ ์„ค์ •ํ•œ ์ž๋™ํ™”๋Š” ์‹คํ–‰๋œ ์ ์ด ์—†์Šต๋‹ˆ๋‹ค. |
123
+ | `domain` | ๋ฌธ์ž์—ด | _(์„ ํƒ์‚ฌํ•ญ)_ | ๊ทธ๋ฃนํ™” ํƒœ๊ทธ(๋ฉ”์ผ, ์บ˜๋ฆฐ๋”, ํด๋ฆฝ ๋“ฑ) |
124
124
 
125
125
  ์ด๋ฒคํŠธ ํŠธ๋ฆฌ๊ฑฐ์˜ ๊ฒฝ์šฐ `schedule`๋Š” `""`(๋น„์–ด ์žˆ์Œ)์ž…๋‹ˆ๋‹ค. ์ผ์ • ํŠธ๋ฆฌ๊ฑฐ์˜ ๊ฒฝ์šฐ cron ํ‘œํ˜„์‹์„ ์ „๋‹ฌํ•ฉ๋‹ˆ๋‹ค. ๋˜ํ•œ ๋””์ŠคํŒจ์ฒ˜๋Š” ์Šค์ผ€์ค„๋Ÿฌ์™€ ๋™์ผํ•œ ๊ด€๋ฆฌํ˜• `lastRun` / `lastStatus` / `lastError` ํ•„๋“œ๋ฅผ ์ž‘์„ฑํ•˜๊ณ  ์กฐ๊ฑด์ด false๋กœ ํ‰๊ฐ€๋˜๋ฉด `"skipped"` ์ƒํƒœ๋„ ์ž‘์„ฑํ•ฉ๋‹ˆ๋‹ค.
126
126
 
@@ -163,7 +163,13 @@ export const responseInsights = table("response_insights", {
163
163
  />
164
164
  </WireframeBlock>
165
165
 
166
- `view-screen`๊ณผ `navigate`๋ฅผ ํ™•์žฅํ•ด agent๊ฐ€ ํ˜„์žฌ route๋ฅผ ์•Œ๊ณ  `/response-insights`๋ฅผ ์—ด ์ˆ˜ ์žˆ๊ฒŒ ํ•ฉ๋‹ˆ๋‹ค. ๊ฒฐ๊ณผ์— `href: "/response-insights"`๋ฅผ ๋„ฃ์œผ๋ฉด ์ฑ„ํŒ…์— "์‘๋‹ต ์ธ์‚ฌ์ดํŠธ ์—ด๊ธฐ" ๋ฒ„ํŠผ์„ ํ‘œ์‹œํ•  ์ˆ˜ ์žˆ์Šต๋‹ˆ๋‹ค.
166
+ ## 6. agent๊ฐ€ ํƒ์ƒ‰ํ•˜๊ฒŒ ํ•˜๊ธฐ {#agent-navigation}
167
+
168
+ Chat ํ…œํ”Œ๋ฆฟ์—๋Š” `view-screen`๊ณผ `navigate` action์ด ํฌํ•จ๋˜์–ด ์žˆ์Šต๋‹ˆ๋‹ค. ์•ฑ์ด ์„ฑ์žฅํ•จ์— ๋”ฐ๋ผ ์ด๋ฅผ ํ™•์žฅํ•˜์„ธ์š”:
169
+
170
+ - `view-screen`์€ application state๋ฅผ ์ฝ์–ด ํ˜„์žฌ route, ์„ ํƒ๋œ insight, ํ™œ์„ฑ ํ•„ํ„ฐ, agent์—๊ฒŒ ํ•„์š”ํ•œ ๊ฐ„๊ฒฐํ•œ ํŽ˜์ด์ง€ ์ปจํ…์ŠคํŠธ๋ฅผ ๋ฐ˜ํ™˜ํ•ด์•ผ ํ•ฉ๋‹ˆ๋‹ค.
171
+ - `navigate`๋Š” agent๊ฐ€ ์‚ฌ์šฉ์ž์—๊ฒŒ ๊ฒฐ๊ณผ๋ฅผ ์‹œ๊ฐ์ ์œผ๋กœ ํ™•์ธ์‹œ์ผœ์•ผ ํ•œ๋‹ค๊ณ  ํŒ๋‹จํ•  ๋•Œ `/response-insights`์™€ ๊ฐ™์€ same-origin ๊ฒฝ๋กœ๋ฅผ ๊ธฐ๋กํ•ด์•ผ ํ•ฉ๋‹ˆ๋‹ค.
172
+ - action ๊ฒฐ๊ณผ์—๋Š” `href: "/response-insights"` ๊ฐ™์€ ๋งํฌ๋ฅผ ํฌํ•จํ•  ์ˆ˜ ์žˆ์–ด, chat์ด ๋ช…์‹œ์ ์ธ "์‘๋‹ต ์ธ์‚ฌ์ดํŠธ ์—ด๊ธฐ" ๋ฒ„ํŠผ์„ ์ œ๊ณตํ•  ์ˆ˜ ์žˆ์Šต๋‹ˆ๋‹ค.
167
173
 
168
174
  ์ „์ฒด ํŽ˜์ด์ง€ chat์—์„œ app ํŽ˜์ด์ง€๋ฅผ ์—ด ๋•Œ๋Š” [Agent Surfaces](/docs/agent-surfaces#rich-chat)์˜ `AgentChatSurface`, `AgentSidebar`, `useAgentChatHomeHandoff`, `useAgentChatHomeHandoffLinks`, `chatViewTransition`์„ ์‚ฌ์šฉํ•ด ๊ฐ™์€ thread๋ฅผ ์œ ์ง€ํ•œ ์ฑ„ chat์„ ์‚ฌ์ด๋“œ๋ฐ”๋กœ ์ด๋™์‹œํ‚ต๋‹ˆ๋‹ค.
169
175
 
@@ -59,7 +59,7 @@ export const i18nCatalog = {
59
59
  ```
60
60
 
61
61
  ํ•ญ์ƒ `en-US`๋ฅผ ๋ฒˆ๋“ค๋กœ ๋ฌถ์œผ์„ธ์š”. ์˜์–ด๊ฐ€ ์•„๋‹Œ ์นดํƒˆ๋กœ๊ทธ๋ฅผ ๋™์  ๊ฐ€์ ธ์˜ค๊ธฐํ•˜์—ฌ ์‚ฌ์šฉ์ž๋งŒ
62
- ํ™œ์„ฑ ๋กœ์บ˜์„ ๋‹ค์šด๋กœ๋“œํ•ฉ๋‹ˆ๋‹ค. ์ง€์›๋˜๋Š” ๋กœ์บ˜ ์ฝ”๋“œ๋Š” `en-US`, `zh-CN`,
62
+ ํ™œ์„ฑ ๋กœ์บ˜์„ ๋‹ค์šด๋กœ๋“œํ•ฉ๋‹ˆ๋‹ค. ์ง€์›๋˜๋Š” ๋กœ์บ˜ ์ฝ”๋“œ๋Š” `en-US`, `zh-CN`, `zh-TW`,
63
63
  `es-ES`, `fr-FR`, `de-DE`, `ja-JP`, `ko-KR`, `pt-BR`, `hi-IN` ๋ฐ `ar-SA`.
64
64
 
65
65
  ## UI
@@ -0,0 +1,20 @@
1
+ ---
2
+ title: ํŒจํ‚ค์ง€ ์ˆ˜๋ช… ์ฃผ๊ธฐ
3
+ description: ๋งค๋‹ˆํŽ˜์ŠคํŠธ ๊ธฐ๋ฐ˜ Agent Native ํŒจํ‚ค์ง€๋ฅผ ์•ˆ์ „ํ•˜๊ฒŒ ๊ฒ€์‚ฌํ•˜๊ณ  ์ถ”๊ฐ€ํ•˜๊ฑฐ๋‚˜ ๊บผ๋ƒ…๋‹ˆ๋‹ค.
4
+ ---
5
+
6
+ # ํŒจํ‚ค์ง€ ์ˆ˜๋ช… ์ฃผ๊ธฐ
7
+
8
+ ์žฌ์‚ฌ์šฉ ํŒจํ‚ค์ง€๋Š” ๋ฒ„์ „์ด ์ง€์ •๋œ ์ •์  `agent-native.package.json`์„ ๊ฒŒ์‹œํ•  ์ˆ˜
9
+ ์žˆ์Šต๋‹ˆ๋‹ค. CLI๋Š” ๊ฒ€์‚ฌ ์ค‘ ์ด JSON๋งŒ ์ฝ๊ณ  ํŒจํ‚ค์ง€ ์ฝ”๋“œ๋ฅผ ์‹คํ–‰ํ•˜์ง€ ์•Š์Šต๋‹ˆ๋‹ค.
10
+
11
+ ```bash
12
+ agent-native package inspect @agent-native/scheduling --json
13
+ agent-native package add @agent-native/scheduling --apply
14
+ agent-native package eject @agent-native/scheduling --apply
15
+ ```
16
+
17
+ ์ถ”๊ฐ€์™€ ๊บผ๋‚ด๊ธฐ๋Š” ๊ธฐ๋ณธ์ ์œผ๋กœ ๋ฏธ๋ฆฌ ๋ณด๊ธฐ์ž…๋‹ˆ๋‹ค. `--apply`๋ฅผ ์ง€์ •ํ•ด์•ผ ํŒŒ์ผ์„ ์“ฐ๊ณ 
18
+ ํŒจํ‚ค์ง€ ๊ด€๋ฆฌ์ž๋ฅผ ์‹คํ–‰ํ•ฉ๋‹ˆ๋‹ค. ์ถฉ๋Œ๊ณผ ์•Œ ์ˆ˜ ์—†๋Š” ๋ ˆ์ด์•„์›ƒ์€ ๊ฑฐ๋ถ€ํ•˜๋ฉฐ ์„ค์น˜๊ฐ€
19
+ ์‹คํŒจํ•˜๋ฉด ํŒŒ์ผ๊ณผ ์ž ๊ธˆ ํŒŒ์ผ์„ ๋ณต์›ํ•ฉ๋‹ˆ๋‹ค. ํŒŒ์ผ๋Ÿฟ์—์„œ๋Š” Scheduling๋งŒ ๊บผ๋‚ผ ์ˆ˜
20
+ ์žˆ์œผ๋ฉฐ Pinpoint๋Š” ๋ณด๋ฅ˜ํ•ฉ๋‹ˆ๋‹ค.