@agent-native/core 0.227.0 → 0.228.0-nightly-20261110212400

package/dist/client/review/use-review.js

@@ -256,6 +256,9 @@ function matchesCommentQuery(params, comment) {
     const query = params;
     if (query.targetId !== undefined && query.targetId !== comment.targetId)
         return false;
+    if (query.surfaceId !== undefined &&
+        query.surfaceId !== (comment.surfaceId ?? null))
+        return false;
     if (comment.status === "resolved" && !query.includeResolved)
         return false;
     if (comment.status === "deleted" && !query.includeDeleted)
@@ -274,9 +277,16 @@ function optimisticComment(input, id, parent) {
         parentCommentId: parent?.id ?? null,
         targetId: parent?.targetId ??
             ("targetId" in input ? (input.targetId ?? null) : null),
+        surfaceId: parent?.surfaceId ??
+            ("surfaceId" in input ? (input.surfaceId ?? null) : null),
         kind: parent?.kind ?? ("kind" in input ? (input.kind ?? "comment") : "comment"),
         status: "open",
         anchor: parent?.anchor ?? ("anchor" in input ? (input.anchor ?? null) : null),
+        anchorKind: parent?.anchorKind ??
+            ("anchorKind" in input ? (input.anchorKind ?? null) : null),
+        anchorVersion: parent?.anchorVersion ??
+            ("anchorVersion" in input ? (input.anchorVersion ?? null) : null),
+        revision: 1,
         body: input.body,
         authorEmail: null,
         authorName: input.authorName ?? null,
@@ -300,6 +310,35 @@ function optimisticComment(input, id, parent) {
 function replaceComment(comments, previousId, replacement) {
     return comments.map((comment) => comment.id === previousId ? replacement : comment);
 }
+/**
+ * Adds a new comment to a cached list. Oldest first, it lists last, so a page
+ * with more after it is left alone; the comment shows on the last page.
+ */
+export function addOptimisticComment(data, params, comment) {
+    if (!matchesCommentQuery(params, comment))
+        return data;
+    if (isReviewCommentsResult(data) && data.nextCursor)
+        return data;
+    return updateComments(data, (comments) => insertOptimisticComment(comments, comment, params));
+}
+/**
+ * Adds a reply to a cached list that holds its parent. Oldest first, a new
+ * reply lists after every comment there is, so like a new comment it goes
+ * only on the last page.
+ */
+export function addOptimisticReply(data, params, parentId, reply) {
+    if (isReviewCommentsResult(data) && data.nextCursor)
+        return data;
+    return updateComments(data, (comments) => {
+        const parent = comments.find((comment) => comment.id === parentId);
+        if (!parent)
+            return comments;
+        const next = reply(parent);
+        return matchesCommentQuery(params, next)
+            ? insertOptimisticComment(comments, next, params)
+            : comments;
+    });
+}
 export function insertOptimisticComment(comments, comment, params) {
     if (comments.some((item) => item.id === comment.id))
         return comments;
@@ -430,9 +469,7 @@ export function useCreateReviewComment() {
         return {
             action: "list-review-comments",
             resource: input,
-            transform: (data, params) => matchesCommentQuery(params, comment)
-                ? updateComments(data, (comments) => insertOptimisticComment(comments, comment, params))
-                : data,
+            transform: (data, params) => addOptimisticComment(data, params, comment),
             onSuccess: (result) => (data) => updateComments(data, (comments) => replaceComment(comments, id, result)),
         };
     });
@@ -443,15 +480,7 @@ export function useReplyReviewComment() {
         return {
             action: "list-review-comments",
             resource: input,
-            transform: (data, params) => updateComments(data, (comments) => {
-                const parent = comments.find((comment) => comment.id === input.commentId);
-                if (!parent)
-                    return comments;
-                const reply = optimisticComment(input, id, parent);
-                return matchesCommentQuery(params, reply)
-                    ? insertOptimisticComment(comments, reply, params)
-                    : comments;
-            }),
+            transform: (data, params) => addOptimisticReply(data, params, input.commentId, (parent) => optimisticComment(input, id, parent)),
             onSuccess: (result) => (data) => updateComments(data, (comments) => replaceComment(comments, id, result)),
         };
     });

package/dist/client/route-state.js

@@ -4,6 +4,7 @@ import { useLocation, useNavigate, } from "react-router";
 import { isWorkspaceAppPath } from "./api-path.js";
 import { deleteClientAppState, readClientAppState, setClientAppState, } from "./application-state.js";
 import { getBrowserTabId, isBrowserTabIdForCurrentDocument, } from "./browser-tab-id.js";
+import { useBrowserTabUse } from "./browser-tab-use.js";
 import { navigateWithAgentChatViewTransition, } from "./chat-view-transition.js";
 import { postAgentNativeWorkspaceAppRoute } from "./workspace-app-navigation.js";
 const SAFE_BROWSER_TAB_ID_RE = /^[A-Za-z0-9_-]{1,96}$/;
@@ -220,6 +221,7 @@ export function useAgentRouteState(options) {
             return;
         postAgentNativeWorkspaceAppRoute(`${location.pathname}${location.search}${location.hash}`);
     }, [location.hash, location.pathname, location.search, options.enabled]);
+    useBrowserTabUse(`${location.pathname}${location.search}`, options.enabled !== false);
     const navigationKeys = useMemo(() => {
         const scopedKey = appStateKeyForBrowserTab(navigationKey, browserTabId);
         const keys = [scopedKey];

package/dist/client/use-db-sync.d.ts

@@ -53,9 +53,16 @@ export type SyncEvent = {
     requestSource?: string;
     [k: string]: unknown;
 };
-/** What a logged sync invalidation asked: a key prefix, or every query. */
+/**
+ * What a logged sync invalidation asked: a key prefix, a predicate the query
+ * itself must pass, both, or neither for every query. A reader with no query
+ * to ask the predicate of takes it as reaching every query.
+ */
 export type SyncInvalidationFilters = {
     queryKey?: readonly unknown[];
+    predicate?: (query: {
+        queryKey: readonly unknown[];
+    }) => boolean;
 };
 /**
  * The invalidations sync has asked of `queryClient` for changes after

package/dist/client/use-db-sync.js

@@ -247,13 +247,14 @@ function logSyncInvalidations(queryClient, events, filters) {
     const after = local ? "local" : (cursorForEvents(events) ?? "local");
     const log = syncInvalidationLog(queryClient);
     for (const requested of filters) {
-        // A predicate decides by the query itself, so it is kept as reaching
-        // every query.
+        // A predicate decides by the query itself, so it is kept for the reader
+        // to ask of the query it holds.
         log.entries.push({
             after,
-            filters: requested.queryKey && !requested.predicate
-                ? { queryKey: requested.queryKey }
-                : {},
+            filters: {
+                ...(requested.queryKey ? { queryKey: requested.queryKey } : {}),
+                ...(requested.predicate ? { predicate: requested.predicate } : {}),
+            },
         });
     }
     while (log.entries.length > SYNC_INVALIDATION_LOG_LIMIT) {

package/dist/collab/routes.d.ts

@@ -26,9 +26,9 @@ export declare const postCollabUpdate: import("h3").EventHandlerWithFetch<import
     ok: boolean;
 }>>;
 export declare const postCollabText: import("h3").EventHandlerWithFetch<import("h3").EventHandlerRequest, Promise<{
-    text?: undefined;
     ok?: undefined;
     error: string;
+    text?: undefined;
 } | {
     error?: undefined;
     ok: boolean;

package/dist/collab/struct-routes.d.ts

@@ -13,9 +13,9 @@ export declare const postCollabPatch: import("h3").EventHandlerWithFetch<import(
     ok: boolean;
 }>>;
 export declare const getCollabJson: import("h3").EventHandlerWithFetch<import("h3").EventHandlerRequest, Promise<{
+    data?: undefined;
     error: string;
     docId?: undefined;
-    data?: undefined;
 } | {
     error?: undefined;
     docId: string;

package/dist/db/schema-snapshot.generated.js

@@ -38,8 +38,9 @@ export const SCHEMA_SNAPSHOT = {
         'CREATE TABLE "agent_native_embed_session_revocations" (\n  "owner_hash" text NOT NULL,\n  "revoked_before" bigint NOT NULL\n);',
         'CREATE TABLE "agent_native_embed_tickets" (\n  "ticket_hash" text NOT NULL,\n  "owner_email" text NOT NULL,\n  "org_id" text,\n  "target_path" text NOT NULL,\n  "scope" text,\n  "created_at" bigint NOT NULL,\n  "expires_at" bigint NOT NULL,\n  "consumed_at" bigint,\n  "renewal_expires_at" bigint,\n  "session_active_until" bigint,\n  "audience_host" text,\n  "audience_base_path" text\n);',
         'CREATE TABLE "agent_resource_versions" (\n  "id" text NOT NULL,\n  "resource_type" text NOT NULL,\n  "resource_id" text NOT NULL,\n  "version_number" bigint NOT NULL,\n  "created_at" text NOT NULL,\n  "created_by" text,\n  "actor_kind" text DEFAULT \'human\'::text NOT NULL,\n  "owner_email" text,\n  "org_id" text,\n  "visibility" text DEFAULT \'private\'::text NOT NULL,\n  "title" text,\n  "summary" text,\n  "snapshot_json" text NOT NULL,\n  "metadata_json" text\n);',
+        'CREATE TABLE "agent_review_comment_links" (\n  "provider" text NOT NULL,\n  "external_kind" text NOT NULL,\n  "external_id" text NOT NULL,\n  "comment_id" text NOT NULL,\n  "resource_type" text NOT NULL,\n  "resource_id" text NOT NULL,\n  "created_at" text NOT NULL\n);',
         'CREATE TABLE "agent_review_comment_reactions" (\n  "comment_id" text NOT NULL,\n  "actor_email" text NOT NULL,\n  "reaction" text NOT NULL,\n  "created_at" text NOT NULL\n);',
-        'CREATE TABLE "agent_review_comments" (\n  "id" text NOT NULL,\n  "resource_type" text NOT NULL,\n  "resource_id" text NOT NULL,\n  "thread_id" text NOT NULL,\n  "parent_comment_id" text,\n  "target_id" text,\n  "kind" text DEFAULT \'comment\'::text NOT NULL,\n  "status" text DEFAULT \'open\'::text NOT NULL,\n  "anchor_json" text,\n  "body" text NOT NULL,\n  "author_email" text,\n  "author_name" text,\n  "created_by" text DEFAULT \'human\'::text NOT NULL,\n  "resolution_target" text,\n  "reply_route_target" text DEFAULT \'legacy\'::text,\n  "notification_completed_at" text,\n  "mentions_json" text,\n  "owner_email" text,\n  "org_id" text,\n  "visibility" text DEFAULT \'private\'::text NOT NULL,\n  "resolved_by" text,\n  "resolved_at" text,\n  "consumed_at" text,\n  "deleted_by" text,\n  "deleted_at" text,\n  "created_at" text NOT NULL,\n  "updated_at" text NOT NULL,\n  "metadata_json" text\n);',
+        'CREATE TABLE "agent_review_comments" (\n  "id" text NOT NULL,\n  "resource_type" text NOT NULL,\n  "resource_id" text NOT NULL,\n  "thread_id" text NOT NULL,\n  "parent_comment_id" text,\n  "target_id" text,\n  "kind" text DEFAULT \'comment\'::text NOT NULL,\n  "status" text DEFAULT \'open\'::text NOT NULL,\n  "anchor_json" text,\n  "body" text NOT NULL,\n  "author_email" text,\n  "author_name" text,\n  "created_by" text DEFAULT \'human\'::text NOT NULL,\n  "resolution_target" text,\n  "reply_route_target" text DEFAULT \'legacy\'::text,\n  "notification_completed_at" text,\n  "mentions_json" text,\n  "owner_email" text,\n  "org_id" text,\n  "visibility" text DEFAULT \'private\'::text NOT NULL,\n  "resolved_by" text,\n  "resolved_at" text,\n  "consumed_at" text,\n  "deleted_by" text,\n  "deleted_at" text,\n  "created_at" text NOT NULL,\n  "updated_at" text NOT NULL,\n  "metadata_json" text,\n  "surface_id" text,\n  "anchor_kind" text,\n  "anchor_version" integer,\n  "revision" integer DEFAULT 1 NOT NULL\n);',
         'CREATE TABLE "agent_review_notification_deliveries" (\n  "comment_id" text NOT NULL,\n  "recipient_email" text NOT NULL,\n  "claim_token" text NOT NULL,\n  "claimed_at" text NOT NULL,\n  "sent_at" text\n);',
         'CREATE TABLE "agent_review_statuses" (\n  "id" text NOT NULL,\n  "resource_type" text NOT NULL,\n  "resource_id" text NOT NULL,\n  "status" text NOT NULL,\n  "note" text,\n  "updated_by" text,\n  "updated_at" text NOT NULL,\n  "owner_email" text,\n  "org_id" text,\n  "visibility" text DEFAULT \'private\'::text NOT NULL,\n  "metadata_json" text\n);',
         'CREATE TABLE "agent_review_suggestion_amendments" (\n  "idempotency_key" text NOT NULL,\n  "suggestion_id" text NOT NULL,\n  "revision" integer NOT NULL,\n  "author_email" text NOT NULL,\n  "owner_email" text,\n  "org_id" text,\n  "visibility" text DEFAULT \'private\'::text NOT NULL,\n  "request_json" text NOT NULL,\n  "before_json" text NOT NULL,\n  "after_json" text NOT NULL,\n  "created_at" text NOT NULL\n);',
@@ -212,6 +213,7 @@ export const SCHEMA_SNAPSHOT = {
         'ALTER TABLE "agent_native_embed_session_revocations" ADD CONSTRAINT "agent_native_embed_session_revocations_pkey" PRIMARY KEY (owner_hash);',
         'ALTER TABLE "agent_native_embed_tickets" ADD CONSTRAINT "agent_native_embed_tickets_pkey" PRIMARY KEY (ticket_hash);',
         'ALTER TABLE "agent_resource_versions" ADD CONSTRAINT "agent_resource_versions_pkey" PRIMARY KEY (id);',
+        'ALTER TABLE "agent_review_comment_links" ADD CONSTRAINT "agent_review_comment_links_pkey" PRIMARY KEY (provider, external_kind, external_id);',
         'ALTER TABLE "agent_review_comment_reactions" ADD CONSTRAINT "agent_review_comment_reactions_pkey" PRIMARY KEY (comment_id, actor_email, reaction);',
         'ALTER TABLE "agent_review_comments" ADD CONSTRAINT "agent_review_comments_pkey" PRIMARY KEY (id);',
         'ALTER TABLE "agent_review_notification_deliveries" ADD CONSTRAINT "agent_review_notification_deliveries_pkey" PRIMARY KEY (comment_id, recipient_email);',
@@ -432,6 +434,7 @@ export const SCHEMA_SNAPSHOT = {
         "CREATE INDEX idx_agent_resource_versions_org ON public.agent_resource_versions USING btree (org_id, created_at);",
         "CREATE INDEX idx_agent_resource_versions_owner ON public.agent_resource_versions USING btree (owner_email, created_at);",
         "CREATE UNIQUE INDEX idx_agent_resource_versions_resource_number ON public.agent_resource_versions USING btree (resource_type, resource_id, version_number);",
+        "CREATE INDEX idx_agent_review_comment_links_comment ON public.agent_review_comment_links USING btree (comment_id);",
         "CREATE INDEX agent_review_comments_access_owner_lower_idx ON public.agent_review_comments USING btree (lower(owner_email));",
         "CREATE INDEX idx_agent_review_comments_org ON public.agent_review_comments USING btree (org_id, created_at);",
         "CREATE INDEX idx_agent_review_comments_owner ON public.agent_review_comments USING btree (owner_email, created_at);",
@@ -683,6 +686,7 @@ export const SCHEMA_SNAPSHOT = {
         "agent_native_embed_session_revocations",
         "agent_native_embed_tickets",
         "agent_resource_versions",
+        "agent_review_comment_links",
         "agent_review_comment_reactions",
         "agent_review_comments",
         "agent_review_notification_deliveries",
@@ -1179,6 +1183,7 @@ export const SCHEMA_SNAPSHOT = {
         ["resources", "visibility-expires-index", null],
         ["resources", "widen-bigint", null],
         ["review", "baseline", null],
+        ["review", "storage-contract", "ed0e701a19ad1c15"],
         ["review_suggestions", "baseline", null],
         ["sandbox_executions", "baseline", null],
         [

package/dist/file-upload/actions/upload-image.d.ts

@@ -33,9 +33,9 @@ declare const _default: import("../../action.js").ActionDefinition<{
     idempotencyKey: string;
     deleted: boolean;
 } | {
+    id?: undefined;
     error: string;
     url?: undefined;
-    id?: undefined;
     provider?: undefined;
     configured?: undefined;
 } | {
@@ -45,8 +45,8 @@ declare const _default: import("../../action.js").ActionDefinition<{
     provider: string;
     configured?: undefined;
 } | {
-    url?: undefined;
     id?: undefined;
+    url?: undefined;
     provider?: undefined;
     error: string;
     configured: boolean;

package/dist/file-upload/index.d.ts

@@ -2,7 +2,7 @@ export type { FileUploadDeleteInput, FileUploadInput, FileUploadProvider, FileUp
 export { registerFileUploadProvider, unregisterFileUploadProvider, listFileUploadProviders, getActiveFileUploadProvider, getActiveFileUploadProviderForRequest, deleteUploadedFile, uploadFile, } from "./registry.js";
 export { builderFileUploadProvider } from "./builder.js";
 export { getBuilderUploadCredentialStatus } from "./status.js";
-export { ensureS3FileUploadProvider, s3FileUploadProvider } from "./s3.js";
+export { ensureS3FileUploadProvider, S3RequestError, s3FileUploadProvider, } from "./s3.js";
 export { cancelS3ResponseBody, fetchS3WithTimeout, presignS3GetUrl, readS3ErrorText, rfc3986, s3ObjectUri, sha256Hex, signS3Request, signedS3Request, trustedDeploymentS3Origin, type PresignS3GetOptions, type S3ClientConfig, type S3Method, type SignedS3RequestOptions, } from "./s3-client.js";
 export { FILE_STORAGE_SECRET_KEYS, getFileStorageStatus, saveFileStorage, clearFileStorage, type FileStorageField, type FileStorageProviderId, type FileStorageStatus, type SaveFileStorageInput, } from "./storage-settings.js";
 export { preUploadImageAttachments, preUploadAttachments, isFileUploadProviderConfigured, type PreUploadAttachmentsResult, type PreUploadedImageAttachment, type PreUploadedFileAttachment, } from "./pre-upload-attachments.js";

package/dist/file-upload/index.js

@@ -1,7 +1,7 @@
 export { registerFileUploadProvider, unregisterFileUploadProvider, listFileUploadProviders, getActiveFileUploadProvider, getActiveFileUploadProviderForRequest, deleteUploadedFile, uploadFile, } from "./registry.js";
 export { builderFileUploadProvider } from "./builder.js";
 export { getBuilderUploadCredentialStatus } from "./status.js";
-export { ensureS3FileUploadProvider, s3FileUploadProvider } from "./s3.js";
+export { ensureS3FileUploadProvider, S3RequestError, s3FileUploadProvider, } from "./s3.js";
 export { cancelS3ResponseBody, fetchS3WithTimeout, presignS3GetUrl, readS3ErrorText, rfc3986, s3ObjectUri, sha256Hex, signS3Request, signedS3Request, trustedDeploymentS3Origin, } from "./s3-client.js";
 export { FILE_STORAGE_SECRET_KEYS, getFileStorageStatus, saveFileStorage, clearFileStorage, } from "./storage-settings.js";
 export { preUploadImageAttachments, preUploadAttachments, isFileUploadProviderConfigured, } from "./pre-upload-attachments.js";

package/dist/file-upload/s3.d.ts

@@ -1,3 +1,12 @@
 import type { FileUploadProvider } from "./types.js";
+/**
+ * A request the bucket answered with an error. `status` lets callers tell a
+ * refused bucket (401, 403, or 404 for a missing bucket) from an outage.
+ */
+export declare class S3RequestError extends Error {
+    readonly provider = "s3";
+    readonly status: number;
+    constructor(message: string, status: number);
+}
 export declare const s3FileUploadProvider: FileUploadProvider;
 export declare function ensureS3FileUploadProvider(): void;

package/dist/file-upload/s3.js

@@ -103,6 +103,19 @@ async function readRequestConfig() {
     await prefetchSecrets(STORAGE_SECRET_KEYS);
     return (await readSavedConfig()) ?? readEnvConfig();
 }
+/**
+ * A request the bucket answered with an error. `status` lets callers tell a
+ * refused bucket (401, 403, or 404 for a missing bucket) from an outage.
+ */
+export class S3RequestError extends Error {
+    provider = "s3";
+    status;
+    constructor(message, status) {
+        super(message);
+        this.name = "S3RequestError";
+        this.status = status;
+    }
+}
 const PUT_TIMEOUT_MS = 120_000;
 const DELETE_TIMEOUT_MS = 30_000;
 function encodeKey(key) {
@@ -117,7 +130,7 @@ async function putObject(config, key, data, contentType) {
     });
     if (!response.ok) {
         const detail = await readS3ErrorText(response);
-        throw new Error(`S3 PutObject failed (${response.status}): ${detail || response.statusText}`);
+        throw new S3RequestError(`S3 PutObject failed (${response.status}): ${detail || response.statusText}`, response.status);
     }
     await cancelS3ResponseBody(response);
     return `${config.publicBaseUrl}/${encodeKey(key)}`;

package/dist/framework-package-versions.json

@@ -1,17 +1,17 @@
 {
-  "@agent-native/agentkit": "0.227.0",
+  "@agent-native/agentkit": "0.228.0-nightly-20261110212400",
   "@agent-native/code-agents-ui": "0.1.75",
-  "@agent-native/core": "0.227.0",
-  "@agent-native/core-corpus": "0.227.0",
+  "@agent-native/core": "0.228.0-nightly-20261110212400",
+  "@agent-native/core-corpus": "0.228.0-nightly-20261110212400",
   "@agent-native/creative-context": "0.8.69",
-  "@agent-native/dispatch": "0.42.4",
+  "@agent-native/dispatch": "0.42.5-nightly-20261110212400",
   "@agent-native/embedding": "0.2.0",
   "@agent-native/migrate": "0.0.7",
   "@agent-native/otel": "0.1.36",
   "@agent-native/pinpoint": "0.1.112",
   "@agent-native/recap-cli": "0.5.100",
-  "@agent-native/scheduling": "0.2.56",
+  "@agent-native/scheduling": "0.2.57-nightly-20261110212400",
   "@agent-native/shared-app-config": "0.1.2",
-  "@agent-native/skills": "0.4.4",
-  "@agent-native/toolkit": "0.227.0"
+  "@agent-native/skills": "0.4.5-nightly-20261110212400",
+  "@agent-native/toolkit": "0.228.0-nightly-20261110212400"
 }

package/dist/jobs/scheduler.js

@@ -28,10 +28,6 @@ const MAX_PAUSED_RECHECKS_PER_TICK = 8;
 const PAUSED_RECHECK_MS = 15 * 60_000;
 const _activeScheduledJobs = new Set();
 const _preflightingScheduledJobs = new Set();
-let _hasJobsCache;
-let _lastJobsCheck = 0;
-const JOBS_CHECK_INTERVAL_MS = 5 * 60_000;
-let _emitterSubscribed = false;
 async function recordSchedulerHealthForScopes(input) {
     const orgIds = [...new Set(input.orgIds)];
     const scopes = orgIds.length > 0 ? orgIds : [null];
@@ -49,22 +45,6 @@ async function recordSchedulerHealthForScopes(input) {
         }
     }
 }
-function subscribeToJobsResourceEvents() {
-    if (_emitterSubscribed)
-        return;
-    _emitterSubscribed = true;
-    import("../resources/emitter.js")
-        .then(({ getResourcesEmitter }) => {
-        getResourcesEmitter().on("resources", (event) => {
-            if (typeof event?.path === "string" && event.path.startsWith("jobs/")) {
-                _hasJobsCache = undefined;
-            }
-        });
-    })
-        .catch((err) => {
-        console.warn("[jobs] resource-event subscription failed:", err instanceof Error ? err.message : err);
-    });
-}
 export async function processRecurringJobs(deps) {
     const leaseOwner = await acquireAutomationSchedulerLease({
         appId: deps.appId,
@@ -122,7 +102,6 @@ export async function processRecurringJobs(deps) {
         throw releaseErrorToThrow;
 }
 async function processRecurringJobsWithLease(deps, leaseSignal, assertCanStart) {
-    subscribeToJobsResourceEvents();
     try {
         const { runUploadReceiptCleanupOnce } = await import("../file-upload/actions/upload-image.js");
         await runUploadReceiptCleanupOnce();
@@ -147,26 +126,18 @@ async function processRecurringJobsWithLease(deps, leaseSignal, assertCanStart)
         orgIds: [],
         checkedAt: nowMs,
     });
-    if (_hasJobsCache === false &&
-        nowMs - _lastJobsCheck < JOBS_CHECK_INTERVAL_MS) {
-        await recordSchedulerHealthForScopes({
-            appId: deps.appId,
-            orgIds: [],
-            checkedAt: nowMs,
-        });
-        return;
-    }
     const reservedJobKeys = new Set();
     const startedJobKeys = new Set();
     const healthOrgIds = new Set();
     let healthError = null;
     let dispatchedAt;
     try {
+        // Read jobs/ on every tick. Any instance can create an automation, so a
+        // remembered "no jobs" here would hold its first run back until it lapsed.
         const jobResources = await resourceListAllOwners("jobs/");
-        _hasJobsCache = jobResources.some((r) => r.path.endsWith(".md") && !r.path.endsWith(".keep"));
-        _lastJobsCheck = nowMs;
-        if (!_hasJobsCache)
+        if (!jobResources.some((r) => r.path.endsWith(".md") && !r.path.endsWith(".keep"))) {
             return;
+        }
         const now = new Date();
         const dueJobCandidates = [];
         const pausedRechecks = [];
@@ -439,8 +410,6 @@ async function processRecurringJobsWithLease(deps, leaseSignal, assertCanStart)
         const { isConnectionError } = await import("../db/client.js");
         if (isConnectionError(err)) {
             healthError = "The scheduler could not reach the database.";
-            _hasJobsCache = undefined;
-            _lastJobsCheck = 0;
             return;
         }
         const detail = err instanceof Error

package/dist/mcp/browser-tab-target.d.ts

@@ -0,0 +1,16 @@
+import { type BrowserTabTarget, type BrowserTabTargetSlot } from "../server/request-context.js";
+/**
+ * An MCP tool call comes from no browser tab, so tab-scoped app state
+ * (navigation, navigate commands, selection) would otherwise fall back to
+ * account-wide rows no tab keeps current. This slot points the call at the
+ * tab of this app the user used last. The lookup runs only when the call
+ * first reads or writes tab-scoped state.
+ */
+export declare function createBrowserTabTargetSlot(): BrowserTabTargetSlot;
+/**
+ * Tells the calling agent which tab a call's tab-scoped reads and writes
+ * reached, since nothing in the call itself says so.
+ */
+export declare function browserTabTargetNote(target: BrowserTabTarget, now?: number): string;
+/** Adds the tab note to a successful tool result that used tab-scoped state. */
+export declare function withBrowserTabTargetNote<T>(result: T, slot: BrowserTabTargetSlot | undefined): T;

package/dist/mcp/browser-tab-target.js

@@ -0,0 +1,58 @@
+import { findLastUsedBrowserTab, LAST_USED_BROWSER_TAB_MAX_AGE_MS, } from "../application-state/last-used-tab.js";
+import { getRequestUserEmail, } from "../server/request-context.js";
+/**
+ * An MCP tool call comes from no browser tab, so tab-scoped app state
+ * (navigation, navigate commands, selection) would otherwise fall back to
+ * account-wide rows no tab keeps current. This slot points the call at the
+ * tab of this app the user used last. The lookup runs only when the call
+ * first reads or writes tab-scoped state.
+ */
+export function createBrowserTabTargetSlot() {
+    let pending;
+    const slot = {
+        resolve() {
+            pending ??= (async () => {
+                const userEmail = getRequestUserEmail();
+                const target = userEmail
+                    ? await findLastUsedBrowserTab(userEmail)
+                    : { kind: "unavailable" };
+                slot.resolved = target;
+                return target;
+            })();
+            return pending;
+        },
+    };
+    return slot;
+}
+function usedAgo(usedAt, now) {
+    const minutes = Math.floor(Math.max(0, now - usedAt) / 60_000);
+    if (minutes < 1)
+        return "less than a minute ago";
+    if (minutes < 60)
+        return `${minutes} min ago`;
+    return `${Math.floor(minutes / 60)} h ago`;
+}
+/**
+ * Tells the calling agent which tab a call's tab-scoped reads and writes
+ * reached, since nothing in the call itself says so.
+ */
+export function browserTabTargetNote(target, now = Date.now()) {
+    if (target.kind === "last-used") {
+        return `Browser tab: this call used the user's most recently used tab of this app (last used ${usedAgo(target.usedAt, now)}). A navigate command reaches that tab only while it stays open, and this result doesn't confirm that it moved.`;
+    }
+    const hours = Math.round(LAST_USED_BROWSER_TAB_MAX_AGE_MS / 3_600_000);
+    return `Browser tab: no tab of this app was used in the last ${hours} hours, so there was no on-screen state to read and a navigate command won't move any tab. Ask the user to open the app in a browser tab, then retry.`;
+}
+/** Adds the tab note to a successful tool result that used tab-scoped state. */
+export function withBrowserTabTargetNote(result, slot) {
+    const target = slot?.resolved;
+    if (!target || !result || typeof result !== "object")
+        return result;
+    const { content, isError } = result;
+    if (isError === true || !Array.isArray(content))
+        return result;
+    return {
+        ...result,
+        content: [...content, { type: "text", text: browserTabTargetNote(target) }],
+    };
+}

package/dist/mcp/build-server.js

@@ -24,6 +24,7 @@ import { mcpApprovalPrompt, mcpApprovalRelativeLinkNote, mcpApprovalReviewUrl, }
 import { mcpApprovalAppId } from "./approval-store.js";
 export { isAutoReadExcludedActionName } from "./action-eligibility.js";
 import { isMcpAppsInlineEnabled } from "./app-cards-lab.js";
+import { createBrowserTabTargetSlot, withBrowserTabTargetNote, } from "./browser-tab-target.js";
 import { getBuiltinCrossAppTools } from "./builtin-tools.js";
 import { MCP_CONNECT_OAUTH_CLIENT_ID, MCP_CONNECT_SCOPE, } from "./connect-store.js";
 import { createDirectActionCall } from "./direct-action-call.js";
@@ -2159,7 +2160,7 @@ export async function createMCPServerForRequest(config, identity, requestMeta) {
         callerAuthUserId ??= import("../server/better-auth-instance.js").then(({ findBetterAuthUserIdForEmail }) => findBetterAuthUserIdForEmail(email));
         return callerAuthUserId;
     }
-    async function withCallerContext(fn, mcpRequestId, authUserId) {
+    async function withCallerContext(fn, mcpRequestId, authUserId, run) {
         const orgId = await orgIdPromise;
         return runWithRequestContext({
             userEmail: effectiveIdentity?.userEmail,
@@ -2178,10 +2179,16 @@ export async function createMCPServerForRequest(config, identity, requestMeta) {
                 : {}),
             ...(mcpRequestId ? { mcpRequestId } : {}),
             mcpCredentialIssuedAtMs: effectiveIdentity?.mcpCredentialIssuedAtMs ?? null,
+            ...(run ? { run } : {}),
         }, fn);
     }
     async function withToolCallContext(fn, mcpRequestId) {
-        return withCallerContext(fn, mcpRequestId, await resolveCallerAuthUserId());
+        // Only a signed-in person has browser tabs for a call to act on.
+        const browserTabTarget = hasVerifiedMcpUserIdentity(effectiveIdentity)
+            ? createBrowserTabTargetSlot()
+            : undefined;
+        const result = await withCallerContext(fn, mcpRequestId, await resolveCallerAuthUserId(), browserTabTarget ? { browserTabTarget } : undefined);
+        return withBrowserTabTargetNote(result, browserTabTarget);
     }
     const actionCallContext = {
         appId: config.appId,

package/dist/notifications/routes.d.ts

@@ -1,12 +1,12 @@
 export declare function createNotificationsHandler(): import("h3").EventHandlerWithFetch<import("h3").EventHandlerRequest, Promise<"" | import("./types.js").Notification[] | {
+    error?: undefined;
     count: number;
     updated?: undefined;
-    error?: undefined;
     ok?: undefined;
 } | {
+    error?: undefined;
     count?: undefined;
     updated: number;
-    error?: undefined;
     ok?: undefined;
 } | {
     count?: undefined;
@@ -14,8 +14,8 @@ export declare function createNotificationsHandler(): import("h3").EventHandlerW
     error: string;
     ok?: undefined;
 } | {
+    error?: undefined;
     count?: undefined;
     updated?: undefined;
-    error?: undefined;
     ok: boolean;
 }>>;

package/dist/org/handlers.d.ts

@@ -90,9 +90,9 @@ export declare const setWorkspaceAppDefaultVisibilityHandler: import("h3").Event
     visibility: WorkspaceAppDefaultVisibility;
 }>>;
 export declare const createOrgHandler: import("h3").EventHandlerWithFetch<import("h3").EventHandlerRequest, Promise<{
+    name?: undefined;
     success: boolean;
     id?: undefined;
-    name?: undefined;
     role?: undefined;
 } | {
     success?: undefined;

package/dist/progress/routes.d.ts

@@ -1,6 +1,6 @@
 export declare function createProgressHandler(): import("h3").EventHandlerWithFetch<import("h3").EventHandlerRequest, Promise<"" | import("./types.js").AgentRun | import("./types.js").AgentRun[] | {
-    error: string;
     ok?: undefined;
+    error: string;
 } | {
     error?: undefined;
     ok: boolean;

package/dist/provider-api/actions/custom-provider-registration.d.ts

@@ -76,7 +76,10 @@ export declare function createCustomProviderRegistrationAction<TSchema extends Z
     }>>;
 }, z.core.$strip>>, {
     id?: undefined;
+    deleted?: undefined;
+    provider?: undefined;
     message?: undefined;
+    found?: undefined;
     providers: {
         id: string;
         label: string;
@@ -87,47 +90,44 @@ export declare function createCustomProviderRegistrationAction<TSchema extends Z
         updatedAt: number;
     }[];
     count: number;
-    provider?: undefined;
-    found?: undefined;
-    deleted?: undefined;
     registered?: undefined;
     label?: undefined;
 } | {
     id?: undefined;
+    deleted?: undefined;
     count?: undefined;
     message?: undefined;
     providers?: undefined;
     found: boolean;
     provider: import("../custom-registry.js").CustomProviderConfig;
-    deleted?: undefined;
     registered?: undefined;
     label?: undefined;
 } | {
+    deleted?: undefined;
+    provider?: undefined;
     count?: undefined;
     message?: undefined;
     providers?: undefined;
-    provider?: undefined;
     found: boolean;
     id: string;
-    deleted?: undefined;
     registered?: undefined;
     label?: undefined;
 } | {
+    provider?: undefined;
     count?: undefined;
     message?: undefined;
-    providers?: undefined;
-    provider?: undefined;
     found?: undefined;
+    providers?: undefined;
     deleted: boolean;
     id: string;
     registered?: undefined;
     label?: undefined;
 } | {
-    count?: undefined;
-    providers?: undefined;
+    deleted?: undefined;
     provider?: undefined;
+    count?: undefined;
     found?: undefined;
-    deleted?: undefined;
+    providers?: undefined;
     registered: boolean;
     id: string;
     label: string;