@agent-native/core 0.213.1 → 0.216.0

package/dist/agent/thread-data-builder.js

@@ -1329,6 +1329,22 @@ export function claimQueuedMessage(repo, messageId) {
     normalized[CLAIMED_QUEUED_MESSAGE_IDS_KEY] = [...claimed, messageId].slice(-MAX_CLAIMED_QUEUED_MESSAGE_IDS);
     return pruneClaimedQueuedMessages(normalized);
 }
+function reconcileDirectSubmissionQueue(repo, userCustom) {
+    if (!userCustom ||
+        typeof userCustom !== "object" ||
+        Array.isArray(userCustom)) {
+        return repo;
+    }
+    const messageId = userCustom.agentKitMessageId;
+    if (typeof messageId !== "string" ||
+        !Array.isArray(repo?.queuedMessages) ||
+        !repo.queuedMessages.some((message) => message &&
+            typeof message === "object" &&
+            message.id === messageId)) {
+        return repo;
+    }
+    return claimQueuedMessage(repo, messageId);
+}
 export function applySubmittedUserMessage(repo, userMessage, queuedMessage) {
     const userCustom = userMessage.metadata.custom;
     const wasSubmitted = queuedMessage && Array.isArray(repo?.messages)
@@ -1370,7 +1386,10 @@ export function applySubmittedUserMessage(repo, userMessage, queuedMessage) {
                 custom.submittedRunId === submittedRunId);
         });
     if (wasDirectlySubmitted) {
-        return { status: "already_submitted", repo };
+        return {
+            status: "already_submitted",
+            repo: reconcileDirectSubmissionQueue(repo, userCustom),
+        };
     }
     if (userCustom &&
         Object.prototype.hasOwnProperty.call(userCustom, AGENT_NATIVE_SUBMISSION_EXPIRES_AT_METADATA_KEY)) {
@@ -1382,7 +1401,10 @@ export function applySubmittedUserMessage(repo, userMessage, queuedMessage) {
         }
     }
     if (!queuedMessage) {
-        return { status: "submitted", repo: upsertUserMessage(repo, userMessage) };
+        return {
+            status: "submitted",
+            repo: upsertUserMessage(reconcileDirectSubmissionQueue(repo, userCustom), userMessage),
+        };
     }
     if (hasClaimedQueuedMessage(repo, queuedMessage.id)) {
         return { status: "already_claimed" };
@@ -2978,9 +3000,9 @@ export function mergeThreadDataForClientSave(existingRepo, incomingRepo, options
             }
         }
     }
-    // Queue mutations are the only writer of the queue and opt out here. Any
-    // other save carries a queue it read earlier, and letting that copy win drops
-    // a promotion claim or an append that landed in between.
+    // Queue mutations own the queue; a submitted-message marker can remove its
+    // matching row. Other saves carry a queue they read earlier, and letting
+    // that copy win drops a promotion claim or an append that landed in between.
     if (preserveExistingQueuedMessages) {
         if (existingNormalized?.queuedMessages !== undefined) {
             merged.queuedMessages = existingNormalized.queuedMessages;

package/dist/agent/types.d.ts

@@ -1,4 +1,4 @@
-import type { AgentSubmissionPayload, AgentSuggestion } from "@agent-native/agentkit/protocol";
+import type { AgentSubmissionReference, AgentSubmissionPayload, AgentRunOptions, AgentSuggestion } from "@agent-native/agentkit/protocol";
 import type { A2AAgentActivitySnapshot } from "../a2a/activity.js";
 import type { ActionChatUIConfig } from "../action-ui.js";
 import type { WriteReceipt } from "../action.js";
@@ -84,17 +84,7 @@ export interface AgentChatStructuredMessage {
     role: "user" | "assistant";
     content: AgentChatStructuredContentPart[];
 }
-export interface AgentChatReference {
-    type: "file" | "skill" | "mention" | "agent" | "custom-agent";
-    path: string;
-    name: string;
-    source: string;
-    refType?: string;
-    refId?: string;
-    slotKey?: string;
-    slotLabel?: string;
-    metadata?: Record<string, unknown>;
-}
+export type AgentChatReference = AgentSubmissionReference;
 export type MentionItemMedia = {
     type: "text";
     text: string;
@@ -144,6 +134,8 @@ export interface MentionProvider {
 export interface AgentChatAttachment {
     type: string;
     name: string;
+    id?: string;
+    mediaType?: string;
     displayOnly?: boolean;
     data?: string;
     url?: string;
@@ -153,6 +145,7 @@ export interface AgentChatAttachment {
     storageRequired?: boolean;
     storageUploadFailed?: boolean;
     contentType?: string;
+    referenceUrl?: string;
     text?: string;
 }
 export interface AgentChatScope {
@@ -169,6 +162,7 @@ export interface AgentChatRequest {
     agentKitMessageId?: string;
     /** Original queue-shaped submit used for idempotent direct/queued admission. */
     submissionPayload?: AgentSubmissionPayload;
+    options?: AgentRunOptions;
     actionScope?: AgentActionScope;
     queuedMessageId?: string;
     queuedMessageClaimId?: string;

package/dist/agentkit/capabilities.d.ts

@@ -1,5 +1,5 @@
 import type { CredentialContext } from "../credentials/index.js";
-export type AgentKitCapabilityAppId = "design" | "slides";
+export type AgentKitCapabilityAppId = "design" | "slides" | "slides-2";
 export interface AgentKitIntegrationCapability {
     id: string;
     label: string;

package/dist/appearance/actions/get-theme-family.d.ts

@@ -0,0 +1,8 @@
+import { type ThemeFamily } from "../theme-family.js";
+export interface ThemeFamilyPreference {
+    family: ThemeFamily;
+    source: "default" | "user-setting";
+    appId: string | null;
+}
+declare const _default: import("../../action.js").ActionDefinition<Record<string, never>, ThemeFamilyPreference>;
+export default _default;

package/dist/appearance/actions/get-theme-family.js

@@ -0,0 +1,38 @@
+import { z } from "zod";
+import { defineAction, fail } from "../../action.js";
+import { getUserSetting } from "../../settings/user-settings.js";
+import { DEFAULT_THEME_FAMILY, THEME_FAMILIES, themeFamilySettingKey, } from "../theme-family.js";
+export default defineAction({
+    description: "Read the current app's saved theme family, which is independent of light or dark color mode.",
+    schema: z.object({}),
+    http: { method: "GET" },
+    readOnly: true,
+    agentTool: false,
+    run: async (_args, ctx) => {
+        const email = ctx?.userEmail;
+        if (!email)
+            fail("Not authenticated.", { statusCode: 401 });
+        const stored = await getUserSetting(email, themeFamilySettingKey(ctx?.appId));
+        if (stored === null) {
+            return {
+                family: DEFAULT_THEME_FAMILY,
+                source: "default",
+                appId: ctx?.appId ?? null,
+            };
+        }
+        const parsed = z
+            .object({ family: z.enum(THEME_FAMILIES) })
+            .safeParse(stored);
+        if (!parsed.success) {
+            fail("The saved theme family setting is invalid and could not be read.", {
+                errorCode: "theme_family_setting_invalid",
+                statusCode: 500,
+            });
+        }
+        return {
+            family: parsed.data.family,
+            source: "user-setting",
+            appId: ctx?.appId ?? null,
+        };
+    },
+});

package/dist/appearance/actions/set-theme-family.d.ts

@@ -0,0 +1,7 @@
+declare const _default: import("../../action.js").ActionDefinition<{
+    family: "agent-native" | "original";
+}, {
+    family: "agent-native" | "original";
+    appId: string;
+}>;
+export default _default;

package/dist/appearance/actions/set-theme-family.js

@@ -0,0 +1,33 @@
+import { z } from "zod";
+import { defineAction, fail } from "../../action.js";
+import { writeAppState } from "../../application-state/script-helpers.js";
+import { putUserSetting } from "../../settings/user-settings.js";
+import { THEME_FAMILIES, themeFamilyAppStateKey, themeFamilySettingKey, } from "../theme-family.js";
+export default defineAction({
+    description: "Set the current app's theme family to agent-native or original. This is separate from light or dark color mode.",
+    schema: z.object({
+        family: z
+            .enum(THEME_FAMILIES)
+            .describe("Theme family: agent-native or original."),
+    }),
+    http: { method: "POST" },
+    mcpAnnotations: {
+        readOnlyHint: false,
+        destructiveHint: false,
+        openWorldHint: false,
+    },
+    run: async ({ family }, ctx) => {
+        const email = ctx?.userEmail;
+        if (!email)
+            fail("Not authenticated.", { statusCode: 401 });
+        const settingKey = themeFamilySettingKey(ctx?.appId);
+        await putUserSetting(email, settingKey, { family });
+        try {
+            await writeAppState(themeFamilyAppStateKey(ctx?.appId), { family });
+        }
+        catch {
+            fail("The theme family was saved, but the open app could not be synchronized.", { errorCode: "theme_family_sync_failed", statusCode: 503 });
+        }
+        return { family, appId: ctx?.appId ?? null };
+    },
+});

package/dist/appearance/theme-family.d.ts

@@ -0,0 +1,13 @@
+export declare const THEME_FAMILIES: readonly ["agent-native", "original"];
+export type ThemeFamily = (typeof THEME_FAMILIES)[number];
+export declare const DEFAULT_THEME_FAMILY: ThemeFamily;
+export declare const THEME_FAMILY_STORAGE_KEY = "theme-family";
+export declare const THEME_FAMILY_ATTRIBUTE = "data-theme-family";
+export declare const THEME_FAMILY_STATUS_ATTRIBUTE = "data-theme-family-status";
+export declare const THEME_FAMILY_APP_STATE_KEY = "theme-family";
+export declare const THEME_FAMILY_SETTING_PREFIX = "theme-family";
+export declare function isThemeFamily(value: unknown): value is ThemeFamily;
+export declare function themeFamilySettingKey(appId?: string): string;
+export declare function themeFamilyStorageKey(appId?: string): string;
+export declare function themeFamilyAppStateKey(appId?: string): string;
+export declare function getThemeFamilyInitScript(appId?: string | null): string;

package/dist/appearance/theme-family.js

@@ -0,0 +1,38 @@
+export const THEME_FAMILIES = ["agent-native", "original"];
+export const DEFAULT_THEME_FAMILY = "original";
+export const THEME_FAMILY_STORAGE_KEY = "theme-family";
+export const THEME_FAMILY_ATTRIBUTE = "data-theme-family";
+export const THEME_FAMILY_STATUS_ATTRIBUTE = "data-theme-family-status";
+export const THEME_FAMILY_APP_STATE_KEY = "theme-family";
+export const THEME_FAMILY_SETTING_PREFIX = "theme-family";
+export function isThemeFamily(value) {
+    return value === "agent-native" || value === "original";
+}
+export function themeFamilySettingKey(appId) {
+    // Older or standalone action contexts can genuinely omit appId. Keep their
+    // setting isolated under one stable fallback rather than borrowing another app's choice.
+    if (appId === undefined)
+        return `${THEME_FAMILY_SETTING_PREFIX}:__no_app_id__`;
+    const normalizedAppId = appId.trim().toLowerCase();
+    if (!normalizedAppId) {
+        throw new TypeError("Theme family settings require a non-empty appId.");
+    }
+    return `${THEME_FAMILY_SETTING_PREFIX}:${encodeURIComponent(normalizedAppId)}`;
+}
+export function themeFamilyStorageKey(appId) {
+    return themeFamilySettingKey(appId);
+}
+export function themeFamilyAppStateKey(appId) {
+    if (appId === undefined)
+        return `${THEME_FAMILY_APP_STATE_KEY}:__no_app_id__`;
+    const normalizedAppId = appId.trim().toLowerCase();
+    if (!normalizedAppId) {
+        throw new TypeError("Theme family application state requires a non-empty appId.");
+    }
+    const encodedAppId = Array.from(normalizedAppId, (character) => character.codePointAt(0).toString(16)).join("_");
+    return `${THEME_FAMILY_APP_STATE_KEY}:${encodedAppId}`;
+}
+export function getThemeFamilyInitScript(appId) {
+    const storageKey = themeFamilyStorageKey(appId ?? undefined);
+    return `(function(){var root=document.documentElement;var fallback=${JSON.stringify(DEFAULT_THEME_FAMILY)};try{var value=window.localStorage.getItem(${JSON.stringify(storageKey)});if(value===null){root.setAttribute(${JSON.stringify(THEME_FAMILY_ATTRIBUTE)},fallback);root.setAttribute(${JSON.stringify(THEME_FAMILY_STATUS_ATTRIBUTE)},'awaiting-app-setting');return}if(value==='agent-native'||value==='original'){root.setAttribute(${JSON.stringify(THEME_FAMILY_ATTRIBUTE)},value);root.removeAttribute(${JSON.stringify(THEME_FAMILY_STATUS_ATTRIBUTE)});return}root.setAttribute(${JSON.stringify(THEME_FAMILY_ATTRIBUTE)},fallback);root.setAttribute(${JSON.stringify(THEME_FAMILY_STATUS_ATTRIBUTE)},'invalid')}catch(e){root.setAttribute(${JSON.stringify(THEME_FAMILY_ATTRIBUTE)},fallback);root.setAttribute(${JSON.stringify(THEME_FAMILY_STATUS_ATTRIBUTE)},'unreadable')}})();`;
+}

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

@@ -25,4 +25,9 @@ export declare function appStateListByKeyPrefix(keyPrefix: string, limit?: numbe
     key: string;
     value: Record<string, unknown>;
 }>>;
+/** Lists metadata for maintenance keys within the current app namespace. */
+export declare function appStateListKeysByKeySuffixPrefix(suffixPrefix: string, limit?: number): Promise<Array<{
+    sessionId: string;
+    key: string;
+}>>;
 export declare function appStateDeleteByPrefix(sessionId: string, keyPrefix: string, options?: StoreWriteOptions): Promise<number>;

package/dist/application-state/store.js

@@ -1,3 +1,4 @@
+import { getAppConfig } from "../app-config/index.js";
 import { getDbExec, isLocalDatabase } from "../db/client.js";
 import { ensureIndexExists, ensureTableExists } from "../db/ddl-guard.js";
 import { defineStore } from "../db/store-registry.js";
@@ -227,6 +228,31 @@ export async function appStateListByKeyPrefix(keyPrefix, limit = 100) {
         value: JSON.parse(row.value),
     }));
 }
+/** Lists metadata for maintenance keys within the current app namespace. */
+export async function appStateListKeysByKeySuffixPrefix(suffixPrefix, limit = 100) {
+    if (!suffixPrefix || suffixPrefix.startsWith(":")) {
+        throw new Error("Cross-session application-state scans require a non-empty key suffix prefix.");
+    }
+    const keyPrefix = `${getAppStateMaintenanceNamespacePrefix()}${suffixPrefix}`;
+    await ensureTable();
+    const client = getDbExec();
+    const boundedLimit = Math.max(1, Math.min(Math.floor(limit), 2_048));
+    const { rows } = await client.execute({
+        sql: `SELECT session_id, key FROM application_state WHERE key LIKE ? ESCAPE '!' ORDER BY updated_at ASC LIMIT ?`,
+        args: [escapeLike(keyPrefix) + "%", boundedLimit],
+    });
+    return rows.map((row) => ({
+        sessionId: row.session_id,
+        key: row.key,
+    }));
+}
+function getAppStateMaintenanceNamespacePrefix() {
+    const namespace = getAppConfig().app.slug;
+    if (!namespace || namespace !== namespace.trim() || namespace.includes(":")) {
+        throw new Error("Application-state maintenance requires a configured app namespace.");
+    }
+    return `${namespace}:`;
+}
 export async function appStateDeleteByPrefix(sessionId, keyPrefix, options) {
     await ensureTable();
     const client = getDbExec();

package/dist/chat-threads/schema-migrations.js

@@ -109,4 +109,21 @@ export const CHAT_THREAD_SCHEMA_MIGRATIONS = [
         ADD COLUMN IF NOT EXISTS interrupt_run_id TEXT
     `,
     },
+    {
+        version: 7,
+        name: "chat-thread-inbox-thread-order-index",
+        sql: `
+      CREATE INDEX IF NOT EXISTS agent_chat_submission_inbox_thread_pending_idx
+        ON agent_chat_submission_inbox (thread_id, interrupt_active_run DESC, move_to_top_at DESC, queue_order ASC)
+        WHERE state = 'queued'
+    `,
+    },
+    {
+        version: 8,
+        name: "chat-thread-inbox-retry-count",
+        sql: `
+      ALTER TABLE agent_chat_submission_inbox
+        ADD COLUMN IF NOT EXISTS retry_count INTEGER NOT NULL DEFAULT 0
+    `,
+    },
 ];

package/dist/chat-threads/store.d.ts

@@ -1,4 +1,4 @@
-import { type AgentSubmissionPayload, type AgentRunOptions } from "@agent-native/agentkit/protocol";
+import { type AgentSubmissionReference, type AgentSubmissionPayload, type AgentRunOptions } from "@agent-native/agentkit/protocol";
 import { type ThreadAnnotationSnapshotConflict } from "../agent/thread-data-builder.js";
 import { type DbExec } from "../db/client.js";
 import { type AccessContext } from "../sharing/access.js";
@@ -124,6 +124,9 @@ export declare function ensureChatThreadTables(): Promise<void>;
  */
 export declare function hasThreadAccess(userEmail: string | null | undefined, threadId: string | null | undefined, minRole?: ShareRole | "owner", ctx?: Omit<AccessContext, "userEmail">): Promise<boolean>;
 export declare function resolveThreadAccess(userEmail: string | null | undefined, threadId: string | null | undefined, minRole?: ShareRole | "owner", ctx?: Omit<AccessContext, "userEmail">): Promise<ChatThread | null>;
+export declare function resolveThreadAccessScope(userEmail: string | null | undefined, threadId: string | null | undefined, minRole?: ShareRole | "owner", ctx?: Omit<AccessContext, "userEmail">): Promise<{
+    scope: ChatThreadScope | null;
+} | null>;
 export declare function resolveThreadsAccess(userEmail: string | null | undefined, threadIds: readonly string[], ctx?: Pick<AccessContext, "orgId">): Promise<Map<string, ChatThread>>;
 export declare function getThread(id: string): Promise<ChatThread | null>;
 /**
@@ -259,6 +262,7 @@ export interface QueuedMessage {
     createdAt?: string;
     attachments?: unknown[];
     requestAttachments?: unknown[];
+    references?: AgentSubmissionReference[];
     metadata?: Record<string, unknown>;
     options?: AgentRunOptions;
     interruptActiveRun?: boolean;
@@ -287,6 +291,7 @@ export interface QueuedSubmissionReceipt {
     submittedRunId?: string;
     interruptRunId?: string;
     retryAfter?: number;
+    retryCount: number;
     createdAt: number;
     updatedAt: number;
 }
@@ -299,10 +304,18 @@ export declare function hashQueuedSubmissionPayload(threadId: string, message: Q
 export declare function queuedSubmissionBehaviorMatches(threadId: string, message: QueuedMessage, identity: AgentSubmissionPayload): boolean;
 /** Returns the durable admission receipt used to dedupe direct starts and queue retries. */
 export declare function getQueuedSubmissionReceipt(threadId: string, messageId: string): Promise<QueuedSubmissionReceipt | null>;
+export declare function getQueuedSubmissionReceiptStatus(threadId: string, messageId: string): Promise<{
+    state: QueuedSubmissionState;
+    submittedRunId?: string;
+} | null>;
+/** Checks the inbox inside a caller's transaction before a fresh run claims its slot. */
+export declare function hasPendingQueuedSubmissionReceipt(tx: DbExec, threadId: string): Promise<boolean>;
 /** Finds accepted queue rows in priority order for the signed server sweep. */
 export declare function listQueuedSubmissionReceipts(options?: {
     limit?: number;
     now?: number;
+    threadId?: string;
+    interruptActiveRun?: boolean;
 }): Promise<QueuedSubmissionReceipt[]>;
 /** Records a run admission in the same transaction that persists its user message. */
 export declare function markQueuedSubmissionSubmitted(tx: DbExec, input: {
@@ -316,6 +329,7 @@ export declare function markQueuedSubmissionSubmitted(tx: DbExec, input: {
 /** Delays a retryable drain failure without releasing the accepted submission. */
 export declare function retryQueuedSubmissionReceipt(threadId: string, messageId: string, retryAfter: number, options?: {
     claimId?: string;
+    countRetry?: boolean;
 }): Promise<boolean>;
 /** Retains but stops automatically promoting a row that can no longer be authorized. */
 export declare function blockQueuedSubmissionReceipt(threadId: string, messageId: string, options?: {
@@ -349,6 +363,9 @@ export type ThreadQueuedMessageMutation = {
 } | {
     type: "remove";
     messageId: string;
+} | {
+    type: "cancel";
+    messageId: string;
 } | {
     type: "moveToTop";
     messageId: string;
@@ -365,6 +382,7 @@ export type ThreadQueuedMessageMutation = {
     messageId: string;
     retryAfter: number;
     claimId?: string;
+    countRetry?: boolean;
 } | {
     type: "blockReceipt";
     messageId: string;
@@ -393,7 +411,9 @@ export interface ThreadQueuedMessageMutationResult {
     claimBusy?: boolean;
     submissionExpired?: boolean;
     promotionBusy?: boolean;
+    receiptManaged?: boolean;
     receiptUnavailable?: boolean;
+    retryDeferred?: boolean;
     receiptConflict?: boolean;
     receiptUpdated?: boolean;
     claimLost?: boolean;