@agent-native/core 0.114.11 → 0.114.13

package/corpus/templates/tasks/app/components/tasks/fields/controls/RichTextValueControl.tsx

@@ -1,3 +1,4 @@
+import { useT } from "@agent-native/core/client/i18n";
 import {
   IconBold,
   IconH1,
@@ -20,6 +21,7 @@ export function RichTextValueControl({
   disabled: boolean;
   onChange: (value: string) => void;
 }) {
+  const t = useT();
   const textareaRef = useRef<HTMLTextAreaElement | null>(null);
 
   function applyWrap(before: string, after = before, placeholder = "text") {
@@ -54,28 +56,32 @@ export function RichTextValueControl({
 
   const tools = [
     {
-      label: "Bold",
+      label: t("taskFields.toolBold"),
       icon: IconBold,
       action: () => applyWrap("**", "**", "bold"),
     },
     {
-      label: "Italic",
+      label: t("taskFields.toolItalic"),
       icon: IconItalic,
       action: () => applyWrap("_", "_", "italic"),
     },
-    { label: "Heading", icon: IconH1, action: () => applyLinePrefix("## ") },
     {
-      label: "Bulleted list",
+      label: t("taskFields.toolHeading"),
+      icon: IconH1,
+      action: () => applyLinePrefix("## "),
+    },
+    {
+      label: t("taskFields.toolBulletedList"),
       icon: IconList,
       action: () => applyLinePrefix("- "),
     },
     {
-      label: "Numbered list",
+      label: t("taskFields.toolNumberedList"),
       icon: IconListNumbers,
       action: () => applyLinePrefix("1. "),
     },
     {
-      label: "Link",
+      label: t("taskFields.toolLink"),
       icon: IconLink,
       action: () => applyWrap("[", "](https://example.com)", "link"),
     },

package/corpus/templates/tasks/app/components/tasks/fields/controls/SingleSelectValueControl.tsx

@@ -1,3 +1,5 @@
+import { useT } from "@agent-native/core/client/i18n";
+
 import { selectColorClass } from "@/components/custom-fields/editor/config/select-colors";
 import { optionsFromConfig } from "@/components/custom-fields/editor/config/utils";
 import {
@@ -24,6 +26,7 @@ export function SingleSelectValueControl({
   disabled: boolean;
   onChange: (value: FieldValue | null) => void;
 }) {
+  const t = useT();
   const options = optionsFromConfig(field.config);
   const selected = typeof value === "string" ? value : EMPTY_SELECT_VALUE;
 
@@ -40,7 +43,9 @@ export function SingleSelectValueControl({
       </SelectTrigger>
       <SelectContent>
         <SelectGroup>
-          <SelectItem value={EMPTY_SELECT_VALUE}>None</SelectItem>
+          <SelectItem value={EMPTY_SELECT_VALUE}>
+            {t("taskFields.noneOption")}
+          </SelectItem>
           {options.map((option) => (
             <SelectItem key={option.id} value={option.id}>
               <span className="flex items-center gap-2">

package/corpus/templates/tasks/app/i18n/en-US.ts

@@ -0,0 +1,209 @@
+const messages = {
+  common: {
+    cancel: "Cancel",
+    delete: "Delete",
+    add: "Add",
+    noneSelected: "None selected",
+    closePanel: "Close panel",
+    editTitleAriaLabel: "Edit title",
+    rowActionsAriaLabel: "Actions for {{title}}",
+    reorderAriaLabel: "Reorder {{title}}",
+    removeAriaLabel: "Remove {{label}}",
+    showAll: "Show all",
+    markReady: "Mark ready",
+  },
+  sidebar: {
+    navInbox: "Inbox",
+    navTasks: "Tasks",
+    navFields: "Fields",
+    collapseSidebar: "Collapse sidebar",
+    expandSidebar: "Expand sidebar",
+    navigationTitle: "Navigation",
+    navigationDescription: "App navigation links",
+  },
+  header: {
+    openNavigation: "Open navigation",
+    pageTasks: "Tasks",
+    pageSettings: "Settings",
+    pageTeam: "Team",
+    pageExtension: "Extension",
+    pageExtensions: "Extensions",
+  },
+  agent: {
+    emptyState: "Ask the agent to inspect or change this app.",
+    suggestionCalendar: "Check my calendar and mails - any tasks for today?",
+    suggestionPrioritize: "Prioritise my tasks",
+    suggestionCleanHouse:
+      "I need to clean my house, create a list of tasks for it",
+  },
+  team: {
+    createOrgDescription:
+      "Set up a team to share this app with your colleagues.",
+  },
+  tasks: {
+    pageTitle: "Tasks",
+    pageDescription:
+      "Manage your task list, drag to reorder, or ask chat to add reminders.",
+    loadError: "Failed to load tasks.",
+    allCompleteHeading: "All tasks complete",
+    allCompleteDescription: "Toggle Show all to review completed tasks.",
+    emptyHeading: "No tasks yet",
+    emptyDescription: "Add one above or ask chat to create a task for you.",
+    listAriaLabel: "Tasks list",
+    bulkDeleteError: "Could not delete selected tasks.",
+    entitySingular: "task",
+    entityPlural: "tasks",
+    taskColumnHeader: "Task",
+    visibleTaskFieldsAriaLabel: "Visible task fields",
+    markCompleteAriaLabel: "Mark {{title}} complete",
+    markIncompleteAriaLabel: "Mark {{title}} incomplete",
+    addPlaceholder: "Add a task...",
+    addButtonLabel: "Add task",
+    addInputAriaLabel: "New task title",
+    addErrorMessage: "Failed to create task. Please try again.",
+  },
+  inbox: {
+    pageTitle: "Inbox",
+    pageDescription:
+      "Capture rough ideas here, then mark ready when they become tasks.",
+    loadError: "Failed to load inbox items.",
+    emptyHeading: "Inbox is empty",
+    emptyDescription:
+      "Add an item above or ask chat to capture something for triage.",
+    listAriaLabel: "Inbox list",
+    bulkDeleteError: "Could not delete selected inbox items.",
+    entitySingular: "inbox item",
+    entityPlural: "inbox items",
+    addPlaceholder: "Add to inbox...",
+    addButtonLabel: "Add item",
+    addInputAriaLabel: "New inbox item title",
+    addErrorMessage: "Failed to add inbox item. Please try again.",
+  },
+  fields: {
+    pageTitle: "Fields",
+    pageDescription: "Define the reusable fields that every task can fill in.",
+    loadError: "Failed to load fields.",
+    emptyHeading: "No fields yet",
+    emptyDescription: "Create a field above to start adding task structure.",
+    listAriaLabel: "Fields list",
+    createdToast: "Field created.",
+    createError: "Could not create field.",
+    deletedToast: "Deleted {{title}}.",
+    deletedWithValuesToast: "Deleted {{title}} and {{count}} task values.",
+    deleteError: "Could not delete field.",
+    taskCardFieldsLabel: "Task card fields",
+    addFieldButtonLabel: "Add field",
+    noFieldsSelectedLabel: "No fields selected",
+    entitySingular: "field",
+    deleteFieldDescription:
+      "This deletes the field and removes its values from every task.",
+    deleteFieldDescriptionWithTitle:
+      'This deletes "{{title}}" and removes its values from every task.',
+    deleteFieldAriaLabel: "Delete {{title}}",
+    createNewFieldHeading: "Create new field",
+    fieldTitleLabel: "Field title",
+    newFieldTitlePlaceholder: "New field title",
+    fieldTypeAriaLabel: "Field type",
+    createButton: "Create",
+    currencyDescription: "Currency {{symbol}}",
+    decimalsDescription: "{{count}} decimals",
+    positiveOnlySuffix: "positive only",
+    optionsCountDescription: "{{count}} options",
+    types: {
+      text: "Text",
+      richText: "Rich text",
+      number: "Number",
+      percent: "Percent",
+      currency: "Currency",
+      singleSelect: "Single-select",
+      multiSelect: "Multi-select",
+      date: "Date",
+    },
+  },
+  fieldEditor: {
+    panelTitle: "Field",
+    closeLabel: "Close field editor",
+    updateError: "Could not update field.",
+    titleLabel: "Title",
+    requiredLabel: "Required",
+    editFieldTitleAriaLabel: "Edit field title",
+    symbolLabel: "Symbol",
+    precisionLabel: "Precision",
+    positiveOnlyLabel: "Positive numbers only",
+    optionsLabel: "Options",
+    optionNameAriaLabel: "Option {{index}} name",
+    optionColorAriaLabel: "Option {{name}} color",
+    removeOptionAriaLabel: "Remove {{name}}",
+    newOptionName: "Option {{index}}",
+    addOptionButton: "Add option",
+    colors: {
+      red: "Red",
+      orange: "Orange",
+      yellow: "Yellow",
+      green: "Green",
+      blue: "Blue",
+      purple: "Purple",
+      pink: "Pink",
+      gray: "Gray",
+    },
+  },
+  taskFields: {
+    panelTitle: "Fields",
+    panelSubtitle: "Task details",
+    closeLabel: "Close fields panel",
+    updateError: "Could not update task.",
+    noFieldsDefined: "No fields defined.",
+    titleLabel: "Title",
+    taskBadge: "Task",
+    editTaskTitleAriaLabel: "Edit task title",
+    noneOption: "None",
+    toolBold: "Bold",
+    toolItalic: "Italic",
+    toolHeading: "Heading",
+    toolBulletedList: "Bulleted list",
+    toolNumberedList: "Numbered list",
+    toolLink: "Link",
+  },
+  selection: {
+    select: "Select",
+    doneSelecting: "Done selecting",
+    selectAll: "Select all",
+    clearAll: "Clear all",
+    exitSelectionMode: "Exit selection mode",
+    markComplete: "Mark complete",
+    markIncomplete: "Mark incomplete",
+    completeLabel: "Complete",
+    incompleteLabel: "Incomplete",
+    selectedCount: "{{count}} selected",
+    selectedCountReorder: "{{count}} selected · drag to reorder",
+    tapToSelectTasks: "Tap tasks to select them.",
+    tapToSelectItems: "Tap items to select them.",
+    taskSelectionActionsAriaLabel: "Task selection actions",
+    inboxSelectionActionsAriaLabel: "Inbox selection actions",
+    couldNotMarkReady: "Could not mark selected items ready.",
+    couldNotUpdateTasks: "Could not update selected tasks.",
+    markedReadyOne: "Marked {{count}} item ready",
+    markedReadyOther: "Marked {{count}} items ready",
+    allTasksAlreadyComplete: "All selected tasks are already complete.",
+    allTasksAlreadyIncomplete: "All selected tasks are already incomplete.",
+    markedDone: "Marked {{count}} {{unit}} complete",
+    markedDoneWithSkipped:
+      "Marked {{count}} {{unit}} complete ({{skipped}} already complete)",
+    markedNotDone: "Marked {{count}} {{unit}} incomplete",
+    markedNotDoneWithSkipped:
+      "Marked {{count}} {{unit}} incomplete ({{skipped}} already incomplete)",
+  },
+  dialogs: {
+    deleteEntityTitle: "Delete {{entity}}?",
+    deleteItemDescription: "This removes the {{entity}} permanently.",
+    deleteItemDescriptionWithTitle: 'This removes "{{title}}" permanently.',
+    bulkDeleteDescriptionOne:
+      "This permanently removes the selected {{entity}}.",
+    bulkDeleteDescriptionOther:
+      "This permanently removes all {{count}} selected {{entity}}.",
+    andMore: "and {{count}} more",
+    deletedCount: "Deleted {{count}} {{entity}}",
+  },
+};
+
+export default messages;

package/corpus/templates/tasks/app/i18n/index.ts

@@ -0,0 +1,34 @@
+import { type AgentNativeI18nCatalog } from "@agent-native/core/client/i18n";
+
+import enUS from "./en-US";
+
+export const i18nCatalog = {
+  sourceLocale: "en-US",
+  messages: enUS,
+  loadMessages: async (locale) => {
+    switch (locale) {
+      case "zh-CN":
+        return (await import("./zh-CN")).default;
+      case "zh-TW":
+        return (await import("./zh-TW")).default;
+      case "es-ES":
+        return (await import("./es-ES")).default;
+      case "fr-FR":
+        return (await import("./fr-FR")).default;
+      case "de-DE":
+        return (await import("./de-DE")).default;
+      case "ja-JP":
+        return (await import("./ja-JP")).default;
+      case "ko-KR":
+        return (await import("./ko-KR")).default;
+      case "pt-BR":
+        return (await import("./pt-BR")).default;
+      case "hi-IN":
+        return (await import("./hi-IN")).default;
+      case "ar-SA":
+        return (await import("./ar-SA")).default;
+      default:
+        return null;
+    }
+  },
+} satisfies AgentNativeI18nCatalog;

package/corpus/templates/tasks/app/root.tsx

@@ -5,6 +5,7 @@ import {
   AppProviders,
   createAgentNativeQueryClient,
 } from "@agent-native/core/client/hooks";
+import { getLocaleInitScript } from "@agent-native/core/client/i18n";
 import {
   CommandMenu,
   useCommandMenuShortcut,
@@ -20,6 +21,7 @@ import type { LinksFunction } from "react-router";
 import { Layout as AppLayout } from "@/components/layout/Layout";
 import { Toaster } from "@/components/ui/sonner";
 import { useNavigationState } from "@/hooks/use-navigation-state";
+import { i18nCatalog } from "@/i18n";
 import { APP_TITLE } from "@/lib/app-config";
 import { TAB_ID } from "@/lib/tab-id";
 
@@ -37,7 +39,31 @@ export const links: LinksFunction = () => [
   { rel: "stylesheet", href: stylesheet },
 ];
 
-const THEME_INIT_SCRIPT = getThemeInitScript();
+const THEME_INIT_SCRIPT_SELECTOR = "script[data-agent-native-theme-init]";
+const LOCALE_INIT_SCRIPT_SELECTOR = "script[data-agent-native-locale-init]";
+
+function getHydrationStableThemeInitScript() {
+  if (typeof document !== "undefined") {
+    const existing = document.querySelector<HTMLScriptElement>(
+      THEME_INIT_SCRIPT_SELECTOR,
+    );
+    if (existing?.innerHTML) return existing.innerHTML;
+  }
+  return getThemeInitScript();
+}
+
+function getHydrationStableLocaleInitScript() {
+  if (typeof document !== "undefined") {
+    const existing = document.querySelector<HTMLScriptElement>(
+      LOCALE_INIT_SCRIPT_SELECTOR,
+    );
+    if (existing?.innerHTML) return existing.innerHTML;
+  }
+  return getLocaleInitScript();
+}
+
+const THEME_INIT_SCRIPT = getHydrationStableThemeInitScript();
+const LOCALE_INIT_SCRIPT = getHydrationStableLocaleInitScript();
 
 export function Layout({ children }: { children: React.ReactNode }) {
   return (
@@ -49,9 +75,15 @@ export function Layout({ children }: { children: React.ReactNode }) {
           content="width=device-width, initial-scale=1, maximum-scale=1, user-scalable=no"
         />
         <script
+          data-agent-native-theme-init
           suppressHydrationWarning
           dangerouslySetInnerHTML={{ __html: THEME_INIT_SCRIPT }}
         />
+        <script
+          data-agent-native-locale-init
+          suppressHydrationWarning
+          dangerouslySetInnerHTML={{ __html: LOCALE_INIT_SCRIPT }}
+        />
         <link rel="manifest" href={appPath("/manifest.json")} />
         <meta name="theme-color" content="#18181B" />
         <meta name="mobile-web-app-capable" content="yes" />
@@ -122,7 +154,7 @@ function AppContent() {
 export default function Root() {
   const [queryClient] = useState(() => createAgentNativeQueryClient());
   return (
-    <AppProviders queryClient={queryClient}>
+    <AppProviders queryClient={queryClient} i18n={{ catalog: i18nCatalog }}>
       <DbSyncSetup />
       <AppContent />
     </AppProviders>

package/corpus/templates/tasks/app/routes/extensions.$id.tsx

@@ -1,9 +1,10 @@
 import { ExtensionViewerPage } from "@agent-native/core/client/extensions";
 
+import messages from "@/i18n/en-US";
 import { APP_TITLE } from "@/lib/app-config";
 
 export function meta() {
-  return [{ title: `Extension — ${APP_TITLE}` }];
+  return [{ title: `${messages.header.pageExtension} — ${APP_TITLE}` }];
 }
 
 export default function ExtensionViewerRoute() {

package/corpus/templates/tasks/app/routes/extensions._index.tsx

@@ -1,9 +1,10 @@
 import { ExtensionsListPage } from "@agent-native/core/client/extensions";
 
+import messages from "@/i18n/en-US";
 import { APP_TITLE } from "@/lib/app-config";
 
 export function meta() {
-  return [{ title: `Extensions — ${APP_TITLE}` }];
+  return [{ title: `${messages.header.pageExtensions} — ${APP_TITLE}` }];
 }
 
 export default function ExtensionsRoute() {

package/corpus/templates/tasks/app/routes/fields.tsx

@@ -1,9 +1,10 @@
 import { FieldsPage } from "@/components/custom-fields/FieldsPage";
+import messages from "@/i18n/en-US";
 import { APP_TITLE } from "@/lib/app-config";
 
 export function meta() {
   return [
-    { title: `Fields · ${APP_TITLE}` },
+    { title: `${messages.fields.pageTitle} · ${APP_TITLE}` },
     {
       name: "description",
       content: "Define reusable custom fields for tasks.",

package/corpus/templates/tasks/app/routes/inbox.tsx

@@ -1,9 +1,10 @@
 import { InboxListPage } from "@/components/inbox/InboxListPage";
+import messages from "@/i18n/en-US";
 import { APP_TITLE } from "@/lib/app-config";
 
 export function meta() {
   return [
-    { title: `Inbox · ${APP_TITLE}` },
+    { title: `${messages.inbox.pageTitle} · ${APP_TITLE}` },
     {
       name: "description",
       content: "Capture rough ideas in the inbox before they become tasks.",

package/corpus/templates/tasks/app/routes/tasks.tsx

@@ -1,9 +1,10 @@
 import { TaskListPage } from "@/components/tasks/TaskListPage";
+import messages from "@/i18n/en-US";
 import { APP_TITLE } from "@/lib/app-config";
 
 export function meta() {
   return [
-    { title: `Tasks · ${APP_TITLE}` },
+    { title: `${messages.tasks.pageTitle} · ${APP_TITLE}` },
     {
       name: "description",
       content:

package/corpus/templates/tasks/app/routes/team.tsx

@@ -1,17 +1,20 @@
+import { useT } from "@agent-native/core/client/i18n";
 import { TeamPage } from "@agent-native/core/client/org";
 
 import { useSetPageTitle } from "@/components/layout/HeaderActions";
+import messages from "@/i18n/en-US";
 import { APP_TITLE } from "@/lib/app-config";
 
 export function meta() {
-  return [{ title: `Team — ${APP_TITLE}` }];
+  return [{ title: `${messages.header.pageTeam} — ${APP_TITLE}` }];
 }
 
 export default function TeamRoute() {
-  useSetPageTitle("Team");
+  const t = useT();
+  useSetPageTitle(t("header.pageTeam"));
   return (
     <main className="mx-auto w-full max-w-3xl px-4 py-6 sm:px-6 sm:py-10">
-      <TeamPage createOrgDescription="Set up a team to share this app with your colleagues." />
+      <TeamPage createOrgDescription={t("team.createOrgDescription")} />
     </main>
   );
 }

package/corpus/templates/tasks/changelog/2026-07-20-tasks-is-now-available-in-10-additional-languages.md

@@ -0,0 +1,6 @@
+---
+type: added
+date: 2026-07-20
+---
+
+Tasks is now available in 10 additional languages

package/dist/application-state/index.d.ts

@@ -1,5 +1,5 @@
-export { appStateGet, appStateGetMany, appStatePut, appStateDelete, appStateCompareAndSet, appStateList, appStateDeleteByPrefix, } from "./store.js";
+export { appStateGet, appStateGetMany, appStatePut, appStateDelete, appStateCompareAndSet, appStateCompareAndSetMany, appStateList, appStateDeleteByPrefix, type AppStateCompareAndSetOperation, } from "./store.js";
 export { getAppStateEmitter, emitAppStateChange, emitAppStateDelete, type AppStateEvent, } from "./emitter.js";
 export { getState, putState, deleteState, listComposeDrafts, getComposeDraft, putComposeDraft, deleteComposeDraft, deleteAllComposeDrafts, } from "./handlers.js";
-export { readAppState, writeAppState, deleteAppState, compareAndSetAppState, listAppState, deleteAppStateByPrefix, readAppStateForCurrentTab, writeAppStateForCurrentTab, appStateKeyForBrowserTab, getCurrentRequestBrowserTabId, } from "./script-helpers.js";
+export { readAppState, writeAppState, deleteAppState, compareAndSetAppState, compareAndSetManyAppState, listAppState, deleteAppStateByPrefix, readAppStateForCurrentTab, writeAppStateForCurrentTab, appStateKeyForBrowserTab, getCurrentRequestBrowserTabId, } from "./script-helpers.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/application-state/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/application-state/index.ts"],"names":[],"mappings":"AACA,OAAO,EACL,WAAW,EACX,eAAe,EACf,WAAW,EACX,cAAc,EACd,qBAAqB,EACrB,YAAY,EACZ,sBAAsB,GACvB,MAAM,YAAY,CAAC;AAGpB,OAAO,EACL,kBAAkB,EAClB,kBAAkB,EAClB,kBAAkB,EAClB,KAAK,aAAa,GACnB,MAAM,cAAc,CAAC;AAGtB,OAAO,EACL,QAAQ,EACR,QAAQ,EACR,WAAW,EACX,iBAAiB,EACjB,eAAe,EACf,eAAe,EACf,kBAAkB,EAClB,sBAAsB,GACvB,MAAM,eAAe,CAAC;AAGvB,OAAO,EACL,YAAY,EACZ,aAAa,EACb,cAAc,EACd,qBAAqB,EACrB,YAAY,EACZ,sBAAsB,EACtB,yBAAyB,EACzB,0BAA0B,EAC1B,wBAAwB,EACxB,6BAA6B,GAC9B,MAAM,qBAAqB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/application-state/index.ts"],"names":[],"mappings":"AACA,OAAO,EACL,WAAW,EACX,eAAe,EACf,WAAW,EACX,cAAc,EACd,qBAAqB,EACrB,yBAAyB,EACzB,YAAY,EACZ,sBAAsB,EACtB,KAAK,8BAA8B,GACpC,MAAM,YAAY,CAAC;AAGpB,OAAO,EACL,kBAAkB,EAClB,kBAAkB,EAClB,kBAAkB,EAClB,KAAK,aAAa,GACnB,MAAM,cAAc,CAAC;AAGtB,OAAO,EACL,QAAQ,EACR,QAAQ,EACR,WAAW,EACX,iBAAiB,EACjB,eAAe,EACf,eAAe,EACf,kBAAkB,EAClB,sBAAsB,GACvB,MAAM,eAAe,CAAC;AAGvB,OAAO,EACL,YAAY,EACZ,aAAa,EACb,cAAc,EACd,qBAAqB,EACrB,yBAAyB,EACzB,YAAY,EACZ,sBAAsB,EACtB,yBAAyB,EACzB,0BAA0B,EAC1B,wBAAwB,EACxB,6BAA6B,GAC9B,MAAM,qBAAqB,CAAC"}

package/dist/application-state/index.js

@@ -1,9 +1,9 @@
 // Store
-export { appStateGet, appStateGetMany, appStatePut, appStateDelete, appStateCompareAndSet, appStateList, appStateDeleteByPrefix, } from "./store.js";
+export { appStateGet, appStateGetMany, appStatePut, appStateDelete, appStateCompareAndSet, appStateCompareAndSetMany, appStateList, appStateDeleteByPrefix, } from "./store.js";
 // Emitter (for SSE wiring)
 export { getAppStateEmitter, emitAppStateChange, emitAppStateDelete, } from "./emitter.js";
 // H3 route handlers (for templates)
 export { getState, putState, deleteState, listComposeDrafts, getComposeDraft, putComposeDraft, deleteComposeDraft, deleteAllComposeDrafts, } from "./handlers.js";
 // Script helpers
-export { readAppState, writeAppState, deleteAppState, compareAndSetAppState, listAppState, deleteAppStateByPrefix, readAppStateForCurrentTab, writeAppStateForCurrentTab, appStateKeyForBrowserTab, getCurrentRequestBrowserTabId, } from "./script-helpers.js";
+export { readAppState, writeAppState, deleteAppState, compareAndSetAppState, compareAndSetManyAppState, listAppState, deleteAppStateByPrefix, readAppStateForCurrentTab, writeAppStateForCurrentTab, appStateKeyForBrowserTab, getCurrentRequestBrowserTabId, } from "./script-helpers.js";
 //# sourceMappingURL=index.js.map

package/dist/application-state/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/application-state/index.ts"],"names":[],"mappings":"AAAA,QAAQ;AACR,OAAO,EACL,WAAW,EACX,eAAe,EACf,WAAW,EACX,cAAc,EACd,qBAAqB,EACrB,YAAY,EACZ,sBAAsB,GACvB,MAAM,YAAY,CAAC;AAEpB,2BAA2B;AAC3B,OAAO,EACL,kBAAkB,EAClB,kBAAkB,EAClB,kBAAkB,GAEnB,MAAM,cAAc,CAAC;AAEtB,oCAAoC;AACpC,OAAO,EACL,QAAQ,EACR,QAAQ,EACR,WAAW,EACX,iBAAiB,EACjB,eAAe,EACf,eAAe,EACf,kBAAkB,EAClB,sBAAsB,GACvB,MAAM,eAAe,CAAC;AAEvB,iBAAiB;AACjB,OAAO,EACL,YAAY,EACZ,aAAa,EACb,cAAc,EACd,qBAAqB,EACrB,YAAY,EACZ,sBAAsB,EACtB,yBAAyB,EACzB,0BAA0B,EAC1B,wBAAwB,EACxB,6BAA6B,GAC9B,MAAM,qBAAqB,CAAC","sourcesContent":["// Store\nexport {\n  appStateGet,\n  appStateGetMany,\n  appStatePut,\n  appStateDelete,\n  appStateCompareAndSet,\n  appStateList,\n  appStateDeleteByPrefix,\n} from \"./store.js\";\n\n// Emitter (for SSE wiring)\nexport {\n  getAppStateEmitter,\n  emitAppStateChange,\n  emitAppStateDelete,\n  type AppStateEvent,\n} from \"./emitter.js\";\n\n// H3 route handlers (for templates)\nexport {\n  getState,\n  putState,\n  deleteState,\n  listComposeDrafts,\n  getComposeDraft,\n  putComposeDraft,\n  deleteComposeDraft,\n  deleteAllComposeDrafts,\n} from \"./handlers.js\";\n\n// Script helpers\nexport {\n  readAppState,\n  writeAppState,\n  deleteAppState,\n  compareAndSetAppState,\n  listAppState,\n  deleteAppStateByPrefix,\n  readAppStateForCurrentTab,\n  writeAppStateForCurrentTab,\n  appStateKeyForBrowserTab,\n  getCurrentRequestBrowserTabId,\n} from \"./script-helpers.js\";\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/application-state/index.ts"],"names":[],"mappings":"AAAA,QAAQ;AACR,OAAO,EACL,WAAW,EACX,eAAe,EACf,WAAW,EACX,cAAc,EACd,qBAAqB,EACrB,yBAAyB,EACzB,YAAY,EACZ,sBAAsB,GAEvB,MAAM,YAAY,CAAC;AAEpB,2BAA2B;AAC3B,OAAO,EACL,kBAAkB,EAClB,kBAAkB,EAClB,kBAAkB,GAEnB,MAAM,cAAc,CAAC;AAEtB,oCAAoC;AACpC,OAAO,EACL,QAAQ,EACR,QAAQ,EACR,WAAW,EACX,iBAAiB,EACjB,eAAe,EACf,eAAe,EACf,kBAAkB,EAClB,sBAAsB,GACvB,MAAM,eAAe,CAAC;AAEvB,iBAAiB;AACjB,OAAO,EACL,YAAY,EACZ,aAAa,EACb,cAAc,EACd,qBAAqB,EACrB,yBAAyB,EACzB,YAAY,EACZ,sBAAsB,EACtB,yBAAyB,EACzB,0BAA0B,EAC1B,wBAAwB,EACxB,6BAA6B,GAC9B,MAAM,qBAAqB,CAAC","sourcesContent":["// Store\nexport {\n  appStateGet,\n  appStateGetMany,\n  appStatePut,\n  appStateDelete,\n  appStateCompareAndSet,\n  appStateCompareAndSetMany,\n  appStateList,\n  appStateDeleteByPrefix,\n  type AppStateCompareAndSetOperation,\n} from \"./store.js\";\n\n// Emitter (for SSE wiring)\nexport {\n  getAppStateEmitter,\n  emitAppStateChange,\n  emitAppStateDelete,\n  type AppStateEvent,\n} from \"./emitter.js\";\n\n// H3 route handlers (for templates)\nexport {\n  getState,\n  putState,\n  deleteState,\n  listComposeDrafts,\n  getComposeDraft,\n  putComposeDraft,\n  deleteComposeDraft,\n  deleteAllComposeDrafts,\n} from \"./handlers.js\";\n\n// Script helpers\nexport {\n  readAppState,\n  writeAppState,\n  deleteAppState,\n  compareAndSetAppState,\n  compareAndSetManyAppState,\n  listAppState,\n  deleteAppStateByPrefix,\n  readAppStateForCurrentTab,\n  writeAppStateForCurrentTab,\n  appStateKeyForBrowserTab,\n  getCurrentRequestBrowserTabId,\n} from \"./script-helpers.js\";\n"]}

package/dist/application-state/script-helpers.d.ts

@@ -11,10 +11,12 @@
  * reliably identify the caller. Only CLI scripts (single-user, no HTTP
  * context) should fall through to the env var.
  */
+import { type AppStateCompareAndSetOperation } from "./store.js";
 export declare function readAppState(key: string): Promise<Record<string, unknown> | null>;
 export declare function writeAppState(key: string, value: Record<string, unknown>): Promise<void>;
 export declare function deleteAppState(key: string): Promise<boolean>;
-export declare function compareAndSetAppState(key: string, expectedValue: Record<string, unknown>, nextValue: Record<string, unknown> | null): Promise<boolean>;
+export declare function compareAndSetAppState(key: string, expectedValue: Record<string, unknown> | null, nextValue: Record<string, unknown> | null): Promise<boolean>;
+export declare function compareAndSetManyAppState(operations: readonly AppStateCompareAndSetOperation[]): Promise<boolean>;
 export declare function listAppState(prefix: string): Promise<Array<{
     key: string;
     value: Record<string, unknown>;

package/dist/application-state/script-helpers.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"script-helpers.d.ts","sourceRoot":"","sources":["../../src/application-state/script-helpers.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAsCH,wBAAsB,YAAY,CAChC,GAAG,EAAE,MAAM,GACV,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC,CAGzC;AAED,wBAAsB,aAAa,CACjC,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC7B,OAAO,CAAC,IAAI,CAAC,CAKf;AAED,wBAAsB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAKlE;AAED,wBAAsB,qBAAqB,CACzC,GAAG,EAAE,MAAM,EACX,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACtC,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,GACxC,OAAO,CAAC,OAAO,CAAC,CAKlB;AAED,wBAAsB,YAAY,CAChC,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,KAAK,CAAC;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAAE,CAAC,CAAC,CAGjE;AAED,wBAAsB,sBAAsB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAK5E;AAUD;;;;GAIG;AACH,wBAAgB,6BAA6B,IAAI,MAAM,GAAG,IAAI,CAM7D;AAED,uEAAuE;AACvE,wBAAgB,wBAAwB,CACtC,GAAG,EAAE,MAAM,EACX,YAAY,EAAE,OAAO,GACpB,MAAM,CAGR;AAED;;;;GAIG;AACH,wBAAsB,yBAAyB,CAC7C,GAAG,EAAE,MAAM,EACX,OAAO,CAAC,EAAE;IAAE,gBAAgB,CAAC,EAAE,OAAO,CAAA;CAAE,GACvC,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC,CAQzC;AAED,oEAAoE;AACpE,wBAAsB,0BAA0B,CAC9C,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC7B,OAAO,CAAC,IAAI,CAAC,CAGf"}
+{"version":3,"file":"script-helpers.d.ts","sourceRoot":"","sources":["../../src/application-state/script-helpers.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAGH,OAAO,EAQL,KAAK,8BAA8B,EACpC,MAAM,YAAY,CAAC;AA4BpB,wBAAsB,YAAY,CAChC,GAAG,EAAE,MAAM,GACV,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC,CAGzC;AAED,wBAAsB,aAAa,CACjC,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC7B,OAAO,CAAC,IAAI,CAAC,CAKf;AAED,wBAAsB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAKlE;AAED,wBAAsB,qBAAqB,CACzC,GAAG,EAAE,MAAM,EACX,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,EAC7C,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,GACxC,OAAO,CAAC,OAAO,CAAC,CAKlB;AAED,wBAAsB,yBAAyB,CAC7C,UAAU,EAAE,SAAS,8BAA8B,EAAE,GACpD,OAAO,CAAC,OAAO,CAAC,CAKlB;AAED,wBAAsB,YAAY,CAChC,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,KAAK,CAAC;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAAE,CAAC,CAAC,CAGjE;AAED,wBAAsB,sBAAsB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAK5E;AAUD;;;;GAIG;AACH,wBAAgB,6BAA6B,IAAI,MAAM,GAAG,IAAI,CAM7D;AAED,uEAAuE;AACvE,wBAAgB,wBAAwB,CACtC,GAAG,EAAE,MAAM,EACX,YAAY,EAAE,OAAO,GACpB,MAAM,CAGR;AAED;;;;GAIG;AACH,wBAAsB,yBAAyB,CAC7C,GAAG,EAAE,MAAM,EACX,OAAO,CAAC,EAAE;IAAE,gBAAgB,CAAC,EAAE,OAAO,CAAA;CAAE,GACvC,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC,CAQzC;AAED,oEAAoE;AACpE,wBAAsB,0BAA0B,CAC9C,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC7B,OAAO,CAAC,IAAI,CAAC,CAGf"}

package/dist/application-state/script-helpers.js

@@ -12,7 +12,7 @@
  * context) should fall through to the env var.
  */
 import { getRequestRunContext } from "../server/request-context.js";
-import { appStateGet, appStatePut, appStateDelete, appStateCompareAndSet, appStateList, appStateDeleteByPrefix, } from "./store.js";
+import { appStateGet, appStatePut, appStateDelete, appStateCompareAndSet, appStateCompareAndSetMany, appStateList, appStateDeleteByPrefix, } from "./store.js";
 /**
  * Resolve session ID for the current caller.
  *
@@ -58,6 +58,12 @@ export async function compareAndSetAppState(key, expectedValue, nextValue) {
         requestSource: "agent",
     });
 }
+export async function compareAndSetManyAppState(operations) {
+    const sessionId = await resolveSessionId();
+    return appStateCompareAndSetMany(sessionId, operations, {
+        requestSource: "agent",
+    });
+}
 export async function listAppState(prefix) {
     const sessionId = await resolveSessionId();
     return appStateList(sessionId, prefix);

package/dist/application-state/script-helpers.js.map

@@ -1 +1 @@
-{"version":3,"file":"script-helpers.js","sourceRoot":"","sources":["../../src/application-state/script-helpers.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Application state helpers for use in scripts and actions.\n *\n * The session ID determines which user's application state is read/written.\n * Resolution order:\n *   1. Per-request context (AsyncLocalStorage) — set by the HTTP handler\n *   2. AGENT_USER_EMAIL env var — CLI scripts only\n *\n * The per-request context is critical in multi-user deployments: the env var\n * is process-global and gets overwritten by concurrent requests, so it cannot\n * reliably identify the caller. Only CLI scripts (single-user, no HTTP\n * context) should fall through to the env var.\n */\n\nimport { getRequestRunContext } from \"../server/request-context.js\";\nimport {\n  appStateGet,\n  appStatePut,\n  appStateDelete,\n  appStateCompareAndSet,\n  appStateList,\n  appStateDeleteByPrefix,\n} from \"./store.js\";\n\n/**\n * Resolve session ID for the current caller.\n *\n * In an HTTP/action context, uses the per-request user email from\n * AsyncLocalStorage so concurrent users don't collide. In a CLI context\n * (no request), falls back to AGENT_USER_EMAIL. Throws when neither is\n * present — application state must be scoped to a real identity.\n */\nasync function resolveSessionId(): Promise<string> {\n  try {\n    const { getRequestUserEmail } =\n      await import(\"../server/request-context.js\");\n    const ctxEmail = getRequestUserEmail();\n    if (ctxEmail) return ctxEmail;\n  } catch {\n    // request-context not available — fall through to env var\n  }\n\n  const email = process.env.AGENT_USER_EMAIL;\n  if (email) return email;\n\n  throw new Error(\n    \"Application state access requires an authenticated request context or AGENT_USER_EMAIL env var\",\n  );\n}\n\nexport async function readAppState(\n  key: string,\n): Promise<Record<string, unknown> | null> {\n  const sessionId = await resolveSessionId();\n  return appStateGet(sessionId, key);\n}\n\nexport async function writeAppState(\n  key: string,\n  value: Record<string, unknown>,\n): Promise<void> {\n  const sessionId = await resolveSessionId();\n  return appStatePut(sessionId, key, value, {\n    requestSource: \"agent\",\n  });\n}\n\nexport async function deleteAppState(key: string): Promise<boolean> {\n  const sessionId = await resolveSessionId();\n  return appStateDelete(sessionId, key, {\n    requestSource: \"agent\",\n  });\n}\n\nexport async function compareAndSetAppState(\n  key: string,\n  expectedValue: Record<string, unknown>,\n  nextValue: Record<string, unknown> | null,\n): Promise<boolean> {\n  const sessionId = await resolveSessionId();\n  return appStateCompareAndSet(sessionId, key, expectedValue, nextValue, {\n    requestSource: \"agent\",\n  });\n}\n\nexport async function listAppState(\n  prefix: string,\n): Promise<Array<{ key: string; value: Record<string, unknown> }>> {\n  const sessionId = await resolveSessionId();\n  return appStateList(sessionId, prefix);\n}\n\nexport async function deleteAppStateByPrefix(prefix: string): Promise<number> {\n  const sessionId = await resolveSessionId();\n  return appStateDeleteByPrefix(sessionId, prefix, {\n    requestSource: \"agent\",\n  });\n}\n\nconst SAFE_TAB_ID_RE = /^[A-Za-z0-9_-]{1,96}$/;\n\nfunction normalizeBrowserTabId(value: unknown): string | null {\n  if (typeof value !== \"string\") return null;\n  const trimmed = value.trim();\n  return SAFE_TAB_ID_RE.test(trimmed) ? trimmed : null;\n}\n\n/**\n * Browser tab id for the current request, if the client sent one. Used to\n * scope ambient UI state (navigation, selection, etc.) so a chat from one tab\n * reads that tab's state instead of whichever tab wrote the global key last.\n */\nexport function getCurrentRequestBrowserTabId(): string | null {\n  try {\n    return normalizeBrowserTabId(getRequestRunContext()?.browserTabId);\n  } catch {\n    return null;\n  }\n}\n\n/** `key:<tabId>` when a browser tab id is present, otherwise `key`. */\nexport function appStateKeyForBrowserTab(\n  key: string,\n  browserTabId: unknown,\n): string {\n  const normalized = normalizeBrowserTabId(browserTabId);\n  return normalized ? `${key}:${normalized}` : key;\n}\n\n/**\n * Read application state scoped to the requesting browser tab. Reads the\n * tab-scoped key first and (by default) falls back to the global key so\n * CLI/external agents and pre-scoping clients keep working.\n */\nexport async function readAppStateForCurrentTab(\n  key: string,\n  options?: { fallbackToGlobal?: boolean },\n): Promise<Record<string, unknown> | null> {\n  const tabKey = appStateKeyForBrowserTab(key, getCurrentRequestBrowserTabId());\n  if (tabKey !== key) {\n    const scoped = await readAppState(tabKey).catch(() => null);\n    if (scoped) return scoped;\n    if (options?.fallbackToGlobal === false) return null;\n  }\n  return readAppState(key);\n}\n\n/** Write application state scoped to the requesting browser tab. */\nexport async function writeAppStateForCurrentTab(\n  key: string,\n  value: Record<string, unknown>,\n): Promise<void> {\n  const tabKey = appStateKeyForBrowserTab(key, getCurrentRequestBrowserTabId());\n  return writeAppState(tabKey, value);\n}\n"]}
+{"version":3,"file":"script-helpers.js","sourceRoot":"","sources":["../../src/application-state/script-helpers.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Application state helpers for use in scripts and actions.\n *\n * The session ID determines which user's application state is read/written.\n * Resolution order:\n *   1. Per-request context (AsyncLocalStorage) — set by the HTTP handler\n *   2. AGENT_USER_EMAIL env var — CLI scripts only\n *\n * The per-request context is critical in multi-user deployments: the env var\n * is process-global and gets overwritten by concurrent requests, so it cannot\n * reliably identify the caller. Only CLI scripts (single-user, no HTTP\n * context) should fall through to the env var.\n */\n\nimport { getRequestRunContext } from \"../server/request-context.js\";\nimport {\n  appStateGet,\n  appStatePut,\n  appStateDelete,\n  appStateCompareAndSet,\n  appStateCompareAndSetMany,\n  appStateList,\n  appStateDeleteByPrefix,\n  type AppStateCompareAndSetOperation,\n} from \"./store.js\";\n\n/**\n * Resolve session ID for the current caller.\n *\n * In an HTTP/action context, uses the per-request user email from\n * AsyncLocalStorage so concurrent users don't collide. In a CLI context\n * (no request), falls back to AGENT_USER_EMAIL. Throws when neither is\n * present — application state must be scoped to a real identity.\n */\nasync function resolveSessionId(): Promise<string> {\n  try {\n    const { getRequestUserEmail } =\n      await import(\"../server/request-context.js\");\n    const ctxEmail = getRequestUserEmail();\n    if (ctxEmail) return ctxEmail;\n  } catch {\n    // request-context not available — fall through to env var\n  }\n\n  const email = process.env.AGENT_USER_EMAIL;\n  if (email) return email;\n\n  throw new Error(\n    \"Application state access requires an authenticated request context or AGENT_USER_EMAIL env var\",\n  );\n}\n\nexport async function readAppState(\n  key: string,\n): Promise<Record<string, unknown> | null> {\n  const sessionId = await resolveSessionId();\n  return appStateGet(sessionId, key);\n}\n\nexport async function writeAppState(\n  key: string,\n  value: Record<string, unknown>,\n): Promise<void> {\n  const sessionId = await resolveSessionId();\n  return appStatePut(sessionId, key, value, {\n    requestSource: \"agent\",\n  });\n}\n\nexport async function deleteAppState(key: string): Promise<boolean> {\n  const sessionId = await resolveSessionId();\n  return appStateDelete(sessionId, key, {\n    requestSource: \"agent\",\n  });\n}\n\nexport async function compareAndSetAppState(\n  key: string,\n  expectedValue: Record<string, unknown> | null,\n  nextValue: Record<string, unknown> | null,\n): Promise<boolean> {\n  const sessionId = await resolveSessionId();\n  return appStateCompareAndSet(sessionId, key, expectedValue, nextValue, {\n    requestSource: \"agent\",\n  });\n}\n\nexport async function compareAndSetManyAppState(\n  operations: readonly AppStateCompareAndSetOperation[],\n): Promise<boolean> {\n  const sessionId = await resolveSessionId();\n  return appStateCompareAndSetMany(sessionId, operations, {\n    requestSource: \"agent\",\n  });\n}\n\nexport async function listAppState(\n  prefix: string,\n): Promise<Array<{ key: string; value: Record<string, unknown> }>> {\n  const sessionId = await resolveSessionId();\n  return appStateList(sessionId, prefix);\n}\n\nexport async function deleteAppStateByPrefix(prefix: string): Promise<number> {\n  const sessionId = await resolveSessionId();\n  return appStateDeleteByPrefix(sessionId, prefix, {\n    requestSource: \"agent\",\n  });\n}\n\nconst SAFE_TAB_ID_RE = /^[A-Za-z0-9_-]{1,96}$/;\n\nfunction normalizeBrowserTabId(value: unknown): string | null {\n  if (typeof value !== \"string\") return null;\n  const trimmed = value.trim();\n  return SAFE_TAB_ID_RE.test(trimmed) ? trimmed : null;\n}\n\n/**\n * Browser tab id for the current request, if the client sent one. Used to\n * scope ambient UI state (navigation, selection, etc.) so a chat from one tab\n * reads that tab's state instead of whichever tab wrote the global key last.\n */\nexport function getCurrentRequestBrowserTabId(): string | null {\n  try {\n    return normalizeBrowserTabId(getRequestRunContext()?.browserTabId);\n  } catch {\n    return null;\n  }\n}\n\n/** `key:<tabId>` when a browser tab id is present, otherwise `key`. */\nexport function appStateKeyForBrowserTab(\n  key: string,\n  browserTabId: unknown,\n): string {\n  const normalized = normalizeBrowserTabId(browserTabId);\n  return normalized ? `${key}:${normalized}` : key;\n}\n\n/**\n * Read application state scoped to the requesting browser tab. Reads the\n * tab-scoped key first and (by default) falls back to the global key so\n * CLI/external agents and pre-scoping clients keep working.\n */\nexport async function readAppStateForCurrentTab(\n  key: string,\n  options?: { fallbackToGlobal?: boolean },\n): Promise<Record<string, unknown> | null> {\n  const tabKey = appStateKeyForBrowserTab(key, getCurrentRequestBrowserTabId());\n  if (tabKey !== key) {\n    const scoped = await readAppState(tabKey).catch(() => null);\n    if (scoped) return scoped;\n    if (options?.fallbackToGlobal === false) return null;\n  }\n  return readAppState(key);\n}\n\n/** Write application state scoped to the requesting browser tab. */\nexport async function writeAppStateForCurrentTab(\n  key: string,\n  value: Record<string, unknown>,\n): Promise<void> {\n  const tabKey = appStateKeyForBrowserTab(key, getCurrentRequestBrowserTabId());\n  return writeAppState(tabKey, value);\n}\n"]}

package/dist/application-state/store.d.ts

@@ -8,7 +8,13 @@ export declare function appStateGet(sessionId: string, key: string): Promise<Rec
 export declare function appStateGetMany(sessionId: string, keys: readonly string[]): Promise<Record<string, Record<string, unknown> | null>>;
 export declare function appStatePut(sessionId: string, key: string, value: Record<string, unknown>, options?: StoreWriteOptions): Promise<void>;
 export declare function appStateDelete(sessionId: string, key: string, options?: StoreWriteOptions): Promise<boolean>;
-export declare function appStateCompareAndSet(sessionId: string, key: string, expectedValue: Record<string, unknown>, nextValue: Record<string, unknown> | null, options?: StoreWriteOptions): Promise<boolean>;
+export declare function appStateCompareAndSet(sessionId: string, key: string, expectedValue: Record<string, unknown> | null, nextValue: Record<string, unknown> | null, options?: StoreWriteOptions): Promise<boolean>;
+export interface AppStateCompareAndSetOperation {
+    key: string;
+    expectedValue: Record<string, unknown> | null;
+    nextValue: Record<string, unknown> | null;
+}
+export declare function appStateCompareAndSetMany(sessionId: string, operations: readonly AppStateCompareAndSetOperation[], options?: StoreWriteOptions): Promise<boolean>;
 export declare function appStateList(sessionId: string, keyPrefix: string): Promise<Array<{
     key: string;
     value: Record<string, unknown>;