@agent-native/core 0.134.1 → 0.135.1

package/src/client/agent-page/use-jobs.ts

@@ -10,10 +10,12 @@ export interface RecurringJob {
   path: string;
   scope: "personal" | "organization";
   schedule: string;
+  timezone: string;
   scheduleDescription: string;
   instructions: string;
   enabled: boolean;
   lastRun: string | null;
+  lastCheck: string | null;
   lastStatus: string | null;
   lastError: string | null;
   nextRun: string | null;
@@ -30,11 +32,13 @@ export interface Automation {
   triggerType: "event" | "schedule";
   event: string | null;
   schedule: string | null;
+  timezone: string | null;
   scheduleDescription: string | null;
   condition: string | null;
   body: string;
   enabled: boolean;
   lastRun: string | null;
+  lastCheck: string | null;
   lastStatus: string | null;
   lastError: string | null;
   nextRun: string | null;
@@ -54,14 +58,23 @@ export type ManageJobInput = {
   name: string;
   scope: "personal" | "organization";
   enabled?: boolean;
+  schedule?: string;
+  timezone?: string;
 };
 
-export type ManageAutomationInput = {
-  operation: "update" | "delete";
-  name: string;
-  scope: "personal" | "organization";
-  enabled?: boolean;
-};
+export type ManageAutomationInput = ManageJobInput;
+
+export interface AutomationRun {
+  id: string;
+  automation: string;
+  scope: string | null;
+  runId: string | null;
+  threadId: string | null;
+  status: "running" | "success" | "error" | "interrupted";
+  startedAt: number;
+  finishedAt: number | null;
+  error: string | null;
+}
 
 function recurringParams(scope: JobsScope) {
   return { scope: scope === "org" ? "organization" : "personal" } as const;
@@ -105,8 +118,8 @@ export function useManageRecurringJob(scope: JobsScope) {
           return current.filter((job) => job.name !== variables.name);
         }
         return current.map((job) =>
-          job.name === variables.name && variables.enabled !== undefined
-            ? { ...job, enabled: variables.enabled }
+          job.name === variables.name
+            ? { ...job, ...optimisticPatch(variables) }
             : job,
         );
       });
@@ -141,8 +154,8 @@ export function useManageAutomation(scope: JobsScope) {
           );
         }
         return current.map((automation) =>
-          automation.name === variables.name && variables.enabled !== undefined
-            ? { ...automation, enabled: variables.enabled }
+          automation.name === variables.name
+            ? { ...automation, ...optimisticPatch(variables) }
             : automation,
         );
       });
@@ -156,3 +169,30 @@ export function useManageAutomation(scope: JobsScope) {
     },
   });
 }
+
+function optimisticPatch(variables: ManageJobInput) {
+  const patch: {
+    enabled?: boolean;
+    schedule?: string;
+    timezone?: string;
+  } = {};
+  if (variables.enabled !== undefined) patch.enabled = variables.enabled;
+  if (variables.schedule !== undefined) patch.schedule = variables.schedule;
+  if (variables.timezone !== undefined) patch.timezone = variables.timezone;
+  return patch;
+}
+
+export function useAutomationRuns(
+  scope: JobsScope,
+  name: string | null,
+  active: boolean,
+) {
+  const params = {
+    scope: scope === "org" ? "organization" : "personal",
+    name: name || "",
+  } as const;
+  return useActionQuery<AutomationRun[]>("list-automation-runs", params, {
+    staleTime: 5_000,
+    enabled: active && Boolean(name),
+  });
+}

package/src/client/org/OrgSwitcher.tsx

@@ -83,6 +83,13 @@ export interface OrgSwitcherProps {
   settingsPath?: string | null;
   /** Path to navigate to when the user clicks "Profile". Defaults to the shared Account settings section. */
   profilePath?: string | null;
+  /**
+   * Path to the Manage agent page. Settings links here too, but the switcher
+   * is the only always-visible surface, so omitting it leaves Files,
+   * Instructions, Memory, Skills and Automations reachable only from Settings.
+   * Pass `null` for apps that do not mount the Agent page.
+   */
+  agentPath?: string | null;
 }
 
 function personalLabelFromEmail(email: string | null | undefined): string {
@@ -119,6 +126,7 @@ const COMPACT_SWITCHER_BUTTON_CLASS =
 
 const DEFAULT_ORGANIZATION_SETTINGS_PATH = "/settings#organization";
 const DEFAULT_PROFILE_PATH = "/settings#account";
+const DEFAULT_AGENT_PATH = "/agent";
 
 const APP_ICON_MAP: Record<string, typeof IconApps> = {
   Mail: IconMail,
@@ -311,6 +319,7 @@ export function OrgSwitcher({
   compact,
   settingsPath = DEFAULT_ORGANIZATION_SETTINGS_PATH,
   profilePath = DEFAULT_PROFILE_PATH,
+  agentPath = DEFAULT_AGENT_PATH,
 }: OrgSwitcherProps) {
   const { data: org, isLoading } = useOrg();
   const { session } = useSession();
@@ -607,6 +616,23 @@ export function OrgSwitcher({
                   </span>
                 </button>
               )}
+              {agentPath && (
+                <button
+                  type="button"
+                  onClick={() => {
+                    setOpen(false);
+                    navigate(agentPath);
+                  }}
+                  className={`${ITEM_CLASS} cursor-pointer`}
+                >
+                  <IconBrain className="h-3.5 w-3.5 shrink-0 text-muted-foreground" />
+                  <span className="flex-1 text-start">
+                    {t("settings.manageAgentMenuItem", {
+                      defaultValue: "Manage agent",
+                    })}
+                  </span>
+                </button>
+              )}
               {inOrg && (
                 <button
                   type="button"

package/src/client/settings/AccountSettingsCard.tsx

@@ -13,6 +13,7 @@ import { useActionMutation, useActionQuery } from "../use-action.js";
 import { uploadAvatar, useAvatarUrl } from "../use-avatar.js";
 import { useSession } from "../use-session.js";
 import { cn } from "../utils.js";
+import { SchedulingTimezoneField } from "./SchedulingTimezoneField.js";
 
 function profileInitials(name: string): string {
   return (
@@ -157,38 +158,41 @@ export function AccountSettingsForm({
           description={t("settings.profileNameDescription")}
           disabled={!email || profileQuery.isLoading || updateProfile.isPending}
         />
-        <div className="flex items-center justify-between gap-3">
-          <div className="min-h-4 text-xs">
-            {updateProfile.isSuccess && (
-              <p className="text-green-600 dark:text-green-400">
-                {t("settings.profileSaved")}
-              </p>
-            )}
-            {updateProfile.error && (
-              <p className="text-destructive">
-                {t("settings.profileSaveError")}
-              </p>
-            )}
-          </div>
-          <ActionButton
-            type="button"
-            intent="primary"
-            emphasis="solid"
-            size="compact"
-            pending={updateProfile.isPending}
-            disabled={
-              !email ||
-              profileQuery.isLoading ||
-              updateProfile.isPending ||
-              !name.trim()
-            }
-            onPress={handleProfileSave}
-          >
-            {updateProfile.isPending
-              ? t("settings.profileSaving")
-              : t("settings.profileSave")}
-          </ActionButton>
+      </div>
+
+      <div className="border-t border-border/60 pt-3">
+        <SchedulingTimezoneField />
+      </div>
+
+      <div className="flex items-center justify-between gap-3 border-t border-border/60 pt-3">
+        <div className="min-h-4 text-xs">
+          {updateProfile.isSuccess && (
+            <p className="text-green-600 dark:text-green-400">
+              {t("settings.profileSaved")}
+            </p>
+          )}
+          {updateProfile.error && (
+            <p className="text-destructive">{t("settings.profileSaveError")}</p>
+          )}
         </div>
+        <ActionButton
+          type="button"
+          intent="primary"
+          emphasis="solid"
+          size="compact"
+          pending={updateProfile.isPending}
+          disabled={
+            !email ||
+            profileQuery.isLoading ||
+            updateProfile.isPending ||
+            !name.trim()
+          }
+          onPress={handleProfileSave}
+        >
+          {updateProfile.isPending
+            ? t("settings.profileSaving")
+            : t("settings.profileSave")}
+        </ActionButton>
       </div>
     </div>
   );

package/src/client/settings/SchedulingTimezoneField.tsx

@@ -0,0 +1,71 @@
+import {
+  TimezoneSelect,
+  browserTimezone,
+} from "../agent-page/TimezoneSelect.js";
+import { useT } from "../i18n.js";
+import { useActionMutation, useActionQuery } from "../use-action.js";
+
+interface LocalizationPreferenceResult {
+  locale: string;
+  timezone: string;
+}
+
+const SYSTEM = "system";
+
+/**
+ * Timezone used when the agent schedules work for this user.
+ *
+ * This is deliberately a stored preference rather than a per-request read of
+ * the browser zone: automations are created and run by callers that have no
+ * browser at all (cron ticks, chat integrations, A2A), and those callers would
+ * otherwise fall back to the host zone and schedule the user's 8am job in UTC.
+ */
+export function SchedulingTimezoneField() {
+  const t = useT();
+  const detected = browserTimezone();
+  const preference = useActionQuery<LocalizationPreferenceResult>(
+    "get-localization-preference",
+  );
+  const save = useActionMutation<
+    LocalizationPreferenceResult,
+    { timezone: string }
+  >("set-localization-preference");
+
+  // Selecting a zone commits it, matching the language picker beside it.
+  const stored = preference.data?.timezone ?? SYSTEM;
+  const pending = save.isPending ? save.variables?.timezone : undefined;
+  const value = pending ?? stored;
+
+  return (
+    <div className="space-y-2">
+      <label
+        className="text-sm font-medium"
+        htmlFor="agent-native-scheduling-timezone"
+      >
+        {t("settings.timezoneLabel", { defaultValue: "Timezone" })}
+      </label>
+
+      <TimezoneSelect
+        id="agent-native-scheduling-timezone"
+        value={value}
+        disabled={preference.isLoading || save.isPending}
+        suggested={[detected]}
+        systemLabel={t("settings.timezoneSystem", {
+          defaultValue: "Follow this browser ({{zone}})",
+          zone: detected,
+        })}
+        onChange={(timezone) => save.mutate({ timezone })}
+      />
+
+      <p className="min-h-4 text-xs text-muted-foreground">
+        {save.error ? (
+          <span className="text-destructive">{save.error.message}</span>
+        ) : (
+          t("settings.timezoneHint", {
+            defaultValue: "Used for timestamps and scheduled automations.",
+          })
+        )}
+      </p>
+    </div>
+  );
+}

package/src/client/settings/SettingsRow.tsx

@@ -0,0 +1,113 @@
+import type { ReactNode } from "react";
+
+import { cn } from "../utils.js";
+
+export interface SettingsGroupProps {
+  /** Anchor target so a settings search hit can scroll the whole group. */
+  id?: string;
+  title?: string;
+  description?: string;
+  className?: string;
+  children: ReactNode;
+}
+
+/**
+ * A bordered card holding several one-line settings instead of one card per
+ * control. Copy is passed in already translated — core components do not
+ * resolve an app's i18n keys.
+ */
+export function SettingsGroup({
+  id,
+  title,
+  description,
+  className,
+  children,
+}: SettingsGroupProps) {
+  return (
+    <section
+      id={id}
+      className={cn(
+        "scroll-mt-16 overflow-hidden rounded-lg border border-border bg-card text-card-foreground shadow-sm",
+        className,
+      )}
+    >
+      {(title || description) && (
+        <header className="border-b border-border/60 px-5 py-4 sm:px-6">
+          {title && (
+            <h2 className="text-base font-semibold leading-none tracking-tight">
+              {title}
+            </h2>
+          )}
+          {description && (
+            <p className="mt-1.5 text-sm leading-snug text-muted-foreground">
+              {description}
+            </p>
+          )}
+        </header>
+      )}
+      <div className="divide-y divide-border/60">{children}</div>
+    </section>
+  );
+}
+
+export interface SettingsRowProps {
+  /**
+   * Anchor target. Rows keep the ids their former standalone cards used, so
+   * existing settings-search hashes still resolve after a card collapses into
+   * a row.
+   */
+  id?: string;
+  label: ReactNode;
+  description?: ReactNode;
+  icon?: ReactNode;
+  /** Badge or pill rendered beside the label. */
+  status?: ReactNode;
+  /** The input itself: switch, select, button, link. */
+  control?: ReactNode;
+  /** Extra content below the row, e.g. a disclosure panel. */
+  children?: ReactNode;
+  className?: string;
+}
+
+/** One setting: label and description on the start side, control on the end. */
+export function SettingsRow({
+  id,
+  label,
+  description,
+  icon,
+  status,
+  control,
+  children,
+  className,
+}: SettingsRowProps) {
+  return (
+    <div id={id} className={cn("scroll-mt-16 px-5 py-4 sm:px-6", className)}>
+      <div className="flex flex-col gap-3 sm:flex-row sm:items-center sm:justify-between">
+        <div className="flex min-w-0 gap-3">
+          {icon && (
+            <span className="mt-0.5 flex size-8 shrink-0 items-center justify-center rounded-md border border-border bg-background text-muted-foreground [&>svg]:size-[18px]">
+              {icon}
+            </span>
+          )}
+          <div className="min-w-0">
+            <div className="flex flex-wrap items-center gap-2">
+              <span className="text-sm font-medium text-foreground">
+                {label}
+              </span>
+              {status}
+            </div>
+            {description && (
+              <p className="mt-1 max-w-xl text-sm leading-6 text-muted-foreground">
+                {description}
+              </p>
+            )}
+          </div>
+        </div>
+        {control && (
+          <div className="shrink-0 sm:ms-4 sm:text-end">{control}</div>
+        )}
+      </div>
+      {children && <div className="mt-4">{children}</div>}
+    </div>
+  );
+}

package/src/client/settings/agent-settings-search.ts

@@ -93,7 +93,8 @@ const SETTINGS_SECTION_SEARCH_META: Record<
 > = {
   account: {
     label: "Account",
-    keywords: "profile photo avatar identity signed in email name",
+    keywords:
+      "profile photo avatar identity signed in email name timezone time zone schedule scheduling clock",
   },
   llm: {
     label: "LLM",

package/src/client/settings/index.ts

@@ -34,6 +34,12 @@ export {
   type OpenBuilderConnectPopupOptions,
 } from "./useBuilderStatus.js";
 export { SecretsSection, type SecretsSectionProps } from "./SecretsSection.js";
+export {
+  SettingsGroup,
+  SettingsRow,
+  type SettingsGroupProps,
+  type SettingsRowProps,
+} from "./SettingsRow.js";
 export {
   normalizeSettingsSection,
   settingsSectionDomId,

package/src/integrations/identity.ts

@@ -1,4 +1,4 @@
-import { getDbExec } from "../db/client.js";
+import { isOrgMember as isMemberOfOrg } from "../org/membership.js";
 import { upsertVerifiedIntegrationIdentity } from "./identity-links-store.js";
 import {
   getActiveIntegrationInstallationByKey,
@@ -74,16 +74,6 @@ async function resolveSlackInstallation(incoming: IncomingMessage) {
     : null;
 }
 
-async function isMemberOfOrg(email: string, orgId: string): Promise<boolean> {
-  const { rows } = await getDbExec().execute({
-    sql: `SELECT 1 FROM org_members
-        WHERE org_id = ? AND LOWER(email) = ?
-        LIMIT 1`,
-    args: [orgId, email],
-  });
-  return rows.length > 0;
-}
-
 /**
  * Resolve the default integration principal.
  *
@@ -150,7 +140,7 @@ export async function resolveDefaultIntegrationExecutionContext(
     incoming.tenantId
   ) {
     try {
-      isOrgMember = await isMemberOfOrg(email, installation.orgId);
+      isOrgMember = await isMemberOfOrg(installation.orgId, email);
     } catch {
       // A membership-store outage is not evidence that the sender is merely
       // unlinked. Fail closed instead of widening them to org-wide access.

package/src/jobs/actions/list-automation-runs.ts

@@ -0,0 +1,33 @@
+import { z } from "zod";
+
+import { defineAction } from "../../action.js";
+import { organizationResourceOwner } from "../../resources/store.js";
+import { listAutomationRuns, type AutomationRun } from "../run-history.js";
+
+const scopeSchema = z.enum(["personal", "organization"]);
+
+export default defineAction({
+  description:
+    "List past execution records for one automation or recurring job in the selected scope.",
+  agentTool: false,
+  schema: z.object({
+    name: z.string().min(1),
+    scope: scopeSchema.default("personal"),
+    limit: z.number().int().min(1).max(100).optional(),
+  }),
+  http: { method: "GET" },
+  readOnly: true,
+  parallelSafe: true,
+  run: async ({ name, scope, limit }, ctx): Promise<AutomationRun[]> => {
+    const userEmail = ctx?.userEmail;
+    if (!userEmail) throw new Error("Not authenticated.");
+    if (scope === "organization" && !ctx?.orgId) return [];
+
+    const owner =
+      scope === "organization"
+        ? organizationResourceOwner(ctx.orgId as string)
+        : userEmail;
+
+    return listAutomationRuns({ owners: [owner], automation: name, limit });
+  },
+});

package/src/jobs/actions/list-recurring-jobs.ts

@@ -6,7 +6,12 @@ import {
   resourceGetByPath,
   resourceList,
 } from "../../resources/store.js";
-import { describeCron, isValidCron, nextOccurrence } from "../cron.js";
+import {
+  describeCron,
+  effectiveTimezone,
+  isValidCron,
+  nextOccurrence,
+} from "../cron.js";
 import { classifyJobResource } from "../frontmatter.js";
 import { parseJobFrontmatter } from "../scheduler.js";
 import { authorizeJobMutation } from "../tools.js";
@@ -17,15 +22,25 @@ function jobName(path: string): string {
   return path.replace(/^jobs\//, "").replace(/\.md$/, "");
 }
 
+/**
+ * A stored `nextRun` in the past means the scheduler kept declining to run the
+ * job, not that it is due two days ago. Report the real next occurrence and
+ * let `lastError` carry the reason it keeps being passed over.
+ */
 function nextRun(
   meta: ReturnType<typeof parseJobFrontmatter>["meta"],
 ): string | null {
   if (!meta.enabled) return null;
-  if (meta.nextRun) return meta.nextRun;
-  if (meta.schedule && isValidCron(meta.schedule)) {
-    return nextOccurrence(meta.schedule).toISOString();
+  const scheduled = Boolean(meta.schedule && isValidCron(meta.schedule));
+  if (meta.nextRun) {
+    const stored = new Date(meta.nextRun).getTime();
+    if (!Number.isFinite(stored) || stored > Date.now() || !scheduled) {
+      return meta.nextRun;
+    }
   }
-  return null;
+  return scheduled
+    ? nextOccurrence(meta.schedule, undefined, meta.timezone).toISOString()
+    : null;
 }
 
 export interface RecurringJobActionItem {
@@ -34,10 +49,12 @@ export interface RecurringJobActionItem {
   path: string;
   scope: "personal" | "organization";
   schedule: string;
+  timezone: string;
   scheduleDescription: string;
   instructions: string;
   enabled: boolean;
   lastRun: string | null;
+  lastCheck: string | null;
   lastStatus: string | null;
   lastError: string | null;
   nextRun: string | null;
@@ -87,10 +104,14 @@ export default defineAction({
         path: full.path,
         scope,
         schedule: meta.schedule,
-        scheduleDescription: meta.schedule ? describeCron(meta.schedule) : "",
+        timezone: effectiveTimezone(meta.timezone),
+        scheduleDescription: meta.schedule
+          ? describeCron(meta.schedule, effectiveTimezone(meta.timezone))
+          : "",
         instructions: body,
         enabled: meta.enabled,
         lastRun: meta.lastRun ?? null,
+        lastCheck: meta.lastCheck ?? null,
         lastStatus: meta.lastStatus ?? null,
         lastError: meta.lastError ?? null,
         nextRun: nextRun(meta),

package/src/jobs/actions/manage-recurring-job.ts

@@ -7,8 +7,9 @@ import {
   resourceGetByPath,
   resourcePut,
 } from "../../resources/store.js";
-import { isValidCron, nextOccurrence } from "../cron.js";
+import { isValidCron, isValidTimezone, nextOccurrence } from "../cron.js";
 import { classifyJobResource } from "../frontmatter.js";
+import { deleteAutomationRuns } from "../run-history.js";
 import { buildJobContent, parseJobFrontmatter } from "../scheduler.js";
 import { authorizeJobMutation } from "../tools.js";
 
@@ -23,8 +24,10 @@ export default defineAction({
     name: z.string().min(1),
     scope: scopeSchema.default("personal"),
     enabled: z.boolean().optional(),
+    schedule: z.string().min(1).optional(),
+    timezone: z.string().min(1).optional(),
   }),
-  run: async ({ operation, name, scope, enabled }, ctx) => {
+  run: async ({ operation, name, scope, enabled, schedule, timezone }, ctx) => {
     const userEmail = ctx?.userEmail;
     if (!userEmail) throw new Error("Not authenticated.");
     if (scope === "organization" && !ctx?.orgId) {
@@ -54,17 +57,46 @@ export default defineAction({
 
     if (operation === "delete") {
       await resourceDelete(resource.id);
+      // Names are reusable; history left behind would surface as the run
+      // history of whatever job is next created under this name.
+      await deleteAutomationRuns(resource.owner, name);
       return { deleted: true, name };
     }
 
-    if (enabled === undefined) {
-      throw Object.assign(new Error("enabled is required for update."), {
-        statusCode: 400,
-      });
+    if (timezone !== undefined) {
+      if (!isValidTimezone(timezone)) {
+        throw Object.assign(new Error(`Unknown timezone "${timezone}".`), {
+          statusCode: 400,
+        });
+      }
+      meta.timezone = timezone;
+    }
+    if (
+      enabled === undefined &&
+      schedule === undefined &&
+      timezone === undefined
+    ) {
+      throw Object.assign(
+        new Error("enabled, schedule, or timezone is required for update."),
+        { statusCode: 400 },
+      );
+    }
+    if (schedule !== undefined) {
+      if (!isValidCron(schedule)) {
+        throw Object.assign(
+          new Error(`Invalid cron expression "${schedule}".`),
+          { statusCode: 400 },
+        );
+      }
+      meta.schedule = schedule;
     }
-    meta.enabled = enabled;
-    if (enabled && meta.schedule && isValidCron(meta.schedule)) {
-      meta.nextRun = nextOccurrence(meta.schedule).toISOString();
+    if (enabled !== undefined) meta.enabled = enabled;
+    if (meta.enabled && meta.schedule && isValidCron(meta.schedule)) {
+      meta.nextRun = nextOccurrence(
+        meta.schedule,
+        undefined,
+        meta.timezone,
+      ).toISOString();
     }
     await resourcePut(
       resource.owner,