@agent-native/core 0.206.0 → 0.206.1-nightly-20261009213000

package/dist/mcp/screen-memory-stdio.d.ts

@@ -140,13 +140,13 @@ export declare function screenMemoryMcpToolDefinitions(): ({
             clientHint?: undefined;
             timestamp?: undefined;
             chapterId?: undefined;
+            count?: undefined;
             startAt?: undefined;
             endAt?: undefined;
             reason?: undefined;
             includeMicrophone?: undefined;
             includeSystemAudio?: undefined;
             requestId?: undefined;
-            count?: undefined;
         };
         required?: undefined;
     };
@@ -171,13 +171,13 @@ export declare function screenMemoryMcpToolDefinitions(): ({
             clientHint?: undefined;
             timestamp?: undefined;
             chapterId?: undefined;
+            count?: undefined;
             startAt?: undefined;
             endAt?: undefined;
             reason?: undefined;
             includeMicrophone?: undefined;
             includeSystemAudio?: undefined;
             requestId?: undefined;
-            count?: undefined;
         };
         required?: undefined;
     };
@@ -196,13 +196,13 @@ export declare function screenMemoryMcpToolDefinitions(): ({
             clientHint?: undefined;
             timestamp?: undefined;
             chapterId?: undefined;
+            count?: undefined;
             startAt?: undefined;
             endAt?: undefined;
             reason?: undefined;
             includeMicrophone?: undefined;
             includeSystemAudio?: undefined;
             requestId?: undefined;
-            count?: undefined;
         };
         required?: undefined;
     };
@@ -231,13 +231,13 @@ export declare function screenMemoryMcpToolDefinitions(): ({
             };
             timestamp?: undefined;
             chapterId?: undefined;
+            count?: undefined;
             startAt?: undefined;
             endAt?: undefined;
             reason?: undefined;
             includeMicrophone?: undefined;
             includeSystemAudio?: undefined;
             requestId?: undefined;
-            count?: undefined;
         };
     };
 } | {
@@ -260,12 +260,12 @@ export declare function screenMemoryMcpToolDefinitions(): ({
                 description: string;
             };
             chapterId?: undefined;
+            count?: undefined;
             startAt?: undefined;
             endAt?: undefined;
             includeMicrophone?: undefined;
             includeSystemAudio?: undefined;
             requestId?: undefined;
-            count?: undefined;
         };
     };
 } | {
@@ -317,6 +317,7 @@ export declare function screenMemoryMcpToolDefinitions(): ({
             clientHint?: undefined;
             timestamp?: undefined;
             chapterId?: undefined;
+            count?: undefined;
             startAt: {
                 type: string;
                 description: string;
@@ -336,7 +337,6 @@ export declare function screenMemoryMcpToolDefinitions(): ({
                 type: string;
             };
             requestId?: undefined;
-            count?: undefined;
         };
     };
 } | {
@@ -352,6 +352,7 @@ export declare function screenMemoryMcpToolDefinitions(): ({
             clientHint?: undefined;
             timestamp?: undefined;
             chapterId?: undefined;
+            count?: undefined;
             startAt?: undefined;
             endAt?: undefined;
             reason?: undefined;
@@ -360,7 +361,6 @@ export declare function screenMemoryMcpToolDefinitions(): ({
             requestId: {
                 type: string;
             };
-            count?: undefined;
         };
     };
 })[];

package/dist/notifications/routes.d.ts

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

package/dist/observability/metrics.d.ts

@@ -19,6 +19,7 @@ export interface HttpServerRequestMetric {
     route?: string;
 }
 export declare function recordHttpServerRequest(request: HttpServerRequestMetric): void;
+export declare function recordHttpServerHandoff(request: HttpServerRequestMetric): void;
 export interface GenAiChatMetric {
     requestModel: string;
     /** The engine name; a closed, registered set. */
@@ -49,10 +50,14 @@ export declare function recordAgentToolCall(call: AgentToolCallMetric): void;
 export type TraceWriteStage = "spans" | "summary" | "thread_org" | "write";
 /** Counted once per failed stage of a run, never per span. */
 export declare function recordTraceWriteFailure(stage: TraceWriteStage, error: unknown): void;
+export declare function __resetFlushFailureLogForTests(): void;
+export declare const METRICS_FLUSH_MIN_INTERVAL_MS = 10000;
 /**
  * Export buffered telemetry before a serverless function can freeze. Never
  * delays a request by more than OBSERVABILITY_FLUSH_TIMEOUT_MS; each provider
  * that times out or fails drops its points and is counted separately on
  * `agent_native.telemetry.flush_failures`, which the next flush exports.
+ * Metrics export at most once per METRICS_FLUSH_MIN_INTERVAL_MS; spans export
+ * on every call.
  */
 export declare function flushObservability(): Promise<void>;

package/dist/observability/metrics.js

@@ -8,6 +8,7 @@
  */
 import { CORE_ACTION_GROUPS } from "../framework-tools.js";
 import { getRegisteredObservabilityProvider, } from "./otel-provider.js";
+import { trackingIdentityProperties } from "./tracking-identity.js";
 const METER_NAME = "@agent-native/core";
 // The SDK default is dense below 100ms, which serverless requests don't need.
 const HTTP_SERVER_DURATION_BUCKETS_S = [0.05, 0.1, 0.25, 0.5, 1, 2.5, 5, 10];
@@ -51,6 +52,11 @@ function instruments() {
             unit: "s",
             advice: { explicitBucketBoundaries: HTTP_SERVER_DURATION_BUCKETS_S },
         }),
+        httpServerHandoffDuration: meter.createHistogram("agent_native.http.server.handoff.duration", {
+            description: "Time from the start of an HTTP server request until its response is handed back to the runtime, including post-handler work that holds it.",
+            unit: "s",
+            advice: { explicitBucketBoundaries: HTTP_SERVER_DURATION_BUCKETS_S },
+        }),
         genAiOperationDuration: meter.createHistogram("gen_ai.client.operation.duration", {
             description: "GenAI operation duration.",
             unit: "s",
@@ -82,18 +88,24 @@ function httpRequestMethod(method) {
     const upper = method.toUpperCase();
     return KNOWN_HTTP_METHODS.has(upper) ? upper : "_OTHER";
 }
-export function recordHttpServerRequest(request) {
-    const recorded = instruments();
-    if (!recorded)
-        return;
-    recorded.httpServerRequestDuration.record(Math.max(0, request.durationMs) / 1_000, {
+function httpServerAttributes(request) {
+    return {
         "http.request.method": httpRequestMethod(request.method),
         "http.response.status_code": request.statusCode,
         ...(request.route ? { "http.route": request.route } : {}),
         ...(request.statusCode >= 500
             ? { "error.type": String(request.statusCode) }
             : {}),
-    });
+    };
+}
+export function recordHttpServerRequest(request) {
+    instruments()?.httpServerRequestDuration.record(Math.max(0, request.durationMs) / 1_000, httpServerAttributes(request));
+}
+// http.server.request.duration ends when the response hook starts; this ends
+// when the hook hands the response back, so work holding a finished response
+// (an awaited telemetry export) shows up as the gap between the two.
+export function recordHttpServerHandoff(request) {
+    instruments()?.httpServerHandoffDuration.record(Math.max(0, request.durationMs) / 1_000, httpServerAttributes(request));
 }
 /**
  * Engines that accept custom model ids pass any caller-supplied string
@@ -167,17 +179,56 @@ export function recordTraceWriteFailure(stage, error) {
 function flushErrorType(error) {
     return error instanceof Error && error.name ? error.name : "unknown";
 }
+const FLUSH_FAILURE_LOG_EVENT = "agent-native.telemetry_flush_failed";
+// Error names come from arbitrary exporters; cap distinct kinds so a provider
+// minting varied names cannot grow this set or the log without bound.
+const MAX_LOGGED_FLUSH_FAILURE_KINDS = 8;
+const loggedFlushFailures = new Set();
 function recordFlushFailure(signal, errorType) {
     instruments()?.flushFailures.add(1, {
         "agent_native.telemetry.signal": signal,
         "error.type": errorType,
     });
+    // The counter rides the export that just failed, so a collector that keeps
+    // timing out never delivers it. The function log does not depend on OTLP.
+    const key = `${signal}:${errorType}`;
+    if (loggedFlushFailures.has(key) ||
+        loggedFlushFailures.size >= MAX_LOGGED_FLUSH_FAILURE_KINDS) {
+        return;
+    }
+    loggedFlushFailures.add(key);
+    console.warn(JSON.stringify({
+        event: FLUSH_FAILURE_LOG_EVENT,
+        ...trackingIdentityProperties(),
+        signal,
+        error_type: errorType,
+        timeout_ms: OBSERVABILITY_FLUSH_TIMEOUT_MS,
+    }));
+}
+export function __resetFlushFailureLogForTests() {
+    loggedFlushFailures.clear();
+}
+// A metric export re-sends every series the process holds, so exporting on
+// each request multiplies upload volume by request rate. Cumulative (and
+// delta) points carry everything skipped into the next export; only an
+// instance that never serves another request loses its last window.
+export const METRICS_FLUSH_MIN_INTERVAL_MS = 10_000;
+const lastMetricsFlushAt = new WeakMap();
+function shouldFlushMetrics(meterProvider, now) {
+    const last = lastMetricsFlushAt.get(meterProvider);
+    if (last !== undefined && now - last < METRICS_FLUSH_MIN_INTERVAL_MS) {
+        return false;
+    }
+    lastMetricsFlushAt.set(meterProvider, now);
+    return true;
 }
 /**
  * Export buffered telemetry before a serverless function can freeze. Never
  * delays a request by more than OBSERVABILITY_FLUSH_TIMEOUT_MS; each provider
  * that times out or fails drops its points and is counted separately on
  * `agent_native.telemetry.flush_failures`, which the next flush exports.
+ * Metrics export at most once per METRICS_FLUSH_MIN_INTERVAL_MS; spans export
+ * on every call.
  */
 export async function flushObservability() {
     const provider = getRegisteredObservabilityProvider();
@@ -196,8 +247,12 @@ export async function flushObservability() {
     try {
         // One provider failing must not end the wait for the other: the response
         // hook returning early lets the runtime freeze mid-export.
+        const meterProvider = provider.meterProvider?.forceFlush &&
+            shouldFlushMetrics(provider.meterProvider, startedAt)
+            ? provider.meterProvider
+            : undefined;
         const flushes = [
-            ["metrics", provider.meterProvider],
+            ["metrics", meterProvider],
             ["traces", provider.tracerProvider],
         ];
         const failures = await Promise.all(flushes.map(([, signalProvider]) => Promise.race([

package/dist/observability/routes.d.ts

@@ -33,26 +33,26 @@ export declare function createObservabilityHandler(): import("h3").EventHandlerW
     spans?: undefined;
     ok?: undefined;
 } | {
-    error?: undefined;
     message?: undefined;
     summary: import("./types.js").TraceSummary;
     spans: import("./types.js").TraceSpan[];
+    error?: undefined;
     ok?: undefined;
 } | {
-    error?: undefined;
     message?: undefined;
     summary?: undefined;
     spans?: undefined;
     traceMissing: true;
     id: string;
+    error?: undefined;
     ok?: undefined;
 } | {
-    error?: undefined;
     message?: undefined;
     summary?: undefined;
     spans?: undefined;
     traceMissing?: undefined;
     id: string;
+    error?: undefined;
     ok?: undefined;
 } | {
     message?: undefined;
@@ -61,9 +61,9 @@ export declare function createObservabilityHandler(): import("h3").EventHandlerW
     error: any;
     ok?: undefined;
 } | {
-    error?: undefined;
     message?: undefined;
     summary?: undefined;
     spans?: undefined;
+    error?: undefined;
     ok: boolean;
 }>>;

package/dist/org/handlers.d.ts

@@ -72,9 +72,9 @@ export declare const setWorkspaceAppDefaultVisibilityHandler: import("h3").Event
 }>>;
 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

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

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

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

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

@@ -311,9 +311,9 @@ export declare function createProviderApiActions(runtime: Pick<ProviderApiRuntim
         notes?: string | undefined;
         scope?: "org" | "user" | undefined;
     }, {
-        id?: undefined;
         deleted?: undefined;
         message?: undefined;
+        found?: undefined;
         providers: {
             id: string;
             label: string;
@@ -325,11 +325,10 @@ export declare function createProviderApiActions(runtime: Pick<ProviderApiRuntim
         }[];
         count: number;
         provider?: undefined;
-        found?: undefined;
         registered?: undefined;
+        id?: undefined;
         label?: undefined;
     } | {
-        id?: undefined;
         deleted?: undefined;
         message?: undefined;
         providers?: undefined;
@@ -337,6 +336,7 @@ export declare function createProviderApiActions(runtime: Pick<ProviderApiRuntim
         found: boolean;
         provider: import("../custom-registry.js").CustomProviderConfig;
         registered?: undefined;
+        id?: undefined;
         label?: undefined;
     } | {
         deleted?: undefined;
@@ -350,20 +350,20 @@ export declare function createProviderApiActions(runtime: Pick<ProviderApiRuntim
         label?: undefined;
     } | {
         message?: undefined;
+        found?: undefined;
         providers?: undefined;
         count?: undefined;
         provider?: undefined;
-        found?: undefined;
         deleted: boolean;
         id: string;
         registered?: undefined;
         label?: undefined;
     } | {
         deleted?: undefined;
+        found?: undefined;
         providers?: undefined;
         count?: undefined;
         provider?: undefined;
-        found?: undefined;
         registered: boolean;
         id: string;
         label: string;

package/dist/scripts/docs/search.d.ts

@@ -6,6 +6,7 @@ interface DocMeta {
 export interface DocFull extends DocMeta {
     body: string;
 }
+export declare function loadSkillDocPages(slugs: readonly string[], userEmail: string | null | undefined): Promise<Map<string, string>>;
 export declare function loadAllDocs(userEmail?: string): Promise<DocFull[]>;
 export default function docsSearchScript(args: string[]): Promise<void>;
 export {};

package/dist/scripts/docs/search.js

@@ -140,6 +140,22 @@ async function loadAgentBundleDocs(userEmail) {
     }
     return docs;
 }
+function formatDocPage(doc) {
+    return `# ${doc.title}\n\n${doc.description ? `${doc.description}\n\n` : ""}${doc.body}`;
+}
+// Slugs come from the client, so only skills visible to this user resolve.
+export async function loadSkillDocPages(slugs, userEmail) {
+    const pages = new Map();
+    if (slugs.length === 0)
+        return pages;
+    const docs = new Map((await loadAgentBundleDocs(userEmail)).map((doc) => [doc.slug, doc]));
+    for (const slug of slugs) {
+        const doc = slug.startsWith("skill-") ? docs.get(slug) : undefined;
+        if (doc)
+            pages.set(slug, formatDocPage(doc));
+    }
+    return pages;
+}
 export async function loadAllDocs(userEmail = getRequestUserEmail()) {
     return [...loadFilesystemDocs(), ...(await loadAgentBundleDocs(userEmail))];
 }
@@ -201,10 +217,7 @@ Options:
             logMissingFrameworkDocsNote();
             return;
         }
-        console.log(`# ${doc.title}\n`);
-        if (doc.description)
-            console.log(`${doc.description}\n`);
-        console.log(doc.body);
+        console.log(formatDocPage(doc));
         return;
     }
     if (parsed.query) {

package/dist/secrets/index.d.ts

@@ -1,5 +1,5 @@
 export { registerRequiredSecret, listRequiredSecrets, getRequiredSecret, registerSecretUsage, getRegisteredSecretUsage, __resetSecretsRegistry, type RegisteredSecret, type SecretUsage, type SecretManagedBy, type SecretScope, type SecretKind, type SecretValidator, type ValidatorResult, } from "./register.js";
-export { writeAppSecret, readAppSecret, readAppSecretMeta, deleteAppSecret, getAppSecretMeta, listAppSecretsForScope, last4, VAULT_SYNC_DESCRIPTION_PREFIX, type SecretRef, type WriteSecretArgs, type ReadSecretResult, type SecretMeta, } from "./storage.js";
+export { writeAppSecret, readAppSecret, hasAppSecret, readAppSecretMeta, deleteAppSecret, getAppSecretMeta, listAppSecretsForScope, last4, VAULT_SYNC_DESCRIPTION_PREFIX, type SecretRef, type WriteSecretArgs, type ReadSecretResult, type SecretMeta, } from "./storage.js";
 export { APP_SECRETS_CREATE_SQL, appSecrets } from "./schema.js";
 export { encryptSecretValue, decryptSecretValue, isEncryptedSecretValue, } from "./crypto.js";
 export { createListSecretsHandler, createWriteSecretHandler, createTestSecretHandler, createAdHocSecretHandler, type SecretStatusPayload, type AdHocSecretPayload, } from "./routes.js";

package/dist/secrets/index.js

@@ -1,5 +1,5 @@
 export { registerRequiredSecret, listRequiredSecrets, getRequiredSecret, registerSecretUsage, getRegisteredSecretUsage, __resetSecretsRegistry, } from "./register.js";
-export { writeAppSecret, readAppSecret, readAppSecretMeta, deleteAppSecret, getAppSecretMeta, listAppSecretsForScope, last4, VAULT_SYNC_DESCRIPTION_PREFIX, } from "./storage.js";
+export { writeAppSecret, readAppSecret, hasAppSecret, readAppSecretMeta, deleteAppSecret, getAppSecretMeta, listAppSecretsForScope, last4, VAULT_SYNC_DESCRIPTION_PREFIX, } from "./storage.js";
 export { APP_SECRETS_CREATE_SQL, appSecrets } from "./schema.js";
 export { encryptSecretValue, decryptSecretValue, isEncryptedSecretValue, } from "./crypto.js";
 export { createListSecretsHandler, createWriteSecretHandler, createTestSecretHandler, createAdHocSecretHandler, } from "./routes.js";

package/dist/secrets/storage.d.ts

@@ -60,6 +60,7 @@ export interface SecretMeta {
     createdAt: number;
     updatedAt: number;
 }
+export declare function hasAppSecret(ref: SecretRef): Promise<boolean>;
 export declare function readAppSecretMeta(ref: SecretRef): Promise<SecretMeta | null>;
 /**
  * List all secrets for a given scope. Returns metadata only — values are

package/dist/secrets/storage.js

@@ -345,6 +345,14 @@ export async function getAppSecretMeta(ref) {
         return null;
     return { last4: result.last4, updatedAt: result.updatedAt };
 }
+export async function hasAppSecret(ref) {
+    await ensureTable();
+    const { rows } = await getDbExec().execute({
+        sql: `SELECT 1 FROM app_secrets WHERE scope = ? AND scope_id = ? AND key = ? LIMIT 1`,
+        args: [ref.scope, ref.scopeId, ref.key],
+    });
+    return rows.length > 0;
+}
 export async function readAppSecretMeta(ref) {
     await ensureTable();
     const { key, scope, scopeId } = ref;