@agent-native/core 0.189.0 → 0.190.0-nightly-20260925211446

package/dist/observability/store.d.ts

@@ -35,6 +35,12 @@ export declare function getTraceSummaries(opts: {
     excludeSpanName?: string;
     requireReviewContext?: boolean;
 }): Promise<TraceSummary[]>;
+export declare function getRecentReviewRunsForThreads(opts: {
+    orgId: string;
+    threadIds: readonly string[];
+    sinceMs: number;
+    perThreadLimit?: number;
+}): Promise<TraceSummary[]>;
 export declare function getTraceSummary(runId: string, opts?: {
     userId?: string;
     orgId?: string;
@@ -45,10 +51,15 @@ export declare function getOrgScopedReviewThreads(orgId: string, requested: read
     ownerEmail: string;
     threadId: string;
 }[]): Promise<Map<string, {
+    ownerEmail: string;
     threadData: string | null;
     title: string | null;
+    scopeType: string | null;
+    scopeId: string | null;
+    scopeLabel: string | null;
 }>>;
 export declare function getHumanReviewSummaries(orgId: string, runIds?: readonly string[]): Promise<Map<string, HumanReviewSummary>>;
+export declare function getHumanReviewSummariesForThreads(orgId: string, threadIds: readonly string[]): Promise<Map<string, HumanReviewSummary>>;
 export declare function upsertHumanReviewSummary(summary: HumanReviewSummary): Promise<boolean>;
 /** Latest completed response in a thread, always scoped to its owner. */
 export declare function getLatestTraceSummaryForThread(threadId: string, opts: {
@@ -65,6 +76,8 @@ export declare function getFeedback(opts: {
     orgId?: string;
     source?: FeedbackEntry["source"];
     runIds?: readonly string[];
+    threadIds?: readonly string[];
+    perThreadLimit?: number;
 }): Promise<FeedbackEntry[]>;
 export declare function getFeedbackStats(sinceMs: number, opts?: {
     userId?: string;
@@ -83,6 +96,8 @@ export declare function getInstructionUpdates(opts: {
     limit?: number;
     userId?: string;
     orgId?: string;
+    threadIds?: readonly string[];
+    perThreadLimit?: number;
 }): Promise<InstructionUpdate[]>;
 export declare function upsertSatisfactionScore(score: SatisfactionScore): Promise<void>;
 export declare function getSatisfactionScores(opts: {

package/dist/observability/store.js

@@ -38,7 +38,7 @@ const persistedHumanReviewArtifactSchema = z
     const paths = {
         design: new RegExp(`^/(?:design|present)/${id}$`),
         slides: new RegExp(`^/deck/${id}(?:/present)?$`),
-        analytics: new RegExp(`^/(?:dashboards|analyses|adhoc)/${id}$`),
+        analytics: new RegExp(`^(?:/(?:dashboards|analyses|adhoc)/${id}|/api/media/${id})$`),
     };
     if (!paths[artifact.appId].test(artifact.path)) {
         ctx.addIssue({
@@ -518,13 +518,29 @@ export async function getTraceSummaries(opts) {
         )
       )`
         : "";
-    const { rows } = await client.execute({
-        sql: `SELECT * FROM agent_trace_summaries
+    const select = opts.requireReviewContext
+        ? `SELECT * FROM (
+        SELECT agent_trace_summaries.*,
+          COUNT(*) OVER (PARTITION BY thread_id) AS run_count,
+          ROW_NUMBER() OVER (
+            PARTITION BY thread_id ORDER BY created_at DESC, run_id DESC
+          ) AS review_row_number
+        FROM agent_trace_summaries
+        WHERE ${where}
+        ${exclude}
+        ${reviewContext}
+      ) AS review_rollups
+      WHERE review_row_number = 1
+      ORDER BY created_at DESC
+      LIMIT ?`
+        : `SELECT * FROM agent_trace_summaries
       WHERE ${where}
       ${exclude}
       ${reviewContext}
       ORDER BY created_at DESC
-      LIMIT ?`,
+      LIMIT ?`;
+    const { rows } = await client.execute({
+        sql: select,
         args: [
             ...args,
             ...(opts.excludeSpanName
@@ -538,6 +554,37 @@ export async function getTraceSummaries(opts) {
     });
     return rows.map(rowToTraceSummary);
 }
+export async function getRecentReviewRunsForThreads(opts) {
+    const threadIds = [...new Set(opts.threadIds.filter(Boolean))].slice(0, 100);
+    if (!opts.orgId || threadIds.length === 0)
+        return [];
+    await ensureObservabilityTables();
+    const limit = Math.max(1, Math.min(opts.perThreadLimit ?? 6, 12));
+    const { rows } = await getDbExec().execute({
+        sql: `SELECT * FROM (
+      SELECT summary.*,
+        ROW_NUMBER() OVER (
+          PARTITION BY summary.thread_id
+          ORDER BY summary.created_at DESC, summary.run_id DESC
+        ) AS review_run_number
+      FROM agent_trace_summaries summary
+      INNER JOIN chat_threads thread
+        ON thread.id = summary.thread_id AND thread.org_id = summary.org_id
+          AND LOWER(thread.owner_email) = LOWER(summary.user_id)
+      WHERE summary.org_id = ? AND summary.created_at >= ?
+        AND summary.thread_id IN (${threadIds.map(() => "?").join(", ")})
+        AND summary.run_id NOT IN (
+          SELECT run_id FROM agent_trace_spans
+          WHERE org_id = ? AND span_type = 'agent_run'
+            AND name = 'agent_run:observability:human-review-summary'
+        )
+    ) AS review_runs
+    WHERE review_run_number <= ?
+    ORDER BY thread_id, created_at DESC, run_id DESC`,
+        args: [opts.orgId, opts.sinceMs, ...threadIds, opts.orgId, limit],
+    });
+    return rows.map(rowToTraceSummary);
+}
 export async function getTraceSummary(runId, opts = {}) {
     await ensureObservabilityTables();
     const client = getDbExec();
@@ -594,9 +641,9 @@ export async function getOrgScopedReviewThreads(orgId, requested) {
         return new Map();
     const client = getDbExec();
     const { rows } = await client.execute({
-        sql: `SELECT id,
+        sql: `SELECT id, owner_email,
       CASE WHEN OCTET_LENGTH(thread_data) <= ? THEN thread_data ELSE NULL END AS thread_data,
-      title FROM chat_threads
+      title, scope_type, scope_id, scope_label FROM chat_threads
       WHERE org_id = ? AND (${keys
             .map(() => "(LOWER(owner_email) = LOWER(?) AND id = ?)")
             .join(" OR ")})`,
@@ -609,8 +656,14 @@ export async function getOrgScopedReviewThreads(orgId, requested) {
     return new Map(rows.map((row) => [
         String(row.id),
         {
+            ownerEmail: String(row.owner_email),
             threadData: typeof row.thread_data === "string" ? row.thread_data : null,
             title: typeof row.title === "string" ? row.title.slice(0, 240) : null,
+            scopeType: typeof row.scope_type === "string" ? row.scope_type : null,
+            scopeId: typeof row.scope_id === "string" ? row.scope_id : null,
+            scopeLabel: typeof row.scope_label === "string"
+                ? row.scope_label.slice(0, 240)
+                : null,
         },
     ]));
 }
@@ -634,6 +687,32 @@ export async function getHumanReviewSummaries(orgId, runIds) {
         return [summary.runId, summary];
     }));
 }
+export async function getHumanReviewSummariesForThreads(orgId, threadIds) {
+    const ids = [...new Set(threadIds.filter(Boolean))];
+    if (!orgId || ids.length === 0)
+        return new Map();
+    await ensureObservabilityTables();
+    const { rows } = await getDbExec().execute({
+        sql: `SELECT review.*, trace.thread_id AS review_thread_id
+      FROM agent_human_review_summaries review
+      INNER JOIN agent_trace_summaries trace
+        ON trace.run_id = review.run_id AND trace.org_id = review.org_id
+      INNER JOIN chat_threads thread
+        ON thread.id = trace.thread_id AND thread.org_id = trace.org_id
+          AND LOWER(thread.owner_email) = LOWER(trace.user_id)
+      WHERE review.org_id = ? AND trace.thread_id IN (${ids.map(() => "?").join(", ")})
+      ORDER BY review.updated_at DESC, review.run_id DESC`,
+        args: [orgId, ...ids],
+    });
+    const summaries = new Map();
+    for (const row of rows) {
+        const threadId = String(row.review_thread_id ?? "");
+        if (threadId && !summaries.has(threadId)) {
+            summaries.set(threadId, parseHumanReviewSummaryRow(row));
+        }
+    }
+    return summaries;
+}
 export async function upsertHumanReviewSummary(summary) {
     await ensureObservabilityTables();
     const client = getDbExec();
@@ -704,6 +783,11 @@ export async function getFeedback(opts) {
         : undefined;
     if (runIds?.length === 0)
         return [];
+    const threadIds = opts.threadIds
+        ? [...new Set(opts.threadIds.filter(Boolean))]
+        : undefined;
+    if (threadIds?.length === 0)
+        return [];
     await ensureObservabilityTables();
     const client = getDbExec();
     const conditions = [];
@@ -716,6 +800,10 @@ export async function getFeedback(opts) {
         conditions.push(`run_id IN (${runIds.map(() => "?").join(", ")})`);
         args.push(...runIds);
     }
+    if (threadIds) {
+        conditions.push(`thread_id IN (${threadIds.map(() => "?").join(", ")})`);
+        args.push(...threadIds);
+    }
     if (opts.sinceMs) {
         conditions.push("created_at >= ?");
         args.push(opts.sinceMs);
@@ -737,10 +825,21 @@ export async function getFeedback(opts) {
         args.push(opts.source);
     }
     const where = conditions.length > 0 ? `WHERE ${conditions.join(" AND ")}` : "";
-    const limit = opts.limit ?? 100;
+    const perThreadLimit = Math.max(1, Math.min(opts.perThreadLimit ?? 6, 12));
     const { rows } = await client.execute({
-        sql: `SELECT * FROM agent_feedback ${where} ORDER BY created_at DESC LIMIT ?`,
-        args: [...args, limit],
+        sql: threadIds
+            ? `SELECT * FROM (
+        SELECT agent_feedback.*,
+          ROW_NUMBER() OVER (
+            PARTITION BY thread_id ORDER BY created_at DESC, id DESC
+          ) AS feedback_row_number
+        FROM agent_feedback ${where}
+      ) AS review_feedback
+      WHERE feedback_row_number <= ?
+      ORDER BY created_at DESC, id DESC`
+            : `SELECT * FROM agent_feedback ${where}
+      ORDER BY created_at DESC LIMIT ?`,
+        args: [...args, threadIds ? perThreadLimit : (opts.limit ?? 100)],
     });
     return rows.map(rowToFeedback);
 }
@@ -798,6 +897,11 @@ export async function getInstructionUpdates(opts) {
         : undefined;
     if (runIds?.length === 0)
         return [];
+    const threadIds = opts.threadIds
+        ? [...new Set(opts.threadIds.filter(Boolean))]
+        : undefined;
+    if (threadIds?.length === 0)
+        return [];
     await ensureObservabilityTables();
     const client = getDbExec();
     const conditions = [];
@@ -810,6 +914,10 @@ export async function getInstructionUpdates(opts) {
         conditions.push(`run_id IN (${runIds.map(() => "?").join(", ")})`);
         args.push(...runIds);
     }
+    if (threadIds) {
+        conditions.push(`thread_id IN (${threadIds.map(() => "?").join(", ")})`);
+        args.push(...threadIds);
+    }
     if (opts.sinceMs) {
         conditions.push("updated_at >= ?");
         args.push(opts.sinceMs);
@@ -823,10 +931,21 @@ export async function getInstructionUpdates(opts) {
         args.push(opts.orgId);
     }
     const where = conditions.length > 0 ? `WHERE ${conditions.join(" AND ")}` : "";
+    const perThreadLimit = Math.max(1, Math.min(opts.perThreadLimit ?? 1, 12));
     const { rows } = await client.execute({
-        sql: `SELECT * FROM agent_instruction_updates ${where}
+        sql: threadIds
+            ? `SELECT * FROM (
+        SELECT agent_instruction_updates.*,
+          ROW_NUMBER() OVER (
+            PARTITION BY thread_id ORDER BY updated_at DESC, id DESC
+          ) AS update_row_number
+        FROM agent_instruction_updates ${where}
+      ) AS review_updates
+      WHERE update_row_number <= ?
+      ORDER BY updated_at DESC, id DESC`
+            : `SELECT * FROM agent_instruction_updates ${where}
       ORDER BY updated_at DESC LIMIT ?`,
-        args: [...args, opts.limit ?? 500],
+        args: [...args, threadIds ? perThreadLimit : (opts.limit ?? 500)],
     });
     return rows.map(rowToInstructionUpdate);
 }
@@ -1266,6 +1385,7 @@ function rowToTraceSummary(row) {
         totalOutputTokens: Number(row.total_output_tokens ?? 0),
         model: String(row.model ?? ""),
         createdAt: Number(row.created_at),
+        ...(row.run_count == null ? {} : { runCount: Number(row.run_count) }),
     };
 }
 function rowToFeedback(row) {

package/dist/observability/types.d.ts

@@ -50,6 +50,8 @@ export interface TraceSummary {
     totalOutputTokens: number;
     model: string;
     createdAt: number;
+    /** Populated by the human-review thread rollup query. */
+    runCount?: number;
 }
 export type FeedbackType = "thumbs_up" | "thumbs_down" | "category" | "text";
 export interface FeedbackEntry {
@@ -90,11 +92,21 @@ export interface OutputReviewListRow {
     inlineAppTitle?: string;
     threadTitle: string;
     summary: HumanReviewSummaryPayload | null;
+    artifacts: HumanReviewArtifactRef[];
+    runs: OutputReviewRun[];
+    runCount: number;
+    authorName?: string;
+    authorAvatar?: string;
     model: string;
     createdAt: number;
     feedback: FeedbackEntry[];
     instructionUpdate: InstructionUpdate | null;
 }
+export interface OutputReviewRun {
+    runId: string;
+    model: string;
+    createdAt: number;
+}
 export interface HumanReviewArtifactRef {
     appId: "design" | "slides" | "analytics";
     artifactId: string;
@@ -116,10 +128,16 @@ export interface HumanReviewSummary extends HumanReviewSummaryPayload {
 export interface OutputReviewThreadMessage {
     role: "user" | "assistant";
     text: string;
+    toolCalls?: string[];
 }
 export interface OutputReviewDetail {
+    runId: string;
     app: AgentMcpAppPayload | null;
     messages: OutputReviewThreadMessage[];
+    artifacts: HumanReviewArtifactRef[];
+    summary: HumanReviewSummaryPayload | null;
+    ask: string;
+    answer: string;
 }
 /** @deprecated Use OutputReviewListRow for list data. */
 export interface OutputReviewRow extends OutputReviewListRow {

package/dist/org/handlers.d.ts

@@ -74,9 +74,9 @@ export declare const setWorkspaceAppDefaultVisibilityHandler: import("h3").Event
 /** POST /_agent-native/org — create a new organization */
 export declare const createOrgHandler: import("h3").EventHandlerWithFetch<import("h3").EventHandlerRequest, Promise<{
     success: boolean;
+    id?: undefined;
     name?: undefined;
     role?: undefined;
-    id?: undefined;
 } | {
     success?: undefined;
     id: string;

package/dist/org/index.d.ts

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

package/dist/progress/routes.d.ts

@@ -15,6 +15,6 @@ export declare function createProgressHandler(): import("h3").EventHandlerWithFe
     error: string;
     ok?: undefined;
 } | {
-    error?: undefined;
     ok: boolean;
+    error?: undefined;
 }>>;

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

@@ -75,8 +75,8 @@ export declare function createCustomProviderRegistrationAction<TSchema extends Z
         user: "user";
     }>>;
 }, z.core.$strip>>, {
-    id?: undefined;
     message?: undefined;
+    id?: undefined;
     deleted?: undefined;
     providers: {
         id: string;
@@ -93,10 +93,10 @@ export declare function createCustomProviderRegistrationAction<TSchema extends Z
     registered?: undefined;
     label?: undefined;
 } | {
-    id?: undefined;
     message?: undefined;
-    count?: undefined;
+    id?: undefined;
     deleted?: undefined;
+    count?: undefined;
     providers?: undefined;
     found: boolean;
     provider: import("../custom-registry.js").CustomProviderConfig;
@@ -104,8 +104,8 @@ export declare function createCustomProviderRegistrationAction<TSchema extends Z
     label?: undefined;
 } | {
     message?: undefined;
-    count?: undefined;
     deleted?: undefined;
+    count?: undefined;
     providers?: undefined;
     provider?: undefined;
     found: boolean;
@@ -123,8 +123,8 @@ export declare function createCustomProviderRegistrationAction<TSchema extends Z
     registered?: undefined;
     label?: undefined;
 } | {
-    count?: undefined;
     deleted?: undefined;
+    count?: undefined;
     providers?: undefined;
     provider?: undefined;
     found?: undefined;

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

@@ -313,6 +313,7 @@ export declare function createProviderApiActions(runtime: Pick<ProviderApiRuntim
     }, {
         id?: undefined;
         deleted?: undefined;
+        provider?: undefined;
         providers: {
             id: string;
             label: string;
@@ -323,7 +324,6 @@ export declare function createProviderApiActions(runtime: Pick<ProviderApiRuntim
             updatedAt: number;
         }[];
         count: number;
-        provider?: undefined;
         found?: undefined;
         registered?: undefined;
         label?: undefined;
@@ -331,8 +331,8 @@ export declare function createProviderApiActions(runtime: Pick<ProviderApiRuntim
     } | {
         id?: undefined;
         deleted?: undefined;
-        count?: undefined;
         providers?: undefined;
+        count?: undefined;
         found: boolean;
         provider: import("../custom-registry.js").CustomProviderConfig;
         registered?: undefined;
@@ -340,18 +340,18 @@ export declare function createProviderApiActions(runtime: Pick<ProviderApiRuntim
         message?: undefined;
     } | {
         deleted?: undefined;
-        count?: undefined;
-        providers?: undefined;
         provider?: undefined;
+        providers?: undefined;
+        count?: undefined;
         found: boolean;
         id: string;
         registered?: undefined;
         label?: undefined;
         message?: undefined;
     } | {
-        count?: undefined;
-        providers?: undefined;
         provider?: undefined;
+        providers?: undefined;
+        count?: undefined;
         found?: undefined;
         deleted: boolean;
         id: string;
@@ -360,9 +360,9 @@ export declare function createProviderApiActions(runtime: Pick<ProviderApiRuntim
         message?: undefined;
     } | {
         deleted?: undefined;
-        count?: undefined;
-        providers?: undefined;
         provider?: undefined;
+        providers?: undefined;
+        count?: undefined;
         found?: undefined;
         registered: boolean;
         id: string;

package/dist/secrets/routes.d.ts

@@ -57,16 +57,16 @@ export declare function createListSecretsHandler(): import("h3").EventHandlerWit
 /** POST /_agent-native/secrets/:key — write a secret. */
 export declare function createWriteSecretHandler(): import("h3").EventHandlerWithFetch<import("h3").EventHandlerRequest, Promise<{
     error: string;
-    status?: undefined;
     ok?: undefined;
+    status?: undefined;
 } | {
     ok: boolean;
     status: string;
     error?: undefined;
 } | {
+    ok?: undefined;
     error: string;
     removed?: undefined;
-    ok?: undefined;
 } | {
     ok: boolean;
     removed: boolean;
@@ -77,9 +77,9 @@ export declare function createWriteSecretHandler(): import("h3").EventHandlerWit
  * or the current stored value without changing anything.
  */
 export declare function createTestSecretHandler(): import("h3").EventHandlerWithFetch<import("h3").EventHandlerRequest, Promise<{
+    ok?: undefined;
     error: string;
     note?: undefined;
-    ok?: undefined;
 } | {
     ok: boolean;
     note?: undefined;

package/dist/server/agent-chat/plugin-options.d.ts

@@ -1,6 +1,6 @@
 import type { ActionEntry, AgentLoopFinalResponseGuard, ProductionAgentOptions } from "../../agent/production-agent.js";
 import type { ActiveRun } from "../../agent/run-manager.js";
-import type { AgentChatAttachment, AgentChatReference, AgentChatScope, MentionProvider } from "../../agent/types.js";
+import type { AgentChatScope, MentionProvider } from "../../agent/types.js";
 import type { FrameworkToolsConfig } from "../../framework-tools.js";
 import type { McpActionEntryOptions } from "../../mcp-client/index.js";
 import type { ExternalAgentPolicy } from "../../mcp/external-agent-policy.js";
@@ -19,6 +19,8 @@ export interface AgentChatPluginOptions {
      * reported by the framework without failing the completed chat turn.
      */
     onAgentTurnComplete?: (scope: AgentChatScope, run: ActiveRun) => void | Promise<void>;
+    /** Best-effort observer called after thread persistence for every completed agent run, including read-only runs. */
+    onAgentRunComplete?: (scope: AgentChatScope | null | undefined, run: ActiveRun) => void | Promise<void>;
     /** Template-specific actions (email ops, booking ops, etc.) */
     actions?: Record<string, ActionEntry> | (() => Record<string, ActionEntry> | Promise<Record<string, ActionEntry>>);
     /** @deprecated Use `actions` instead */
@@ -183,25 +185,7 @@ export interface AgentChatPluginOptions {
      * before the model sees the message, so apps can translate chat attachments
      * into template-native file handles while preserving the user's visible text.
      */
-    prepareRequest?: (details: {
-        event: any;
-        ownerEmail: string | null;
-        message: string;
-        displayMessage?: string;
-        attachments: AgentChatAttachment[];
-        references: AgentChatReference[];
-        threadId?: string;
-        internalContinuation?: boolean;
-        mode: "act" | "plan";
-    }) => void | {
-        message?: string;
-        displayMessage?: string;
-        attachments?: AgentChatAttachment[];
-    } | Promise<void | {
-        message?: string;
-        displayMessage?: string;
-        attachments?: AgentChatAttachment[];
-    }>;
+    prepareRequest?: ProductionAgentOptions["prepareRequest"];
     /**
      * Resolve the exact native action surface for each interactive chat request.
      * Omitted allowlist names are not sent to the model or discoverable through

package/dist/server/agent-chat/prompt-resources.d.ts

@@ -1,3 +1,4 @@
+import { type JevCandidate } from "../../agent/jev-tool-prefetch.js";
 import { type FrameworkToolGroup } from "../../framework-tools.js";
 import type { ContextGovernanceTier, ContextManifestSourceRef, ContextSystemProvenance } from "../../shared/context-xray.js";
 import type { BuilderGatewayAuth } from "../credential-provider.js";
@@ -24,6 +25,13 @@ export interface PromptContextProvider {
 /** Register a package-owned, request-scoped system-context contribution. */
 export declare function registerPromptContextProvider(provider: PromptContextProvider): () => void;
 export declare function compactPromptLine(value: string, maxChars: number): string;
+export interface JevPromptContextCandidate extends JevCandidate {
+    kind?: string;
+    name: string;
+    scope: string;
+    path?: string;
+    content: string;
+}
 export interface PromptResourceManifestSection {
     label: string;
     provenance: ContextSystemProvenance;
@@ -82,11 +90,19 @@ export declare function resourceScopeForOwner(owner: string, currentOwner?: stri
 /** Rank and inline a few optional context sources before the first model call. */
 export declare function preloadJevContextForPrompt(options: {
     request: string;
+    appId?: string;
+    owner?: string;
+    orgId?: string | null;
     apiKey?: string;
     personalApiKey?: string;
     builderAuth?: BuilderGatewayAuth | null;
+    candidates?: readonly JevPromptContextCandidate[];
+    fallbackCandidateIds?: readonly string[];
     compact?: boolean;
     maxChars?: number;
+    contextPrefetchDeadlineAt?: number;
+    dispatchToBackground?: boolean;
+    internalContinuation?: boolean;
 }): Promise<string>;
 /**
  * Pre-load the agent's context: AGENTS.md (workspace/template/runtime