@superblocksteam/vite-plugin-file-sync 1.99.99-next.2 → 2.0.0-SNAPSHOT.2143e2e95d0107ab

package/dist/ai-service/agent/tool-permission-delivery.js

@@ -0,0 +1,434 @@
+/**
+ * Delivery of the tool-permission dialog to the browser peer.
+ *
+ * Each delivery RPC is bounded by PERMISSION_PROMPT_DELIVERY_TIMEOUT_MS (10s),
+ * and a delivery whose live-edit route is already unbound is refused before the
+ * RPC rather than waiting out that bound.
+ * A miss parks the prompt for PERMISSION_PROMPT_REPLAY_GRACE_MS (60s), during
+ * which reconnect and interval retries can restore the dialog. If none
+ * succeeds, the service turns the delivery failure into a tool result and
+ * resumes the agent. The user's approve/deny decision is not awaited here.
+ */
+import { getErrorMeta, getLogger } from "../../util/logger.js";
+import { emitLiveEditEvent } from "../live-edit-events/bridge.js";
+import { clearPendingToolPermissionRequest } from "../state-machine/helpers/peer.js";
+import { isPeerUnavailableError } from "../state-machine/helpers/stable-peer.js";
+import { callPeer } from "../util/call-peer.js";
+import { PERMISSION_PROMPT_DELIVERY_TIMEOUT_MS, PERMISSION_PROMPT_REPLAY_GRACE_MS, RpcTimeoutError, } from "../util/rpc-timeout.js";
+import { recordToolPermissionDeliveryOutcome } from "./tool-permission-delivery-metrics.js";
+function reconnectableDeliveryPeer(peer) {
+    if ("connectionGeneration" in peer &&
+        typeof peer.connectionGeneration === "number" &&
+        "isConnected" in peer &&
+        typeof peer.isConnected === "boolean") {
+        return peer;
+    }
+    return undefined;
+}
+function sameConnection(replay, peer, connectionGeneration) {
+    return (replay.peer === peer && replay.connectionGeneration === connectionGeneration);
+}
+function replayFailure(error) {
+    return (transientDeliveryFailure(error) ?? {
+        kind: "rpc_error",
+        message: errorMessage(error),
+    });
+}
+function parkReplayFailure(clark, messageId, failure, generation) {
+    let newlyParked = false;
+    let updated = false;
+    clark.updateContext((context) => {
+        const pending = context.pendingToolPermissionRequest;
+        if (!pending ||
+            pending.messageId !== messageId ||
+            pending.delivery.generation !== generation) {
+            return context;
+        }
+        updated = true;
+        newlyParked = pending.delivery.status !== "parked";
+        return {
+            ...context,
+            pendingToolPermissionRequest: {
+                ...pending,
+                delivery: {
+                    status: "parked",
+                    expiresAtMs: pending.delivery.status === "parked"
+                        ? pending.delivery.expiresAtMs
+                        : Date.now() + PERMISSION_PROMPT_REPLAY_GRACE_MS,
+                    failure,
+                    generation,
+                },
+            },
+        };
+    });
+    if (newlyParked) {
+        recordToolPermissionDeliveryOutcome("parked");
+    }
+    return updated;
+}
+const inFlightReplays = new WeakMap();
+const firstDeliveryReplaced = new WeakMap();
+function errorMessage(error) {
+    if (error &&
+        typeof error === "object" &&
+        "message" in error &&
+        typeof error.message === "string") {
+        return error.message;
+    }
+    return String(error);
+}
+function updatePendingDelivery(clark, messageId, delivery, expected) {
+    let updated = false;
+    clark.updateContext((context) => {
+        const pending = context.pendingToolPermissionRequest;
+        if (!pending ||
+            pending.messageId !== messageId ||
+            (expected &&
+                (pending.delivery.status !== expected.status ||
+                    pending.delivery.generation !== expected.generation))) {
+            return context;
+        }
+        updated = true;
+        return {
+            ...context,
+            pendingToolPermissionRequest: {
+                ...pending,
+                delivery,
+            },
+        };
+    });
+    return updated;
+}
+function whenFirstDeliveryReplaced(clark) {
+    return new Promise((resolve) => {
+        firstDeliveryReplaced.set(clark, resolve);
+    });
+}
+function notifyFirstDeliveryReplaced(clark) {
+    const notify = firstDeliveryReplaced.get(clark);
+    if (!notify) {
+        return;
+    }
+    firstDeliveryReplaced.delete(clark);
+    notify();
+}
+function transientDeliveryFailure(error) {
+    if (error instanceof RpcTimeoutError) {
+        return { kind: "timeout" };
+    }
+    if (isPeerUnavailableError(error)) {
+        return {
+            kind: "peer_unavailable",
+            message: errorMessage(error),
+        };
+    }
+    return undefined;
+}
+function parkAwaitingAck(clark, messageId, failure, generation) {
+    const parked = updatePendingDelivery(clark, messageId, {
+        status: "parked",
+        expiresAtMs: Date.now() + PERMISSION_PROMPT_REPLAY_GRACE_MS,
+        failure,
+        generation,
+    }, { status: "awaiting_ack", generation });
+    if (parked) {
+        recordToolPermissionDeliveryOutcome("parked");
+    }
+    return parked;
+}
+function currentDeliveryOutcome(clark, messageId) {
+    const current = clark.context.pendingToolPermissionRequest;
+    if (!current || current.messageId !== messageId) {
+        return "superseded";
+    }
+    switch (current.delivery.status) {
+        case "acked":
+            return "acked";
+        case "parked":
+            return "parked";
+        case "awaiting_ack":
+            return "awaiting_ack";
+        default: {
+            const exhaustive = current.delivery;
+            return exhaustive;
+        }
+    }
+}
+async function settleAfterReplacement(clark, messageId) {
+    await inFlightToolPermissionReplay(clark);
+    const outcome = currentDeliveryOutcome(clark, messageId);
+    switch (outcome) {
+        case "acked":
+        case "parked":
+        case "superseded":
+            return outcome;
+        case "awaiting_ack": {
+            const current = clark.context.pendingToolPermissionRequest;
+            if (!current || current.messageId !== messageId) {
+                return "superseded";
+            }
+            const parked = parkAwaitingAck(clark, messageId, {
+                kind: "peer_unavailable",
+                message: "permission prompt replay missed after reconnect",
+            }, current.delivery.generation);
+            if (parked) {
+                void flushPendingToolPermissionPrompt(clark);
+                return "parked";
+            }
+            const after = currentDeliveryOutcome(clark, messageId);
+            return after === "awaiting_ack" ? "superseded" : after;
+        }
+        default: {
+            const exhaustive = outcome;
+            return exhaustive;
+        }
+    }
+}
+function withGeneration(delivery, generation) {
+    switch (delivery.status) {
+        case "acked":
+            return { status: "acked", generation };
+        case "awaiting_ack":
+            return { status: "awaiting_ack", generation };
+        case "parked":
+            return {
+                status: "parked",
+                expiresAtMs: delivery.expiresAtMs,
+                failure: delivery.failure,
+                generation,
+            };
+        default: {
+            const exhaustive = delivery;
+            return exhaustive;
+        }
+    }
+}
+export function flushPendingToolPermissionPrompt(clark, options) {
+    const pending = clark.context.pendingToolPermissionRequest;
+    const peer = clark.context.peer;
+    if (!pending || !peer) {
+        return Promise.resolve("skipped");
+    }
+    const reconnectablePeer = reconnectableDeliveryPeer(peer);
+    if (reconnectablePeer && !reconnectablePeer.isConnected) {
+        return Promise.resolve("skipped");
+    }
+    if (pending.delivery.status === "awaiting_ack" && !options?.replaceInFlight) {
+        return Promise.resolve("skipped");
+    }
+    const active = inFlightReplays.get(clark);
+    const connectionGeneration = reconnectablePeer?.connectionGeneration;
+    if (active?.messageId === pending.messageId &&
+        (!options?.replaceInFlight ||
+            sameConnection(active, peer, connectionGeneration))) {
+        return active.promise;
+    }
+    const replacingFirstDelivery = pending.delivery.status === "awaiting_ack";
+    const generation = pending.delivery.generation + 1;
+    updatePendingDelivery(clark, pending.messageId, withGeneration(pending.delivery, generation));
+    if (replacingFirstDelivery) {
+        notifyFirstDeliveryReplaced(clark);
+    }
+    const request = {
+        messageId: pending.messageId,
+        toolName: pending.toolName,
+        actionName: pending.actionName,
+        formattedInput: pending.formattedInput,
+        rawInput: pending.rawInput,
+        permissions: pending.permissions ?? [],
+        signature: pending.signature,
+    };
+    const promise = (async () => {
+        try {
+            await callPeer(peer, () => peer.call.aiRequestToolPermission(request), PERMISSION_PROMPT_DELIVERY_TIMEOUT_MS, "aiRequestToolPermission");
+            const current = clark.context.pendingToolPermissionRequest;
+            if (current?.messageId === pending.messageId &&
+                current.delivery.generation === generation) {
+                updatePendingDelivery(clark, pending.messageId, {
+                    status: "acked",
+                    generation,
+                });
+                recordToolPermissionDeliveryOutcome("acked_after_replay");
+                clark.logger.info(`[debug] replay aiRequestToolPermission acknowledged`, {
+                    generation,
+                    messageId: pending.messageId,
+                    source: options?.source ?? "retry",
+                    toolName: pending.toolName,
+                });
+                return "acked";
+            }
+            clark.logger.info(`[debug] replay aiRequestToolPermission acknowledgement superseded`, {
+                attemptedGeneration: generation,
+                currentGeneration: current?.delivery.generation,
+                messageId: pending.messageId,
+                source: options?.source ?? "retry",
+                toolName: pending.toolName,
+            });
+            return "superseded";
+        }
+        catch (error) {
+            clark.logger.warn(`[debug] replay aiRequestToolPermission failed`, {
+                messageId: pending.messageId,
+                toolName: pending.toolName,
+                source: options?.source ?? "retry",
+                error: errorMessage(error),
+                errorName: error instanceof Error ? error.name : "unknown",
+            });
+            if (options?.source === "reconnect") {
+                clark.logger.error("[ai-service] Failed to resend tool permission request on reconnect", getErrorMeta(error));
+            }
+            return parkReplayFailure(clark, pending.messageId, replayFailure(error), generation)
+                ? "parked"
+                : "superseded";
+        }
+        finally {
+            const currentReplay = inFlightReplays.get(clark);
+            if (currentReplay?.messageId === pending.messageId &&
+                currentReplay.generation === generation) {
+                inFlightReplays.delete(clark);
+            }
+        }
+    })();
+    inFlightReplays.set(clark, {
+        connectionGeneration,
+        generation,
+        messageId: pending.messageId,
+        peer,
+        promise,
+    });
+    return promise;
+}
+export function inFlightToolPermissionReplay(clark) {
+    return inFlightReplays.get(clark)?.promise;
+}
+/**
+ * Thrown when the permission dialog could not be delivered to the browser.
+ * The message is written for the LLM to relay to the user verbatim. The
+ * diagnosis depends on the cause: "may be unresponsive" is accurate only for
+ * the timeout path. An immediate rejection (e.g. a socket drop) can happen
+ * with a perfectly healthy tab, so it carries the underlying reason instead.
+ */
+export class PermissionPromptDeliveryError extends Error {
+    constructor(toolName, options) {
+        const cause = options?.cause;
+        const expiredAfterGrace = options?.expiredAfterGrace === true;
+        const causeText = cause instanceof Error ? cause.message : String(cause ?? "");
+        const diagnosis = cause instanceof RpcTimeoutError
+            ? expiredAfterGrace
+                ? `Could not deliver the permission dialog for "${toolName}" to the user's editor tab before the delivery grace period expired; the tab may be unresponsive.`
+                : `Could not deliver the permission dialog for "${toolName}" to the user's editor tab within ` +
+                    `${PERMISSION_PROMPT_DELIVERY_TIMEOUT_MS / 1000}s; the tab may be unresponsive.`
+            : expiredAfterGrace
+                ? `Could not deliver the permission dialog for "${toolName}" to the user's editor tab before the delivery grace period expired: ${causeText}.`
+                : `Could not deliver the permission dialog for "${toolName}" to the user's editor tab: ${causeText}.`;
+        super(`${diagnosis} ` +
+            `Tell the user to check their editor tab is open and connected, then re-run this action. ` +
+            `Do not proceed with the gated action without permission.`, options);
+        this.name = "PermissionPromptDeliveryError";
+    }
+}
+export function createExpiredPermissionPromptDeliveryError(toolName, delivery) {
+    const cause = delivery.failure.kind === "timeout"
+        ? new RpcTimeoutError("aiRequestToolPermission", PERMISSION_PROMPT_DELIVERY_TIMEOUT_MS)
+        : new Error(delivery.failure.message);
+    return new PermissionPromptDeliveryError(toolName, {
+        cause,
+        expiredAfterGrace: true,
+    });
+}
+/**
+ * Deliver the permission dialog to the browser peer. Transient misses park the
+ * pending request for replay; non-transient failures clear it before throwing.
+ *
+ * No-peer behavior is unchanged from the pre-ENG-4820 code: warn and return
+ * without error; the pending request stays stored.
+ */
+export async function deliverToolPermissionPrompt(clark, request) {
+    const { messageId, toolName, signature } = request;
+    if (!clark.context.peer) {
+        getLogger().warn(`[ai-service] Cannot request tool permission: no peer. tool=${toolName}`);
+    }
+    clark.logger.info(`[debug] sending aiRequestToolPermission`, {
+        messageId,
+        toolName,
+        signature,
+    });
+    if (!clark.context.peer) {
+        return "no_peer";
+    }
+    // Clark is now blocked on a human. A Gateway caller cannot see this dialog,
+    // so without the relay its turn just appears to stall.
+    emitLiveEditEvent("auth_required", { reason: "tool_permission" });
+    const startedGeneration = clark.context.pendingToolPermissionRequest?.delivery.generation ?? 0;
+    const reconnectablePeer = reconnectableDeliveryPeer(clark.context.peer);
+    if (reconnectablePeer && !reconnectablePeer.isConnected) {
+        parkAwaitingAck(clark, messageId, {
+            kind: "peer_unavailable",
+            message: "editor peer disconnected before permission prompt delivery",
+        }, startedGeneration);
+        return "parked";
+    }
+    const peer = clark.context.peer;
+    const rpcHandled = callPeer(peer, () => peer.call.aiRequestToolPermission(request), PERMISSION_PROMPT_DELIVERY_TIMEOUT_MS, "aiRequestToolPermission").then(() => ({ ok: true }), (error) => ({ ok: false, error }));
+    const replaced = whenFirstDeliveryReplaced(clark);
+    const winner = await Promise.race([
+        rpcHandled.then((result) => ({ kind: "rpc", result })),
+        replaced.then(() => ({ kind: "replaced" })),
+    ]);
+    if (winner.kind === "replaced") {
+        return settleAfterReplacement(clark, messageId);
+    }
+    firstDeliveryReplaced.delete(clark);
+    if (winner.result.ok) {
+        clark.logger.info(`[debug] aiRequestToolPermission acknowledged`, {
+            messageId,
+            toolName,
+            signature,
+        });
+        if (updatePendingDelivery(clark, messageId, {
+            status: "acked",
+            generation: startedGeneration,
+        }, { status: "awaiting_ack", generation: startedGeneration })) {
+            recordToolPermissionDeliveryOutcome("acked");
+            return "acked";
+        }
+        const outcome = currentDeliveryOutcome(clark, messageId);
+        return outcome === "awaiting_ack"
+            ? settleAfterReplacement(clark, messageId)
+            : outcome;
+    }
+    const error = winner.result.error;
+    clark.logger.warn(`[debug] aiRequestToolPermission failed`, {
+        messageId,
+        toolName,
+        signature,
+        error: error instanceof Error ? error.message : String(error),
+        // Structured discriminator (e.g. "RpcTimeoutError" vs socket errors) so
+        // Datadog can query @errorName instead of the refactor-fragile freetext
+        // message when tracking delivery-failure rates.
+        errorName: error instanceof Error ? error.name : "unknown",
+    });
+    const failure = transientDeliveryFailure(error);
+    if (failure) {
+        const parked = parkAwaitingAck(clark, messageId, failure, startedGeneration);
+        if (parked) {
+            return "parked";
+        }
+        const outcome = currentDeliveryOutcome(clark, messageId);
+        return outcome === "awaiting_ack"
+            ? settleAfterReplacement(clark, messageId)
+            : outcome;
+    }
+    const current = clark.context.pendingToolPermissionRequest;
+    if (current?.messageId !== messageId ||
+        current.delivery.status !== "awaiting_ack" ||
+        current.delivery.generation !== startedGeneration) {
+        const outcome = currentDeliveryOutcome(clark, messageId);
+        return outcome === "awaiting_ack"
+            ? settleAfterReplacement(clark, messageId)
+            : outcome;
+    }
+    clearPendingToolPermissionRequest(clark, "prompt-rpc-error");
+    throw new PermissionPromptDeliveryError(toolName, { cause: error });
+}
+//# sourceMappingURL=tool-permission-delivery.js.map

package/dist/ai-service/agent/tool-permission-delivery.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-permission-delivery.js","sourceRoot":"","sources":["../../../src/ai-service/agent/tool-permission-delivery.ts"],"names":[],"mappings":"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"}

package/dist/ai-service/agent/tool-result-metrics.d.ts

@@ -0,0 +1,29 @@
+import type { Tool } from "./tools2/types.js";
+export declare const DEFAULT_MAX_OUTPUT_CHARS = 25000;
+export declare const TOOL_EXECUTION_RESULT_CHARS_METRIC = "superblocks.clark.tool.execution.result_chars";
+export type ToolExecutionOutcome = "error" | "success" | "timeout";
+/**
+ * Character length of a tool result as the model receives it.
+ *
+ * Media parts count as zero: the provider carries them outside the text
+ * context, so they are not the bloat this metric ranks. Going through
+ * `toModelOutput` is what makes that fall out automatically, rather than
+ * needing a list of tool names to exclude. Mirrors the same call in
+ * `llm/stream/observers/llmobs.ts`.
+ */
+export declare function measureToolResultChars(tool: Pick<Tool, "toModelOutput">, args: {
+    input: unknown;
+    output: unknown;
+    toolCallId: string;
+}): number;
+/**
+ * Character length of a thrown tool result as the model receives it.
+ *
+ * Failed tools never go through `toModelOutput`; the AI SDK puts
+ * `error.message` (or `String(error)`) into the conversation, so measuring
+ * the successful converter would miss the text that actually lands.
+ */
+export declare function measureThrownToolResultChars(error: unknown): number;
+export declare function recordToolExecutionResultChars(toolName: string, chars: number, stepNumber: number, outcome: ToolExecutionOutcome): void;
+export declare function _resetToolResultMetricsForTesting(): void;
+//# sourceMappingURL=tool-result-metrics.d.ts.map

package/dist/ai-service/agent/tool-result-metrics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-result-metrics.d.ts","sourceRoot":"","sources":["../../../src/ai-service/agent/tool-result-metrics.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,mBAAmB,CAAC;AAI9C,eAAO,MAAM,wBAAwB,QAAS,CAAC;AAG/C,eAAO,MAAM,kCAAkC,kDACE,CAAC;AAElD,MAAM,MAAM,oBAAoB,GAAG,OAAO,GAAG,SAAS,GAAG,SAAS,CAAC;AAyEnE;;;;;;;;GAQG;AACH,wBAAgB,sBAAsB,CACpC,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,eAAe,CAAC,EACjC,IAAI,EAAE;IAAE,KAAK,EAAE,OAAO,CAAC;IAAC,MAAM,EAAE,OAAO,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,GAC5D,MAAM,CA2DR;AAED;;;;;;GAMG;AACH,wBAAgB,4BAA4B,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAInE;AAYD,wBAAgB,8BAA8B,CAC5C,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,MAAM,EACb,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,oBAAoB,GAC5B,IAAI,CAON;AAUD,wBAAgB,iCAAiC,IAAI,IAAI,CAGxD"}

package/dist/ai-service/agent/tool-result-metrics.js

@@ -0,0 +1,162 @@
+import { metrics } from "@opentelemetry/api";
+// I am seeing 1 character map to 2 tokens for these large JSON outputs in practice, so setting the limit
+// here to 25k characters. 50k tokens is a huge output.
+export const DEFAULT_MAX_OUTPUT_CHARS = 25_000;
+const METER_NAME = "superblocks.clark.tool_execution";
+export const TOOL_EXECUTION_RESULT_CHARS_METRIC = "superblocks.clark.tool.execution.result_chars";
+/**
+ * Highest step number reported verbatim; anything beyond collapses into
+ * `MAX_TRACKED_STEP+`. A turn is around a dozen steps, so this keeps the
+ * early-vs-late signal the histogram exists for while bounding series count.
+ */
+const MAX_TRACKED_STEP = 50;
+/**
+ * Bucket edges spanning the range tool results actually occupy. The SDK
+ * defaults are calibrated for millisecond latencies and stop at 10k, which for
+ * character counts puts everything worth ranking — the 25k limit, the SDK docs
+ * tool's ~43.5k, a runaway six-figure result — in one unbounded top bucket,
+ * leaving percentiles unable to tell those apart. An edge sits on
+ * DEFAULT_MAX_OUTPUT_CHARS so the over-limit split is exact rather than
+ * interpolated. Ten buckets, fewer than the sixteen the defaults give.
+ */
+const RESULT_CHARS_BUCKET_BOUNDARIES = [
+    1_000,
+    2_500,
+    5_000,
+    10_000,
+    DEFAULT_MAX_OUTPUT_CHARS,
+    50_000,
+    100_000,
+    250_000,
+    500_000,
+];
+let cachedMeter;
+let cachedResultCharsHistogram;
+function resolveResultCharsHistogram() {
+    const meter = metrics.getMeter(METER_NAME);
+    if (meter === cachedMeter && cachedResultCharsHistogram) {
+        return cachedResultCharsHistogram;
+    }
+    cachedMeter = meter;
+    cachedResultCharsHistogram = meter.createHistogram(TOOL_EXECUTION_RESULT_CHARS_METRIC, {
+        advice: { explicitBucketBoundaries: RESULT_CHARS_BUCKET_BOUNDARIES },
+        description: "Character length of the text a Clark tool result adds to the conversation, including failed and timed-out calls.",
+        unit: "{char}",
+    });
+    return cachedResultCharsHistogram;
+}
+/**
+ * Serialized length without the log sanitizer. `safeJsonStringify` drops
+ * secret-named fields and rewrites any repeated object reference as
+ * "[Circular Reference]", both of which understate the real size, and it runs
+ * a regex pass over every string — the cost this repo avoids on large base64
+ * payloads. A size metric emits no content, so none of that applies.
+ */
+function serializedLength(value) {
+    if (typeof value === "string") {
+        return value.length;
+    }
+    try {
+        return JSON.stringify(value)?.length ?? 0;
+    }
+    catch {
+        // Circular or otherwise non-serializable; no size to report.
+        return 0;
+    }
+}
+/**
+ * Character length of a tool result as the model receives it.
+ *
+ * Media parts count as zero: the provider carries them outside the text
+ * context, so they are not the bloat this metric ranks. Going through
+ * `toModelOutput` is what makes that fall out automatically, rather than
+ * needing a list of tool names to exclude. Mirrors the same call in
+ * `llm/stream/observers/llmobs.ts`.
+ */
+export function measureToolResultChars(tool, args) {
+    if (!tool.toModelOutput) {
+        return serializedLength(args.output);
+    }
+    let modelOutput;
+    try {
+        modelOutput = tool.toModelOutput({
+            input: args.input,
+            output: args.output,
+            toolCallId: args.toolCallId,
+        });
+    }
+    catch {
+        // A throwing toModelOutput is the tool's problem, not the metric's; fall
+        // back to the raw result so the observation is not lost.
+        return serializedLength(args.output);
+    }
+    if (!modelOutput ||
+        typeof modelOutput !== "object" ||
+        !("type" in modelOutput)) {
+        return serializedLength(modelOutput);
+    }
+    const typed = modelOutput;
+    switch (typed.type) {
+        case "error-text":
+        case "text":
+        case "error-json":
+        case "json":
+            // A nullish value means the converter did not recognize what it was
+            // handed, which is what happens once the limiter has replaced a
+            // structured result with its truncation notice: a `toModelOutput` that
+            // reads a field off the result gets undefined. Scoring that as zero
+            // would rank the largest results as the cheapest and would clear
+            // `over_char_limit` on the very calls that tripped it, so fall back to
+            // the result actually returned.
+            return typed.value == null
+                ? serializedLength(args.output)
+                : serializedLength(typed.value);
+        case "content":
+            return Array.isArray(typed.value)
+                ? typed.value.reduce((total, part) => total + contentPartTextLength(part), 0)
+                : 0;
+        case "execution-denied":
+            return serializedLength(typed.reason ?? "");
+        default:
+            return serializedLength(modelOutput);
+    }
+}
+/**
+ * Character length of a thrown tool result as the model receives it.
+ *
+ * Failed tools never go through `toModelOutput`; the AI SDK puts
+ * `error.message` (or `String(error)`) into the conversation, so measuring
+ * the successful converter would miss the text that actually lands.
+ */
+export function measureThrownToolResultChars(error) {
+    return serializedLength(error instanceof Error ? error.message : String(error));
+}
+function contentPartTextLength(part) {
+    if (!part || typeof part !== "object") {
+        return 0;
+    }
+    const typed = part;
+    return typed.type === "text" && typeof typed.text === "string"
+        ? typed.text.length
+        : 0;
+}
+export function recordToolExecutionResultChars(toolName, chars, stepNumber, outcome) {
+    resolveResultCharsHistogram().record(chars, {
+        outcome,
+        over_char_limit: String(chars > DEFAULT_MAX_OUTPUT_CHARS),
+        step_number: formatStepNumber(stepNumber),
+        tool_name: toolName,
+    });
+}
+function formatStepNumber(stepNumber) {
+    if (!Number.isFinite(stepNumber) || stepNumber < 0) {
+        return "unknown";
+    }
+    const step = Math.floor(stepNumber);
+    return step > MAX_TRACKED_STEP ? `${MAX_TRACKED_STEP}+` : String(step);
+}
+export function _resetToolResultMetricsForTesting() {
+    cachedMeter = undefined;
+    cachedResultCharsHistogram = undefined;
+}
+//# sourceMappingURL=tool-result-metrics.js.map

package/dist/ai-service/agent/tool-result-metrics.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-result-metrics.js","sourceRoot":"","sources":["../../../src/ai-service/agent/tool-result-metrics.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAc,MAAM,oBAAoB,CAAC;AAIzD,yGAAyG;AACzG,uDAAuD;AACvD,MAAM,CAAC,MAAM,wBAAwB,GAAG,MAAM,CAAC;AAE/C,MAAM,UAAU,GAAG,kCAAkC,CAAC;AACtD,MAAM,CAAC,MAAM,kCAAkC,GAC7C,+CAA+C,CAAC;AAIlD;;;;GAIG;AACH,MAAM,gBAAgB,GAAG,EAAE,CAAC;AAE5B;;;;;;;;GAQG;AACH,MAAM,8BAA8B,GAAG;IACrC,KAAK;IACL,KAAK;IACL,KAAK;IACL,MAAM;IACN,wBAAwB;IACxB,MAAM;IACN,OAAO;IACP,OAAO;IACP,OAAO;CACR,CAAC;AAEF,IAAI,WAA8B,CAAC;AACnC,IAAI,0BAES,CAAC;AAEd,SAAS,2BAA2B;IAClC,MAAM,KAAK,GAAG,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC;IAC3C,IAAI,KAAK,KAAK,WAAW,IAAI,0BAA0B,EAAE,CAAC;QACxD,OAAO,0BAA0B,CAAC;IACpC,CAAC;IAED,WAAW,GAAG,KAAK,CAAC;IACpB,0BAA0B,GAAG,KAAK,CAAC,eAAe,CAChD,kCAAkC,EAClC;QACE,MAAM,EAAE,EAAE,wBAAwB,EAAE,8BAA8B,EAAE;QACpE,WAAW,EACT,kHAAkH;QACpH,IAAI,EAAE,QAAQ;KACf,CACF,CAAC;IACF,OAAO,0BAA0B,CAAC;AACpC,CAAC;AAED;;;;;;GAMG;AACH,SAAS,gBAAgB,CAAC,KAAc;IACtC,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,OAAO,KAAK,CAAC,MAAM,CAAC;IACtB,CAAC;IACD,IAAI,CAAC;QACH,OAAO,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,EAAE,MAAM,IAAI,CAAC,CAAC;IAC5C,CAAC;IAAC,MAAM,CAAC;QACP,6DAA6D;QAC7D,OAAO,CAAC,CAAC;IACX,CAAC;AACH,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,sBAAsB,CACpC,IAAiC,EACjC,IAA6D;IAE7D,IAAI,CAAC,IAAI,CAAC,aAAa,EAAE,CAAC;QACxB,OAAO,gBAAgB,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IACvC,CAAC;IAED,IAAI,WAAoB,CAAC;IACzB,IAAI,CAAC;QACH,WAAW,GAAG,IAAI,CAAC,aAAa,CAAC;YAC/B,KAAK,EAAE,IAAI,CAAC,KAAK;YACjB,MAAM,EAAE,IAAI,CAAC,MAAM;YACnB,UAAU,EAAE,IAAI,CAAC,UAAU;SACyB,CAAC,CAAC;IAC1D,CAAC;IAAC,MAAM,CAAC;QACP,yEAAyE;QACzE,yDAAyD;QACzD,OAAO,gBAAgB,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IACvC,CAAC;IAED,IACE,CAAC,WAAW;QACZ,OAAO,WAAW,KAAK,QAAQ;QAC/B,CAAC,CAAC,MAAM,IAAI,WAAW,CAAC,EACxB,CAAC;QACD,OAAO,gBAAgB,CAAC,WAAW,CAAC,CAAC;IACvC,CAAC;IAED,MAAM,KAAK,GAAG,WAIb,CAAC;IACF,QAAQ,KAAK,CAAC,IAAI,EAAE,CAAC;QACnB,KAAK,YAAY,CAAC;QAClB,KAAK,MAAM,CAAC;QACZ,KAAK,YAAY,CAAC;QAClB,KAAK,MAAM;YACT,oEAAoE;YACpE,gEAAgE;YAChE,uEAAuE;YACvE,oEAAoE;YACpE,iEAAiE;YACjE,uEAAuE;YACvE,gCAAgC;YAChC,OAAO,KAAK,CAAC,KAAK,IAAI,IAAI;gBACxB,CAAC,CAAC,gBAAgB,CAAC,IAAI,CAAC,MAAM,CAAC;gBAC/B,CAAC,CAAC,gBAAgB,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QACpC,KAAK,SAAS;YACZ,OAAO,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC;gBAC/B,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,MAAM,CAChB,CAAC,KAAa,EAAE,IAAa,EAAE,EAAE,CAC/B,KAAK,GAAG,qBAAqB,CAAC,IAAI,CAAC,EACrC,CAAC,CACF;gBACH,CAAC,CAAC,CAAC,CAAC;QACR,KAAK,kBAAkB;YACrB,OAAO,gBAAgB,CAAC,KAAK,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC;QAC9C;YACE,OAAO,gBAAgB,CAAC,WAAW,CAAC,CAAC;IACzC,CAAC;AACH,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,4BAA4B,CAAC,KAAc;IACzD,OAAO,gBAAgB,CACrB,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CACvD,CAAC;AACJ,CAAC;AAED,SAAS,qBAAqB,CAAC,IAAa;IAC1C,IAAI,CAAC,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ,EAAE,CAAC;QACtC,OAAO,CAAC,CAAC;IACX,CAAC;IACD,MAAM,KAAK,GAAG,IAA0C,CAAC;IACzD,OAAO,KAAK,CAAC,IAAI,KAAK,MAAM,IAAI,OAAO,KAAK,CAAC,IAAI,KAAK,QAAQ;QAC5D,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM;QACnB,CAAC,CAAC,CAAC,CAAC;AACR,CAAC;AAED,MAAM,UAAU,8BAA8B,CAC5C,QAAgB,EAChB,KAAa,EACb,UAAkB,EAClB,OAA6B;IAE7B,2BAA2B,EAAE,CAAC,MAAM,CAAC,KAAK,EAAE;QAC1C,OAAO;QACP,eAAe,EAAE,MAAM,CAAC,KAAK,GAAG,wBAAwB,CAAC;QACzD,WAAW,EAAE,gBAAgB,CAAC,UAAU,CAAC;QACzC,SAAS,EAAE,QAAQ;KACpB,CAAC,CAAC;AACL,CAAC;AAED,SAAS,gBAAgB,CAAC,UAAkB;IAC1C,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,UAAU,CAAC,IAAI,UAAU,GAAG,CAAC,EAAE,CAAC;QACnD,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;IACpC,OAAO,IAAI,GAAG,gBAAgB,CAAC,CAAC,CAAC,GAAG,gBAAgB,GAAG,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;AACzE,CAAC;AAED,MAAM,UAAU,iCAAiC;IAC/C,WAAW,GAAG,SAAS,CAAC;IACxB,0BAA0B,GAAG,SAAS,CAAC;AACzC,CAAC"}