@agent-native/core 0.214.0 → 0.217.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/app-config/analytics.js

@@ -32,6 +32,6 @@ export const analyticsConfig = z.object({
         .optional()
         .meta({
         env: "AGENT_NATIVE_HEAD_SCRIPT_SRC",
-        doc: "HTTPS URL of a script loaded with `defer` on every server-rendered page, for deployment-specific tooling such as support or feedback widgets.",
+        doc: "HTTPS URL of a script added to every server-rendered page, for deployment-specific tooling such as support or feedback widgets. Where the consent banner shows, it waits for analytics consent, like Google Analytics.",
     }),
 });

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/automation/index.d.ts

@@ -139,8 +139,8 @@ export declare function createAutomationCallbackHandler(runtime: AutomationRunti
     duplicate?: undefined;
     eventId?: undefined;
 } | {
-    error?: undefined;
     accepted: boolean;
     duplicate: boolean;
     eventId: string;
+    error?: undefined;
 }>;

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;